| Some important MACROs and type definitions. See a_predef.h for other useful constants and defines. | |
|---|---|
| MACRO | Description |
| NULL_STRING | Useful for representing a NULL pointer to an iostream member. Defined as "(null)". |
| SAFESTRING(pcc) | If {pcc} is NULL, then NULL_STRING is returned, otherwise {pcc} is returned. |
| __min(A,B) | The lesser of the two is returned. |
| __max(A,B) | The greater of the two is returned. |
| BYTE | An 8-bit typedef - unsigned char |
| WORD | A 16-bit typedef - unsigned short |
| BYTE | A 32-bit typedef - unsigned long |
| UINT | Machine specific size - unsigned int |
| MAKEWORD(hi, lo) | 2 BYTEs {hi} and {lo} are used to create a WORD {hi lo} |
| MAKEDWORD(hi, lo) | 2 WORDs {hi} and {lo} are used to create a DWORD {hi lo} |
| LOWORD(dw) | Extracts the lower order 16 bits from a DWORD |
| HIWORD(dw) | Extracts the higher order 16 bits from a DWORD |
| BYTEx(dw) |
{x}={0,1,2,3} Extracts the BYTE from a DWORD {b3 b2 b1 b0} |
| BITMASK(n) | Returns a DWORD with the nth bit set |
| WIDTHMASK(n) | Sets the lower n bits on |
| CEILN(num, N) |
Ceiling function in N. Given {num} it will find the next multiple of {N} (eg. CEIL(25, 8) = 32, 25 is closest to the next multiple of 8, which is 32) |
| FLOORN(num, N) |
Floor function in N. Given {num} it will find the previous multiple of {N} (eg. FLOORN(25, 8) = 24, 25 is closest to the previous multiple of 8, which is 24) |
| COLORREF | A typedef which is really a DWORD, 0x00bbggrr, representing true-color. |
| RGB(r,g,b) | Given {r}ed, {g}reen and {b}lue, it creates a COLORREF. |
|
GetXValue(rgb) |
Where {X}={R,G,B,V,L}. {R}ed, {G}reen, {B}lue, {V}alue (brightness), AntiVa{L}ue (dullness) Retrieve BYTE color component from COLORREF. |