Transforms (OpenIMAJ master project 1.1 API)

java.lang.Object
- org.openimaj.image.colour.Transforms

```
public class Transforms
extends Object
```
A collection of static methods for colour transformations

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Constructor Summary

Constructors
Constructor and Description

Transforms()

Constructors
Constructor and Description
`Transforms()`

Method Summary

Methods
Modifier and Type	Method and Description
`static FImage`	`calculateHue(MBFImage in)` Calculate Hue in 0..1 range from a 3-band RGB MBFImage
`static FImage`	`calculateIntensity(MBFImage in)` Calculate intensity by averaging R, G, B planes.
`static FImage`	`calculateIntensity(MBFImage in, float wR, float wG, float wB)` Calculate Intensity image from an RGB or RGBA MBFImage with given weightings for R, G and B
`static FImage`	`calculateIntensityNTSC(MBFImage in)` Calculate intensity by a weighted average of the R, G, B planes.
`static FImage`	`calculateSaturation(MBFImage in)` Calculate Saturation image from a 3-band RGB MBFImage
`static MBFImage`	`CIELab_TO_CIEXYZ(MBFImage input)` Convert CIELab to CIEXYZ.
`static MBFImage`	`CIELab_TO_RGB(MBFImage input)` Convert CIE Lab to RGB.
`static MBFImage`	`CIELabNormalised_TO_RGB(MBFImage input)` Convert normalised CIE Lab to RGB.
`static MBFImage`	`CIELUV_TO_CIEXYZ(MBFImage input)` Convert CIELUV to CIEXYZ.
`static MBFImage`	`CIELUV_TO_RGB(MBFImage input)` Convert CIE LUV to RGB.
`static MBFImage`	`CIEXYZ_TO_CIELab(MBFImage input)` Convert CIEXYZ to CIELab.
`static MBFImage`	`CIEXYZ_TO_CIELab(MBFImage input, boolean inPlace)` Convert CIEXYZ to CIELab.
`static MBFImage`	`CIEXYZ_TO_CIELUV(MBFImage input)` Convert CIEXYZ to CIELUV (CIE 1976) See http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html
`static MBFImage`	`CIEXYZ_TO_CIELUV(MBFImage input, boolean inPlace)` Convert CIEXYZ to CIELUV (CIE 1976) See http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html
`static MBFImage`	`CIEXYZ_TO_RGB(MBFImage in)` CIE_XYZ color space transform to RGB.
`static MBFImage`	`CIEXYZ_TO_RGB(MBFImage in, boolean inPlace)` CIE_XYZ color space transform to RGB.
`static MBFImage`	`H_TO_H1H2_2(FImage in)` Convert to Hue to H2 VARIANT 2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
`static MBFImage`	`H_TO_H1H2(FImage in)` Convert to Hue to H2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
`static MBFImage`	`H2SV_TO_HSV_Simple(MBFImage in)` Convert H2SV to HSV VARIANT 1 using the simple formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumes H1 and H2 are 0..1.
`static MBFImage`	`H2SV2_TO_HSV_Simple(MBFImage in)` Convert H2SV to HSV VARIANT 2 using the simple formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumes H1 and H2 are 0..1.
`static MBFImage`	`HSV_TO_H2SV_2(MBFImage in)` Convert HSV to H2SV VARIANT 2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
`static MBFImage`	`HSV_TO_H2SV(MBFImage in)` Convert HSV to H2SV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
`static MBFImage`	`HSV_TO_RGB(MBFImage in)` Convert from HSV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumption is that H is in the range 0..1 and SV are in the range 0..1.
`static MBFImage`	`projectHS(MBFImage in)` Transform the Hue and Saturation components of a MBFImage by projecting them from a radial coordinate system to Cartesian coordinates.
`static MBFImage`	`RGB_TO_CIELab(MBFImage input)` Convert RGB to CIE Lab.
`static MBFImage`	`RGB_TO_CIELabNormalised(MBFImage input)` Convert CIEXYZ to CIELab and normalise the resultant L, a & b values to 0..1.
`static MBFImage`	`RGB_TO_CIELUV(MBFImage input)` Convert RGB to CIE LUV.
`static MBFImage`	`RGB_TO_CIEXYZ(MBFImage in)` CIE_XYZ color space transform from RGB.
`static MBFImage`	`RGB_TO_H2S_2(MBFImage in)` Convert RGB to H2S VARIANT 2
`static MBFImage`	`RGB_TO_H2S(MBFImage in)` Convert RGB to H2S
`static MBFImage`	`RGB_TO_H2SV_2(MBFImage in)` Convert RGB to H2SV2 VARIANT 2
`static MBFImage`	`RGB_TO_H2SV(MBFImage in)` Convert RGB to H2SV
`static MBFImage`	`RGB_TO_HS_2(MBFImage in)` Convert to HS using the formulation from http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
`static MBFImage`	`RGB_TO_HS(MBFImage in)` Transform 3 band RGB image to HS
`static MBFImage`	`RGB_TO_HSI(MBFImage in)` Transform 3 band RGB image to HSV
`static MBFImage`	`RGB_TO_HSL(MBFImage in)` Transform 3 band RGB image to HSL
`static MBFImage`	`RGB_TO_HSV(MBFImage in)` Convert to HSV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space The assumption is that RGB are in the range 0..1.
`static MBFImage`	`RGB_TO_HSY(MBFImage in)` Transform 3 band RGB image to HSY
`static MBFImage`	`RGB_TO_RGB_NORMALISED(MBFImage in)` Intensity normalisation
`static MBFImage`	`RGB_TO_YUV(MBFImage input)` Convert from RGB to YUV.
`static MBFImage`	`RGB_TO_YUV(MBFImage input, boolean inPlace, boolean norm)` Convert from RGB to YUV.
`static MBFImage`	`RGB_TO_YUVNormalised(MBFImage input)` Convert from RGB to normalised YUV.
`static MBFImage`	`YUV_TO_RGB(MBFImage input)` Convert from YUV to RGB.
`static MBFImage`	`YUV_TO_RGB(MBFImage input, boolean inPlace, boolean norm)` Convert from YUV to RGB.
`static MBFImage`	`YUVNormalised_TO_RGB(MBFImage input)` Convert from normalised YUV to RGB.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Transforms
```
public Transforms()
```
- Method Detail
  - calculateIntensity
```
public static FImage calculateIntensity(MBFImage in)
```
    Calculate intensity by averaging R, G, B planes. Assumes planes are all in the same magnitude.
    
    Parameters:
    in - MBFImage with 3 bands
    
    Returns:
    intensity image
  - calculateIntensity
```
public static FImage calculateIntensity(MBFImage in,
                        float wR,
                        float wG,
                        float wB)
```
    Calculate Intensity image from an RGB or RGBA MBFImage with given weightings for R, G and B
    
    Parameters:
    in - input image
    wR - red weight
    wG - green weight
    wB - blue weight
    
    Returns:
    Intensity image
  - calculateIntensityNTSC
```
public static FImage calculateIntensityNTSC(MBFImage in)
```
    Calculate intensity by a weighted average of the R, G, B planes. Assumes planes are all in the same magnitude, and NTSC weighting coefficients.
    
    Parameters:
    in - MBFImage with 3 bands
    
    Returns:
    intensity image
  - calculateHue
```
public static FImage calculateHue(MBFImage in)
```
    Calculate Hue in 0..1 range from a 3-band RGB MBFImage
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    Hue image
  - calculateSaturation
```
public static FImage calculateSaturation(MBFImage in)
```
    Calculate Saturation image from a 3-band RGB MBFImage
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    Saturation image
  - RGB_TO_HSI
```
public static MBFImage RGB_TO_HSI(MBFImage in)
```
    Transform 3 band RGB image to HSV
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HSV image
  - RGB_TO_HSL
```
public static MBFImage RGB_TO_HSL(MBFImage in)
```
    Transform 3 band RGB image to HSL
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HSL image
  - RGB_TO_HSY
```
public static MBFImage RGB_TO_HSY(MBFImage in)
```
    Transform 3 band RGB image to HSY
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HSV image
  - RGB_TO_HS
```
public static MBFImage RGB_TO_HS(MBFImage in)
```
    Transform 3 band RGB image to HS
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HS image
  - RGB_TO_HS_2
```
public static MBFImage RGB_TO_HS_2(MBFImage in)
```
    Convert to HS using the formulation from http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HS image
  - projectHS
```
public static MBFImage projectHS(MBFImage in)
```
    Transform the Hue and Saturation components of a MBFImage by projecting them from a radial coordinate system to Cartesian coordinates. Assumes the Hue is the first band and Saturation is the second band. Any additional bands will be cloned to the result image.
    
    Parameters:
    in - input image
    
    Returns:
    Multi-band image with coupled first and second bands calculated by projecting from radial to Cartesian coordinates.
  - RGB_TO_HSV
```
public static MBFImage RGB_TO_HSV(MBFImage in)
```
    Convert to HSV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space The assumption is that RGB are in the range 0..1. H is output in the range 0..1, SV are output in the range 0..1
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    HSV image
  - HSV_TO_RGB
```
public static MBFImage HSV_TO_RGB(MBFImage in)
```
    Convert from HSV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumption is that H is in the range 0..1 and SV are in the range 0..1. RGB are output in the range 0..1
    
    Parameters:
    in - input image
    
    Returns:
    RGB image
  - H_TO_H1H2
```
public static MBFImage H_TO_H1H2(FImage in)
```
    Convert to Hue to H2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
    
    Parameters:
    in - input image
    
    Returns:
    Two-component hue image
  - HSV_TO_H2SV
```
public static MBFImage HSV_TO_H2SV(MBFImage in)
```
    Convert HSV to H2SV using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
    
    Parameters:
    in - HSV image
    
    Returns:
    H2SV image
  - RGB_TO_H2SV
```
public static MBFImage RGB_TO_H2SV(MBFImage in)
```
    Convert RGB to H2SV
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    H2SV image
  - RGB_TO_H2S
```
public static MBFImage RGB_TO_H2S(MBFImage in)
```
    Convert RGB to H2S
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    H2S image
  - H_TO_H1H2_2
```
public static MBFImage H_TO_H1H2_2(FImage in)
```
    Convert to Hue to H2 VARIANT 2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
    
    Parameters:
    in - Hue image
    
    Returns:
    H1H2_2 image
  - H2SV_TO_HSV_Simple
```
public static MBFImage H2SV_TO_HSV_Simple(MBFImage in)
```
    Convert H2SV to HSV VARIANT 1 using the simple formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumes H1 and H2 are 0..1. Output H is 0..1
    
    Parameters:
    in - H2SV image
    
    Returns:
    HSV image
  - H2SV2_TO_HSV_Simple
```
public static MBFImage H2SV2_TO_HSV_Simple(MBFImage in)
```
    Convert H2SV to HSV VARIANT 2 using the simple formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space Assumes H1 and H2 are 0..1. Output H is 0..1
    
    Parameters:
    in - H2SV2 image
    
    Returns:
    HSV image
  - HSV_TO_H2SV_2
```
public static MBFImage HSV_TO_H2SV_2(MBFImage in)
```
    Convert HSV to H2SV VARIANT 2 using the formulation from: http://ilab.usc.edu/wiki/index.php/HSV_And_H2SV_Color_Space
    
    Parameters:
    in - HSV image
    
    Returns:
    H2SV_2 image
  - RGB_TO_H2SV_2
```
public static MBFImage RGB_TO_H2SV_2(MBFImage in)
```
    Convert RGB to H2SV2 VARIANT 2
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    H2SV_2 image
  - RGB_TO_H2S_2
```
public static MBFImage RGB_TO_H2S_2(MBFImage in)
```
    Convert RGB to H2S VARIANT 2
    
    Parameters:
    in - RGB or RGBA image
    
    Returns:
    H2S image
  - RGB_TO_RGB_NORMALISED
```
public static MBFImage RGB_TO_RGB_NORMALISED(MBFImage in)
```
    Intensity normalisation
    
    Parameters:
    in - RGB image
    
    Returns:
    normalised RGB image
  - RGB_TO_CIEXYZ
```
public static MBFImage RGB_TO_CIEXYZ(MBFImage in)
```
    CIE_XYZ color space transform from RGB. Uses inverse sRGB companding for energy normalisation and assumes a D65 whitepoint. Transform described here: http://www.brucelindbloom.com/Eqn_RGB_to_XYZ.html
    
    Parameters:
    in - input RGB image
    
    Returns:
    CIEXYZ image
  - CIEXYZ_TO_RGB
```
public static MBFImage CIEXYZ_TO_RGB(MBFImage in)
```
    CIE_XYZ color space transform to RGB. Uses sRGB companding for energy normalisation and assumes a D65 whitepoint. Transform described here: http://www.brucelindbloom.com/Eqn_XYZ_to_RGB.html
    
    Parameters:
    in - input CIEXYZ image
    
    Returns:
    RGB image
  - CIEXYZ_TO_RGB
```
public static MBFImage CIEXYZ_TO_RGB(MBFImage in,
                     boolean inPlace)
```
    CIE_XYZ color space transform to RGB. Uses sRGB companding for energy normalisation and assumes a D65 whitepoint. Transform described here: http://www.brucelindbloom.com/Eqn_XYZ_to_RGB.html
    
    Parameters:
    in - input CIEXYZ image
    inPlace - if true then input image is modified, rather than creating a new image
    
    Returns:
    RGB image
  - CIEXYZ_TO_CIELab
```
public static MBFImage CIEXYZ_TO_CIELab(MBFImage input)
```
    Convert CIEXYZ to CIELab. See http://www.brucelindbloom.com/Eqn_XYZ_to_Lab.html
    
    Parameters:
    input - input image
    
    Returns:
    converted image
  - CIEXYZ_TO_CIELab
```
public static MBFImage CIEXYZ_TO_CIELab(MBFImage input,
                        boolean inPlace)
```
    Convert CIEXYZ to CIELab. See http://www.brucelindbloom.com/Eqn_XYZ_to_Lab.html
    
    Parameters:
    input - input image
    inPlace - if true then input image is modified, rather than creating a new image
    
    Returns:
    converted image
  - RGB_TO_CIELab
```
public static MBFImage RGB_TO_CIELab(MBFImage input)
```
    Convert RGB to CIE Lab. See http://www.brucelindbloom.com/index.html?Math.html Conversion goes from RGB->XYZ->Lab
    
    Parameters:
    input - input RGB image
    
    Returns:
    transformed CIE Lab image
  - CIELab_TO_CIEXYZ
```
public static MBFImage CIELab_TO_CIEXYZ(MBFImage input)
```
    Convert CIELab to CIEXYZ. See http://www.brucelindbloom.com/Eqn_Lab_to_XYZ.html
    
    Parameters:
    input - input image
    
    Returns:
    converted image
  - CIELab_TO_RGB
```
public static MBFImage CIELab_TO_RGB(MBFImage input)
```
    Convert CIE Lab to RGB. See http://www.brucelindbloom.com/index.html?Math.html Conversion goes from Lab->XYZ->RGB
    
    Parameters:
    input - input CIE Lab image
    
    Returns:
    transformed RGB image
  - RGB_TO_CIELabNormalised
```
public static MBFImage RGB_TO_CIELabNormalised(MBFImage input)
```
    Convert CIEXYZ to CIELab and normalise the resultant L, a & b values to 0..1. See http://www.brucelindbloom.com/Eqn_XYZ_to_Lab.html.
    
    Parameters:
    input - input image
    
    Returns:
    converted image
  - CIELabNormalised_TO_RGB
```
public static MBFImage CIELabNormalised_TO_RGB(MBFImage input)
```
    Convert normalised CIE Lab to RGB. The L, a & b values are in 0..1. See http://www.brucelindbloom.com/index.html?Math.html Conversion goes from Lab->XYZ->RGB
    
    Parameters:
    input - input CIE Lab image
    
    Returns:
    transformed RGB image
  - CIEXYZ_TO_CIELUV
```
public static MBFImage CIEXYZ_TO_CIELUV(MBFImage input)
```
    Convert CIEXYZ to CIELUV (CIE 1976) See http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html
    
    Parameters:
    input - input image
    
    Returns:
    converted image
  - CIEXYZ_TO_CIELUV
```
public static MBFImage CIEXYZ_TO_CIELUV(MBFImage input,
                        boolean inPlace)
```
    Convert CIEXYZ to CIELUV (CIE 1976) See http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html
    
    Parameters:
    input - input image
    inPlace - if true then input image is modified, rather than creating a new image
    
    Returns:
    converted image
  - RGB_TO_CIELUV
```
public static MBFImage RGB_TO_CIELUV(MBFImage input)
```
    Convert RGB to CIE LUV. See http://www.brucelindbloom.com/index.html?Math.html Conversion goes from RGB->XYZ->LUV
    
    Parameters:
    input - input RGB image
    
    Returns:
    transformed CIE LUV image
  - CIELUV_TO_CIEXYZ
```
public static MBFImage CIELUV_TO_CIEXYZ(MBFImage input)
```
    Convert CIELUV to CIEXYZ. See http://www.brucelindbloom.com/Eqn_Lab_to_XYZ.html
    
    Parameters:
    input - input image
    
    Returns:
    converted image
  - CIELUV_TO_RGB
```
public static MBFImage CIELUV_TO_RGB(MBFImage input)
```
    Convert CIE LUV to RGB. See http://www.brucelindbloom.com/index.html?Math.html Conversion goes from LUV->XYZ->RGB
    
    Parameters:
    input - input CIE LUV image
    
    Returns:
    transformed RGB image
  - RGB_TO_YUV
```
public static MBFImage RGB_TO_YUV(MBFImage input)
```
    Convert from RGB to YUV. Y is in the range [0, 1]; U is [-0.436, 0.436] and V is [-0.615, 0.615].
    
    Parameters:
    input - input RGB image
    
    Returns:
    transformed YUV image
  - RGB_TO_YUVNormalised
```
public static MBFImage RGB_TO_YUVNormalised(MBFImage input)
```
    Convert from RGB to normalised YUV. Y, U and V are all in the range [0, 1].
    
    Parameters:
    input - input RGB image
    
    Returns:
    transformed normalised YUV image
  - RGB_TO_YUV
```
public static MBFImage RGB_TO_YUV(MBFImage input,
                  boolean inPlace,
                  boolean norm)
```
    Convert from RGB to YUV. Conversion can be either in place or in a new image. The U and V components can optionally be normalised to 0..1 or alternatively take the standard ranges: U in [-0.436, 0.436] and V in [-0.615, 0.615].
    
    Parameters:
    input - input RGB image
    inPlace - if true the output will overwrite the input; otherwise a new image is created.
    norm - true if the U and V values are normalised to [0, 1].
    
    Returns:
    transformed YUV image
  - YUVNormalised_TO_RGB
```
public static MBFImage YUVNormalised_TO_RGB(MBFImage input)
```
    Convert from normalised YUV to RGB.
    
    Parameters:
    input - input normalised YUV image
    
    Returns:
    transformed RGB image
  - YUV_TO_RGB
```
public static MBFImage YUV_TO_RGB(MBFImage input)
```
    Convert from YUV to RGB.
    
    Parameters:
    input - input YUV image
    
    Returns:
    transformed RGB image
  - YUV_TO_RGB
```
public static MBFImage YUV_TO_RGB(MBFImage input,
                  boolean inPlace,
                  boolean norm)
```
    Convert from YUV to RGB. Conversion can be either in place or in a new image. The U and V components are either in [0, 1] (norm = true) or alternatively take the standard ranges (norm = false): U in [-0.436, 0.436] and V in [-0.615, 0.615].
    
    Parameters:
    input - input RGB image
    inPlace - if true the output will overwrite the input; otherwise a new image is created.
    norm - true if the U and V values should be normalised to [0, 1].
    
    Returns:
    transformed YUV image

Class Transforms

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Transforms

Method Detail

calculateIntensity

calculateIntensity

calculateIntensityNTSC

calculateHue

calculateSaturation

RGB_TO_HSI

RGB_TO_HSL

RGB_TO_HSY

RGB_TO_HS

RGB_TO_HS_2

projectHS

RGB_TO_HSV

HSV_TO_RGB

H_TO_H1H2

HSV_TO_H2SV

RGB_TO_H2SV

RGB_TO_H2S

H_TO_H1H2_2

H2SV_TO_HSV_Simple

H2SV2_TO_HSV_Simple

HSV_TO_H2SV_2

RGB_TO_H2SV_2

RGB_TO_H2S_2

RGB_TO_RGB_NORMALISED

RGB_TO_CIEXYZ

CIEXYZ_TO_RGB

CIEXYZ_TO_RGB

CIEXYZ_TO_CIELab

CIEXYZ_TO_CIELab

RGB_TO_CIELab

CIELab_TO_CIEXYZ

CIELab_TO_RGB

RGB_TO_CIELabNormalised

CIELabNormalised_TO_RGB

CIEXYZ_TO_CIELUV

CIEXYZ_TO_CIELUV

RGB_TO_CIELUV

CIELUV_TO_CIEXYZ

CIELUV_TO_RGB

RGB_TO_YUV

RGB_TO_YUVNormalised

RGB_TO_YUV

YUVNormalised_TO_RGB

YUV_TO_RGB

YUV_TO_RGB