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