home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / program / Basic / SDA30.ZIP / BASSCR.DOC < prev    next >
Encoding:
Text File  |  1983-03-07  |  3.8 KB  |  133 lines
  1.         Screen Design Aid - V3.0 - BASIC Interface Revision.
  2.  
  3.  
  4.         EINTERFACE TO COMPILED BASIC PROGRAMSF
  5.  
  6.              The  current  distribution  diskette  contains  an  enhanced 
  7.         version  of  the  interface bridge for used with  compiled  BASIC 
  8.         programs.   This  enhanced version permits inclusion of up to  10 
  9.         screens in program memory at one time,  and elminates one of  the 
  10.         modules required during Link.  It follows the interface described 
  11.         in  the original documentation,  in that it expects to be  called 
  12.         with  three  parameters  passed  by  the  call.   The  first  two 
  13.         parameters  are  integer variables,  while the third is a  string 
  14.         variable.  The functions supported, and the proper content of the 
  15.         passed variables are:
  16.  
  17.              Display Menu - Parm 1 = 0, Parm 2 = Screen number (1 to 10),
  18.                             Parm 3 = unused.
  19.  
  20.              Output String- Parm 1 = 1, Parm 2 = Field number, Parm 3 =
  21.                             string to be displayed.
  22.  
  23.              Input String - Parm 1 = 2, Parm 2 = Field number, Parm 3 =
  24.                             string variable to accept the input string.
  25.  
  26.              Out/In       - Not supported
  27.  
  28.              Field Clear  - Parm 1 = 4, Parm 2 = Field number, Parm 3 =
  29.                             unused.
  30.  
  31.              Position     - Parm 1 = 5, Parm 2 = Field number, Parm 3 =
  32.                             unused.
  33.  
  34.         As discussed in the original documentation, a string being output 
  35.         will be truncated or extended by blanks to the field size defined 
  36.         for  the screen.   Input strings will be similarily  extended  by 
  37.         blanks  or  truncated  to  fit the entry  length  of  the  string 
  38.         parameter passed to this function.  
  39.  
  40.              To  use this facility,  prepare screens as described in  the 
  41.         main  document.   Having  completed  the design  step,  form  one 
  42.         assembly module, of the form:
  43.  
  44.              CODE SEGMENT   PARA PUBLIC    'CODE'
  45.                   ASSUME    CS:CODE,DS:CODE
  46.              ;
  47.                   PUBLIC    BASMEN
  48.              ;
  49.              BASMEN    EQU  $
  50.          
  51.                   (Include the source form of the screens desired
  52.                    in the sequence desired...note the sequence)
  53.  
  54.              ;
  55.                   DW        -1                  ;Must be included!!!!!
  56.              ;
  57.              CODE ENDS
  58.                   END
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         Screen Design Aid - V3.0 - BASIC Interface Revision.
  68.  
  69.  
  70.              Be   particularily  careful  that  the  final  define   word 
  71.         containing 0FFFFH (-1) is included.   Assemble this  module,  and 
  72.         then  when performing the "Link" of your Basic program,  use  the 
  73.         following control string:
  74.  
  75.                   your-program+BASSCR+screen-module  (sequence critical)
  76.  
  77.         when prompted for the "object" code to be linked.  Obviously, the 
  78.         object  form of the BASMEN you just produced and the object  form 
  79.         of BASSCR must be available to the Link program.  
  80.  
  81.              BASSCR requires 3CEH memory, while the screen module size is 
  82.         a  function  of  the  number and content of  the  screens  to  be 
  83.         displayed.   Execution  is normal as for any other compiled Basic 
  84.         program.   This  function  performs properly  whether  the  Basic 
  85.         program  was  compiled  for "stand alone" or "run  time  library" 
  86.         execution.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.