GData Reference Manual: GData Types

## 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          (const GDataColor *color);

## Object Hierarchy

      GBoxed
       +----GDataColor

## 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 `#`rr``gg``bb``, 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. [out caller-allocates]
Returns : | `TRUE` on success, `FALSE` otherwise

### gdata_color_to_hexadecimal ()

    gchar *             gdata_color_to_hexadecimal          (const GDataColor *color);

Returns a string describing `color` in hexadecimal form; in the form `#`rr``gg` `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