GData Types

GData Types — miscellaneous data types

Stability Level

Unstable, unless otherwise indicated

Synopsis


#include <gdata/gdata-types.h>

                    GDataColor;
gboolean            gdata_color_from_hexadecimal        (const gchar *hexadecimal,
                                                         GDataColor *color);
gchar *             gdata_color_to_hexadecimal          (GDataColor *color);

Description

The structures here are used haphazardly across the library, describing various small data types.

Details

GDataColor

typedef struct {
	guint16 red;
	guint16 green;
	guint16 blue;
} GDataColor;

Describes a color, such as used in the Google Calendar interface to differentiate calendars.

guint16 red;

red color intensity, from 0–255

guint16 green;

green color intensity, from 0–255

guint16 blue;

blue color intensity, from 0–255

gdata_color_from_hexadecimal ()

gboolean            gdata_color_from_hexadecimal        (const gchar *hexadecimal,
                                                         GDataColor *color);

Parses hexadecimal and returns a GDataColor describing it in color.

hexadecimal should be in the form #rrggbb, where rr is a two-digit hexadecimal red intensity value, gg is green and bb is blue. The hash is optional.

hexadecimal :

a hexadecimal color string

color :

a GDataColor

Returns :

TRUE on success, FALSE otherwise

gdata_color_to_hexadecimal ()

gchar *             gdata_color_to_hexadecimal          (GDataColor *color);

Returns a string describing color in hexadecimal form; in the form #rrgg bb, where rr is a two-digit hexadecimal red intensity value, gg is green and bb is blue. The hash is always present.

color :

a GDataColor

Returns :

the color string; free with g_free()

Since 0.3.0