Functions

Properties

Types and Values

Object Hierarchy

    GObject
    ╰── GogTheme

Implemented Interfaces

GogTheme implements GOPersist.

Description

The library provides two hard coded themes, "Default", and "Guppi". Other themes are described in files, some of which might be distributed with the library.

A file defining a theme is an xml file with a <GogTheme> root node. The root element needs to have an Id which should be unique. The uuid command provides such Ids.

The contents must be: _name|name+, _description?|description*, GOStyle+.

_name and name nodes:

The _name node should be used for themes distributed with goffice, localized names will be in *.po files and only the default name for "C" locale needs to be there. Other files need at least one name node for the default name, and might have some translated names with an appropriate "xml:lang" attribute.

_description and description nodes:

These work just like name nodes. The difference is that no description node is mandatory. A theme can work perfectly without a description.

GOStyle nodes:

These nodes actually define the theme. Attributes and contents are: node attributes: class, role. node contents: (line|outline)?, fill?, marker?, font?, text_layout?

The attributes define the target for the style. You might have a class and a role attribute, or just one of them. If the role attribute is given, the class attribute, if given, represents the class of the parent object. A GOStyle node with no class or role will be used as default when another style is missing. If several such nodes exist, the last one will be used. If no default style exists, the "Default" theme is applied for missing nodes. The list of GOStyle nodes might be:

The line and outline nodes are actually the same so using line in place of outline is not an issue. A color is specified either using the format RR:GG::BB:AA or a string as defined in rgb.txt, so black can be specified as "black" or "00:00:00:FF".

"line" or "outline" node:

"fill" node

contents: (pattern|gradient)?

"pattern" node

Should be included in the fill node if type is pattern.

"gradient" node

Should be included in the fill node if type is gradient.

"marker" node

"font" node

"text_layout" node

Functions

gboolean
gog_theme_delete (GogTheme *theme);

GogTheme *
gog_theme_dup (GogTheme *theme);

GogTheme *
gog_theme_edit (GogTheme *theme,
                GOCmdContext *cc);

void
gog_theme_foreach (GFunc handler,
                   gpointer user_data);

void
gog_theme_fillin_style (GogTheme const *theme,
                        GOStyle *style,
                        GogObject const *obj,
                        int ind,
                        GOStyleFlag relevant_fields);

GogAxisColorMap const *
gog_theme_get_color_map (GogTheme const *theme,
                         gboolean discrete);

char const *
gog_theme_get_description (GogTheme const *theme);

char const *
gog_theme_get_id (GogTheme const *theme);

char const *
gog_theme_get_name (GogTheme const *theme);

GoResourceType
gog_theme_get_resource_type (GogTheme const *theme);

GSList *
gog_theme_registry_get_theme_names (void);

GogTheme *
gog_theme_registry_lookup (char const *name);

void
gog_theme_save_to_home_dir (GogTheme *theme);

Types and Values

typedef struct _GogTheme GogTheme;

Property Details

  “resource-type”            GoResourceType