atiutil.h revision 32b578d3 
1/*
2 * Copyright 1997 through 2004 by Marc Aurele La France (TSI @ UQV), tsi@xfree86.org
3 *
4 * Permission to use, copy, modify, distribute, and sell this software and its
5 * documentation for any purpose is hereby granted without fee, provided that
6 * the above copyright notice appear in all copies and that both that copyright
7 * notice and this permission notice appear in supporting documentation, and
8 * that the name of Marc Aurele La France not be used in advertising or
9 * publicity pertaining to distribution of the software without specific,
10 * written prior permission.  Marc Aurele La France makes no representations
11 * about the suitability of this software for any purpose.  It is provided
12 * "as-is" without express or implied warranty.
13 *
14 * MARC AURELE LA FRANCE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
15 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO
16 * EVENT SHALL MARC AURELE LA FRANCE BE LIABLE FOR ANY SPECIAL, INDIRECT OR
17 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
18 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
19 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
20 * PERFORMANCE OF THIS SOFTWARE.
21 */
22
23#ifndef ___ATIUTIL_H___
24#define ___ATIUTIL_H___ 1
25
26/*
27 * Prevent the C standard's insistence on unsigned long sizeof's from causing
28 * counter-intuitive results.
29 */
30#define SizeOf(_object) ((int)sizeof(_object))
31#define NumberOf(_what) (SizeOf(_what) / SizeOf(_what[0]))
32
33#define __ONE_MICROSECOND__ 100         /* This'll need calibration */
34
35#define ATIDelay(_microseconds)                            \
36    {                                                      \
37        unsigned int _i, _j;                               \
38        for (_i = 0;  _i < _microseconds;  _i++)           \
39            for (_j = 0;  _j < __ONE_MICROSECOND__;  _j++) \
40                /* Nothing */;                             \
41    }
42
43/*
44 * Macros to get/set a contiguous bit field.  Arguments should not be
45 * self-modifying.
46 */
47#define UnitOf(___Value)                                \
48        (((((___Value) ^ ((___Value) - 1)) + 1) >> 1) | \
49         ((((___Value) ^ ((___Value) - 1)) >> 1) + 1))
50
51#define GetBits(__Value, _Mask) (((__Value) & (_Mask)) / UnitOf(_Mask))
52#define SetBits(__Value, _Mask) (((__Value) * UnitOf(_Mask)) & (_Mask))
53
54#define MaxBits(__Mask)         GetBits(__Mask, __Mask)
55
56#define _ByteMask(__Byte)       ((CARD8)(-1) << (8 * (__Byte)))
57#define GetByte(_Value, _Byte)  GetBits(_Value, _ByteMask(_Byte))
58#define SetByte(_Value, _Byte)  SetBits(_Value, _ByteMask(_Byte))
59
60#define _WordMask(__Word)       ((CARD16)(-1) << (16 * (__Word)))
61#define GetWord(_Value, _Word)  GetBits(_Value, _WordMask(_Word))
62#define SetWord(_Value, _Word)  SetBits(_Value, _WordMask(_Word))
63
64extern void ATIReduceRatio(int *, int *);
65extern int  ATIDivide(int, int, int, const int);
66
67#endif /* ___ATIUTIL_H___ */
68