Name
doc:LoadFont -- load font using Hollywood
Synopsis
font = doc:LoadFont(name[, weight, slant, embed])
Function
doc:LoadFont() loads a font using Hollywood and registers it in the document object. If the optional embed argument is set to True, the glyph data of the font is embedded, otherwise only the matrix data is included in the PDF file.

Note that only TrueType fonts can be used with this method. You cannot use bitmap fonts in PDF documents.

The optional arguments weight and slant can be used to specify a font weight and slant. The following can be passed in the weight parameter:

 
#FONTWEIGHT_THIN
#FONTWEIGHT_EXTRALIGHT
#FONTWEIGHT_ULTRALIGHT
#FONTWEIGHT_LIGHT
#FONTWEIGHT_BOOK
#FONTWEIGHT_NORMAL (default)
#FONTWEIGHT_REGULAR
#FONTWEIGHT_MEDIUM
#FONTWEIGHT_SEMIBOLD
#FONTWEIGHT_DEMIBOLD
#FONTWEIGHT_BOLD
#FONTWEIGHT_EXTRABOLD
#FONTWEIGHT_ULTRABOLD
#FONTWEIGHT_HEAVY
#FONTWEIGHT_BLACK
#FONTWEIGHT_EXTRABLACK
#FONTWEIGHT_ULTRABLACK

The following constants can be passed in the slant parameter:

 
#FONTSLANT_ROMAN (default)
#FONTSLANT_ITALIC
#FONTSLANT_OBLIQUE

When doc:LoadTTFont() succeeds, it returns the name of a font. Otherwise, it returns Nil and the error handler is called.

Inputs
name
name of a font to load through Hollywood
weight
optional: desired font weight (defaults to #FONTWEIGHT_NORMAL)
slant
optional: desired font slant (defaults to #FONTSLANT_ROMAN)
embed
optional: if this parameter is set to True, the glyph data of the font is embedded, otherwise only the matrix data is included in PDF file
Results
font
name of the font as a string
Errors
#HPDF_INVALID_DOCUMENT - An invalid document handle was set.

#HPDF_FAILED_TO_ALLOC_MEM - Memory allocation failed.

#HPDF_FONT_EXISTS - The font of the same name has already been registered.

#HPDF_TTF_INVALID_CMAP - Failed to load .ttf file.

#HPDF_TTF_INVALID_FORMAT - Failed to load .ttf file.

#HPDF_TTF_MISSING_TABLE - Failed to load .ttf file.

#HPDF_TTF_CANNOT_EMBEDDING_FONT - The font doesn't allow embedding.

Show TOC