1#!F-adobe-helvetica-medium-r-normal--18*
2#!N
3#!N  #!Rdisplay Display
4#!N #!N Category #!N #!N  #!Lcatren,dxall760 h Rendering  #!EL  #!N #!N Function #!N #!N
5Displays an image or renders a scene and displays an image.
6#!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N #!N  #!F-adobe-times-bold-r-normal--18*   where
7#!EF = Display(  #!F-adobe-times-bold-r-normal--18*   object, camera, where, throttle #!EF ); #!N
8#!EF #!N #!N #!EC #!N #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N
9TAB Name TAB Type TAB Default TAB Description #!EF #!N TAB
10object TAB object TAB none TAB object to render or image
11to #!N TAB - TAB - TAB - TAB display #!N
12TAB camera TAB camera TAB no default TAB camera if rendering
13is required #!N TAB where TAB window or string TAB the
14user's terminal TAB host and window for display #!N TAB throttle
15TAB scalar TAB 0 TAB minimum time between image frames #!N
16TAB - TAB - TAB - TAB (in seconds) #!N TAB
17- TAB - TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646
18 #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Description #!EF #!N
19TAB where TAB window TAB window identifier for Display window #!N
20TAB - TAB - TAB #!EF #!N #!N Functional Details #!N
21#!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   object #!EF #!EF
22#!I50 #!N is the object to be displayed or to be
23rendered and displayed. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   camera #!EF #!EF
24#!I50 #!N is the camera to be used to render  #!F-adobe-times-bold-r-normal--18*
25object #!EF . If  #!F-adobe-times-bold-r-normal--18*   camera #!EF is not specified, the
26system assumes that  #!F-adobe-times-bold-r-normal--18*   object #!EF is an image to be
27displayed (e.g., the output of the Render module). Note: A transformed
28camera cannot be used for this parameter. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*
29 #!F-adobe-times-bold-r-normal--18*   where #!EF #!EF #!I50 #!N specifies the host and window
30for displaying the image. On a workstation, the format of the
31parameter string is: #!N  #!F-adobe-times-bold-r-normal--18*   X #!EF ,  #!F-adobe-times-bold-i-normal--18*   display, window
32#!EF where  #!F-adobe-times-bold-r-normal--18*   X #!EF refers to the X Window System;
33 #!F-adobe-times-bold-i-normal--18*   display #!EF is an X server name (e.g., host:0); and
34 #!F-adobe-times-bold-i-normal--18*   window #!EF is a window name (and must not begin
35with two #-characters). As a rule, it is not necessary to
36set this parameter. But when it is set, the resulting Image
37window is not controlled by the user interface (e.g., it has
38no menu options). The function of this parameter is to specify
39another workstation on which to display an image (e.g., by setting
40it to "  #!F-adobe-times-medium-i-normal--18*   X, #!EF workstationname  #!F-adobe-times-medium-i-normal--18*   :0, #!EF message").
41Using the Image tool, you can display the same image to
42another workstation simply by connecting the module's two outputs to the
43two inputs of Display and setting  #!F-adobe-times-bold-r-normal--18*   where #!EF . #!N
44#!N If you are using SuperviseState or SuperviseWindow to control user
45interactions in the Display window, then  #!F-adobe-times-bold-r-normal--18*   where #!EF should be
46set with the  #!F-adobe-times-bold-r-normal--18*   where #!EF output of SuperviseWindow. Note: If
47you are using the  #!F-adobe-times-bold-r-normal--18*   where #!EF parameter, it is important
48to set its value  #!F-adobe-times-medium-i-normal--18*   before #!EF the first execution of
49Display. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   throttle #!EF #!EF #!I50 #!N
50specifies a minimum interval between successive image displays. The default is
510 (no delay). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   where #!EF #!EF
52#!I50 #!N The output can be used, for example, by ReadImageWindow
53to retrieve the pixels of an image after Display has run.
54#!I0 #!N #!N #!N #!N #!I0 #!N Notes: #!N #!I30 #!N
551. In the user interface, you must use the Image tool
56rather than Display if you want to use many of the
57interactive image-manipulation functions provided by Data Explorer. For more information, see
58 #!Lchav,dxall300 h Controlling the Image: View Control...  #!EL  in IBM Visualization Data Explorer User's Guide. However, see  #!Lsupwind,dxall961 h SuperviseWindow  #!EL
59and  #!Lsupstat,dxall958 h SuperviseState  #!EL  for a discussion of how to create your own
60interaction modes when using the Display window. #!N #!I30 #!N 2.
61The Display module can render surfaces, volumes, and arbitrary combinations of
62surfaces and volumes. (However, the current volume-rendering algorithm does not support
63coincident or perspective volumes.) To render an object, that object must
64contain a "colors" component. Many modules add a default color. In
65addition, volume rendering (e.g., of cubes, as opposed to lines) requires
66an "opacities" component. all surfaces, the lack of an "opacities" component
67implies an opaque surface. #!N #!I30 #!N 3. Choosing appropriate color
68and opacity maps for volume rendering can be difficult. The AutoColor,
69AutoGrayScale, and Color modules use heuristics to generate good values; as
70a rule of thumb, the opacity should be &approx.0.7/T, and the
71color value &approx.1.4/T (where T is the thickness of the object
72in user units). See also  #!Lcvolrnd,dxall820 h Coloring Objects for Volume Rendering  #!EL  . #!I0 #!N #!N #!N
73#!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Ltall809,dxall809 h Changing the Resolution of an Image  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*
74#!N
75