![]() |
![]() |
![]() |
Gwyddion Widgets Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
Gwy3DLabelGwy3DLabel — Label on Gwy3DView |
#include <libgwydgets/gwydgets.h> struct Gwy3DLabel; struct 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
); gdouble gwy_3d_label_user_size (Gwy3DLabel *label
,gdouble user_size
);
"default-text" gchar* : 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 "text" gchar* : Read / Write
struct Gwy3DLabelClass { GObjectClass parent_class; void (*reserved1)(void); void (*reserved2)(void); };
Gwy3DLabel * gwy_3d_label_new (const gchar *default_text
);
Creates a new 3D view label.
|
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.
|
A 3D label. |
|
New label text. |
const gchar * gwy_3d_label_get_text (Gwy3DLabel *label
);
Gets the text of a 3D 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.
|
A 3D label. |
|
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.
|
A 3D label. |
void gwy_3d_label_reset_text (Gwy3DLabel *label
);
Resets 3D label text to default values.
|
A 3D label. |
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.
|
A 3D label. |
|
Size of the text to be set. |
Returns : |
Size of label. |
"default-text"
property"default-text" gchar* : 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