Real2Virtual WebView v1.0 User Guide
Introduction
Real2Virtual WebView allows 3D Models to be published on web-pages without the need for browser blug-ins.
WebView comes in two forms
- Standard version : Allows Real2Virtual3D model (.m3d) files to be published
- WebView+ : Supports StL files (.StL) and Real2Virtual3D models.
Real2Virtual WebView is a Java applet. To use it you simply...
- Use ReduceM3D to reduce model file sizes and create the HTML needed to display the model
- Upload the applet file, model file and web-page to your server
Usage
The following table summarises each parmater of the applet
| width | Width of the applet |
| height | Height of the applet |
| modelSrc | The path of the model file relative to the applet file |
| name | A name for the model |
| backCol | The background colour of the applet window |
| objectCol | The colour of the object if no colour is defined in the model file (as in StL files) |
| license | The license number (for WebView+ version only) |
| spin | The roatation in degrees around the vertical to spin each step |
| spinDelay | A wait in milliseconds between spin steps |
| spinHaltOnClick | When the user clicks spinning will stop is this is set to 1 otherwise spinning continues |
| initialScale | Inital scale factor to apply to the model |
| initialRotX | Initial rotation in degrees (x-component) |
| initialRotY | Initial rotation in degrees (y-component) |
| initialRotZ | Initial rotation in degrees (z-component) |
| initialTransX | Initial translation in screen units (x-component) |
| initialTransY | Initial translation in screen units (y-component) |
| initialTransZ | Initial translation in screen units (z-component) |
| fovaY | Field of view angle (degrees) about the y-axis - basically how wide a field of view the applet shows |
The origin of the coordinate system is in the center of the applet. The x,y, and z axes are defined as follows
- X-axis : Positive x-axis is horizontal and right pointing
- Y-axis : Positive y-axis is vertical and down pointing
- Z-axis : Positive Z-axis is points away from the viewer into the screen
Colours are defined in hexadecimal notation aarrggbb where aa is the alpha component, rr the red component, gg the green component and bb the blue component. The alpha component should be ff, other values are not currently supported. Some examples of colours defined this way are ...
- Red ffff0000, Green ff00ff00, Blue ff0000ff
- White ffffffff, Black ff000000, Grey ffa0a0a0
- Yellow ff00ffff
Publishing to a web page
The easiest way to publish a model is to have ReduceM3D generate the HTML for you.
- Download the free version of ReduceM3D
- Run ReduceM3D and load the model you wish to publish
- Hit the publish button
- Use the page created or cut and paste the contents to your own web-page source code
ReduceM3D will create a html page with the same name as the model, in the same folder as the model
Note: if you wish to reduce the model file-size you will need to buy a license for the full version of ReduceM3D
You then upload the model and web-page to your server along with the WebView applet file...
- The Real2Virtual WebView applet is called r2v3dvf1.jar and works on any website or offline
- The WebView+ applet is called r2v3dv1.jar and is tied to the owners website
Note: the applet file should be inclued in every folder which contains a web-page that uses it
Purchasing
WebView
Real2Virtual WebView is free to use on any website. Note that WebView only publishes Real2Virtual3D models.
WebView+
To use Real2Virtual WebView+ you must purchase a license for each website you wish to use it on. As well as supporting StL, WebView+ includes a full version of ReduceM3D reduction and publishing tool. For more details see the WebView home page
ReduceM3D
ReduceM3D can be purchased seperately for use in reducing models - or as part of the WebView+ package. See the ReduceM3D home page for more details.
|