# PolygonKey

class `PolygonKey` : public HPS::GeometryKey

  The PolygonKey class is a smart pointer to a database object. It is a handle to a polygon created by SegmentKey::InsertPolygon.

  Public Functions

  void `Consume`(PolygonKit &in_kit)

    Completely replaces all settings on this PolygonKit with those set on the specified kit and resets the kit.

    Parameters: | in_kit – The kit from which to get the settings to replace on this PolygonKit.

  PolygonKey &`EditPointsByDeletion`(size_t in_offset, size_t in_count)

    Remove the specified number of points from this PolygonKey at the specified offset.

    Parameters: | in_offset – The offset into the points for PolygonKey at which to remove points. in_count – The number of points to remove.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`EditPointsByInsertion`(size_t in_offset, PointArray const &in_points)

    Add points to this PolygonKey at the specified offset.

    Parameters: | in_offset – The offset into the points for PolygonKey at which to add points. This value must be such that in_offset <= point_count for insertion to succeed. in_points – The points to add to this PolygonKey.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`EditPointsByInsertion`(size_t in_offset, size_t in_count, Point const in_points[])

    Add points to this PolygonKey at the specified offset.

    Parameters: | in_offset – The offset into the points for PolygonKey at which to add points. This value must be such that in_offset <= point_count for insertion to succeed. in_count – Size of the following array. in_points – The points to add to this PolygonKey.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`EditPointsByReplacement`(size_t in_offset, PointArray const &in_points)

    Replace the specified number of points for this PolygonKey at the specified offset.

    Parameters: | in_offset – The offset into the points for PolygonKey at which to start replacing points. in_points – The points to use to replace those on this PolygonKey.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`EditPointsByReplacement`(size_t in_offset, size_t in_count, Point const in_points[])

    Replace the specified number of points for this PolygonKey at the specified offset.

    Parameters: | in_offset – The offset into the points for PolygonKey at which to start replacing points. in_count – Size of the following array. in_points – The points to use to replace those on this PolygonKey.
    Returns: | A reference to this PolygonKey.

  size_t `GetPointCount`() const

    Retrieves the number of points in this polygon.

    Returns: | The number of points in this polygon.

  inline virtual HPS::Type `ObjectType`() const

    This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

    Returns: | The declared type of the object in question, which may differ from the true, underlying type.

  PolygonKey &`operator=`(PolygonKey &&in_that)

    The move assignment operator transfers the underlying impl of the rvalue reference to this PolygonKey thereby avoiding a copy.

    Parameters: | in_that – An rvalue reference to a PolygonKey to take the impl from.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`operator=`(PolygonKey const &in_that)

    Associate this PolygonKey with the same underlying impl as the source PolygonKey.

    Parameters: | in_that – The source PolygonKey for the assignment.
    Returns: | A reference to this PolygonKey.

  `PolygonKey`()

    The default constructor creates an uninitialized PolygonKey object. The Type() function will return Type::None.

  explicit `PolygonKey`(Key const &in_that)

    This constructor creates an PolygonKey object that shares the underlying smart-pointer of the source Key. The copy will only be successful if the source key is really an upcast of a polygon key. Otherwise the copy will fail and the resulting PolygonKey will be invalid.

    Parameters: | in_key – The source Key to copy.

  `PolygonKey`(PolygonKey &&in_that)

    The move constructor creates a PolygonKey by transferring the underlying impl of the rvalue reference to this PolygonKey thereby avoiding a copy and allocation.

    Parameters: | in_that – An rvalue reference to a PolygonKey to take the impl from.

  `PolygonKey`(PolygonKey const &in_that)

    The copy constructor creates a PolygonKey object that shares the underlying smart-pointer of the source PolygonKey.

    Parameters: | in_that – The source PolygonKey to copy.

  void `Set`(PolygonKit const &in_kit)

    Replace those settings on this PolygonKey with those set on the specified kit.

    Parameters: | in_kit – The kit from which to get the settings to replace on this PolygonKey.

  PolygonKey &`SetPoints`(PointArray const &in_points)

    Replace the points on this PolygonKey with the specified points.

    Parameters: | in_points – The points to use to replace those on this PolygonKey.
    Returns: | A reference to this PolygonKey.

  PolygonKey &`SetPoints`(size_t in_count, Point const in_points[])

    Replace the points on this PolygonKey with the specified points.

    Parameters: | in_count – Size of the following array. in_points – The points to use to replace those on this PolygonKey.
    Returns: | A reference to this PolygonKey.

  void `Show`(PolygonKit &out_kit) const

    Copy the contents of this PolygonKey into the specified kit.

    Parameters: | out_kit – The kit to populate with the contents of this PolygonKey.

  bool `ShowPoints`(PointArray &out_points) const

    Show the points for this PolygonKey.

    Parameters: | out_points – The points for this PolygonKey.
    Returns: | true if points were set, false otherwise.

  bool `ShowPointsByList`(size_t in_count, size_t const in_indices[], PointArray &out_points) const

    Show a subset of the points for this PolygonKey by list.

    Parameters: | in_count – The number of points to show. in_indices – The list of point indices to show. out_points – The requested points for this PolygonKey.
    Returns: | true if all requested points were set, false otherwise.

  bool `ShowPointsByList`(SizeTArray const &in_indices, PointArray &out_points) const

    Show a subset of the points for this PolygonKey by list.

    Parameters: | in_indices – The list of point indices to show. out_points – The requested points for this PolygonKey.
    Returns: | true if all requested points were set, false otherwise.

  bool `ShowPointsByRange`(size_t in_start_index, size_t in_count, PointArray &out_points) const

    Show a subset of the points for this PolygonKey by range.

    Parameters: | in_start_index – The first point to show. in_count – The number of points to show. out_points – The requested points for this PolygonKey.
    Returns: | true if all requested points were set, false otherwise.

  PointArray `Triangulate`() const

    Divides the polygon into triangles. Note that the data associated with this polygon is left untouched. If the polygon is self-intersecting, the intersection points will be calculated and taken into account If an error is encountered while triangulating the polygon, the returned array will be empty.

    Returns: | An array of points. Each triplet of points represents one of the triangle that was computed. For example, the returned values 0th, 1st and 2nd points represent the first triangle, and the 3rd, 4th and 5th points represent second one, and so forth.

  `~PolygonKey`()

  Public Static Attributes

  static const HPS::Type `staticType` = HPS::Type::PolygonKey

Hello I'm HOOPSY!

HOOPSY BETA

Hello I am HOOPSY! your Docs generative AI assistant.

Ask me anything about HOOPS Visualize HPS or choose a sample question below to start a conversation:

Additional info

HOOPSY may store chats to provide and maintain the service according to OpenAI's data policy.

This feature is currently experimental. While we are continually enhancing its performance and quality, the underlying AI model may generate inaccurate or fabricated responses, especially if prompted to do so.

New Conversation
Continue generating