home *** CD-ROM | disk | FTP | other *** search
Text File | 1992-04-07 | 51.9 KB | 1,078 lines |
- {comment}
- ┌────────────────────────────────────────────────────────────────────────────┐
- │ │
- │ File: FASTFLIP.DOT │
- │ FastFlip v2.16 Documentation │
- │ Requirements: DOCPRT v1.3 │
- │ Author: Chris Curran │
- │ Aquila Data Systems, Inc. │
- │ Created: 12-01-91 │
- │ Modified: 02-04-92 │
- │ │
- └────────────────────────────────────────────────────────────────────────────┘
- {comment}
- {pagesize} 59
- {row} 20
- {b}FastFlip{n}
-
- The {i}Fast{n} Application Swapper
- {box} 0 0 3000 2399 1 100 0
- {box} 850 655 350 1050 1 100 10
- {newpage}
- {row} 28
- FastFlip, Copyright 1992 Aquila Data Systems and Chris Curran.
- All rights reserved.
- {row} 49
- Aquila Data Systems, Inc.
- 304 Bayfield Drive
- Brandon, FL 33511
-
- FAX : (813)653/2408 Group II, III
- BBS #1: (813)653-2937 1200-38400 v.32bis/v.42bis
- BBS #2: (813)685-4218 1200-38400 v.32bis/v.42bis
- {newpage}
- {header}
- {shade} 50 400 2825 2 100 ;tall vertical line on left
-
- {header}
- {footer}
- {shade} 2880 56 105 2286 10 ;row,col,rows,cols,%grey
- ────────────────────────────────────────────────────────────────────────────
- FastFlip v2.16 Table of Contents
- {footer}
- Contents
- Topic Section Page
- ─────────────────────────────────────────────────
- General
- Tools Used 1 1
- Program Description 1 2
- System Requirements 1 2
- Memory Requirements 1 2
- Installing FastFlip 1 4
- Starting FastFlip 1 4
- Command line options 1 5
-
- Program Status Screen 1 6
- Editing Pages Online 1 7
- Custom DOS Prompt 1 8
- Cut & Paste 1 9
-
-
- Configuration
- FFSETUP.EXE 2 1
- Startup Parameters 2 2
- Application Pages 2 4
-
-
- Command Line Operation
- Help 3 1
-
-
- Trouble Shooting
- Help 4 1
-
-
- Programmer Interface
- Definition 5 1
- Functions 5 1
-
-
- Legal Information
- License 6 1
- Shareware Policies 6 1
- BBS Operators 6 1
- Disclaimer 6 2
- Trademarks 6 2
-
-
- Ordering Information
- How 7 1
- Form 7 3
-
- {newpage}
- {footer}
- {shade} 2880 56 105 2286 10 ;row,col,rows,cols,%grey
- ────────────────────────────────────────────────────────────────────────────
- FastFlip v2.16 Section {sl}, Page {pr}
- {footer}
- {setpage} 1
- Development C compiler : BorlandC++ v2.0 (Borland)
- Tools Used Assembler : TASM v3.0 (Borland)
- Linker : TLink v5.0 (Borland)
- Debugger : TDebug v3.0 (Borland)
- Editor : Qedit 2.15 (SemWare)
- Version Control: PVCS for DOS (Sage Software)
- C Libs : CodeRunneR (Omega Point, Inc.)
- : PDK1-3, ADK1 (Omega Point, Inc.)
-
-
- Omega Point is the developer of a group of TSR libraries for
- 'C' programmers. Their libraries were used extensively in
- the development of FastFlip, most notably ADK1. It should
- also be noted that a sample program provided with ADK1 was
- used as the "starting point" for FastFlip. While FastFlip no
- longer resembles the original sample, FastFlip does have its
- roots in someone else's work. In other words, credit is due
- to Omega Point for providing superior programming libraries
- with superior sample programs to its customers.
-
- It should also be noted that Omega Point provides some of
- the best technical support there is. There are no three day
- waits for a call back from tech support! Without the quality
- tech support provided by Omega Point, FastFlip would have
- been next to impossible to write.
-
- While the Omega Point documentation is not what one would
- call "perfect", it is much better than other products
- competing in the same market, and sufficient for most
- applications. Omega Point has also been receptive to
- comments and suggestions concerning their doc, and has
- continually improved the quality of its documentation with
- each release.
-
- And no, I don't work for Omega Point, and I don't get any
- kick-back from them (no free updates). The above is this
- programmers opinion; you may or may not agree.
-
- How to contact Omega Point:
-
- Omega Point, Inc.
- 25 Birch Road
- Framingham, MA 01701
-
- Voice: (508)877-1819
- BBS: (508)875-8009
- {newpage}
- Program FastFlip v2.16
- Name Application Swapper
-
-
- What is it? FastFlip(tm) is a versatile program management tool that
- allows you to load up to 10 programs at once and instantly
- switch between them. You can switch between your word
- processor, spreadsheets, databases, and utilities at will
- without having to wait. This eliminates the need to exit one
- program to open and use another, which lets you concentrate
- on the reasons why you are using your software in the first
- place.
-
- NOTE: This is NOT a multi-tasker; the PC apps are simply
- swapped in and out as desired. The *only* task that is
- actually running is the task that is being viewed.
-
-
- Why? Why on EARTH would someone write "yet another task
- switcher"? Good question.
-
- FastFlip is not like other task switchers. For one, FastFlip
- is "lean & mean"; there aren't ten zillion features to
- learn, configure and remember. Because of this, you'll have
- FastFlip "up & running" in only minutes! And it's EASY!
-
- But just because FastFlip is easy use doesn't mean it's a
- "bare-bones" program. You can CUT & PASTE data from one
- application to another, specify memory size and type for
- each application page, and control it from DOS BAT files.
- And if you're a programmer, you can even control FastFlip
- from within your own programs!
-
- Everything about FastFlip is FAST. FAST setup. FAST load.
- FAST task switching.
-
-
- System FastFlip will run on the IBM PS/2, PC/AT, PC/XT, PC, and
- Requirements IBM compatible computers including the Compaq, NCR, Tandy,
- and WYSE PC's. MINIMUM requirements are:
-
- - 512k of memory.
- - PC/MS-DOS 3.0 or higher
- - Color or monochrome monitor with 80-column display.
-
-
- Memory Now for the next question in everyone's mind - how much
- Requirements memory is this going to cost me? 16k! That's right - you can
- have up to 10 PC applications running at the same time for
- 16k of DOS memory. And if you load FastFlip into upper
- memory (with DOS 5.0), it will leave a 0k DOS footprint!
-
- {newpage}
- The memory/disc space requirements of FastFlip are as
- follows (assuming you use the default memory settings):
-
- 1. ~775k of XMS memory per application, or
- 2. ~775k of LIM memory per application, or
- 3. ~775k of disc space per application, or
- 4. Any combination of the above.
-
- FastFlip is able to "scatter" its data requirements among
- the different stowage mediums available at load time. In
- other words, it can use some XMS, some LIM and send the rest
- to disc.
-
- XMS memory is preferred, then LIM, then lastly the disc
- drive. Note that FastFlip can directly access XMS (extended
- memory) if it is available. This type of memory is the
- cheapest to add to a PC (no extra boards are needed to
- install or control this type of memory), and also the
- fastest performing memory you can add to your PC. Street
- prices for memory are now about $50 to $75 per meg
- (depending on type and speed).
-
- Also note that if you use extended memory, you'll need to
- include HIMEM.SYS in your CONFIG.SYS file (make it the first
- entry).
-
- If a disc drive is used (and most will need to), then disc
- caching software is recommended. I personally use HyperDisk
- version 4.21 and find it to be one of the best. I have my
- machines on UPS's, so I also enable the disc write caching
- of HyperDisk, which tremendously decreases application swap
- time.
- {newpage}
- Installing You may install FastFlip two different ways: 1) copy all
- FastFlip FastFlip files to the directory of your choice (a separate
- directory is recommended), or, 2) run the FastFlip install
- program, "FFINST".
-
-
- Starting To start FastFlip, type FASTFLIP at your DOS prompt,
- FastFlip followed by any optional command line parameters (see
- next page). Do NOT start FastFlip if you have "shelled to
- DOS" from another application - this will leave "holes" in
- your memory.
-
- After FastFlip has been loaded, you may "hotkey" into any
- available application. With the exception of Windows 3.0,
- FastFlip can swap almost any application - even hi-res
- graphics applications.
-
- NOTE: FastFlip defaults to three application pages; to
- change this (and other) settings you need to run the
- setup program (see Section 2).
-
- {newpage}
- Command Line Command line options allow you to override settings that you
- Options have defined in the setup program. The available command
- line options are as follows:
-
- /? Display HELP screen. The help screen may be displayed
- before, or after FastFlip is loaded.
-
- /C Sets the hotkey used for CUT.
-
- Example: FastFlip /clcs-1
-
- Sets the CUT hotkey to Left-Ctrl-Shft-1.
-
- /E Forces FastFlip to NOT use any available EXPANDED
- memory (LIM 3.x-4.x) for swapping.
-
- /I Displays detailed information about the currently
- defined pages.
-
- /M Sets the hotkey used for MENU.
-
- /N Specifies the number of pages FastFlip will setup. The
- default is 3, and the maximum is 10.
-
- Example: FastFlip /n6
-
- Loads FastFlip with 6 pages.
-
- /P Sets the hotkey used for PASTE.
-
- /S FastFlip will use the current drive for swapping (if
- disc swapping is needed). If you do not have
- sufficient space on the current drive, or, have a RAM
- drive with sufficient space, use this option to
- specify a different swap drive.
-
- Example: FastFlip /sg
-
- Loads FastFlip, and swaps to drive G: if
- needed.
-
- /U Unload FastFlip from memory. This option requires that
- FastFlip is the LAST TSR that has been loaded. If
- other TSR's are loaded AFTER FastFlip, they will need
- to be removed before FastFlip can perform an unload.
-
- /X Forces FastFlip to NOT use any available XMS memory for
- swapping.
- {newpage}
- Program After FastFlip has been loaded, LCTRL-? will pop-up the
- Status application status menu.
-
- {shade} 275 499 750 1554 10 ;row,col,rows,cols,%grey
- ┌───────────────────────────────────────────────────┐
- │Pg Stat Mem Program HotKey │
- │───────────────────────────────────────────────────│
- │ 1 ══> 554k Dos Prompt LC-1 │
- │ 2 Act 256k Dos Prompt LC-2 │
- │ 3 Idl 256k Dos Prompt LC-3 │
- │ 4 Idl 256k Dos Prompt LC-4 │
- │ 5 Act 256k Dos Prompt LC-5 │
- │ 6 Idl 256k Dos Prompt LC-6 │
- │ 7 Idl 256k Dos Prompt LC-7 │
- │ 8 Idl 256k Dos Prompt LC-8 │
- │ 9 Idl 256k Dos Prompt LC-9 │
- │ 0 Idl 256k Dos Prompt LC-0 │
- │───────────────────────────────────────────────────│
- │ Enter Page #, or 'E' to edit │
- └───────────────────────────────────────────────────┘
-
- Sample Application Status Menu
-
-
- The Application Status Menu is rather self-explanatory. The
- current page is indicated with a "══>". Pages that are idle
- show "Idl" and pages that are active (but not currently
- selected) show "Act". The status display also shows the
- amount of memory, program name and hotkey for each page.
- {newpage}
- Editing A limited number of fields may be modified at run time for
- Program each application page. To edit the settings of a page, enter
- Information 'E' and select the appropriate page number from the list.
- The following screen will then be displayed:
-
- {shade} 375 499 400 1610 10 ;row,col,rows,cols,%grey
- ┌─────────────────────────────────────────────────────┐
- │ Page: x │
- │ Name: _________________________ │
- │ Program: ________________________________________ │
- │ Chg Dir: ________________________________________ │
- │ │
- │ Pause for command line options? (Y/N): _ │
- │ │
- └─────────────────────────────────────────────────────┘
-
- Sample Page Edit Display
-
-
- Page The page number being edited. This is a display
- only field.
-
- Name The description of the program. This may be any
- text up to 25 characters.
-
- Program The DOS name of the program. If the program is a
- COM or EXE file, an extension is not needed. If
- the program is a BATCH file, then the ".BAT"
- extension *MUST* be included.
-
- If the program is in your DOS PATH, then a path
- does not need to precede the DOS file name. If
- the program is NOT in your DOS PATH, then you
- must specify the path with the file name, or use
- the "Chg Dir" field below.
-
- If you only want a DOS prompt, leave this field
- blank. A BATCH file will also return to the DOS
- prompt (unless an EXIT command is included).
-
- Chg Dir The path that FastFlip should change to when the
- program is started.
-
- Pause If this field is "Y", FastFlip will pause for
- entry of any parameters to be passed to the
- program.
- {newpage}
- Custom DOS If a custom prompt is desired for each page at the DOS
- Prompt prompt, specify a BATCH file in the Program field to change
- the prompt.
-
- Example SETNEWP.BAT file for DOS:
-
- @echo off
- prompt $e[37;40m%1│$p$g$e[36;40m
-
-
- Example SETNEWP.BAT file for 4DOS users:
-
- @echo off
- setdos /V0
- prompt $e[37;40m%1│$p$g$e[36;40m
-
-
- This BATCH file will set a new prompt for this page (the
- 4DOS version also sets a 4DOS state variable). The PROMPT
- statement above requires ANSI.SYS (or equivalent) to be
- loaded since it also changes the color of the prompt (my
- personal preference). Note the placement of the DOS
- parameter "%1" - this parm is specified in the FastFlip
- Program Edit screen for this page (see example below).
-
- Following is a sample BATCH file setup:
-
- {shade} 1475 618 400 1612 10 ;row,col,rows,cols,%grey
- ┌─────────────────────────────────────────────────────┐
- │ Page: 3 │
- │ Name: Dos Prompt │
- │ Program: setnewp.bat 3 │
- │ Chg Dir: │
- │ │
- │ Pause for command line options? (Y/N): N │
- │ │
- └─────────────────────────────────────────────────────┘
- {newpage}
- Cut and FastFlip also allows you to "cut and paste" data between
- Paste applications.
-
- Cutting The contents of one application screen may be
- Data copied to another application, or to itself. Data
- that is to be copied must first be marked, then
- "cut". Note that the term "cut" does not denote
- that any damage or modification with come to the
- original data.
-
- Data is marked for cutting by pressing
- "Left-Ctrl-Left-Shft-C". The current application
- screen will then be set to white on black, and the
- marked area will be displayed as white on blue.
- The current cursor location is used as the upper
- left corner of the marked block. Use the arrow
- keys to expand or shrink the marked area.
-
- You may not move the cursor above or to the left
- of the current upper left corner of the marked
- block. If the upper left corner of the block needs
- to be moved, press "A", reposition the cursor and
- press "A" to anchor the upper left corner of the
- marked block.
-
- After the block has been marked, press "Enter".
- The data will then be copied to a disc file for
- later use by the Paste command. The disc file is
- NOT erased after a Paste command, or when FastFlip
- is unloaded. This allows you to paste the same
- data any number of times, to any number of
- applications.
-
- Pasting The contents of the disc cut file is pasted to the
- current application by pressing
- "Left-Ctrl-Left-Shft-P". The contents of the disc
- cut file is then fed into the current applications
- keyboard buffer, with an "Enter" simulated at the
- end of each line. If the disc cut file is empty or
- an error occurs during reading, a beep will be
- emitted and no action taken.
-
- Note: You must release all keys of the Paste
- command before pasting will begin.
- {newpage}
- {row} 20
- Configuring FastFlip
- {newpage} nofooter
- {section}
- Configuring The program FFSETUP.EXE is used to configure FastFlip. If
- FastFlip you run FFSETUP from a page in FastFlip (while it is
- loaded), the changes will not take effect until FastFlip has
- been unloaded and reloaded.
-
- NOTE: Command line toggles will override any configured
- settings.
-
-
- After FFSETUP has been loaded, you will be presented with
- the following menu:
-
- {shade} 725 975 700 660 10 ;row,col,rows,cols,%grey
- ┌─────────────────────┐
- │ │
- │ Startup Parameters │
- │ Application Page 1 │
- │ Application Page 2 │
- │ Application Page 3 │
- │ Application Page 4 │
- │ Application Page 5 │
- │ Application Page 6 │
- │ Application Page 7 │
- │ Application Page 8 │
- │ Application Page 9 │
- │ Application Page 10 │
- │ │
- └─────────────────────┘
-
-
- Select "Startup Parameters" to configure settings that
- affect all application pages (number of apps, swap drive,
- etc). Select "Application Page 1" through "Application Page
- 10" to configure the appropriate application page.
- {newpage}
- {shade} 125 499 700 1648 10 ;row,col,rows,cols,%grey
- Startup ┌──────────────────────────────────────────────────────┐
- Parameters │ │
- │ Menu Hotkey: LC-/ │
- │ Cut Hotkey: LCS-C │
- │ Paste Hotkey: LCS-P │
- │ Prev App Hotkey: LCS-, │
- │ Next App Hotkey: LCS-. │
- │ │
- │ Number of Applications: 3 │
- │ Swap Drive (if needed): C Alternate Drive: C │
- │ Use EMS for swapping?: Y │
- │ Use XMS for swapping?: Y │
- │ │
- │ │
- └──────────────────────────────────────────────────────┘
-
- Startup Parameters Edit Screen
-
-
- Menu Sets the hotkey used to display the application
- menu. See "Hot Key" in "Application Page Edit
- Screen" for valid hot key specifiers.
-
- Cut Sets the hotkey used to activate the cut
- operation. See "Hot Key" in "Application Page
- Edit Screen" for valid hot key specifiers.
-
- Paste Sets the hotkey used to activate the paste
- operation. See "Hot Key" in "Application Page
- Edit Screen" for valid hot key specifiers.
-
- Prev Sets the hotkey used to swap to the previous
- application page. See "Hot Key" in "Application
- Page Edit Screen" for valid hot key specifiers.
-
- Next Sets the hotkey used to swap to the next
- application page. See "Hot Key" in "Application
- Page Edit Screen" for valid hot key specifiers.
-
- Number Specifies the number of pages FastFlip will
- setup. The default is 3, and the maximum is 10.
-
- Swap Drive The primary drive that FastFlip should use for
- swapping (if disc swapping is needed). If there
- is not enough free space on this drive, the
- Alternate swap drive will be attempted.
-
- Alternate If FastFlip needs to swap to the disc and the
- primary swap drive does not have enough free
- space to hold the swap file, the alternate drive
- will be used instead.
- {newpage}
- Use EMS If this field is "Y", FastFlip will allow
- application pages to use EMS memory for
- swapping.
-
- If this field is "N", FastFlip will not allow
- application pages to use EMS memory for
- swapping.
-
- Use XMS If this field is "Y", FastFlip will allow
- application pages to use XMS memory for
- swapping.
-
- If this field is "N", FastFlip will not allow
- application pages to use XMS memory for
- swapping.
-
-
- {newpage}
- {shade} 110 499 700 1648 10 ;row,col,rows,cols,%grey
- Application ┌──────────────────────────────────────────────────────┐
- Page 1-10 │ │
- │ Page: 1 │
- │ Name: Dos Prompt │
- │ Program: │
- │ Chg Dir: │
- │ Memory: 512 │
- │ Hot Key: LC-1 │
- │ Use EMS: Y │
- │ Use XMS: Y │
- │ │
- │ Pause for command line options? (Y/N): N │
- │ │
- │ │
- └──────────────────────────────────────────────────────┘
-
- Application Page Edit Screen
-
-
- Page The page number being edited. This is a display
- only field.
-
- Name The description of the program. This may be any
- text up to 25 characters.
-
- Program The DOS name of the program. If the program is a
- COM or EXE file, an extension is not needed. If
- the program is a BATCH file, then the ".BAT"
- extension *MUST* be included.
-
- If the program is in your DOS PATH, then a path
- does not need to precede the DOS file name. If
- the program is NOT in your DOS PATH, then you
- must specify the path with the file name, or use
- the "Chg Dir" field below.
-
- If you only want a DOS prompt, leave this field
- blank. A BATCH file will also return to the DOS
- prompt (unless an EXIT command is included).
-
- Chg Dir The path that FastFlip should change to when the
- program is started.
-
- Memory The amount of memory needed (in k) for this
- program.
-
- NOTE: Memory size changes do not take effect
- until FastFlip has been unloaded and
- reloaded.
- {newpage}
- Hot Key The HotKey that will be used to change to this
- page. A HotKey is selected by entering HotKey
- specifiers, followed by a dash ('-') and then
- the identifier key. Available HotKey specifiers
- are:
-
- L Left
- R Right
- A Alt
- C Ctrl
- S Shift
-
- HotKey specifiers may be combined in any manner,
- except 'L' and 'R' - these two specifiers are
- mutually exclusive.
-
- A HotKey identifier is any single key. Function
- keys may be used as identifiers by using the key
- name (i.e. "F5").
-
- Examples:
- LCS-1 Left-Ctrl-Shift-1
- RCS-1 Right-Ctrl-Shift-1
- LCA-1 Left-Ctrl-Alt-1
- LCAS-1 Left-Ctrl-Alt-Shift-1
- LC-F9 Left-Ctrl-F9
- RC-F11 Right-Ctrl-F11
- LCAS-F9 Left-Ctrl-Alt-Shift-F9
- RCS-Q Right-Ctrl-Shift-Q
-
-
- NOTE: HotKey changes do not take effect until
- FastFlip has been unloaded and reloaded.
-
- Use EMS If this field is "Y", FastFlip will attempt to
- use EMS memory for swapping this page. If EMS
- usage is turned off (via Startup Parameters),
- this field has no effect.
-
- If this field is "N", FastFlip will not use EMS
- memory for swapping this page.
-
- Use XMS If this field is "Y", FastFlip will attempt to
- use XMS memory for swapping this page. If XMS
- usage is turned off (via Startup Parameters),
- this field has no effect.
-
- If this field is "N", FastFlip will not use XMS
- memory for swapping this page.
-
- Pause If this field is "Y", FastFlip will pause for
- entry of any parameters to be passed to the
- program.
- {newpage}
- {row} 20
- Command Line Operation
- {newpage} nofooter
- {section}
-
- Command The program FFCTL is provided to allow you to change
- FastFlip pages from a DOS batch file.
-
- NOTE: This program provides other features, but are
- primarily designed as examples for programmer's
- using the FastFlip Programmer Interface.
- Therefor, these features are not discussed in
- this section.
-
- To change a FastFlip page from DOS, type:
-
- FFCTL -pX
-
- where 'X' is the 1 based page number to switch to. For
- example, "FFCTL -p2" will cause FastFlip to change to
- page 2.
-
- {newpage}
- {row} 20
- FastFlip Trouble Shooting
- {newpage} nofooter
- {section}
- Huh? Having trouble with FastFlip? Check the following list
- of questions and answers to see if that helps. If not,
- try re-reading the documentation - sometimes we have
- to read something a few times before the "light bulb"
- comes on. If this still doesn't help, please call our
- BBS for support. WE'll try to help you through your
- problem whether you're registered or not.
-
- Q How do I shutdown a DOS page so that I may unload FastFlip.
-
- A Change to the DOS page and enter "EXIT" followed by ENTER.
-
-
-
- Q I can't get more than 3 pages to work.
-
- A Run the setup program FFSETUP. Select "Startup Parameters"
- and change the "Number of Applications" field to the number
- of pages you wish to run.
-
-
-
- Q I can't get more than 512k in a page.
-
- A Run the setup program FFSETUP. Select the application page
- you wish to modify. In the "Memory" field enter the amount
- of memory for this page.
-
- NOTE: If FastFlip is loaded when you change memory sizes,
- you must unload, then reload FastFlip for the changes
- to take effect.
-
-
-
- Q I can't get DOS BAT files to run.
-
- A You *MUST* include the ".BAT" extension when specifying the
- "Program" name for this page (see Section 2).
-
-
-
- Q I get a "Program not found" message when I select page X.
-
- A1 The program name may be spelled incorrectly.
- A2 The program may not be in your PATH (and no path specified
- with the program name).
- A3 The PATH specified with the program name may be invalid.
- A4 The PATH specified in "Chg Dir" may be invalid.
-
- {newpage}
- {row} 20
- FastFlip Programmer Interface
- {newpage} nofooter
- {section}
- Programmer Your programs may communicate with FastFlip via the
- Interface Multiplex Interrupt (interrupt 0x2F). This interrupt is well
- defined and its usage is somewhat "standardized" amongst
- TSRs. For a detailed discussion of the Multiplex Interrupt
- see any one of the following: Microsoft Encyclopedia
- (M$Press), DOS Programmer's Reference (QUE) or MS-DOS
- Developer's Guide (Waite Group). I recommend all three.
-
- A set of 'C' routines that can be used with your programs
- are contained in the file "FFLNK.C". The source is also
- provided for the utility program FFCTL - you may use this as
- an example program.
-
- ────────────────────────────────────────────────────────────
- Function: int ffLoaded(void);
-
- Purpose: Check to see if FastFlip is loaded.
-
- Input: none
-
- Return: 0 = Not loaded.
- 1 = Loaded.
-
- ────────────────────────────────────────────────────────────
- Function: int ffGetMaxPage(void);
-
- Purpose: Get the max number of pages available.
-
- Input: none
-
- Return: The number of DEFINED pages (not ACTIVE pages).
-
- ────────────────────────────────────────────────────────────
- Function: int ffSetPage(int page)
-
- Purpose: Set new active page.
-
- Input: page: The 0 based page number to change to.
-
- Return: 0 = Error
- 1 = No Error
-
- ────────────────────────────────────────────────────────────
- Function: void ffSetTimer(int clicks)
-
- Purpose: Set FastFlip internal timer.
-
- Input: clicks: The number of timer ticks to elapse before
- FastFlip checks internal tables for
- instructions.
-
- Return: none
- {newpage}
- ────────────────────────────────────────────────────────────
- Function: void ffSetMem(int offset, void far *buf, int len)
-
- Purpose: Copy data to the FastFlip common application
- memory area. NOTE: This area is 64 bytes in length
- (TOTAL, not per app) and YOU must verify that it
- is not overwritten.
- This function can be used to pass data between
- applications running under FastFlip.
-
- Input: offset The offset into the common memory to
- begin write to.
- buf Far pointer to data to write to the common
- memory.
- len The number of bytes to write to the common
- memory.
-
- Return: none
-
- ────────────────────────────────────────────────────────────
- Function: void ffGetMem(int offset, void far *buf, int len)
-
- Purpose: Copy data from the FastFlip common application
- memory area. NOTE: This area is 64 bytes in length
- (TOTAL, not per app).
- This function can be used to pass data between
- applications running under FastFlip.
-
- Input: offset The offset into the common memory to
- begin read from.
- buf Far pointer to receive buffer.
- len The number of bytes to read from common
- memory.
-
- Return: none
- {newpage}
- ────────────────────────────────────────────────────────────
- Function: void ffSetLock(int state)
-
- Purpose: This function allows you to "lock" or "unlock"
- FastFlip. When FastFlip is in a locked state, the
- user will NOT be able to perform ANY FastFlip
- actions. Note that even when FastFlip is in a
- locked state, your program can still perform all
- normal functions.
-
- NOTE: It is VERY important to ALWAYS unlock
- FastFlip after it has been locked. If your
- program exits with FastFlip locked and other
- pages are active, the user will not be able
- to switch to other pages. If other pages
- cannot be shutdown, the user cannot unload
- FastFlip - they must reboot to clear memory.
- Since this is not a desired action, it would
- be a good idea to call an unlock function
- with "atexit()". This will ensure that
- FastFlip is unlocked when your program exits
- (if FastFlip is not locked, the unlock
- command is ignored).
-
- Input: state 0 = Unlock FastFlip
- 1 = Lock FastFlip
-
- Return: none
- {newpage}
- {row} 20
- The Legal Stuff
- {newpage} nofooter
- {section}
- License This version of FastFlip is NOT public domain or free
- software, but is being distributed as "shareware".
-
- Non-registered users of this software are granted a limited
- license to make an evaluation copy for trial use on a
- private, non-commercial basis, for the express purpose of
- determining whether FastFlip is suitable for their needs. At
- the end of this trial period, you should either register
- your copy or discontinue using FastFlip.
-
- A FastFlip registration entitles you to use the program on
- any and all computers available to you, with the following
- restriction: If other people have access to this program or
- may use it, then you should purchase a site license. See
- the following section for information about site licensing
- or quantity discounts.
-
- All users are granted a limited license to copy FastFlip
- only for the trial use of others and subject to the above
- limitations. This license does NOT include distribution or
- copying of this software package:
-
- 1. In connection with any other product or service.
- 2. For general use within a company or institution.
- 3. For any consideration or 'disk fee'.
- 4. For distribution in modified form; i.e., the file
- containing this license information MUST be included,
- along with the full FastFlip documentation.
-
-
- Shareware This shareware version of FastFlip has a 3 second delay when
- Policies started from DOS. Registered versions of FastFlip do not
- contain this screen. The registered and shareware versions
- are otherwise {i}IDENTICAL{n}.
-
-
- BBS Operators of electronic bulletin board systems (Sysops) are
- Operators encouraged to post FastFlip for downloading by their users,
- as long as the above conditions are met.
- {newpage}
- Disclaimer The software and accompanying written materials (including
- instructions for use) are provided "AS IS" without warranty
- of any kind. Further, Aquila Data Systems does not warrant,
- guarantee, or make any representations regarding the use, or
- the results of the use, of the software or written materials
- in terms of correctness, accuracy, reliability, currentness,
- or otherwise. The entire risk as to the result and
- performance of the software is assumed by you. If the
- software or written materials are defective you, and not
- Aquila Data Systems or its dealers, distributors, agents or
- employees, assume the entire cost of all necessary
- servicing, repair, or correction.
-
- No warranties of any kind, either express or implied,
- including but not limited to the implied warranties of
- merchantability and fitness for a particular purpose, that
- are made by Aquila Data Systems on this Aquila Data Systems
- product. No oral or written information or advice given by
- Aquila Data Systems, its dealers, distributors, agents or
- employees shall create a warranty or in any way increase the
- scope of this warranty, and you may not rely on any such
- information or advice. This warranty gives you specific
- legal rights. You may have other legal rights, which vary
- from state to state.
-
- Neither Aquila Data Systems nor anyone else who has been
- involved with the creation, production, or delivery of this
- product shall be liable for any direct, indirect,
- consequential, or incidental damages (including but not
- limited to damages for loss of business profits, business
- interruption, loss of business information, and the like)
- arising out of the use or inability to use such product even
- if Aquila Data Systems has been advised of the possibility
- of such damages. Because some states do not allow the
- exclusion or limitation of liability for consequential or
- incidental damages, the above limitation may not apply to
- you.
-
-
- Trademarks All trademarks and copyrights belong to their respective
- holders. Who else {i}would{n} they belong to anyway?
- {newpage}
- {row} 20
- Ordering Information
- {newpage} nofooter
- {section}
- Ordering A FastFlip registration licenses you to use the product on a
- Information regular basis. Registration includes notification of updates
- and technical support (via our support BBS).
-
- Registering FastFlip costs $35. When received, we will send
- you an "unlock" code that will turn your current (and
- future) versions of FastFlip into a "registered" version. If
- you prefer, you may also receive this code via our support
- BBS.
-
- A diskette with the latest version of FastFlip and printed
- documentation is also available for an additional $15.
- Florida residents should include 6% sales tax. Please use
- the form at the end of this document.
-
-
- Upgrades Updating to a newer version of FastFlip is currently free.
- We do not expect this policy to change in the future, but we
- reserve the right to do so. When you register, you will
- receive an unlock code that will brand the current and
- future versions of FastFlip with your name.
-
-
- Orders Please send a check drawn on a US bank in US dollars. We
- outside can accept non-US currency; however, you must include an
- the US additional $15 to cover conversion and collection costs.
- Please include an additional $10 to cover postage on orders
- delivered outside of the US (if applicable).
-
- Corporate All corporate, business, government or other commercial
- Site users of FastFlip must be registered. We offer quantity
- Licenses and discounts as well as site licensing.
- Quantity
- Purchases Corporate site licensing agreements allow duplication and
- distribution of specific numbers of copies within the licensed
- institution. Duplication of multiple copies is not allowed
- except through execution of a licensing agreement. Site
- license fees are based upon estimated number of users.
-
- Please call or write for more information.
-
- ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT
- NOTICE. Discounts are not cumulative; they apply to single
- orders of like products only. Unit prices are the same as
- for individual users.
-
- WARNING YOU MAY NOT USE FastFlip WITHIN YOUR ORGANIZATION WITHOUT A
- PRIOR PURCHASE OR LICENSE ARRANGEMENT.
- {newpage}
- How To To register your copy of FastFlip, please fill out the
- Register following form and send it along with a check or money
- order.
-
- Remit/Send To: Aquila Data Systems, Inc.
- 304 Bayfield Drive
- Brandon, FL 33511
- {newpage} noheader
- ────────────────────────────────────────────────────────────────────────────
- FastFlip Order Form
- ────────────────────────────────────────────────────────────────────────────
-
- Name (to register to): ________________________________________________
-
- Address to ship to: ________________________________________________
-
- ________________________________________________
-
- ________________________________________________
-
- Telephone: ________________________________________________
-
- Date: __________________
-
-
- ────────────────────────────────────────────────────────────────────────────
- QUANTITY DESCRIPTION UNIT PRICE TOTAL
- ────────────────────────────────────────────────────────────────────────────
-
- ________ FastFlip US $ 35.00 ________
-
- Florida Residents add 6% ________
-
- Shipping $1.50
-
- Additional Shipping ________
-
- Total ________
-
- Check/Money Order enclosed for US $ ___________
-
- ────────────────────────────────────────────────────────────────────────────
-
- Version Number of FastFlip: _________________________________________
-
- Place obtained from: _________________________________________
-
- Type of Computer: _________________________________________
-
- Type of Operating System: _________________________________________
-
- Type of video card/monitor: _________________________________________
-
-
- Additional Comments: _________________________________________
-
- ________________________________________________________________________
-
- ________________________________________________________________________
-
- ________________________________________________________________________
- {newpage} nofooter
-