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