pd.if.org Git - pdclib/blob - platform/example/Readme.txt

   1 $Id$
   2
   3 "Example" Platform Overlay
   4 ==========================
   5
   6 This is an example platform overlay, as described in the main Readme.txt of
   7 this archive. For ease of development, it applies (and tests) correctly on the
   8 machine of the author; no other guarantees can be given.
   9 It should give you a good idea of what is REQUIRED to make a copy of PDCLib
  10 work. There is a lot more you could do, and even some things you SHOULD do, in
  11 order to experience anything but abysmal performance:
  12
  13 - Read / write operations on binary streams, and even on text streams for
  14   machines that do not do any text conversion, can be made much more efficient
  15   by using some sort of page buffer instead of the linear buffer implemented
  16   here. It requires some special and platform-dependent manipulations, though,
  17   which is why it is not done by default.
  18
  19 - Anything relating to floating point logic is written in generic C. While
  20   this is (hopefully) highly portable and should get you started on your
  21   platform of choice, it is also highly inefficient and should be replaced by
  22   inline assembly. Just make sure that your assembly keeps all the promises
  23   the C library makes.
  24