Evaluates a series of N-dim points as a path The jit.path object takes a series of N-dimensional points retrieves interpolated values based on an input parameter. It is useful for creating user interfaces for parameter morphing. Cycling '74 Jitter point matrix in TEXT_HERE point matrix in TEXT_HERE point matrix TEXT_HERE evaluated matrix TEXT_HERE evaluated values TEXT_HERE dumpout TEXT_HERE Output the point matrix TEXT_HERE Append point values Append point values to the end of the path. If dim is 0, it is set to length of arg list. Calculate the eval matrix Calculate the eval matrix by filling with the evaluated values of the path. The matrix is 1D, the size is equal to the evalmatrixsize, and the planes are equal to path dim. Useful in conjunction with the evalmatrixname attribute when accessing jit.path in javascript. Calculate the point output matrix Calculate the point output matrix by filling with the path point and handle values. The matrix is 2D with the size is equal to number of points, and planes equal to path dim. Useful in conjunction with the outmatrixname attribute when accessing jit.path in javascript. Create a closed path Close the path by adding a point to the end equal to the first point. Evaluate the path using parameter Evaluate the path using parameter, (between 0. and 1.) and output the interpolated values. Evaluate the path using length-parameter Evaluate the path using the length-parameter (between 0 and pathlength) and output the interpolated values. Evaluate the path using time Evaluate the path using time (between 0 and duration) and output the interpolated values. The usetime attribute must be set to 1, causing the first dim of the path to be treated as time values. Delete the point at index Delete the point at index Calculate the path handles Calculate the path handles of each point in the path using the Catmull-Rom method. This will overwrite any previously stored handles. Remove all points from the path TEXT_HERE Edit the point at index Edit the point at index Edit the point handle at index Edit the point handle at index Get handle values at index Get handle values at index and output through dump outlet. Get point values at index Get the point values at index and output through dump outlet. point. Insert a new point at index Insert a new point at index Output eval matrix Output a matrix from the second outlet, filled with the evaluated values of the path. The matrix is 1D, the size is equal to the evalmatrixsize, and the planes are equal to path dim. Advance to next point Advance the path animation to the next point. Rewind to previous point Rewind the path animation to the previous point Set time at index Set time at index. If necessary, the path will be resorted prior to evaluation. Sort path based on time values TEXT_HERE Start path animation TEXT_HERE Stop path animation TEXT_HERE Enable automatic handle calculation Enable the calculation of handle values every time the path is edited (default = 1). Indicates a closed path Indicates the path is closed (first and last points are equal). Path dimension Path dimension and number of planes in point and eval matrices (default = 0). Path duration in seconds Path duration in seconds (default = 0.) Matrix evaluation mode Determines how the eval-matrix is evaluated (default = eval). Normalized by pointcount TEXT_HERE Normalized by pathlength TEXT_HERE Eval matrix name The eval matrix name (default = UID). This is a read-only attribute and is useful in conjunction with the calc_evalmatrix message when accessing jit.path in javascript. Size of the eval-matrix The size of the eval-matrix (default = 100). Time grain used when animating Time grain used when animating in milliseconds (default = 50). Path interpolation method Path interpolation method (default = linear). Linear interpolation TEXT_HERE Hermite interpolation TEXT_HERE Path length Path length (default = 0.) Path animation loop method Path animation loop method (default = 1). TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Point output matrix name The point output matrix name (default = UID). This is a read-only attribute and is useful in conjunction with the calc_outmatrix message when accessing jit.path in javascript. Enable path animation Enable path animation (default = 0). Number of path points Number of path points (default = 0). Animation rate value Animation rate value (default = 1.) Output point matrix receiving input matrix Output point matrix receiving input matrix (default = 1). Current path time value Current path time value (default = 0.) Determine how time values added to path Determine how time values added to the path (default = relative). Time value is set to argument TEXT_HERE Time value is set to argument plus previous time value TEXT_HERE Determine if first path dim is used as time Determine if first path dim is used as time value (default = 0). The jit.path object performs this interpolation using either linear or Hermite spline interpolation. The Hermite splines are automatically calculated using the Catmull-Rom method, which creates a single tangent for each point. The interpolated values are retrieved based on an input parameter. There is also the option of outputting a matrix out the second outlet filled with the interpolated values, with the number of planes equal to the dimension of the path.
Points are added to the path either with messages, or by passing in a 1D matrix of point values. A 2D matrix will be output containing the path points in the first row, and the automatically calculated tangents in the second row.
The length of the path can be calculated by treating the first three dimensions as x/y/z position values. The path can optionally be evaluated based on the length.