Class PhotometricInterpretation

Photometric Interpretation.

Inheritance

Object

DicomParseable

PhotometricInterpretation

Inherited Members

DicomParseable.Parse<T>(String)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetType()

Object.MemberwiseClone()

Namespace: Dicom.Imaging

Assembly: cs.temp.dll.dll

Syntax

public class PhotometricInterpretation : DicomParseable

Fields

Monochrome1

Pixel data represent a single monochrome image plane. The minimum sample value is intended to be displayed as white after any VOI gray scale transformations have been performed. See PS 3.4. This value may be used only when Samples per Pixel (0028,0002) has a value of 1.

Declaration

public static readonly PhotometricInterpretation Monochrome1

Field Value

Type	Description
PhotometricInterpretation

Monochrome2

Pixel data represent a single monochrome image plane. The minimum sample value is intended to be displayed as black after any VOI gray scale transformations have been performed. See PS 3.4. This value may be used only when Samples per Pixel (0028,0002) has a value of 1.

Declaration

public static readonly PhotometricInterpretation Monochrome2

Field Value

Type	Description
PhotometricInterpretation

PaletteColor

Pixel data describe a color image with a single sample per pixel (single image plane). The pixel value is used as an index into each of the Red, Blue, and Green Palette Color Lookup Tables (0028,1101-1103 & 1201-1203). This value may be used only when Samples per Pixel (0028,0002) has a value of 1. When the Photometric Interpretation is Palette Color; Red, Blue, and Green Palette Color Lookup Tables shall be present.

Declaration

public static readonly PhotometricInterpretation PaletteColor

Field Value

Type	Description
PhotometricInterpretation

Rgb

Pixel data represent a color image described by red, green, and blue image planes. The minimum sample value for each color plane represents minimum intensity of the color. This value may be used only when Samples per Pixel (0028,0002) has a value of 3.

Declaration

public static readonly PhotometricInterpretation Rgb

Field Value

Type	Description
PhotometricInterpretation

YbrFull

Pixel data represent a color image described by one luminance (Y) and two chrominance planes (Cb and Cr). This photometric interpretation may be used only when Samples per Pixel (0028,0002) has a value of 3. Black is represented by Y equal to zero. The absence of color is represented by both Cb and Cr values equal to half full scale.

In the case where Bits Allocated (0028,0100) has a value of 8 then the following equations convert between RGB and YCBCR Photometric Interpretation: Y = + .2990R + .5870G + .1140B Cb = - .1687R - .3313G + .5000B + 128 Cr = + .5000R - .4187G - .0813B + 128

Declaration

public static readonly PhotometricInterpretation YbrFull

Field Value

Type	Description
PhotometricInterpretation

YbrFull422

The same as YBR_FULL except that the Cb and Cr values are sampled horizontally at half the Y rate and as a result there are half as many Cb and Cr values as Y values.

This Photometric Interpretation is only allowed with Planar Configuration (0028,0006) equal to 0.
Two Y values shall be stored followed by one Cb and one Cr value. The Cb and Cr values shall be sampled at the location of the first of the two Y values. For each Row of Pixels, the first Cb and Cr samples shall be at the location of the first Y sample. The next Cb and Cr samples shall be at the location of the third Y sample etc.

Declaration

public static readonly PhotometricInterpretation YbrFull422

Field Value

Type	Description
PhotometricInterpretation

YbrIct

Pixel data represent a color image described by one luminance (Y) and two chrominance planes (Cb and Cr). This photometric interpretation may be used only when Samples per Pixel (0028,0002) has a value of 3. Black is represented by Y equal to zero. The absence of color is represented by both Cb and Cr values equal to zero.

Regardless of the value of Bits Allocated (0028,0100), the following equations convert between RGB and YCbCr Photometric Interpretation: Y = + .29900R + .58700G + .11400B Cb = - .16875R - .33126G + .50000B Cr = + .50000R - .41869G - .08131B

Declaration

public static readonly PhotometricInterpretation YbrIct

Field Value

Type	Description
PhotometricInterpretation

YbrPartial420

The same as YBR_PARTIAL_422 except that the Cb and Cr values are sampled horizontally and vertically at half the Y rate and as a result there are four times less Cb and Cr values than Y values, versus twice less for YBR_PARTIAL_422.

This Photometric Interpretation is only allowed with Planar Configuration (0028,0006) equal to 0.
The Cb and Cr values shall be sampled at the location of the first of the two Y values. For the first Row of Pixels (etc.), the first Cb and Cr samples shall be at the location of the first Y sample. The next Cb and Cr samples shall be at the location of the third Y sample etc. The next Rows of Pixels containing Cb and Cr samples (at the same locations than for the first Row) will be the third etc.

Declaration

public static readonly PhotometricInterpretation YbrPartial420

Field Value

Type	Description
PhotometricInterpretation

YbrPartial422

The same as YBR_FULL_422 except that:

In the case where Bits Allocated (0028,0100) has value of 8 then the following equations convert between RGB and YBR_PARTIAL_422 Photometric Interpretation: Y = + .2568R + .5041G + .0979B + 16 Cb = - .1482R - .2910G + .4392B + 128 Cr = + .4392R - .3678G - .0714B + 128

Declaration

public static readonly PhotometricInterpretation YbrPartial422

Field Value

Type	Description
PhotometricInterpretation

YbrRct

Pixel data represent a color image described by one luminance (Y) and two chrominance planes (Cb and Cr). This photometric interpretation may be used only when Samples per Pixel (0028,0002) has a value of 3. Black is represented by Y equal to zero. The absence of color is represented by both Cb and Cr values equal to zero.

Regardless of the value of Bits Allocated (0028,0100), the following equations convert between RGB and YBR_RCT Photometric Interpretation: Y = floor((R + 2G +B) / 4) Cb = B - G Cr = R - G

The following equations convert between YBR_RCT and RGB Photometric Interpretation: R = Cr + G G = Y – floor((Cb + Cr) / 4) B = Cb + G

Declaration

public static readonly PhotometricInterpretation YbrRct

Field Value

Type	Description
PhotometricInterpretation

Properties

ColorSpace

Gets the color space of the photometric interpretation, or

null

if IsPalette is

false

.

Declaration

public ColorSpace ColorSpace { get; }

Property Value

Type	Description
ColorSpace

Description

Gets the description of the photometric interpretation.

Declaration

public string Description { get; }

Property Value

Type	Description
String

IsColor

Gets whether or not the photometric interpretation represents color (true) or grayscale (false).

Declaration

public bool IsColor { get; }

Property Value

Type	Description
Boolean

IsPalette

Gets whether or not the photometric interpretation is represented by a palette of colors.

Declaration

public bool IsPalette { get; }

Property Value

Type	Description
Boolean

IsYBR

Gets whether or not the photometric interpretation represents an YBR color scheme.

Declaration

public bool IsYBR { get; }

Property Value

Type	Description
Boolean

Value

Gets the identifier value, corresponding with a DICOM defined term for tag (0028, 0004).

Declaration

public string Value { get; }

Property Value

Type	Description
String

Methods

Equals(Object)

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
Object	obj

Returns

Type	Description
Boolean

Overrides

Object.Equals(Object)

GetHashCode()

Declaration

public override int GetHashCode()

Returns

Type	Description
Int32

Overrides

Object.GetHashCode()

Parse(String)

Parse the photometric interpretation based on a string, typically obtained by reading DICOM tag (0028,0004).

Declaration

public static PhotometricInterpretation Parse(string photometricInterpretation)

Parameters

Type	Name	Description
String	photometricInterpretation	String to be parsed.

Returns

Type	Description
PhotometricInterpretation	PhotometricInterpretation object corresponding to the parsed photometricInterpretation string.

Exceptions

Type	Condition
DicomImagingException	Thrown when the parsed string cannot be matched with the known photometric interpretations.

ToString()

Declaration

public override string ToString()

Returns

Type	Description
String

Overrides

Object.ToString()

Operators

Equality(PhotometricInterpretation, PhotometricInterpretation)

Equivalence operator for PhotometricInterpretation class.

Declaration

public static bool operator ==(PhotometricInterpretation a, PhotometricInterpretation b)

Parameters

Type	Name	Description
PhotometricInterpretation	a	Left-hand side object to compare for equivalence.
PhotometricInterpretation	b	Right-hand side object to compare for equivalence.

Returns

Type	Description
Boolean	True if both objects are null or PhotometricInterpretation objects with the same Value, false otherwise.

Inequality(PhotometricInterpretation, PhotometricInterpretation)

Non-equivalence operator for PhotometricInterpretation class.

Declaration

public static bool operator !=(PhotometricInterpretation a, PhotometricInterpretation b)

Parameters

Type	Name	Description
PhotometricInterpretation	a	Left-hand side object to compare for non-equivalence.
PhotometricInterpretation	b	Right-hand side object to compare for none-equivalence.

Returns

Type	Description
Boolean	True if exactly one object is null or if both are PhotometricInterpretation objects with different Value, false otherwise.