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