home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 18 / CD_ASCQ_18_111294_W.iso / dos / prg / pas / pscrn55 / a86.doc < prev    next >
Text File  |  1994-10-09  |  11KB  |  266 lines
  1.  
  2.  
  3.           Using P-Screen and A86.Com to create "callable" screens
  4.           =======================================================
  5.  
  6.  
  7.  
  8.        A86 is Copyright 1990-1994, Eric Isaacson   All Rights Reserved
  9.  
  10.               P-Screen is Copyright 1988-1994, Rob W. Smetana
  11.                            All Rights Reserved
  12.  
  13.  
  14.  
  15.       Here's how to create "callable" screens that you link to programs
  16.       and then just "call myscreen" to display them:
  17.  
  18.         1.  Create a screen using P-Screen.
  19.  
  20.         2.  Save it to an ASM file (press F2).
  21.  
  22.         3.  Exit P-Screen and run A86 or any Masm-compatible assembler
  23.             to create an OBJ file (e.g., a86 myscreen.asm +o).
  24.  
  25.         4.  Link the OBJ to your program, then just "call" your screen
  26.             to display it (e.g.,  call frog -or- frog; -or-  FROG (); ).
  27.  
  28.  
  29.       But when we added P-Screen's ASM/OBJ screen feature, we realized
  30.       that some P-Screen users might have no way to assemble their
  31.       screens into .OBJ files.  Not to worry . . .
  32.  
  33.  
  34.       Through special arrangements with Eric Isaacson (author of the
  35.       A86 assembler, Zipkey and other user-supported programs) we've
  36.       included a copy of A86 for your trial use in assembling P-Screen's
  37.       .ASM screens.
  38.  
  39.       You may use either A86 or MASM to assemble your screens.  A86 is
  40.       faster than MASM, consumes just 23k of disk space, and usually
  41.       creates OBJs that are smaller than those MASM creates.  But the
  42.       choice is yours.
  43.  
  44.  
  45.       NOTE:  We urge you to obtain the full version of A86 from a BBS, a
  46.       shareware distributor, or from Mr. Isaacson himself.  This brief
  47.       discussion ONLY shows you how to use A86 to assemble P-Screen's
  48.       ASM screens.  It does NOT explain A86's other features or advantages.
  49.       Please get the full version for it's complete documentation and
  50.       the other features Eric includes.
  51.  
  52.  
  53.  
  54.  
  55.                                                                        
  56.  
  57.      ============================ LICENSE ============================
  58.  
  59.  
  60.        A86 is Copyright 1990-1994, Eric Isaacson   All Rights Reserved
  61.  
  62.               P-Screen is Copyright 1988-1994, Rob W. Smetana
  63.                            All Rights Reserved
  64.  
  65.  
  66.  
  67.  
  68.       =================================================================
  69.  
  70.       Below are Eric Isaacson's guidelines for trying this A86 package.
  71.  
  72.       =================================================================
  73.  
  74.       This A86 package is provided under the following conditions:
  75.  
  76.       You may execute the A86.Com program in this package in order
  77.       to evaluate it.  If you decide that you want to continue using
  78.       A86 assembler beyond the trial perion of 30 days, you must become
  79.       a registered user by sending $50 US ($52 if you are outside
  80.       North America) to:
  81.  
  82.                              Eric Isaacson
  83.                         416 E. University Avenue
  84.                        Bloomington, IN 47401-4739
  85.  
  86.       For your convenience, I now accept Visa and MasterCard, by
  87.       telephone.  My number is (812) 339-1811.
  88.  
  89.       When you register we'll send you the latest version of A86 on a
  90.       5.25 inch disk.   We'll also send you the A86LIB tool, available
  91.       only to registered users.  You may order further updates for
  92.       $10 US, or $12 US if you are overseas.  Once you register for
  93.       this package, you are registered for all future versions -- you
  94.       have permanent rights to execute A86 on one computer.  As long
  95.       as I'm in business, you can get the latest version for just the
  96.       update fee.
  97.  
  98.       We also offer the D86 debugging tool.  Normally it's also $50.
  99.       But when you order both A86 and D86 at the same time, I charge
  100.       $80 ($82 overseas) for both.
  101.  
  102.                                                        continued . . .
  103.                                                                            
  104.  
  105.       A86 License  (continued)
  106.  
  107.       I also offer a printed version of the manual covering both A86
  108.       and D86 (an on-disk manual is always included).  If you order
  109.       with your registration the manual is an extra $10 to the U.S.,
  110.       $15 overseas. If you've already registered and now want the
  111.       manual, add another $10 ($12 overseas) for the update disk that
  112.       the manual is bundled with.  There is a limit of one manual per
  113.       computer registered (except you may reorder when there is a
  114.       substantial revision to the manual).
  115.  
  116.       Indiana residents must add sales tax.  At the current rate of 5%,
  117.       the prices for Indiana residents are $52.50 for either A86 or D86,
  118.       $63 one product with manual, $84 both products, $94.50 both
  119.       products with manual, $21 manual if already registered.
  120.  
  121.       Educational institutions and training facilities MUST be registered
  122.       in order to use A86 in courses.  Contact me for special terms.
  123.  
  124.       Companies and government agencies MUST be registered in order to
  125.       use A86 for their work.  Again, contact me for special terms.
  126.  
  127.       =================================================================
  128.  
  129.       NOTE:  Just to clarify, you'll register A86 with Eric Isaacson.
  130.  
  131.       You'll register P-Screen with Rob W. Smetana.  See Catalog.Doc and
  132.       To-Order.Doc for descriptions of our many programs and order forms.
  133.  
  134.       =================================================================
  135.  
  136.  
  137.       Rob W. Smetana                   Eric Isaacson
  138.       Pro~Formance                     416 E. University Avenue
  139.       132 Alpine Terrace               Bloomington, IN 47401-4739
  140.       San Francisco, CA  94117
  141.       (415) 863 - 0530                 (812) 339 - 1811
  142.  
  143.                                                                            
  144.  
  145.       =============  A Word About P-Screen's ASM Screens  =============
  146.  
  147.  
  148.       P-Screen's "callable" screens are terrific!  They're v-e-r-y fast
  149.       and easy to use.  And since we use one screen-restore routine for
  150.       everything (library, ASM and normal screen save/restores), using
  151.       ASM screens adds very little overhead to your programs.
  152.  
  153.       Also, "callable" screens can be full or partial screens.  Partial
  154.       screens may be anything from 1 character on up.  You needn't
  155.       burden your program with several 4,000 byte screens.  P-Screen's
  156.       compressed, partial screens (plus one small ASM routine) yield
  157.       tight, efficient programs.
  158.  
  159.       But it's sometimes not obvious when one should:  1) draw a screen
  160.       manually; 2) use an ASM screen; or, 4) display screens from a
  161.       library.  Here are some guidelines we follow:
  162.  
  163.  
  164.        * First, while we're developing programs, we always display most
  165.          screens from screen libraries, preserving memory for code.  When
  166.          we compile the program, we simply comment out the CALLs to the
  167.          library screen display routine, and un-REM the CALL below it to
  168.          our ASM or in-line screen display routine.  For example:
  169.  
  170.          displayscreen ("mylib", "myscreen", errcode)   -- from a library
  171.          myscreen                                       -- ASM screen
  172.  
  173.        * Screens that are critical to our program must be IN our program.
  174.          This includes menus, dialog boxes, warnings or error messages
  175.          and mandatory help screens.  We display ALL other screens from
  176.          screen libraries (help screens, introductions or farewell).
  177.  
  178.        * When a screen is simple, it's often most efficient to draw it
  179.          manually in your program.  Examples might be a window with just
  180.          a few lines of text.  This also gives you the flexibility to
  181.          simply change your code to change colors, text or positions.
  182.  
  183.        * But with complex screens, it's often more efficient to use ASM
  184.          screens.  That's because complex screens require so much code
  185.          to vary colors, patterns and textures and locate and print text.
  186.  
  187.                                                                            
  188.  
  189.  
  190.                            ASM versus OBJ Screens
  191.  
  192.       Other screen design programs let you save .OBJ files that you
  193.       LINK directly with your program -- you needn't assemble/compile
  194.       them first.
  195.  
  196.       We chose to provide you with .ASM screens for one simple reason:
  197.       to give you flexibility!
  198.  
  199.        * ASM screens are simple ASCII files you can edit with any
  200.          word processor or editor.  You can edit ASM screens to:
  201.  
  202.          - Change where the screen is displayed (assuming it's
  203.            a sub-screen, not a full screen).
  204.  
  205.          - Merge several "callable" screens into one ASM file.
  206.  
  207.        * You can "archive" ASM screens (using ZIP, PAK, LHarc or ARC) to
  208.          retain permanent, easily-edited copies and to preserve disk
  209.          space.  Then, you can change them without needing P-Screen.
  210.  
  211.          Note:  We urge you to ALWAYS save each screen to a screen
  212.          library.  That way you can always edit it and save it as an
  213.          ASCII, COM or ASM file.  And since P-Screen compresses screens,
  214.          this extra convenience and security consumes little disk space.
  215.  
  216.                                                                            
  217.  
  218.  
  219.                      Creating and Using ASM Screens
  220.                      ==============================
  221.  
  222.       Here's how easy it is to create screens you LINK with your
  223.       programs, then just CALL them to display them.
  224.  
  225.        1. Create a screen in P-Screen and save it to a screen library.
  226.           We urge you to ALWAYS save screens to libraries so you can
  227.           easily edit them later.
  228.  
  229.  
  230.        2. Save your screen to an ASM file by pressing <F2>.
  231.  
  232.           - NOTE:  Since you can create "partial" callable screens,
  233.             you must MARK that part of the screen you want saved to
  234.             an ASM file.
  235.  
  236.             So before you press <F2>, move your cursor to the top
  237.             left corner of the area you want to save.
  238.  
  239.             Then press <F2>, move the cursor to the bottom right corner,
  240.             and press <cr>.
  241.  
  242.           - Now give P-Screen a screen name.  Do NOT include hyphens
  243.             or numbers in your screen name.  Neither MASM nor A86
  244.             accept names that begin with numbers or contain hyphens.
  245.             Use the underscore if you need a separator (e.g. my_scrn).
  246.  
  247.           - Let's say you saved a screen named "myscreen."
  248.  
  249.  
  250.        3. Exit P-Screen and assemble your screen with A86 or Masm:
  251.  
  252.             masm myscreen;        -- note the semi-colon
  253.                  -or-
  254.             a86 myscreen.asm +o   -- no semi; +o means .OBJ file, not .COM
  255.  
  256.  
  257.           Note:  Masm assumes you're assembling an ".asm" file and
  258.           doesn't require the ".asm" extension.  With a86, you MUST
  259.           specify the ".asm" extension.
  260.  
  261.  
  262.        4. In your programs, declare the screen (the top of the ASM file
  263.           has declarations), then just CALL your screen to display it.
  264.  
  265.           That's it!
  266.