write_vrml

Summary

Name

write VRML

Type

data output

Inputs

	geometry (required: in)
			geometry (optional: in2)

Outputs

	none

Parameters

Name		Type		Default	
			outfile		browser		--
			href		typein		""
			transparency	real		0.0
			detail range	real		0.0
			detail center	typein		"0.0 0.0 0.0"
			start traverse	oneshot		--
    The write VRML module converts its input geometry to the VRML1.0 and stores
   it into a file. This module supports the following geometry types:
	GEOM_MESH
	GEOM_POLYHEDRON
	GEOM_POLYTRI
	GEOM_SPHERE
	GEOM_LABEL
    If the geometry data contains the color or the normal vectors, write VRML
   converts them. 
    write VRML does not convert UV and UVW data of texture mapping.
  POLYTRI
    The geometry data of GEOM_POLYTRI type can include the polytri(triangular
   strips) objects and the line(polyline and disjoint-line) objects.
    If both of the polytri and line objects are included in a geometry,
   write VRML converts only the polytri objects.
  LABEL
    write VRML converts the geometry data of GEOM_LABEL type to the AsciiText
   node of "SANS" face (Helvetica), and ignores the title label.
INPUTS
    in (required: geometry)
	Any AVS geometry.
	In case of using LOD, the geometry passed to this port is converted
	as the high detail model of the LOD node.
    in2 (optional: geometry)
	Any AVS geometry.
	It is converted as the low detail model of the LOD node.
PARAMETERS
    outfile
	A file browser to specify the name of the VRML file to be created.
    href
	A character string to specify the URL of the whole VRML model
	this module outputs.
    transparency
	A floating point to specify the transparency of the whole VRML model
	this module outputs : 1.0 = transparent, 0.0 = opaque.
    detail range
    detail center
	Floating points to specify the range of the LOD(Level Of Detail) node.
	LOD is the feature that enables VRML switch the model to render
	related to the change of the distance from the specified point
	to the view point.
	If the data is passed to the input port 'in2' and the value of
	'detail range' is greater than 0.01, write VRML generates the LOD node.
	In this case, write VRML converts the data passed to the port 'in' to
	the high detail model of the LOD node which is rendered while the
	distance from  the 'detail center' to the view point is less than 
	'detail range' in the VRML browser. And converts the data 'in2' to the
	low detail model.
    start traverse
	An oneshot switch to execute converting.

Examples

  1) The following network reads an AVS geometry file, and converts it into
     a VRML file.
                    read geom
                        |
                        o----------------.
                        |                |
                geometry viewer     write VRML
  2) The following writes an output of arbitrary slicer into a VRML file
                generate colormap         read volume
                        |                      |
                        `-------.      .-------'
                                |      |
                           arbitrary slicer
                                       |
                        .--------------o
                        |              |
                geometry viewer   write VRML
  3) The following is an example of using LOD.
           generate colormap            read field
กก                |                          |
                  |  .-----------------------o
กก                |  |                       |
             color range              field to irreg
                    |                        |
กก                  |          .-------------o
                    |          |             |
                    |     downsize           |
                    |          |             |
                    `-------o------------.   |
                            |  |         |   |
                     field to mesh   field to mesh
                            |               |
                    .-------o-----.   .-----o--------.
                    |             |   |              |
            geometry viewer   write VRML     geometry viewer
     In this network, read field module reads the "field 2D scalar uniform" data.
     field to irreg module (by Kathleen M. Dyer. and Karin Schaefer) converts
     the all types of field data to the "irregular field".
     You must set the parameters 'detail range' and 'detail center'
     according to the existence region of the geometry.

Related modules

	Any module that outputs a geometry.

See also

  Jeff Vroom, "Interpreting GEOM Edit Lists", AVS Inc. Product Technical Papers,
                http://www.avs.com/techpapers/avs/geom.html
  Josie Wernecke, Open Inventor Architecture Group, "The Inventor Mentor",
		Addison-Wesley Publishing Company, 1994
  Gavin Bell, Anthony Parisi, Mark Pesce,
		"The Virtual Reality Modeling Language Version 1.0 Specification",
		http://vrml.wired.com/vrml.tech/vrml10-3.html, 1995

Author

        Hiroyuki Yoshikawa,  FUJITSU NAGANO SYSTEMS ENGINEERING LTD