<<<<<<<<<<<<<<<<<

display_surface(display) Display display_surface(display)

NAME

display_surface - a modeller to represent surface data in display data.

DESCRIPTION

Display_surface takes as input a display_data (or display_filter) object, generating on output graphics primitives that represent the surface information in display_data. Display_surface is a modeller, that is, it provides the usual methods of a modeller including transformation. Currently the surface information in the display_data object are triangle strips and polygons. The components of the surface data in display_data may be turned on/off using the appropriate instance variables.

Display_surface functions by creating instances of display_polygons and display_triangle_strips and then managing these. Alternatively, these instances may be set by the user for direct control of the data primitives (for example, to use the mask instance variable to turn on/off portions of the data).

SUPERCLASS

display_modeller

INSTANCE VARIABLES

display_polygons the name of the display_polygons object to display the polygons in display_data.

display_triangle_strips the name of the display_triangle_strips object to display the triangle strips in display_data.

polygons_visibility boolean variable to turn on/off display of polygons.

triangle_strips_visibility boolean variable to turn on/off display of triangle strips.

MESSAGES

display_polygons= name set the name of the display_polygons modeller.

display_polygons? name get the name of the display_polygons modeller.

display_triangle_strips= name set the name of the display_triangle_strips modeller.

display_triangle_strips? name get the name of the display_triangle_strips modeller.

polygons_visibility_on!, polygons_on! turn on the display of polygons.

polygons_visibility_off!, polygons_off! turn off the display of polygons.

polygons_visibility= value set the value of the polygons boolean instance variable. If =0, polygons are off, if !=0, polygons are on.

polygons_visibility? get the value of the polygons boolean instance variable.

triangle_strips_visibility_on!, triangle_strips_on! turn on the display of triangle_strips.

triangle_strips_visibility_off!, triangle_strips_off! turn off the display of triangle_strips.

triangle_strips_visibility= value set the value of the triangle_strips boolean instance variable. If =0, triangle_strips are off, if !=0, triangle_strips are on.

triangle_strips_visibility? get the value of the triangle_strips boolean instance variable.

all_on! turn on the display of all the componenets of display_data.

all_off! turn off the display of all the componenets of display_data.

EXAMPLE

In this example a structured grid set is read and a i,j,k plane of the grid is drawn. An outline of the object is displayed as well.

/* * read in the data */ string new: data_name=bluntfin;

plot3d_reader new: areader file_prefix=data_name

; /* * set up some displays */ display_geometry new: g1 data_in= areader extent=(1,100,1,100,1,1) ; display_surface new: draw_g1 data_in= g1 range= ([areader range?]) ; actor new: a modeller=draw_g1 ; data_outline new: outline data_in= areader ; display_lines new: draw_outline data_in=outline ; actor new: outline_actor modeller= draw_outline ; camera new: acamera position=(1,1,1) range=[areader bounds?] default! on! ;

renderer new: main_renderer actors= [actor instances?] cameras= acamera render! ;