
 MyCSeries
  a universal CSeries development library

  Version: 0.4.2
  Author:  Adam P.

  Revised: 2008.11.24 23:38 GMT

  Most Recent MacOS Build Date Date:  2008.07.22 06:37:41 GMT

 This package is for... pretty much anything that will work with it.


  MyCSeries is one of those libraries that can bridge the gap between platforms,
where the tools are in general and the results are to be reproducable... or for
the programmer that's just tired of writing the same old algorithms for each new
project that comes along.

  If you have a name conflict, please contact me via E-mail with a list of
alternative names, so the name conflict can be resolved by changing the
conflicting name for the next release.

  The font generation and rendering code is supplied for:
    (presumably) reproducable results on different platforms;
    when the platform's fonts are either not available or shouldn't be used;
      (debugging mode is a case where you might not want to use system fonts)


Compatibility Issues and Guidelines

* Revision Note *
   As of version 0.3, the _debugMsg macros pass their parameters differently.
   If you use them, you should recompile.

* * * * * * * * *

  Because this is not a complete version (far from v1.0), things may change
 - especially names - if you are using this.

  Currently, the includes only support compilers that are recognized by
"ConditionalMacros.h" -- a part of Apple's Universal Interfaces.

  Because the newer in-place macros, such as "isgn" and "ipin", use temporary
variables, they shouldn't be nested in each other (eg., "imin(isgn(x),y)").

  For graphics, PIXEL16 represents the full 16 bit (5:6:5) BGR/RGB format, and
not the three channel 15 bit format.  The 15 bit PIXEL15 is usually bounded by
16 bits, making it either {1:5:5:5} or {5:5:5:1}.

  The type `int' should be 32 bit, and enum's should be sized as an `int'.

  The platform "_cseries.h" and cs_ headers include "cseries.h" - not the other
way around!

  All used system includes should come before "cseries.h".

  CFM-68K, and the MC68000/MC68010 CPUs are not supported.

  MacCSeries.o generally supports only 32 bit data patch addressing (far-data)
under the MC68020 generation or later (when using certain library functions).
  MyCSeries is not compatible with System 6 and earlier versions of the Macintosh
operating system, as the libraries are not 24 bit compatible.

  There are identifiers that are not built as a part of MyCSeries, and must be
defined by the user's project or the platform headers/libraries that the project
uses.  This software development package contains a template for the routines
(however limited).  Here is a list of the required names:

      _out_of_memory         -- the only global variable that needs to be defined
                             --  for the alert_user "out of memory" error string
                             --  NOTE: this string overrides string #128 index 0
      stop_interface_fade    -- for full screen/surface fades (alert_user calls this)
      current_graphics_mode  -- counts as theme - doesn't need to be the screen depth
      initialize_debugger    -- for user debugger (not necessarily the system)
      debugger_log           -- for logging - not to be confused with stderr, 
                             --  stdout, etc.
      close_debugging_log    -- close the debugging log
      dprintf                -- debugger command (goes to either the log file or
                             --  system debugger)
      csprintf, psprintf     -- variations of the ANSI printf routines

  More compatibility problems are yet to be discovered...


Versions that aren't in BCD are not full release versions.


********** DISCLAIMER **********
*
* THIS SOFTWARE IS NOT COPYRIGHTED
*
*  I am in no way related or affiliated with any of the mentioned product
* names or companies that own those products.
*  I am not responsible for printing or clerical errors.
*
*  This source code is offered for use in the public domain.  You may use,
* modify or distribute it freely.
*
*  This code is distributed in the hope that it will be useful but WITHOUT
* ANY WARRANTY.  ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY DISCLAIMED.
*  This includes but is not limited to warranties of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE.
*

   All redistributed copies - regardless of modifications - cannot be
  honestly stated as the originating source (although, dishonesty is not
  illegal in the public domain... but it would be a-hole-ish).
 
********** ********** **********

Credits

 Apple, the Apple logo, and Macintosh are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.
 Macintosh PC Exchange, Power Macintosh, and QuickDraw are trademarks of Apple Computer, Inc.
 Helvetica and Times are registered trademarks of Linotype Company.

 All other product names are trademarks or registered trademarks of their respective holders.

 All rights are reserved.

Links

 To download Apple's Universal Interfaces go to:
   http://developer.apple.com/

 A recent version of MyCSeries may be available by going to:
   http://geocities.com/daedheadap9/games.html
 and searching for a link to the zip archive.
