draw_rectangles


Description:

public void draw_rectangles (Pipeline pipeline, float[] coordinates, uint n_rectangles)

Draws a series of rectangles to this with the given pipeline state in the same way that draw_rectangle does.

The top left corner of the first rectangle is positioned at (coordinates[0], coordinates[1]) and the bottom right corner is positioned at (coordinates[2], coordinates[3]). The positions for the second rectangle are (coordinates[4], coordinates[5]) and (coordinates[6], coordinates[7]) and so on...

<note>The position is the position before the rectangle has been transformed by the model-view matrix and the projection matrix. </note>

As a general rule for better performance its recommended to use this this API instead of calling draw_textured_rectangle separately for multiple rectangles if all of the rectangles will be drawn together with the same pipeline state.

Parameters:

this

A destination Framebuffer

pipeline

A Pipeline state object

coordinates

an array of coordinates containing groups of 4 float values: [x_1, y_1, x_2, y_2] that are interpreted as two position coordinates; one for the top left of the rectangle (x1, y1), and one for the bottom right of the rectangle (x2, y2).

n_rectangles

number of rectangles defined in coordinates.