OGRE: Ogre::Bitwise Class Reference - OGRE Documentation

# Ogre::Bitwise Class Reference

Class for manipulating bit patterns. More...

`#include <OgreBitwise.h>`

List of all members.

## Static Public Member Functions
static FORCEINLINE unsigned int | mostSignificantBitSet (unsigned int value)
| Returns the most significant bit set in a value.
static FORCEINLINE uint32 | firstPO2From (uint32 n)
| Returns the closest power-of-two number greater or equal to value.
template<typename T>
static FORCEINLINE bool | isPO2 (T n)
| Determines whether the number is power-of-two or not.
template<typename T>
static FORCEINLINE unsigned int | getBitShift (T mask)
| Returns the number of bits a pattern must be shifted right by to remove right-hand zeros.
template<typename SrcT, typename DestT>
static DestT | convertBitPattern (SrcT srcValue, SrcT srcBitMask, DestT destBitMask)
| Takes a value with a given src bit mask, and produces another value with a desired bit mask.
static unsigned int | fixedToFixed (uint32 value, unsigned int n, unsigned int p)
| Convert N bit colour channel value to P bits.
static unsigned int | floatToFixed (const float value, const unsigned int bits)
| Convert floating point colour channel value between 0.0 and 1.0 (otherwise clamped) to integer of a certain number of bits.
static float | fixedToFloat (unsigned value, unsigned int bits)
| Fixed point to float.
static void | intWrite (void *dest, const int n, const unsigned int value)
| Write a n*8 bits integer value to memory in native endian.
static unsigned int | intRead (const void *src, int n)
| Read a n*8 bits integer value to memory in native endian.
static uint16 | floatToHalf (float i)
| Convert a float32 to a float16 (NV_half_float) Courtesy of OpenEXR.
static uint16 | floatToHalfI (uint32 i)
| Converts float in uint32 format to a a half in uint16 format.
static float | halfToFloat (uint16 y)
| Convert a float16 (NV_half_float) to a float32 Courtesy of OpenEXR.
static uint32 | halfToFloatI (uint16 y)
| Converts a half in uint16 format to a float in uint32 format.

## Detailed Description

Class for manipulating bit patterns.

Definition at line 38 of file OgreBitwise.h.

## Member Function Documentation

static FORCEINLINE unsigned int Ogre::Bitwise::mostSignificantBitSet | ( | unsigned int | value | ) | `[static]`

Returns the most significant bit set in a value.

Definition at line 42 of file OgreBitwise.h.

static FORCEINLINE uint32 Ogre::Bitwise::firstPO2From | ( | uint32 | n | ) | `[static]`

Returns the closest power-of-two number greater or equal to value.

Note:
  0 and 1 are powers of two, so firstPO2From(0)==0 and firstPO2From(1)==1.

Definition at line 55 of file OgreBitwise.h.

template<typename T>

static FORCEINLINE bool Ogre::Bitwise::isPO2 | ( | T | n | ) | `[static]`

Determines whether the number is power-of-two or not.

Note:
  0 and 1 are tread as power of two.

Definition at line 70 of file OgreBitwise.h.

template<typename T>

static FORCEINLINE unsigned int Ogre::Bitwise::getBitShift | ( | T | mask | ) | `[static]`

Returns the number of bits a pattern must be shifted right by to remove right-hand zeros.

Definition at line 78 of file OgreBitwise.h.

Referenced by convertBitPattern().

template<typename SrcT, typename DestT>

static DestT Ogre::Bitwise::convertBitPattern | ( | SrcT | srcValue,
|  | SrcT | srcBitMask,
|  | DestT | destBitMask |
| ) |  |  | `[static]`

Takes a value with a given src bit mask, and produces another value with a desired bit mask.

Remarks:
  This routine is useful for colour conversion.

Definition at line 97 of file OgreBitwise.h.

References getBitShift().

static unsigned int Ogre::Bitwise::fixedToFixed | ( | uint32 | value,
|  | unsigned int | n,
|  | unsigned int | p |
| ) |  |  | `[static]`

Convert N bit colour channel value to P bits.

It fills P bits with the bit pattern repeated. (this is /((1<<n)-1) in fixed point)

Definition at line 122 of file OgreBitwise.h.

static unsigned int Ogre::Bitwise::floatToFixed | ( | const float | value,
|  | const unsigned int | bits |
| ) |  |  | `[static]`

Convert floating point colour channel value between 0.0 and 1.0 (otherwise clamped) to integer of a certain number of bits.

Works for any value of bits between 0 and 31.

Definition at line 146 of file OgreBitwise.h.

static float Ogre::Bitwise::fixedToFloat | ( | unsigned | value,
|  | unsigned int | bits |
| ) |  |  | `[static]`

Fixed point to float.

Definition at line 156 of file OgreBitwise.h.

static void Ogre::Bitwise::intWrite | ( | void * | dest,
|  | const int | n,
|  | const unsigned int | value |
| ) |  |  | `[static]`

Write a n*8 bits integer value to memory in native endian.

Definition at line 164 of file OgreBitwise.h.

static unsigned int Ogre::Bitwise::intRead | ( | const void * | src,
|  | int | n |
| ) |  |  | `[static]`

Read a n*8 bits integer value to memory in native endian.

Definition at line 192 of file OgreBitwise.h.

static uint16 Ogre::Bitwise::floatToHalf | ( | float | i | ) | `[static]`

Convert a float32 to a float16 (NV_half_float) Courtesy of OpenEXR.

Definition at line 217 of file OgreBitwise.h.

References floatToHalfI().

static uint16 Ogre::Bitwise::floatToHalfI | ( | uint32 | i | ) | `[static]`

Converts float in uint32 format to a a half in uint16 format.

Definition at line 225 of file OgreBitwise.h.

Referenced by floatToHalf().

static float Ogre::Bitwise::halfToFloat | ( | uint16 | y | ) | `[static]`

Convert a float16 (NV_half_float) to a float32 Courtesy of OpenEXR.

Definition at line 268 of file OgreBitwise.h.

References halfToFloatI().

static uint32 Ogre::Bitwise::halfToFloatI | ( | uint16 | y | ) | `[static]`

Converts a half in uint16 format to a float in uint32 format.

Definition at line 277 of file OgreBitwise.h.

Referenced by halfToFloat().

The documentation for this class was generated from the following file:

- OgreBitwise.h

Copyright © 2008 Torus Knot Software Ltd
This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Jul 26 11:32:50 2009