.\"Copyright 2010-2011 (c) EPFL
.TH DTK_CREATE_TRIANGLE 3 2011 "EPFL" "Draw Toolkit manual"
.SH NAME
dtk_create_triangle - Create and modify triangle shape
.SH SYNOPSIS
.LP
.B #include <drawtk.h>
.sp
.BI "dtk_hshape dtk_create_triangle(dtk_hshape " shp ","
.br
.BI "                float " x1 ", float " y1 ",
.br
.BI "                float " x2 ", float " y2 ","
.br
.BI "                float " x3 ", float " y3 ","
.br
.BI "                int " filled ", const float *" color ");"
.br
.SH DESCRIPTION
.LP
\fBdtk_create_triangle\fP() creates a triangle between the vertices
(\fIx1\fP,\fIy1\fP), (\fIx2\fP,\fIy2\fP) and (\fIx3\fP,\fIy3\fP).
.LP
\fIshp\fP, \fIfilled\fP and \fIcolor\fP have the same usage and meaning as for
other shape creation function:
.IP " *" 3
\fIshp\fP 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 \fIshp\fP: no new
shape is created and the returned value is ensured to be \fIshp\fP in case of
success, \fINULL\fP otherwise. If \fIshp\fP is \fINULL\fP, the function will
attempt to create a new shape.
.LP
.IP " *" 3
\fIfilled\fP 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.
.LP
.IP " *" 3
\fIcolor\fP should point to a 4 float array containing a normalized RGBA value
(i.e. each component is between 0.0 and 1.0).
.SH "RETURN VALUE"
.LP
In case of success these functions return the handle to the newly created or modified
shape. If the \fIshp\fP argument is non-null, the handle returned is the
same value. In case of error, \fINULL\fP is returned.
.SH "SEE ALSO"
.BR dtk_destroy_shape (3)