push_primitive_clip


Description:

public void push_primitive_clip (Primitive primitive, float bounds_x1, float bounds_y1, float bounds_x2, float bounds_y2)

Sets a new clipping area using a 2D shaped described with a Primitive.

The shape must not contain self overlapping geometry and must lie on a single 2D plane. A bounding box of the 2D shape in local coordinates (the same coordinates used to describe the shape) must be given. It is acceptable for the bounds to be larger than the true bounds but behaviour is undefined if the bounds are smaller than the true bounds.

The primitive is transformed by the current model-view matrix and the silhouette is intersected with the previous clipping area. To restore the previous clipping area, call pop_clip.

Parameters:

this

A Framebuffer pointer

primitive

A Primitive describing a flat 2D shape

bounds_x1

x coordinate for the top-left corner of the primitives bounds

bounds_y1

y coordinate for the top-left corner of the primitives bounds

bounds_x2

x coordinate for the bottom-right corner of the primitives bounds.

bounds_y2

y coordinate for the bottom-right corner of the primitives bounds.