(c) AF&AR GROUP 3D Open System (3DOS) v3.01

Effects Overview

The 3DOS SDK contains a lot of visual effects.

More of 2D effects are in the scenes of the Buyan Island(castle,complex,gallery). Source texts of 2D effects are in the catalogue SDK/DEMOS. We took some of these effects from demos/intros. The name of authors are specified alongside the displaying of the effect. The installation of 2D effect to the 3D scene is not more difficult than the usual texture. Start the Visual Designer to assign an effect, and use the item 'The selection of an application'. Use the item 'The assignment of a covering for the light sources with textures' to assign the effect on a ray and on a projection of light .

You can see 3D effects in the 'galaxy kitchen' scene(kitchen.vrs) . You can find their source texts (and source texts for 2D) in the SDK section. 3D effect is a body of x-camera, i. e. the creating of the 3D effect is the creating of the controller of x-camera, and its installation is an installation of x-camera. Start Visual Builder to assign the 3D effect, and use the item 'The Installation of a X-camera'.


Cataloque of the 2D effects

Backview camera

Description: Backview camera

Source : back.cpp

Command line: DEMOS{BACKVIEW} [i] [interval]

  • interval - Sets the interval between the refreshment of the frame, default: 2.
  • i - Enables the inter frame linear interpolation.

Composite Effect

Description:

Two medias are merged for forming a composite surface or surfaces with the textured alpha channel.

Source : blend.cpp

Command line: DEMOS.DLL{BLEND} /pMEDIA [/aMEDIA] [/sMEDIA] [/ipn] [/isn]

  • /Pmedia - Sets the primary media (must be BGRA_SURFACE).
  • /Amedia - Sets the media for textured alpha channel (must be gradient SURFACE).
  • /Smedia - Sets the secondary media (must be PAL_SURFACE).
  • /IPn - Sets refresh interval of the primary surface(0-static).
  • /ISn - Sets refresh interval of the secondary or alpha surface.

Examples :

  • DEMOS.DLL{BLEND} /Pdemos.dll{smoke} /Sdemos.dll{flame}
  • DEMOS.DLL{BLEND} /Pp_girl5 /Ademos.dll{smoke}

Emboss Effect (MMX)

Description:

Two medias are blended for forming a emboss surface.

Source : emboss.cpp

Command line: DEMOS.DLL{emboss} /pMEDIA /sMEDIA [/in /rn /gn /bn /m /a /e]

  • /Pmedia - Sets the primary media.
  • /Smedia - Sets the secondary media.
  • /In - Sets refresh interval(0-static).
  • /Rn - Sets a red component of RGB balance(default:128)
  • /Gn - Sets a green component of RGB balance(default:128)
  • /Bn - Sets a blue component of RGB balance(default:128)
  • /m - Sets a type [*](default)
  • /a - Sets a type [+]
  • /e - Sets a type [=]

Examples :

Blobs

Description: It's the base effect of the beautiful merging of the 2 balls

Source : blobs.cpp blobasm.asm

Command line: demos{blobs}

BOBSHADE

Description: It's the effect 'fakedemo' by Carlos Hasan V.

Source : bobshade.cpp

Command line: demos{bobshade}

Bump Effect

Description: It's the effect of the relief mapping of the specific surface

Source : bump.cpp

Command line: DEMOS.DLL{Bump} [/tTEXT] [/sFONTSIZE] MEDIA

  • /tTEXT - Specifies the line of the text which will also be displayed in relief.
  • /sFONTSIZE - Sets the size of font.
  • MEDIA - Sets the media for mapping.

Examples :

Explosive Text

Description: It's the effect of destroying an inscription: 3DOS DEMO.

Source : chaos.cpp

Command line: demos{chaos}

Comets

Description: They are Blobs + Fire.

Source : blobs.cpp blobasm.asm

Command line: demos{chaos}

Desert

Description: It's the effect from DDG.

Source : desert.cpp

Command line: demos{desert}

Fire

Description: It's the Fire effect.

Source : fire.cpp

Command line: demos{fire}

FLAKES

Description: Spots run around and they are smoothed by Motion Blur and Blur.

Source : flakes.cpp

Command line: demos{flakes}

FLAME

Description: It's another fire. It is a variation of flakes...

Source : flakes.cpp

Command line: demos{flame}

FLYER

Description: It's the Voxel landscape by Andrea "6502" Griffini + the interactive shell.

Source : flyer.cpp

Command line: demos{flyer}

FRACTAL PLASMA

Description: The fractal plasma.

Source : frplasma.cpp : frplasm.asm

Command line: demos{frplasma}

LENS

Description: It's the effect of distortion of a surface by lens.

Source : lens.cpp lensdist.asm

Command line: demos.dll{LENS} [/R /G /B /A] media

  • /r,/g,/b,/a - BGRA surface components for distortion.
  • media - A picture for distortion.

LIGHTNING

Description: It's the lightning effect by Nelson Chu.

Source : lighting.cpp

Command line: demos{lighting}

LINES

Description: Flying lines are smoothed by Motion Blur and Blur.

Source : lines.cpp

Command line: demos{lines}

PLASMA

Description: The beautiful plasma is taken from 256byte intro by an unknown author.

Source : plasma.cpp plasm.asm

Command line: demos{plasma}

RAIN

Description: It's the effect from DDG.

Source : rain.cpp

Command line: demos{rain}

TEXT SCROLLER

Description: It's the scrolling of the ASCII text with some options.

Source : scroll.cpp

Command line: demos.dll{scroll} text_resource

  • text_resource - Specifies the text.

If the line begins with the symbol '$', then the further symbols are assumed as options:

  • rate=r r - Sets the rate of the scrolling in units of lines/sec(default 16).
  • screen= r g b r g b- Sets the background colour (default 255 255 255 ).
  • text = r g b r g b - Sets the colour of the font (default 0 0 0).
  • size =s s - Sets the size of the font (default 10).
  • pause =p p - Sets the pause in units of miliseconds.
  • media =m size x0 y0
    • m - Specifies the name of the media which will be shown in the left side near the text.
    • size- Recommends the size of the media (0- original).
    • x0 - Sets the displacment along the X axis.
    • y0 - Sets the displacment along the Y axis.

SHADEBOB

Description: It's the effect from DDG.

Source : shadebob.cpp

Command line: demos{shadebob}

SIMPLESKY

Description: It's a variation of the desert effect from DDG.

Source : desert.cpp

Command line: demos{simplesky}

SINE

Description: It's the effect of sinusoidal distortion of a surface.

Source : sine.cpp sinedist.asm

Command line: demos.dll{SINE} [/R /G /B /A] MEDIA

  • /r,/g,/b,/a - BGRA surface components for distortion.
  • media - A picture for distortion

SINLINE

Description: It's the effect from DDG.

Source : sineline.cpp

Command line: demos{sineline}

SMOKE

Description: It's the smoke effect from Fantasy (Fay).

Source : smoke.cpp dosmoke.asm

Command line: demos{smoke}

SPIRAL EFFECTS

Command line: demos{spiral0}

Command line: demos{spiral1}

Command line: demos{spiral2}

Command line: demos{spiral3}

Command line: demos{spiral4}

Command line: demos{spiral5}

Command line: demos{spiral6}

Command line: demos{spiral7}

Command line: demos{spiral8}

Command line: demos{spiral9}

Command line: demos{spiral10}

Command line: demos{spiral11}

Command line: demos{spiral12}

Command line: demos{spiral13}

Command line: demos{spiral14}

Command line: demos{spiral15}

Command line: demos{spiral16}

Command line: demos{spiral17}

Description: It's the family of the beautiful colour effects from MoNsTeR.

Source : spiral.cpp

STARS

Description: It's the effect of the flying stars.

Source : stars.cpp

Command line: demos{stars}

SWATER

Description: It's the effect of sinusoidal distortion of a surface.

Source : swater.cpp swatera.asm

Command line: demos.dll{swater} [/X /Y /W /H] MEDIA

  • /x,/y,/w,/h - Sets the left upper coordinate and size of distorting region.
  • MEDIA - Sets the picture for distortion

TORNADO

Description: It's the tornado effect from MoNsTeR.

Source : tornado.cpp

Command line: demos{tornado}

Circles on the Water

Description: It's circles on the water.

Source : water.cpp dowater.asm

Command line: demos.dll{water} MEDIA

  • MEDIA - Sets the gradient picture for distortion.

The Twisted Joint of an Image to the Centre.

Description: It's the twisted joint of an image to centre.

Source : xcir.cpp xlat1.asm

Command line: demos.dll{xcir} TEXTURE

  • TEXTURE - Sets the static texture.

XNEWSPIR

Description: It's the effect from DDG.

Source : XNEWSPIR.cpp xlat0.asm

Command line: demos{xnewspir}

XVORTEX

Description: It's the effect from DDG by Mega G. Baitoff.

Source : XVORTEX.cpp xlat2.asm

Command line: demos{xvortex}


Cataloque of the 3D effects

Effects based on the Marching Cubes Algorithm

common options

Metaballs

Description: They are beautiful flying balls

Source: metaballs.cpp

Command line vrlai.dll{metaballs} [options]

options:

  • /m{str} - Sets the covering
  • /l{n} - Sets the isolevel (default : 4096 , range: 1,65536 )
  • /d{n} - Sets the distance between nodes (default : 24, range: 8,1024 )
  • /r{n}- Sets the resolution (default : 16, range: 4,64 )
  • /e - Sets the chrome mapping in world system(default: local system)
  • /c{n} - Sets the charge (default : 64, range: 1,4096 )
  • /n{n} - Sets the number of metaballs (default : 4, range: 1, 8)
  • /r{n} - Sets the speed od rotation (default : 16, range: 0, 256)
  • /v - Visualizes the cube.

Example: vrlai.dll{metaballs} /n2

Visualisation of the 2D effect or picture

Description: Any 2D effect or a simple picture will be converted to the voxel form and it will be poligonized with using the marching cubes algorithm.

Source: image3d.cpp effect3d.cpp

Command line vrlai.dll{image3d} [common options /t{str} /n1 /n2 /n3]

  • /t{str} - Specifies the effect or the picture for visualization.
  • /n1 - Inverts colours.
  • /n2 - Doesn't update the image (for pictures).
  • /n3 - Sets the options: /n1 + /n2

Example: vrlai.dll{image3d} /tdemos{flame}/mdemos{comets}

3D Morphing of Symbols

Description: Each of the 2D symbol in the input string will be converted to the voxel form and they will be smoothly morphed to the next one. The result will be poligonized with using the marching cubes algorithm.

Source: type3d.cpp effect3d.cpp

Command line vrlai.dll{type3d} [common options /t{str}]

  • /t{str} - Specifies the

Example: vrlai.dll{type3d} </t3D OPEN SYSTEM>

Visualisation of 3D plasm

Description: It's the attempt of 3D visualization of 3d fire and 3d plasm.

Source: fire3d.cpp amorph3d.cpp effect3d.cpp

command lines:

Examples:

  • vrlai.dll{fire3d} /mdemos{comets}
  • vrlai.dll{amorph3d} /mlogo


Visualization of the Surface of the Type z=f(x,y,t)

Description: It's visualization of the surface of the type z=f(x,y,t)

Source: msurf.cpp isoterm.cpp expri.cpp

Command line vrlai.dll{msurf} [options ] {expression}

options:

  • /mt[str] - Sets the upper covering.
  • /mb[str] - Sets the lower covering.
  • /ms[str] - Sets the side covering.
  • /h{n} - Sets the thickness of a surface.
  • /lx{n} - Sets the size of a surface on X axis.
  • /ly{n} - Sets the size of a surface on Y axis.
  • /lz{n} - Sets the size of a surface on Z axis.
  • /nx{n} - Sets the number of the samples on x axis.
  • /ny{n} - Sets the number of the samples on y axis.
  • /t{n} - Sets the step of 't' variable in units of 1000 seconds.
  • /d{n} - Sets the number of the default function in the range from 0 to 22.
  • /c - Sets the environment covering.
  • /e - Opens the terminal.
  • /i[n] - Executes a slide show in interval determinated by n.
  • [expression] - Sets the mathimatical expression if the /d option is not set.

Logotype

Description: They're the recognition and convertion of the text string or the simple image to the 3D logotype.

Source: logo.cpp

Command line: vrlai{logo} [options]

options:

  • /m{str} - Sets the covering.
  • /sx|y|z{n}- Sets the scaling (default : 1,1,4).
  • /i{str} - Specifies the image for parsing.
  • /t{str} - Specifies the text for parsing.
  • /f{n} - Sets the font size.
  • /m{n}-min Sets the colour level for recognition.

Snake

Description: It's the snake/worm-like creation.

Source: snake.cpp

Command line: vrlai{csnake} [options]

options:

  • /nl{n} - Sets the number of coils (default: 8).
  • /nv{n} - Sets the number of coil vertices (default: 8).
  • /l{n} - Sets the length of the link (default: 64).
  • /r{n} - Sets the radius of the coil (default: 32).
  • /m{str} - Specifies the media (default: greymet).
  • /s{n} - Sets the media scale (default: 0).
  • /X{str} - Replays the program created in the Visual Recorder.
  • /x{str} - Replays the program (loop).

Example: vrlai{csnake} /nv4


Other Camera Controllers

The simple body loader

Source: SDK/AI/loader.cpp

Command line : vrlai{loader} {body}

walker

Source: SDK/AI/walker.cpp SDK/AI/walkwin.cpp

Command line : vrlai{walker} {body}

Remark: The walker has the control panel with the autopilot, map, etc. The key F12 is the default key of the activation of the panel.


Viewers and players

You can use any type of data as a 2D covering. If you create the viewer/player for this data type you must define it in the vrl.cfg file.

In the vrlgui.dll are defined such viewers/players:

AVI PLAYER - The player of AVI streams for the WINDOWS platform only.

Command line: vrlgui{VAVIPLAYER}[ /l /n /g] avi_file

SOUND PLAYER - The player of sounds.

Command line: vrlgui{VSNDPLAYER}snd_file

HTML VIEWER - The Viewer of the HTML Documents.

Command line: html.dll{VHTMLVIEWER} html_file

SCENE VIEWER - The Viewer of the 3DOS scenes.

Command line: vrlgui{VSCENEVIEWER}[ /s{scene} /p{x,y,z} /o{x0,y0,x1,y1,s} /w{win_name} /f{callback function} ] scene_file

Examples:

EXCURSION VIEWER - The Viewer of the excursions.

Command line: vrlgui{VDEMONSTRATION} [options]

See the description in an An user interface

Example:


Back to 3D Open System Reference Guide