StippleComboBox

StippleComboBox — Defines a specialised GtkComboBox to choose patterns for lines.

Synopsis

                    StippleComboBox;
GtkWidget*          stippleComboBox_new                 ();
void                stippleComboBoxAdd_pattern          (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);
guint16             stippleComboBoxGet_selectedStipple  (StippleComboBox *stippleComboBox);
GdkPixbuf*          stippleComboBoxGet_pixbufFromStipple
                                                        (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);
gboolean            stippleComboBoxSet_selectionByStipple
                                                        (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);
GdkPixbuf*          stippleComboBoxBuild_stippleStamp   (guint16 stipple);

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

StippleComboBox

typedef struct _StippleComboBox StippleComboBox;

Private structure to store informations of a StippleComboBox object.

Since 3.4


stippleComboBox_new ()

GtkWidget*          stippleComboBox_new                 ();

A StippleComboBox widget is like a GtkComboBox widget, but it is already filled with predefined line patterns (call stipple). Using this widget is a convienient way to share stipples between all part of V_Sim and to give a consistent look of all stipple selection.

Returns :

a newly created StippleComboBox widget.

Since 3.4


stippleComboBoxAdd_pattern ()

void                stippleComboBoxAdd_pattern          (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);

Create an entry in the ComboBox for the given stipple pattern if it does not already exist.

stippleComboBox :

a StippleComboBox widget ;

stipple :

a pattern value.

Since 3.4


stippleComboBoxGet_selectedStipple ()

guint16             stippleComboBoxGet_selectedStipple  (StippleComboBox *stippleComboBox);

The user can access to the selected Stipple object using this method.

stippleComboBox :

a StippleComboBox widget.

Returns :

a pattern value (or 65535).

Since 3.4


stippleComboBoxGet_pixbufFromStipple ()

GdkPixbuf*          stippleComboBoxGet_pixbufFromStipple
                                                        (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);

The stippleComboBox has little pixbufs to represent the stipple. User methods can use these pixbufs but should considered them read-only.

stippleComboBox :

a StippleComboBox widget ;

stipple :

a pattern value.

Returns :

a pixbuf pointer corresponding to the little image shown on the stippleComboBox.

Since 3.4


stippleComboBoxSet_selectionByStipple ()

gboolean            stippleComboBoxSet_selectionByStipple
                                                        (StippleComboBox *stippleComboBox,
                                                         guint16 stipple);

Use this method to set the ComboBox on the given stipple. This emits a 'stipple-channel' signal if the stipple is changed, which means, a previous stipple has been modified, or a new stipple is selected.

stippleComboBox :

a StippleComboBox widget ;

stipple :

a pattern value.

Returns :

TRUE if the stipple already exists in the model.

Since 3.4


stippleComboBoxBuild_stippleStamp ()

GdkPixbuf*          stippleComboBoxBuild_stippleStamp   (guint16 stipple);

This method is used to create pixbuf representing stipples.A new pixbuf is created.

stipple :

a pattern value.

Returns :

a pixbuf pointer.

Since 3.4

See Also

ShadeComboBox