Module imagingbook.common

Package imagingbook.common.image

Class ColorPack

java.lang.Object

imagingbook.common.image.PixelPack

imagingbook.common.image.ColorPack

public class ColorPack
extends PixelPack

This class defines a "color stack" as a subtype of PixelPack with exactly 3 components (slices), representing a color image in a specific color space (default is sRGB65ColorSpace). It allows simple conversion to other color spaces (see convertFromSrgbTo(ColorSpace)). All conversions are 'destructive', i.e., the affected color stack is modified. Pixel values are typically in [0,1], depending on the associated color space. A ColorPack may be created from an existing ColorProcessor whose pixels are assumed to be in sRGB color space (see ColorPack(ColorProcessor)). To be converted back to a ColorProcessor, the ColorPack must be in sRGB color space (see convertToSrgb()).

Version:

2022/09/10

Nested Class Summary

Nested classes/interfaces inherited from class imagingbook.common.image.PixelPack

PixelPack.PixelSlice

Field Summary

Fields inherited from class imagingbook.common.image.PixelPack

data, DefaultOutOfBoundsStrategy, depth, height, length, width

Constructor Summary

Constructors

Constructor	Description
ColorPack(ColorProcessor cp)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	convertFromSrgbTo(ColorSpace targetColorspace)	Converts the pixel values of this ColorPack to the specified color space.
void	convertToSrgb()	Converts this ColorPack to sRGB space.
ColorSpace	getColorspace()	Returns the current color space instance of this ColorPack.
FloatProcessor[]	getProcessors()	Returns the 3 color components as an array of FloatProcessor.
ColorProcessor	toColorProcessor()	Converts this PixelPack to a new ColorProcessor instance.
ColorProcessor	toColorProcessor(double scale)	Converts this PixelPack to a new ColorProcessor instance.
ImageStack	toImageStack()	Converts this PixelPack to a new ImageStack with the same number of slices (see PixelPack.getDepth()).

Methods inherited from class imagingbook.common.image.PixelPack

copyFromImageProcessor, copyFromImageProcessor, copyTo, copyToImageProcessor, copyToImageProcessor, get3x3Neighborhood, getData, getDepth, getEmptySlice, getFloatProcessor, getFloatProcessors, getHeight, getOutOfBoundsStrategy, getPix, getPix, getPix, getPix, getSlice, getSlices, getVec, getVec, getWidth, isCompatibleTo, isCompatibleTo, setPix, setPix, setVec, toByteProcessor, toByteProcessor, toFloatProcessor, toFloatProcessor, toShortProcessor, toShortProcessor, zero

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ColorPack

public ColorPack(ColorProcessor cp)

Constructor.

Parameters:

cp - a color image assumed to be in sRGB

Method Details

getProcessors

public FloatProcessor[] getProcessors()

Returns the 3 color components as an array of FloatProcessor.

Returns:

a FloatProcessor array

getColorspace

public ColorSpace getColorspace()

Returns the current color space instance of this ColorPack.

Returns:

the current color space

convertFromSrgbTo

public void convertFromSrgbTo(ColorSpace targetColorspace)

Converts the pixel values of this ColorPack to the specified color space. The color stack must be in sRGB space. An exceptions is thrown if the color stack is not in sRGB color space. Has no effect if the target color space already is sRGB.

Parameters:

targetColorspace - the new color space

convertToSrgb

public void convertToSrgb()

Converts this ColorPack to sRGB space. Has no effect if the color stack is in sRGB color space already.

toColorProcessor

public ColorProcessor toColorProcessor()

Description copied from class: PixelPack

Converts this PixelPack to a new ColorProcessor instance. An exception is thrown if the depth of the pack is not equal 3. Component values are rounded, no scale factor is applied.

Overrides:

toColorProcessor in class PixelPack

Returns:

a new ColorProcessor instance

toColorProcessor

public ColorProcessor toColorProcessor(double scale)

Description copied from class: PixelPack

Converts this PixelPack to a new ColorProcessor instance. An exception is thrown if the depth of the pack is not equal 3.

Overrides:

toColorProcessor in class PixelPack

Parameters:

scale - scale factor applied to component values (before rounding)

Returns:

a new ColorProcessor instance

toImageStack

public ImageStack toImageStack()

Description copied from class: PixelPack

Converts this PixelPack to a new ImageStack with the same number of slices (see PixelPack.getDepth()). The stack images are of type FloatProcessor. The resulting ImageStack does not share any pixel data with this PixelPack.

Overrides:

toImageStack in class PixelPack

Returns:

a new ImageStack instance