# Difference between revisions of "Small Float Formats"

(Correcting and stubifying.) |
(Writing full article.) |
||

Line 1: | Line 1: | ||

'''Small Float Formats''', like the 16-bit half-float, are floating-point values that use less than the standard 32-bits of precision. This article details how these are encoded and used. | '''Small Float Formats''', like the 16-bit half-float, are floating-point values that use less than the standard 32-bits of precision. This article details how these are encoded and used. | ||

− | { | + | == IEEE float review == |

+ | |||

+ | We start with a quick review on how 32-bit floating-point numbers are encoded; detailed information can be found on [http://en.wikipedia.org/wiki/IEEE_754 Wikipedia.] | ||

+ | |||

+ | The IEEE 754 specification defines a floating-point encoding format that breaks a floating-point number into 3 parts: a sign bit, a ''mantissa'', and an ''exponent''. | ||

+ | |||

+ | The mantissa is an unsigned binary number (the sign of the number is in the sign bit) with some particular bitdepth. For 32-bit floats, this depth is 23 bits. The absolute value of the mantissa, when converting it into an actual number, is the mantissa divided by 2^bitdepth. This is the number that gets multiplied by the exponent. | ||

+ | |||

+ | The exponent has special handling. This is again an unsigned binary number with a particular bitdepth. A ''bias'' value is based on the particular bitdepth: it is (2^(bitdepth - 1)) - 1. For example, 32-bit floats have an exponent depth of 8, so they have a bias of 127. The bias is subtracted from the exponent based on certain properties. | ||

+ | |||

+ | The actual interpretation of the number depends on the value of the exponent. The exponent can be one of the following: | ||

+ | |||

+ | * 0: The resulting number is the mantissa directly multiplied by 2^(bias - 1). If the mantissa is also zero, you get 0.0. In floating-point numbers, you can have positive and negative 0. | ||

+ | * (0, 2^bitdepth - 1): The resulting number is 1.0 + the mantissa multiplied by 2^(exponent - bias). Note the addition of 1.0 to the mantissa in such cases. | ||

+ | * 2^bitdepth - 1: This will either be infinity or NaN based on the mantissa. A zero mantissa gives infinity, while any other number gives NaN. OpenGL's internal processes will produce undefined results when given Inf or NaN, but they will not crash. | ||

+ | |||

+ | The result of the above is negated if the sign bit is set. | ||

+ | |||

+ | This process works for floating-point numbers of any bitdepth. | ||

+ | |||

+ | == Low-bitdepth floats == | ||

+ | |||

+ | OpenGL supports a number of low bitdpeth floating-point formats. These are: | ||

+ | |||

+ | {| class="wikitable" border="1" | ||

+ | |- | ||

+ | ! Overall bitdepth | ||

+ | ! Sign bitdepth | ||

+ | ! Mantissa bitdepth | ||

+ | ! Exponent bitdepth | ||

+ | |- | ||

+ | | 16 | ||

+ | | 1 | ||

+ | | 10 | ||

+ | | 5 | ||

+ | |- | ||

+ | | 14** | ||

+ | | 0* | ||

+ | | 9 | ||

+ | | 5 | ||

+ | |- | ||

+ | | 11 | ||

+ | | 0* | ||

+ | | 6 | ||

+ | | 5 | ||

+ | |- | ||

+ | | 10 | ||

+ | | 0 | ||

+ | | 5 | ||

+ | | 5 | ||

+ | |- | ||

+ | |} | ||

+ | |||

+ | * No sign bits mean that the value is always positive. | ||

+ | ** Used only in RGB9_E5 textures. | ||

+ | |||

+ | |||

+ | === Half floats === | ||

+ | |||

+ | 32-bit floats are often called "single-precision" floats, and 64-bit floats are often called "double-precision" floats. 16-bit floats therefore are called "half-precision" floats, or just "half floats". | ||

+ | |||

+ | OpenGL supports the use of half floats in [[Image Formats]], but it also allows them to be used as vertex attributes during [[Vertex Specification]]. The OpenGL enumerator for half floats is GL_HALF_FLOAT. | ||

+ | |||

+ | === R11F_G11F_B10F === | ||

+ | |||

+ | The 11 and 10 bit floats are used exclusively for the GL_R11F_G11F_B10F image format. They have no sign bit, as they're generally used to represent image data in floating-point format. | ||

+ | |||

+ | === RGB9_E5 === | ||

+ | |||

+ | The 14-bit float format is exclusively used in the GL_RGB9_E5 image format. These have no sign bit, as they're generally used to represent image data. They have individual mantissa bits, but share a single exponent for all 3 values. | ||

[[Category:General OpenGL]] | [[Category:General OpenGL]] |

## Revision as of 19:01, 25 September 2009

**Small Float Formats**, like the 16-bit half-float, are floating-point values that use less than the standard 32-bits of precision. This article details how these are encoded and used.

## IEEE float review

We start with a quick review on how 32-bit floating-point numbers are encoded; detailed information can be found on Wikipedia.

The IEEE 754 specification defines a floating-point encoding format that breaks a floating-point number into 3 parts: a sign bit, a *mantissa*, and an *exponent*.

The mantissa is an unsigned binary number (the sign of the number is in the sign bit) with some particular bitdepth. For 32-bit floats, this depth is 23 bits. The absolute value of the mantissa, when converting it into an actual number, is the mantissa divided by 2^bitdepth. This is the number that gets multiplied by the exponent.

The exponent has special handling. This is again an unsigned binary number with a particular bitdepth. A *bias* value is based on the particular bitdepth: it is (2^(bitdepth - 1)) - 1. For example, 32-bit floats have an exponent depth of 8, so they have a bias of 127. The bias is subtracted from the exponent based on certain properties.

The actual interpretation of the number depends on the value of the exponent. The exponent can be one of the following:

- 0: The resulting number is the mantissa directly multiplied by 2^(bias - 1). If the mantissa is also zero, you get 0.0. In floating-point numbers, you can have positive and negative 0.
- (0, 2^bitdepth - 1): The resulting number is 1.0 + the mantissa multiplied by 2^(exponent - bias). Note the addition of 1.0 to the mantissa in such cases.
- 2^bitdepth - 1: This will either be infinity or NaN based on the mantissa. A zero mantissa gives infinity, while any other number gives NaN. OpenGL's internal processes will produce undefined results when given Inf or NaN, but they will not crash.

The result of the above is negated if the sign bit is set.

This process works for floating-point numbers of any bitdepth.

## Low-bitdepth floats

OpenGL supports a number of low bitdpeth floating-point formats. These are:

Overall bitdepth | Sign bitdepth | Mantissa bitdepth | Exponent bitdepth |
---|---|---|---|

16 | 1 | 10 | 5 |

14** | 0* | 9 | 5 |

11 | 0* | 6 | 5 |

10 | 0 | 5 | 5 |

- No sign bits mean that the value is always positive.
- Used only in RGB9_E5 textures.

### Half floats

32-bit floats are often called "single-precision" floats, and 64-bit floats are often called "double-precision" floats. 16-bit floats therefore are called "half-precision" floats, or just "half floats".

OpenGL supports the use of half floats in Image Formats, but it also allows them to be used as vertex attributes during Vertex Specification. The OpenGL enumerator for half floats is GL_HALF_FLOAT.

### R11F_G11F_B10F

The 11 and 10 bit floats are used exclusively for the GL_R11F_G11F_B10F image format. They have no sign bit, as they're generally used to represent image data in floating-point format.

### RGB9_E5

The 14-bit float format is exclusively used in the GL_RGB9_E5 image format. These have no sign bit, as they're generally used to represent image data. They have individual mantissa bits, but share a single exponent for all 3 values.