Abstract
Base class for all geometric shapes.
Threading contract. Geometry assembly (makeDrawable / assembleGeometry and everything they call) is single-threaded. The companion-scoped scratch state — point, vertPoint, currentBoundindData, activeAttributes, the per-shape currentData, and the index/cursor statics in subclasses (vertexIndex, lineVertexIndex, etc.) — is shared across instances and is only safe under that single-threaded assumption. Calling assembly from multiple threads concurrently corrupts these scratches; calling assembly recursively (subclass code that triggers another shape's assembly mid-flight) corrupts them too.
In practice the render thread drives one shape's assembly to completion before starting the next, so this is fine. If parallel assembly ever becomes desirable, the scratches need to move from companion fields to a thread-local or a passed-through RenderState parameter.
Inheritors
Properties
AltitudeMode used by movable object
Indicates the shape's normal (non-highlight) attributes.
Base altitude level of shape sides. Is dependent on altitudeMode. Ground level by default.
Indicates the shape's highlight attributes.
Draw sides of the shape which extend from the defined position and altitude to baseAltitude level.
Determines whether this shape's geometry follows the terrain surface or is fixed at a constant altitude.
Indicates whether the shape is highlighted.
true when this shape's referencePosition coincides with where the user actually sees the shape (Placemark, Label, sightlines — the reference is the rendered location). false for shapes whose reference is computed from extended geometry and may sit far from where the user grabbed (Polygon centroid, Path centroid, Mesh).
Optional lambda to control current shape visibility based on its attributes and frame render context
Maximum number of intermediate edge intervals across a half-equator (PI radians) of arc. Per-edge subdivision count is scaled by edge length: steps = round(maximumNumEdgeIntervals * distanceRadians / PI), then further adjusted by polarThrottle near the poles for surface shapes. 3D shapes use the unthrottled count. A value of 0 disables intermediate vertex generation.
Pole-throttle factor: higher values shrink the subdivision step near ±90° latitude so the straight 2D lon/lat segments between samples more closely follow the true great-circle path. A value of 0 disables throttling (uniform step).
A position associated with the object that indicates its aggregate geographic position. The chosen position varies among implementers of this interface. For objects defined by a list of positions, the reference position is typically the first position in the list. For symmetric objects the reference position is often the center of the object. In many cases the object's reference position may be explicitly specified by the application.
Functions
Apply simplestyle stroke / fill / stroke-width to a Path or Polygon's attributes. Writes outline / interior color only when there's an explicit value to apply — either the feature's stroke / fill property OR a non-null defaultLineColor / defaultFillColor. With both null (the default), an absent property leaves the renderable's existing color alone — important when the layer's shapeAttributes supplied an intentional template colour at construction time (e.g. Shapefile's translucent blue) that would otherwise be clobbered by auto-style.