home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / 3 / 3d120.zip / 3D.DOC < prev    next >
Text File  |  1992-08-08  |  16KB  |  310 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11.  3D environment program documentation   : 3D.DOC
  12.  LAST UPDATE                            : Aug 03, 1992.
  13.  RELEASE No.                            : 1.2 
  14.  
  15. *******************************************************************************
  16. *                                     3D                                      *
  17. *******************************************************************************
  18.  
  19.  
  20.                                  FILE - LIST
  21.                                  -----------
  22.  
  23.   The distribution file contains the following files :
  24.  
  25.       3D.EXE            - 3D environment program executable.
  26.       3D.HLP            - 3D on-line help file.
  27.       README.WWT        - WWToolKit description.
  28.       3D.DOC            - This file.
  29.       3D.REG            - Registration file.
  30.       *.M3D             - 3D macro files.
  31.       *.3D2             - Simple 3D object definition files.
  32.       *.3DS             - Complex 3D object definition files.
  33.       *.PAS             - Units required by the generated "compiled macros".
  34.       PROGRAMS.TXT      - ISoft D&M shareware products description.
  35.  
  36.                                   WHAT'S NEW
  37.                                   ----------
  38.  
  39.   - Version 1.2 uses overlays to reduce memory requirments. The 3D program
  40.    will run faster, and will not crash when huge super-vga windows are 
  41.    maniplated.
  42.  
  43.   - The object Open command will automatically enter Edit mode.
  44.  
  45.   - Better text appearance in line edit window, on VGA screens.
  46.  
  47.   - Version 1.11 was compiled using Turbo Pascal 6.0 - a change that will 
  48.    allow us to continue and support the 3D program. (It was a pain in the ..
  49.    to keep it on Turbo Pascal 5.5 that has a different heap managment
  50.    structure).
  51.  
  52.   - The macro language has been modified to include ',' characters between
  53.    arguments in commands that has multiple parameters (like the GOTO command).
  54.    This allows correct parsing of commands that pass negative arguments.
  55.    
  56.   - The macro language structure is now compatible with the syntax of the
  57.    3dC macro translator available in the 3dLib package from ISoft D&M.
  58.  
  59.   - Version 1.10 offers a better heap memory managment routine, VGA users
  60.    will not face the "Out of memory" message so frequently as did 
  61.    Version 1.00 users.
  62.  
  63.   - PC3270, 8514 and AT&T graphic users will need to use BGI drivers from
  64.    TP5.5, these drivers are no longer included in the code.
  65.  
  66.   - The source files required by the generated "Compiled" files are now
  67.    available within 3D110.
  68.  
  69.                                  INTRODUCTION
  70.                                  ------------
  71.  
  72.   3D is a GUI WWToolKit demo application, that is a companion to the
  73.  3dLib 3D library available from ISoft D&M.
  74.  
  75.  3D was written by Loewy Ron (LR) and Ishai Ben-Aroya (IBA) during 1990 - 1991, 
  76.  This program is distributed by ISoft D&M, and maintained (Since V1.0) by
  77.  Loewy Ron. From this version 3D is a shareware program, I found that I 
  78.  could not keep this program up to date when it was released to the public 
  79.  domain, In order to minimize the cost, the 3D environment program is free to 
  80.  registered users of the 3dLib package, but should be registered by
  81.  any other one that find it valuable. Please refer to the 3D.REG program
  82.  for details.
  83.  
  84.  
  85.   Please notice :
  86.  
  87.   The 3D source files (except WWToolKit sources) are available in the
  88.  3D120SRC archive file, if you want to try and compile the 3D program,
  89.  you will need the WWT11TPU archive file - for the WWToolKit units,
  90.  and probably also the WWT11DOC archive file, that contains documents
  91.  to these units.
  92.  
  93.  
  94.                                   What is 3D ?
  95.                                   ------------
  96.  
  97.   3D is an environment program that uses the WWToolKit GUI, to enable the
  98.  design, creation, study and use of 3D objects in a 3D object space, the
  99.  program includes a Graphic editor, an On-line test module, a graphic
  100.  based Text Editor, an animation macro language Interpreter, a macro to
  101.  Pascal compiler (translator), and (available separately in the 3D120SRC file)
  102.  Pascal library files, to create stand alone animation executables, from the
  103.  Pascal code created by the compiler.
  104.  
  105.   Turbo Pascal programmers that want to use the 3D engine used by the 3D 
  106.  program can use the 3dLib pacakge from ISoft D&M. This package includes
  107.  support for both Turbo Pascal for Dos and Turbo Pascal for Windows.
  108.  At the time that this file is written the 3dLib version available from
  109.  ISoft D&M is 1.2. Please notice - If you have 3dLib 1.1 you will be 
  110.  able to use the macros generated and tested with this package, but will
  111.  not be able to use them with Turbo Pascal for Windows.
  112.  
  113.  
  114.                                 User Interface 
  115.                                 --------------
  116.  
  117.   3D uses the WWToolKit GUI, the user interface is documented in the 
  118.  TOOLKIT.DOC file, in the WWT11DOC archive file, basically, this is a
  119.  windowed, menu - driven, mouse (and keyboard, if a mouse is not present)
  120.  desktop environment, The top of the screen (Desktop) contains the main 
  121.  program menu, from which drop down windows can be opened (using the mouse
  122.  or the F10 key on keyboard only systems) to choose (point and release)
  123.  program options, the desktop contains application windows, with a top
  124.  (active) window, by pointing with the mouse (or using the F6 key in keyboard
  125.  systems) - you can bring a window to the top of the desktop. A window may
  126.  contain controls (buttons), option lists, or other action elements. If the
  127.  application needs a response from the user it will open a dialogue-box, a 
  128.  non-removable window, that waits for some input from the user. Normal 
  129.  ( well.. market common ) conventions are used - re-sizing through the
  130.  bottom-right grow box (F9), closing through the top-left close box (F3), 
  131.  dragging - in the header line (Alt-F9), choosing by clicking, or 
  132.  double-clicking, as needed. Please notice - because this program was used to 
  133.  compile, develope and test the WWToolKit library, the right mouse button is 
  134.  used to terminate the program!.
  135.  (This item is discussed in the TOOLKIT.DOC file, in the WWT11DOC archive 
  136.  file). If you do not have access to the WWT11DOC file, you can get basic
  137.  explanation, by using the 3D on-line help windows, open a help window by
  138.  choosing a topic from the help menu, and double click on underlined items
  139.  of interest - to receive hyper-text help about the 3D program and user
  140.  interface.
  141.  
  142.  
  143.                                    OBJECTS
  144.                                    -------
  145.  
  146.   3D objects supported by the 3D program are wire-mesh objects, 
  147.  (no solid objects support in this version), there are 2 object types
  148.  defined by 3D - simple objects : wire mesh points and lines, and 
  149.  complex objects : sets of simple objects, with a common frame of reference.
  150.  3D defines an "active" object, all of the 3D object operations are performed
  151.  on this object, to set the "active" object - choose from the list created by
  152.  the ACTIVE option in the objects menu. Please notice - clicking on an 
  153.  object's edit window, loading an object, or testing it in the on-line
  154.  window automatically brings it to the top of the object list, and makes
  155.  it the "active" object. Use the LOAD option in the object menu to load an
  156.  object from disk to memory, please notice - simple objects are saved in
  157.  OBJNAME.3D2 files, while complex objects are saved in OBJNAME.3DS files.
  158.  When you load an object, no window is opened, choose the EDIT option in 
  159.  the objects menu to open a graphic editor window for the object. 
  160.  (notice that a simple object has 2 types of editors - points, and lines
  161.  editors). Use the NEW option from the objects menu to create new objects.
  162.  Please refer to the on-line help facility, or to the technical documentation
  163.  in the 3D110SRC archive file, objects are defined in the OBJECT3D.PAS,
  164.  SUPEROBJ.PAS, RTOBJ.PAS files, graphic editors are defined in the 
  165.  LINEWIND.PAS, PNTWIND.PAS and SEDTWIND.PAS files in the 3D111SRC archive.
  166.  
  167.  
  168.                                     MACROS
  169.                                     ------
  170.  
  171.  
  172.   Macros are 3D scripts that animate (used to create animation) 3D objects,
  173.  the macro language is described in the on-line help macros topic, and can be
  174.  found also in the technical documentation, and source files in the 
  175.  3D110SRC archive file. Use the 3D built in Text Editor, or any plain
  176.  ASCII text editor of your choice - to create macro files, 3D macro files
  177.  should carry the .M3D extension. (e.g. BOX3MV.M3D), use the macro menu
  178.  to manipulate the Text Editor text files. The run menu offers the 
  179.  INTERPRET option, that opens a window, and displays the animation
  180.  sequence defined in the "active" macro, (please refer to the objects "active"
  181.  description - the "active" macro has the same meaning for macro files), 
  182.  the macro can be debugged, and developed using the Text Editor, and the
  183.  INTERPRET option, use the COMPILE option from the run menu to create a 
  184.  Pascal source code, ready to be (Turbo - Pascal) compiled into a stand alone
  185.  3D animation EXE file. The macro text-editor is defined in the MCRWIND.PAS
  186.  file, and is a derived object of the TEXTWINDOW object of the WWToolKit
  187.  window, the macro language interpreter, and compiler are documented in the
  188.  INTERPER.PAS and CMPL3D.PAS - in the 3D111SRC archive file, some more 
  189.  animation consideration topics can be found in the PROJECT3.PAS, PRJWIND.PAS
  190.  and CTM3D.PAS files.
  191.  
  192.  
  193.                                    WARRANTY
  194.                                    --------
  195.  
  196.  
  197.   There is no warranty what so ever, The program is supplied as is,
  198.  The distributer (ISoft D&M), or the author (Loewy Ron), are not,
  199.  and will not be responsible for any damages, lost profits, 
  200.  or inconveniences caused by the use, or inability to use this package. 
  201.  The use of the package is at your own risk. 
  202.  By using (or attempting to use) the package you agree to this.
  203.  
  204.  
  205.  
  206.                                     General
  207.                                     -------
  208.  
  209.   3D is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  210.   
  211.   3D is (c) copyrighted by Loewy Ron, 1991, 92.
  212.  
  213.   3D is a shareware package, please register your copy. 
  214.   To register your copy of 3D please refer to the supplied
  215.   3D.REG file. 
  216.  
  217.   Other programs distributed by ISoft D&M are described in the supplied  
  218.   PROGRAMS.TXT file.
  219.  
  220.                                    CONTACT
  221.                                    -------
  222.  
  223.  
  224.   Please contact :
  225.  
  226.   ISoft D&M,  
  227.   P.O.B 5517
  228.   Coralville IA 52241,
  229.   U.S.A
  230.  
  231.                                     History
  232.                                     -------
  233.  
  234.  
  235.   The 3D program had been written several times, before this ("version 1.20")
  236.  was released, The first 3D design, creation and test
  237.  program was created by LR, on an Apple //e, in 1984, written in BASIC,
  238.  some help from Paluda Oded (PO) - in mathematical definitions - was used
  239.  to create the 2.nd Apple implementation - that introduced the macro idea,
  240.  used self center of gravity to create relational frames, and used a basic
  241.  compiler (OOWWAOO) - to achieve faster execution time. LR used Turbo-Pascal
  242.  version 3.01, with the GRAPHIX TOOLBOX to learn Pascal and PC programming,
  243.  in 1988, the result 3D program was never released, and supported only
  244.  integer math, keyboard interface, and HGC graphic adapter. (No CGA version 
  245.  pal, sorry). With Turbo-Pascal 4.0 a new - BGI version was created by LR,
  246.  and was renamed THREE_D, this version still used keyboard interface, however
  247.  the window system did not use the GRAPHIX TOOLBOX, THREE_D version 1.10
  248.  replaced the integer math, with a real math version, and version 1.20
  249.  introduced (along with Turbo-Pascal 5.0) the macro to Pascal compiler.
  250.  Versions 1.23 to 1.25 were for a short time distributed in the U.K. as a
  251.  shareware product. From FEB 1990, IBA joined LR to rewrite the entire
  252.  3D program (renamed again to 3D) using OOPS technology, and Turbo-Pascal 5.5,
  253.  The new 3D program was used as a test bed to the new LR & IBA developed
  254.  GUI - WWToolKit. Because the 3D program was big enough, and complex enough
  255.  to test and build most of the ideas in the WWToolKit library, many WWToolKit
  256.  files still carry the something3D name, (like the WINDOW3D window unit file).
  257.  This version was re-worked, and released as version 1.00 on SEP 1990. Minor
  258.  changes to the WWToolKit library were made during OCT, and NOV 1990, and the
  259.  3D program had to wait for the documentation file (this file), before
  260.  it could be released to BBS, and FTP sites. Some users complained about VGA
  261.  systems that crashed because of lack of memory, version 1.10 improves this
  262.  situation by using a smarter heap managment error routine, that will lead 
  263.  to slower window re-draws, but will consume less memory. This fix is 
  264.  acceptable because 3D 1.00 was written on a 10 MHz XT machine with a HGC
  265.  card, and needed any bit of performance it could get, if you use an XT
  266.  machine with a VGA display - you are in trouble, however, any AT or 386
  267.  machine will perform resonably. (My 286 AT and 386-33 AT run this version
  268.  fast enough). Version 1.11 is again a shareware product - LR found he could
  269.  not support this program without some help from the users. From this version
  270.  3D is distributed by ISoft D&M. This version was converted to Turbo Pascal 6.0
  271.  in order to support it in the future.
  272.  
  273.  A Macintosh version was written by LR during 1989, using .. Turbo-Pascal, 
  274.  but was never debugged to be considered anything more then a test project.
  275.  
  276.  WWToolKit is a copyright of Loewy Ron & Ishai Ben-Aroya.
  277.  PC is a trademark of International Business Machines.
  278.  Apple, Apple //e and Macintosh are trademarks of APPLE Computer Inc.
  279.  Turbo-Pascal (V3.0, 4.0, 5.0, 5.5, 6.0) and GRAPHIX TOOLBOX are copyrights and
  280.   trademarks of BORLAND INTL'. LTD.
  281.  Turbo Pascal for Windows is a copyright of Borland International.
  282.  
  283.  Other products or registered names mentioned are trademarks, or copyrights
  284.  of their respective trademark/copyright holders/owners.
  285.  
  286.  
  287.      ██      ∙          ██      ██                 ██          ∙
  288.     ▓▓█                ▓▓█     ▓▓█   ∙           ▓▓█      ∙
  289.    ▒▒▓█    ∙    ∙     ▒▒▓█    ▒▒▓█               ▒▒▓█    ∙          ■
  290.   ░░▒▓██      ███    ░░▒▓█   ░░▒▓██      ███    ░░▒▓█         ∙
  291.   ░░▒▓▓█     ▓▓▓█    ░░▒▓█   ░░▒▓▓█     ▓▓▓█    ░░▒▓█   ∙
  292.   ░░▒▒▓██   ▒▒▒▓██  ░░▒▓█    ░░▒▒▓██   ▒▒▒▓██  ░░▒▓█               ·    ■
  293.    ░░▒▓▓██ ░░░▒▓▓██ ░░▒▓█     ░░▒▓▓██ ░░░▒▓▓██ ░░▒▓█                        ·
  294.    ░░▒▒▓▓█░░▒░░▒▓▓█ ░░▒▓█     ░░▒▒▓▓█░░▒░░▒▓▓█ ░░▒▓█   ·      ·
  295. ∙   ░░▒▒▓░░▒▓█░░▒▓▓░░▒▓█       ░░▒▒▓░░▒▓█░░▒▓▓░░▒▓█
  296.      ░░▒░░▒▓█  ░░▒░░▒▓█         ░░▒░░▒▓█  ░░▒░░▒▓█
  297.       ░░░▒▓█    ░░░▒▓█          ░░░▒▓█    ░░░▒▓█          ·               ·
  298.                                                       ·
  299.   ∙                                                           ·
  300.                   ∙                ·         ·                   ·
  301.                               ·            ▀▄▀▄▀▄ ·   ▀▄▀▄▀▄              ·
  302.     ∙                                            ▄▀    ▀▄    ▀▄  ·
  303.                               ·        ·        ▀▄   · ▀▄  · ▀▄         ·
  304.            ·       ∙             ·           ▄ ▄ ▄▀    ▀▄ ▄ ▄▀
  305.                        ∙      ·             ▀ ▀ ▀      ▀ ▀ ▀
  306.         ·     ·                            ·          · ·          ·  ·
  307.                           ∙                       ·
  308.     · The 3D environment program. ·                    ·        ·
  309. 
  310.