# RectangleGeometry

#### new Cesium.RectangleGeometry(options)
Core/RectangleGeometry.js 548

  A description of a cartographic rectangle on an ellipsoid centered at the origin. Rectangle geometry can be rendered with both `Primitive` and `GroundPrimitive`.

  Name | Type | Description
  --- | --- | ---
  `options` | Object | Object with the following properties:
  Name | Type | Default | Description
  --- | --- | --- | ---
  `rectangle` | Rectangle |  | A cartographic rectangle with north, south, east and west properties in radians.
  `vertexFormat` | VertexFormat | `VertexFormat.DEFAULT` | optional The vertex attributes to be computed.
  `ellipsoid` | Ellipsoid | `Ellipsoid.WGS84` | optional The ellipsoid on which the rectangle lies.
  `granularity` | Number | `CesiumMath.RADIANS_PER_DEGREE` | optional The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  `height` | Number | `0.0` | optional The height from the surface of the ellipsoid.
  `rotation` | Number | `0.0` | optional The rotation of the rectangle, in radians. A positive rotation is counter-clockwise.
  `stRotation` | Number | `0.0` | optional The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
  `extrudedHeight` | Number |  | optional Height of extruded surface.
  `closeTop` | Boolean | `true` | optional Specifies whether the rectangle has a top cover when extruded.
  `closeBottom` | Boolean | `true` | optional Specifies whether the rectangle has a bottom cover when extruded.

  ##### Throws:

  - DeveloperError : `options.rectangle.north` must be in the interval [`-Pi/2`, `Pi/2`].
  - DeveloperError : `options.rectangle.south` must be in the interval [`-Pi/2`, `Pi/2`].
  - DeveloperError : `options.rectangle.east` must be in the interval [`-Pi`, `Pi`].
  - DeveloperError : `options.rectangle.west` must be in the interval [`-Pi`, `Pi`].
  - DeveloperError : `options.rectangle.north` must be greater than `options.rectangle.south`.

  ##### Example:

      // 1. create an rectangle
      var rectangle = new Cesium.RectangleGeometry({
        ellipsoid : Cesium.Ellipsoid.WGS84,
        rectangle : Cesium.Rectangle.fromDegrees(-80.0, 39.0, -74.0, 42.0),
        height : 10000.0
      });
      var geometry = Cesium.RectangleGeometry.createGeometry(rectangle);

      // 2. create an extruded rectangle without a top
      var rectangle = new Cesium.RectangleGeometry({
        ellipsoid : Cesium.Ellipsoid.WGS84,
        rectangle : Cesium.Rectangle.fromDegrees(-80.0, 39.0, -74.0, 42.0),
        height : 10000.0,
        extrudedHeight: 300000,
        closeTop: false
      });
      var geometry = Cesium.RectangleGeometry.createGeometry(rectangle);

  ##### Demo:

  - Cesium Sandcastle Rectangle Demo

  ##### See:

  - RectangleGeometry#createGeometry

### Members

#### staticCesium.RectangleGeometry.packedLength : Number
Core/RectangleGeometry.js 591

  The number of elements used to pack the object into an array.

### Methods

#### staticCesium.RectangleGeometry.createGeometry(rectangleGeometry) → Geometry
Core/RectangleGeometry.js 722

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

  Name | Type | Description
  --- | --- | ---
  `rectangleGeometry` | RectangleGeometry | A description of the rectangle.

  ##### Returns:

  The computed vertices and indices.

  ##### Throws:

  - DeveloperError : Rotated rectangle is invalid.

#### staticCesium.RectangleGeometry.pack(value, array, startingIndex)
Core/RectangleGeometry.js 600

  Stores the provided instance into the provided array.

  Name | Type | Default | Description
  --- | --- | --- | ---
  `value` | RectangleGeometry |  | The value to pack.
  `array` | Array.<Number> |  | The array to pack into.
  `startingIndex` | Number | `0` | optional The index into the array at which to start packing the elements.

#### staticCesium.RectangleGeometry.unpack(array, startingIndex, result) → RectangleGeometry
Core/RectangleGeometry.js 656

  Retrieves an instance from a packed array.

  Name | Type | Default | Description
  --- | --- | --- | ---
  `array` | Array.<Number> |  | The packed array.
  `startingIndex` | Number | `0` | optional The starting index of the element to be unpacked.
  `result` | RectangleGeometry |  | optional The object into which to store the result.

  ##### Returns:

  The modified result parameter or a new RectangleGeometry instance if one was not provided.