Borland Programmer's Resource/Borland_Programmers_Resource_CD_1995.iso/code/bcpp/file10/fgdemo.doc

Text File | 1995-05-19 | 20.6 KB | 382 lines

                             FGDEMO version 1.1

Ted Gruber Software                                      Voice: [phone]
PO Box 13408                                               FAX: [phone]
Las Vegas, NV  89112                                       BBS: [phone]
                                                           CIS:     72000,1642

------------------------------------------------------------------------------
    FGDEMO:  the demo program for Fastgraph v2.10 and Fastgraph/Light v1.10
------------------------------------------------------------------------------

This program illustrates some of the features of the Fastgraph (tm) graphics
library.  It was written by Diana Gruber, senior programmer at Ted Gruber
Software.  You can contact Ted Gruber Software at the address and phone
numbers listed at the bottom of this file.

FGDEMO is distributed with source code.  It was originally compiled with the
Microsoft C 6.0 medium memory model.  You may use the source code in FGDEMO in
your own applications.  This program requires either Fastgraph version 2.10 or
Fastgraph/Light (tm) version 1.10 to link.  If you want to use this code, and
you don't have a copy of Fastgraph, please contact Ted Gruber Software.

------------------------------------------------------------------------------
                                Starting FGDEMO
------------------------------------------------------------------------------

You can install FGDEMO on a hard disk or run it from diskette.  Just type
FGDEMO at the DOS command prompt.  To install FGDEMO on a hard disk, create a
subdirectory and copy all the files from the diskette to the subdirectory.

------------------------------------------------------------------------------
                                  Video modes
------------------------------------------------------------------------------

FGDEMO runs in a choice of 4 video modes:

   640x200 2-color CGA
   640x200 16-color EGA
   640x350 16-color EGA
   720x348 Hercules monochrome

When you start the program, you will be given a default video mode choice, and
an opportunity to change to one of the other video modes.  We suggest you try
all of them, and see what they look like.  Note that some of these video modes
may not be available on your system.

------------------------------------------------------------------------------
                                Running FGDEMO
------------------------------------------------------------------------------

After you start FGDEMO and choose a video mode, an attractive horizontal menu
bar will appear at the top of the screen.  Press any key or click the left
mouse button to get the first pull-down vertical menu.  Select a feature from
this or any menu.  The menus are intuitive.  Select and try all the features
on all the menus.

------------------------------------------------------------------------------
                              Distributing FGDEMO
------------------------------------------------------------------------------

You may freely distribute FGDEMO as long as all the files are distributed
together in their original unaltered state.  If you want to zip the files
together for BBS distribution, please use the file name FGDEMO11.ZIP for
version 1.1 of FGDEMO.  The following files are included in the FGDEMO
distribution:

Files required to run FGDEMO:
    FGDEMO   EXE  - the Fastgraph demo program
    08PT     FNT  - 8pt font file (packed pixel run format)
    14PT     FNT  - 14pt font file (packed pixel run format)
    CASINO   PCX  - graphic file (PCX format)
    CASINO   PPR  - graphic file (packed pixel run format)
    ORDER    FRM  - order form (can be printed from File menu)

Documentation:
    FGDEMO   DOC  - this file

Source code for FGDEMO:
    CHAR     C   - character display and management functions
    COMMON   C   - initialization, termination, general i/o functions
    DISPLAY  C   - functions on Display submenu
    EDITOR   C   - text editor functions
    FGDEMO   C   - function main and screen drawing functions
    FILE     C   - functions on File submenu
    FUNDMTLS C   - functions on Fundamentals submenu
    MENU     C   - define and manage the horizontal and vertical menus
    MISC     C   - functions on Miscellaneous submenu
    UTILITY  C   - functions on Utilities submenu
    VIDEO    C   - functions on Video submenu

Header files:
    DEFS     H   - general declarations and initializations
    BIRDMAPS H   - Bird animation bitmaps
    TNTMAPS  H   - TNT and "Kablooy" bitmaps for explosion
    CHAR     H   - these files contain the function declarations.
    COMMON   H     Each one is associated with a source code file.
    DISPLAY  H     The Microsoft C compiler creates these files
    EDITOR   H     when the /Zg switch is used.
    FGDEMO   H
    FILE     H
    FUNDMTLS H
    MENU     H
    MISC     H
    UTILITY  H
    VIDEO    H

Make files:
    BUILDBC  BAT - batch file to compile and link FGDEMO with Borland C++
    BUILDMSC BAT - batch file to compile and link FGDEMO with MSC or QuickC
    BUILDTC  BAT - batch file to compile and link FGDEMO with Turbo C/C++
    FGDEMO       - make file for Microsoft C or Quick C
    FGDEMO   MAK - make file for Borland C++ or Turbo C++
    FGDEMO   PRJ - project file for Turbo C

------------------------------------------------------------------------------
                         Compiling and linking FGDEMO
------------------------------------------------------------------------------

The source code files may be recompiled using either Microsoft C, Turbo C,
Turbo C++, Borland C++.  The medium memory model is recommended, and the large
model will also work.  FGDEMO is too big to use the small memory model.

If you are using Microsoft C, you can use the make file FGDEMO (no extension)
to rebuild FGDEMO.  If you want to link FGDEMO with Fastgraph instead of
Fastgraph/Light, change the library name FGLM to FGM in the LINK command.

If you are using Turbo C or Turbo C++, you can use the project file FGDEMO.PRJ
to rebuild FGDEMO.  If you are compiling from withing the IDE, set the
compilation options to use the medium memory model.  Alternatively, you can
use the command file BUILDTC.BAT to perform the compilation and linking. If
you want to link FGDEMO with Fastgraph instead of Fastgraph/Light, change the
library name FGLM to FGM in the TLINK command, or in the last line of the
project make file.

If you are using Borland C++, you can use the make file FGDEMO.MAK to rebuild
FGDEMO.  If you are compiling from withing the IDE, set the compilation
options to use the medium memory model.  Alternatively, you can use the
command file BUILDBC.BAT to perform the compilation and linking. If you want
to link FGDEMO with Fastgraph instead of Fastgraph/Light, change the library
name FGLM to FGM in the TLINK command, or in the last line of the project make
file.

You may have problems running FGDEMO in the CGA 640x200 2-color mode (mode 6)
in the Turbo C integrated development environment.  That is because the
environment allocates all available memory, making it impossible for Fastgraph
to allocate a virtual video page.  FGDEMO requires two video pages, of which
one is virtual in mode 6.  You should be able to run FGDEMO in the other video
modes, and you should have no trouble compiling, linking, and running FGDEMO
from the DOS command line.

We have had some reports of trouble with older versions of TLINK finding the
Fastgraph or Fastgraph/Light libraries.  If you have this problem, be sure the
full path name of the library appears in your TLINK.CFG file.  If that does
not solve the problem, include the full library path name in the TLINK
command.  We called Borland technical support about this problem, and they
told us there is no TLINK.CFG file supported in Turbo C version 2.0, but it is
supported in Turbo C++ and Borland C++.

------------------------------------------------------------------------------
                            About the FGDEMO menus
------------------------------------------------------------------------------

The menu structure is defined in the file DEFS.H.  A typdef CMD is defined
which is a structure containing information about each menu item:  the
function called when the menu choice is activated, the descriptive name of the
menu item, the x and y location of the menu item, and pointers to the next and
previous items on the menu.  Each menu is defined by an array of these
structures, and is initialized at the top of MENU.C.

There are two types of menus:  a horizontal menu, which is the moving bar menu
at the top of the screen, and vertical menus, also known as "pull-down"
menus.  When a pull-down menu is visible, a menu function may be activated by
either clicking the mouse on a highlighted menu function, or by pressing
<Enter>.  Arrow keys are used to highlight the next and previous menu item,
and a mouse may also be used.

User input relevant to the menus is accepted in two places:  within the
vertical_menu function (to activate a menu choice), or in the main function
(to control the horizontal menu).  The horizontal menu is also controlled
within the vertical menu, to the extent that if an arrow key is pressed, the
next or previous pull-down menu becomes active.

The entire screen, including the horizontal menu and the dithered background,
is drawn at the beginning of the program and stored on the hidden page.  When
a function is called, for example "point", part or all of the visual page is
overwritten, in this case with a pattern of points.  When a key or mouse
button is pressed, the relevant parts of the hidden page are copied back to
the visual page using fg_transfer, resulting in quick (almost instantaneous)
screen redraws.  Occasionally, the entire hidden page needs to be completely
redrawn, such as after the graphics file is displayed, but in most cases only
a small part of the hidden page needs to be redrawn, usually with a single
call to fg_drect.  In general, the hidden page is assumed to have a "clean"
copy of the horizontal menu screen throughout the program, and whenever it is
overwritten it is immediately restored.

------------------------------------------------------------------------------
                                  Fastgraph
------------------------------------------------------------------------------

Fastgraph is a versatile, high-performance programmer's graphics library for
DOS-based PC systems.  It is powerful enough to satisfy the most demanding
graphics application, yet it is easy enough for even the novice graphics
programmer.  Fastgraph includes more than 170 hand-optimized routines, from
pixel display to sophisticated animation tools.  This collection of routines
provides a programmer with proven, powerful tools to take command of the PC
and PS/2 text and graphics video environment.

Fastgraph's major functional areas include:

   * Video mode detection and initialization
   * Colors, virtual colors, and palettes
   * Graphics fundamentals, including points, solid and dashed lines,
     polygons, circles, ellipses, solid and dithered rectangles, region
     fill, and clipping
   * Redefinable world space coordinate system
   * A scalable stroked character font
   * Image display facilities, including mode-specific and mode-independent
     images, clipped and reversed images, image retrieval, pixel run maps,
     PCX file display and creation, and fast image transfer
   * Physical, virtual, and logical video page management
   * Resizeable video pages for smooth, flicker-free panning
   * Animation and special effects
   * Keyboard, mouse, and joystick support
   * Sound effects and music, both synchronous and asynchronous
   * Support for Borland C++, Turbo C and C++, Microsoft C and QuickC,
     Power C, Turbo Pascal, QuickBASIC, Microsoft FORTRAN, and MASM/TASM
   * Support for small, medium, and large memory models
   * Extensive tutorial-style user's guide and reference manual
   * No royalties

Fastgraph is an ideal development tool for entertainment and educational
software, presentation graphics products, scientific and engineering
applications, CAD/CAM, animation, and any application that requires robust
graphics.  Fastgraph supports 22 video modes, including VGA (standard and
extended), EGA, MCGA, CGA, Hercules, Tandy, and monochrome and color text.
With Fastgraph, it's possible to write programs that run in many different
video modes by changing only a few lines of code, resulting in fast program
development.

Originally developed for use in commercial video games, Fastgraph represents
the cutting edge in graphics technology for the IBM PC.  It has been used in
commercial products such as Accolade's Test Drive III, Day of the Viper, Steel
Thunder, and Gunboat; ComputerEasy's Video Poker a la Carte; Compu-Teach's
Once Upon a Time series, Puppet Playhouse, and Destination Mars; and all our
shareware products.

------------------------------------------------------------------------------
                               Fastgraph/Light
------------------------------------------------------------------------------

Fastgraph/Light is the shareware version of Fastgraph.  It includes all the
features of Fastgraph except the world space coordinate system and stroked
character font.  Unlike Fastgraph, Fastgraph/Light uses an external video
driver (FGDRIVER) that you load before running a program developed with
Fastgraph/Light, just as you load a mouse driver before you run a program that
uses a mouse.  Fastgraph does not use the external video driver but instead
includes the necessary functions directly in your EXE or COM file.

Any programs developed using Fastgraph/Light are 100% source code compatible
with Fastgraph.  If you upgrade from Fastgraph/Light to Fastgraph, all you
need to do is re-link your programs.  As with Fastgraph, we don't charge
royalties for using Fastgraph/Light.  The Fastgraph/Light software license
agreement allows you to distribute the external video driver without charge
as part of your applications.

------------------------------------------------------------------------------
                               Fastgraph/Fonts
------------------------------------------------------------------------------

Fastgraph/Fonts lets you easily add bit-mapped character support to Fastgraph
applications.  The product includes 40 font files in several point sizes.  A
program can load up to 32 fonts simultaneously.  Font files shipped with
Fastgraph/Fonts may be distributed without royalties in your applications.

The Fastgraph/Fonts manual includes a detailed description of the font file
format, so you can create your own font files.  PCX templates and a MAKEFONT
utility are included to assist in font file creation.

Fastgraph/Fonts requires any version of Fastgraph or Fastgraph/Light.

------------------------------------------------------------------------------
                               Fastgraph/Image
------------------------------------------------------------------------------

Fastgraph/Image is a Fastgraph add-on product that provides functions and
utilities for managing libraries containing images and other files.  While
the product was designed to manage and display PCX, PPR, and SPR images
stored in a library file, Fastgraph/Image can be used with any type of file,
including bit maps, text files, and Fastgraph/Fonts font files.

Functions are provided for opening a library, displaying an image file from
a library, retrieving a file from a library, and closing a library.  The
product also includes a library management utility that lets you add, delete,
extract, and replace files in a library.

If an application uses several image files, Fastgraph/Image is especially
valuable because it lets you distribute these images in a single file.  This
provides added security because users can't take your image files and use
them for other purposes (at least not easily).  Another benefit is that
combining many images in a single file uses less disk space than distributing
separate files for each image.

Fastgraph/Fonts requires any version of Fastgraph.

------------------------------------------------------------------------------
                             Ordering Information
------------------------------------------------------------------------------

The Fastgraph family of products represents a high-performance, comprehensive
development system for graphics programmers.  For more information about any
of our products, please call, write, or FAX.  You can download evaluation
versions and product demos from our technical support BBS at [phone].

We accept Visa, MasterCard, and COD (extra charge for COD orders).  Purchase
orders are welcome from most companies, schools, and government agencies.

Site licenses are available for all products.  Please call, write, or FAX for
specific details.

For your convenience, the order form below appears by itself in the ORDER.FRM
file.

Order from:                                              Voice: [phone]
Ted Gruber Software                                        FAX: [phone]
PO Box 13408                                               BBS: [phone]
Las Vegas, NV  89112                                       CIS:     72000,1642

Name:    _____________________________________________________________________

Company: _____________________________________________________________________

Address: _____________________________________________________________________

City:    _____________________________________  State: ________  Zip: ________

Country: _____________________________________  Phone: _______________________

+=====+=========================================+=======+============+=======+
|     |                                         | Price |  Shipping  |       |
| Qty |            Product Description          | Each  | Code  Cost | Total |
+=====+=========================================+=======+=====+======+=======+
|     | Fastgraph graphics library              | $169  |  1  |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | Fastgraph/Light with on-line manuals    |  $49  |  2  |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | Fastgraph/Light with printed manuals    |  $74  |  1  |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | Fastgraph/Fonts bit-mapped font support |  $49  |  2  |      |       |
|     | (requires Fastgraph or Fastgraph/Light) |       |     |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | Fastgraph/Image image management library|  $49  |  2  |      |       |
|     | (requires Fastgraph)                    |       |     |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | FG/Fonts and FG/Image bundle            |  $88  |  2  |      |       |
+-----+-----------------------------------------+-------+-----+------+-------+
|     | Graphics Power Pack                     | $249  |  1  |      |       |
|     | Fastgraph, FG/Fonts, and FG/Image       |       |     |      |       |
+=====+=========================================+=======+=====+======+=======+
                                                           Subtotal  |       |
*********************************                                    +=======+
*                               *    Nevada residents add sales tax  |       |
* Shipping charges per product: *                                    +=======+
*                               *     COD orders (U.S. only) add $4  |       |
*     Code 1         Code 2     *                                    +=======+
*   ----------     ----------   *                             Total  |       |
*   U.S.    $5     U.S.    $3   *                                    +=======+
*   Canada $12     Canada  $3   *    Specify disk format:
*   Other  $39     Other   $6   *
*                               *       [ ]  3.5-inch    [ ]  5.25-inch
*********************************
                                     Method of payment:

                                        [ ] payment enclosed
                                        [ ] Visa or MasterCard
                                        [ ] COD
                                        [ ] purchase order # _________________
For credit card orders only:

Card number: ____________________________________  Expiration date: __________

Signature:   _________________________________________________________________