描述一个图形 Describes graphics for a
Rectangle。该矩形符合地球的曲率，可以放置在表面或高空，并且可以选择挤压成体积。 . The rectangle conforms to the curvature of the globe and can be placed on the surface or at altitude and can optionally be extruded into a volume.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
options |
RectangleGraphics.ConstructorOptions | 可选 optional 描述初始化选项的对象 Object describing initialization options |
演示： Demo:
另见： See:
成员 Members
classificationType : Property|undefined
获取或设置 Gets or sets the
ClassificationType 属性指定此矩形在地面上时是否对地形、3D Tiles或两者进行分类。 Property specifying whether this rectangle will classify terrain, 3D Tiles, or both when on the ground.
-
默认值： Default Value:
ClassificationType.BOTH
coordinates : Property|undefined
获取或设置指定的属性 Gets or sets the Property specifying the
Rectangle.
readonly definitionChanged : Event
获取每当更改或修改属性或子属性时引发的事件。 Gets the event that is raised whenever a property or sub-property is changed or modified.
distanceDisplayCondition : Property|undefined
获取或设置 Gets or sets the
DistanceDisplayCondition 属性指定该矩形将在距相机的距离处显示。 Property specifying at what distance from the camera that this rectangle will be displayed.
extrudedHeight : Property|undefined
获取或设置指定矩形拉伸高度的数值属性。设置此属性会创建从高度开始到此高度结束的体积。 Gets or sets the numeric Property specifying the altitude of the rectangle extrusion. Setting this property creates volume starting at height and ending at this altitude.
extrudedHeightReference : Property|undefined
获取或设置指定拉伸的属性 Gets or sets the Property specifying the extruded
HeightReference.
-
默认值： Default Value:
HeightReference.NONE
fill : Property|undefined
获取或设置布尔属性，指定矩形是否用提供的材质填充。 Gets or sets the boolean Property specifying whether the rectangle is filled with the provided material.
-
默认值： Default Value:
true
granularity : Property|undefined
获取或设置指定矩形上点之间的角距离的数值属性。 Gets or sets the numeric Property specifying the angular distance between points on the rectangle.
-
默认值： Default Value:
{CesiumMath.RADIANS_PER_DEGREE}
height : Property|undefined
获取或设置指定矩形高度的数字属性。 Gets or sets the numeric Property specifying the altitude of the rectangle.
-
默认值： Default Value:
0.0
heightReference : Property|undefined
获取或设置指定的属性 Gets or sets the Property specifying the
HeightReference.
-
默认值： Default Value:
HeightReference.NONE
获取或设置指定用于填充矩形的材质的属性。 Gets or sets the Property specifying the material used to fill the rectangle.
-
默认值： Default Value:
Color.WHITE
outline : Property|undefined
获取或设置指定矩形是否有轮廓的属性。 Gets or sets the Property specifying whether the rectangle is outlined.
-
默认值： Default Value:
false
outlineColor : Property|undefined
-
默认值： Default Value:
Color.BLACK
outlineWidth : Property|undefined
获取或设置指定轮廓宽度的数字属性。 Gets or sets the numeric Property specifying the width of the outline.
注意：此属性在 Windows 平台上的所有主要浏览器上都将被忽略。有关详细信息，请参阅（@link https://github.com/CesiumGS/cesium/issues/40}。 Note: This property will be ignored on all major browsers on Windows platforms. For details, see (@link https://github.com/CesiumGS/cesium/issues/40}.
-
默认值： Default Value:
1.0
rotation : Property|undefined
获取或设置指定矩形从北顺时针旋转的数字属性。 Gets or sets the numeric property specifying the rotation of the rectangle clockwise from north.
-
默认值： Default Value:
0
shadows : Property|undefined
获取或设置枚举属性，指定矩形是否投射或接收来自光源的阴影。 Get or sets the enum Property specifying whether the rectangle casts or receives shadows from light sources.
-
默认值： Default Value:
ShadowMode.DISABLED
show : Property|undefined
获取或设置指定矩形可见性的布尔属性。 Gets or sets the boolean Property specifying the visibility of the rectangle.
-
默认值： Default Value:
true
stRotation : Property|undefined
获取或设置数字属性，指定矩形纹理从北逆时针旋转。 Gets or sets the numeric property specifying the rotation of the rectangle texture counter-clockwise from north.
-
默认值： Default Value:
0
zIndex : ConstantProperty|undefined
获取或设置指定矩形顺序的 zIndex 属性。仅当矩形恒定并且未指定高度或 extrudedHeight 时才有效。 Gets or sets the zIndex Property specifying the ordering of the rectangle. Only has an effect if the rectangle is constant and neither height or extrudedHeight are specified.
-
默认值： Default Value:
0
方法 Methods
clone(result) → RectangleGraphics
复制此实例。 Duplicates this instance.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
result |
RectangleGraphics | 可选 optional 用于存储结果的对象。 The object onto which to store the result. |
返回： Returns:
修改后的结果参数或新实例（如果未提供）。 The modified result parameter or a new instance if one was not provided.
将此对象上每个未分配的属性分配给所提供的源对象上相同属性的值。 Assigns each unassigned property on this object to the value of the same property on the provided source object.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
source |
RectangleGraphics | 要合并到此对象中的对象。 The object to be merged into this object. |
类型定义 Type Definitions
RectangleGraphics 构造函数的初始化选项 Initialization options for the RectangleGraphics constructor
属性： Properties:
| 名称 Name | 类型 Type | Attributes | 默认值 Default | 说明 Description |
|---|---|---|---|---|
show |
Property | boolean |
<可选> <optional> |
true | 指定矩形可见性的布尔属性。 A boolean Property specifying the visibility of the rectangle. |
coordinates |
Property | Rectangle |
<可选> <optional> |
该属性指定 The Property specifying the Rectangle. |
|
height |
Property | number |
<可选> <optional> |
0 | 一个数字属性，指定矩形相对于椭球面的高度。 A numeric Property specifying the altitude of the rectangle relative to the ellipsoid surface. |
heightReference |
Property | HeightReference |
<可选> <optional> |
HeightReference.NONE | 指定高度相对值的属性。 A Property specifying what the height is relative to. |
extrudedHeight |
Property | number |
<可选> <optional> |
一个数字属性，指定矩形的拉伸面相对于椭球面的高度。 A numeric Property specifying the altitude of the rectangle's extruded face relative to the ellipsoid surface. | |
extrudedHeightReference |
Property | HeightReference |
<可选> <optional> |
HeightReference.NONE | 指定 extrudedHeight 相对于什么的属性。 A Property specifying what the extrudedHeight is relative to. |
rotation |
Property | number |
<可选> <optional> |
0.0 | 一个数字属性，指定矩形从北顺时针旋转。 A numeric property specifying the rotation of the rectangle clockwise from north. |
stRotation |
Property | number |
<可选> <optional> |
0.0 | 一个数字属性，指定矩形纹理从北逆时针旋转。 A numeric property specifying the rotation of the rectangle texture counter-clockwise from north. |
granularity |
Property | number |
<可选> <optional> |
Cesium.Math.RADIANS_PER_DEGREE | 一个数字属性，指定矩形上点之间的角距离。 A numeric Property specifying the angular distance between points on the rectangle. |
fill |
Property | boolean |
<可选> <optional> |
true | 一个布尔属性，指定矩形是否填充有提供的材质。 A boolean Property specifying whether the rectangle is filled with the provided material. |
material |
MaterialProperty | Color |
<可选> <optional> |
Color.WHITE | 指定用于填充矩形的材质的属性。 A Property specifying the material used to fill the rectangle. |
outline |
Property | boolean |
<可选> <optional> |
false | 一个布尔属性，指定矩形是否有轮廓。 A boolean Property specifying whether the rectangle is outlined. |
outlineColor |
Property | Color |
<可选> <optional> |
Color.BLACK | 指定的属性 A Property specifying the Color 的轮廓。 of the outline. |
outlineWidth |
Property | number |
<可选> <optional> |
1.0 | 指定轮廓宽度的数字属性。 A numeric Property specifying the width of the outline. |
shadows |
Property | ShadowMode |
<可选> <optional> |
ShadowMode.DISABLED | 一个枚举属性，指定矩形是否投射或接收来自光源的阴影。 An enum Property specifying whether the rectangle casts or receives shadows from light sources. |
distanceDisplayCondition |
Property | DistanceDisplayCondition |
<可选> <optional> |
一个属性，指定该矩形将在距相机的距离处显示。 A Property specifying at what distance from the camera that this rectangle will be displayed. | |
classificationType |
Property | ClassificationType |
<可选> <optional> |
ClassificationType.BOTH | 一个枚举属性，指定此矩形在地面上时是否对地形、3D Tiles或两者进行分类。 An enum Property specifying whether this rectangle will classify terrain, 3D Tiles, or both when on the ground. |
zIndex |
Property | number |
<可选> <optional> |
0 | 指定用于排序地面几何体的 zIndex 的属性。仅当矩形恒定并且未指定高度或 extrudedHeight 时才有效。 A Property specifying the zIndex used for ordering ground geometry. Only has an effect if the rectangle is constant and neither height or extrudedHeight are specified. |