top
all js glsl

ExtentGeometry

ExtentGeometry

new

A description of a cartographic extent on an ellipsoid centered at the origin.

Parameters:
Name Type Argument Default Description
options.extent Extent A cartographic extent with north, south, east and west properties in radians.
options.vertexFormat VertexFormat <optional>
 VertexFormat.DEFAULT The vertex attributes to be computed.
options.ellipsoid Ellipsoid <optional>
 Ellipsoid.WGS84 The ellipsoid on which the extent lies.
options.granularity Number <optional>
 CesiumMath.RADIANS_PER_DEGREE The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
options.height Number <optional>
 0.0 The height from the surface of the ellipsoid.
options.rotation Number <optional>
 0.0 The rotation of the extent, in radians. A positive rotation is counter-clockwise.
options.stRotation Number <optional>
 0.0 The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
options.extrudedHeight Number <optional>
 Height of extruded surface.
options.closeTop Boolean <optional>
 true true to render top of an extruded extent; false otherwise. (Only applicable if options.extrudedHeight is not equal to options.height.)
options.closeBottom Boolean <optional>
 true true to render bottom of an extruded extent; false otherwise. (Only applicable if options.extrudedHeight is not equal to options.height.)
Throws:
  • DeveloperError : options.extent is required and must have north, south, east and west attributes.
  • DeveloperError : options.extent.north must be in the interval [-Pi/2, Pi/2].
  • DeveloperError : options.extent.south must be in the interval [-Pi/2, Pi/2].
  • DeveloperError : options.extent.east must be in the interval [-Pi, Pi].
  • DeveloperError : options.extent.west must be in the interval [-Pi, Pi].
  • DeveloperError : options.extent.north must be greater than options.extent.south.
  • DeveloperError : options.extent.east must be greater than options.extent.west.
Example
// 1. create an extent
var extent = new ExtentGeometry({
  ellipsoid : Ellipsoid.WGS84,
  extent : Extent.fromDegrees(-80.0, 39.0, -74.0, 42.0),
  height : 10000.0
});
var geometry = ExtentGeometry.createGeometry(extent);

// 2. create an extruded extent without a top
var extent = new ExtentGeometry({
  ellipsoid : Ellipsoid.WGS84,
  extent : Extent.fromDegrees(-80.0, 39.0, -74.0, 42.0),
  height : 10000.0,
  extrudedHieght: 300000,
  closeTop: false
});
var geometry = ExtentGeometry.createGeometry(extent);
See:
  • ExtentGeometry#createGeometry
Source:

Methods

<static>

Computes the geometric representation of an extent, including its vertices, indices, and a bounding sphere.

Parameters:
Name Type Description
extentGeometry ExtentGeometry A description of the extent.
Throws:
DeveloperError : Rotated extent is invalid.
Returns:
Geometry The computed vertices and indices.