as.raster {AmigaFFH}R Documentation

Convert AmigaFFH objects into grDevices raster images

Description

Convert AmigaFFH objects that contain bitmap images into grDevices raster images.

Usage

## S3 method for class 'AmigaBitmapFont'
as.raster(x, text, style, palette, ...)

## S3 method for class 'AmigaBitmapFontSet'
as.raster(x, text, style, palette, ...)

## S3 method for class 'hardwareSprite'
as.raster(x, background = "#AAAAAA", ...)

## S3 method for class 'IFFChunk'
as.raster(x, ...)

## S3 method for class 'AmigaIcon'
as.raster(x, selected = F, ...)

Arguments

x

Object that needs to be converted into a grDevices raster. It can be an IFFChunk containing an interleaved bitmap image (ILBM) or animation (ANIM), a hardwareSprite, an AmigaBitmapFont object or an AmigaBitmapFontSet object.

text

Text (a character string) to be formated with x (when x is an AmigaBitmapFont or an AmigaBitmapFontSet.

style

Argument is only valid when x is an AmigaBitmapFont or an AmigaBitmapFontSet. No styling is applied when missing or NULL. One or more of the following styles can be used 'bold', 'italic or 'underlined'.

palette

Argument is only valid when x is an AmigaBitmapFont or an AmigaBitmapFontSet. Should be a vector of two colours. The first is element is used as background colour, the second as foreground. When missing, transparent white and black are used.

...

Currently ignored.

background

Use the argument background to specify a background colour in case x is a hardwareSprite.

selected

This argument is only allowed when x is an object of class AmigaIcon. When set to TRUE, the raster of the AmigaIcon will be based on the ‘selected’ state of the icon. Otherwise it will be based on the unselected state (default).

Details

Images on the Amiga were stored as bitmap images with indexed colour palettes. This was mainly due to hardware and memory limitations. Bitmap images could also be embedded in several file types. This method can be used to convert AmigaFFH objects read from such files into grDevices raster images (as.raster).

Value

Returns a grDevices raster image (as.raster) based on x. If x is an animation (IFFChunk of type ANIM), a list of raster objects is returned.

Author(s)

Pepijn de Vries

See Also

Other iff.operations: IFFChunk-class, WaveToIFF, getIFFChunk, interpretIFFChunk, rasterToIFF, rawToIFFChunk, read.iff, write.iff

Other raster.operations: AmigaBitmapFont, bitmapToRaster, dither, index.colours, rasterToAmigaBitmapFont, rasterToBitmap, rasterToHWSprite, rasterToIFF

Examples

## Not run: 
## load an IFF file
example.iff <- read.iff(system.file("ilbm8lores.iff", package = "AmigaFFH"))

## The file contains an interleaved bitmap image that can be
## converted into a raster:
example.raster <- as.raster(example.iff)

## the raster can be plotted:
plot(example.raster)

## note that the IFFChunk can also be plotted directly:
plot(example.iff)

## Hardware sprites can also be converted into raster images.
## Let's generate a 16x16 sprite with a random bitmap:
spr <- new("hardwareSprite",
           VStop = 16,
           bitmap = as.raw(sample.int(255, 64, replace = TRUE)))

## now convert it into a raster image.
## as the background colour is not specified for hardware
## sprite, we can optionally provide it here.
spr.raster <- as.raster(spr, background = "green")

## End(Not run)

[Package AmigaFFH version 0.3.1 Index]