Frequently Asked Questions

If you are using 3dsmax then WorldViz highly recommends you use the OSG exporter for 3ds Max which is freely available on our downloads page. It will export models to Vizards native format, which supports more features than any other format. Choose between the text format (.osgt) or the binary format (.osgb). The binary format loads very quickly and embeds all texture data inside it. The exporter also has an option to compress textures, which further reduces the size and loading time of the binary file.

1.2 How do I create or get models for Vizard?

While Vizard has some facility for creating content (e.g., 2D & 3D text, primitives and shapes), most likely your project's completion will require you to provide your own content either by creating it using 3rd party software or by leveraging content created by others. The 3D Models page lists some sites where you can purchase and download free models.

3ds Max exports to Vizard's native OSG format and is the best modeler for Vizard. WorldViz uses 3ds Max internally for creating assets and supports the workflow through this software. Even if you're not creating content, it's useful for exporting models found online to the OSG format.

There are a number of other applications that export to Vizard compatible formats, some of the more commonly used are Google SketchUp and Blender. The following knowledge base article describes the SketchUp workflow:

1.3 Is there a way to remove objects from the world?

All objects added to the scene have a remove command, which permanently deletes the object.

1.4 I want to position a model at a certain location in the scene. What's the easiest way to determine the coordinates of that location?

Load the model used to create the scene (e.g. room, house, city etc.) into Inspector, right click on the location and copy the coordinates.

1.5 Instead 'absolute' rotate, I need to 'relative' rotate a 3d model.

If you need more advanced control you could use the Transform class. Here's a simple example:

1.6 Does Vizard support mipmaps, LOD? If so, how do I get this to work? I want to conserve resources and have models further away show less detail.

If you are using 3ds Max and exporting to the OSG format you can specify LODs. From 3ds Max, in the create tab of the Command panel, go to helpers, then select OpenSceneGraph from the dropdown list. You should see an option along the lines of "OSG LOD" where you can set the LODs. When you export the model make sure 'Helpers' is one of the options checked.

1.7 My model is negatively affecting performance? How can I fix this?

The Performance page explains how to read Vizard's render stats and determine the cause of a frame rate drop. The Optimization page describes how to reduce the drawables, polygons, and textures of a model to improve performance.

1.8 When should <node3d>.copy and <node3d>.clone be used?

A copy will have the appearance of the original object when it was created. Any future changes to the original object's appearance will not affect the copy. There is a unique instance for each model but only one file needs to be loaded thereby reducing the load time.

If your script does not require a unique instance for each model, then you can use the clone command. Clones share the appearance of all the other clones. Changing the appearance of any one clone will change the appearance of all the others (although all their position, orientation, and scale transforms will be independent). In addition to reducing load time, memory is conserved as there is only one instance in memory for all the clones.

1.9 Does Vizard provide basic primitives and shapes?

Vizard allows you to create basic geometric objects (e.g. points, lines, triangles) on-the-fly. These objects are defined by creating vertices and then connecting those vertices with lines or surfaces. After an object is created it's vertices can be manipulated.

The vizshape library allows you to add more complex shapes (e.g. cubes, cylinders, cones). Unlike the on-the-fly objects you create with basic primitives you will not be able to access or manipulate individual vertices.

Once you've added either an on-the-fly or vizshape object, you can treat it as you would any other 3D object (e.g. set it's position, color, visibility etc.)

1.10 Can objects be made transparent or semi-transparent?

Yes, see the Transparency page for a discussion on this topic and to learn workarounds for issues that can arise when transparent objects are combined in the same scene.

2. Avatars

2.1 What avatar formats are supported?

Vizard supports the Cal3D avatar format. The Cal3D exporter for Max is available from the WorldViz download page. The Cal3D tutorial describes how to use the exporter.

2.2 Is it possible to change the included avatar's clothing or scale individual body parts?

Unless you've purchased the Complete Character set with the Max files you won't be able to make these types of modifications to the avatars. You'll need the Max files to make the changes and export a new Cal3D avatar.

2.3 How can I stop the avatar from walking through objects?

The vizact.walkTo action will not take into account objects along the walking path. You can create a series of walkTo actions to avoid an obstacle.

If you need to generate random walking actions then use proximity sensors to find out if the avatar is close to an object. If it is, end the walk action on the avatar and add a new one.

2.4 Is it possible to detect a collision with an individual body part?

You cannot perform collision on bones, only the entire avatar mesh. An alternative is to create an empty group node with a collision shape similar to the bone or avatar area where you want to detect collisions. Then link the group node to the bone.

2.5 How do I create a custom animation for an avatar?

This is possible if you own the Complete Character set which comes with all the associated 3ds Max files for the avatars. This set already includes many animations you don't see with the built-in avatars and may have what you are looking for. For custom animations you can either develop them using keyframe animation or with a motion capture system. Both will require you have the original max files and that you export the finished animation to Cal3D, Vizard's native avatar format.

2.6 What facial expressions are included and how can I add new ones?

The HD Complete Characters include facial bones that you can manipulate to create expressions.

For the standard Complete Characters, it's necessary to create a morph target in 3ds Max for each facial expression you want. The morphs that are included with the characters allow for blinking, speaking, and eyebrow raising. Take a look at the Blinking Avatars tech tip for example code to control these morphs in Vizard.

2.7 How can I attach a prop to an avatar?

There is an example file in the Vizard install path under \examples\avatar\linkbones.py.

2.8 How can I make the avatar keep eye contact with the user?

Using the <bone>.lookAt command you can orient the avatar's neck and head bones to face the user. The Animating Bones tutorial shows how to use this command to maintain eye contact. If you need more advanced behaviour, such as having the avatar's head smoothly turn and then make contact, try the WatchNode example code.

3. Flow control and animations

3.1 I have a series of events that I want to occur one after the other. How do I do this?

A lot can happen between the beginning and the ending of a virtual world. Tasks (created with the viztask module) are useful for controlling the order of events. They are functions that can pause and wait for a condition to be met, like a key press or an action to end, before they proceed. While the task function is waiting, the rest of the program runs uninterrupted. An example would be an interaction with an avatar where the avatar would speak, wait for a user response and then walk away.

Tasks are also helpful for splitting up your program into different periods of activity. For example, if you have a training simulation or experiment with various phases you can use a task function to wait until one phase is done and then set another in motion.

For more information on viztask, look under Flow control in both the tutorial and reference sections of the Vizard help. The Program flow section in Vizard Teacher in a Book (available as a free download) also has a description of this module with example code.

3.2 What options are there for animating a model in Vizard?

3.3 How do I disable a callback function?

To disable a callback that has been registered using the vizact library use <EventFunction>.setEnabled(viz.OFF).

Otherwise, disable a callback by setting the function to the value 0. For example, you would use the following code to disable a sensor button callback:

3.4 What's the difference between task and director functions?

The viztask module and viz.director functions have similar functionality; however, there are important differences. Calling viz.director actually creates a new thread, while scheduling a task does not. This means that calling a long blocking operation in a task will block the Vizard update loop as well and the frame rate will go to zero. However, in most cases, tasks should be used because they are much more CPU/memory efficient and are non-preemptive so synchronization locks are not necessary. Director functions should only be used for performing IO operations that would otherwise halt the rendering of the world or the execution of other code (e.g. reading data from a large file, downloading a file from the Internet)

3.5 How can I stop all my timers without closing my world?

To stop all the timers but keep the world open, use viz.pause(). To resume the timers, use viz.play().

4. Media

4.1 Why are my models too big or too small (or not showing up at all )?

In Vizard, it is important to note that the linear unit of measurement is meters. This is especially important to remember when obtaining 3D models from 3rd party sources because their units may not be in meters, in which case the objects may appear extremely large or small when imported into Vizard.

4.2 Objects are rendered pure white (textures not showing up).

This is often a result of trying to use a texture map that exceed the maximum 2D image resolution of Vizard.

4.3 I have a media file that won't play in Vizard.

Vizard supports any video or sound file format for which your system has a codec. One of the most common problem with media files is not having the correct codec (compression/decompression algorithm) installed on your system. Some applications (e.g. WMP, VLC) may have embedded codecs allowing them to play files that Vizard can't. If Vizard reports an error when loading a file, installing a codec pack may fix the problem.

4.4 Can I make movies of my worlds?

Yes, there are several ways. Vizard comes with a built-in screen recorder. Another excellent solution is a 3rd party tool called Fraps.

4.5 How can I do picture in picture showing the user and their Vizard perspective?

With a webcam and a few lines of code added to your script, a user can be displayed alongside the virtual scene they are viewing. By recording it all with software like Fraps, you can easily create a picture-in-picture video demo.

The following code shows the Vizard gallery with webcam video mapped to a texture quad in the corner of the screen:

4.6 3DMax and lighting in Vizard.

Take a look at the Light Baking page for instructions on baking complete maps and light maps.

4.7 Why does Vizard scale my textures?

By default, textures are resized to a power of two. You can use the texture.hint command with the viz.ALLOW_NPOT_TEXTURE_HINT flag to allow non-power-of-two textures if this is supported by your graphics card.

4.8 I have a large texture that doesn't work. Why?

The size of the texture may be larger than the maximum texture size allowed by your graphics card. Run the following code to determine this value:

If you want to use a very large texture, split it up into smaller textures and tile the textures on your object.

4.9 Why aren't transparent textures transparent within Vizard?

You will need to use alpha masks in order for transparency to work in Vizard. The jpg image format does not support alpha masks, so if you're using a jpg you will need to convert the image to some other format, such as tif or png. Within the appropriate format, give the black areas an alpha value of 0. Microsoft Office comes with a handy program call Microsoft Photo Editor. You can open your image with this program and use the "Set Transparent Color" tool to make the black areas transparent. Then make sure you save the image to tif or png format.

4.10 My objects have the appropriate textures in 3DMax, but when I bring them into Vizard those textures are gone.

When you apply a texture material in 3DMax you should only use UVW modifiers to adjust the texture parameters. Adjusting them directly within the material editor does not carry through to Vizard.

5. Display

5.1 What settings should be adjusted to get the best stereoscopic effect on a monitor or screen?

For viewing on an external display (e.g 3D monitor, shutterglasses) screen distance is important. WorldViz suggests that you correctly set the screen distance to your display(see <window>.screenDistance), the vertical field-of-view of the display (see viz.fov), and the user's ipd (see viz.ipd) when creating compelling and accurate 3D visualizations.

If you want to exaggerate the stereo effect you can change the window.fusionDistance setting. This command is not normally used for setting up correct 3D viewing. If you want an object to pop out of the screen more, then you would use a higher fusion distance value. This causes all objects less than that amount of distance from the virtual viewpoint to appear in front of the screen in 3D. By default, the fusion distance value will be the same as the screen distance value.

For a full discussion of stereoscopic rendering and HMD versus external displays, refer to the Stereoscopic Rendering page.

5.2 How do I get Vizard to display in stereo with shutter glasses?

If you video card supports quad buffered stereo and the stereo setting is enabled use:

5.3 How do I setup Vizard to work with a powerwall or CAVE?

The vizcave documentation includes example scripts for setting up both a powerwall and multi-wall CAVE in Vizard.

5.4 What is the fov of the Vizard display?

The default vertical FOV for the Vizard display is 40 degrees; the aspect ratio is automatically computed based on the window size. To change this, use viz.fov(verticleFOV, aspect ration).

5.5 How do I reverse left/right eye channels?

This can be set within the graphics card's control panel. To set this in Vizard, use the viz.ipd(IPD) command. Instead of the default interpupillary distance of 0.06 meters, specify the distance as -0.06 meters.

5.6 What is clipping range?

Most 3D graphics programs that rely on hardware accelerated hidden surface removal always have a finite depth range. Vizard uses hardware z-buffering exclusively for hidden surface removal, as do most other rendering APIs.

As such, you can use the viz.clip() command to fine tune the range. Keep in mind your depth resolution (the minimum distance the computer can distinguish in depth) will be spread over this range. You're noticing that far objects are disappearing. Try increasing the far range:

that sets the nearest range to 0.5 and the farthest to 1000 meters. If that's still not far enough, increase the far (e.g., to 5000). If you will never view an object closer than say 2 meters, then you'll get better z-buffer performance if you then correspondingly increase your near distance (e.g., viz.clip(2.0, 5000)).

If you set the range to be too wide (e.g., viz.clip(0.001, 1000000000)), you'll notice jagged slices through all your objects because the algorithms cannot exactly distinguish which objects are closer to viewpoint than others.

5.7 How can I display an object to a specific eye in stereo?

You can prevent a node from rendering to a specific eye in stereo using the <node3D>.disable command with either the viz.RENDER_RIGHT or viz.RENDER_LEFT flag. In the following example, a ball is displayed to only the left eye by disabling right eye rendering:

6. Viewpoint and Navigation

6.1 How do I manually move the viewpoint?

For relative movement of the viewpoint, use view.move(). For movement within the world's coordinates, use view.setPosition([x,y,z]). For relative rotations, use view.setEuler() with the viz.REL_PARENT flag. For rotations within the world's coordinate system, use view.setEuler().

6.2 Is it possible to do real time collision detection with the viewpoint and the scene in Vizard?

Yes. Turn on built-in collision detection by adding the following line to your script:

Vizard will automatically check for collisions between the viewer and the world. If the viewer collides with an object it will stop the viewer from moving past it.

6.3 Can I rotate the viewer's head and body independently?

The command <viewpoint>.setEuler will rotate the head (and not the body) by default. You can however, rotate the body (and the head will rotate with it). To do so, use the flag below:

6.4 Is there a way to disable the default behavior of using the mouse to move around the scene?

6.5 Mouse navigation speed is too slow or too fast. Can it be changed?

Try the viz.mouse.setScale command. It let's you change the gain for both navigation translation and rotations. To just go faster forward but keep the same turn feel, try something like:

7. Vizard IDE

7.1 Can I use a 3rd party Python IDE to run Vizard scripts?

Yes, you just need to configure the IDE to run the Vizard script using winviz.exe, which is located in the Vizard \bin directory. Our knowledge base contains step-by-step instructions on how to configure some of the more popular Python IDEs to run Vizard scripts.

7.2 Can I run a script and pass arguments to it from the command-line?

8. Hardware

8.1 I use an inertial sensor and PPT for 6DOF tracking; sometimes when I start a session, the movement seems to be off by 5-70 degrees. How do I fix this?

You must make sure that the inertial sensor's coordinate system is aligned with PPT's coordinate system. If that's not the case, your movement direction will be off by the degree of the initial offset. The tracker resets tech tip describes several ways to perform the alignment using vizconnect:

8.2 How do I add a second Intersense in my script?

8.3 Does Vizard work with Nvidia's 3D Vision glasses?

An Nvidia Quadro card is required to use the 3D Vision glasses with Vizard. The drivers do not support using 3D Vision with OpenGL applications on GeForce cards.

If you have an nvidia Quadro card and meet all the 3D Vision requirements then use the following in Vizard to initialize stereo:

8.4 What graphics cards does WorldViz recommend?

Worldviz generally recommends the high end Nvidia GeForce cards. If you need frame sequential stereo then we recommend an Nvidia Quadro card.

8.5 How much memory can Vizard address?

The amount of memory available to Vizard is limited by one of three factors; system memory, GPU memory, and Vizard version (32/64 bit). Programs running on 32-bit versions of Windows by default are limited to 2 GB of memory. This means that even if you have more memory installed in your host computer, Vizard 32-bit will not be able to access it. With Vizard 64-bit the memory bottleneck is determined by whichever is less, system or GPU memory.

Note: If you add "/3GB" to your boot.ini file, then Windows 32-bit will allow you to access up to 3 GB of memory for a single application (1 GB is always set aside for the OS)

8.6 Can I run multiple instances of Vizard, and how much memory will be available?

You can build a cluster on the same machine and thus leverage multiple GPUs. Under this scenario, each cluster instance can access a total amount of RAM according to the description in FAQ 8.5. Keep this in mind when running two GPUs—you may well need a machine that has 8 or more GB RAM to render full throttle. The supported GPU configurations are NVidia Quadro and AMD Radeon / FireGL.

8.7 How can I improve the performance of my Vizard script?

There are a variety of factors that can affect performance such as graphics content, hardware, and Windows settings. Take a look at the Performance page for more on this topic.

9. Add-ons

9.1 Can I use wxPython with Vizard?

9.2 Is it possible to do voice recognition in Vizard?

Yes, you can use the 3rd party pywin32 library along with the Microsoft Speech SDK to perform voice recognition in Python. The following knowledge base article describes how to do this.