S2PLOT:S2web

From S2PLOT

(Difference between revisions)
Jump to: navigation, search
Revision as of 05:06, 14 October 2008
Dbarnes (Talk | contribs)
(s2web: Embedding S2PLOT Content in Web Pages (using Flash))
← Previous diff
Revision as of 05:07, 14 October 2008
Dbarnes (Talk | contribs)
(Requirements)
Next diff →
Line 14: Line 14:
** version 2.4 or higher recommended ** version 2.4 or higher recommended
** <font color=green>S2PLOT is freely available for non-commercial and educational use</font> ** <font color=green>S2PLOT is freely available for non-commercial and educational use</font>
-* Adobe Acrobat 3D version 8.1.2+* s2web version 0.1 or higher
-** Adobe Acrobat Pro 9 Extended expected to work but not yet tested and interface may be different to that described below+** <font color=green>s2web is freely available for non-commercial and educational use</font>
-** <font color=green>Acrobat 3D and Acrobat Pro 9 Extended are commercial software but frequently are available at special academic and education prices</font>+* Web browser with Flash player plugin
===VRML export from S2PLOT=== ===VRML export from S2PLOT===

Revision as of 05:07, 14 October 2008

s2web: Embedding S2PLOT Content in Web Pages (using Flash)

Since version 2.02, S2PLOT has been able to write the displayed geometry to a VRML 97 format file. This format was selected as it can be read in by Adobe Acrobat 3D and embedded in Portable Document Format (PDF) files. See the section on 3-d PDF for more information.

We also use the VRML export capability of S2PLOT to produce content for the freely available S2PLOT Flash player, s2web. A syntax-only translation using the NIST-provided [ | v2x3d] yields an X3D file from the S2PLOT-exported VRML, and the 3-d scene in the X3D file can be read and displayed by s2web. Camera control and interaction with the scene in the s2web application is almost identical to that in a native S2PLOT program. Volume rendering, billboards, handles and frame-based animation are all supported.

The s2web functionality of S2PLOT is documented in the following paper. If you use s2web to embed S2PLOT content in a web page, please cite or acknowledge this source:

Requirements

  • S2PLOT version 2.02 or higher
    • version 2.4 or higher recommended
    • S2PLOT is freely available for non-commercial and educational use
  • s2web version 0.1 or higher
    • s2web is freely available for non-commercial and educational use
  • Web browser with Flash player plugin

VRML export from S2PLOT

Most S2PLOT geometry can be written to VRML format. While running an S2PLOT program, simply press Shift-W and a file called "test.wrl" will be written. It will overwrite any pre-existing "test.wrl" file in the current working directory.

When writing an S2PLOT program whose output may be captured to VRML, keep the following points in mind:

  • screen-coordinate geometry is not saved to VRML
  • line thickness is not properly supported in VRML
  • textured spheres are not presently written to VRML (next version of S2PLOT)
  • transparent dots are not presently written to VRML (next version of S2PLOT)
  • disks are not presently written to VRML (next version of S2PLOT)
  • both static and dynamic S2PLOT geometry is saved to the VRML file
  • you can organise parts of your geometry into named sections of the VRML file (model tree) by using the S2PLOT function pushVRMLname
  • correct volume rendering requires special attention (see below)
  • frame animation is possible (see below)
  • billboards can be used but require special attention (see below)
  • handles are written and can be used for particular types of interaction (see below)
  • Acrobat Reader generally struggles with more than say 5000 pieces of geometry (whether points, lines or facets)
  • you can programmatically export the VRML file by declaring the function "void writeVRML20(void)" and calling it from a dynamic S2PLOT callback function
Personal tools