---
name: "Font::TTF::Head"
section: "3pm"
platform: "linux"
package: "perl-font-ttf"
version: "1.06-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Font::TTF::Head"
---

# Font::TTF::Head(3pm)

The head table for a TTF Font

## NAME

Font::TTF::Head - The head table for a TTF Font

## DESCRIPTION

This is a very basic table with just instance variables as described in the TTF documentation, using the same names. One of the most commonly used is `"unitsPerEm"`.

## INSTANCE VARIABLES

The `"head"` table has no internal instance variables beyond those common to all tables and those specified in the standard:

```
    version
    fontRevision
    checkSumAdjustment
    magicNumber
    flags
    unitsPerEm
    created
    modified
    xMin
    yMin
    xMax
    yMax
    macStyle
    lowestRecPPEM
    fontDirectionHint
    indexToLocFormat
    glyphDataFormat
```

The two dates are held as an array of two unsigned longs (32-bits)

## METHODS

### $t-\>read

Reads the table into memory thanks to some utility functions

### $t-\>out($fh)

Writes the table to a file either from memory or by copying. If in memory (which is usually) the checkSumAdjustment field is set to 0 as per the default if the file checksum is not to be considered.

### $t-\>minsize()

Returns the minimum size this table can be. If it is smaller than this, then the table must be bad and should be deleted or whatever.

### $t-\>XML\_element($context, $depth, $key, $value)

Handles date process for the XML exporter

### $t-\>update

Updates the head table based on the glyph data and the hmtx table

### $t-\>getdate($is\_create)

Converts font modification time (or creation time if `$is_create` is set) to a 32-bit integer as returned from **time()**. Returns undef if the value is out of range, either before the epoch or after the maximum storable time.

### $t-\>setdate($time, $is\_create)

Sets the time information for modification (or creation time if `$is_create` is set) according to the 32-bit time information.

## BUGS

None known

## AUTHOR

Martin Hosken \<http://scripts.sil.org/FontUtils\>.

## LICENSING

Copyright (c) 1998-2016, SIL International (http://www.sil.org)

This module is released under the terms of the Artistic License 2.0.  For details, see the full text of the license in the file LICENSE.