home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d542 / chemnimate.lha / ChemniMaTe / compiling.doc < prev    next >
Text File  |  1991-09-19  |  4KB  |  118 lines
  1.  
  2.  
  3. =============================================================================
  4.              CHEMNIMATE 0.8 alpha-release       COMPILING.DOC
  5. =============================================================================
  6.  
  7.    Klaas  van Gend                Raymond Knaapen
  8.    Hoekerstraat 9b                Veldstraat   26
  9.    5987 AN  EGCHEL                5988 AK  HELDEN
  10.    THE NETHERLANDS                THE NETHERLANDS
  11.  
  12.  
  13. REVISION HISTORY
  14. ----------------
  15. Ver 1. KvGend    27Jul91 wrote this document.
  16. Rev 1. RKnaapen    06Aug91 revision.    
  17. Rev 2. KvGend    28Aug91    corrected all 'åƳ' etc. Raymond brought in by editing
  18.             it in WordPerfect 5.1... 
  19.  
  20. ChemNiMate was written using the DICE 2.06.18R C compiler,
  21. written by Matt Dillon. Dice is a Public Domain/ShareWare
  22. compiler, I use the ShareWare( US$ 50) version of it. It is an
  23. almost 100% ANSI compiler, all missing stuff will be
  24. implemented soon.
  25. Dice HAS a make utility (dMake), but I don't understand the
  26. manual so I don't use it. Instead of that I use the front-end
  27. quite extensively:
  28.  
  29. To Compile it with DICE:
  30.  
  31. setenv DCCOPTS "-r -v -1.3 -f -new"
  32. dcc tokenlist3.c ch14.c 2nd7.c parser11.c SrcBm4.o
  33.  
  34. the switches do the following:
  35. -r   the compiler will generate a pure programme
  36.      (residentable).
  37. -v   verbose
  38. -1.3 use the 1.3 includes & Amiga.lib 
  39. -f   allow a Ctrl-C break when using the AmigaShell
  40. -new only compile a file when the date/time of the "#?.c" is
  41.      newer than the date/time of the "#?.o"
  42.      Also DCC automatically specifies two switches itself: 
  43. -mc  Small Code memory model
  44. -md  Small Data memory model
  45.  
  46. The code is written in such a way that any normal C compiler
  47. should be able to compile it without much real problems.
  48. I don't know enough of either SAS/Lattice nor Manx to tell you
  49. how to compile it using them.
  50.  
  51. If the executable generated by your compiler is shorter than
  52. mine, please let me know, as Dice normally generates shorter
  53. code than either Manx or Lattice.
  54.  
  55. For the public Domain version of Dice, please refer to FISH #466.
  56.  
  57.  
  58. PORTABILITY OF CHEMNIMATE.
  59. Almost the whole source is written in plain ANSI-C. I'll
  60. comment the various files:
  61.  
  62. tokenlist3.c   no problem.
  63. parser11.c     should be no problem.
  64.  
  65. For the following files, you'll need some adaptations.
  66. 2nd7.c         Is purely Amiga-specific code. Might be hard to convert.
  67.                It contains of 3 functions:
  68.     SetUp()        Initialise the screens etcetera. 
  69.     Quit()         Do the reverse.
  70.     SwapShow()     Change the front & backpage of the double
  71.                    buffering system. 
  72. SrcBm4.c       Contains only one function: 
  73.     LoadPic()  which loads the picture of all balls in the third
  74.                bitmap.
  75.                This function is only called once: in SetUp().
  76. ch14.c         Contains the main() and some other functions.
  77.                In PutBalls() is one Amiga function used
  78.                (BltBitMap).
  79.                All other functions are done using macros, i.e.
  80.                LINETO(x,y); is by the preprocessor converted
  81.                to Draw (rastport,x,y); .
  82.  
  83. Generally, somebody who knows his sytem, should be able to
  84. port chemnimate. Only, it isn't really necessary. Almost no
  85. other computer is able to handle   graphics fast enough,
  86. without having to program all stuff in Assembler. Besides,
  87. these computers aren't able to create a normal TV signal, thus
  88. they require either a camcorder (BOO!) or some very expensive
  89. hardware.
  90. Thanks to Amiga.
  91.  
  92. Besides, a friend of mine (Raymond) is at the moment writing
  93. his interpretation of this programme, in TurboPascal. He
  94. wanted to write it from scratch, but he chose some other
  95. techniques to develop. The result are two completely dif-
  96. ferent programmes. To be honest: Mine is faster and better.
  97. (Sorry Raymond).
  98.  
  99. ### Here is Raymond writing:
  100. # To be honest: Klaas' program is finished and mine isn't.
  101. # E.g. He can program his animations, I still can't.
  102. # As Klaas said before he has an Amiga. I have an AT with a
  103. # multi-leg-beetle (also called 80286) which has to do
  104. # everything, including grahics, so my program ain't fast (well,
  105. # maybe it is when compared to a ZX81).
  106. #
  107. # Besides, our programmes don't differ as much as Klaas said.
  108. # His program is faster and better? Well, mine looks better!!
  109. #
  110. # When finished, my program will have the same options as
  111. # Klaas' program. Only it won't be as fast as his.
  112. #
  113. # By the way, I like some postcards, too.
  114. ###
  115.  
  116. So, that was Raymond. Hey, Rayder, thanks for spoiling the bytes!
  117. That was it. 
  118.