0.9.9 API documenation: GLM_GTC_packing

| 0.9.9 API documenation

Functions
GLM_GTC_packing
Recommended extensions

## Functions
GLM_FUNC_DECL uint32 | packF2x11_1x10 (vec3 const &v)
GLM_FUNC_DECL uint32 | packF3x9_E1x5 (vec3 const &v)
template<length_t L, qualifier Q>
GLM_FUNC_DECL vec< L, uint16, Q > | packHalf (vec< L, float, Q > const &v)
GLM_FUNC_DECL uint16 | packHalf1x16 (float v)
GLM_FUNC_DECL uint64 | packHalf4x16 (vec4 const &v)
GLM_FUNC_DECL uint32 | packI3x10_1x2 (ivec4 const &v)
GLM_FUNC_DECL int | packInt2x16 (i16vec2 const &v)
GLM_FUNC_DECL int64 | packInt2x32 (i32vec2 const &v)
GLM_FUNC_DECL int16 | packInt2x8 (i8vec2 const &v)
GLM_FUNC_DECL int64 | packInt4x16 (i16vec4 const &v)
GLM_FUNC_DECL int32 | packInt4x8 (i8vec4 const &v)
template<length_t L, typename T , qualifier Q>
GLM_FUNC_DECL vec< 4, T, Q > | packRGBM (vec< 3, T, Q > const &rgb)
template<typename intType , length_t L, typename floatType , qualifier Q>
GLM_FUNC_DECL vec< L, intType, Q > | packSnorm (vec< L, floatType, Q > const &v)
GLM_FUNC_DECL uint16 | packSnorm1x16 (float v)
GLM_FUNC_DECL uint8 | packSnorm1x8 (float s)
GLM_FUNC_DECL uint16 | packSnorm2x8 (vec2 const &v)
GLM_FUNC_DECL uint32 | packSnorm3x10_1x2 (vec4 const &v)
GLM_FUNC_DECL uint64 | packSnorm4x16 (vec4 const &v)
GLM_FUNC_DECL uint32 | packU3x10_1x2 (uvec4 const &v)
GLM_FUNC_DECL uint | packUint2x16 (u16vec2 const &v)
GLM_FUNC_DECL uint64 | packUint2x32 (u32vec2 const &v)
GLM_FUNC_DECL uint16 | packUint2x8 (u8vec2 const &v)
GLM_FUNC_DECL uint64 | packUint4x16 (u16vec4 const &v)
GLM_FUNC_DECL uint32 | packUint4x8 (u8vec4 const &v)
template<typename uintType , length_t L, typename floatType , qualifier Q>
GLM_FUNC_DECL vec< L, uintType, Q > | packUnorm (vec< L, floatType, Q > const &v)
GLM_FUNC_DECL uint16 | packUnorm1x16 (float v)
GLM_FUNC_DECL uint16 | packUnorm1x5_1x6_1x5 (vec3 const &v)
GLM_FUNC_DECL uint8 | packUnorm1x8 (float v)
GLM_FUNC_DECL uint8 | packUnorm2x3_1x2 (vec3 const &v)
GLM_FUNC_DECL uint8 | packUnorm2x4 (vec2 const &v)
GLM_FUNC_DECL uint16 | packUnorm2x8 (vec2 const &v)
GLM_FUNC_DECL uint32 | packUnorm3x10_1x2 (vec4 const &v)
GLM_FUNC_DECL uint16 | packUnorm3x5_1x1 (vec4 const &v)
GLM_FUNC_DECL uint64 | packUnorm4x16 (vec4 const &v)
GLM_FUNC_DECL uint16 | packUnorm4x4 (vec4 const &v)
GLM_FUNC_DECL vec3 | unpackF2x11_1x10 (uint32 p)
GLM_FUNC_DECL vec3 | unpackF3x9_E1x5 (uint32 p)
template<length_t L, qualifier Q>
GLM_FUNC_DECL vec< L, float, Q > | unpackHalf (vec< L, uint16, Q > const &p)
GLM_FUNC_DECL float | unpackHalf1x16 (uint16 v)
GLM_FUNC_DECL vec4 | unpackHalf4x16 (uint64 p)
GLM_FUNC_DECL ivec4 | unpackI3x10_1x2 (uint32 p)
GLM_FUNC_DECL i16vec2 | unpackInt2x16 (int p)
GLM_FUNC_DECL i32vec2 | unpackInt2x32 (int64 p)
GLM_FUNC_DECL i8vec2 | unpackInt2x8 (int16 p)
GLM_FUNC_DECL i16vec4 | unpackInt4x16 (int64 p)
GLM_FUNC_DECL i8vec4 | unpackInt4x8 (int32 p)
template<length_t L, typename T , qualifier Q>
GLM_FUNC_DECL vec< 3, T, Q > | unpackRGBM (vec< 4, T, Q > const &rgbm)
template<typename floatType , length_t L, typename intType , qualifier Q>
GLM_FUNC_DECL vec< L, floatType, Q > | unpackSnorm (vec< L, intType, Q > const &v)
GLM_FUNC_DECL float | unpackSnorm1x16 (uint16 p)
GLM_FUNC_DECL float | unpackSnorm1x8 (uint8 p)
GLM_FUNC_DECL vec2 | unpackSnorm2x8 (uint16 p)
GLM_FUNC_DECL vec4 | unpackSnorm3x10_1x2 (uint32 p)
GLM_FUNC_DECL vec4 | unpackSnorm4x16 (uint64 p)
GLM_FUNC_DECL uvec4 | unpackU3x10_1x2 (uint32 p)
GLM_FUNC_DECL u16vec2 | unpackUint2x16 (uint p)
GLM_FUNC_DECL u32vec2 | unpackUint2x32 (uint64 p)
GLM_FUNC_DECL u8vec2 | unpackUint2x8 (uint16 p)
GLM_FUNC_DECL u16vec4 | unpackUint4x16 (uint64 p)
GLM_FUNC_DECL u8vec4 | unpackUint4x8 (uint32 p)
template<typename floatType , length_t L, typename uintType , qualifier Q>
GLM_FUNC_DECL vec< L, floatType, Q > | unpackUnorm (vec< L, uintType, Q > const &v)
GLM_FUNC_DECL float | unpackUnorm1x16 (uint16 p)
GLM_FUNC_DECL vec3 | unpackUnorm1x5_1x6_1x5 (uint16 p)
GLM_FUNC_DECL float | unpackUnorm1x8 (uint8 p)
GLM_FUNC_DECL vec3 | unpackUnorm2x3_1x2 (uint8 p)
GLM_FUNC_DECL vec2 | unpackUnorm2x4 (uint8 p)
GLM_FUNC_DECL vec2 | unpackUnorm2x8 (uint16 p)
GLM_FUNC_DECL vec4 | unpackUnorm3x10_1x2 (uint32 p)
GLM_FUNC_DECL vec4 | unpackUnorm3x5_1x1 (uint16 p)
GLM_FUNC_DECL vec4 | unpackUnorm4x16 (uint64 p)
GLM_FUNC_DECL vec4 | unpackUnorm4x4 (uint16 p)

## Detailed Description

Include <glm/gtc/packing.hpp> to use the features of this extension.

This extension provides a set of function to convert vertors to packed formats.

## Function Documentation

## ◆ packF2x11_1x10()

GLM_FUNC_DECL uint32 glm::packF2x11_1x10 | ( | vec3 const & | v | ) |

First, converts the first two components of the normalized floating-point value v into 11-bit signless floating-point values.

Then, converts the third component of the normalized floating-point value v into a 10-bit signless floating-point value. Then, the results are packed into the returned 32-bit unsigned integer.

The first vector component specifies the 11 least-significant bits of the result; the last component specifies the 10 most-significant bits.

See also
  GLM_GTC_packing
  vec3 unpackF2x11_1x10(uint32 const& p)

## ◆ packF3x9_E1x5()

GLM_FUNC_DECL uint32 glm::packF3x9_E1x5 | ( | vec3 const & | v | ) |

First, converts the first two components of the normalized floating-point value v into 11-bit signless floating-point values.

Then, converts the third component of the normalized floating-point value v into a 10-bit signless floating-point value. Then, the results are packed into the returned 32-bit unsigned integer.

The first vector component specifies the 11 least-significant bits of the result; the last component specifies the 10 most-significant bits.

packF3x9_E1x5 allows encoding into RGBE / RGB9E5 format

See also
  GLM_GTC_packing
  vec3 unpackF3x9_E1x5(uint32 const& p)

## ◆ packHalf()

GLM_FUNC_DECL vec<L, uint16, Q> glm::packHalf | ( | vec< L, float, Q > const & | v | ) |

Returns an unsigned integer vector obtained by converting the components of a floating-point vector to the 16-bit floating-point representation found in the OpenGL Specification.

The first vector component specifies the 16 least-significant bits of the result; the forth component specifies the 16 most-significant bits.

See also
  GLM_GTC_packing
  vec<L, float, Q> unpackHalf(vec<L, uint16, Q> const& p)
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packHalf1x16()

GLM_FUNC_DECL uint16 glm::packHalf1x16 | ( | float | v | ) |

Returns an unsigned integer obtained by converting the components of a floating-point scalar to the 16-bit floating-point representation found in the OpenGL Specification, and then packing this 16-bit value into a 16-bit unsigned integer.

See also
  GLM_GTC_packing
  uint32 packHalf2x16(vec2 const& v)
  uint64 packHalf4x16(vec4 const& v)
  GLSL packHalf2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packHalf4x16()

GLM_FUNC_DECL uint64 glm::packHalf4x16 | ( | vec4 const & | v | ) |

Returns an unsigned integer obtained by converting the components of a four-component floating-point vector to the 16-bit floating-point representation found in the OpenGL Specification, and then packing these four 16-bit values into a 64-bit unsigned integer.

The first vector component specifies the 16 least-significant bits of the result; the forth component specifies the 16 most-significant bits.

See also
  GLM_GTC_packing
  uint16 packHalf1x16(float const& v)
  uint32 packHalf2x16(vec2 const& v)
  GLSL packHalf2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packI3x10_1x2()

GLM_FUNC_DECL uint32 glm::packI3x10_1x2 | ( | ivec4 const & | v | ) |

Returns an unsigned integer obtained by converting the components of a four-component signed integer vector to the 10-10-10-2-bit signed integer representation found in the OpenGL Specification, and then packing these four values into a 32-bit unsigned integer.

The first vector component specifies the 10 least-significant bits of the result; the forth component specifies the 2 most-significant bits.

See also
  GLM_GTC_packing
  uint32 packI3x10_1x2(uvec4 const& v)
  uint32 packSnorm3x10_1x2(vec4 const& v)
  uint32 packUnorm3x10_1x2(vec4 const& v)
  ivec4 unpackI3x10_1x2(uint32 const& p)

## ◆ packInt2x16()

GLM_FUNC_DECL int glm::packInt2x16 | ( | i16vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  i16vec2 unpackInt2x16(int p)

## ◆ packInt2x32()

GLM_FUNC_DECL int64 glm::packInt2x32 | ( | i32vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  i32vec2 unpackInt2x32(int p)

## ◆ packInt2x8()

GLM_FUNC_DECL int16 glm::packInt2x8 | ( | i8vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  i8vec2 unpackInt2x8(int16 p)

## ◆ packInt4x16()

GLM_FUNC_DECL int64 glm::packInt4x16 | ( | i16vec4 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  i16vec4 unpackInt4x16(int64 p)

## ◆ packInt4x8()

GLM_FUNC_DECL int32 glm::packInt4x8 | ( | i8vec4 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  i8vec4 unpackInt4x8(int32 p)

## ◆ packRGBM()

GLM_FUNC_DECL vec<4, T, Q> glm::packRGBM | ( | vec< 3, T, Q > const & | rgb | ) |

Returns an unsigned integer vector obtained by converting the components of a floating-point vector to the 16-bit floating-point representation found in the OpenGL Specification.

The first vector component specifies the 16 least-significant bits of the result; the forth component specifies the 16 most-significant bits.

See also
  GLM_GTC_packing
  vec<3, T, Q> unpackRGBM(vec<4, T, Q> const& p)
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packSnorm()

GLM_FUNC_DECL vec<L, intType, Q> glm::packSnorm | ( | vec< L, floatType, Q > const & | v | ) |

Convert each component of the normalized floating-point vector into signed integer values.

See also
  GLM_GTC_packing
  vec<L, floatType, Q> unpackSnorm(vec<L, intType, Q> const& p);

## ◆ packSnorm1x16()

GLM_FUNC_DECL uint16 glm::packSnorm1x16 | ( | float | v | ) |

First, converts the normalized floating-point value v into 16-bit integer value.

Then, the results are packed into the returned 16-bit unsigned integer.

The conversion to fixed point is done as follows: packSnorm1x8: round(clamp(s, -1, +1) * 32767.0)

See also
  GLM_GTC_packing
  uint32 packSnorm2x16(vec2 const& v)
  uint64 packSnorm4x16(vec4 const& v)
  GLSL packSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packSnorm1x8()

GLM_FUNC_DECL uint8 glm::packSnorm1x8 | ( | float | s | ) |

First, converts the normalized floating-point value v into 8-bit integer value.

Then, the results are packed into the returned 8-bit unsigned integer.

The conversion to fixed point is done as follows: packSnorm1x8: round(clamp(s, -1, +1) * 127.0)

See also
  GLM_GTC_packing
  uint16 packSnorm2x8(vec2 const& v)
  uint32 packSnorm4x8(vec4 const& v)
  GLSL packSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packSnorm2x8()

GLM_FUNC_DECL uint16 glm::packSnorm2x8 | ( | vec2 const & | v | ) |

First, converts each component of the normalized floating-point value v into 8-bit integer values.

Then, the results are packed into the returned 16-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packSnorm2x8: round(clamp(c, -1, +1) * 127.0)

The first component of the vector will be written to the least significant bits of the output; the last component will be written to the most significant bits.

See also
  GLM_GTC_packing
  uint8 packSnorm1x8(float const& v)
  uint32 packSnorm4x8(vec4 const& v)
  GLSL packSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packSnorm3x10_1x2()

GLM_FUNC_DECL uint32 glm::packSnorm3x10_1x2 | ( | vec4 const & | v | ) |

First, converts the first three components of the normalized floating-point value v into 10-bit signed integer values.

Then, converts the forth component of the normalized floating-point value v into 2-bit signed integer values. Then, the results are packed into the returned 32-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packSnorm3x10_1x2(xyz): round(clamp(c, -1, +1) * 511.0) packSnorm3x10_1x2(w): round(clamp(c, -1, +1) * 1.0)

The first vector component specifies the 10 least-significant bits of the result; the forth component specifies the 2 most-significant bits.

See also
  GLM_GTC_packing
  vec4 unpackSnorm3x10_1x2(uint32 const& p)
  uint32 packUnorm3x10_1x2(vec4 const& v)
  uint32 packU3x10_1x2(uvec4 const& v)
  uint32 packI3x10_1x2(ivec4 const& v)

## ◆ packSnorm4x16()

GLM_FUNC_DECL uint64 glm::packSnorm4x16 | ( | vec4 const & | v | ) |

First, converts each component of the normalized floating-point value v into 16-bit integer values.

Then, the results are packed into the returned 64-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packSnorm2x8: round(clamp(c, -1, +1) * 32767.0)

The first component of the vector will be written to the least significant bits of the output; the last component will be written to the most significant bits.

See also
  GLM_GTC_packing
  uint16 packSnorm1x16(float const& v)
  uint32 packSnorm2x16(vec2 const& v)
  GLSL packSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packU3x10_1x2()

GLM_FUNC_DECL uint32 glm::packU3x10_1x2 | ( | uvec4 const & | v | ) |

Returns an unsigned integer obtained by converting the components of a four-component unsigned integer vector to the 10-10-10-2-bit unsigned integer representation found in the OpenGL Specification, and then packing these four values into a 32-bit unsigned integer.

The first vector component specifies the 10 least-significant bits of the result; the forth component specifies the 2 most-significant bits.

See also
  GLM_GTC_packing
  uint32 packI3x10_1x2(ivec4 const& v)
  uint32 packSnorm3x10_1x2(vec4 const& v)
  uint32 packUnorm3x10_1x2(vec4 const& v)
  ivec4 unpackU3x10_1x2(uint32 const& p)

## ◆ packUint2x16()

GLM_FUNC_DECL uint glm::packUint2x16 | ( | u16vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  u16vec2 unpackUint2x16(uint p)

## ◆ packUint2x32()

GLM_FUNC_DECL uint64 glm::packUint2x32 | ( | u32vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  u32vec2 unpackUint2x32(int p)

## ◆ packUint2x8()

GLM_FUNC_DECL uint16 glm::packUint2x8 | ( | u8vec2 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  u8vec2 unpackInt2x8(uint16 p)

## ◆ packUint4x16()

GLM_FUNC_DECL uint64 glm::packUint4x16 | ( | u16vec4 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  u16vec4 unpackUint4x16(uint64 p)

## ◆ packUint4x8()

GLM_FUNC_DECL uint32 glm::packUint4x8 | ( | u8vec4 const & | v | ) |

Convert each component from an integer vector into a packed unsigned integer.

See also
  GLM_GTC_packing
  u8vec4 unpackUint4x8(uint32 p)

## ◆ packUnorm()

GLM_FUNC_DECL vec<L, uintType, Q> glm::packUnorm | ( | vec< L, floatType, Q > const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec<L, floatType, Q> unpackUnorm(vec<L, intType, Q> const& p);

## ◆ packUnorm1x16()

GLM_FUNC_DECL uint16 glm::packUnorm1x16 | ( | float | v | ) |

First, converts the normalized floating-point value v into a 16-bit integer value.

Then, the results are packed into the returned 16-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packUnorm1x16: round(clamp(c, 0, +1) * 65535.0)

See also
  GLM_GTC_packing
  uint16 packSnorm1x16(float const& v)
  uint64 packSnorm4x16(vec4 const& v)
  GLSL packUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packUnorm1x5_1x6_1x5()

GLM_FUNC_DECL uint16 glm::packUnorm1x5_1x6_1x5 | ( | vec3 const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec3 unpackUnorm1x5_1x6_1x5(uint16 p)

## ◆ packUnorm1x8()

GLM_FUNC_DECL uint8 glm::packUnorm1x8 | ( | float | v | ) |

First, converts the normalized floating-point value v into a 8-bit integer value.

Then, the results are packed into the returned 8-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packUnorm1x8: round(clamp(c, 0, +1) * 255.0)

See also
  GLM_GTC_packing
  uint16 packUnorm2x8(vec2 const& v)
  uint32 packUnorm4x8(vec4 const& v)
  GLSL packUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packUnorm2x3_1x2()

GLM_FUNC_DECL uint8 glm::packUnorm2x3_1x2 | ( | vec3 const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec3 unpackUnorm2x3_1x2(uint8 p)

## ◆ packUnorm2x4()

GLM_FUNC_DECL uint8 glm::packUnorm2x4 | ( | vec2 const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec2 unpackUnorm2x4(uint8 p)

## ◆ packUnorm2x8()

GLM_FUNC_DECL uint16 glm::packUnorm2x8 | ( | vec2 const & | v | ) |

First, converts each component of the normalized floating-point value v into 8-bit integer values.

Then, the results are packed into the returned 16-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packUnorm2x8: round(clamp(c, 0, +1) * 255.0)

The first component of the vector will be written to the least significant bits of the output; the last component will be written to the most significant bits.

See also
  GLM_GTC_packing
  uint8 packUnorm1x8(float const& v)
  uint32 packUnorm4x8(vec4 const& v)
  GLSL packUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packUnorm3x10_1x2()

GLM_FUNC_DECL uint32 glm::packUnorm3x10_1x2 | ( | vec4 const & | v | ) |

First, converts the first three components of the normalized floating-point value v into 10-bit unsigned integer values.

Then, converts the forth component of the normalized floating-point value v into 2-bit signed uninteger values. Then, the results are packed into the returned 32-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packUnorm3x10_1x2(xyz): round(clamp(c, 0, +1) * 1023.0) packUnorm3x10_1x2(w): round(clamp(c, 0, +1) * 3.0)

The first vector component specifies the 10 least-significant bits of the result; the forth component specifies the 2 most-significant bits.

See also
  GLM_GTC_packing
  vec4 unpackUnorm3x10_1x2(uint32 const& p)
  uint32 packUnorm3x10_1x2(vec4 const& v)
  uint32 packU3x10_1x2(uvec4 const& v)
  uint32 packI3x10_1x2(ivec4 const& v)

## ◆ packUnorm3x5_1x1()

GLM_FUNC_DECL uint16 glm::packUnorm3x5_1x1 | ( | vec4 const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec4 unpackUnorm3x5_1x1(uint16 p)

## ◆ packUnorm4x16()

GLM_FUNC_DECL uint64 glm::packUnorm4x16 | ( | vec4 const & | v | ) |

First, converts each component of the normalized floating-point value v into 16-bit integer values.

Then, the results are packed into the returned 64-bit unsigned integer.

The conversion for component c of v to fixed point is done as follows: packUnorm4x16: round(clamp(c, 0, +1) * 65535.0)

The first component of the vector will be written to the least significant bits of the output; the last component will be written to the most significant bits.

See also
  GLM_GTC_packing
  uint16 packUnorm1x16(float const& v)
  uint32 packUnorm2x16(vec2 const& v)
  GLSL packUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ packUnorm4x4()

GLM_FUNC_DECL uint16 glm::packUnorm4x4 | ( | vec4 const & | v | ) |

Convert each component of the normalized floating-point vector into unsigned integer values.

See also
  GLM_GTC_packing
  vec4 unpackUnorm4x4(uint16 p)

## ◆ unpackF2x11_1x10()

GLM_FUNC_DECL vec3 glm::unpackF2x11_1x10 | ( | uint32 | p | ) |

First, unpacks a single 32-bit unsigned integer p into two 11-bit signless floating-point values and one 10-bit signless floating-point value .

Then, each component is converted to a normalized floating-point value to generate the returned three-component vector.

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  uint32 packF2x11_1x10(vec3 const& v)

## ◆ unpackF3x9_E1x5()

GLM_FUNC_DECL vec3 glm::unpackF3x9_E1x5 | ( | uint32 | p | ) |

First, unpacks a single 32-bit unsigned integer p into two 11-bit signless floating-point values and one 10-bit signless floating-point value .

Then, each component is converted to a normalized floating-point value to generate the returned three-component vector.

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

unpackF3x9_E1x5 allows decoding RGBE / RGB9E5 data

See also
  GLM_GTC_packing
  uint32 packF3x9_E1x5(vec3 const& v)

## ◆ unpackHalf()

GLM_FUNC_DECL vec<L, float, Q> glm::unpackHalf | ( | vec< L, uint16, Q > const & | p | ) |

Returns a floating-point vector with components obtained by reinterpreting an integer vector as 16-bit floating-point numbers and converting them to 32-bit floating-point values.

The first component of the vector is obtained from the 16 least-significant bits of v; the forth component is obtained from the 16 most-significant bits of v.

See also
  GLM_GTC_packing
  vec<L, uint16, Q> packHalf(vec<L, float, Q> const& v)
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackHalf1x16()

GLM_FUNC_DECL float glm::unpackHalf1x16 | ( | uint16 | v | ) |

Returns a floating-point scalar with components obtained by unpacking a 16-bit unsigned integer into a 16-bit value, interpreted as a 16-bit floating-point number according to the OpenGL Specification, and converting it to 32-bit floating-point values.

See also
  GLM_GTC_packing
  vec2 unpackHalf2x16(uint32 const& v)
  vec4 unpackHalf4x16(uint64 const& v)
  GLSL unpackHalf2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackHalf4x16()

GLM_FUNC_DECL vec4 glm::unpackHalf4x16 | ( | uint64 | p | ) |

Returns a four-component floating-point vector with components obtained by unpacking a 64-bit unsigned integer into four 16-bit values, interpreting those values as 16-bit floating-point numbers according to the OpenGL Specification, and converting them to 32-bit floating-point values.

The first component of the vector is obtained from the 16 least-significant bits of v; the forth component is obtained from the 16 most-significant bits of v.

See also
  GLM_GTC_packing
  float unpackHalf1x16(uint16 const& v)
  vec2 unpackHalf2x16(uint32 const& v)
  GLSL unpackHalf2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackI3x10_1x2()

GLM_FUNC_DECL ivec4 glm::unpackI3x10_1x2 | ( | uint32 | p | ) |

Unpacks a single 32-bit unsigned integer p into three 10-bit and one 2-bit signed integers.

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  uint32 packU3x10_1x2(uvec4 const& v)
  vec4 unpackSnorm3x10_1x2(uint32 const& p);
  uvec4 unpackI3x10_1x2(uint32 const& p);

## ◆ unpackInt2x16()

GLM_FUNC_DECL i16vec2 glm::unpackInt2x16 | ( | int | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int packInt2x16(i16vec2 const& v)

## ◆ unpackInt2x32()

GLM_FUNC_DECL i32vec2 glm::unpackInt2x32 | ( | int64 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int packInt2x16(i32vec2 const& v)

## ◆ unpackInt2x8()

GLM_FUNC_DECL i8vec2 glm::unpackInt2x8 | ( | int16 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int16 packInt2x8(i8vec2 const& v)

## ◆ unpackInt4x16()

GLM_FUNC_DECL i16vec4 glm::unpackInt4x16 | ( | int64 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int64 packInt4x16(i16vec4 const& v)

## ◆ unpackInt4x8()

GLM_FUNC_DECL i8vec4 glm::unpackInt4x8 | ( | int32 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int32 packInt2x8(i8vec4 const& v)

## ◆ unpackRGBM()

GLM_FUNC_DECL vec<3, T, Q> glm::unpackRGBM | ( | vec< 4, T, Q > const & | rgbm | ) |

Returns a floating-point vector with components obtained by reinterpreting an integer vector as 16-bit floating-point numbers and converting them to 32-bit floating-point values.

The first component of the vector is obtained from the 16 least-significant bits of v; the forth component is obtained from the 16 most-significant bits of v.

See also
  GLM_GTC_packing
  vec<4, T, Q> packRGBM(vec<3, float, Q> const& v)
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackSnorm()

GLM_FUNC_DECL vec<L, floatType, Q> glm::unpackSnorm | ( | vec< L, intType, Q > const & | v | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  vec<L, intType, Q> packSnorm(vec<L, floatType, Q> const& v)

## ◆ unpackSnorm1x16()

GLM_FUNC_DECL float glm::unpackSnorm1x16 | ( | uint16 | p | ) |

First, unpacks a single 16-bit unsigned integer p into a single 16-bit signed integers.

Then, each component is converted to a normalized floating-point value to generate the returned scalar.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm1x16: clamp(f / 32767.0, -1, +1)

See also
  GLM_GTC_packing
  vec2 unpackSnorm2x16(uint32 p)
  vec4 unpackSnorm4x16(uint64 p)
  GLSL unpackSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackSnorm1x8()

GLM_FUNC_DECL float glm::unpackSnorm1x8 | ( | uint8 | p | ) |

First, unpacks a single 8-bit unsigned integer p into a single 8-bit signed integers.

Then, the value is converted to a normalized floating-point value to generate the returned scalar.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm1x8: clamp(f / 127.0, -1, +1)

See also
  GLM_GTC_packing
  vec2 unpackSnorm2x8(uint16 p)
  vec4 unpackSnorm4x8(uint32 p)
  GLSL unpackSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackSnorm2x8()

GLM_FUNC_DECL vec2 glm::unpackSnorm2x8 | ( | uint16 | p | ) |

First, unpacks a single 16-bit unsigned integer p into a pair of 8-bit signed integers.

Then, each component is converted to a normalized floating-point value to generate the returned two-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm2x8: clamp(f / 127.0, -1, +1)

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  float unpackSnorm1x8(uint8 p)
  vec4 unpackSnorm4x8(uint32 p)
  GLSL unpackSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackSnorm3x10_1x2()

GLM_FUNC_DECL vec4 glm::unpackSnorm3x10_1x2 | ( | uint32 | p | ) |

First, unpacks a single 32-bit unsigned integer p into four 16-bit signed integers.

Then, each component is converted to a normalized floating-point value to generate the returned four-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm3x10_1x2(xyz): clamp(f / 511.0, -1, +1) unpackSnorm3x10_1x2(w): clamp(f / 511.0, -1, +1)

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  uint32 packSnorm3x10_1x2(vec4 const& v)
  vec4 unpackUnorm3x10_1x2(uint32 const& p))
  uvec4 unpackI3x10_1x2(uint32 const& p)
  uvec4 unpackU3x10_1x2(uint32 const& p)

## ◆ unpackSnorm4x16()

GLM_FUNC_DECL vec4 glm::unpackSnorm4x16 | ( | uint64 | p | ) |

First, unpacks a single 64-bit unsigned integer p into four 16-bit signed integers.

Then, each component is converted to a normalized floating-point value to generate the returned four-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm4x16: clamp(f / 32767.0, -1, +1)

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  float unpackSnorm1x16(uint16 p)
  vec2 unpackSnorm2x16(uint32 p)
  GLSL unpackSnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackU3x10_1x2()

GLM_FUNC_DECL uvec4 glm::unpackU3x10_1x2 | ( | uint32 | p | ) |

Unpacks a single 32-bit unsigned integer p into three 10-bit and one 2-bit unsigned integers.

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  uint32 packU3x10_1x2(uvec4 const& v)
  vec4 unpackSnorm3x10_1x2(uint32 const& p);
  uvec4 unpackI3x10_1x2(uint32 const& p);

## ◆ unpackUint2x16()

GLM_FUNC_DECL u16vec2 glm::unpackUint2x16 | ( | uint | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  uint packUint2x16(u16vec2 const& v)

## ◆ unpackUint2x32()

GLM_FUNC_DECL u32vec2 glm::unpackUint2x32 | ( | uint64 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  int packUint2x16(u32vec2 const& v)

## ◆ unpackUint2x8()

GLM_FUNC_DECL u8vec2 glm::unpackUint2x8 | ( | uint16 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  uint16 packInt2x8(u8vec2 const& v)

## ◆ unpackUint4x16()

GLM_FUNC_DECL u16vec4 glm::unpackUint4x16 | ( | uint64 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  uint64 packUint4x16(u16vec4 const& v)

## ◆ unpackUint4x8()

GLM_FUNC_DECL u8vec4 glm::unpackUint4x8 | ( | uint32 | p | ) |

Convert a packed integer into an integer vector.

See also
  GLM_GTC_packing
  uint32 packUint4x8(u8vec2 const& v)

## ◆ unpackUnorm()

GLM_FUNC_DECL vec<L, floatType, Q> glm::unpackUnorm | ( | vec< L, uintType, Q > const & | v | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  vec<L, intType, Q> packUnorm(vec<L, floatType, Q> const& v)

## ◆ unpackUnorm1x16()

GLM_FUNC_DECL float glm::unpackUnorm1x16 | ( | uint16 | p | ) |

First, unpacks a single 16-bit unsigned integer p into a of 16-bit unsigned integers.

Then, the value is converted to a normalized floating-point value to generate the returned scalar.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackUnorm1x16: f / 65535.0

See also
  GLM_GTC_packing
  vec2 unpackUnorm2x16(uint32 p)
  vec4 unpackUnorm4x16(uint64 p)
  GLSL unpackUnorm2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackUnorm1x5_1x6_1x5()

GLM_FUNC_DECL vec3 glm::unpackUnorm1x5_1x6_1x5 | ( | uint16 | p | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  uint16 packUnorm1x5_1x6_1x5(vec3 const& v)

## ◆ unpackUnorm1x8()

GLM_FUNC_DECL float glm::unpackUnorm1x8 | ( | uint8 | p | ) |

Convert a single 8-bit integer to a normalized floating-point value.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackUnorm4x8: f / 255.0

See also
  GLM_GTC_packing
  vec2 unpackUnorm2x8(uint16 p)
  vec4 unpackUnorm4x8(uint32 p)
  GLSL unpackUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackUnorm2x3_1x2()

GLM_FUNC_DECL vec3 glm::unpackUnorm2x3_1x2 | ( | uint8 | p | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  uint8 packUnorm2x3_1x2(vec3 const& v)

## ◆ unpackUnorm2x4()

GLM_FUNC_DECL vec2 glm::unpackUnorm2x4 | ( | uint8 | p | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  uint8 packUnorm2x4(vec2 const& v)

## ◆ unpackUnorm2x8()

GLM_FUNC_DECL vec2 glm::unpackUnorm2x8 | ( | uint16 | p | ) |

First, unpacks a single 16-bit unsigned integer p into a pair of 8-bit unsigned integers.

Then, each component is converted to a normalized floating-point value to generate the returned two-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackUnorm4x8: f / 255.0

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  float unpackUnorm1x8(uint8 v)
  vec4 unpackUnorm4x8(uint32 p)
  GLSL unpackUnorm4x8 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackUnorm3x10_1x2()

GLM_FUNC_DECL vec4 glm::unpackUnorm3x10_1x2 | ( | uint32 | p | ) |

First, unpacks a single 32-bit unsigned integer p into four 16-bit signed integers.

Then, each component is converted to a normalized floating-point value to generate the returned four-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackSnorm3x10_1x2(xyz): clamp(f / 1023.0, 0, +1) unpackSnorm3x10_1x2(w): clamp(f / 3.0, 0, +1)

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  uint32 packSnorm3x10_1x2(vec4 const& v)
  vec4 unpackInorm3x10_1x2(uint32 const& p))
  uvec4 unpackI3x10_1x2(uint32 const& p)
  uvec4 unpackU3x10_1x2(uint32 const& p)

## ◆ unpackUnorm3x5_1x1()

GLM_FUNC_DECL vec4 glm::unpackUnorm3x5_1x1 | ( | uint16 | p | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  uint16 packUnorm3x5_1x1(vec4 const& v)

## ◆ unpackUnorm4x16()

GLM_FUNC_DECL vec4 glm::unpackUnorm4x16 | ( | uint64 | p | ) |

First, unpacks a single 64-bit unsigned integer p into four 16-bit unsigned integers.

Then, each component is converted to a normalized floating-point value to generate the returned four-component vector.

The conversion for unpacked fixed-point value f to floating point is done as follows: unpackUnormx4x16: f / 65535.0

The first component of the returned vector will be extracted from the least significant bits of the input; the last component will be extracted from the most significant bits.

See also
  GLM_GTC_packing
  float unpackUnorm1x16(uint16 p)
  vec2 unpackUnorm2x16(uint32 p)
  GLSL unpackUnorm2x16 man page
  GLSL 4.20.8 specification, section 8.4 Floating-Point Pack and Unpack Functions

## ◆ unpackUnorm4x4()

GLM_FUNC_DECL vec4 glm::unpackUnorm4x4 | ( | uint16 | p | ) |

Convert a packed integer to a normalized floating-point vector.

See also
  GLM_GTC_packing
  uint16 packUnorm4x4(vec4 const& v)