home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 11 / 11.iso / m / m111 / 1.img / GRPCT1.EXE / READ1ST.ME < prev    next >
Encoding:
Text File  |  1991-02-15  |  12.0 KB  |  297 lines
  1.                 GRASP 4.0 Readme File - February 1, 1991
  2.  
  3. This file contains three sections:
  4.  
  5.     New features in GRASP 4.0
  6.     Updating applications from GRASP 3.5 and previous versions
  7.     Additions to the manual
  8.  
  9. There are two additional Readme files, for TGL + and for the High-Level
  10. Language examples.  TGL's Readme is in the TGL directory.  The HLL 
  11. Readme is in the HLL directory.
  12. You should replace your old manual with the new one provided with the soft-
  13. ware.  There are major differences and additions to consider.
  14. -----------------------------------------------------------------------------
  15. Changes to the manual:
  16.         
  17.         SOUND: The PC Speaker is no longer an option.  Command has changed.
  18.         -----
  19.  
  20. Enhancements to the manual:
  21.  
  22.         Clearscr, Data, Glib, Setupscr, Cap, Debug switch for Grasp, Graspc 
  23.         and Grasprt, Editor keys for search/replace
  24.  
  25. New features not in the manual:
  26.         
  27.         Additional Functions (widths(), delete(), movemem), Additional 
  28.         Variables (read-only: @memfree, @memused, @txtbuf, @txtlen)
  29. -----------------------------------------------------------------------------
  30. New features in GRASP 4.0:
  31.  
  32. GRASP now sports more than 100 commands, greatly improved performance, 
  33. and many new features which give GRASP all the capabilities of other
  34. third-generation languages like C and Pascal.  Here are some of 
  35. the highlights:
  36.  
  37. GRASP
  38.  
  39.     Video modes:
  40.  
  41.     GRASP supports the SVGA modes up to and including 1280 x 1024 x 256. 
  42.     Page 6-4 in the GRASP manual lists all of the modes.  However, modes
  43.     R through W are only supported within GRASP. They now work with most 
  44.     video systems that were available as of this date.  All commands are 
  45.     fully functional in these video modes.  Pictor does not support any 
  46.     hi-resolution 256 color modes such as 640X480X256 or 360X480x256 at this
  47.     time.  As new video boards are made available, the support for the SVGA 
  48.     modes for these boards will be available in future releases of GRASP.
  49.     Pictor support of the SVGA modes is planned for a future release.
  50.  
  51.     Differential animation:
  52.  
  53.     The utility GDFF creates differential animation files which GRASP can
  54.     play back.  This technique saves the changes from one frame to another
  55.     in a sequence of images, resulting in much smaller and faster animations.  
  56.     See page 2-13 for an introduction to the concept.  Additionally, you can 
  57.     now play AutoDesk Animator FLI files in the same manner as the 
  58.     DFF files.  Remember, FLI files are in video mode L only.
  59. =============================================================================
  60. Page 1
  61.  
  62.  
  63. =============================================================================
  64.  
  65.     DOS commands, CDs, and other devices:
  66.  
  67.     GRASP now has full multimedia capability.  The INT command calls
  68.     interrupts, which allows GRASP programs to control CD players and
  69.     other devices and to issue DOS commands such as Make Directory.  See
  70.     the file CDCMD.TXT for examples.  In addition you may load an ASCII file 
  71.     into memory, read, write, create and display that file or use the file 
  72.     in a data statement simply by using the Load command. 
  73.  
  74.     Digitized Sound support:
  75.  
  76.     GRASP now supports the use of digitized sound through the Sound Blaster 
  77.     board, with support for Sound Blaster sound through other compatible 
  78.     boards.  Support for other sound boards will be available at a later date.
  79.  
  80.  
  81.     Conditional execution:
  82.  
  83.     GRASP features conditional execution in If-Else-Endif constructs,
  84.     which can be built around value comparisons, user keystrokes, mouse
  85.     clicks, and other testable conditions.  See pages 3-34 through 3-37.
  86.  
  87.     Variables, operators, and functions:
  88.  
  89.     GRASP now allows variables and can perform string and math operations.
  90.     See pages 3-28 and 3-29 for an introduction to variables, and pages
  91.     6-18 through 6-20 for lists of operators and functions.  See also, the
  92.     section of Variables and Functions in this Readme.
  93.  
  94.     Subroutines:
  95.  
  96.     You can now pass parameters (including expressions and variables) to
  97.     subroutines.  See pages 3-37 through 3-41 for details.
  98.  
  99.     Typographic controls:
  100.  
  101.     The Text command now wraps text within windows automatically, and you
  102.     can choose left, center, or right alignment of text.  Letter and word
  103.     spacing can also be controlled.  See page 4-106.
  104.  
  105.     Picture/clipping command use:
  106.  
  107.     All GRASP commands can now work with clippings or pictures.  To use a
  108.     clipping with a command designed for pictures such as Pfade, preface
  109.     the buffer number with a C.  To use a picture with a clipping command
  110.     such as Putup, preface the buffer number with a P.
  111.  
  112.     Editor commands:
  113.  
  114.     The GRASP editor now has search and replace functions as well as 
  115.     additional user definable help screens.  A new tutorial is included as
  116.     well.
  117. =============================================================================
  118. Page 2
  119.  
  120. =============================================================================
  121.  
  122. PICTOR
  123.  
  124.     Quick keys:
  125.  
  126.     The quick-key feature has been expanded to include more menu options
  127.     and to allow you to select all of the drawing tools.  See section six
  128.     of the Pictor manual for a complete list.  Also note that it's no
  129.     longer necessary to use the Alt key with a letter key to select menu
  130.     options or tools, unless you're using the Text tool.
  131.  
  132.     VGA color cycling:
  133.  
  134.     In VGA modes you can cycle a range of colors on screen by pressing
  135.     Tab.  All colors from the left to the right mouse button color will
  136.     begin shifting positions as they do in GRASP with the Cycle command.
  137.     Tab again to speed up shifting; use Shift-Tab to slow it down and stop
  138.     it.  Press the Backspace key to reverse cycling direction.
  139.  
  140.     VGA color range adjustment:
  141.  
  142.     The range of colors from the left to the right mouse button color can
  143.     be adjusted in hue, brightness, and contrast, using the Ctrl key with
  144.     the function keys.  These are listed in section six of the Pictor
  145.     manual.  Press the Asterisk key to restore the original palette, or
  146.     save the image to make the adjustments permanent.  Note that until you
  147.     save the image and reload it, any adjustments you make with this
  148.     feature affect the underlying palette.
  149.  
  150.     Edit menu and Change Colors dialog box:
  151.  
  152.     When the Change Colors dialog box is displayed, you can use the Edit
  153.     menu functions Cut, Copy, Paste, and Invert Colors.  They will operate
  154.     on the selected range of colors (from left to right button color). 
  155.     Copy and Paste make it easy to move ranges of colors in 256-color
  156.     mode.  To use this feature, just click on Edit on the menu bar or
  157.     press the quick key for the function you want (C for Copy, for example).
  158.  
  159. Artools
  160.  
  161.     Artools is now bundled with GRASP.  If you're familiar with the 
  162.     previous version of Artools, you'll notice two program changes:
  163.  
  164.     TXTCLP (for converting text-mode images to graphics modes) has been
  165.     added, and TGAPIC/PICTGA are no longer included.  The Artools program
  166.     has also been eliminated:  each of the programs now has its own 
  167.     interactive screen.
  168.  
  169. TGL +
  170.  
  171.     TGL + is now provided with the GRASP program as an aid to capturing 
  172.     and printing images.  It also contains other features and is the complete
  173.     program, not just a demo version.
  174.  
  175. =============================================================================
  176. Page 3
  177.  
  178. =============================================================================
  179.  
  180.  
  181. Updating existing applications
  182.  
  183. Applications written in GRASP 3.1 and 3.5 will run under version 4.0 with 
  184. four exceptions for those upgrading from 3.1.  We're confident that GRASP's 
  185. enhanced capabilities and performance will make converting your applications 
  186. worthwhile.
  187.  
  188. 1)   The TOUCH command has been eliminated.  Touchscreen users should rely
  189.     on the software provided with their screens, which can be used to
  190.     simulate keystrokes or mouse clicks in response to touches.  GRASP 
  191.     programs can then test for keystrokes or mouse clicks instead.
  192.     
  193. 2)   The FLOAT command has been enhanced with ENDFLOAT.  Float leaves the
  194.     last clipping displayed in two-page mode, and saves the background
  195.     under that clipping in a buffer.  The next Float command restores
  196.     the background from that buffer before starting its Float.  This new 
  197.     feature allows you to put together a sequence of Floats to create 
  198.     complex movement.  However, the Endfloat command must now be
  199.     issued after the last Float in a series.  Existing applications that
  200.     use Float in two-page animation may need Endfloats to work correctly.
  201.  
  202. 3)   The new math operators include the dash (subtraction and negation).
  203.     Unfortunately, this means that filenames in GRASP programs cannot use
  204.     dashes unless they're enclosed in quotes.  For example, PLOAD T-12,1
  205.     will cause an error, but PLOAD "T-12",1 will work.  If you've used
  206.     dashes in filenames, add quotes or rename the files.
  207.  
  208. 4)   Since text can now span multiple lines, it's imperative that all
  209.     quotes be balanced.  This was not true in version 3.1, you could leave
  210.     off the closing quote from a Text command without causing an error.
  211.     In version 4.0 the interpreter will scan lines, treating them as text,
  212.     until it finds the next quote.
  213.  
  214. Additional Information and Examples (that may not be in the manual).
  215. --------------------------------------------------------------------
  216.  
  217.                 Section 1: Command Information and Examples
  218.                 -------------------------------------------                
  219.  
  220. CALL now supports params so you can call a subroutine with params
  221. like this:
  222.  
  223.      call subfile display "Hello There" 27 30
  224.  
  225. ---------
  226. CGETBUF has been revised, there is a new SET option CGETSHIFT. CGETSHIFT
  227. defaults to ON, which means that if you do a CGETBUF without shifted
  228. copies, CGETBUF will round the coordinates to byte boundries and put in
  229. correct offsets so that the image can be displayed at the same location from
  230. which it came.  If you get an image with shifted copies, this option has no 
  231. effect. If you get an image without shifted copies and this option is OFF, 
  232. and the image is NOT at a byte boundry, the coordinates will not be rounded 
  233. to byte boundries, and the offsets will be correct for saving the image to
  234. disk.  CGETBUF now includes an offset as part of the image rather than an 
  235. offset of 0,0.  To set the offset of an image to 0,0 do a POSITION C? 0 0.
  236.  
  237. =============================================================================
  238. Page 4
  239.  
  240. =============================================================================
  241.  
  242.  
  243. ---------
  244. The CLEARSCR command now supports an optional color, so you can CLEARSCR 0, 
  245. rather than having to set a drawing color (the new optional parameter has
  246. no effect on the current drawing color).
  247.  
  248. ---------
  249. The new command CURSOR, is mainly for accessing the hardware cursor in text 
  250. modes.
  251.  
  252. CURSOR              ;put up/remove cursor at current location
  253. CURSOR X,Y          ;put up/remove cursor at X,Y
  254. CURSOR OFF          ;remove cursor from screen
  255.  
  256. example:
  257.      video 1
  258.      getstr 40
  259.      clearscr
  260.      text @0
  261.      waitkey
  262.      exit
  263.  
  264. getstr:
  265.      set space off
  266.      local savx @textx
  267.      local str ""
  268.      local a ""
  269.      text string(@1," ")
  270.      text @savx,@texty,""
  271. lp:  cursor
  272.      waitkey
  273.      cursor
  274.      getkey a
  275.      if asc(@a)>=32&&len(@str)<@1
  276.           set str @str$@a
  277.           text @a
  278.           goto lp
  279.      else
  280.           if @a==chr(8)&&len(@str)
  281.                set a @textx-width(right(@str,1))
  282.                set str left(@str,len(@str)-1)
  283.                text @a,@texty,"  "
  284.                text @a,@texty,""
  285.                goto lp
  286.           endif
  287.           if @a!=chr(13)
  288.                goto lp
  289.           endif
  290.      endif
  291.      text @savx,@texty,""
  292.      return @str
  293.  
  294. =============================================================================
  295. Page 5
  296.  
  297.