class

SF::ConvexShape

Inherits SF::Shape / SF::Drawable / SF::Transformable / Reference / Object

Specialized shape representing a convex polygon

This class inherits all the functions of SF::Transformable (position, rotation, scale, bounds, ...) as well as the functions of SF::Shape (outline, color, texture, ...).

It is important to keep in mind that a convex shape must always be... convex, otherwise it may not be drawn correctly. Moreover, the points must be defined in order; using a random order would result in an incorrect shape.

Usage example:

polygon = SF::ConvexShape.new
polygon.point_count = 3
polygon[0] = SF.vector2f(0, 0)
polygon[1] = SF.vector2f(0, 10)
polygon[2] = SF.vector2f(25, 5)
polygon.outline_color = SF::Color::Red
polygon.outline_thickness = 5
polygon.position = {10, 20}
# [...]
window.draw polygon

See also: SF::Shape, SF::RectangleShape, SF::CircleShape

Constructors

new(point_count : Int = 0)

Default constructor

  • point_count - Number of points of the polygon
Source

Instance methods

[](index)

Shorthand for get_point

Source
[]=(index, point)

Shorthand for set_point

Source
dup

Returns a shallow copy of this object.

This allocates a new object and copies the contents of self into it.

Source
finalize

Virtual destructor

Source
get_point(index : Int) : Vector2f

Get the position of a point

The returned point is in local coordinates, that is, the shape's transforms (position, rotation, scale) are not taken into account. The result is undefined if index is out of the valid range.

  • index - Index of the point to get, in range 0 ... point_count

Returns: Position of the index-th point of the polygon

See also: point=

Source
point_count

Get the number of points of the polygon

Returns: Number of points of the polygon

See also: point_count=

Source
point_count=(count : Int)

Set the number of points of the polygon

count must be greater than 2 to define a valid shape.

  • count - New number of points of the polygon

See also: point_count

Source
set_point(index : Int, point : Vector2 | Tuple)

Set the position of a point

Don't forget that the polygon must remain convex, and the points need to stay ordered! point_count= must be called first in order to set the total number of points. The result is undefined if index is out of the valid range.

  • index - Index of the point to change, in range 0 ... point_count
  • point - New position of the point

See also: point

Source