imfill {imager}

Create an image of custom size by filling in repeated values

Description

This is a convenience function for quickly creating blank images, or images filled with a specific colour. See examples. If val is a logical value, creates a pixset instead.

Usage

imfill(x = 1, y = 1, z = 1, val = 0, dim = NULL)

Arguments

x

width (default 1)

y

height (default 1)

z

depth (default 1)

val

fill-in values. Either a single value (for grayscale), or RGB values for colour, or a character string for a colour (e.g. "blue")

dim

dimension vector (optional, alternative to specifying x,y,z)

Value

an image object (class cimg)

Author(s)

Simon Barthelme

Examples

imfill(20,20) %>% plot #Blank image of size 20x20
imfill(20,20,val=c(1,0,0)) %>% plot #All red image
imfill(20,20,val="red") %>% plot #Same, using R colour name
imfill(3,3,val=FALSE) #Pixset
imfill(dim=dim(boats)) #Blank image of the same size as the boats image