Skip navigation.
 

VrmlMerge HowTo

Running VrmlMerge

VrmlMerge is a very versatile application. It can be run as a command line tool, as a windowed application or as an Applet inside your browser.
  • Running online (live): Go to Run live! section. VrmlMerge will be downloaded by your browser automatically and after a while a window will pop up asking you if you want to let the program run. You should obviously press "YES" button... If everything worked fine you can go to next section to find out what are VrmlMerge commands and options.
  • Running as a GUI application: Download file VrmlMerge-[version].jar and execute it - just double click this file. That's it. If VrmlMerge doesn't start up then it can mean that you have no Java installed on your computer - get it here If everything worked fine you can go to next section to find out what are VrmlMerge commands and options.
  • Running from command line (for advanced users or developers): Download VrmlMerge and in a command prompt type:
    java -jar VrmlMerge-[version].jar -merge inputfile.wrl [outputfile.wrl]
    java -jar VrmlMerge-[version].jar -convert inputfile.wrl [outputfile.x3d]
    java -jar VrmlMerge-[version].jar -images inputfile.wrl outputfile.wrl bitsPerColor
    java -jar VrmlMerge-[version].jar -images2 inputfile.wrl [outputfile.wrl]


VrmlMerge command and options


VrmlMerge always needs you to enter some VRML'97 input file to process and some output file to save results of processing (output file does not have to exist). After providing it with this information you can choose which command to run:

  • Press "Merge files" button to start merging multiple VRML files into one file
  • Press "Convert to X3D" button to start converting single VRML file into another X3D file
  • Press "Convert textures" button to start converting ImageTextures to PixelTextures
In case of "Merge files" command the input file should be the main file of your visualisation containing references to other .wrl files.

When converting to X3D make sure that output file has .x3d extension.

As for "Convert textures" command the "Bits per color" text field is responsible for setting how many bits should be used for each color component in your textures. If set to 8 then colors in output images won't be changed at all, when set to 1 you'll get a black-white "something". Default value 5 is fine for most cases (so called HighColor) (4 is also quite good). Of course the less bits per color the better compression can be attained in output file (using gzip). Try yourself various values to see which one fits you best.

NEW (ver 0.5)In version 0.5 there is a new option which can be used when converting textures - "Use data protocol". When clicked then images are inlined using a special data protocol handled by some browsers (Cortona, Octaga, Cosmo...).
This option is also available through command line switch "-images2"

That's it - the rest is up to VrmlMerge. After the process is complete go and check your output file to see if it works... ;)

You may wish to check out the FAQ section if you need more information.