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 "stipple-selected" signal that is a wrapper around the "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