illegal2vrml(1)

1illegal2vrml(1)             General Commands Manual            illegal2vrml(1)
2
3
4

NAME

6       illegal2vrml - convert VRML97 files with illegal extensions
7

SYNOPSIS

9       illegal2vrml [ -prefix prefix ] protofile.wrl file.wrl
10

DESCRIPTION

12       illegal2vrml  convert  Virtual Reality Modeling Language (VRML97) files
13       with illegal extensions to valid VRML97,  according  to  ISO/IEC  14772
14       Annex  F.   Annex F decribe, how extensions to the VRML language should
15       be implemented: using a EXTERNPROTO with a "urn" (fake URL)  that  sign
16       the VRML browser the extension and not to use the following URL.
17
18       illegal2vrml  read  the  file  protofile.wrl  which should contain such
19       EXTERNPROTOs.  The names of the EXTERNPROTOs should start with the same
20       prefix.   The  prefix  is  needed to deal with additional illegal field
21       names in valid VRML97 nodes.
22       In the next step illegal2vrml read the file file.wrl  and  replace  all
23       node  names  which are identical to the EXTERNPROTOs without the prefix
24       with the names of the EXTERNPROTOs (with the prefix).
25       In the last step, the result is written to standard output.
26

OPTIONS

28       -prefix prefix
29
30              set the name of the prefix of the EXTERNPROTOs. If  this  option
31              is  not  used,  the prefix is calculated from the proto names in
32              protofile.wrl
33

EXAMPLE

35       Imagine a VRML97 file with a illegal extension to the WorldInfo node
36
37       $ cat $HOME/worldinfo.wrl
38              #VRML V2.0 utf8
39
40              WorldInfo
41              {
42                copyright "(C) illegal extension Inc."
43                info      "a existing VRML97 node with a illegal extension"
44              }
45
46       A matching file with a EXTERNPROTO would be
47
48       $ cat $HOME/protofile.wrl
49              #VRML V2.0 utf8
50
51              EXTERNPROTO PrefixWorldInfo
52              [
53              field SFString copyright
54              field MFString info
55              field SFString title
56              ]
57              ["urn:inet:browser.com:library:PrefixWorldInfo"    "PrefixWorld‐
58              Info.wrl"]
59
60       To convert to a valid VRML97 file, use
61
62       $ illegal2vrml -prefix Prefix  $HOME/protofile.wrl $HOME/worldinfo.wrl
63              #VRML V2.0 utf8
64
65              EXTERNPROTO PrefixWorldInfo
66              [
67              field SFString copyright
68              field MFString info
69              field SFString title
70              ]
71              ["urn:inet:browser.com:library:PrefixWorldInfo"    "PrefixWorld‐
72              Info.wrl"]
73
74              PrefixWorldInfo
75                {
76                copyright "(C) illegal extension Inc."
77                info
78                  [
79                  "a existing VRML97 node with a illegal extension"
80                  ]
81                }
82

COPYRIGHT

84           illegal2vrml convert VRML97 files with illegal extensions
85           Copyright (C) 2000-2003  J. "MUFTI" Scheurich, Stephen F. White
86
87           This program is free software; you can redistribute it
88           and/or modify it under the terms of the
89           GNU General Public License
90           as published by the Free Software Foundation; either
91           version 2 of the License, or (at your option) any later
92           version.
93

BUGS

95       Inside PROTOs, the conversion program  do  not  parse  for  node  names
96       (yet).   Therefore  only a string based replacement is made inside PRO‐
97       TOs.
98

DIAGNOSTICS

100       Exit status is 0 for sucessfull operation, 1 if inputfiles can  not  be
101       sucessfully read or other error
102