st_theme_node_new ()

StThemeNode *
st_theme_node_new (StThemeContext *context,
                   StThemeNode *parent_node,
                   StTheme *theme,
                   GType element_type,
                   const char *element_id,
                   const char *element_class,
                   const char *pseudo_class,
                   const char *inline_style,
                   gboolean important);

Creates a new StThemeNode. Once created, a node is immutable. Of any of the attributes of the node (like the element_class ) change the node and its child nodes must be destroyed and recreated.

st_theme_node_get_parent ()

StThemeNode *
st_theme_node_get_parent (StThemeNode *node);

Gets the parent themed element node.

st_theme_node_get_theme ()

StTheme *
st_theme_node_get_theme (StThemeNode *node);

Gets the theme stylesheet set that styles this node

st_theme_node_equal ()

gboolean
st_theme_node_equal (StThemeNode *node_a,
                     StThemeNode *node_b);

Compare two StThemeNodes. Two nodes which compare equal will match the same CSS rules and have the same style properties. However, two nodes that have ended up with identical style properties do not necessarily compare equal. In detail, node_a and node_b are considered equal iff

st_theme_node_hash ()

guint
st_theme_node_hash (StThemeNode *node);

st_theme_node_get_element_type ()

GType
st_theme_node_get_element_type (StThemeNode *node);

st_theme_node_get_element_id ()

const char *
st_theme_node_get_element_id (StThemeNode *node);

st_theme_node_get_element_classes ()

GStrv
st_theme_node_get_element_classes (StThemeNode *node);

st_theme_node_get_pseudo_classes ()

GStrv
st_theme_node_get_pseudo_classes (StThemeNode *node);

st_theme_node_lookup_color ()

gboolean
st_theme_node_lookup_color (StThemeNode *node,
                            const char *property_name,
                            gboolean inherit,
                            ClutterColor *color);

Generically looks up a property containing a single color value. When specific getters (like st_theme_node_get_background_color()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

See also st_theme_node_get_color(), which provides a simpler API.

st_theme_node_lookup_double ()

gboolean
st_theme_node_lookup_double (StThemeNode *node,
                             const char *property_name,
                             gboolean inherit,
                             double *value);

Generically looks up a property containing a single numeric value without units.

See also st_theme_node_get_double(), which provides a simpler API.

st_theme_node_lookup_length ()

gboolean
st_theme_node_lookup_length (StThemeNode *node,
                             const char *property_name,
                             gboolean inherit,
                             gdouble *length);

Generically looks up a property containing a single length value. When specific getters (like st_theme_node_get_border_width()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

See also st_theme_node_get_length(), which provides a simpler API.

st_theme_node_lookup_shadow ()

gboolean
st_theme_node_lookup_shadow (StThemeNode *node,
                             const char *property_name,
                             gboolean inherit,
                             StShadow **shadow);

If the property is not found, the value in the shadow variable will not be changed.

Generically looks up a property containing a set of shadow values. When specific getters (like st_theme_node_get_box_shadow()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

See also st_theme_node_get_shadow(), which provides a simpler API.

st_theme_node_get_color ()

void
st_theme_node_get_color (StThemeNode *node,
                         const char *property_name,
                         ClutterColor *color);

Generically looks up a property containing a single color value. When specific getters (like st_theme_node_get_background_color()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

If property_name is not found, a warning will be logged and a default color returned.

See also st_theme_node_lookup_color(), which provides more options, and lets you handle the case where the theme does not specify the indicated color.

st_theme_node_get_double ()

gdouble
st_theme_node_get_double (StThemeNode *node,
                          const char *property_name);

Generically looks up a property containing a single numeric value without units.

See also st_theme_node_lookup_double(), which provides more options, and lets you handle the case where the theme does not specify the indicated value.

st_theme_node_get_length ()

gdouble
st_theme_node_get_length (StThemeNode *node,
                          const char *property_name);

Generically looks up a property containing a single length value. When specific getters (like st_theme_node_get_border_width()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

Unlike st_theme_node_get_color() and st_theme_node_get_double(), this does not print a warning if the property is not found; it just returns 0.

See also st_theme_node_lookup_length(), which provides more options.

st_theme_node_get_shadow ()

StShadow *
st_theme_node_get_shadow (StThemeNode *node,
                          const char *property_name);

Generically looks up a property containing a set of shadow values. When specific getters (like st_theme_node_get_box_shadow()) exist, they should be used instead. They are cached, so more efficient, and have handling for shortcut properties and other details of CSS.

Like st_theme_get_length(), this does not print a warning if the property is not found; it just returns NULL

See also st_theme_node_lookup_shadow(), which provides more options.

st_theme_node_get_background_color ()

void
st_theme_node_get_background_color (StThemeNode *node,
                                    ClutterColor *color);

Returns node 's background color.

st_theme_node_get_foreground_color ()

void
st_theme_node_get_foreground_color (StThemeNode *node,
                                    ClutterColor *color);

Returns node 's foreground color.

st_theme_node_get_background_gradient ()

void
st_theme_node_get_background_gradient (StThemeNode *node,
                                       StGradientType *type,
                                       ClutterColor *start,
                                       ClutterColor *end);

The start and end arguments will only be set if type is not ST_GRADIENT_NONE.

st_theme_node_get_background_image ()

const char *
st_theme_node_get_background_image (StThemeNode *node);

Returns node 's background image.

st_theme_node_get_background_bumpmap ()

const char *
st_theme_node_get_background_bumpmap (StThemeNode *node);

Returns node 's background bumpmap.

st_theme_node_get_border_width ()

int
st_theme_node_get_border_width (StThemeNode *node,
                                StSide side);

st_theme_node_get_border_radius ()

int
st_theme_node_get_border_radius (StThemeNode *node,
                                 StCorner corner);

st_theme_node_get_border_color ()

void
st_theme_node_get_border_color (StThemeNode *node,
                                StSide side,
                                ClutterColor *color);

Returns the color of node 's border on side

st_theme_node_get_outline_width ()

int
st_theme_node_get_outline_width (StThemeNode *node);

st_theme_node_get_outline_color ()

void
st_theme_node_get_outline_color (StThemeNode *node,
                                 ClutterColor *color);

Returns the color of node 's outline.

st_theme_node_get_padding ()

double
st_theme_node_get_padding (StThemeNode *node,
                           StSide side);

st_theme_node_get_horizontal_padding ()

double
st_theme_node_get_horizontal_padding (StThemeNode *node);

Gets the total horizonal padding (left + right padding)

st_theme_node_get_vertical_padding ()

double
st_theme_node_get_vertical_padding (StThemeNode *node);

Gets the total vertical padding (top + bottom padding)

st_theme_node_get_margin ()

double
st_theme_node_get_margin (StThemeNode *node,
                          StSide side);

st_theme_node_get_width ()

int
st_theme_node_get_width (StThemeNode *node);

st_theme_node_get_height ()

int
st_theme_node_get_height (StThemeNode *node);

st_theme_node_get_min_width ()

int
st_theme_node_get_min_width (StThemeNode *node);

st_theme_node_get_min_height ()

int
st_theme_node_get_min_height (StThemeNode *node);

st_theme_node_get_max_width ()

int
st_theme_node_get_max_width (StThemeNode *node);

st_theme_node_get_max_height ()

int
st_theme_node_get_max_height (StThemeNode *node);

st_theme_node_get_icon_style ()

StIconStyle
st_theme_node_get_icon_style (StThemeNode *node);

st_theme_node_get_transition_duration ()

int
st_theme_node_get_transition_duration (StThemeNode *node);

Get the value of the transition-duration property, which specifies the transition time between the previous StThemeNode and node .

st_theme_node_get_text_decoration ()

StTextDecoration
st_theme_node_get_text_decoration (StThemeNode *node);

st_theme_node_get_text_align ()

StTextAlign
st_theme_node_get_text_align (StThemeNode *node);

st_theme_node_get_letter_spacing ()

double
st_theme_node_get_letter_spacing (StThemeNode *node);

Gets the value for the letter-spacing style property, in pixels.

st_theme_node_get_font ()

const PangoFontDescription *
st_theme_node_get_font (StThemeNode *node);

st_theme_node_get_font_features ()

gchar *
st_theme_node_get_font_features (StThemeNode *node);

st_theme_node_get_border_image ()

StBorderImage *
st_theme_node_get_border_image (StThemeNode *node);

Gets the value for the border-image style property

st_theme_node_get_box_shadow ()

StShadow *
st_theme_node_get_box_shadow (StThemeNode *node);

Gets the value for the box-shadow style property

st_theme_node_get_text_shadow ()

StShadow *
st_theme_node_get_text_shadow (StThemeNode *node);

Gets the value for the text-shadow style property

st_theme_node_get_background_image_shadow ()

StShadow *
st_theme_node_get_background_image_shadow
                               (StThemeNode *node);

Gets the value for the -st-background-image-shadow style property

st_theme_node_get_icon_colors ()

StIconColors *
st_theme_node_get_icon_colors (StThemeNode *node);

Gets the colors that should be used for colorizing symbolic icons according the style of this node.

st_theme_node_adjust_for_height ()

void
st_theme_node_adjust_for_height (StThemeNode *node,
                                 float *for_height);

Adjusts a "for height" passed to clutter_actor_get_preferred_width() to account for borders and padding. This is a convenience function meant to be called from a get_preferred_width() method of a ClutterActor subclass. The value after adjustment is the height available for the actor's content.

st_theme_node_adjust_preferred_width ()

void
st_theme_node_adjust_preferred_width (StThemeNode *node,
                                      float *min_width_p,
                                      float *natural_width_p);

Adjusts the minimum and natural width computed for an actor by adding on the necessary space for borders and padding and taking into account any minimum or maximum width. This is a convenience function meant to be called from the get_preferred_width() method of a ClutterActor subclass

st_theme_node_adjust_for_width ()

void
st_theme_node_adjust_for_width (StThemeNode *node,
                                float *for_width);

Adjusts a "for width" passed to clutter_actor_get_preferred_height() to account for borders and padding. This is a convenience function meant to be called from a get_preferred_height() method of a ClutterActor subclass. The value after adjustment is the width available for the actor's content.

st_theme_node_adjust_preferred_height ()

void
st_theme_node_adjust_preferred_height (StThemeNode *node,
                                       float *min_height_p,
                                       float *natural_height_p);

Adjusts the minimum and natural height computed for an actor by adding on the necessary space for borders and padding and taking into account any minimum or maximum height. This is a convenience function meant to be called from the get_preferred_height() method of a ClutterActor subclass

st_theme_node_get_content_box ()

void
st_theme_node_get_content_box (StThemeNode *node,
                               const ClutterActorBox *allocation,
                               ClutterActorBox *content_box);

Gets the box within an actor's allocation that contents the content of an actor (excluding borders and padding). This is a convenience function meant to be used from the allocate() or paint() methods of a ClutterActor subclass.

st_theme_node_get_paint_box ()

void
st_theme_node_get_paint_box (StThemeNode *node,
                             const ClutterActorBox *allocation,
                             ClutterActorBox *paint_box);

Gets the box used to paint the actor, including the area occupied by properties which paint outside the actor's assigned allocation. When painting node to an offscreen buffer, this function can be used to determine the necessary size of the buffer.

st_theme_node_get_background_paint_box ()

void
st_theme_node_get_background_paint_box
                               (StThemeNode *node,
                                const ClutterActorBox *allocation,
                                ClutterActorBox *paint_box);

Gets the box used to paint the actor's background, including the area occupied by properties which paint outside the actor's assigned allocation.

st_theme_node_geometry_equal ()

gboolean
st_theme_node_geometry_equal (StThemeNode *node,
                              StThemeNode *other);

Tests if two theme nodes have the same borders and padding; this can be used to optimize having to relayout when the style applied to a Clutter actor changes colors without changing the geometry.

st_theme_node_paint_equal ()

gboolean
st_theme_node_paint_equal (StThemeNode *node,
                           StThemeNode *other);

Check if st_theme_node_paint() will paint identically for node as it does for other . Note that in some cases this function may return TRUE even if there is no visible difference in the painting.

st_theme_node_paint ()

void
st_theme_node_paint (StThemeNode *node,
                     CoglFramebuffer *framebuffer,
                     const ClutterActorBox *box,
                     guint8 paint_opacity);

[skip]

st_theme_node_copy_cached_paint_state ()

void
st_theme_node_copy_cached_paint_state (StThemeNode *node,
                                       StThemeNode *other);

Copy cached painting state from other to node . This function can be used to optimize redrawing cached background images when the style on an element changess in a way that doesn't affect background drawing. This function must only be called if st_theme_node_paint_equal (node, other) returns TRUE.

enum StSide

enum StCorner

enum StTextDecoration

enum StTextAlign

enum StGradientType

enum StIconStyle

StTheme

typedef struct _StTheme StTheme;

StThemeContext

typedef struct _StThemeContext StThemeContext;

The “application-stylesheet” property

  “application-stylesheet”   char *

The highest priority stylesheet, representing application-specific styling; this is associated with the CSS "author" stylesheet.

Owner: StTheme

Flags: Read / Write / Construct Only

Default value: NULL

The “default-stylesheet” property

  “default-stylesheet”       char *

The lowest priority stylesheet, representing global default styling; this is associated with the CSS "user agent" stylesheet.

Owner: StTheme

Flags: Read / Write / Construct Only

Default value: NULL

The “fallback-stylesheet” property

  “fallback-stylesheet”      char *

Fallback stylesheet - non-cascading. It is applied only if the user-selected stylesheets fail to return any properties, and the StWidget has its "important" property set.

Owner: StTheme

Flags: Read / Write / Construct Only

Default value: NULL

The “theme-stylesheet” property

  “theme-stylesheet”         char *

The second priority stylesheet, representing theme-specific styling; this is associated with the CSS "user" stylesheet.

Owner: StTheme

Flags: Read / Write / Construct Only

Default value: NULL

The “scale-factor” property

  “scale-factor”             int

The scaling factor used or high dpi scaling.

Owner: StThemeContext

Flags: Read / Write

Allowed values: >= 0

Default value: 1

The “custom-stylesheets-changed” signal

void
user_function (StTheme *sttheme,
               gpointer user_data)

Flags: Run Last

The “changed” signal

void
user_function (StThemeContext *stthemecontext,
               gpointer        user_data)

Flags: Run Last