| Gwyddion Widgets Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <libgwydgets/gwydgets.h>
GwyShader;
GwyShaderClass;
GtkWidget* gwy_shader_new (const gchar *gradient);
gdouble gwy_shader_get_theta (GwyShader *shader);
gdouble gwy_shader_get_phi (GwyShader *shader);
void gwy_shader_set_theta (GwyShader *shader,
gdouble theta);
void gwy_shader_set_phi (GwyShader *shader,
gdouble phi);
void gwy_shader_set_angle (GwyShader *shader,
gdouble theta,
gdouble phi);
const gchar* gwy_shader_get_gradient (GwyShader *shader);
void gwy_shader_set_gradient (GwyShader *shader,
const gchar *gradient);
GtkUpdateType gwy_shader_get_update_policy (GwyShader *shader);
void gwy_shader_set_update_policy (GwyShader *shader,
GtkUpdateType update_policy);
GwyShader is a spherical angle selector that allows user to change angle by simply moving the north pole of a sphere around with mouse. It can display the sphere colored with various GwyGradient's.
typedef struct {
GtkWidgetClass parent_class;
void (*angle_changed)(GwyShader *shader);
void (*reserved1)(void);
} GwyShaderClass;
GtkWidget* gwy_shader_new (const gchar *gradient);
Creates a new spherical shader.
The widget takes up all the space allocated for it.
gdouble gwy_shader_get_theta (GwyShader *shader);
Returns the theta coordinate of a shader.
|
A shader. |
Returns : |
The theta coordinate, in radians. Theta coordinate is angle from sphere's north pole. |
gdouble gwy_shader_get_phi (GwyShader *shader);
Returns the phi coordinate of a shader.
|
A shader. |
Returns : |
The phi coordinate, in radians. Phi coordinate is orientation in horizontal plane, measured from x axis, counterclockwise. |
void gwy_shader_set_theta (GwyShader *shader,gdouble theta);
Sets the theta coordinate of a shader.
|
A shader. |
|
The theta coordinate to set. See gwy_shader_get_theta() for
description.
|
void gwy_shader_set_phi (GwyShader *shader,gdouble phi);
Sets the phi coordinate of a shader.
|
A shader. |
|
The phi coordinate to set. See gwy_shader_get_phi() for description.
|
void gwy_shader_set_angle (GwyShader *shader,gdouble theta,gdouble phi);
Sets the spherical angle of a shader.
|
A shader. |
|
The theta coordinate to set. See gwy_shader_get_theta() for
description.
|
|
The phi coordinate to set. See gwy_shader_get_phi() for description.
|
const gchar* gwy_shader_get_gradient (GwyShader *shader);
Returns the name of color gradient a shader uses.
|
A shader. |
Returns : |
The gradient name. It must not be modified or freed. It may
differ the name that was used on initialization or set with
gwy_shader_set_gradient(), if the gradient didn't exist or
was renamed meanwhile.
|
void gwy_shader_set_gradient (GwyShader *shader,const gchar *gradient);
Sets the gradient a shader uses.
|
A shader. |
|
Name of gradient shader should use. It should exist.
|
GtkUpdateType gwy_shader_get_update_policy (GwyShader *shader);
Returns the update policy of a shader.
|
A shader. |
Returns : |
The update policy. |
void gwy_shader_set_update_policy (GwyShader *shader,GtkUpdateType update_policy);
Sets the update policy of a shader.
|
A shader. |
|
The update policy shader should use.
|
"gradient" property"gradient" gchar* : Read / Write
Name of gradient the sphere is colored with.
Default value: NULL
"update-policy" property"update-policy" GtkUpdateType : Read / Write
When value change causes signal emission.
Default value: GTK_UPDATE_CONTINUOUS