home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / program / pascal / pas_lina / linea.doc next >
Text File  |  1987-11-29  |  3KB  |  59 lines
  1. Ok, heres quick docs for LINEA 1.000 11/30/87.
  2.  
  3. First off, if you have questions, even better answers, suggestions etc
  4. leave me mail on Genie addressed do D.COOK or call my BBS at 206-672-0956.
  5.  
  6. Ok, well what I have done here is thrown some quick stuff together so we
  7. can access LINEA graphics from Personal Pascal II.  In this set of files
  8. you should find LINEA.S ( the assembly code to do the actual calls ), LINEA.O
  9. which you must link with your pascal file to use the routines and LINEATST.PAS
  10. which is a short test program.    Actually LINEATST.PAS was meant to be an include
  11. file but I added a couple of extra lines to get it run a quick test.  Just
  12. strip out the main routine and the program statement and include it with your
  13. stuff.
  14.  
  15. Now for the bad news.  Not all linea calls have been fully implemented.  Why,
  16. well partly because of poor docs for OSS and partly from other poor docs.  I
  17. am strictly a beginner at 68000 assembly so I kept the code to the minimum.
  18.  
  19. Basically, what I have done is set up personal pascal to access the all
  20. important PTSIN,PTSOUT,CONTRL etc. arrays.  You do this by not really creating
  21. the arrays, but instead using pointers.  Look at my init functions and you will
  22. get the picture.  CONTRL^[0] corresponds to C's Contrl[0] etc.
  23.  
  24. Also, you can access the LINEA variables in two ways.  You can use the address
  25. which is provided and poke the values in ( all the constants are there to help
  26. you ) or you can access the variables through an array.
  27.  
  28. If you choose this method the constants will have to be divided by two to
  29. correspond to the proper array element.  LINEA_VARS^[LA_X1/2] etc.
  30.  
  31. As far as testing goes, I have had little time to try out the routines but
  32. I know the basic init and putpixel works. ( the demo shows that! ).  The
  33. sprites are a bit iffy and I am not sure you can get all the use text_blt.
  34.  
  35. Sprites.  Well, I don't know much about sprites ( not having access with PP
  36. to the before! ) but the textbook examples should be easy to modify to get
  37. to run with this software.  There are two arrays which get passed, one that
  38. has the sprite info and a buffer for the screen stuff.    The difference you
  39. will find on the sprite array is that the first 2 elements must contain the
  40. X,Y positions and then the standerd info as described in the INTERNALS book
  41. or in Developers docs.
  42.  
  43. Again, I haven't tried those so I included the assembly so that you folks can
  44. help me debug this and hopefully upgrade it to a real graphics package.
  45.  
  46.  
  47. Oh yea, one more note of caution.  If you use arrays ( the easiest for contrl
  48. etc. ) you must turn range checking off.  We are breaking pascals rules and it
  49. doesn't like.
  50.  
  51. Wish you luck!
  52. Devin Cook
  53. D.COOK
  54.  
  55. Bauhaus BBS
  56. (206) 672-0956
  57.  
  58.  
  59.