GOFont: GOffice Reference Manual

## GOFont GOFont |

## Functions

char * | go_font_as_str ()
void | go_font_cache_register ()
void | go_font_cache_unregister ()
gboolean | go_font_eq ()
void | go_font_metrics_free ()
GOFontMetrics * | go_font_metrics_new ()
GOFont const * | go_font_new_by_desc ()
GOFont const * | go_font_new_by_index ()
GOFont const * | go_font_new_by_name ()
GOFont const * | go_font_ref ()
void | go_font_unref ()
GSList * | go_fonts_list_families ()
GSList * | go_fonts_list_sizes ()

## Object Hierarchy

        GBoxed
        ├── GOFont
        ╰── GOFontMetrics

## Description

## Functions

### go_font_as_str ()

    char *
    go_font_as_str (GOFont const *font);

#### Parameters

font | GOFont |

#### Returns

a string representation of `font` .

[transfer full]

### go_font_cache_register ()

    void
    go_font_cache_register (GClosure *callback);

Registers a callback for font cache changes.

#### Parameters

callback | GClosure |

### go_font_cache_unregister ()

    void
    go_font_cache_unregister (GClosure *callback);

Unregisters a callback for font cache changes.

#### Parameters

callback | GClosure |

### go_font_eq ()

    gboolean
    go_font_eq (GOFont const *a,
                GOFont const *b);

#### Parameters

a | GOFont |
b | GOFont |

#### Returns

`TRUE` if `a` and `b` are equal.

### go_font_metrics_free ()

    void
    go_font_metrics_free (GOFontMetrics *metrics);

Frees `metrics` .

#### Parameters

metrics | GOFontMetrics. | [transfer full]

### go_font_metrics_new ()

    GOFontMetrics *
    go_font_metrics_new (PangoContext *context,
                         GOFont const *font);

#### Parameters

context | PangoContext |
font | GOFont |

#### Returns

a new GOFontMetrics for `font` .

[transfer full]

### go_font_new_by_desc ()

    GOFont const *
    go_font_new_by_desc (PangoFontDescription *desc);

#### Parameters

desc | PangoFontDescription. | [transfer full]

#### Returns

a font that matches `desc` .

[transfer full]

### go_font_new_by_index ()

    GOFont const *
    go_font_new_by_index (unsigned  i);

#### Parameters

i | an index |

#### Returns

the font at index `i` .

[transfer full][nullable]

### go_font_new_by_name ()

    GOFont const *
    go_font_new_by_name (char const *str);

#### Parameters

str | a font name |

#### Returns

a font that matches `str` .

[transfer full]

### go_font_ref ()

    GOFont const *
    go_font_ref (GOFont const *font);

Increments the reference count of `font` .

#### Parameters

font | GOFont |

#### Returns

`font` .

[transfer full]

### go_font_unref ()

    void
    go_font_unref (GOFont const *font);

Decrements the reference count of `font` .

#### Parameters

font | GOFont. | [transfer full]

### go_fonts_list_families ()

    GSList *
    go_fonts_list_families (PangoContext *context);

#### Parameters

context | PangoContext |

#### Returns

a sorted list of strings of font family names.

[element-type utf8][transfer full]

### go_fonts_list_sizes ()

    GSList *
    go_fonts_list_sizes (void);

#### Returns

a sorted list of font sizes in Pango units.

[element-type guint][transfer container]