Home » Archimedes archive » Acorn User » AU 1996-01.adf » TopModel » !TMViewer/Docs/Help

!TMViewer/Docs/Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1996-01.adf » TopModel
Filename: !TMViewer/Docs/Help
Read OK:
File size: 0A3E bytes
Load address: 0000
Exec address: 0000
File contents
--------------- TMViewer instructions -----------------

Welcome to this new exciting 3D environment. !TMViewer
is only a viewer of TopModel files (type 3DModel, &B5C)
and implements a small part of its graphic engine. You
can run !TMViewer by double-clicking on the application
directory, or by double-clicking on one of the supplied
TopModel files. Then you are presented with a dialogue
box for memory setup. Once TMViewer is loaded you can
only load files, add some library objects and modify
view parameters (zoom, pan, rotation and view style).
Main short-cuts are:

  CTRL+Select     :zoom IN/OUT
  CTRL+Adjust     :rotate view
  CTRL+SHIFT+Menu :pan IN/OUT

All other combinations and movements are disabled, so
navigation in the scene is not as comfortable as it is
in TopModel. When in shaded wireframe or in any of the
two Gouraud style modes, TMViewer uses the first
default material (plastic) to calculate light
contribute. In these modes you only have frontal and
ambiental lights. You should activate the option
"Calculate Reflection" in the "Setup Light Parameter"
dialogue box, to enable the real-time recalculation of
reflected light. If you choose Phong view style, then
you can have a feedback of each object attributes. Last
but not least, when you are in any of 256 colour modes,
you can choose the true-colour view mode in which the
graphic engine shows you the real colours of objects
(in all the other modes you work using one of the 16
logical colour TopModel manages) and deals with
materials and with any coloured light activated. It
also allows user defined trasparencies. At the end of
the view style selector you find the possibility to
enable textures (if any) or trasparency (if any). On
the vertical pane you can find all the buttons required
to modify the view, to visualize axis, grid and so on.
Watch carefully the on-line help to discover all the
possibilities TMViewer has. As far as the main bar is
concerned, we have left the main tools to show you some
of TopModel's features. You can only add objects from
libraries, dragging them from the creation pane.
TMViewer loads any texture present in the scene files
using ChangeFSI, so there must be enough memory to
perform this task, otherwise some of the textures may
not be loaded.

Please note:if you run !TMViewer on any version of
            RISC OS less than 3.5 (i.e. you do not have
            a Risc PC) then system sprite area will be
            corrupted, and this may cause some other
            applications to hang (for ex. SparkFS which
            uses the same area...)

�1995/96 Sincronia Soluzioni Multimediali
00000000  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 20  |--------------- |
00000010  54 4d 56 69 65 77 65 72  20 69 6e 73 74 72 75 63  |TMViewer instruc|
00000020  74 69 6f 6e 73 20 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |tions ----------|
00000030  2d 2d 2d 2d 2d 2d 2d 0a  0a 57 65 6c 63 6f 6d 65  |-------..Welcome|
00000040  20 74 6f 20 74 68 69 73  20 6e 65 77 20 65 78 63  | to this new exc|
00000050  69 74 69 6e 67 20 33 44  20 65 6e 76 69 72 6f 6e  |iting 3D environ|
00000060  6d 65 6e 74 2e 20 21 54  4d 56 69 65 77 65 72 0a  |ment. !TMViewer.|
00000070  69 73 20 6f 6e 6c 79 20  61 20 76 69 65 77 65 72  |is only a viewer|
00000080  20 6f 66 20 54 6f 70 4d  6f 64 65 6c 20 66 69 6c  | of TopModel fil|
00000090  65 73 20 28 74 79 70 65  20 33 44 4d 6f 64 65 6c  |es (type 3DModel|
000000a0  2c 20 26 42 35 43 29 0a  61 6e 64 20 69 6d 70 6c  |, &B5C).and impl|
000000b0  65 6d 65 6e 74 73 20 61  20 73 6d 61 6c 6c 20 70  |ements a small p|
000000c0  61 72 74 20 6f 66 20 69  74 73 20 67 72 61 70 68  |art of its graph|
000000d0  69 63 20 65 6e 67 69 6e  65 2e 20 59 6f 75 0a 63  |ic engine. You.c|
000000e0  61 6e 20 72 75 6e 20 21  54 4d 56 69 65 77 65 72  |an run !TMViewer|
000000f0  20 62 79 20 64 6f 75 62  6c 65 2d 63 6c 69 63 6b  | by double-click|
00000100  69 6e 67 20 6f 6e 20 74  68 65 20 61 70 70 6c 69  |ing on the appli|
00000110  63 61 74 69 6f 6e 0a 64  69 72 65 63 74 6f 72 79  |cation.directory|
00000120  2c 20 6f 72 20 62 79 20  64 6f 75 62 6c 65 2d 63  |, or by double-c|
00000130  6c 69 63 6b 69 6e 67 20  6f 6e 20 6f 6e 65 20 6f  |licking on one o|
00000140  66 20 74 68 65 20 73 75  70 70 6c 69 65 64 0a 54  |f the supplied.T|
00000150  6f 70 4d 6f 64 65 6c 20  66 69 6c 65 73 2e 20 54  |opModel files. T|
00000160  68 65 6e 20 79 6f 75 20  61 72 65 20 70 72 65 73  |hen you are pres|
00000170  65 6e 74 65 64 20 77 69  74 68 20 61 20 64 69 61  |ented with a dia|
00000180  6c 6f 67 75 65 0a 62 6f  78 20 66 6f 72 20 6d 65  |logue.box for me|
00000190  6d 6f 72 79 20 73 65 74  75 70 2e 20 4f 6e 63 65  |mory setup. Once|
000001a0  20 54 4d 56 69 65 77 65  72 20 69 73 20 6c 6f 61  | TMViewer is loa|
000001b0  64 65 64 20 79 6f 75 20  63 61 6e 0a 6f 6e 6c 79  |ded you can.only|
000001c0  20 6c 6f 61 64 20 66 69  6c 65 73 2c 20 61 64 64  | load files, add|
000001d0  20 73 6f 6d 65 20 6c 69  62 72 61 72 79 20 6f 62  | some library ob|
000001e0  6a 65 63 74 73 20 61 6e  64 20 6d 6f 64 69 66 79  |jects and modify|
000001f0  0a 76 69 65 77 20 70 61  72 61 6d 65 74 65 72 73  |.view parameters|
00000200  20 28 7a 6f 6f 6d 2c 20  70 61 6e 2c 20 72 6f 74  | (zoom, pan, rot|
00000210  61 74 69 6f 6e 20 61 6e  64 20 76 69 65 77 20 73  |ation and view s|
00000220  74 79 6c 65 29 2e 0a 4d  61 69 6e 20 73 68 6f 72  |tyle)..Main shor|
00000230  74 2d 63 75 74 73 20 61  72 65 3a 0a 0a 20 20 43  |t-cuts are:..  C|
00000240  54 52 4c 2b 53 65 6c 65  63 74 20 20 20 20 20 3a  |TRL+Select     :|
00000250  7a 6f 6f 6d 20 49 4e 2f  4f 55 54 0a 20 20 43 54  |zoom IN/OUT.  CT|
00000260  52 4c 2b 41 64 6a 75 73  74 20 20 20 20 20 3a 72  |RL+Adjust     :r|
00000270  6f 74 61 74 65 20 76 69  65 77 0a 20 20 43 54 52  |otate view.  CTR|
00000280  4c 2b 53 48 49 46 54 2b  4d 65 6e 75 20 3a 70 61  |L+SHIFT+Menu :pa|
00000290  6e 20 49 4e 2f 4f 55 54  0a 0a 41 6c 6c 20 6f 74  |n IN/OUT..All ot|
000002a0  68 65 72 20 63 6f 6d 62  69 6e 61 74 69 6f 6e 73  |her combinations|
000002b0  20 61 6e 64 20 6d 6f 76  65 6d 65 6e 74 73 20 61  | and movements a|
000002c0  72 65 20 64 69 73 61 62  6c 65 64 2c 20 73 6f 0a  |re disabled, so.|
000002d0  6e 61 76 69 67 61 74 69  6f 6e 20 69 6e 20 74 68  |navigation in th|
000002e0  65 20 73 63 65 6e 65 20  69 73 20 6e 6f 74 20 61  |e scene is not a|
000002f0  73 20 63 6f 6d 66 6f 72  74 61 62 6c 65 20 61 73  |s comfortable as|
00000300  20 69 74 20 69 73 0a 69  6e 20 54 6f 70 4d 6f 64  | it is.in TopMod|
00000310  65 6c 2e 20 57 68 65 6e  20 69 6e 20 73 68 61 64  |el. When in shad|
00000320  65 64 20 77 69 72 65 66  72 61 6d 65 20 6f 72 20  |ed wireframe or |
00000330  69 6e 20 61 6e 79 20 6f  66 20 74 68 65 0a 74 77  |in any of the.tw|
00000340  6f 20 47 6f 75 72 61 75  64 20 73 74 79 6c 65 20  |o Gouraud style |
00000350  6d 6f 64 65 73 2c 20 54  4d 56 69 65 77 65 72 20  |modes, TMViewer |
00000360  75 73 65 73 20 74 68 65  20 66 69 72 73 74 0a 64  |uses the first.d|
00000370  65 66 61 75 6c 74 20 6d  61 74 65 72 69 61 6c 20  |efault material |
00000380  28 70 6c 61 73 74 69 63  29 20 74 6f 20 63 61 6c  |(plastic) to cal|
00000390  63 75 6c 61 74 65 20 6c  69 67 68 74 0a 63 6f 6e  |culate light.con|
000003a0  74 72 69 62 75 74 65 2e  20 49 6e 20 74 68 65 73  |tribute. In thes|
000003b0  65 20 6d 6f 64 65 73 20  79 6f 75 20 6f 6e 6c 79  |e modes you only|
000003c0  20 68 61 76 65 20 66 72  6f 6e 74 61 6c 20 61 6e  | have frontal an|
000003d0  64 0a 61 6d 62 69 65 6e  74 61 6c 20 6c 69 67 68  |d.ambiental ligh|
000003e0  74 73 2e 20 59 6f 75 20  73 68 6f 75 6c 64 20 61  |ts. You should a|
000003f0  63 74 69 76 61 74 65 20  74 68 65 20 6f 70 74 69  |ctivate the opti|
00000400  6f 6e 0a 22 43 61 6c 63  75 6c 61 74 65 20 52 65  |on."Calculate Re|
00000410  66 6c 65 63 74 69 6f 6e  22 20 69 6e 20 74 68 65  |flection" in the|
00000420  20 22 53 65 74 75 70 20  4c 69 67 68 74 20 50 61  | "Setup Light Pa|
00000430  72 61 6d 65 74 65 72 22  0a 64 69 61 6c 6f 67 75  |rameter".dialogu|
00000440  65 20 62 6f 78 2c 20 74  6f 20 65 6e 61 62 6c 65  |e box, to enable|
00000450  20 74 68 65 20 72 65 61  6c 2d 74 69 6d 65 20 72  | the real-time r|
00000460  65 63 61 6c 63 75 6c 61  74 69 6f 6e 20 6f 66 0a  |ecalculation of.|
00000470  72 65 66 6c 65 63 74 65  64 20 6c 69 67 68 74 2e  |reflected light.|
00000480  20 49 66 20 79 6f 75 20  63 68 6f 6f 73 65 20 50  | If you choose P|
00000490  68 6f 6e 67 20 76 69 65  77 20 73 74 79 6c 65 2c  |hong view style,|
000004a0  20 74 68 65 6e 0a 79 6f  75 20 63 61 6e 20 68 61  | then.you can ha|
000004b0  76 65 20 61 20 66 65 65  64 62 61 63 6b 20 6f 66  |ve a feedback of|
000004c0  20 65 61 63 68 20 6f 62  6a 65 63 74 20 61 74 74  | each object att|
000004d0  72 69 62 75 74 65 73 2e  20 4c 61 73 74 0a 62 75  |ributes. Last.bu|
000004e0  74 20 6e 6f 74 20 6c 65  61 73 74 2c 20 77 68 65  |t not least, whe|
000004f0  6e 20 79 6f 75 20 61 72  65 20 69 6e 20 61 6e 79  |n you are in any|
00000500  20 6f 66 20 32 35 36 20  63 6f 6c 6f 75 72 20 6d  | of 256 colour m|
00000510  6f 64 65 73 2c 0a 79 6f  75 20 63 61 6e 20 63 68  |odes,.you can ch|
00000520  6f 6f 73 65 20 74 68 65  20 74 72 75 65 2d 63 6f  |oose the true-co|
00000530  6c 6f 75 72 20 76 69 65  77 20 6d 6f 64 65 20 69  |lour view mode i|
00000540  6e 20 77 68 69 63 68 20  74 68 65 0a 67 72 61 70  |n which the.grap|
00000550  68 69 63 20 65 6e 67 69  6e 65 20 73 68 6f 77 73  |hic engine shows|
00000560  20 79 6f 75 20 74 68 65  20 72 65 61 6c 20 63 6f  | you the real co|
00000570  6c 6f 75 72 73 20 6f 66  20 6f 62 6a 65 63 74 73  |lours of objects|
00000580  0a 28 69 6e 20 61 6c 6c  20 74 68 65 20 6f 74 68  |.(in all the oth|
00000590  65 72 20 6d 6f 64 65 73  20 79 6f 75 20 77 6f 72  |er modes you wor|
000005a0  6b 20 75 73 69 6e 67 20  6f 6e 65 20 6f 66 20 74  |k using one of t|
000005b0  68 65 20 31 36 0a 6c 6f  67 69 63 61 6c 20 63 6f  |he 16.logical co|
000005c0  6c 6f 75 72 20 54 6f 70  4d 6f 64 65 6c 20 6d 61  |lour TopModel ma|
000005d0  6e 61 67 65 73 29 20 61  6e 64 20 64 65 61 6c 73  |nages) and deals|
000005e0  20 77 69 74 68 0a 6d 61  74 65 72 69 61 6c 73 20  | with.materials |
000005f0  61 6e 64 20 77 69 74 68  20 61 6e 79 20 63 6f 6c  |and with any col|
00000600  6f 75 72 65 64 20 6c 69  67 68 74 20 61 63 74 69  |oured light acti|
00000610  76 61 74 65 64 2e 20 49  74 0a 61 6c 73 6f 20 61  |vated. It.also a|
00000620  6c 6c 6f 77 73 20 75 73  65 72 20 64 65 66 69 6e  |llows user defin|
00000630  65 64 20 74 72 61 73 70  61 72 65 6e 63 69 65 73  |ed trasparencies|
00000640  2e 20 41 74 20 74 68 65  20 65 6e 64 20 6f 66 0a  |. At the end of.|
00000650  74 68 65 20 76 69 65 77  20 73 74 79 6c 65 20 73  |the view style s|
00000660  65 6c 65 63 74 6f 72 20  79 6f 75 20 66 69 6e 64  |elector you find|
00000670  20 74 68 65 20 70 6f 73  73 69 62 69 6c 69 74 79  | the possibility|
00000680  20 74 6f 0a 65 6e 61 62  6c 65 20 74 65 78 74 75  | to.enable textu|
00000690  72 65 73 20 28 69 66 20  61 6e 79 29 20 6f 72 20  |res (if any) or |
000006a0  74 72 61 73 70 61 72 65  6e 63 79 20 28 69 66 20  |trasparency (if |
000006b0  61 6e 79 29 2e 20 4f 6e  0a 74 68 65 20 76 65 72  |any). On.the ver|
000006c0  74 69 63 61 6c 20 70 61  6e 65 20 79 6f 75 20 63  |tical pane you c|
000006d0  61 6e 20 66 69 6e 64 20  61 6c 6c 20 74 68 65 20  |an find all the |
000006e0  62 75 74 74 6f 6e 73 20  72 65 71 75 69 72 65 64  |buttons required|
000006f0  0a 74 6f 20 6d 6f 64 69  66 79 20 74 68 65 20 76  |.to modify the v|
00000700  69 65 77 2c 20 74 6f 20  76 69 73 75 61 6c 69 7a  |iew, to visualiz|
00000710  65 20 61 78 69 73 2c 20  67 72 69 64 20 61 6e 64  |e axis, grid and|
00000720  20 73 6f 20 6f 6e 2e 0a  57 61 74 63 68 20 63 61  | so on..Watch ca|
00000730  72 65 66 75 6c 6c 79 20  74 68 65 20 6f 6e 2d 6c  |refully the on-l|
00000740  69 6e 65 20 68 65 6c 70  20 74 6f 20 64 69 73 63  |ine help to disc|
00000750  6f 76 65 72 20 61 6c 6c  20 74 68 65 0a 70 6f 73  |over all the.pos|
00000760  73 69 62 69 6c 69 74 69  65 73 20 54 4d 56 69 65  |sibilities TMVie|
00000770  77 65 72 20 68 61 73 2e  20 41 73 20 66 61 72 20  |wer has. As far |
00000780  61 73 20 74 68 65 20 6d  61 69 6e 20 62 61 72 20  |as the main bar |
00000790  69 73 0a 63 6f 6e 63 65  72 6e 65 64 2c 20 77 65  |is.concerned, we|
000007a0  20 68 61 76 65 20 6c 65  66 74 20 74 68 65 20 6d  | have left the m|
000007b0  61 69 6e 20 74 6f 6f 6c  73 20 74 6f 20 73 68 6f  |ain tools to sho|
000007c0  77 20 79 6f 75 20 73 6f  6d 65 0a 6f 66 20 54 6f  |w you some.of To|
000007d0  70 4d 6f 64 65 6c 27 73  20 66 65 61 74 75 72 65  |pModel's feature|
000007e0  73 2e 20 59 6f 75 20 63  61 6e 20 6f 6e 6c 79 20  |s. You can only |
000007f0  61 64 64 20 6f 62 6a 65  63 74 73 20 66 72 6f 6d  |add objects from|
00000800  0a 6c 69 62 72 61 72 69  65 73 2c 20 64 72 61 67  |.libraries, drag|
00000810  67 69 6e 67 20 74 68 65  6d 20 66 72 6f 6d 20 74  |ging them from t|
00000820  68 65 20 63 72 65 61 74  69 6f 6e 20 70 61 6e 65  |he creation pane|
00000830  2e 0a 54 4d 56 69 65 77  65 72 20 6c 6f 61 64 73  |..TMViewer loads|
00000840  20 61 6e 79 20 74 65 78  74 75 72 65 20 70 72 65  | any texture pre|
00000850  73 65 6e 74 20 69 6e 20  74 68 65 20 73 63 65 6e  |sent in the scen|
00000860  65 20 66 69 6c 65 73 0a  75 73 69 6e 67 20 43 68  |e files.using Ch|
00000870  61 6e 67 65 46 53 49 2c  20 73 6f 20 74 68 65 72  |angeFSI, so ther|
00000880  65 20 6d 75 73 74 20 62  65 20 65 6e 6f 75 67 68  |e must be enough|
00000890  20 6d 65 6d 6f 72 79 20  74 6f 0a 70 65 72 66 6f  | memory to.perfo|
000008a0  72 6d 20 74 68 69 73 20  74 61 73 6b 2c 20 6f 74  |rm this task, ot|
000008b0  68 65 72 77 69 73 65 20  73 6f 6d 65 20 6f 66 20  |herwise some of |
000008c0  74 68 65 20 74 65 78 74  75 72 65 73 20 6d 61 79  |the textures may|
000008d0  0a 6e 6f 74 20 62 65 20  6c 6f 61 64 65 64 2e 0a  |.not be loaded..|
000008e0  0a 50 6c 65 61 73 65 20  6e 6f 74 65 3a 69 66 20  |.Please note:if |
000008f0  79 6f 75 20 72 75 6e 20  21 54 4d 56 69 65 77 65  |you run !TMViewe|
00000900  72 20 6f 6e 20 61 6e 79  20 76 65 72 73 69 6f 6e  |r on any version|
00000910  20 6f 66 0a 20 20 20 20  20 20 20 20 20 20 20 20  | of.            |
00000920  52 49 53 43 20 4f 53 20  6c 65 73 73 20 74 68 61  |RISC OS less tha|
00000930  6e 20 33 2e 35 20 28 69  2e 65 2e 20 79 6f 75 20  |n 3.5 (i.e. you |
00000940  64 6f 20 6e 6f 74 20 68  61 76 65 0a 20 20 20 20  |do not have.    |
00000950  20 20 20 20 20 20 20 20  61 20 52 69 73 63 20 50  |        a Risc P|
00000960  43 29 20 74 68 65 6e 20  73 79 73 74 65 6d 20 73  |C) then system s|
00000970  70 72 69 74 65 20 61 72  65 61 20 77 69 6c 6c 20  |prite area will |
00000980  62 65 0a 20 20 20 20 20  20 20 20 20 20 20 20 63  |be.            c|
00000990  6f 72 72 75 70 74 65 64  2c 20 61 6e 64 20 74 68  |orrupted, and th|
000009a0  69 73 20 6d 61 79 20 63  61 75 73 65 20 73 6f 6d  |is may cause som|
000009b0  65 20 6f 74 68 65 72 0a  20 20 20 20 20 20 20 20  |e other.        |
000009c0  20 20 20 20 61 70 70 6c  69 63 61 74 69 6f 6e 73  |    applications|
000009d0  20 74 6f 20 68 61 6e 67  20 28 66 6f 72 20 65 78  | to hang (for ex|
000009e0  2e 20 53 70 61 72 6b 46  53 20 77 68 69 63 68 0a  |. SparkFS which.|
000009f0  20 20 20 20 20 20 20 20  20 20 20 20 75 73 65 73  |            uses|
00000a00  20 74 68 65 20 73 61 6d  65 20 61 72 65 61 2e 2e  | the same area..|
00000a10  2e 29 0a 0a a9 31 39 39  35 2f 39 36 20 53 69 6e  |.)...1995/96 Sin|
00000a20  63 72 6f 6e 69 61 20 53  6f 6c 75 7a 69 6f 6e 69  |cronia Soluzioni|
00000a30  20 4d 75 6c 74 69 6d 65  64 69 61 6c 69 0a        | Multimediali.|
00000a3e