rgbim

0th

Percentile

Create Colour-Valued Pixel Image

Creates an object of class "im" representing a two-dimensional pixel image whose pixel values are colours.

Keywords
manip, spatial, datagen
Usage
rgbim(R, G, B, maxColorValue=255, autoscale=FALSE)
  hsvim(H, S, V, autoscale=FALSE)
Arguments
R,G,B
Pixel images (objects of class "im") or constants giving the red, green, and blue components of a colour, respectively.
maxColorValue
Maximum colour channel value for R,G,B.
H,S,V
Pixel images (objects of class "im") or constants giving the hue, saturation, and value components of a colour, respectively.
autoscale
Logical. If TRUE, input values are automatically rescaled to fit the permitted range. RGB values are scaled to lie between 0 and maxColorValue. HSV values are scaled to lie between 0 and 1.
Details

These functions take three pixel images, with real or integer pixel values, and create a single pixel image whose pixel values are colours recognisable to R.

Some of the arguments may be constant numeric values, but at least one of the arguments must be a pixel image. The image arguments should be compatible (in array dimension and in spatial position).

rgbim calls rgb to compute the colours, while hsvim calls hsv. See the help for the relevant function for more information about the meaning of the colour channels.

See Also

im.object, rgb, hsv.

See colourtools for additional colour tools.

Aliases
  • rgbim
  • hsvim
Examples
<testonly>op <- spatstat.options(npixel=32)</testonly>
  # create three images with values in [0,1]
  X <- setcov(owin())
  X <- eval.im(pmin(1,X))
  M <- Window(X)
  Y <- as.im(function(x,y){(x+1)/2}, W=M)
  Z <- as.im(function(x,y){(y+1)/2}, W=M)
  RGB <- rgbim(X, Y, Z, 1)
  HSV <- hsvim(X, Y, Z)
  plot(RGB, valuesAreColours=TRUE)
  plot(HSV, valuesAreColours=TRUE)
  <testonly>spatstat.options(op)</testonly>
Documentation reproduced from package spatstat, version 1.42-2, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.