Class CircularArcByBulgeAbstract

Circular-arc-by-bulge interface. A circular-arc-by-bulge is a Shape that represents a circular arc defined by two points and a bulge factor in the 2D space. A bulge factor of 1 means that the arc defines half a circle. As the bulge factor goes towards 0 the arc becomes flatter (i.e. the radius of the arc's circle increases). The sign of the bulge indicates whether the bulge is on the left side or right side of the vector from start to end point.

More specifically, consider the chord between start point S and end point E with a point C in the middle of it. The midpoint M of the arc is located on a line that starts from C and is oriented along the normal. The bulge factor is the ratio of the distance of MC and SC. The sign of the bulge indicates whether the midpoint is on the left side (positive) or right side (negative) of the vector from start to end point.

The circular-arc-by-bulge is defined by:

  • The point (read-only).
  • The start point startPoint. (read-only).
  • The end point endPoint. (read-only).
  • The bulge factor bulge. (read-write).
A circular-arc-by-bulge cannot be instantiated directly. It must be instantiated using createCircularArcByBulge.

Hierarchy

Constructors

constructor

Accessors

bounds bulge center coordinateType endPoint focusPoint radius reference startAzimuth startPoint sweepAngle type

Methods

contains2D contains2DCoordinates contains2DPoint copy equals move2DToCoordinates move2DToPoint moveEndPoint2DToCoordinates moveEndPoint2DToPoint moveStartPoint2DToCoordinates moveStartPoint2DToPoint toString translate2D translateEndPoint2D translateStartPoint2D

Constructors

constructor

Accessors

Abstract bounds

  • get bounds(): Bounds

  • The bounds of this shape. This property is to be treated in a read only manner. An error will be thrown when trying to assign to this property. Note that the bounds property is not immutable. Modifying properties of the bounds property may corrupt your data.

    Returns Bounds

Abstract bulge

  • get bulge(): number

  • The bulge factor of the arc. This field is mutable.

    The bulge factor is the ratio of (1) the distance between the arc midpoint and the center of the arc's chord, and (2) half the length of the arc's chord. The sign of the bulge indicates whether the midpoint is on the left side (positive) or right side (negative) of the vector from start to end point. So a bulge factor with an absolute value of 1 means a half-circle, smaller than 1 means a less bulging arc and larger than 1 means an arc that bulges out in the start and end point.

    Returns number

  • set bulge(value): void

  • Parameters

    • value: number

    Returns void

Abstract center

  • get center(): Point

  • The center point of the circle defining the circular arc. This field is read-only.

    Please use move2DToCoordinates or move2DToPoint to move the center point to a new position.

    Returns Point

Abstract coordinateType

  • get coordinateType(): CoordinateType

  • The coordinate type this shape. This property is read only. An Error will be thrown when trying to assign to this property.

    Returns CoordinateType

Abstract endPoint

  • get endPoint(): Point

  • The end point of this circular arc.

    Returns Point

Abstract focusPoint

  • get focusPoint(): Point

  • The focus point of this shape. This property is read only. An error will be thrown when trying to assign to this property. This property contains an object but should be treated with value semantics: changes to the shape will not be reflected in the focusPoint that was retrieved from this Polygon before the modification.

    Returns Point

Abstract radius

  • get radius(): number

  • The radius of the circle defining the circular arc.

    Returns number

reference

  • get reference(): null | CoordinateReference

  • The spatial reference of this shape. This property is read only. An Error will be thrown when trying to assign to this property.

    Returns null | CoordinateReference

Abstract startAzimuth

  • get startAzimuth(): number

  • The start angle. It is defined as an azimuth: in degrees, positive clockwise, starting up/north.

    Returns number

Abstract startPoint

  • get startPoint(): Point

  • The start point of this circular arc.

    Returns Point

Abstract sweepAngle

  • get sweepAngle(): number

  • The angle over which the arc extends. It is defined in degrees, positive clockwise.

    Returns number

type

Methods

contains2D

  • Determines whether a given point is inside this shape. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).

    Parameters

    • x: number | Point | Bounds

      The point for which containment must be checked. If a 3D point is passed to this function, it will be treated as a 2D point: the z coordinate (height) will be ignored. The reference of this point must be the same reference as this Shape

    • Optional y: number

    Returns boolean

    true when the given point is contained in this shape

    Throws

    Point with another spatial reference

    Deprecated

    Please use contains2DPoint instead.

Abstract contains2DCoordinates

  • Determines whether the given point is inside this shape. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).

    Parameters

    • x: number

      The x coordinate of the point for which containment must be checked

    • y: number

      The y coordinate of the point for which containment must be checked

    Returns boolean

    true when the given point is contained in this shape

    Throws

    Point with another spatial reference

contains2DPoint

  • Determines whether the given point is inside this shape. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).

    Parameters

    • point: Point

      The point for which containment must be checked.

    Returns boolean

    true when the given point is contained in this shape

    Throws

    Point with another spatial reference

Abstract copy

equals

  • Indicates whether this shape is equal to another.

    Parameters

    • aArc: Shape

      the other shape this shape is compared with.

    Returns boolean

    true if both shapes are equal, false otherwise.

move2DToCoordinates

  • Translates this shape so that its center point ends up at the specified position.

    Parameters

    • x: number

      x coordinate value

    • y: number

      y coordinate value

    Returns void

move2DToPoint

  • Translates this shape so that its center point ends up at the specified position.

    Parameters

    Returns void

    Throws

    InvalidReferenceError when the reference of the Point parameter does not correspond with the reference of this shape.

Abstract moveEndPoint2DToCoordinates

  • Moves the end point of this circular arc to the given coordinates

    Parameters

    • x: number

      The new x coordinate of the end point on this circular arc

    • y: number

      The new y coordinate of the end point on this circular arc

    Returns void

moveEndPoint2DToPoint

  • Moves the end point of this circular arc to the given point

    Parameters

    Returns void

Abstract moveStartPoint2DToCoordinates

  • Moves the start point of this circular arc to the given coordinates

    Parameters

    • x: number

      The new x coordinate of the start point on this circular arc

    • y: number

      The new y coordinate of the start point on this circular arc

    Returns void

moveStartPoint2DToPoint

  • Moves the start point of this circular arc to the given point

    Parameters

    Returns void

toString

  • Converts the shape to a string. This functionality is for debugging purposes only. Results of toString cannot be used to uniquely identify a shape instance.

    Returns string

translate2D

  • Translates the shape over the given vector in 2D space.

    Parameters

    • aDeltaX: number

      The x coordinate of the translation vector

    • aDeltaY: number

      The y coordinate of the translation vector

    Returns void

Abstract translateEndPoint2D

  • Translates the end point of this circular arc from its current position over the given translation vector to another location.

    Parameters

    • aDeltaX: number

      vector x coordinate value

    • aDeltaY: number

      vector y coordinate value

    Returns void

Abstract translateStartPoint2D

  • Translates the start point of this circular arc from its current position over the given translation vector to another location.

    Parameters

    • aDeltaX: number

      vector x coordinate value

    • aDeltaY: number

      vector y coordinate value

    Returns void

Settings

Member Visibility

Theme