vvinterpreter

User Instructions


vvinterpreter is intended to be used with the DLLs genereated by vvp2cpp. For instructions on generating such a DLL, see the vvp2cpp documentation.

Opening a program

A program compiled as a DLL can be opened in one of two ways. First, it can be loaded with the program by adding the name of the DLL as a command line argument. Second, it can be opened at any time while vvinterpreter running with the File/Open menu selection.

Quiting

The program can be exited at any time by the File/Quit menu selection.

Image grabbing

An image can be generated at any time from the current view. A raster image can be generated with the Image/Save As Image menu selection. An image can be saved to any of the file formats supported by Qt. The format is inferred from the extension given to the file name. An image can also be generated in PostScript format with the Image/Save As PostScript menu selection.

Viewing

The view is manipulated using a combination of mouse and keysboard.

Rotate the view

The view can be rotated using Shift+Left mouse button.

Translate the view

The view can be translated using Ctrl+Left mouse button.

Zoom the view

The view can be rotated using the middle mouse button.

Program Logic Commands

All of the following commands are avialable as selection from the context menu and as keyboard shortcuts.

Start (Ctrl-w)

If the vertex-vertex program provides a start block, it is called immediately when the DLL is loaded. If the user calls this again, the DLL is reloaded and the block is executed again.

Step (Ctrl-f)

Calls the step block of the vertex-vertex program.

End (Ctrl-e)

Calls the end block of the vertex-vertex program.

Run (Ctrl-r)

Calls the step block upto the number of times specified by the proxy or is stopped.

Animate (Ctrl-a)

Calls the step block repeatadly until stopped.

Stop (Ctrl-s)

Stops the repeated steps of the Run and Animate commands.

Proxy

vvinterpreter can read information set in the proxy object in a vertex-vertex program. See the vertex-vertex language documentation.

Command line parameters

The first unrecognised command line parameter is assumed to be the DLL that contains the vertex-vertex program. Any other unrecognised parameters are ignored.

-d

Calls printXMLFile() on each mesh if the program causes any exception.

-stats

Causes the elapsed time for each function call from the vv program to be printed in milliseconds.

-nogui

Prevents the vvinterpreter window from opening. If there is program provided as a command line parameter, its start block is executed and vvinterpreter exits. If no program is provided, then vvinterpreter immediately exits. This option is useful for programs with no graphical output.

-animate

Starts the program animate mode.

-size h w

Sets the size of the window. Both h and w are values between zero and one. The actual size of the window is the height of the desktop times h and the width of the desktop by w.

-glsize h w

Sets the size of the OpenGL canvas to a height of h pixels and width of w pixels.

-pos x y

Sets the position of the window. Both x and y are values between zero and one. The actual position of the window is the height of the desktop times x and the width of the desktop by y.

-max

Starts the program window maximised.

-min

Start the program window minimised.


Return to the main page
Colin Smith

Valid XHTML 1.1! Valid CSS!