home *** CD-ROM | disk | FTP | other *** search
/ gondwana.ecr.mu.oz.au/pub/ / Graphics.tar / Graphics / VOGLE.ZIP / VOGLE / SRC / SUNPAS / README < prev    next >
Encoding:
Text File  |  1994-04-27  |  1.8 KB  |  47 lines
  1.  
  2.     Using the SUN Pascal interface to vogle.
  3.     ----------------------------------------
  4.  
  5.     a)    You must run the SUN Pascal compiler 'pc'.
  6.  
  7.     b)    All Pascal programs using vogle routines must include the
  8.         file "Vogle.h" after the program statement.
  9.         This file contains the declarations for all the vogle
  10.         functions and procedures as well as several useful types.
  11.  
  12.     c)    A typical compile and link sequence might be:
  13.  
  14.         pc -o myprog myprog.p -lvogle -lsuntool -lsunwindow 
  15.             -lpixrect -lm
  16.  
  17.     NOTE:- If you are using the 'sun' device then you should be running
  18.     sunview (suntools).
  19.  
  20.     OTHER NOTES:- All string data that is to be used in vogle routines
  21.     must be of type 'string_t' (defined in Vogle.h)
  22.  
  23.  
  24.     The philosophy behind this Pascal interface is that we didn't
  25.     want to change the 'notional' names of any of the routines. But
  26.     we had to have different names for some routines to satisfy the
  27.     C/Pascal calling conventions. We simply made the names by
  28.     capitalising the first letter of each word in the name - eg move
  29.     ==> Move and viewport ==> ViewPort. We didn't feel this was a
  30.     problem because it is the style of procedure naming that makes X
  31.     and Pascal programmers feel all warm and gooey inside :-). All
  32.     these names are in the header file Vogle.h
  33.     
  34.     In case any of you are wondering why some of the interfaces to
  35.     string routines only seem to be passing a single integer, here's
  36.     the reason why: We use the SUN pascal type varying [1..255] of char.
  37.     This type is allocated as a 4 byte integer followed by an array
  38.     of characters. Hence we get passed a 4 byte integer and the actual
  39.     string data is just after that.
  40.  
  41.     Finally, a special thanks to Peter Horan (peter@cm.deakin.OZ.AU)
  42.     for all his work on the interface.
  43.  
  44.  
  45.     PS. There seems to be a difference between SUN Pascal 1.1 and 2.0
  46.     We only have 2.0 - if you have problems with 1.1 let us know.
  47.