as.raster: Convert AmigaFFH objects into grDevices raster images
In AmigaFFH: Commodore Amiga File Format Handler

as.raster.AmigaBasicShape

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 'AmigaBasicShape'
as.raster(x, selected = c("bitmap", "shadow", "collision"), ...)

## 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.
`selected`	When `x` is an object of class `AmigaIcon()`, `selected` can be used to select a specific state. 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 deselected state (default). When `x` is an `AmigaBasicShape()` class object, `selected` can be used to select a specific layer of the shape to plot, which can be one of `"bitmap"` (default), `"shadow"` or `"collision"`.
`...`	Currently ignored.
`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.
`background`	Use the argument `background` to specify a background colour in case `x` is a `hardwareSprite()`.

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 (grDevices::as.raster()).

Value

Returns a grDevices raster image (grDevices::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

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")

## AmigaBasicShape objects can also be converted into rasters:
ball <- read.AmigaBasicShape(system.file("ball.shp", package = "AmigaFFH"))
ball.rst <- as.raster(ball)

## End(Not run)

AmigaFFH documentation built on June 22, 2024, 11:03 a.m.