RectangularSensor

new IonSdkSensors.RectangularSensor(options)

Visualizes a rectangular pyramid sensor volume taking into account occlusion of an ellipsoid, i.e., the globe. A rectangular sensor may represent what is visible to a camera attached to a satellite or aircraft. The sensor's shape is defined by two half angles (RectangularSensor#xHalfAngle and RectangularSensor#yHalfAngle) and a radius (RectangularSensor#radius). The shape also depends on if the sensor intersects the ellipsoid, as shown in examples 2 and 3 below, and what surfaces are shown using properties such as RectangularSensor#showDomeSurfaces.

Code Example 1 below

Code Example 2 below

Code Example 3 below

A sensor points along the local positive z-axis and is positioned and oriented using RectangularSensor#modelMatrix.

Name	Type	Description
options	Object	optional Object with the following properties: Name Type Default Description ellipsoid Ellipsoid Ellipsoid.WGS84 optional The ellipsoid that the sensor potentially intersects. show Boolean true optional Determines if the sensor will be shown. portionToDisplay SensorVolumePortionToDisplay SensorVolumePortionToDisplay.COMPLETE optional Indicates what portion of the sensor is shown. modelMatrix Matrix4 Matrix4.IDENTITY optional The 4x4 transformation matrix that transforms the sensor from model to world coordinates. radius Number Number.POSITIVE_INFINITY optional The distance from the sensor origin to any point on the sensor dome. xHalfAngle Number CesiumMath.PI_OVER_TWO optional The half-angle, in radians, of the sensor measured from the positive z-axis (principal direction) along the x-axis. yHalfAngle Number CesiumMath.PI_OVER_TWO optional The half-angle, in radians, of the sensor measured from the positive z-axis (principal direction) along the y-axis. lateralSurfaceMaterial Material Material.ColorType optional The surface appearance of the sensor lateral surface, i.e., the outer sides of the sensor. showLateralSurfaces Boolean true optional Determines if the lateral surfaces, i.e., the outer sides of the sensor, are shown. ellipsoidHorizonSurfaceMaterial Material Material.ColorType optional The surface appearance of the ellipsoid horizon surfaces, i.e., the sides formed from occlusion due to the ellipsoid horizon. showEllipsoidHorizonSurfaces Boolean true optional Determines if the ellipsoid horizon surfaces, i.e., the sides formed from occlusion due to the ellipsoid horizon, are shown. ellipsoidSurfaceMaterial Material Material.ColorType optional The appearance of the ellipsoid surface where the sensor intersects. showEllipsoidSurfaces Boolean true optional Determines if the ellipsoid/sensor intersection surfaces are shown. domeSurfaceMaterial Material Material.ColorType optional The appearance of the sensor dome surfaces. showDomeSurfaces Boolean true optional Determines if the sensor dome surfaces are shown. showIntersection Boolean true optional Determines if a polyline is shown where the sensor intersects the ellipsoid. intersectionColor Color Color.WHITE optional The color of the polyline where the sensor intersects the ellipsoid. intersectionWidth Number 5.0 optional The approximate pixel width of the polyline where the sensor intersects the ellipsoid. showThroughEllipsoid Boolean false optional Determines if a sensor intersecting the ellipsoid is drawn through the ellipsoid and potentially out to the other side. environmentConstraint Boolean false optional Determines if the sensor will be occluded by objects in the current view of the environment, e.g. visible terrain or models. showEnvironmentOcclusion Boolean false optional Determines if the portion of the sensor occluded by the environment is shown. environmentOcclusionMaterial Material Material.ColorType optional The appearance of the surface that is occluded by the environment. showEnvironmentIntersection Boolean false optional Determines if the line intersecting the sensor and the environment is shown. environmentIntersectionColor Color Color.WHITE optional The color of the line intersecting the sensor and the environment. environmentIntersectionWidth Number 5.0 optional The width of the line intersecting the sensor and the environment in meters. showViewshed Boolean false optional Determine if a viewshed is shown. The viewshed is only shown in 3D (see Scene#mode) and only accounts for visible objects in the current camera view. viewshedVisibleColor Material Color.LIME optional The color of the scene geometry that is visible to the sensor. viewshedOccludedColor Material Color.RED optional The color of the scene geometry that is not visible to the sensor. viewshedResolution Number 2048 optional The resolution in pixels of the viewshed. classificationType ClassificationType ClassificationType.BOTH optional Determines whether terrain, 3D Tiles or both will be classified. id Object optional User-defined object returned when the sensors is picked. debugShowCrossingPoints Boolean false optional For debugging only. Determines if the points where the sensor boundary crosses off of and onto the ellipsoid are shown. debugShowProxyGeometry Boolean false optional For debugging only. Determines if the proxy geometry used for shading the dome and ellipsoid horizon surfaces of the sensor boundary are shown. debugShowBoundingVolume Boolean false optional For debugging only. Determines if this primitive's commands' bounding spheres are shown. debugShowShadowMap Boolean false optional For debugging only. Determines if this primitive's shadow map's bounding volume and contents are shown.

Examples:

// Example 1. Sensor on the ground pointing straight up
var sensor = scene.primitives.add(new IonSdkSensors.RectangularSensor({
  modelMatrix : Cesium.Transforms.eastNorthUpToFixedFrame(Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706)),
  radius : 1000000.0,
  xHalfAngle : Cesium.Math.toRadians(25.0),
  yHalfAngle : Cesium.Math.toRadians(40.0)
}));

// Example 2. Sensor pointing straight down with its dome intersecting the ellipsoid
var sensor = scene.primitives.add(new IonSdkSensors.RectangularSensor({
  modelMatrix : Cesium.Transforms.northEastDownToFixedFrame(Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 900000.0)),
  radius : 1000000.0,
  xHalfAngle : Cesium.Math.toRadians(25.0),
  yHalfAngle : Cesium.Math.toRadians(40.0),
  lateralSurfaceMaterial : Cesium.Material.fromType(Cesium.Material.StripeType),
  intersectionColor :  Cesium.Color.YELLOW
}));

// Example 3. Sensor with custom materials for each surface.  Switch to 2D to see the ellipsoid surface material.
var sensor = scene.primitives.add(new IonSdkSensors.RectangularSensor({
  modelMatrix : Cesium.Transforms.northEastDownToFixedFrame(Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 9000000.0)),
  radius : 20000000.0,
  xHalfAngle : Cesium.Math.toRadians(25.0),
  yHalfAngle : Cesium.Math.toRadians(40.0),
  lateralSurfaceMaterial : Cesium.Material.fromType(Cesium.Material.ColorType, { color : new Cesium.Color(1.0, 0.0, 0.0, 0.5) }),
  ellipsoidHorizonSurfaceMaterial : Cesium.Material.fromType(Cesium.Material.ColorType, { color : new Cesium.Color(0.0, 1.0, 0.0, 0.5) }),
  ellipsoidSurfaceMaterial : Cesium.Material.fromType(Cesium.Material.ColorType, { color : new Cesium.Color(0.0, 0.0, 1.0, 0.5) }),
  domeSurfaceMaterial : Cesium.Material.fromType(Cesium.Material.ColorType, { color : new Cesium.Color(1.0, 1.0, 1.0, 0.5) })
}));

See:

• ConicSensor
• CustomPatternSensor

Members

Default Value: ClassificationType.BOTH

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: undefined

Examples:

// Change the color of the dome surface material to yellow
sensor.domeSurfaceMaterial.uniforms.color = Cesium.Color.YELLOW;

// Change material to horizontal stripes
sensor.domeSurfaceMaterial = Material.fromType(Material.StripeType);

See:

• RectangularSensor#showDomeSurfaces

Default Value: Ellipsoid.WGS84

Default Value: undefined

Examples:

// Change the color of the ellipsoid horizon surface material to yellow
sensor.ellipsoidHorizonSurfaceMaterial.uniforms.color = Cesium.Color.YELLOW;

// Change material to horizontal stripes
sensor.ellipsoidHorizonSurfaceMaterial = Cesium.Material.fromType(Cesium.Material.StripeType);

See:

• RectangularSensor#showEllipsoidHorizonSurfaces

Default Value: undefined

Examples:

// Change the color of the ellipsoid surface material to yellow
sensor.ellipsoidSurfaceMaterial.uniforms.color = new Cesium.Color.YELLOW;

// Change material to horizontal stripes
sensor.ellipsoidSurfaceMaterial = Material.fromType(Material.StripeType);

See:

• RectangularSensor#showEllipsoidSurfaces

Default Value: false

Default Value: Color.WHITE

Default Value: 5.0

Default Value: Material.ColorType

Default Value: undefined

See:

• Scene#pick

Default Value: Color.WHITE

See:

• RectangularSensor#showIntersection

Default Value: 5.0

See:

• RectangularSensor#showIntersection

Default Value: Material.ColorType

Examples:

// Change the color of the default material to yellow
sensor.lateralSurfaceMaterial.uniforms.color = Cesium.Color.YELLOW;

// Change material to horizontal stripes
sensor.lateralSurfaceMaterial = Cesium.Material.fromType(Cesium.Material.StripeType);

See:

• RectangularSensor#showLateralSurfaces

The 4x4 transformation matrix that transforms the sensor from model to world coordinates. In its model coordinates, the sensor's principal direction is along the positive z-axis. Half angles measured from the principal direction in the direction of the x-axis and y-axis define the rectangle of the rectangular cross section.

Default Value: Matrix4.IDENTITY

Example:

// The sensor's origin is located on the surface at -75.59777 degrees longitude and 40.03883 degrees latitude.
// The sensor opens upward, along the surface normal.
var center = Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883);
sensor.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(center);

Indicates what portion of the sensor is shown.

COMPLETE

BELOW_ELLIPSOID_HORIZON

ABOVE_ELLIPSOID_HORIZON

Default Value: SensorVolumePortionToDisplay.COMPLETE

Default Value: Number.POSITIVE_INFINITY

Default Value: true

When true, the sensor dome surfaces are shown.

These surfaces are only shown in 3D (see Scene#mode).

Full sensor

Dome only

Default Value: true

See:

• RectangularSensor#domeSurfaceMaterial

When true, the ellipsoid horizon surfaces, i.e., the sides formed from occlusion due to the ellipsoid hoirzon, are shown.

These surfaces are only shown in 3D (see Scene#mode).

Full sensor

Ellipsoid horizon surfaces only

Default Value: true

See:

• RectangularSensor#ellipsoidHorizonSurfaceMaterial

Default Value: true

See:

• RectangularSensor#ellipsoidSurfaceMaterial

Default Value: false

Default Value: false

When true, a polyline is shown where the sensor intersections the ellipsoid.

showIntersection : false

showIntersection : true

Default Value: true

See:

• RectangularSensor#intersectionColor
• RectangularSensor#intersectionWidth

When true, the sensor's lateral surfaces, i.e., the outer sides of the sensor, are shown.

These surfaces are only shown in 3D (see Scene#mode).

Full sensor

Lateral surfaces only

Default Value: true

See:

• RectangularSensor#lateralSurfaceMaterial

When true, a sensor intersecting the ellipsoid is drawn through the ellipsoid and potentially out to the other side.

showThroughEllipsoid : false

showThroughEllipsoid : true

Default Value: false

Default Value: false

Experimental

This feature is not final and is subect to change without Cesium's standard deprecation policy.

See:

• RectangularSensor#viewshedVisibleColor
• RectangularSensor#viewshedOccludedColor
• RectangularSensor#viewshedResolution

Default Value: Color.RED

Experimental

This feature is not final and is subect to change without Cesium's standard deprecation policy.

Default Value: 2048

Experimental

This feature is not final and is subect to change without Cesium's standard deprecation policy.

Default Value: Color.LIME

Experimental

This feature is not final and is subect to change without Cesium's standard deprecation policy.

Default Value: CesiumMath.PI_OVER_TWO

Default Value: CesiumMath.PI_OVER_TWO

Methods

Returns:

Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

Example:

sensor = sensor && sensor.destroy();

Returns:

Throws:

• DeveloperError : this.xHalfAngle and this.yHalfAngle must each be less than 90 degrees.
• DeveloperError : this.radius must be greater than or equal to zero.
• DeveloperError : this.lateralSurfaceMaterial must be defined.