xracer::bvrml(3pm) [debian man page]

BVRML(3pm)						User Contributed Perl Documentation						BVRML(3pm)

NAME

       XRacer::BVRML - Parser for a tiny subset of VRML generated by Blender

SYNOPSIS

	 use XRacer::BVRML;

DESCRIPTION

       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.

CLASS METHODS

       $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".

WORLD OBJECT METHODS

       $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.

AUTHOR

	 Richard W.M. Jones, <rich@annexia.org>

COPYRIGHT

       XRacer is copyright (C) 1999-2000 Richard W.M. Jones (rich@annexia.org) and other contributors listed in the AUTHORS file.

SEE ALSO

       perl(1), xracer(6).

perl v5.14.2							    2000-01-07								BVRML(3pm)

Check Out this Related Man Page

WebService::CIA::Parser(3pm)				User Contributed Perl Documentation			      WebService::CIA::Parser(3pm)

NAME

       WebService::CIA::Parser - Parse pages from the CIA World Factbook

SYNOPSIS

	 use WebService::CIA::Parser;
	 my $parser = WebService::CIA::Parser->new;
	 my $data = $parser->parse($string);

DESCRIPTION

       WebService::CIA::Parser takes a string of HTML and parses it. It will only give sensible output if the string is the HTML for a page whose
       URL matches "https://www.cia.gov/library/publications/the-world-factbook/print/[a-z]{2}.html"

       This parsing is somewhat fragile, since it assumes a certain page structure.  It'll work just as long as the CIA don't choose to alter
       their pages.

METHODS

       "new"
	   Creates a new WebService::CIA::Parser object. It takes no arguments.

       "parse($html)"
	   Parses a string of HTML take from the CIA World Factbook. It takes a single string as its argument and returns a hashref of fields and
	   values.

	   The values are stripped of all HTML. "<br>" tags are replaced by newlines.

	   It also creates four extra fields: "URL", "URL - Print", "URL - Flag", and "URL - Map" which are the URLs of the country's Factbook
	   page, the printable version of that page, a GIF map of the country, and a GIF flag of the country respectively.

EXAMPLE

	 use WebService::CIA::Parser;
	 use LWP::Simple qw(get);

	 $html = get(
	   "https://www.cia.gov/library/publications/the-world-factbook/print/uk.html"
	 );
	 $parser = WebService::CIA::Parser->new;
	 $data = $parser->parse($html);
	 print $data->{"Population"};

AUTHOR

       Ian Malpass (ian-cpan@indecorous.com)

COPYRIGHT

       Copyright 2003-2007, Ian Malpass

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       The CIA World Factbook's copyright information page (<https://www.cia.gov/library/publications/the-world-factbook/docs/contributor_copy-
       right.html>) states:

	 The Factbook is in the public domain. Accordingly, it may be copied
	 freely without permission of the Central Intelligence Agency (CIA).

SEE ALSO

       WebService::CIA

perl v5.8.8							    2008-02-04					      WebService::CIA::Parser(3pm)

Linux and UNIX Man Pages

xracer::bvrml(3pm) [debian man page]

Check Out this Related Man Page