Copyright ©1995 by NeXT Computer, Inc.  All Rights Reserved.


Inherits From: Panel : Window : Responder : Object
Declared In: 3Dkit/N3DRenderPanel.h

Class Description

N3DRenderPanel provides a user interface for controlling rendering with the PhotoRealistic RenderMan renderer.  The Render panel lets the user select the host or hosts on which to perform  rendering and the resolution of that rendering.  Each application has at most one instance of N3DRenderPanel.

An N3DRenderPanel is presented anytime RIB is printed (either through an N3DCamera or an N3DRIBImageRep).  When an application prints RIB code, the PhotoRealistic RenderMan renderer generates a TIFF image of the 3D scene, which is then merged into the PostScript stream being spooled to the printer.  The Render panel is also presented anytime as image is generated using the N3DCamera methods renderAsTIFF and renderAsEPS.

You generally won't need to use this class directly:  The 3D Graphics Kit ensures that an instance of N3DRenderPanel is created and presented to the user at the appropriate times.  However, you may want to send messages to that instance to add an accessory view or perform other customization.

Instance Variables

id browser

id nametext

id notetext

id resolution

char **hostnames

id accessoryView

browser NXBrowser instance that lists rendering host names
nametext TextField instance that lists the selected host
notetext TextField instance that displays notes about the host
resolution TextField instance that displays rendering resolution
hostnames Pointer to array of names of selected hosts
accessoryView Optional View added by the application

Method Types

Initializing the class + initialize
+ new
Setting accessory view accessoryView
Running modal runModal
Setting resolution resolution
Host management numSelectedHosts
Browser delegate method browser:fillMatrix:inColumn:

Class Methods

+ initialize

Initializes the N3DRenderPanel class by reading data from the defaults database.  You never invoke this method directly; it is invoked for you the first time an instance of N3DRenderPanel is created by your application.

+ new

Creates, if necessary, and returns the application's sole instance of N3DRenderPanel.  Use this method to get the id of this instance--for example, to add an accessory View to the N3DRenderPanel.  It is invoked automatically when an application starts printing a View that generates RIB code, either directly or through a subview.

Instance Methods


Returns the accessory View, an optional View added to the Render panel by the application.

See also:  setAccessoryView:


This method fills the panel's browser with a list of available hosts.  The Render panel is hostBrowser's delegate, and NXBrowser objects send this message whenever a column needs to be updated.  This method fills matrix with the host names and returns the number of names placed in the matrix.

(char **)hostNames

Returns an array of selected host names--the list of names in the Render panel's browser that the user has highlighted.  The number of entries in this array is returned by numSelectedHosts.

See also:  numSelectedHosts


Returns the number of rendering hosts that the user has selected in the Render panel's browser.  The array of selected host names is returned by hostNames.

See also:  hostNames


Returns the rendering resolution specified by the user.  This value represents the number of pixels per inch for images to be rendered by the PhotoRealistic RenderMan renderer.


Presents the Render panel in a modal loop.  Before displaying the panel, this method loads the browser with host names and sets the selected host to that previously selected.  Returns 1 if the modal loop was ended by the user choosing the Render button, 0 if the modal session was ended by the user choosing Cancel.


Sets the receiver's accessory View to aView.  Use this method to add a View containing custom user interface features to your application's instance of N3DRenderPanel.  Returns self.

See also:  accessoryView