home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / NRFACE.ZIP / IFACE.DOC < prev    next >
Text File  |  1990-04-29  |  18KB  |  430 lines

  1.                          WELCOME TO INTERFACE PLUS!
  2.                                 Version 2.1
  3.            
  4.                The Solution For Your QuickBASIC 4.5 Problems
  5.                =============================================
  6.            
  7.                                       by
  8.  
  9.                                 George Campbell
  10.                                  1472 Sixth St.
  11.                               Los Osos, CA  93402
  12.                                  CIS: 71571,222
  13.                                 GEnie: G.CAMPBELL
  14.                               BBS - (805) 528-3753
  15.            
  16.            
  17.            INTRODUCTION
  18.            ============
  19.            
  20.            After writing dozens of shareware and public domain programs
  21.            in QuickBASIC, I finally figured out that I was re-inventing
  22.            the interface wheel for each program. As I developed my
  23.            skills, my interfaces became more and more sophisticated.
  24.            BUT -- I was still rewriting the things for each program.
  25.            
  26.            Finally, I came up with an answer. Why not create a
  27.            universal interface for all my software....one which was
  28.            flexible enough to handle a single menu, and complex enough
  29.            to work for a complex program with dozens of choices?  Out
  30.            of that need comes Interface Plus, the program you're
  31.            looking at today.
  32.            
  33.            The interface itself became an obsession: Every time I
  34.            turned around, I found another thing it needed. Mouse
  35.            support?  Of course!  Built-in routines for common needs?
  36.            Certainly!  Drop-down menus?  What else?
  37.            
  38.            In any case, I finally brought the program to a point where
  39.            I felt it was good enough for my programs. Now, I'm offering
  40.            it as a shareware program to aid other QuickBASIC
  41.            programmers. Can it work for you?
  42.            
  43.            
  44.            WHY YOU NEED INTERFACE PLUS
  45.            ===========================
  46.            
  47.            If you write shareware software, you already know that
  48.            registration checks from users depend on your program. If
  49.            it's complete and easy to use, you get checks. It's that
  50.            simple.
  51.            
  52.            By writing your program within Interface Plus, you assure
  53.            better registration response. Your program, no matter what
  54.            it does, has a state-of-the-art interface.
  55.            
  56.            You save time, too. Since you don't have to re-invent the
  57.            interface wheel each time you create a new program, you can
  58.            focus on YOUR routines.
  59.            
  60.            Finally, since your programs will be in a flexible
  61.            interface, adding new functions as you upgrade is a walk in
  62.            the park. You can add new menu items just by writing three
  63.            lines of code.
  64.            
  65.            
  66.            SYSTEM REQUIREMENTS
  67.            ===================
  68.            
  69.            Interface Plus will run on any IBM-compatible PC. It needs
  70.            256K of memory, DOS 2.1 or a later version, but will work on
  71.            any monitor. The mouse is optional. Its mouse-handling
  72.            routines are designed to support ALL mice, including the IBM
  73.            PS/2 mouse.
  74.            
  75.            The program automatically determines what's available in any
  76.            PC, then adjusts itself accordingly.
  77.            
  78.            As a programmer, working with Interface Plus, you'll need
  79.            640K, QuickBASIC 4.5 or later, and DOS 3.1 or a later
  80.            version. A mouse is a good idea for testing.
  81.            
  82.            FEATURES
  83.            ========
  84.            
  85.            
  86.            Interface Plus has an extensive features list, with handles
  87.            you can build on to make all your programs more powerful.
  88.            Here's a fairly complete list:
  89.            
  90.            USER FUNCTIONS
  91.            
  92.            Windows-like text interface
  93.            Drop-Down Menus
  94.            Mouse Support
  95.            Automatic Configuration
  96.            All menu functions can be accessed by:
  97.                 1. Mouse click
  98.                 2. First letter keypress
  99.                 3. Cursor keys plus <Enter>
  100.            Intelligent Menus (jumps to next logical choice)
  101.            Screen Color Selection built-in. (point and click)
  102.            Screen background choices
  103.            File selection from screen list
  104.            File Viewer
  105.            Shell to DOS with command or just to prompt
  106.            Pop-up windows and input boxes
  107.            OK and YES/NO buttons for mouse or keyboard
  108.            Configuration file automatically saves YOUR setup
  109.            Environment variables for power users
  110.            Automatic return to original directory
  111.            Totally intuitive operation
  112.            
  113.            
  114.            PROGRAMMER FUNCTIONS
  115.            ====================
  116.            
  117.            MENUS
  118.            
  119.            Full drop-down, with mouse, keyboard, or cursor-key control
  120.            Up to 240 separate menu items
  121.            Easy menu setup, with all menu variables in one place
  122.            Automatic sizing and positioning of menus
  123.            Total menu flexibility
  124.            
  125.            MENU INTELLIGENCE
  126.            
  127.            By adding two simple variables, you can make your Interface
  128.            Plus applications intelligent. After executing one function,
  129.            your user finds him or herself looking at the next logical
  130.            menu -- already highlighted. You control this easily.
  131.            
  132.            MOUSE SUPPORT
  133.            
  134.            By keeping mouse functions simple, this program is
  135.            completely independent of type of mouse. It works with ALL
  136.            mice, automatically.
  137.            
  138.            Mouse Cursor Control -- YOU decide where you want the mouse
  139.            cursor to be. Combined with intelligent menus, you can
  140.            always place the cursor in the next logical spot.
  141.            
  142.            Detect clicks
  143.            Find mouse location
  144.            Turn mouse on or off with a command
  145.            
  146.            
  147.            WINDOWS and BOXES
  148.            
  149.            Built-in input or information box with:
  150.            
  151.                 Fixed location for instant user recognition.
  152.                 Room for three 60-character lines of text
  153.                 OK button or YES/NO button optional
  154.            
  155.            Custom Screen Windows with:
  156.            
  157.                 Flexible sizing
  158.                 Total color control
  159.                 5 Border types
  160.                 One-line call to create box on screen
  161.                 Multiple boxes on screen at once.
  162.            
  163.            OK and YES/NO buttons:
  164.            
  165.                 Can be positioned anywhere on screen
  166.                 One line call to create button
  167.                 Accept mouse click or keystroke
  168.                 Optional defaults
  169.                 Mouse cursor is automatically on button!
  170.            
  171.            Program Intelligence
  172.            
  173.            Interface Plus checks the user's system and knows these
  174.            things:
  175.            
  176.                 Memory Size
  177.                 DOS Version
  178.                 Monitor Type
  179.                 Mouse status
  180.                 Available Drives (A: to H:)
  181.                 (NOTE: The drive check is currently REMmed out in
  182.                 this version. It occasionally leaves a temporary file
  183.                 behind on LOGICAL drives. You can decide for yourself
  184.                 whether to use the DriveTest routine)
  185.                 Original Directory
  186.                 Current Directory
  187.                 Environment path setting for your data files
  188.                 File choice - if file is selected
  189.                 Command line parameters
  190.                 MORE!
  191.            
  192.            Programmer-accessible routines include:
  193.            
  194.                 Directory Display
  195.                 File Selection
  196.                 Change Directory
  197.                 Display ASCII file
  198.                 Mouse cursor position - set or read
  199.                 Mouse cursor on or off
  200.                 Programmable delay
  201.                 Print Screen
  202.                 Send Formfeed
  203.                 Change File Mask for directory search
  204.                 Shell to DOS
  205.                 Input box -- described above
  206.                 OK and YES/NO buttons -- described above
  207.                 Sizable and movable windows
  208.                 Read in Color data from file.
  209.                 Write and read configuration file.
  210.                 Keystroke filter -- tells you what key has been
  211.                 pressed, including all function keys, plain or shifted,
  212.                 and cursor keys. Easy string-type identifiers. FAST!
  213.                 MORE!
  214.            
  215.            
  216.            PROGRAM LAYOUT
  217.            
  218.            Interface Plus is written TOTALLY in QuickBASIC 4.5. There
  219.            are no hidden routines or libraries. All routines are
  220.            included and may be altered to suit your needs.
  221.            
  222.            You get COMPLETE source code!
  223.            
  224.            All variables and routines have long, readable names. You
  225.            won't have to remember cryptic variable and routine names
  226.            when you insert your own code.
  227.            
  228.            Interface Plus is clean and well-designed. It uses the
  229.            appropriate QB tools in the appropriate places. CALLed
  230.            subroutines and GOSUBs are use throughout, depending on the
  231.            need for global or local variables. NOTICE:  There are three
  232.            places where GOTOs are used, but they never leave a routine,
  233.            so cause zero problems.
  234.            
  235.            Where appropriate, Interface Plus uses INTERRUPT-driven
  236.            routines. Mouse control, file lists, and others are
  237.            included. Since these are fundamental to the program, you
  238.            don't need to know how to use interrupts to use them. There
  239.            here for speed and to add support for functions not
  240.            supported by QuickBASIC.
  241.            
  242.            The Interface Plus source code is in three sections.
  243.            
  244.            1. The main menu section.
  245.            All menu design tools are right up-front and easy to use.
  246.            The QB SELECT CASE function is used throughout.
  247.            
  248.            1. GOSUB subroutines
  249.            
  250.            These routines use global variables. Every precaution has
  251.            been taken to clear variables when needed. Here's where you
  252.            add your own stuff.
  253.            
  254.            2. Called subroutines
  255.            
  256.            Most of these are integral to the interface itself. Calling
  257.            each of these means that you must pass variables to the
  258.            routine. Since variable names are clear and understandable,
  259.            it's easy.
  260.            
  261.            Individual routines are separated by comment lines, clearly
  262.            identifying them. The full documentation package even
  263.            includes keywords for jumping to any routine while in the QB
  264.            environment.
  265.            
  266.            
  267.            LICENSING INFORMATION
  268.            =====================
  269.            
  270.            Interface Plus is shareware, and has a four-tiered licensing
  271.            structure, along with several registration methods. First
  272.            and foremost:  YOU NEVER PAY ROYALTIES WHEN YOU USE
  273.            INTERFACE PLUS!
  274.            
  275.            Overall Licensing
  276.            
  277.            Interface Plus contains code which will identify it,
  278.            regardless of how you use it. In addition, a copyright
  279.            notice is included as a string constant in the program. This
  280.            notice will NEVER appear to your customers, but MUST remain
  281.            in the source code, without changes. It will appear in the
  282.            .EXE file, if a hex editor is used. No licence granted
  283.            allows removal of that code or copyright notice.
  284.            
  285.            Regardless of the license type, users may alter any portion
  286.            of the Interface Plus source code to suit their needs.
  287.            
  288.            Here's a rundown on licensing and registration options:
  289.            
  290.            Public Domain and Personal Use license:
  291.            
  292.            You may use Interface Plus to create personal programs and
  293.            programs you place in the public domain at no charge
  294.            whatsoever. I want to encourage the development of free
  295.            programs. By public domain, I mean programs which are
  296.            offered to the public with no registration fee whatsoever.
  297.            You may, of course, want to take advantage of the $10
  298.            registration offer, which brings a clean version of the
  299.            source code, and more documentation.
  300.            
  301.            
  302.            Shareware Licence:
  303.            
  304.            If you use Interface Plus to create shareware software,
  305.            wherein you request a registration fee from users, the
  306.            licence fee is $60. That's just three $20 registrations, so
  307.            it's not all that expensive. See the Registration
  308.            Information below to see what you get for your $60
  309.            registration fee!
  310.            
  311.            
  312.            Corporate In-House License:
  313.            
  314.            If you use Interface Plus to create applications which will
  315.            be used internally WITHIN a corporation, the license fee is
  316.            $125. This fee entitles you to distribute unlimited copies
  317.            of a program using Interface Plus WITHIN a single
  318.            corporation. Under this fee, you MAY NOT sell or otherwise
  319.            distribute a program outside your corporation or to clients
  320.            of your corporation.
  321.            
  322.            
  323.            Commercial License:
  324.            
  325.            If you use Interface Plus to create software which you will
  326.            sell outright to customers, whether corporate or individual,
  327.            the license fee is $1000. It's simple:  If a program using
  328.            Interface Plus has a price tag and is not distributed as
  329.            shareware, you must buy a Commercial License.
  330.            
  331.            
  332.            REGISTRATION INFORMATION
  333.            ========================
  334.            
  335.            Here's what you get for each of the license formats:
  336.            
  337.            
  338.            Public Domain and Personal Use License:
  339.            
  340.            COST: $10
  341.            
  342.            INCLUDES:
  343.            
  344.            1. Full source code, both for the demo version and for the
  345.            cleaned-up version with no built-in menu functions.
  346.            
  347.            2. 5.25" or 3.5" diskettes.
  348.            
  349.            3. Basic documentation, on-disk, which includes all
  350.            information needed to use functions in Interface Plus.
  351.            
  352.            4. TXT2COM -- a shareware text-to-COM file utility for
  353.            creating self-browsing text files.
  354.            
  355.            5. Limited support on CompuServe, GEnie, or the author's
  356.            BBS. No telephone support is included with this license.
  357.            
  358.            
  359.            All other Licenses:
  360.            
  361.            COST: Varies
  362.            
  363.            INCLUDES:
  364.            
  365.            1. Full source code, both for the demonstration version and
  366.            the empty version.
  367.            
  368.            2. 5.25" AND 3.5" Diskettes
  369.            
  370.            3. Laser-printed manual in three-ring binder. Manual
  371.            includes:
  372.            
  373.            a. Detailed source code comments
  374.            b. Full variable list, with calls and functions
  375.            c. Full subroutine details, with parameters and syntax.
  376.            d. Menu-design tips and parameters.
  377.            e. Printed copy of both source code sets for study.
  378.            f. Hints and tips for making Interface Plus work for you.
  379.            
  380.            4. Telephone support, along with the other support tools.
  381.            
  382.            5. Notification of upgrades. Upgrades will cost $15, and
  383.            will include new disks, and manual pages for quick
  384.            insertion.
  385.            
  386.            
  387.            ORDER FORM
  388.            
  389.            INTERFACE PLUS
  390.            George Campbell
  391.            1472 Sixth Street
  392.            Los Osos, CA  93402
  393.            
  394.            YES! I want to order a Registered Version of Interface Plus!
  395.            Please send the version checked below. I'm enclosing a check
  396.            or money order.
  397.            
  398.            ___  Personal Use License  ($15)    ____ 5.25"   ___ 3.5"
  399.            
  400.            ___ Shareware License ($60)
  401.            
  402.            ___ Corporate In-house License ($125)
  403.            
  404.            ___ Commercial License ($1000)
  405.            
  406.            (See section above for what's included)
  407.            
  408.            AMOUNT ENCLOSED: $____________ (Includes shipping)
  409.            
  410.            
  411.            SEND TO:
  412.            
  413.            NAME:_______________________________________________________
  414.            
  415.            STREET:_____________________________________________________
  416.            
  417.            ____________________________________________________________
  418.            
  419.            CITY:____________________________STATE:_____ZIP_____________
  420.            
  421.            
  422.            
  423.            
  424.            
  425.            FINAL NOTE:
  426.            
  427.            If you're reading this, but haven't yet seen a copy of
  428.            Interface Plus, be sure and download your copy of NRFACE.ZIP
  429.            soon. You'll wonder why nobody did this before!
  430.