trusty (3) dtk_create_rectangle_2p.3.gz

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)