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.
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. |