home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DATABASE / DBT123S.ZIP / DBTQREF.DOC < prev    next >
Text File  |  1990-08-10  |  15KB  |  326 lines
  1.  
  2.  
  3.         dBTools dBASE Enhancement Tools Quick Reference Guide
  4.  
  5.                     Version 2.0  08/07/1990
  6.                 (c) 1990 BERNATH COMPUTER
  7.  
  8.         To load dBTools:    LOAD DBTWORK
  9.                             mADDR=SPACE(14)
  10.                             CALL DBTWORK WITH mADDR
  11.                             LOAD DBTOOLS
  12.                             CALL DBTOOLS WITH "0,"+mADDR
  13.  
  14.         To call a dBTools function:
  15.               CALL DBTOOLS WITH "function name or number,parameter string"
  16.               You can use either the function name or number. Only the 1st
  17.               4 characters of the function name are significant, and can be
  18.               in upper or lower case. Using the function number runs
  19.               slightly faster.
  20.  
  21.               Color pairs (FG/BG) can be specified using the standard DOS
  22.               color numbers 0-15 or with the dBASE color format (eg, +W/N,
  23.               etc.) and are also case insensitive. Using the DOS color
  24.               numbers is slighty faster.
  25.  
  26.  
  27.         Func Name      Syntax
  28.         ---- --------- ----------------------------------------------
  29.           1  ATSAY     fast screen write
  30.                        "atsay,<S>,row,col,FG,BG,page,text"
  31.                        optional S parameter gives a small shadow
  32.  
  33.           2  SOUNDEFF  sound effects
  34.                        "effects" or "2,0" bronx cheer (formerly 'BLAT')
  35.                        "2,1" or "18"  3 note 'TWIDDLE'
  36.                        "2,2"   sounds an alarm until a key is pressed
  37.                        "2,3"   'CHIRP' sounds like a bird chirp
  38.                        "2,4"   'BLIP', a short, high pitched beep
  39.  
  40.           3  BOX       draw a framed box
  41.                        "box,ULR,ULC,LRR,LRC,FG,BG,frame,page,shadow"
  42.  
  43.                        Frame: 0 - no frame
  44.                               1 - single line
  45.                               2 - double line
  46.                               3 - single on horz, double on vert
  47.                               4 - double on horz, single on vert
  48.                               5 - thick line frame
  49.  
  50.                        Shadow = 1 to activate, 0 for no shadow
  51.  
  52.           4  CURSOR    cursor attributes
  53.                        "cursor,off/on,normal/fat"
  54.  
  55.                        0 to turn off cursor or set to normal
  56.                        1 to turn on cursor or set to fat
  57.  
  58.           5  ERASE     erase text
  59.                        "erase,ULR,ULC,LRR,LRC,<BG>"
  60.  
  61.                        optional BG to erase to a color. If not specified,
  62.                        blanks text but leaves colors intact.
  63.  
  64.           6  DELAY     wait for a specified time
  65.                        "delay,delaytime"
  66.  
  67.           7  DITHER    dithered background
  68.                        "dither,chartype,FG/BG,page"
  69.  
  70.                        Chartype: 0 - <solid BG color>
  71.                                  1 - ░
  72.                                  2 - ▒
  73.                                  3 - ▓
  74.                                  4 - <solid FG color>
  75.  
  76.           8  FADE      slideshow fades
  77.                        "fade,fadetype,mode/color,delay,slot"
  78.  
  79.                        Fadetype: 0 - instant
  80.                                  1 - vertical alternate fingers wipe
  81.                                  2 - vertical scroll, top to bottom
  82.                                  3 - vertical scroll, bottom to top
  83.                                  4 - horizontal wipe, left to right
  84.                                  5 - horizontal wipe, right to left
  85.                                  6 - horizontal alternate fingers wipe
  86.                                  7 - sparkle fade
  87.  
  88.                        Mode/color should be 0 if fading in a screen image,
  89.                        or specify a color if fading to a blank screen.
  90.                        Delay time is somewhat dependent on processor speed and
  91.                        so might vary with processor type.
  92.                        If Mode/color is 0, you MUST specify a slot number.
  93.  
  94.  
  95.           9  HMENU     horizontal moving bar menu
  96.                        "hmenu,<Y>,choice,row,col,LowFG,LowBG,HighFG,HighBG,
  97.                         item1,item2,...,@"
  98.  
  99.              mPARM = "9,Y,"+STR(choice,2)+",24,25,15,0,0,7,Add,Change,Quit,@"
  100.              CALL DBTOOLS WITH mPARM
  101.              choice = VAL(mPARM)
  102.              IF choice = 99                        && Fkey was pressed
  103.                  mKEY  = ASC(SUBSTR(mPARM,4,1))-1  && Extract 1st scancode
  104.                  mSCAN = ASC(SUBSTR(mPARM,5,1))-1  && Extract 2nd scancode
  105.                  choice = ASC(SUBSTR(mPARM),6,1))  && Extract highlighted opt
  106.              ENDIF
  107.  
  108.  
  109.          10  PAUSE     "press any key to continue...",  or alternate message
  110.                        "pause,<Y>,row,col,FG,BG,<alternate message>"
  111.  
  112.              mPARM = "10,Y,5,15,11,1,F1 Recall    F2 Add new   F3 Blank"
  113.              CALL DBTOOLS WITH mPARM
  114.              mKEY=ASC(mPARM)-1                     && Extract 1st scancode
  115.              mSCAN = ASC(SUBSTR(mPARM,2,1))-1      && Extract 2nd scancode
  116.  
  117.          11  PRINTER   printer driver
  118.                        "printer,0,0,filespec"
  119.                        "11,0,1,                              "
  120.                        "11,seqcode"
  121.  
  122.                        You must first load the definition file with
  123.                        CALL DBTOOLS WITH "11,0,0,filespec".
  124.                        Example printer codes:
  125.  
  126.                         1    Initialize printer
  127.                         2    Set to 10 CPI
  128.                         3    Set to 12 CPI
  129.                         4    Compressed print ON
  130.                         5    Compressed print OFF
  131.                         6    Double wide ON
  132.                         7    Double wide OFF
  133.                         8    Bold ON
  134.                         9    Bold OFF
  135.                        10    Italic ON
  136.                        11    Italic OFF
  137.                        12    Underline ON
  138.                        13    Underline OFF
  139.                        14    Superscript ON
  140.                        15    Superscript OFF
  141.                        16    Subscript ON
  142.                        17    Subscript OFF
  143.                        18    NLQ ON
  144.                        19    NLQ OFF
  145.                        20    Set to 6 LPI
  146.                        21    Set to 8 LPI
  147.                        22    Set to 4 LPI
  148.                        23    Set left margin
  149.  
  150.          To get printer info:
  151.          mPARM = "11,0,1,"+SPACE(31)
  152.          CALL DBTOOLS WITH mPARM
  153.          mNUMESC = ASC(SUBSTR(mPARM,1,1))       && # of defined esc seq's
  154.          mPRTYPE = ASC(SUBSTR(mPARM,2,1))       && printer type
  155.                                                 &&  0 = nonprogrammable
  156.                                                 &&  1 = 80 col dot matrix
  157.                                                 &&  2 = 132 col dot matrix
  158.                                                 &&  3 = laser/inkjet
  159.          mPRNAME = SUBSTR(mPARM,3,36)           && printer name
  160.  
  161.          12  READSCR   read screen image from a file into memory
  162.                        "readscr,slot,filespec"
  163.  
  164.                        Legal slotnumbers 1-4.
  165.                        Filespec is a 4000 byte screen image.
  166.  
  167.          13  RECOLOR   recolor an area
  168.                        "recolor,ULR,ULC,LRR,LRC,FG/BG"
  169.  
  170.          14  RESTSCR   restore a screen image from memory to the screen
  171.                        "restscr,slotnumber,page"
  172.  
  173.                        Legal slotnumbers 1-4.
  174.  
  175.          15  SAVESCR   save current screen into memory
  176.                        "savescr,slotnumber"
  177.  
  178.                        Legal slotnumbers 1-4.
  179.  
  180.          16  SCROLL    scroll an area
  181.                        "scroll,ULR,ULC,LRR,LRC,FG,BG,numlines,direction"
  182.  
  183.                        Direction = 1, up   = 2, down
  184.  
  185.          17  PLAY      play notes on the speaker
  186.                        "play,frequency,duration"
  187.  
  188.                        Frequency range 50 to 17000 cps
  189.                        Duration is in clock tics (1/18th second)
  190.  
  191.          18  TWIDDLE   three note twiddle
  192.                        "twiddle" or "2,1"
  193.  
  194.          19  UNPOP     restore area under a popup window
  195.                        "unpop,windownumber"     Legal windownumer 1-24
  196.  
  197.          20  VMENU     vertical moving bar menu
  198.                        Non-popup:
  199.                        "vmenu,<Y>,choice,0,ULR,ULC,LRR,LRC,LowFG/LowBG,frame,
  200.                         shadow,HighFG/HighBG,Jus,item1,item2,...,@"
  201.  
  202.                        Frame and shadow same as BOX, function 3.
  203.                        Jus = 1, text left justified
  204.                        Jus = 2, text centered
  205.  
  206.                        Popup:
  207.                        (set up a Window first with function 21)
  208.                        "vmenu,<Y>,choice,windownumber,HighFG/HighBG,Jus,
  209.                         item1,item2,...,@"
  210.                        (use UNPOP function 19 to restore window)
  211.  
  212.              CALL DBTOOLS WITH mPARM
  213.              choice = VAL(mPARM)
  214.              IF choice = 99                         && Fkey was pressed
  215.                  mKEY  = ASC(SUBSTR(mPARM,4))-1     && Extract 1st scancode
  216.                  mSCAN = ASC(SUBSTR(mPARM,5,1))-1   && Extract 2nd0 scancode
  217.                  choice = ASC(SUBSTR(mPARM,6,1))    && Extract highlighted opt
  218.              ENDIF
  219.  
  220.          21  WINDOW    popup window
  221.                        "window,windownumber,ULR,ULC,LRR,LRC,FG/BG,
  222.                         frame,shadow"
  223.  
  224.                        Legal windownumbers 1-24.
  225.                        Frame and shadow same as BOX, function 3.
  226.  
  227.          22  PAGE      Change active video page. Legal page = 0-3.
  228.                        "page,pagenum"
  229.  
  230.          23  NOBLINK   Enable/disable blinking
  231.                        "noblink,blinkattr"
  232.                        blinkattr=0  disable blinking, enable hi intensity BG
  233.                        blinkattr=1  enable blinking, disable hi intensity BG
  234.  
  235.          24  PALETTE   Set EGA palette colors (EGA/VGA only)
  236.                        "egapal,0"    reset to standard default palette
  237.                        "egapal,1,RR/VV,RR/VV,RR/VV,...." one to all 16 registers
  238.                        where RR is one of the 16 EGA color registers 0-15
  239.                        and VV is one of the possible 64 color values 0-63
  240.  
  241.          25  GETKEY    Trap keystrokes and return unambiguous codes
  242.                        "getkey,0"  without echo
  243.                        "getkey,1"  with echo
  244.                        mPARM="25,0"
  245.                        CALL DBTOOLS WITH mPARM
  246.                        mKEY=ASC(mPARM)-1
  247.                        mSCAN=ASC(SUBSTR(mPARM,2,1))-1
  248.  
  249.           26  DIALOG   "dialog,0,0"  clear all dialog buttons
  250.               BUTTONS  "dialog,0,X"  clear dialog button X  (1-24)
  251.  
  252.                        "dialog,1,row,col,length,lowFG/lowBG,hiFG/hiBG,shadow,
  253.                              prompt text"
  254.  
  255.                        Define dialog button. Starting at row,col the prompt
  256.                        text is displayed in color lowFG/lowBG. If length is
  257.                        specified, text is centered in a 'box' of length. If
  258.                        shadow=1, a small shadow (like ATSAY's) is drawn.
  259.  
  260.  
  261.                        mPARM="26,2,0"  activate all dialog buttons
  262.                        mPARM="26,2,X,Y,Z,..."  activate specific dialog buttons
  263.                        CALL DBTOOLS WITH mPARM
  264.                        mCHOICE = VAL(mPARM)
  265.  
  266.                        When dialog buttons are activated, a moving bar high-
  267.                        light (which is color hiFG,hiBG for each button) is
  268.                        displayed, which is moved with the arrow keys. Pressing
  269.                        ENTER will cause the value associated with the high-
  270.                        lighted button to be returned (ESC returns 0). The
  271.                        initial highlighted button will be the one with the
  272.                        lowest number if you use "26,2,0", or the first button
  273.                        in the list if you use "26,2,X,Y,Z,...".
  274.                        Alternatively, clicking the left mouse button on a
  275.                        dialog button returns its value, or clicking the right
  276.                        button acts like ESC.
  277.  
  278.           27  MOUSE    "mouse,0,0" turn mouse cursor off (deactivate mouse)
  279.               CONTROL  "mouse,0,1" turn mouse cursor on  (activate mouse)
  280.  
  281.                        "mouse,1,ULR,ULC,LRR,LRC" set mouse boundaries
  282.  
  283.                        mPARM="27,2   "  total length of 7 bytes
  284.                        CALL DBTOOLS WITH mPARM     return mouse status
  285.                        row=VAL(LEFT(mPARM,2))
  286.                        col=VAL(SUBSTR(mPARM,3,2))
  287.                        left button=   SUBSTR(mPARM,5,1))  1 is ON, 0 is OFF
  288.                        middle button= SUBSTR(mPARM,6,1))
  289.                        right button=  SUBSTR(mPARM,7,1))
  290.  
  291.           28  ENCRYPT  String encryption (for passwords, etc). Encrypt or
  292.                        decrypt a string of up to 128 bytes.
  293.                        "encrypt,1,<string to encrypt>"
  294.                        "encrypt,2,<string to decrypt>"
  295.                        Must use a memvar to pass parameters. String is
  296.                        returned in the memvar.
  297.  
  298.           29  SCHEME   Color schemes, a la FoxPro.
  299.                        "scheme,1,schemeno,FG/BG,FG/BG,...."  define a color scheme
  300.                        "scheme,2,schemeno"   set current dBASE colors to scheme
  301.                        "29,3"            save current dBASE colors
  302.  
  303.                        A color scheme consists of 10 color pairs which
  304.                        define colors of various items:
  305.  
  306.                        1)   Standard @SAY color
  307.                        2)   GET highlight color
  308.                        3)   Window frame
  309.                        4)   Window text
  310.                        5)   Menu active item (unselected)
  311.                        6)   Menu selected item (highlighted)
  312.                        7)   Menu inactive item
  313.                        8)   Menu hotkey highlight
  314.                        9)   Message color
  315.                        10)  Title color
  316.  
  317.                        There is space to store 12 color schemes.
  318.  
  319.  
  320.          30  MOVEWIND  Move a window
  321.  
  322.          31  COPYWIND  Copy a window
  323.  
  324.          32  SETCOL    Set Columns
  325.  
  326.