![]() |
![]() |
![]() |
Gwyddion Widgets Library Reference Manual | ![]() |
---|
Gwy3DLabelGwy3DLabel — Label on Gwy3DView |
Gwy3DLabel; Gwy3DLabelClass; Gwy3DLabel* gwy_3d_label_new (const gchar *default_text); void gwy_3d_label_set_text (Gwy3DLabel *label, const gchar *text); const gchar* gwy_3d_label_get_text (Gwy3DLabel *label); gchar* gwy_3d_label_expand_text (Gwy3DLabel *label, GHashTable *variables); void gwy_3d_label_reset (Gwy3DLabel *label); void gwy_3d_label_reset_text (Gwy3DLabel *label); gboolean gwy_3d_label_get_fixed_size (Gwy3DLabel *label); void gwy_3d_label_set_fixed_size (Gwy3DLabel *label, gboolean fixed_size); gdouble gwy_3d_label_user_size (Gwy3DLabel *label, gdouble user_size); GtkAdjustment* gwy_3d_label_get_delta_x_adjustment (Gwy3DLabel *label); GtkAdjustment* gwy_3d_label_get_delta_y_adjustment (Gwy3DLabel *label); GtkAdjustment* gwy_3d_label_get_rotation_adjustment (Gwy3DLabel *label); GtkAdjustment* gwy_3d_label_get_size_adjustment (Gwy3DLabel *label);
"default-text" gchararray : Read / Write / Construct Only "delta-x" gdouble : Read / Write "delta-y" gdouble : Read / Write "fixed-size" gboolean : Read / Write "rotation" gdouble : Read / Write "size" gdouble : Read / Write
typedef struct { GObjectClass parent_class; void (*value_changed)(Gwy3DLabel *label); } Gwy3DLabelClass;
Gwy3DLabel* gwy_3d_label_new (const gchar *default_text);
Creates a new 3D view label.
default_text : |
Label default text. |
Returns : | A newly created 3D label. |
void gwy_3d_label_set_text (Gwy3DLabel *label, const gchar *text);
Sets the text of a 3D label.
label : |
A 3D label. |
text : |
New label text. |
const gchar* gwy_3d_label_get_text (Gwy3DLabel *label);
Gets the text of a 3D label.
label : |
A 3D label. |
Returns : | The label text. The returned string is owned by label and must no be modified or freed. |
gchar* gwy_3d_label_expand_text (Gwy3DLabel *label, GHashTable *variables);
Substitutes variables in label text.
label : |
A 3D label. |
variables : |
Hash table with variable values. |
Returns : | A newly allocated string with variables from variables substituted
with values.
|
void gwy_3d_label_reset (Gwy3DLabel *label);
Resets all 3D label properties and text to default values.
label : |
A 3D label. |
void gwy_3d_label_reset_text (Gwy3DLabel *label);
Resets 3D label text to default values.
label : |
A 3D label. |
gboolean gwy_3d_label_get_fixed_size (Gwy3DLabel *label);
Queries a 3D label for its label size policy.
label : |
A 3D label. |
Returns : | TRUE if label size is fixed, FALSE if it's overriden by automatic
size.
|
void gwy_3d_label_set_fixed_size (Gwy3DLabel *label, gboolean fixed_size);
Sets 3D label size policy.
label : |
A 3D label. |
fixed_size : |
Whether label size should be fixed.
|
gdouble gwy_3d_label_user_size (Gwy3DLabel *label, gdouble user_size);
Eventually sets size of a 3D label.
If label size si fixed, it does not change and it is simply returned.
Otherwise label size is changed and user_size
itself is returned.
label : |
A 3D label. |
user_size : |
Size of the text to be set. |
Returns : | Size of label. |
GtkAdjustment* gwy_3d_label_get_delta_x_adjustment (Gwy3DLabel *label);
Gets the horizontal offest adjustment of a 3D label.
label : |
A 3D label. |
Returns : | The horizontal offest adjustment. |
GtkAdjustment* gwy_3d_label_get_delta_y_adjustment (Gwy3DLabel *label);
Gets the vertical offest adjustment of a 3D label.
label : |
A 3D label. |
Returns : | The vertical offest adjustment. |
GtkAdjustment* gwy_3d_label_get_rotation_adjustment (Gwy3DLabel *label);
Gets the rotation adjustment of a 3D label.
label : |
A 3D label. |
Returns : | The rotation adjustment. |
GtkAdjustment* gwy_3d_label_get_size_adjustment (Gwy3DLabel *label);
Gets the size adjustment of a 3D label.
label : |
A 3D label. |
Returns : | The size adjustment. |
default-text
" property"default-text" gchararray : Read / Write / Construct Only
Default label text.
Default value: ""
delta-x
" property"delta-x" gdouble : Read / Write
The :delta-x property represents horizontal label offset in pixels (in screen coordinates after mapping from 3D to 2D).
Allowed values: [-1000,1000]
Default value: 0
delta-y
" property"delta-y" gdouble : Read / Write
The :delta-y property represents vertical label offset in pixels (in screen coordinates after mapping from 3D to 2D).
Allowed values: [-1000,1000]
Default value: 0
fixed-size
" property"fixed-size" gboolean : Read / Write
The :fixed-size property controls whether the :size property is kept and honoured, or conversely ignored and overwritten with automatic size.
Default value: FALSE
rotation
" property"rotation" gdouble : Read / Write
The :rotation property represents label rotation in radians, counterclokwise (on screen, after mapping from 3D to 2D).
Allowed values: [-3.14159,3.14159]
Default value: 0
size
" property"size" gdouble : Read / Write
The :size property represents label size in pixels. When :fixed_size
is FALSE
, its value is overwritten with automatic size.
Allowed values: [1,100]
Default value: 14
void user_function (Gwy3DLabel *gwy3dlabel, gpointer user_data);
gwy3dlabel : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |
<< Gwy3DWindow | General Widgets >> |