poi - Point display
Name
poi — Point display
Syntax
poi [size] [sel] [val] [fd] [nfo | x | y | z] [use] [col] [sav] [start | stop] [map | type | cep | seq | cnu | ref | pos | loc | cur | txt | rod | num [ncp] | cel | coor | win | lim | pse | cpo]
Description
Display points and information about the points and cells of the active dataset.
Arguments
[size]
Display the points of the active dataset with the current marker symbol. Optionally apply the [size] parameter.
sel | pse selection
Display with a selection frequency. The pse option may be faster for large datasets.
val [xco | yco | zco | sca]
Display the z value of the points, optionally the values of xcoordinate | ycoordinate | zcoordinate | scalar.
[split] fd fielddataname [fielddataname2 ...]
Display the field data values of fielddataname and optionally fielddataname2....
The split argument is used if there are two fielddata references and one wants to split them to each side of the point position. Put the split argument in front of fd.
Put always fd and arguments at the end of the poi command.
val | fd tx2 | tx3 | vec
Display the z value or field data of the points, using text font specification.
- tx2 - Set textfont to 2d font. This is default. The text is overall visible.
- tx3 - Set textfont to 3d font. The text is overall visible.
- vec - Set textfont to 3d vector text font. The text is not visible behind a solid object. Can be slow for many values.
val ... offset offset_value
The point values are displayed with an offset of size offset_value. The offset_value follows the z-direction; i.e. positive values are shifted downwards when the z axis points downwards.
nfo [x | y | z]
Default is that values are displayed in follower mode; e.g. facing the camera. Using the nofollower option nfo the point values will have a fixed orientation according to x | y | z.
cep
Display the end points for all cells.
use
Use active pointmarker even if it is a large point dataset and greater than the limitation for using the marker symbol.
win
Display points only within the window frame.
num number
Display point number number.
num ncp [val | ava]
Display the point nearest cursor position. Optionally annotate the value (val) or the sequence number value (ava) at the point.
lim limit
Limit the number of display points to limit. The system has some limits that can be overridden by this argument.
start start_from stop stop_before
Display from start_from to stop_before of the point sequence.
map [range1 range2]
Map the point markers using range values.
ref | pos | loc | cur | txt limit
Display the point marker at one of these system points.
sav
Save displayed point markers in workspace ^sav.
rod
Display vertical lines through the points.
cel number
Display points markers or values for cell number at this cell.
cnu [number]
Display cell numbers in the middle of the cell. Optionally display only the cell number.
seq [cel cell_number]
Will display the point sequence number for the points; either all points or only for a specific cell number.
coor x y z
Display point at coordinate position x y z.
col color
Display in color red/gre/blu/...etc.
cpo
Display scalar value at cursor position. Valid for cubes.
type number
Display the markers with type setting. The behavior depends on the point scalars.
Various type numbers
1 - ScaleMode scale_number.
2 - ScaleModeToDataScalingOff
3 - ScaleModeToScaleByVector
4 - ScaleModeToScaleByVectorComponents
5 - ColorModeToColorByScale
6 - ColorModeToColorByScalar
7 - ColorModeToColorByVector
8 - ScaleFactor scale_factor.
9 - Display according to z value
Example of using type number:
#will display size of marker symbol according to scalar value. set scale_factor 2.5 poi type 5 $scale_factor poi type 8 $scale_factor
Display limits
Default marker is the pixel. The max number of markers displayed with pixels is 4000000 found in lst i 64 and changed by val i 64 number.
The other markers have a max display number of 5000 found in lst i 34 and changed by val i 34 number.
Point values have a max display number of 5000 found in lst i 34 and changed by val i 34 number.
Examples
Ex.1: Different marker types
# Shows the different marker types. z ;# Erase screen win demo ;# Get demo window (450000 460000 6450000 6460000 1000 4000) spe bgc whi ;# Specify background color to white set i 0 ;# Initialize i while {$i lt 8} { ;# While i is lower than 8 (replace lt symbol with correct) spe mar $i ;# set marker symbol (0 to 7) mak ran 3 ;# make random points poi 5 ;# display points with size 5 incr i ;# increment i }
The above example produces this image.
Different point marker types
Ex.1: Marker size according to scalar value
# Marker size depends on scalar value z ;# Erase screen win demo ;# Get demo window (450000 460000 6450000 6460000 1000 4000) spe bgc whi ;# Specify background color to white set i 0 ;# Initialize i spe mar sphere ;# Set marker symbol to sphere mak ran 22 ;# Make random points mak ras ;# Make random scalars poi map type 8 .1 ;# Map points with type 8; size depends on scalar value
The above example produces this image.
Marker size depends on scalar value
See also
lin poi , mak poi , pol - Polygon type display , spe mar