c: Combine multiple AmigaFFH objects

In AmigaFFH: Commodore Amiga File Format Handler

Combine multiple AmigaFFH objects

Description

Use this function to correctly combine one or more AmigaBitmapFont class objects into a single AmigaBitmapFontSet class object, or to combine multiple AmigaBasic class objects.

Usage

## S3 method for class 'AmigaBasic'
c(...)

## S3 method for class 'AmigaBitmapFont'
c(..., name = "font")

Arguments

...

Either AmigaBasic or AmigaBitmapFont class objects. In case of AmigaBitmapFont objects: Each AmigaBitmapFont object should have a unique Y-size.

name

This argument is only valid when ... are one or more AmigaBitmapFont class objects. A character string specifying the name that needs to be applied to the font set. When unspecified, the default name 'font' is used. Note that this name will also be used as a file name when writing the font to a file. So make sure the name is also a valid file name. This will not be checked for you and may thus result in errors.

Details

In case ... are one or more AmigaBasic class objects:

AmigaBasic class objects are combined into a single AmigaBasic class object in the same order as they are given as argument to this function. for this purpose the lines of Amiga Basic codes are simply concatenated.

In case ... are one or more AmigaBitmapFont class objects:

AmigaBitmapFontSet class objects can hold multiple AmigaBitmapFont class objects. Use this method to combine font bitmaps into such a font set. Make sure each bitmap represents a unique font height (in pixels). When heights are duplicated an error will be thrown.

You can also specify a name for the font, that will be embeded in the object. As this name will also be used as a file name when writing the font to a file, make sure that it is a valid filename.

Value

Returns an AmigaBitmapFontSet in which the AmigaBitmapFont objects are combined. Or when AmigaBasic objects are combined, an AmigaBasic object is returned in which the lines of Amiga Basic code are combined.

Author(s)

Pepijn de Vries

See Also

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

Examples

## Not run: 
data(font_example)

## first get some AmigaBitmapFont objects:
font8 <- getAmigaBitmapFont(font_example, 8)
font9 <- getAmigaBitmapFont(font_example, 9)

## now bind these bitmaps again in a single set
font.set <- c(font8, font9, name = "my_font_name")

## Amiga Basic codes can also be combined:
bas1 <- as.AmigaBasic("LET a = 1")
bas2 <- as.AmigaBasic("PRINT a")
bas  <- c(bas1, bas2)

## End(Not run)

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