With this function you can draw either an outline of a rectangle or a filled rectangle by defining an area where the (x1,y1) position is the top left corner and the (x2,y2) position is the bottom right corner. If it is filled you can define the individual colours for each corner point and if these colours are not the same, you will get a gradient effect from one to the other (the colour settings will over-ride the base colour set with the function draw_set_colour()). Please note that the rectangle being drawn may need different values (+/-1 on the x, y, or width or height) to be drawn with the desired dimensions due to differences across the various supported platforms.
NOTE If you want to draw a shape using a shader, you should be aware that most shaders expect the following inputs: vertex, texture, colour. However, when using this function, only vertex and colour data are being passed in, and so the shader may not draw anything (or draw something but not correctly). If you need to draw shapes in this way then the shader should be customised with this in mind.
draw_rectangle_colour(x1, y1, x2, y2, col1, col2, col3, col4, outline);
| Argument | Type | Description |
|---|---|---|
| x1 | Real | The x coordinate of the left of the rectangle. |
| y1 | Real | The y coordinate of the top of the rectangle. |
| x2 | Real | The x coordinate of the right of the rectangle. |
| y2 | Real | The y coordinate of the bottom of the rectangle. |
| col1 | Colour | The colour of the top left corner. |
| col2 | Colour | The colour of the top right corner. |
| col3 | Colour | The colour of the bottom right corner. |
| col4 | Colour | The colour of the bottom left corner. |
| outline | Boolean | Whether the rectangle is an outline (true) or filled in (false). |
N/A
draw_rectangle_colour(50, 50, 200, 200, c_black, c_white, c_black, c_white, false);
This would draw a filled-in square with a smooth black/white gradient between the corners.