Content-type: text/html
<HTML><HEAD><TITLE>Manpage of ILLEGAL2VRML</TITLE>
</HEAD><BODY>
<H1>ILLEGAL2VRML</H1>
Section: User Commands (1)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
<B>illegal2vrml</B> - convert VRML97 files with illegal extensions
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<BR>
<B>illegal2vrml</B>
[<B>
-prefix prefix
</B>]
<B>
protofile.wrl
</B>
<B>
file.wrl
</B>
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
<B>illegal2vrml</B>
convert Virtual Reality Modeling Language (VRML97) files with illegal
extensions to valid VRML97, according to ISO/IEC 14772 Annex F.
Annex F decribe, how extensions to the VRML language should be
implemented: using a EXTERNPROTO with a "urn" (fake URL) that sign the
VRML browser the extension and not to use the following URL.
<B>illegal2vrml</B>
read the file
<B>protofile.wrl</B>
which should contain such EXTERNPROTOs.
The names of the EXTERNPROTOs should start with the same prefix.
The prefix is needed to deal with additional illegal field names
in valid VRML97 nodes.
<BR>
In the next step
<B>illegal2vrml</B>
read the file
<B>file.wrl</B>
and replace all node names which are identical to the EXTERNPROTOs
without the prefix with the names of the EXTERNPROTOs (with the prefix).
<BR>
In the last step, the result is written to standard output.
<A NAME="lbAE"> </A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>-prefix prefix </B>
<DD>
<P>
set the name of the prefix of the EXTERNPROTOs. If this option is not
used, the prefix is calculated from the proto names in
<B>protofile.wrl</B>
</DL>
<A NAME="lbAF"> </A>
<H2>EXAMPLE</H2>
Imagine a VRML97 file with a illegal extension to the WorldInfo node
<P>
<DL COMPACT>
<DT>$ cat HOME/worldinfo.wrl<DD>
<BR>
#VRML V2.0 utf8
<P>
WorldInfo
<BR>
{
<BR>
<BR> copyright "(C) illegal extension Inc."
<BR>
<BR> info "a existing VRML97 node with a illegal extension"
<BR>
}
</DL>
<P>
<DL COMPACT>
<DT>A matching file with a EXTERNPROTO would be<DD>
</DL>
<P>
<DL COMPACT>
<DT>$ cat $HOME/protofile.wrl<DD>
<BR>
#VRML V2.0 utf8
<P>
EXTERNPROTO PrefixWorldInfo
<BR>
[
<BR>
field SFString copyright
<BR>
field MFString info
<BR>
field SFString title
<BR>
]
<BR>
["urn:inet:browser.com:library:PrefixWorldInfo" "PrefixWorldInfo.wrl"]
</DL>
<P>
<DL COMPACT>
<DT>To convert to a valid VRML97 file, use<DD>
</DL>
<P>
<DL COMPACT>
<DT>$ illegal2vrml -prefix Prefix $HOME/protofile.wrl $HOME/worldinfo.wrl<DD>
<BR>
#VRML V2.0 utf8
<P>
EXTERNPROTO PrefixWorldInfo
<BR>
[
<BR>
field SFString copyright
<BR>
field MFString info
<BR>
field SFString title
<BR>
]
<BR>
["urn:inet:browser.com:library:PrefixWorldInfo" "PrefixWorldInfo.wrl"]
<P>
PrefixWorldInfo
<BR>
<BR> {
<BR>
<BR> copyright "(C) illegal extension Inc."
<BR>
<BR> info
<BR>
<BR> [
<BR>
<BR> "a existing VRML97 node with a illegal extension"
<BR>
<BR> ]
<BR>
<BR> }
</DL>
<A NAME="lbAG"> </A>
<H2>COPYRIGHT</H2>
<BR> illegal2vrml convert VRML97 files with illegal extensions
<BR>
<BR> Copyright (C) 2000-2003 J. "MUFTI" Scheurich, Stephen F. White
<P>
<BR> This program is free software; you can redistribute it
<BR> and/or modify it under the terms of the
<BR> GNU General Public License
<BR> as published by the Free Software Foundation; either
<BR> version 2 of the License, or (at your option) any later
<BR> version.
<A NAME="lbAH"> </A>
<H2>BUGS</H2>
Inside PROTOs, the conversion program do not parse for node names (yet).
Therefore only a string based replacement is made inside PROTOs.
<A NAME="lbAI"> </A>
<H2>DIAGNOSTICS</H2>
Exit status is 0 for sucessfull operation,
1 if inputfiles can not be sucessfully read or other error
<A NAME="lbAJ"> </A>
<H2>SEE ALSO</H2>
<DL COMPACT>
<DT>VRML97 International Standard<DD>
<BR>
<A HREF="http://www.web3d.org/x3d/specifications/vrml/ISO-IEC-14772-IS-VRML97WithAmendment1">http://www.web3d.org/x3d/specifications/vrml/ISO-IEC-14772-IS-VRML97WithAmendment1</A>
<DT>VRML97 International Standard Annex F<DD>
<BR>
<A HREF="http://www.web3d.org/x3d/specifications/vrml/ISO-IEC-14772-IS-VRML97WithAmendment1/part1/extensions.html">http://www.web3d.org/x3d/specifications/vrml/ISO-IEC-14772-IS-VRML97WithAmendment1/part1/extensions.html</A>
<P>
</DL>
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">EXAMPLE</A><DD>
<DT><A HREF="#lbAG">COPYRIGHT</A><DD>
<DT><A HREF="#lbAH">BUGS</A><DD>
<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 03:05:19 GMT, May 27, 2005
</BODY>
</HTML>
distrib
>
Mandriva
>
2007.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
72ca020c3e58903e15410e6277d9d7a5
>
files
>
204
