source: trunk/packages/vizservers/vtkvis/protocol.txt @ 2453

Last change on this file since 2453 was 2453, checked in by ldelgass, 13 years ago

Add legend type option for selecting active scalar field, active vector field
magnitude or component ranges for labels.

  • Property svn:eol-style set to native
File size: 14.9 KB
Line 
1================================================================================
2On connection, send 32-bit little endian int indicating memory requirements
3(comsumed by nanoscale server before exec-ing vtkvis)
4================================================================================
5Requests:
6
7screen bgcolor <r> <g> <b>
8screen size <width> <height>
9
10renderer clipplane <axis> <ratio> <direction>
11         Set a user clipping plane, ratio is [0,1] and is always interpreted as
12         0 = min_bound, 1 = max_bound, regardless of direction.  Sign of
13         direction determines normal of clipping plane.  User clip planes do not
14         apply if camera mode is image.
15renderer depthpeel <bool>
16         Set use of depth peeling algorithm for transparency
17renderer light2side <bool>
18         Toggle use of two-sided lighting (controls if backfaces are lit with a
19         flipped normal)
20renderer render
21         Force a new image to be rendered - use for advancing animation
22
23axis color <r> <g> <b>
24     Set color of axis lines, labels, titles, ticks
25axis flymode <mode>
26     <mode> = static_edges|static_triad|outer_edges|furthest_triad|closest_triad
27axis grid <bool>
28axis labels <axis> <bool>
29     Toggle visibility of axis labels
30     <axis> = x|y|z|all
31axis name <axis> <title>
32axis tickpos <position>
33     Set position of ticks on 3D axes (not implemented for 2D axes)
34     <position> = inside|outside|both
35axis ticks <axis> <bool>
36     Toggle visibility of axis tick marks
37     <axis> = x|y|z|all
38axis units <axis> <units>
39     Currently only supported when camera mode is not image mode
40axis visible <axis> <bool>
41     <axis> = x|y|z|all
42     Note: 'all' means all enabled axes.  To force all axes on, set each axis on
43     individually -- however, it is best to let the server determine which of
44     the individual axes are enabled based on the dataset bounds.
45
46camera get
47       Request current camera parameters
48camera mode <mode>
49       <mode> = persp|ortho|image
50camera orient <quatW> <quatX> <quatY> <quatZ>
51       Set scene orientation using a quaternion
52camera ortho <coordMode> <x> <y> <width> <height>
53       <coordMode> = pixel|world
54       Supply bounds of plot area for image camera mode
55camera pan <x> <y>
56       <x,y> viewport coordinates (window center at 0,0).  Positive x pan
57       means pan object to right (camera to left).  Positive y pan means
58       pan object down (camera up).  For example a pan of 0.5, 0.5 would
59       move the object center to the lower right corner of the window
60camera reset <?all?>
61       Option all resets orientation/rotation as well as pan/zoom/clip range
62camera rotate <yaw> <pitch> <roll>
63       Specify relative rotation in Euler angles
64camera set <posX> <posY> <posZ> <focalPtX> <focalPtY> <focalPtZ> <viewUpX> <viewUpY> <viewUpZ>
65       Set camera parameters: camera position, focal point and view up vector
66camera zoom <z>
67       Specify zoom ratio.  z > 1 is a zoom in, z < 1 is zoom out. z = 1
68       resets to default.
69
70colormap add <colorMapName> <colorMap> <opacityMap>
71         colorMap = Tcl list of {value r g b} control points
72         opacityMap = Tcl list of {value alpha} control points
73colormap delete <?colorMapName?>
74
75legend <colormapName> <legendType> <legendTitle> <width> <height> <?datasetName?>
76       Causes legend to be rendered and written back with labels and title
77       (title may be left blank)
78       <legendType> = scalar|vmag|vx|vy|vz
79       If datasetName is omitted, the cumulative data range of all data sets
80       will be used to label the legend -- otherwise, the current setting of
81       'dataset maprange' will be used to determine if the individual dataset
82       range or cumulative range will be used.
83
84dataset add <datasetName> data follows <nbytes>
85dataset delete <?datasetName?>
86dataset getscalar world <x> <y> <z> <datasetName>
87dataset getscalar pixel <x> <y> <datasetName>
88dataset getvector world <x> <y> <z> <datasetName>
89dataset getvector pixel <x> <y> <datasetName>
90        Use pixel for image camera mode
91dataset maprange <val>
92        <val> = all|visible|separate
93        Controls if data range for colormapping and contours is based on
94        cumulative range of all datasets ("all"), only visible datasets
95        ("visible") or each individual dataset ("separate").  Defaults to
96        "all"
97dataset opacity <val> <?datasetName?>
98dataset scalar <scalarName> <?datasetName?>
99        Set the active scalar field to plot
100dataset vector <vectorName> <?datasetName?>
101        Set the active vector field to plot
102dataset visible <bool> <?datasetName?>
103
104contour2d add numcontours <n> <?datasetName?>
105          Generate evenly spaced contours including range endpoints.  See also
106          'dataset maprange' command.
107contour2d add contourlist <list> <?datasetName?>
108          list = {isoval1 isoval2 isoval3...}
109contour2d delete <?datasetName?>
110contour2d lighting <bool> <?datasetName?>
111contour2d linecolor <r> <g> <b> <?datasetName?>
112contour2d linewidth <val> <?datasetName?>
113contour2d opacity <val> <?datasetName?>
114contour2d orient <qw> <qx> <qy> <qz> <?dataSetName?>
115contour2d pos <x> <y> <z> <?dataSetName?>
116contour2d scale <sx> <sy> <sz> <?dataSetName?>
117contour2d visible <bool> <?datasetName?>
118
119contour3d add numcontours <n> <?datasetName?>
120          Generate evenly spaced contours including range endpoints.  See also
121          'dataset maprange' command.
122contour3d add contourlist <list> <?datasetName?>
123          list = {isoval1 isoval2 isoval3...}
124contour3d ccolor r g b <?datasetName?>
125contour3d colormap <colorMapName> <?dataSetName?>
126contour3d delete <?datasetName?>
127contour3d edges <bool> <?datasetName?>
128contour3d lighting <bool> <?datasetName?>
129contour3d linecolor <r> <g> <b> <?datasetName?>
130contour3d linewidth <val> <?datasetName?>
131contour3d opacity <val> <?datasetName?>
132contour3d orient <qw> <qx> <qy> <qz> <?dataSetName?>
133contour3d pos <x> <y> <z> <?dataSetName?>
134contour3d scale <sx> <sy> <sz> <?dataSetName?>
135contour3d visible <bool> <?datasetName?>
136contour3d wireframe <bool> <?datasetName?>
137
138glyphs add <?dataSetName?>
139glyphs ccolor r g b <?datasetName?>
140glyphs colormap <colorMapName> <?dataSetName?>
141glyphs colormode <scale|scalar|vmag|ccolor> <?dataSetName?>
142       Set the color mode: color by scale, scalar field or
143       vector magnitude -- uses the current color map
144glyphs delete <?dataSetName?>
145glyphs edges <bool> <?datasetName?>
146glyphs gscale <scaleFactor> <?datasetName?>
147       Set glyph scaling factor
148glyphs lighting <bool> <?datasetName?>
149glyphs linecolor <r> <g> <b> <?datasetName?>
150glyphs linewidth <val> <?datasetName?>
151glyphs opacity <val> <?datasetName?>
152glyphs orient <qw> <qx> <qy> <qz> <?dataSetName?>
153glyphs pos <x> <y> <z> <?dataSetName?>
154glyphs scale <sx> <sy> <sz> <?dataSetName?>
155glyphs shape <arrow|cone|cube|cylinder|dodecahedron|icosahedron|line|octahedron|sphere|tetrahedron> <?datasetName?>
156glyphs smode <scalar|vmag|vcomp|off> <?dataSetName?>
157       Set the scaling mode: use the scalar field, vector magnitude
158       (uniform scale), vector components, or disable scaling
159glyphs visible <bool> <?datasetName?>
160glyphs wireframe <bool> <?datasetName?>
161
162heightmap add numcontours <n> <heightScale> <?dataSetName?>
163          Generate evenly spaced contours including range endpoints.  See also
164          'dataset maprange' command.
165heightmap add contourlist <list> <heightScale> <?dataSetName?>
166          list = {isoval1 isoval2 isoval3...}
167heightmap colormap <colorMapName> <?dataSetName?>
168heightmap contourlist <list> <?dataSetName?>
169heightmap delete <?dataSetName?>
170heightmap edges <bool> <?dataSetName?>
171heightmap heightscale <value> <?dataSetName?>
172heightmap isolinecolor <r> <g> <b> <?dataSetName?>
173heightmap isolines <bool> <?dataSetName?>
174heightmap isolinewidth <width> <?dataSetName?>
175heightmap lighting <bool> <?dataSetName?>
176heightmap linecolor <r> <g> <b> <?dataSetName?>
177heightmap linewidth <width> <?dataSetName?>
178heightmap numcontours <n> <?dataSetName?>
179heightmap opacity <value> <?dataSetName?>
180heightmap orient <qw> <qx> <qy> <qz> <?dataSetName?>
181heightmap pos <x> <y> <z> <?dataSetName?>
182heightmap scale <sx> <sy> <sz> <?dataSetName?>
183heightmap surface <bool> <?dataSetName?>
184          Toggle rendering of colormapped surface (mountain plot or cutplane)
185heightmap visible <bool> <?dataSetName?>
186heightmap volumeslice axis ratio <?dataSetName?>
187          For 3D data, select a slice along a principle axis of the volume. The
188          ratio is [0,1]
189heightmap wireframe <bool> <?datasetName?>
190
191lic add <?datasetName?>
192lic colormap <colormapName> <?datasetName?>
193lic delete <?datasetName?>
194lic edges <bool> <?datasetName?>
195lic lighting <bool> <?datasetName?>
196lic linecolor <r> <g> <b> <?datasetName?>
197lic linewidth <val> <?datasetName?>
198lic opacity <val> <?datasetName?>
199lic orient <qw> <qx> <qy> <qz> <?dataSetName?>
200lic pos <x> <y> <z> <?dataSetName?>
201lic scale <sx> <sy> <sz> <?dataSetName?>
202lic visible <bool> <?datasetName?>
203lic volumeslice <axis> <ratio> <?datasetName?>
204
205molecule add <?datasetName?>
206molecule atoms <bool> <?datasetName?>
207         Toggle rendering of atoms
208molecule bonds <bool> <?datasetName?>
209         Toggle rendering of bonds
210molecule colormap <colormapName> <?datasetName?>
211molecule delete <?datasetName?>
212molecule edges <bool> <?datasetName?>
213molecule lighting <bool> <?datasetName?>
214molecule linecolor <r> <g> <b> <?datasetName?>
215molecule linewidth <val> <?datasetName?>
216molecule opacity <val> <?datasetName?>
217molecule orient <qw> <qx> <qy> <qz> <?dataSetName?>
218molecule pos <x> <y> <z> <?dataSetName?>
219molecule rscale <val> <?dataSetName?>
220         Atom radius scaling
221         val = van_der_walls|covalent|atomic|none
222molecule scale <sx> <sy> <sz> <?dataSetName?>
223molecule visible <bool> <?datasetName?>
224molecule wireframe <bool> <?datasetName?>
225
226polydata add <?datasetName?>
227polydata color <r> <g> <b> <?datasetName?>
228polydata delete <?datasetName?>
229polydata edges <bool> <?datasetName?>
230polydata lighting <bool> <?datasetName?>
231polydata linecolor <r> <g> <b> <?datasetName?>
232polydata linewidth <val> <?datasetName?>
233polydata opacity <val> <?datasetName?>
234polydata orient <qw> <qx> <qy> <qz> <?dataSetName?>
235polydata pos <x> <y> <z> <?dataSetName?>
236polydata ptsize <size> <?dataSetName?>
237polydata scale <sx> <sy> <sz> <?dataSetName?>
238polydata visible <bool> <?datasetName?>
239polydata wireframe <bool> <?datasetName?>
240
241pseudocolor add <?datasetName?>
242pseudocolor colormap <colormapName> <?datasetName?>
243pseudocolor delete <?datasetName?>
244pseudocolor edges <bool> <?datasetName?>
245pseudocolor lighting <bool> <?datasetName?>
246pseudocolor linecolor <r> <g> <b> <?datasetName?>
247pseudocolor linewidth <val> <?datasetName?>
248pseudocolor opacity <val> <?datasetName?>
249pseudocolor orient <qw> <qx> <qy> <qz> <?dataSetName?>
250pseudocolor pos <x> <y> <z> <?dataSetName?>
251pseudocolor scale <sx> <sy> <sz> <?dataSetName?>
252pseudocolor visible <bool> <?datasetName?>
253pseudocolor wireframe <bool> <?datasetName?>
254
255streamlines add <?datasetName?>
256streamlines ccolor <r> <g> <b> <?datasetName?>
257            Set the constant color of streamlines used for color mode 'ccolor'
258streamlines colormap <colormapName> <?datasetName?>
259            Colormap used to color streamlines/tubes/ribbons by vector magnitude
260streamlines colormode <scalar|vmag|vx|vy|vz|ccolor> <?datasetName?>
261            Set the field used to color the streamlines.  'ccolor' means to use
262            the constant color defined by the ccolor subcommand.  'scalar' uses
263            the active scalar field.  'vmag' uses the magnitude of the current
264            vector field, and 'vx','vy','vz' use the corresponding component of
265            the active vector field.
266streamlines delete <?datasetName?>
267streamlines edges <bool> <?datasetName?>
268            Turn on/off edges for tubes, ribbons
269streamlines length <?datasetName?>
270            Set maximum length in world coordinates of streamlines
271streamlines lighting <bool> <?datasetName?>
272streamlines linecolor <r> <g> <b> <?datasetName?>
273            Set color of edges for tubes, ribbons (lines are colored by colormap)
274streamlines lines <?datasetName?>
275            Set rendering type to polylines
276streamlines linewidth <val> <?datasetName?>
277streamlines opacity <val> <?datasetName?>
278streamlines orient <qw> <qx> <qy> <qz> <?dataSetName?>
279streamlines pos <x> <y> <z> <?dataSetName?>
280streamlines ribbons <width> <angle> <?datasetName?>
281            Set rendering type to ribbons, width is minimum half-width, angle is
282            degrees offset from normal orientation
283streamlines scale <sx> <sy> <sz> <?dataSetName?>
284streamlines seed color <r> <g> <b> <?datasetName?>
285streamlines seed disk <centerX> <centerY> <centerZ> <normalX> <normalY> <normalZ> <radius> <innerRadius> <numPoints> <?dataSetName?>
286            Create a disk seed area with optional hole, filled with randomly
287            placed points
288streamlines seed fpoly <centerX> <centerY> <centerZ> <normalX> <normalY> <normalZ> <angle> <radius> <numSides> <numPoints> <?dataSetName?>
289            Create a regular n-sided polygonal seed area filled with randomly
290            placed points
291streamlines seed polygon <centerX> <centerY> <centerZ> <normalX> <normalY> <normalZ> <angle> <radius> <numSides> <?dataSetName?>
292            Create seed points from vertices of a regular n-sided polygon
293streamlines seed rake <startX> <startY> <startZ> <endX> <endY> <endZ> <numPoints> <?datasetName?>
294streamlines seed random <numPoints> <?datasetName?>
295streamlines seed visible <bool> <?datasetName?>
296streamlines tubes <numSides> <radius> <?datasetName?>
297            Set rendering type to tubes, numSides is number of sides of tubes,
298            radius is minimum tube radius
299streamlines visible <bool> <?datasetName?>
300
301volume add <?datasetName?>
302volume colormap <colorMapName> <?datasetName?>
303volume delete <?datasetName?>
304volume lighting <bool> <?datasetName?>
305volume orient <qw> <qx> <qy> <qz> <?dataSetName?>
306volume pos <x> <y> <z> <?dataSetName?>
307volume scale <sx> <sy> <sz> <?dataSetName?>
308volume shading ambient <coeff> <?datasetName?>
309volume shading diffuse <coeff> <?datasetName?>
310volume shading specular <coeff> <power> <?datasetName?>
311volume visible <bool> <?datasetName?>
312
313================================================================================
314Replies:
315
316nv>camera set <posX> <posY> <posZ> <focalPtX> <focalPtY> <focalPtZ> <viewUpX> <viewUpY> <viewUpZ>
317   Reply to "camera get"
318nv>image -type image -bytes <nbytes>
319  <binary RGB data>
320nv>image -type image -bbox {x y w h} -bytes <nbytes>
321  <binary RGB data>
322  The bounding box of the 2D image camera zoom region is supplied
323  Note: The bbox coordinates are in the form used by 'camera ortho world ...':
324  x,y - world coordinate of lower left corner, w,h - width height in world coords
325  This form is currently used only if the camera mode is set to 'image'.
326nv>legend <colormapName> <nbytes>
327  <binary RGB data>
328nv>dataset scalar world <x> <y> <z> <value> <dataSetName>
329nv>dataset scalar pixel <x> <y> <value> <dataSetName>
330nv>dataset vector world <x> <y> <z> <valueX> <valueY> <valueZ> <dataSetName>
331nv>dataset vector pixel <x> <y> <valueX> <valueY> <valueZ> <dataSetName>
332
333================================================================================
334Errors:
335
336Prefixed with "VtkVis Server Error: "
337Currently not guaranteed to be on a single line
Note: See TracBrowser for help on using the repository browser.