Prev | Next

IceMan Reference Guide


List BoundingBox(pixel)
pixel: Threshold (Image)

Find the bounding box of all pixels that are greater than the specified threshold.

Note: It makes no sense for the threshold to be anything but a card

The list returned has four elements that are; (origin x, origin y, size x, size y)

box: Mean computed over this region (List)

Computes the average value of each channel over a specified rectangular region. An image is returned, but it is always 1x1, the single pixel representing the mean.

Histogram(nBins, range)
nBins: Number of bins in histogram (Number)
range: Range of values to bin (List)

Returns an List of histograms, one for each channel. Each histogram is a List

Note: For efficiency reasons, Fractional (8-bit) images always return histograms with 256 bins.

Range(computeBox, interval)
computeBox: Region over which range is computed (List)
interval: Minimum and maximum pixel value to consider (List)

Computes the range of each channel in the image. Values outside of the interval have no effect on the result. The result is an image with two pixels: the first at (0,0) contains minimum values for each channel, and the second at (1,0) the maximum values. The result image has the same ply as the input image. You can pass this range image directly to the Normalize operator

Note: This operation is not lazy-evaluated: if called on an existing expression, it will trigger evaluation.

infinite := list(Number constants inf * -1, Number constants inf)
rangeImg := image Range(image DataBox, infinite)

// rangeImage is a two pixel image of the same ply as the input
min := rangeImg GetPixelVal(list(0,0)) at(0)
max := rangeImg GetPixelVal(list(1,0)) at(0)
writeln("min ", min, " max ", max)
GetPixel(location, filterType = PointSample)
location: Location from which pixel value is to be retrieved (List)
filterType: filter to use (Number). Location may be non-integral. Defaults to point sample. Any of IceFilterType

The returned image is a card.

List GetPixelVal(location)
location: Location from which pixel value is to be retrieved (List)

The pixel value is returned as an List of component values.


Prev | Next



Pixar Animation Studios
Copyright© Pixar. All rights reserved.
Pixar® and RenderMan® are registered trademarks of Pixar.
All other trademarks are the properties of their respective holders.