home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / programming / intuitioned / ie_help < prev    next >
Text File  |  1990-10-10  |  8KB  |  228 lines
  1.  
  2.                           I N S T R U C T I O N S
  3.                      ---------------------------------
  4.  
  5.                      Intuition Ed         Version 1.00
  6.  
  7.  
  8.  
  9.    Contents :
  10.  
  11.    1  -  What's Intuition Ed ?
  12.    2  -  Description of Intuition Ed
  13.    3  -  Edit :
  14.           Screens
  15.           Windows
  16.           Gadgets
  17.           Text
  18.           Borders
  19.    4  -  Quit Intuition Ed
  20.    5  -  Distribution
  21.  
  22. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  23.  
  24.    1  -                  What's Intuition Ed ?
  25.                       ---------------------------
  26.  Intuition Ed is a source-code utility that transfers user inputs to source
  27.  code in C.  The main job of the program is to check, to arrange, to write
  28.  and to link created structures.
  29.  It can also write the required functions to open and close them.
  30.  To check your edited structures, Intuition Ed can write a main program
  31.  that opens all elements and closes them after 20 seconds.
  32.  The resulting C program can be compiled with Manx and Lattice compilers.
  33.  
  34.  Another feature is the possibility to open the same structure twice
  35.  by simply giving two structures the same name when you edit them.
  36.  (For example you can use the same borders for different gadgets.) 
  37.  
  38. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  39.  
  40.    2  -                  Program description
  41.                       ---------------------------
  42.  
  43.  At first the program looks at your screen size. If it's 200 or 400
  44.  pixels high it opens an interlace screen.
  45.  In the first program window of Intuition Ed you just have to enter the 
  46.  file name of your C program and choose include files that will appear in
  47.  the source code. In the two spare gadgets you can add your own include files.
  48.  
  49.  You can enter comments, defines and macros in the gadgets on the right
  50.  side. There is room for 25 lines which will appear unchanged in the
  51.  source code. They can be scrolled with the arrow gadgets.
  52.  
  53.  You can also leave the program immediately by pressing the 'Exit' gadget,
  54.  or you can save the inputs with the 'End' gadget.
  55.  
  56.  By pressing the 'Screen' or 'Window' gadget you can edit structures.
  57.  Their order is important : 
  58.  
  59.  Structures containing others must be edited first. 
  60.  
  61.  
  62.              TEXT / BORDER        TEXT / BORDER
  63.                   ^                    ^
  64.  SCREEN   -»    WINDOW      -»       GADGET
  65.  
  66.  
  67.  If you edit a window before you do the screen, the C program opens the
  68.  window on the Workbench and afterwards opens the screen.
  69.  
  70.  A structure is saved after you pressed the 'OK' gadget. It then can
  71.  only be changed in the source code later.
  72.  So its useful to know what you want to create and to have it on 
  73.  a piece of paper.
  74.  
  75.  Before the structure is saved, it's checked. If it's senseless, a requester
  76.  appears and you can change it (Stop) or you can save it nevertheless
  77.  (continue).
  78.  
  79.  To avoid errors the structures should not have the same name as functions
  80.  and shouldn't begin with a number.
  81.  
  82.  To write identical structures only once in the source code you 
  83.  merely give them the same name. 
  84.  That doesn't work with gadgets.
  85.  
  86.  It's important to know that only the last structure with the same name
  87.  is saved ( independent of the others ).
  88.  
  89.  EXAMPLE:
  90.  
  91.  You can edit two identical windows containing different gadgets.
  92.  In the first window menue you enter the name of both structures
  93.  in 'Window Name' and press 'OK'. Then you can create the gadgets 
  94.  for this window. You return to the window menue and enter the
  95.  same window name again. Then you edit the windows, press
  96.  'OK' again and edit it's gadgets.
  97.  
  98.  
  99.  Two journal-files, which simulate user inputs show an example
  100.  of how to use Intuition Ed.
  101.  They ONLY work on the non-interlaced Intuition Ed screen!
  102.  Some of the few comments are in German.
  103.  Both create a file called 'Demo.c' in device 'RAM:'
  104.  
  105.  Intuition Ed must already run and it's screen must be behind the Workbench
  106.  when you start a demo.
  107.  
  108.  Demo1:
  109.  ------
  110.  run IntuitionEd
  111.  IntuitionEd/playback IntuitionEd/Demo1
  112.  
  113.  The demo creates a screen containing two windows with either a text
  114.  or a border on them.
  115.  
  116.  Demo2:
  117.  ------
  118.  run IntuitionEd
  119.  IntuitionEd/playback IntuitionEd/Demo2
  120.  
  121.  This demo shows how to write structures which are opend several times.
  122.  It creates two identical screens containing two identical windows
  123.  with different textes on them.
  124.  
  125. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  126.  
  127.    3  -                      Structures
  128.                      -----------------------------
  129.  
  130.  
  131.    Screens
  132. -------------
  133.  
  134.  To edit a screen structure, you just enter the structure-values in the 
  135.  gadgets.
  136.  
  137.  You can chose a default font for your screen with the gadgets 
  138.  'Topaz 60' and 'Topaz 80'.
  139.  
  140.  
  141.    Windows
  142. -------------
  143.  
  144.  The gadgets to edit gadgets, borders and text are aktiv after you
  145.  created a window on which they can be displayed.
  146.  
  147.  
  148.    Gadgets
  149. -------------
  150.  
  151.  Since you haven't yet the complete version of Intuition Ed, a description
  152.  does not make much sense.
  153.  
  154.  
  155.     Text
  156. ------------
  157.  
  158.  Beside the IntuiText structure you can create a TextAttr structure in the
  159.  text menu. You MUST activate the 'ON' gadget to save a TextAttr
  160.  structure !!!
  161.  
  162.  You can create a DiskFont in the TextAttr structure with Intuition Ed
  163.  but it's not automatically opend by the compiled C program.
  164.  
  165.  There is a program in the Intuition Ed directory (DiskFont.c) which shows
  166.  how to handle DiskFonts.
  167.  
  168.  As in the IntuiText structure, the LeftEdge and TopEdge values are relative
  169.  to the gadget position if it's a gadgettext.
  170.  
  171.  
  172.    Borders
  173. -------------
  174.  
  175.  When you enter the edges of a border you have to put a value for every
  176.  edge you want to have.
  177.  
  178.  If you edit a gadgetborder (with the entire version)
  179.  the edges contain default values to surround the gadget.
  180.  
  181.  The LeftEdge and TopEdge values are relative to the gadget position.
  182.  
  183.  
  184. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  185.  
  186.    4  -                    Quit Intuition Ed
  187.                       ---------------------------
  188.  
  189.  You get to the Save menu by pressing the 'End' Gadget in any other menu.
  190.  By pressing the 'Cancel' gadget you can return to this menu again.
  191.  You can also quit the program without saving anything ('Exit').
  192.  
  193.  When the 'Open_All() & Close_All()' gadget is activated Intuition Ed
  194.  writes functions which open and close all intuition elements.
  195.  It can also write a main function which calls them with 20 seconds delay.
  196.  Intuition Ed can also write comments on all structures and headlines to
  197.  seperate and describe functions in the source code.
  198.  
  199. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  200.  
  201.    5  -                       Distribution
  202.                       ---------------------------
  203.  
  204.          
  205.  Please feel free to copy and spread this version of Intuition Ed and the
  206.  files which go with it. It's public domain !
  207.  The public domain version of Intuition Ed is not complete!   
  208.  
  209.  To get the entire program (which can also save gadgets) and
  210.  to support further developments please send me 20$ or something equal
  211.  in any currency and you get the latest copy of Intuition Ed and
  212.  similar PD tools and program examples which are on the same disk.
  213.  
  214.  
  215.  This program is originally German (thats why I got to take the interlace
  216.  mode to fit on your screen) but you can also get the German version with
  217.  a much more detailed description of the intuition structures !
  218.  
  219.  That's it.
  220.  If you have any questions, comments, bug reports, money sent it to
  221.  
  222.  
  223.   Niels Thorwirth
  224.    Ulmenweg 3
  225.     3370 Seesen
  226.   
  227.   GERMANY
  228.