![]() | ![]() | ![]() | Gwyddion Widgets Library Reference Manual | ![]() |
---|
GwyShader — Spherical angle selector
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);
struct GwyShaderClass { GtkWidgetClass parent_class; void (*angle_changed)(GwyShader *shader); gpointer reserved1; };
GtkWidget* gwy_shader_new (const gchar *gradient);
Creates a new spherical shader.
The widget takes up all the space allocated for it.
gradient : | Name of gradient to color the spehere with. Can be NULL to use the default gray gradient. |
Returns : | The new shader as a GtkWidget. |
gdouble gwy_shader_get_theta (GwyShader *shader);
Returns the theta coordinate of a shader.
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.
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.
shader : | A shader. |
theta : | 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.
shader : | A shader. |
phi : | 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.
shader : | A shader. |
theta : | The theta coordinate to set. See gwy_shader_get_theta() for description. |
phi : | 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.
shader : | 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.
shader : | A shader. |
gradient : | Name of gradient shader should use. It should exist. |
GtkUpdateType gwy_shader_get_update_policy (GwyShader *shader);
Returns the update policy of a shader.
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.
shader : | A shader. |
update_policy : | The update policy shader should use. |
<< GwyStatusbar | GwyValUnit >> |