| Gwyddion Widgets Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <libgwydgets/gwydgets.h> struct GwyShader; struct 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.
struct GwyShaderClass {
GtkWidgetClass parent_class;
void (*angle_changed)(GwyShader *shader);
void (*reserved1)(void);
};
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