NAME¶
dtk_create_triangle_2p, dtk_create_rectangle_hw - Create and modify rectangular
shapes
SYNOPSIS¶
#include <drawtk.h>
dtk_hshape dtk_create_rectangle_2p(dtk_hshape shp,
float p1_x, float p1_y, float
p2_x, float p2_y,
int filled, const float *color);
dtk_hshape dtk_create_rectangle_hw(dtk_hshape shp,
float cx, float cy, float h, float
w,
int filled, const float *color);
DESCRIPTION¶
dtk_create_rectangle_2p() creates a rectangle whose the opposing corners
are located at (
p1_x,
p1_y) and (
p2_x,
p2_y).
dtk_create_rectangle_hw() creates a rectangle with height
h and
width
w and with its center located at (
cx,
cy) in the
original frame.
shp,
filled and
color have the same usage and meaning as
for other shape creation function:
- *
- shp can be used to modify a previously created shape. If it is
non-null, the handle will be used to modify the shape referenced by
shp: no new shape is created and the returned value is ensured to
be shp in case of success, NULL otherwise. If shp is
NULL, the function will attempt to create a new shape.
- *
- filled is set to 0 if the described shape should be a continuous
line or a non-null value if the shape is supposed to be filled
polygon.
- *
- color should point to a 4 float array containing a normalized RGBA
value (i.e. each component is between 0.0 and 1.0).
RETURN VALUE¶
In case of success these functions return the handle to the newly created or
modified shape. If the
shp argument is non-null, the handle returned is
the same value. In case of error,
NULL is returned.
SEE ALSO¶
dtk_destroy_shape(3)