LineObject

LineObject — Defines a specialised GtkHBox to choose all characteristic of lines.

Synopsis




            LineObject;
GtkWidget*  lineObjectNew                   (const gchar *label);
void        lineObjectSet_color             (LineObject *line,
                                             float rgb[3]);
void        lineObjectSet_stipple           (LineObject *line,
                                             guint16 stipple);
void        lineObjectSet_use               (LineObject *line,
                                             gboolean status);
void        lineObjectSet_width             (LineObject *line,
                                             gint width);


Description

This widget looks like a GtkComboBox and it displays a list of preset patterns for line. These patterns are defined by a guint16 value that is given to OpenGL for line stipple.

This widget can emit a LineObject::stipple-selected signal that is a wrapper around the GtkComboBox::changed signal, but it is emitted only when a stipple is selected and this stipple is passed to the call back.

Details

LineObject

typedef struct _LineObject LineObject;

Private structure to store informations of a LineObject object.

Since 3.4


lineObjectNew ()

GtkWidget*  lineObjectNew                   (const gchar *label);

A LineObject widget is a widget allowing to choose the properties of a line. These properties are the line stipple pattern, its colour and its width. The colour is available through GtkRange and with a ColorComboBox widget. There is also a checkbox allowing to turn the line on or off.

label : the name of the group, output in bold.
Returns : a newly created LineObject widget.

Since 3.4


lineObjectSet_color ()

void        lineObjectSet_color             (LineObject *line,
                                             float rgb[3]);

The line can is drawn in a given colour. Change the interface values using this routine. The colour ranges are updated and if it correspond to a registered colour, it is selected in the combobox.

line : the object to modify ;
rgb : a RGB array.

lineObjectSet_stipple ()

void        lineObjectSet_stipple           (LineObject *line,
                                             guint16 stipple);

The line can be drawn with a given stipple pattern, call this routine to change the interface value.

line : the object to modify ;
stipple : a value.

lineObjectSet_use ()

void        lineObjectSet_use               (LineObject *line,
                                             gboolean status);

The line can be turn on or off, call this routine to change the interface status.

line : the object to modify ;
status : a boolean.

lineObjectSet_width ()

void        lineObjectSet_width             (LineObject *line,
                                             gint width);

The line can be drawn with a given width, call this routine to change the interface value.

line : the object to modify ;
width : a value.

See Also

ColorComboBox and StippleComboBox