PixelFormat (NativeWindow API -- 2.2 Specification)

java.lang.Object
- java.lang.Enum<PixelFormat>
- - javax.media.nativewindow.util.PixelFormat

All Implemented Interfaces:

Serializable, Comparable<PixelFormat>
```
public enum PixelFormat
extends Enum<PixelFormat>
```
Basic pixel formats
Notation follows OpenGL notation, i.e. name consist of all it's component names followed by their bit size.

Order of component names is from lowest-bit to highest-bit.

In case component-size is 1 byte (e.g. OpenGL data-type GL_UNSIGNED_BYTE), component names are ordered from lowest-byte to highest-byte. Note that OpenGL applies special interpretation if data-type is e.g. GL_UNSIGNED_8_8_8_8_REV or GL_UNSIGNED_8_8_8_8_REV.

PixelFormat can be converted to OpenGL GLPixelAttributes via
```
  GLPixelAttributes glpa = GLPixelAttributes.convert(PixelFormat pixFmt, GLProfile glp);
 
```
See OpenGL Specification 4.3 - February 14, 2013, Core Profile, Section 8.4.4 Transfer of Pixel Rectangles, p. 161-174.

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ABGR8888` Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
`ARGB8888` Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
`BGR888` Pixel size is 3 bytes (24 bits) with each component of size 1 byte (8 bits).
`BGRA8888` Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
`LUMINANCE` Pixel size is 1 bytes (8 bits) with one component of size 1 byte (8 bits).
`RGB888` Pixel size is 3 bytes (24 bits) with each component of size 1 byte (8 bits).
`RGBA8888` Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).

Field Summary

Fields
Modifier and Type Field and Description

int bitsPerPixel
Number of bits per pixel, e.g.

int componentCount
Number of components per pixel, e.g.

Fields
Modifier and Type	Field and Description
`int`	`bitsPerPixel` Number of bits per pixel, e.g.
`int`	`componentCount` Number of components per pixel, e.g.

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`bytesPerPixel()` Number of bytes per pixel, e.g.
`static PixelFormat`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static PixelFormat[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - LUMINANCE
```
public static final PixelFormat LUMINANCE
```
    Pixel size is 1 bytes (8 bits) with one component of size 1 byte (8 bits). Compatible with:
    - OpenGL: data-format GL_ALPHA (< GL3), GL_RED (>= GL3), data-type GL_UNSIGNED_BYTE
    - AWT: none
  - RGB888
```
public static final PixelFormat RGB888
```
    Pixel size is 3 bytes (24 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: R, G, B
    Compatible with:
    - OpenGL: data-format GL_RGB, data-type GL_UNSIGNED_BYTE
    - AWT: None
  - BGR888
```
public static final PixelFormat BGR888
```
    Pixel size is 3 bytes (24 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: B, G, R
    Compatible with:
    - OpenGL: data-format GL_BGR (>= GL2), data-type GL_UNSIGNED_BYTE
    - AWT: TYPE_3BYTE_BGR
  - RGBA8888
```
public static final PixelFormat RGBA8888
```
    Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: R, G, B, A
    Compatible with:
    - OpenGL: data-format GL_RGBA, data-type GL_UNSIGNED_BYTE
    - AWT: None
    - PointerIcon: X11 (XCURSOR)
    - PNGJ: Scanlines
  - ABGR8888
```
public static final PixelFormat ABGR8888
```
    Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: A, B, G, R
    Compatible with:
    - OpenGL: data-format GL_RGBA, data-type GL_UNSIGNED_8_8_8_8
    - AWT: TYPE_4BYTE_ABGR
  - ARGB8888
```
public static final PixelFormat ARGB8888
```
    Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: A, R, G, B
    Compatible with:
    - OpenGL: data-format GL_BGRA, data-type GL_UNSIGNED_INT_8_8_8_8
    - AWT: None
  - BGRA8888
```
public static final PixelFormat BGRA8888
```
    Pixel size is 4 bytes (32 bits) with each component of size 1 byte (8 bits).
    The components are interleaved in the order:
    - Low to High: B, G, R, A
    Compatible with:
    - OpenGL: data-format GL_BGRA, data-type GL_UNSIGNED_BYTE
    - AWT: TYPE_INT_ARGB
    - PointerIcon: Win32, OSX (NSBitmapImageRep), AWT
    - Window Icon: X11, Win32, OSX (NSBitmapImageRep)
- Field Detail
  - componentCount
```
public final int componentCount
```
    Number of components per pixel, e.g. 4 for RGBA.
  - bitsPerPixel
```
public final int bitsPerPixel
```
    Number of bits per pixel, e.g. 32 for RGBA.
- Method Detail
  - values
```
public static PixelFormat[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (PixelFormat c : PixelFormat.values())
    System.out.println(c);
```
    Returns:
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static PixelFormat valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    name - the name of the enum constant to be returned.
    
    Returns:
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - bytesPerPixel
```
public final int bytesPerPixel()
```
    Number of bytes per pixel, e.g. 4 for RGBA.

Enum PixelFormat

Enum Constant Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

LUMINANCE

RGB888

BGR888

RGBA8888

ABGR8888

ARGB8888

BGRA8888

Field Detail

componentCount

bitsPerPixel

Method Detail

values

valueOf

bytesPerPixel