Home | History | Annotate | Line # | Download | only in src 
      1 /*
      2  * Copyright 1997 through 2004 by Marc Aurele La France (TSI @ UQV), tsi (at) 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     do {                                                   \
     37         unsigned int _i, _j;                               \
     38         for (_i = 0;  _i < _microseconds;  _i++)           \
     39             for (_j = 0;  _j < __ONE_MICROSECOND__;  _j++) \
     40                 /* Nothing */;                             \
     41     } while (0)
     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 
     64 extern void ATIReduceRatio(int *, int *);
     65 extern int  ATIDivide(int, int, int, const int);
     66 
     67 #endif /* ___ATIUTIL_H___ */
     68