DzImageRenderHandler Class Reference
[Rendering Objects]

A render handler that renders into an image (or images). More...

Inheritance diagram for DzImageRenderHandler:

DzRenderHandler Dz3DViewRenderHandler DzViewRenderHandler List of all members.

Constructors

 DzImageRenderHandler (Size size, DzTime startingTime, Number numFrames, String filename, Boolean isMovie)
 DzImageRenderHandler (Size size, DzTime renderTime, String filename)

Detailed Description

A render handler that renders into an image (or images).

Has an array of QImage objects for capturing data from a renderer - one image will be created for each frame rendered.


Constructor & Destructor Documentation

DzImageRenderHandler::DzImageRenderHandler ( Size  size,
DzTime  renderTime,
String  filename 
)

Create a new image render handler for rendering a single frame.

Parameters:
size The width & height of the rendered image.
renderTime The time to render the frame at.
filename The filename to save the image to.
Example:
// Get the active viewport and camera
var oActiveView = MainWindow.getViewportMgr().getActiveViewport();
var oCamera = oActiveView.get3DViewport().getCamera();

// Get the render options
var oRenderOptions = App.getRenderOptions();

// Create a handler
var oHandler = new DzImageRenderHandler( oRenderOptions.getImageSize(), 0, App.getTempPath() + "/test.jpg" );

// If we have a valid handler
if( oHandler ){
    // Set the background color
    oHandler.setBackColor( oActiveView.get3DViewport().background );

    // Get the renderer
    var oRenderer = oRenderOptions.getActiveRenderer();

    // Render, using our handler and options
    oRenderer.render( oHandler, oCamera, oRenderOptions );
}

DzImageRenderHandler::DzImageRenderHandler ( Size  size,
DzTime  startingTime,
Number  numFrames,
String  filename,
Boolean  isMovie 
)

Create a new image render handler for rendering a multiple frames.

Parameters:
size The width & height of the rendered images.
startingTime The time to start the render at.
numFrames The number of frames to render.
filename The name of the movie file or the base file name for the series.
isMovie If true, the filename is expected to be a valid filename for saving a movie file, if false, it is expected to be a valid image name.
Example:
// Get the active viewport and camera
var oActiveView = MainWindow.getViewportMgr().getActiveViewport();
var oCamera = oActiveView.get3DViewport().getCamera();

// Get the render options
var oRenderOptions = App.getRenderOptions();

// Create a handler
var oHandler = new DzImageRenderHandler( oRenderOptions.getImageSize(), 0, 1, App.getTempPath() + "/test.jpg", false );

// Render if we have a handler
if( oHandler ){
    var oRenderer = oRenderOptions.getActiveRenderer();
    oRenderer.render( oHandler, oCamera, oRenderOptions );
}


Generated on Thu Sep 24 12:21:12 2009

Copyright © 2002 - 2009 DAZ 3D, Inc.