XRacer::BVRML - Parser for a tiny subset of VRML generated by
Blender
This is a parser for a tiny subset of VRML generated by Blender,
so called Blender-VRML or BVRML. In fact, this parser is by no means
guaranteed to be able to parse everything that Blender could generate. I
will add parsing capability to it as I see the need.
"XRacer::BVRML" parses a Blender
VRML file, and stores it in an internal world representation, which
can be inspected and manipulated.
"XRacer::BVRML" can also write out a C
function containing GL commands which render this world object, and
this function can then be used inside an XRacer track or craft file.
- $world = XRacer::BVRML->parse ($filename [, $world]);
- This function parses a BVRML file called
$filename, and generates a
$world object. If the second optional
$world parameter is given, then the BVRML file is
parsed and the results are merged with the existing
$world object.
If the parsing fails, then this function will print an error
message and return "undef".
- $nr_vertices = $world->nr_vertices;
- Return the total number of vertices in the world.
- $nr_faces = $world->nr_faces;
- Return the total number of faces in the world.
- @vertices = $world->vertices;
- Aggregate all vertices in the world, and return it as a list.
- @faces = $world->faces;
- Aggregate all faces in the world, and return it as a list.
- ($smallest_x, $largest_x, $smallest_y, $largest_y, $smallest_z,
$largest_z) = $world->bbox;
- Return the bounding box (or bounding cuboid, to be more precise) of this
world.
- $world->write_display_function ([name => $function_name,]
[filehandle => $filehandle,] [decl => $decl]);
- Write out a C function containing GL calls which, when invoked, will
display this world object. The C function is called
$function_name and will be written to the file
specified by the $filehandle. The function will be
declared as "void function_name (void)"
unless the $decl parameter is given, which gives
the return declaration. The C function is suitable for directly linking
into XRacer craft and track files. However, it requires some support. In
particular, you will need to include the header file GL/gl.h, and probably
xracer.h before the function.
Richard W.M. Jones, <rich@annexia.org>
XRacer is copyright (C) 1999-2000 Richard W.M. Jones
(rich@annexia.org) and other contributors listed in the AUTHORS file.