Max 5 API Reference

ext_common.h

/* common.h -- those things we define often */
#ifndef _EXT_COMMON_H_
#define _EXT_COMMON_H_


/**
    If a value is within the specified range, then return true.  Otherwise return false.

    @ingroup    misc
    @param  v   The value to test.
    @param  lo  The low bound for the range.
    @param  hi  The high bound for the range.
    @return     Returns true if within range, otherwise false.
*/
#define InRange(v,lo,hi) ((v)<=(hi)&&(v)>=(lo))


/**
    Return the higher of two values.

    @ingroup    misc
    @param  a   The first value to compare.
    @param  b   The second value to compare.
    @return     Returns the higher of a or b.
*/
#ifndef MAX
#define MAX(a,b) ((a)>(b)?(a):(b))
#endif


/**
    Return the lower of two values.

    @ingroup    misc
    @param  a   The first value to compare.
    @param  b   The second value to compare.
    @return     Returns the lower of a or b.
*/
#ifndef MIN
#define MIN(a,b) ((a)<(b)?(a):(b))
#endif


/**
    Limit values to within a specified range.

    @ingroup    misc
    @param  a   The value to constrain.
    @param  lo  The low bound for the range.
    @param  hi  The high bound for the range.
    @return     Returns the value a constrained to the range specified by lo and hi.
*/
#define CLIP(a, lo, hi) ( (a)>(lo)?( (a)<(hi)?(a):(hi) ):(lo) )


#define OSTAsChars(x) (int)((x)>>24)&0xFF,(int)((x)>>16)&0xFF,(int)((x)>>8)&0xFF,(int)((x)&0xFF)


#endif /* _EXT_COMMON_H_ */

Copyright © 2008, Cycling '74