rawToAmigaBitmapFontSet: Coerce raw data into an AmigaBitmapFontSet class object

View source: R/bitmapfont.r

rawToAmigaBitmapFontSetR Documentation

Coerce raw data into an AmigaBitmapFontSet class object

Description

AmigaBitmapFontSet objects are comprehensive representations of binary Amiga font files (*.font). Use this function to convert raw data from such a file to an AmigaBitmapFontSet object.

Usage

rawToAmigaBitmapFontSet(x, file, disk = NULL)

Arguments

x

A vector of raw data that needs to be converted into an AmigaBitmapFontSet.

file

The raw version of the AmigaBitmapFontSet does not contain the nested font bitmap images. In order to correctly construct an AmigaBitmapFontSet the file location of the original *.font file is required in order to read and include the font bitmap image information. file should thus be a character string specifying the file location of the *.font file.

disk

A virtual Commodore Amiga disk from which the file should be read. This should be an amigaDisk object. Using this argument requires the adfExplorer package. When set to NULL, this argument is ignored.

Details

This function converts raw data as stored in *.font files. The function also needs the file location, in order to load the nested bitmap images for each font height. This function is effectively the inverse of as.raw.

Value

Returns an AmigaBitmapFontSet object.

Author(s)

Pepijn de Vries

See Also

Other AmigaBitmapFont.operations: AmigaBitmapFont, availableFontSizes(), c(), fontName(), font_example, getAmigaBitmapFont(), rasterToAmigaBitmapFont(), rawToAmigaBitmapFont(), read.AmigaBitmapFontSet(), read.AmigaBitmapFont(), write.AmigaBitmapFont()

Other raw.operations: as.AmigaBasic(), as.raw.AmigaBasic(), colourToAmigaRaw(), packBitmap(), rawToAmigaBasicBMAP(), rawToAmigaBasicShape(), rawToAmigaBasic(), rawToAmigaBitmapFont(), rawToAmigaIcon(), rawToHWSprite(), rawToIFFChunk(), rawToSysConfig(), simpleAmigaIcon()

Examples

## Not run: 
data(font_example)

## First create raw font set data. Note that this raw data
## does not include the nested font bitmap images.
fontset.raw <- as.raw(font_example)

## Therefore it is necesary to have the entire font stored as files:
write.AmigaBitmapFontSet(font_example, tempdir())

font.restored <- rawToAmigaBitmapFontSet(fontset.raw, file.path(tempdir(), "AmigaFFH.font"))

## End(Not run)

AmigaFFH documentation built on Aug. 27, 2023, 9:07 a.m.