3D-Scapev1.02

a 3Dtop Plugin by BoneS @ 2001
 

---

Operating Instructions
Bedienungsanleitung
Mode d’emploi
Gebruiksaanwijzing
Istructioni per l’uso
Instrucciones de manejo
Modo de emprego
Betjeningsvejledning
Bruksanvisning
Kayttoohje
Odhgiex yrhdevx
 

---

A logical addition to the plugin From8-80 was to have some kind of method to make more complex objects. One of the techniques in 3D world is the so called bump map, that add per point of the object an offset, that is taken out of a height map.
3D-Scape does just that, the height map is converted out of an ordinary BMP bit map file.
The heights are calculated from the luminance of the BMP colors, the brighter the color, the higher the map.

It should be noted that to get really good results increase the number of divisions the object is made of (menu: FINER), this takes allot of CPU and OpenGL power, but if you have it,

• At Start up
• The Menu
• Keyboard shortcuts
• The 880 file's
• Tips and tricks
• Change From Previous Versions

On loading the 3DScape.dll PLugin, The Plugin try's to open a file named defscp00.880 in which the last scene was saved. When this file doesn't exist, it makes a white sphere without any skin.
Every time the plugin quits, or 3Dtop quits, it will save the scene for you in defscp00.880, so it will start next time as you left it.
This Plugin can be loaded more times, it then creates more defscpXX.880 files, where XX is the number of the starting sequence, so defscp00.880, for the first, defscp01.880, for the second .... ( remember this !! )
 

You can move the object as any object in 3Dtop ,
clicking with the right button on one of the blocks will popup 3Dscape's Menu:

For accessing the 3Dtop menu ( spinning, reload etc. ) press the shift key as well as the Right Mouse Button.

 
To make it simple, there are no keyboard shortcuts !

 
Now the handy part:
The Saved scene file is a text file in which you can enter , copy and paste, more blocks,
or change the block's origin size etc.
Here's the format:
880 //always first, its the file id !!(note 3)
Then per Block:
//kind: origin[x,y,z]: size[x,y,z]: rotation[x,y,z]: color[R,G,B] texture file: density:
SPHERE ORG[+0.00,+0.00,+0.00] SIZE[+2.00,+1.00,+1.00] ROT[0.00,0.00,0.00] RGB[+0.90,+0.70,+0.50] TEXTURE[ ] DENS[1.00]
First the kind of block: PLANE(note 1), SPHERE (note 1)
Then the block's origin: ORG[ x, y, z ]
The block's Size: SIZE[ x, y, z ]
The rotation angle: ROT[ around x, y, z ]
The Block's color: RGB [ red, green, blue ] value's between 0.0 and 1.0
The Material Texture image file: TEXTURE[ path/filename ] ( only *.BMP or *.JPG ) ( note 2 )
The material's density: DENS[ number ] the value defines the number of times the texture is mapped, so 0.5 is see a quarter of the texture image( 0.5 by 0.5), 2.0 is see the texture twice in vertical and twice in horizontal ( 2 by 2 ).
The Skin or Bump image file: SKIN[ path/filename ] ( only *.BMP or *.JPG ) ( note 2 )
The skin's scale: SKINSCALE[ number ] the value defines offset scale calculated on the objects points.
Finally a so called SHORTCUT[ path/filename ] that makes the object a shortcut to a file or program.( note 2 )
The Translucent parameter TRANS[ 0 or 1 ].Only on = 1 and off = 0 are supported.

All item's can be separated by space or tab's, but have to be on 1 line.
Comments are on C++ style with // in front , rest of line is comment:
// this is comment
Best is to copy the 880 file and, cut/copy/paste yourself a new world.
Note 1:

The SPHERE and PLANE have an extension number for choosing the number of
subdivisions of the object, so SPHERE8 has 8 subdivisions in stead of the standard 24
 

Note 2:

The Material Texture and Skin  Filename is a relative path , relative to the directory of the plugin
this way you can move the plugin and texture folder to an other drive or folder, as long as there relative position stays
the same.

Note 3:

If you are familiar with the plugin From8-80 you know this format already.
Version V1.2 of this plugin has also the SKIN capability's as a viewer, so you can load the defscp00.880 file or copy the line from it to any *.880 file and load them with From8-80.
 

• Loading the same Material image as Skin image gets good results
• Better to make the Skin image out of the Material image by converting it to gray scale and then change the height by the degree of gray.
• Making you're own skin image is easier in gray scale's than in color.
• If you have a picture of your self, Skin it on a SPHERE and horror
• Most Fractal programs can export to BMP/JPEG bit maps.

since V1.0: There where a few bugs when starting the plugin more then once and setting the reload flag.
since V1.01:

    Very Big Change:

• Lines in 880 files can now be more then 256 characters, a lot of crashes where due to this bug.
• Every Filename in the 880 files are now relative to the 3DScape.DLL directory.

The used files are therefore moveable to other drives, as long as the relative path to the plugin DLL stays the same.
• The path of the 880 file in Icon3D.dat is now relative to the icon3d.dat directory.

The 880 files are therefore moveable to other drives, as long as the relative path to the ICON3D.DAT file stays the same.
• When Creating a new world in 3DTop, every dll that was marked 'reload', will be opened in the new world to, and the 880 files are loaded from the previous directory, but saved in the new directory, so you get an

exact copy of the previous world. This is done only at creating, at entering the new world, the 880 file in
that world is normally loaded.
• Both Material and Skin images can now be Windows BMP's or JPEG images.
• Added a Translucent function to the menu. This is a nice effect to see through the object, so looking like glass or water. You can change the degree of translucency by changing the object's color: darker colors are more translucence.