documentation projects applications publications gallery download
BOOGA
Virtual Emmental

Up ] osRenderer on the SP ]


osRenderer Reference Manual

osRenderer can render scenes with the OpenGL library without opening a window. The offscreen renderer was implemented using the newest version (2.4) of the Mesa library.

osRenderer has following features:

Support for Boundingbox, Wireframe, Gouraud or Raytracing quality
Support for generation of animations
JPEG or PPM output
Oversampling

Usage: osRenderer [--oversampling rate] [--quality q] [--pal_small] [--pal_large] [--jpeg] [--ppm] [in-file] out-file

where:

--oversampling : (optional) oversampling rate for antialiasing (values 2,3, or 4 are recommended) (default: no antialiasing performed)
--pal_large : (optional) render scene with PAL resolution (704x576)
--pal_small : (optional) render scene with 1/4 PAL resolution (352x288)
--ppm : (optional) output as PPM 24bit uncompressed
--jpeg : (optional) output as JPEG, with 75% compression
--quality boundingbox : (optional) render boundingboxes of the scene (default: --quality gouraud)
--quality wireframe : (optional) render scene with wireframe quality (default: --quality gouraud)
--quality gouraud: (optional) render scene with smooth shading quality (default: --quality gouraud)
--quality raytracing: (optional) render scene with raytracing quality (default: --quality gouraud)
--startframe number : (optional) start frame of the animation
--number number : (optional) number of frames
--framestep number : (optional) framestep of the animation
--counter number : (optional) startnumber of the counter for the outputfiles
in-file : (optional) filename of input
out-file : filename of output, without extension. The extension of the resulting image is added automatically by osRenderer. The filename may also be a complete path.

Rendering quality

osRenderer can generate images of four different qualities:

--quality boundingbox

--quality wireframe

--quality gouraud

--quality raytracing

Depending on the requested quality, rendering time may vary. Raytracing takes the longes rendering time, boundingbox is fastest.

Oversampling

Oversampling can be used to enhance image quality. --oversampling 2 means that the image is process in double the resoultion, which means a rendering time which can be four times slower. Using boundingbox, wireframe or gouraud, the maximum oversampling rate is limited by the maximum viewport of the OpenGL library, which is 1280x1024 at the moment. For example, rendering a scene which has a resolution of 400x350 with oversampling of 3 will work, oversampling 4 will create unpredictable results.

no oversampling --oversampling 2 --oversampling 3

Rendering animations

osRenderer can be used to render a sequence of frames of an animation. All the animation parameters will be taken from the BSDL file. The first camera which is switched on will be active for all the frames to be rendered. If more than one cameras are defined, osRenderer must be executed subsequentally with the corresponding startframe and number of frames which belong to the active camera. Maybe you have to copy your BSDL file and switch on the appropriate camera before rendering.

Examples

Creating an animated sequence:

osRenderer --startframe 0 --number 15 --framestep .5 windmill.bsdl3 anim 

This will render frames 0 to 7 in steps of .5 in gouraud quality. The output files will be named anim.0000.jpf, anim.0001.jpg, ..., anim.0014.jpg. The leading zeroes are useful for applications which can process image sequences to create animation files. The first camera which is switched on will be activated for the rendering of all the frames.

buhlmann@iam.unibe.ch

8.1.98

Last changed: 12.05.98

Back Home Up Next

documentation projects applications publications gallery download

BOOGA - A project of the fcg Research group of the Insitute of Computer Science of the University of Berne