import type { ClonableMixin } from "../../core/Clonable.js";
import type { JSONSupport } from "../../core/JSONSupport.js";

export interface MeshGeoreferencedVertexSpaceProperties extends Partial<Pick<MeshGeoreferencedVertexSpace, "origin">> {}

/**
 * Represents a [vertex space](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#vertexSpace) that interprets
 * [Mesh vertex positions](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshVertexAttributes/#position) in relation to
 * [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference).
 *
 * A vertex space is the [Mesh.vertexSpace](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#vertexSpace) object that tells the SDK how to read the
 * x, y, z positions stored in [Mesh.vertexAttributes.position](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshVertexAttributes/#position).
 * Use MeshGeoreferencedVertexSpace when those source numbers should be interpreted in map space, either as offsets
 * from a placement point or as absolute coordinates in [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference).
 *
 * This vertex space has two common workflows:
 *
 * - In a local [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/) with a projected coordinate system, use a
 *   [vertex space origin](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshGeoreferencedVertexSpace/#origin) for models from 3D modeling or CAD
 *   tools, whose positions are measured from the source model's own [0,0,0], or for data measured from an insertion
 *   point. The vertex space origin places that local [0,0,0] or insertion point in
 *   [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference). Each source position is then an offset from the
 *   vertex space origin, using the units and directions of
 *   [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference).
 * - For source data already exported with absolute coordinates, use no vertex space origin. Each source position is
 *   already an absolute x, y, z location in [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference).
 *
 * Use the same projected coordinate system for [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference) and
 * [SceneView.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#spatialReference) when displaying or editing mesh graphics in a
 * local scene. Do not use this vertex space with a
 * [vertex space origin](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshGeoreferencedVertexSpace/#origin) in WGS84 or CGCS2000 for
 * meter-based model coordinates: longitude and latitude are angular units, so [10, 0, 0] is not ten meters east.
 *
 * @since 4.27
 * @see [Mesh.vertexSpace](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#vertexSpace)
 * @see [MeshLocalVertexSpace](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshLocalVertexSpace/)
 */
export default class MeshGeoreferencedVertexSpace extends MeshGeoreferencedVertexSpaceSuperclass {
  constructor(properties?: MeshGeoreferencedVertexSpaceProperties);
  /**
   * Optional coordinate used to place source position values that are offsets.
   *
   * With a vertex space origin, this [x, y, z] coordinate is interpreted in
   * [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference). Each source position in
   * [Mesh.vertexAttributes.position](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshVertexAttributes/#position) is then an offset from the
   * vertex space's origin.
   *
   * Without a vertex space origin, each source position is already an absolute x, y, z location in
   * [Mesh.spatialReference](https://developers.arcgis.com/javascript/latest/references/core/geometry/Mesh/#spatialReference).
   */
  accessor origin: readonly [
      number,
      number,
      number
  ] | null | undefined;
  /** Type of the vertex space. */
  readonly type: "georeferenced";
}
declare const MeshGeoreferencedVertexSpaceSuperclass: typeof JSONSupport & typeof ClonableMixin