==============================================================================
September 1st, 1989                                            Bernardo Zamora
==============================================================================


                        3DPLAYER.EXE  (Version 1.0)
                        ---------------------------



     IMPORTANT : Be sure to read the file READ.ME before proceeding
                 with this document.



=====================
Contents of this file
=====================



I   - Note by the author
II  - 3DPlayer sintax
III - Video Modes
IV  - Farewell



======================
I - Note by the author
======================


     This programs plays pre-recorded 3D animations. This 3D files
     were previously recorded with an spececial program still under
     developement. This animations are for your entertainment only,
     the main program cannot be obtained yet.


     All the original program was developed under the Turbo Pascal 5.0
     system. I thank Borland for the great environment they provide
     to develop programs.


     The program was fine-tuned to provide the fastest animations
     possible for any kind of adapter. There are TWO different
     animations possible, wire-frame and solid-model rendering.
     The solid-models are pre-recorded as 'pictures', and can
     only be played back in the same resolution and video-mode.
     The wire-frame animations can be played back at the best
     video-mode provided by your adapter. If you want to force
     a video mode please refer to the VIDEO-MODE table in
     chapter III.


     This document contains the sintaxis of all the parameters accepted
     by 3DPlayer V1.0. If you have any comments, please forward them
     to me. (Addressed provided at the end of this document).



============================
II - 3DPlayer command sintax
============================



   IMPORTANT : When first loaded, 3DPlayer auto-detects the adapter
               and video mode unless overriden by the 'mode' or
               'adapter' parameters.


   The sintax of the player is :


   3DPLAYER file_name repetitions [delay] [video_mode] [adapter]


    'file_name' is the name of the file to be 'played back'. Please
       type the COMPLETE FILE_NAME (name.ext). The only extensions
       accepted are ".ANI" or ".CUA".
       (ANI=wire_frame animation, CUA=solid_model animation).

     'repetitions' is an integer that tells the player the number
       of times the animation will be played. If it is 0, the
       animation will continue until the user presses a key.

     'delay' is the number of miliseconds between each frame. The default
       value is 20 msec. To keep the default value you can type "-1"

     'video_mode' overrides the auto-detected video_mode. Refer to
       the table in the next chapter to see which mode is supported
       by each adapter.

     'adapter' : overrides detected adapter.


EXAMPLES
========

     * To replay animation (wire-frame) "TEX" 4 times :
     3DPLAYER tex.ani 4

     * To play ZOOM.ANI 5 times in CGA mode (you have VGA) :
     3DPLAYER zoom.ani 5 -1 0 1

     * To replay TEX animation (solid_model) until keypress (it was
       recorded on CGA, so you have to OVERRIDE any other adapter & mode) :
     3DPLAYER tex.cua 0 -1 0 1


NOTE
====


       If the mode & adapter requested cannot be used, the PLAYER tries to
     use the highest video mode of the requested adapter. If the adapter
     doesn't respond, PLAYER uses the highest video mode for the detected
     adapter.




=================
III - Video Modes
=================



                  'Adapters and provided video modes'
                  -----------------------------------


Name of     ID= Number
Adapter     of adapter    Mode   Resolution  Explanation of mode
----------------------------------------------------------------------------------
CGA             1          0      320*200    uses black, light green,
                                             ligth red and yellow.
                           1      320*200    uses black, light blue, light
                                             magenta, white.
                           2      320*200    uses black, green, red and
                                             brown.
                           3      320*200    uses black, blue, magenta and
                                             light gray.
                           4      640*200    monochrome.
----------------------------------------------------------------------------------
MCGA            2          0      320*200    uses black, light green,
                                             ligth red and yellow.
                           1      320*200    uses black, light blue, light
                                             magenta, white.
                           2      320*200    uses black, green, red and
                                             brown.
                           3      320*200    uses black, blue, magenta and
                                             light gray.
                           4      640*200    monochrome.

                           5      640*480    monochrome.
----------------------------------------------------------------------------------
EGA             3          0      640*200    16 colors.

                           1      640*350    16 colors.

----------------------------------------------------------------------------------
EGA64           4          0      640*200    16 colors.

                           1      640*350    04 colors.
----------------------------------------------------------------------------------
EGAMono         5          0      640*350    monochrome.
----------------------------------------------------------------------------------
HercMono        7          0      720*348    monochrome.
----------------------------------------------------------------------------------
VGA             9          0      640*200    16 colors.

                           1      640*350    16 colors,

                           2      640*480    16 colors.
----------------------------------------------------------------------------------




=============
IV - Farewell
=============



+===========================================================================+
|  Any comments?                                                            |
|                                                                           |
|  Forward them to BITNET :                                                 |
|     Bernardo Zamora                                                       |
|     BL306971 at TECMTYVM (Monterrey - Mexico) or                          |
|     PL306971 at TECMTYVM (Monterrey - Mexico) or try asking for me in     |
|     EM304599 at VMTECMEX (Mexico City)                                    |
|                                                                           |
|  Or by mail :                                                             |
|     Bernardo Zamora,                                                      |
|     Paseo de la Herradura #126,                                           |
|     La Herradura,                                                         |
|     Mexico 53920, Mexico City.                                            |
|     MEXICO.                                                               |
|                                                                           |
|  Any mail delivered to my BITNET address will be answered. Thanks.        |
+===========================================================================+
