de.grogra.ray2

Interface Renderer

All Known Implementing Classes:

BidirectionalRenderer, MetropolisRenderer, PixelwiseRenderer

public interface Renderer

This interface specifies the basic operations for a renderer.

Author:

Ole Kniemeyer

Method Summary

Methods

Modifier and Type	Method and Description
void	initialize(Options opts, ProgressMonitor progress) Initializes the renderer.
void	render(Scene scene, Sensor camera, Matrix4d cameraTransformation, int width, int height, java.awt.image.ImageObserver obs) Renders an image of a scene.
void	stop() This method is invoked from another thread to stop a running renderer.

Method Detail

initialize

void initialize(Options opts,
              ProgressMonitor progress)

Initializes the renderer. This method has to be invoked at first.

Parameters:

opts - options to use (may be null)

progress - monitor to display rendering progress (may be null)

render

void render(Scene scene,
          Sensor camera,
          Matrix4d cameraTransformation,
          int width,
          int height,
          java.awt.image.ImageObserver obs)

Renders an image of a scene.

Parameters:

scene - scene to render

camera - camera to use

cameraTransformation - transformation from camera coordinates to world coordinates

width - width of image

height - height of image

obs - the observer receives the image data

stop

void stop()

This method is invoked from another thread to stop a running renderer. The renderer should stop rendering as early as possible. However, there is no guarantee on the time span between stop and the return from the invocation of render.