---
name: "lua-oocairo-fontface"
section: "3"
platform: "linux"
package: "liblua5.1-oocairo0"
version: "1.4-1.2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/lua-oocairo-fontface"
---

# lua-oocairo-fontface(3)

Unscaled font face object

## Name

lua-oocairo-fontface - Unscaled font face object

## Introduction

Cairo font face objects are returned by the `"get_font_face"` method on context objects (see [*lua-oocairo-context*(3)](/lua-oocairo-context/3.md)).  They represent a font selection, but not including the scaling used to create a font of a particular size.  See [*lua-oocairo-scaledfont*(3)](/lua-oocairo-scaledfont/3.md) for details about fonts at a particular size, which can be created by scaling one of these font face objects.

Font face objects can be compared with the `"=="` operator.  This will compare the identity of the objects, so different Lua objects which refer to the same `"cairo_font_face_t"` will compare as equal.

## Methods

Font face objects provide the following methods.  Some of these will not be defined if the module was compiled against a version of Cairo too old to support them.

- fontface:get\_family ()

  Returns a string containing the name of the family selected with the `"select_font_face"` method.  Throws an exception if called on a font face which wasn't created with the aXXtoyaXX API. Only available with Cairo 1.8 or better.

- fontface:get\_slant ()

  Returns the slant style of the font face created with the toy API, or throws an exception for other font faces.  The return value will be a string, with one of the values accepted by the `"select_font_face"` method. Only available with Cairo 1.8 or better.

- fontface:get\_type ()

  Returns a string indicating what backend library handles this font. The return value will be one of the following:

  - toy

    Created using Cairo's aXXtoyaXX font API, probably selected with the `"select_font_face"` method.

  - ft

    Created with the FreeType API.

  - win32

    A Windows native font.

  - quartz

    A MacOS X native font.

  - user

    A font created with custom code.

- fontface:get\_weight ()

  Returns the weight of the font face created with the toy API, or throws an exception for other font faces.  The return value will be a string, with one of the values accepted by the `"select_font_face"` method. Only available with Cairo 1.8 or better.