Utils (Fiji Javadocs 0-SNAPSHOT API)

java.lang.Object
- org.siox.util.Utils

```
public class Utils
extends Object
```
Collection of auxiliary image processing methods used by the SioxSegmentator mainly for postprocessing.

Version:

1.05

Author:

G. Friedland, K. Jantz, L. Knipping

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`average(int argb0, int argb1)` Averages two ARGB colors.
`static int`	`clabToRGB(float[] clab)` Converts an CLAB value to a RGB color value.
`static String`	`clabToString(float[] clab)` Returns a string representation of a CLAB value.
`static float`	`colordiff(int rgb0, int rgb1)` Computes Euclidian distance of two RGB color values.
`static float`	`colordiffsq(int rgb0, int rgb1)` Computes squared euclidian distance of two RGB color values.
`static void`	`dilate(float[] cm, int xres, int yres)` Applies the morphological dilate operator.
`static void`	`erode(float[] cm, int xres, int yres)` Applies the morphological erode operator.
`static float`	`euclid(float[] p, float[] q)` Euclidian distance of p and q.
`static int`	`getAlpha(int argb)` Returns the alpha component of an ARGB value.
`static int`	`getBlue(int rgb)` Returns the blue component of an (A)RGB value.
`static int`	`getGreen(int rgb)` Returns the green component of an (A)RGB value.
`static int`	`getRed(int rgb)` Returns the red component of an (A)RGB value.
`static float`	`labcolordiff(int rgb0, int rgb1)` Computes squared euclidian distance in CLAB space for two colors given as RGB values.
`static float`	`labcolordiffsq(int rgb0, int rgb1)` Computes squared euclidian distance in CLAB space for two colors given as RGB values.
`static void`	`normalizeMatrix(float[] cm)` Normalizes the matrix to values to [0..1].
`static int`	`packPixel(int a, int r, int g, int b)` Limits the values of a,r,g,b to values from 0 to 255 and puts them together into an 32 bit integer.
`static void`	`premultiplyMatrix(float alpha, float[] cm)` Multiplies matrix with the given scalar.
`static float[]`	`rgbToClab(int rgb)` Converts 24-bit RGB values to {l,a,b} float values.
`static int`	`setAlpha(float alpha, int rgb)` Sets the alpha byte of a pixel.
`static int`	`setAlpha(int alpha, int rgb)` Sets the alpha byte of a pixel.
`static void`	`smoothcm(float[] cm, int xres, int yres, float f1, float f2, float f3)` Blurs confidence matrix with a given symmetrically weighted kernel.
`static float`	`sqrEuclidianDist(float[] p, float[] q)` Squared Euclidian distance of p and q.

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

- Method Detail
  - dilate
```
public static void dilate(float[] cm,
                          int xres,
                          int yres)
```
    Applies the morphological dilate operator. Can be used to close small holes in the given confidence matrix.
    
    Parameters:
    
    cm - Confidence matrix to be processed.
    
    xres - Horizontal resolution of the matrix.
    
    yres - Vertical resolution of the matrix.
  - erode
```
public static void erode(float[] cm,
                         int xres,
                         int yres)
```
    Applies the morphological erode operator.
    
    Parameters:
    
    cm - Confidence matrix to be processed.
    
    xres - Horizontal resolution of the matrix.
    
    yres - Vertical resolution of the matrix.
  - normalizeMatrix
```
public static void normalizeMatrix(float[] cm)
```
    Normalizes the matrix to values to [0..1].
    
    Parameters:
    
    cm - The matrix to be normalized.
  - premultiplyMatrix
```
public static void premultiplyMatrix(float alpha,
                                     float[] cm)
```
    Multiplies matrix with the given scalar.
    
    Parameters:
    
    alpha - The scalar value.
    
    cm - The matrix of values be multiplied with alpha.
  - smoothcm
```
public static void smoothcm(float[] cm,
                            int xres,
                            int yres,
                            float f1,
                            float f2,
                            float f3)
```
    Blurs confidence matrix with a given symmetrically weighted kernel.
    In the standard case confidence matrix entries are between 0...1 and the weight factors sum up to 1.
    
    Parameters:
    
    cm - The matrix to be smoothed.
    
    xres - Horizontal resolution of the matrix.
    
    yres - Vertical resolution of the matrix.
    
    f1 - Weight factor for the first pixel.
    
    f2 - Weight factor for the mid-pixel.
    
    f3 - Weight factor for the last pixel.
  - sqrEuclidianDist
```
public static float sqrEuclidianDist(float[] p,
                                     float[] q)
```
    Squared Euclidian distance of p and q.
    Usage hint: When only comparisons between Euclidian distances without actual values are needed, the squared distance can be preferred for being faster to compute.
    
    Parameters:
    
    p - First euclidian point coordinates.
    
    q - Second euclidian point coordinates. Dimension must not be smaller than that of p. Any extra dimensions will be ignored.
    
    Returns:
    
    Squared euclidian distance of p and q.
    
    See Also:
    
    euclid(float[], float[])
  - euclid
```
public static float euclid(float[] p,
                           float[] q)
```
    Euclidian distance of p and q.
    
    Parameters:
    
    p - First euclidian point coordinates.
    
    q - Second euclidian point coordinates. Dimension must not be smaller than that of p. Any extra dimensions will be ignored.
    
    Returns:
    
    Squared euclidian distance of p and q.
    
    See Also:
    
    sqrEuclidianDist(float[], float[])
  - colordiff
```
public static float colordiff(int rgb0,
                              int rgb1)
```
    Computes Euclidian distance of two RGB color values.
    
    Parameters:
    
    rgb0 - First color value.
    
    rgb1 - Second color value.
    
    Returns:
    
    Euclidian distance between the two color values.
  - colordiffsq
```
public static float colordiffsq(int rgb0,
                                int rgb1)
```
    Computes squared euclidian distance of two RGB color values.
    Note: Faster to compute than colordiff
    
    Parameters:
    
    rgb0 - First color value.
    
    rgb1 - Second color value.
    
    Returns:
    
    Squared Euclidian distance between the two color values.
  - average
```
public static int average(int argb0,
                          int argb1)
```
    Averages two ARGB colors.
    
    Parameters:
    
    argb0 - First color value.
    
    argb1 - Second color value.
    
    Returns:
    
    The averaged ARGB color.
  - labcolordiffsq
```
public static float labcolordiffsq(int rgb0,
                                   int rgb1)
```
    Computes squared euclidian distance in CLAB space for two colors given as RGB values.
    
    Parameters:
    
    rgb0 - First color value.
    
    rgb1 - Second color value.
    
    Returns:
    
    Squared Euclidian distance in CLAB space.
  - labcolordiff
```
public static float labcolordiff(int rgb0,
                                 int rgb1)
```
    Computes squared euclidian distance in CLAB space for two colors given as RGB values.
    
    Parameters:
    
    rgb0 - First color value.
    
    rgb1 - Second color value.
    
    Returns:
    
    Euclidian distance in CLAB space.
  - rgbToClab
```
public static float[] rgbToClab(int rgb)
```
    Converts 24-bit RGB values to {l,a,b} float values.
    The conversion used is decribed at CLAB Conversion for reference white D65. Note that the conversion is computational expensive. Results are cached to speed up further conversion calls.
    
    Parameters:
    
    rgb - RGB color value,
    
    Returns:
    
    CLAB color value tripel.
  - clabToRGB
```
public static int clabToRGB(float[] clab)
```
    Converts an CLAB value to a RGB color value.
    This is the reverse operation to rgbToClab.
    
    Parameters:
    
    clab - CLAB value.
    
    Returns:
    
    RGB value.
    
    See Also:
    
    rgbToClab(int)
  - setAlpha
```
public static int setAlpha(int alpha,
                           int rgb)
```
    Sets the alpha byte of a pixel. Constructs alpha to values from 0 to 255.
    
    Parameters:
    
    alpha - Alpha value from 0 (transparent) to 255 (opaque).
    
    rgb - The 24bit rgb color to be combined with the alpga value.
    
    Returns:
    
    An ARBG calor value.
  - setAlpha
```
public static int setAlpha(float alpha,
                           int rgb)
```
    Sets the alpha byte of a pixel. Constricts alpha to values from 0 to 255.
    
    Parameters:
    
    alpha - Alpha value from 0.0f (transparent) to 1.0f (opaque).
    
    rgb - The 24bit rgb color to be combined with the alpga value.
    
    Returns:
    
    An ARBG calor value.
  - packPixel
```
public static int packPixel(int a,
                            int r,
                            int g,
                            int b)
```
    Limits the values of a,r,g,b to values from 0 to 255 and puts them together into an 32 bit integer.
    
    Parameters:
    
    a - Alpha part, the first byte.
    
    r - Red part, the second byte.
    
    g - Green part, the third byte.
    
    b - Blue part, the fourth byte.
    
    Returns:
    
    A ARBG value packed to an int.
  - getAlpha
```
public static int getAlpha(int argb)
```
    Returns the alpha component of an ARGB value.
    
    Parameters:
    
    argb - An ARGB color value.
    
    Returns:
    
    The alpha component, ranging from 0 to 255.
  - getRed
```
public static int getRed(int rgb)
```
    Returns the red component of an (A)RGB value.
    
    Parameters:
    
    rgb - An (A)RGB color value.
    
    Returns:
    
    The red component, ranging from 0 to 255.
  - getGreen
```
public static int getGreen(int rgb)
```
    Returns the green component of an (A)RGB value.
    
    Parameters:
    
    rgb - An (A)RGB color value.
    
    Returns:
    
    The green component, ranging from 0 to 255.
  - getBlue
```
public static int getBlue(int rgb)
```
    Returns the blue component of an (A)RGB value.
    
    Parameters:
    
    rgb - An (A)RGB color value.
    
    Returns:
    
    The blue component, ranging from 0 to 255.
  - clabToString
```
public static String clabToString(float[] clab)
```
    Returns a string representation of a CLAB value.
    
    Parameters:
    
    clab - The CLAB value.
    
    Returns:
    
    A string representation of the CLAB value.

Class Utils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

dilate

erode

normalizeMatrix

premultiplyMatrix

smoothcm

sqrEuclidianDist

euclid

colordiff

colordiffsq

average

labcolordiffsq

labcolordiff

rgbToClab

clabToRGB

setAlpha

setAlpha

packPixel

getAlpha

getRed

getGreen

getBlue

clabToString