git.sur5r.net Git - cc65/blob - include/cc65.h

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                  cc65.h                                   */
   4 /*                                                                           */
   5 /*          Target independent but cc65 specific utility functions           */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 2009-2011, Ullrich von Bassewitz                                      */
  10 /*                Roemerstrasse 52                                           */
  11 /*                D-70794 Filderstadt                                        */
  12 /* EMail:         uz@cc65.org                                                */
  13 /*                                                                           */
  14 /*                                                                           */
  15 /* This software is provided 'as-is', without any expressed or implied       */
  16 /* warranty.  In no event will the authors be held liable for any damages    */
  17 /* arising from the use of this software.                                    */
  18 /*                                                                           */
  19 /* Permission is granted to anyone to use this software for any purpose,     */
  20 /* including commercial applications, and to alter it and redistribute it    */
  21 /* freely, subject to the following restrictions:                            */
  22 /*                                                                           */
  23 /* 1. The origin of this software must not be misrepresented; you must not   */
  24 /*    claim that you wrote the original software. If you use this software   */
  25 /*    in a product, an acknowledgment in the product documentation would be  */
  26 /*    appreciated but is not required.                                       */
  27 /* 2. Altered source versions must be plainly marked as such, and must not   */
  28 /*    be misrepresented as being the original software.                      */
  29 /* 3. This notice may not be removed or altered from any source              */
  30 /*    distribution.                                                          */
  31 /*                                                                           */
  32 /*****************************************************************************/
  33
  34
  35
  36 #ifndef _CC65_H
  37 #define _CC65_H
  38
  39
  40
  41 /*****************************************************************************/
  42 /*                                   Code                                    */
  43 /*****************************************************************************/
  44
  45
  46
  47 long __fastcall__ idiv32by16r16 (long rhs, int lhs);
  48 /* Divide a 32 bit signed value by a 16 bit signed value yielding a 16
  49 ** bit result and a 16 bit remainder. The former is returned in the lower 16
  50 ** bit of the result, the latter in the upper. If you don't need the
  51 ** remainder, just assign (or cast) to an int.
  52 */
  53
  54 unsigned long __fastcall__ udiv32by16r16 (unsigned long rhs, unsigned lhs);
  55 /* Divide a 32 bit unsigned value by a 16 bit unsigned value yielding a 16
  56 ** bit result and a 16 bit remainder. The former is returned in the lower 16
  57 ** bit of the result, the latter in the upper. If you don't need the
  58 ** remainder, just assign (or cast) to an unsigned.
  59 */
  60
  61 int __fastcall__ imul8x8r16 (signed char lhs, signed char rhs);
  62 /* Multiplicate two signed 8 bit to yield an signed 16 bit result */
  63
  64 long __fastcall__ imul16x16r32 (int lhs, int rhs);
  65 /* Multiplicate two signed 16 bit to yield a signed 32 bit result */
  66
  67 unsigned __fastcall__ umul8x8r16 (unsigned char lhs, unsigned char rhs);
  68 /* Multiplicate two unsigned 8 bit to yield an unsigned 16 bit result */
  69
  70 unsigned long __fastcall__ umul16x8r32 (unsigned lhs, unsigned char rhs);
  71 /* Multiplicate an unsigned 16 bit by an unsigned 8 bit number yielding a 24
  72 ** bit unsigned result that is extended to 32 bits for easier handling from C.
  73 */
  74
  75 unsigned long __fastcall__ umul16x16r32 (unsigned lhs, unsigned rhs);
  76 /* Multiplicate two unsigned 16 bit to yield an unsigned 32 bit result */
  77
  78 unsigned int __fastcall__ mul20 (unsigned char value);
  79 /* Multiply an 8 bit unsigned value by 20 and return the 16 bit unsigned
  80 ** result
  81 */
  82
  83 unsigned int __fastcall__ mul40 (unsigned char value);
  84 /* Multiply an 8 bit unsigned value by 40 and return the 16 bit unsigned
  85 ** result
  86 */
  87
  88 int __fastcall__ _sin (unsigned x);
  89 /* Return the sine of the argument, which must be in range 0..360. The result
  90 ** is in 8.8 fixed point format, which means that 1.0 = $100 and -1.0 = $FF00.
  91 */
  92
  93 int __fastcall__ _cos (unsigned x);
  94 /* Return the cosine of the argument, which must be in range 0..360. The result
  95 ** is in 8.8 fixed point format, which means that 1.0 = $100 and -1.0 = $FF00.
  96 */
  97
  98 unsigned char doesclrscrafterexit (void);
  99 /* Indicates whether the screen automatically be cleared after program
 100 ** termination.
 101 */
 102
 103
 104
 105 /* End of cc65.h */
 106 #endif
 107
 108
 109