Debug::DebugFloat Class Reference
#include <debugfloat.h>
Detailed Description
This class is supposed to make it easier, to restore the exact value of floating- point-based types, like vector, matrix44, float etc. for debugging. printf cuts values and rounds it. Also denormalized values might be printed as "0.0". Its particulary useful, if a certain set of input-parameters lets a function crash. Just call printHex for floating-point-based params so they are being printed to stdout with its exact bit-pattern. That dump can be passed to restoreHex and you can debug that function with that particular input-set.Printing a float4 to stdout works like this:
float4 v(1.0f, 2.0f, 3.0f, 4.0f); DebugFloat::printHex(v, "v");
The output in stdout is this:
v: 0x3F800000, 0x40000000, 0x40400000, 0x40800000
To restore the values, just pass the output to restoreHex
float4 v = DebugFloat::restoreHex(0x3F800000, 0x40000000, 0x40400000, 0x40800000);
Now v has the exact same value(bit pattern) as it had when being printed with printHex
There is also a normal "print" for each type. Quite useful is the quaternion-version, since it gives a more human-readable output than just the normal debugger.
(C) 2009 Radon Labs GmbH
Static Public Member Functions | |
| static void | printHex (float val, const char *msg=NULL) |
| print float's bit pattern as hex to stdout | |
| static void | printHex (const Math::float4 &v, const char *msg=NULL) |
| print float4's bit pattern as hex to stdout | |
| static void | printHex (const Math::matrix44 &m, const char *msg=NULL) |
| print matrix's bit pattern as hex to stdout | |
| static void | printHex (const Math::quaternion &q, const char *msg=NULL) |
| print quaternion's bit pattern as hex to stdout | |
| static void | printHex (const Math::plane &p, const char *msg=NULL) |
| print plane's bit pattern as hex to stdout | |
| static void | print (const float &v, const char *msg=NULL) |
| print float's values plain to stdout | |
| static void | print (const Math::float4 &v, const char *msg=NULL) |
| print float4's values plain to stdout | |
| static void | print (const Math::matrix44 &m, const char *msg=NULL) |
| print matrix's values plain to stdout | |
| static void | print (const Math::quaternion &q, const char *msg=NULL) |
| print quaternion's values plain to stdout | |
| static void | print (const Math::plane &p, const char *msg=NULL) |
| print plane's values plain to stdout | |