Package-level declarations
Types
Provides an abstract base class for mesh shapes.
Base class for all geometric shapes.
Interface to controlling a shape's attributes. Shapes implementing this interface use the ShapeAttributes bundle for specifying the normal attributes and the highlight attributes.
Ellipse shape defined by a geographic center position and radii for the semi-major and semi-minor axes.
Axes and Heading
Ellipse axes, by default, are oriented such that the semi-major axis points East and the semi-minor axis points North. Ellipse provides an optional heading, which when set to anything other than 0.0 rotates the semi-major and semi-minor axes about the center position, while retaining the axes relative relationship to one another. Heading is defined clockwise from North. Configuring ellipse with a heading of 45.0 results in the semi-major axis pointing Southeast and the semi-minor axis pointing Northeast.
Altitude Mode and Terrain Following
Ellipse geometry displays at a constant altitude determined by the geographic center position and altitude mode. For example, an ellipse with a center position altitude of 1km and altitude mode of ABSOLUTE displays at 1km above mean sea level. The same ellipse with an altitude mode of RELATIVE_TO_GROUND displays at 1km above ground level, relative to the ellipse's center location.
Surface ellipse geometry, where an ellipse appears draped across the terrain, may be achieved by enabling ellipse's terrain following state and setting its altitude mode to CLAMP_TO_GROUND. See isFollowTerrain and altitudeMode.
Display Granularity
Ellipse's appearance on screen is composed of discrete segments which approximate the ellipse's geometry. This approximation is chosen such that the display appears to be a continuous smooth ellipse. Applications can control the maximum number of angular intervals used in this representation with maximumIntervals.
3D ellipsoid centered at a geographic position. Supports three independent semi-axes for a tri-axial ellipsoid; pass xRadius == yRadius for a rotation spheroid (the common "two-radius" case of one equatorial radius paired with a polar radius).
Represents a 3D geographic mesh.
Interface to control a shape's highlighting. Shapes implementing this interface have their own highlighting behaviors and attributes and the means for setting them.
Represents an intersection result.
Provides a common API for 3D shapes that support ray intersection.
Represents a label at a geographic position. Labels display one or more lines of text, separated by '\n', according to specified TextAttributes. Lines are aligned inside the text block by the horizontal fraction of TextAttributes.textOffset anchor: 0 = left, 0.5 = center, 1 = right.
Orientation mode indicates how WorldWind interprets a renderable's orientation value, e.g., tilt and rotate values. Accepted values are RELATIVE_TO_GLOBE, and RELATIVE_TO_SCREEN.
Path type indicates how WorldWind create a geographic path between two locations. Accepted values are GREAT_CIRCLE, LINEAR and RHUMB_LINE.
Represents a Placemark shape. A placemark displays an image, a label and a leader connecting the placemark's geographic position to the ground. All three of these items are optional. By default, the leader is not pickable. See Placemark.isLeaderPickingEnabled.
Placemarks may be drawn with either an image or as single-color square with a specified size. When the placemark attributes indicate a valid image, the placemark's image is drawn as a rectangle in the image's original dimensions, scaled by the image scale attribute. Otherwise, the placemark is drawn as a square with width and height equal to the value of the image scale attribute, in pixels, and color equal to the image color attribute.
Holds attributes applied to Placemark shapes. The defaults indicate a placemark displayed as a white 1x1 pixel square centered on the placemark's geographic position.
Displays a realtime sightline's visibility within the WorldWind scene, resolved every frame against the rendered geometry (terrain and world-space 3D content such as 3D Tiles meshes, filled shapes and COLLADA models) — unlike ViewshedSightline, which ray-marches a static elevation grid. The sightline's placement and coverage are defined by a center position, a range, and a horizontal wedge given by heading and fieldOfView; the default 360-degree field of view covers the full sphere (the former OmnidirectionalSightline), while narrower angles model directional sensors (the former DirectionalSightline, no longer limited to 90).
Terrain and scene features within the coverage appear in the sightline's normal attributes or its highlight attributes when there is a direct line-of-sight to the center position, and in the occlude attributes otherwise. Features outside the range or wedge are untinted.
Limitations and Planned Improvements
Surface decals and screen-space sprites such as placemarks and leader lines are intentionally excluded as they do not represent occluding volumes. The visibility overlay is drawn in ShapeAttributes' interior color only. Requires a depth-texture-capable context (GLES3 / WebGL2 / desktop GL3+); on older contexts the sightline is not rendered.Holds attributes applied to geographic shapes.
Decal that projects an image (CPU-loaded) or a Texture (GPU-resident) onto the terrain over sector. Use the imageSource constructor for the typical bitmap/URL path (the texture is resolved via RenderContext.getTexture and cached in RenderResourceCache); use the texture constructor when the data already lives on the GPU — e.g. the output of a render-to-texture pass — to skip the upload round-trip entirely.
Holds attributes applied to text shapes and Placemark labels.
Represents a 3D triangle mesh.
The geographic footprint that a ViewshedSightline analyses.
Visibility-from-observer overlay computed against the source elevation model rather than the rendered terrain mesh. Sampling resolution is decoupled from the camera's terrain LoD, so far-away coverage areas remain accurate even when the visible terrain tiles are coarse.