PointView

Extension

Create a new PointView.

Arguments:

Set the Array of Cartesian points to display. If resetConnections is false, any previously set -connections will remain, otherwise the default connections will be set to sequential indices [[0, 1, ... numPoints-1]].

Set the directions of points to display. dirArray can be an Array of:

• Arrays in the form of [[azimuth, inclination], [azimuth, inclination], ...] in radians, where rho is assumed to be 1. i.e. points on a unit circle.
• Arrays in the form of [[azimuth, inclination, rho], [azimuth, inclination, rho], ...] in radians.
• Spherical objects.

If resetConnections is false, any previously set -connections will remain, otherwise the default connections will be set to sequential indices [[0, 1, ... numPoints-1]]. Directions are converted to Cartesian points internally.

Set/get the list of indices which are connected by lines.

Arguments:

Set a Boolean whether the end and start point of connection groups should be connected.

Return an Array of triplets which are the indices of points forming the triangulation mesh across the points, similar to a convex hull. The results can be passed to -connectTriplets to display the triangulations. Returns nil if the triangulations can't be calculated.

Set an Array of Arrays, each listing the indices of points in groups of three that form a triangulation mesh across the points. This method is more efficient than setting connections to be the triplets directly, because it avoids repeated connections.

Get the number of points displayed.

arrayOfColors can be a single Color, Array of Colors. If (arrayOfColors.size != numPoints), points will wrap through the color array.

Set the points to colors within a hue range. hueLow and hueHighare 0 <= hue < 1. Optionally specify saturation, value, and alpha, which are bound as in Color: *hsv. If scramble is true, the colors will be randomly distributed among the points instead of hues ascending with index.

arrayOfColors can be a single Color, Array of Colors. If (colorGroups.size != groupColors.size), groups will wrap through the color array. Indices not listed in the -colorGroups will be assigned the defaultColor.

An Array of Arrays containing point indices to be set to each of the -groupColors. If (colorGroups.size != groupColors.size), groups will wrap through the -groupColors array. Indices not listed in the -colorGroups will be assigned the defaultColor.

A Boolean toggling the connection lines on and off. -connections must be set.

Set/Get the color(s) of the lines showing the -connections. This can be a Color or an Array of Colors, one for each connection (i.e. the array size should equal connections.size, if smaller the connection colors will wrap through the provided array).

Get/set the stroke width of connection lines in pixels. The size determins the stroke width of the line nearest to the viewer, the farthest connection line widths will be scaled by -pointDistScale. This can be a Number or an Array of Numbers, one for each connection (i.e. the array size should equal connections.size, if smaller the connection stroke widths will wrap through the provided array).

A Boolean flag stating whether the display the axes at the origin. The length of the axes can be set with -axisScale.

Set the stroke width of the axes at the origin, in pixels.

A 3-element Array of Colors in the order [x,y,z].

Adjust the length of the axes. scale of 1 makes the axes as long as the distance to the outermost point. Show/hide the axes with -showAxes.

A Boolean flag indicating whether to display the point indices or not.

Set the Color of the text of the points' indices.

The diameter of the points, in pixels. If -renderDistanceSize is true, the nearest point will be the specified size;

Arguments:

Provide emphasis on specific points in the view through color.

Arguments:

Restore the points' colors to the state before they were set to -highlightPoints.

Set the units, 'radians' or 'degrees', used by the GUI.

The rotation of the displayed points, on each axis, in radians. Default positive directions are:

• rotate: counter-clockwise
• tilt: left-up
• tumble: front-up

A flag to specify the direction of rotation on each or all axes. A dir of 1 will select the default direction for that axis (see above) while -1 will invert the direction of rotation.

Reset rotations to defaults. (rotate = -45.degrad, tilt = 0, tumble = 0)

Set the order of rotations when applying compound rotations to the points. 'rtt' for Rotate-Tilt-Tumble, 'ypr' Yaw-Pitch-Roll.

A Boolean flag stating whether the display (including axes) will oscillate around each axis or all axes.

The period of oscillation on each axis or all axes, in seconds.

Set the oscillation width of each axis or all axes, in radians.

A Boolean flag stating whether the display (including axes) will rotate cyclically around each axis or all axes.

The cycle period of each axis or all axes, in seconds.

The cycle period of each axis or all axes, in Hertz.

Set an axis ('rotate', 'tilt', or 'tumble') with a Boolean flag to randomize its motion, if it's oscillating or cycling.

Set the random variance applied to those axes for which -varyMotion is true. The value of variance is normalized to the phase increment of each frame, so a variance of 0 has no effect, while a variance of 1 could potentially step twice as far (twice as fast) on each frame. Default is 0.15.

Set the framerate of the animation if the view is set to cycle (-rotateCyc) or oscillate (-rotateOsc).

Set the view to a flat orthographic projection along axis. This is useful for displaying symmetry of points through a plane.

Arguments:

Set the view to render the points in perspective (as opposed to an orthogonal view).

Translate the origin of the display on the X axis. A norm of -1 and 1, is far left and right of the view, respectively.

Translate the origin of the display on the Y axis. A norm of -1 and 1, is bottom and top of the view, respectively.

Skew the perspective along the screen's X axis. A useful range of norm is 0 to 1.

Skew the perspective along the screen's Y axis. A useful range of norm is 0 to 1.

Move the origin of your points closer or farther from the screen. A useful range for norm values is about -0.5 (close) to 3 (far), but it depends also on the -eyeDist.

A value which makes the the depth of the perspective more or less pronounced, qualitatively similar to moving your eye or a lens nearer or farther from your points. Useful norm values in a range of 1.5 (more warped) to 6 (less) are reasonable, but it depends also on the -originDist.

A Boolean to determine if point size changes with distance to enhance 3D effect.

Scale the size of the points with distance. A norm of 0.5 would scale the farthest point to be one half the size of the nearest point.

Refresh the view. Most methods which change render settings refresh the view automatically.

Returns the UserView which is used for drawing the point display.

Return the Array of Cartesian points used internally for plotting. i.e. normalized to a radius of 1.

Return the Array as Points, in pixels, relative to the center of the view. I.e. left of center will be a negative X value and above center will be a negative Y value.

Export the view to an image file.

Arguments: