indicates that the vertex data following this keyword, up until the next keyword or end-of-data, will represent a single series of connected line segments. An error is raised if normals are supplied in the vertex data. There needs to be at least two data lines provided before the end of data for this primitive. If r b g a are supplied, the entire primitive will be drawn in this color. If not supplied, the most recently used color will be used if not also supplied with the vertex data.

indicates that the vertex data following this keyword, up until the next keyword or end-of-data, will represent a single tristrip. There needs to be at least three data lines provided before the end of data for this primitive. If r b g a are supplied, the entire primitive will be drawn in this color. If not supplied, the most recently used color will be used if not also supplied with the vertex data.

indicates indicates that the vertex data following this keyword, up until the next keyword or end-of-data, will represent a series of one or more n sided polygons. If n is omitted, then a single polygon will drawn with as many sides as data lines that follow, but must be at least three. If n is provided, at least n data lines must be provided, and the total number of data lines must be evenly divisible by n. If r b g a are supplied, the entire primitive will be drawn in this color. If not supplied, the most recently used color will be used if not also supplied with the vertex data.

indicates that the vertex data following this keyword, up until the next keyword or end-of-data, will represent a single series of points. An error is raised if normals are supplied in the vertex data. If r b g a are supplied, the entire primitive will be drawn in this color. If not supplied, the most recently used color will be used if not also supplied with the vertex data.

xv yv zv [ r g b a ] [ xn yn zn ]

where:

xv yv zv define a vertex position in 3 space

r g b a define a color and transparency (values range from 0 to 1)

xn yn zn define a normal at the position of the vertex

if "r g b a" is omitted, the most recently supplied color will be used.

if "xn yn zn" is omitted, no normals will be passed to pfBuilder for the primitive.

Note: All data lines for a single primitive need to be in the same format. For example, if the first data line for a primitive contains only a vertex, all subsequent data lines for this primitive can only supply vertex data. And if the first data line for a primitive contains a vertex and color, then all subsequent data lines for this primitive must supply a vertex and color.

indicates how primitives should be rendered. filled specifies that polygons and tristrips should be filled. wireframe specifies that polygons and tristrips should be rendered in wireframe. The specified style will affect all subsequent geometry until another style keyword is given. The default style is filled.

indicates the size of a point, or the width of a line, in pixels. The specified pixelsize will affect all subsequent geometry until another pixelsize keyword is given. If no pixelsize keyword is given, 1.0 is used. Note: size is a floating point number.

indicates that each filled polygon or tristrip should be shrunk towards its center by scale. The smaller the value of scale, the smaller the objects. The specified shrinkage will affect all subsequent geometry until another shrinkage keyword is given. If no shrinkage keyword is given, 1.0, or no shrinkage, is used. Note: size is a floating point non-negative number less than or equal to one.

indicates the number of triangles per pfGeoSet- each pfGeoSet will have at most length triangles. Viewport culling is done at the pfGeoSet level, so bigger pfGeoSets will cull faster, but may send more geometry to be drawn that is outside of the viewing volume. Transparency sorting is also done at the pfGeoSet level, so the larger the pfGeoSet, the less accurate is the transparency rendering. For best transparency results set length to 1, the default. If length is set to 0, then no pfGeoSet subdivision will be performed, resulting in potentally large pfGeoSets. If multiple striplength commands are given, only the last one is used, and affects all primitives in the file.

The loader calls pfdBreakup to create a recursive spatial octree whose leaf nodes are pfGeodes. The octree parameters specify how to shape the tree. If multiple octree commands are given, only the last one is used, and affects all primitives in the file. If the octree command is not supplied, the default value of size is 0 (ignored), and the default value of children is 20. The parameters are described in more detail below.

The length of the diagonal of the bounding box surrounding each pfGeode will be less than size units, in model coordinates. Each pfGeode will contain up to children pfGeoSets.

Octree recursion stops when either the size or children condition is met. size can be set to zero, but then children must be greater than one. If size is greater than or equal to one, children can be set to one.

Making size larger will reduce culling and increase drawing time. Making children larger will increase culling time and decrease drawing time. To get the best values for a particular mode, try loading it with different octree values with perfly, and using the "z" key in perfly to see how much geometry is getting clipped and how much is getting draw that is outside of the viewing volume, and press the "show tree" menu button to see the structure of the octree. Also, use the DIVERSE dpf-bounds command to help set a realistic value for size based on the extent of the model data. Note: size is a floating point number, and children is an integer.

by default, planar quads are retessellated into flat tristrips by pfdBuilder. By specifying this keyword anywhere in the savg file, retessellation is disabled. Retessellation can increase the efficiency of the displayed geometry, but can also alter the underlying geometry; this can be important for wireframe displays, and for some lighting conditions.

if this keyword is present anywhere in the savg file, the loader will check all polygons to see if all vertices are in the same plane. If not, a message is written to the console at pfNotify's NOTICE level.

specifies how transparent geometry should be rendered. By default, when a non-zero alpha value is supplied as a color for a primitive, transparency is enabled for that primitive- this is what the auto parameter specifies. The on parameter specifies that transparency should be enabled regardless of the primitive's alpha values. The off parameter specifies that transparency should be disabled regardless of the primitive's alpha values. The unfortunately named default parameter uses whatever transparency value was inherited from the global state.

specifies how primitive lighting should be rendered. By default, lighting is enabled for 3D primitives and disabled for 2D primitives- this is what the auto parameter specifies. The on parameter specifies that lighting should be enabled. The off parameter specifies that lighting should be disabled. The default parameter uses whatever lighting value was inherited from the global state.

specifies what model to use for lighting. These calls map directly to DIVERSE's pfMaterial::setColorMode call. The default parameter uses whatever lighting model was inherited from the global state, which is usually ambient_and_diffuse.

specifies the value of ambient light if r g b are given, which are then passed to pfMaterial::setColor. r g b are floating point numbers between 0.0 and 1.0, inclusive. The default parameter uses whatever ambient color is inherited from the global state. How the ambient light value is used depends on the colormode selected.

specifies the value of diffuse light if r g b are given, which are then passed to pfMaterial::setColor. r g b are floating point numbers between 0.0 and 1.0, inclusive. The default parameter uses whatever diffuse color is inherited from the global state. How the diffuse light value is used depends on the colormode selected.

specifies the value of specular light if r g b are given, which are then passed to pfMaterial::setColor. r g b are floating point numbers between 0.0 and 1.0, inclusive. The default parameter uses whatever specular color is inherited from the global state. How the specular light value is used depends on the colormode selected.

specifies the value of emissive light if r g b are given, which are then passed to pfMaterial::setColor. r g b are floating point numbers between 0.0 and 1.0, inclusive. The default parameter uses whatever emission color is inherited from the global state. How the emission light value is used depends on the colormode selected.

specifies the value of the alpha component if a is specified. The alpha value is a floating point number between 0.0 ands 128.0, inclusive. This range is used because it is what is used by the pfMaterial::setAlpha command. The default parameter uses whatever alpha value was inherited from the global state. How the alpha value is used depends on the colormode selected.

specifies the value of shininess component if s is specified. The shininess value is a floating point number between 0.0 ands 128.0, inclusive. This range is used because it is what is used by the pfMaterial::setShininess command. The default parameter uses whatever shininess value was inherited from the global state. How the shininess value is used depends on the colormode selected.

pfNode foo = pdfLoadFile("filename.savg") ;

diversifly filename.savg

# blank lines, case, and extra white space is ignored

# The "active node" is the node under which other nodes are placed.

# Initially the top level group node is the active node.

# create a pfGroup, pfDCS or pfSCS node named "nodeName" under the activenode, and make it the new active node. An optional transformation can be given. The node name can be left unspecified by using the keyword NULL

# make the node named "nodeName" the active node- subsequent nodes and files will be placed under this node. If no node is specified, use the top level node

# load files named under the active node

# duplicate files are automatically instanced.

# Use the FILE command to load files and attach them to the scenegraph (make them visible).

# Use the LOAD command just to load files into the scenegraph.

# Use the ON command to make objects visible that have been loaded but not added to the scenegraph.

#A nodename for each file is optional. This is a way to individually name each object that may lie under a group node.

# A parent group name for is ON statement is also optional. If not specified, the node is placed on the active node.