With the Function Curve functions, you can retrieve and modify values in the function curves. More...

#include <funcinterface.h>

Inheritance diagram for func:

Collaboration diagram for func:

Public Slots
Func Data
int	holdStartFrame (String columnName)
	returns the Start value from the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors.

int	holdStopFrame (String columnName)
	returns the Stop value from the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors

int	holdStep (String columnName)
	returns the Step value from the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors

Functions common to Bezier, Ease and VeloBased
int	numberOfPoints (String columnName)
	returns the number of keyframes and control points on a curve

double	pointX (String columnName, int point)
	returns the X value (frame number) of a point on a function curve

double	pointY (String columnName, int point)
	returns the Y value of a point on a function curve

bool	pointConstSeg (String columnName, int point)
	returns a 1 (one) to indicate that the point is on a ant segment, or a 0 (zero) to indicate that the point is not on a ant segment

String	pointContinuity (String columnName, int point)
	returns the continuity of the curve that follows the point. One of the following values will be returned, in upper-case: SMOOTH, CORNER or STRAIGHT

Bezier Func
double	pointHandleLeftX (String columnName, int point)
	returns the X value of the left handle of a point on a curve

double	pointHandleLeftY (String columnName, int point)
	returns the Y value of the left handle of a point on a curve.

double	pointHandleRightX (String columnName, int point)
	returns the X value of the right handle of a point on a curve.

double	pointHandleRightY (String columnName, int point)
	returns the Y value of the right handle of a point on a curve

Ease Func
double	pointEaseIn (String columnName, int point)
	returns the number of frames in the ease-in

double	angleEaseIn (String columnName, int point)
	returns the angle of the ease-in handle

double	pointEaseOut (String columnName, int point)
	returns the number of frames in the ease-out

double	angleEaseOut (String columnName, int point)
	returns the angle of the ease-out handle

Catmull (Path3d)
int	numberOfPointsPath3d (String columnName)
	returns the number of keyframes and control points on the 3D Path

double	pointXPath3d (String columnName, int point)
	returns the value of the specified point on the X path

double	pointYPath3d (String columnName, int point)
	returns the value of the specified point on the Y path

double	pointZPath3d (String columnName, int point)
	returns the value of the specified point on the Z path

double	pointTensionPath3d (String columnName, int point)
	returns the tension value for the specified point on the 3D Path

double	pointContinuityPath3d (String columnName, int point)
	returns the continuity value (STRAIGHT, SMOOTH or CORNER) for the specified point on the 3D Path.

double	pointBiasPath3d (String columnName, int point)
	returns the bias value for the specified point on the 3D Path

double	pointLockedAtFrame (String columnName, int point)
	returns the frame at which it's locked, or returns 0 if the point is not locked.

Func Edition
bool	setHoldStartFrame (String columnName, int start)
	sets the Start value in the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors

bool	setHoldStopFrame (String columnName, int stop)
	sets the Stop value in the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors

bool	setHoldStep (String columnName, int step)
	sets the Hold value in the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors.

bool	setBezierPoint (String columnName, int frame, double y, double handleLeftX, double handleLeftY, double handleRightX, double handleRightY, bool Seg, String continuity)
	sets the values of a point on a Bezier function curve

bool	setEasePoint (String columnName, int frame, double y, double easeIn, double angleEaseIn, double easeOut, double angleEaseOut, bool Seg, String continuity)
	sets the values of a point on an Ease function curve

bool	setVeloBasedPoint (String columnName, int frame, double y)
	sets the values of a point on a Velocity-Based function curve

bool	addKeyFramePath3d (String columnName, int frame, double x, double y, double z, double tension, double continuity, double bias)
	adds a keyframe to a 3D Path and sets the X, Y and Z value, as well as the tension, continuity and bias.

bool	addCtrlPointAfterPath3d (String columnName, int point, double x, double y, double z, double tension, double continuity, double bias)
	adds a keyframe after a point on a 3D Path and sets the X, Y and Z values, as well as the tension, continuity and bias

bool	removePointPath3d (String columnName, int point)
	removePointPath3d may be used to remove either a key frame, or a control point

bool	setPointPath3d (String columnName, int point, double x, double y, double z, double tension, double continuity, double bias)
	setPointPath3d may be used to set values in either a key frame, or a control point, but cannot change a key frame into a control point or a control point into a key frame. To change a key frame into a control point or a control point into a key frame, you must remove the point and add a new point.

bool	setPath3dPointConstantSegment (String columnName, int point, bool ant)
	sets the ant segment flag of point i of path p to b.

bool	setPath3dPointConstantSegmentForFrame (String columnName, double point, bool ant)
	sets the ant segment flag of point found at frame f of path p to b.

Detailed Description

With the Function Curve functions, you can retrieve and modify values in the function curves.

You can use it in Script Editor only.

function addSetFunctions()
{
  //creates the function columns if needed
  if ( !column.add("3DPATH_FUNC", "3DPATH") )
     System.println( "Error creating 3dpath column" );
  if ( !column.add("BEZIER_FUNC", "BEZIER") )
    System.println( "Error creating bezier column" );
  if ( !column.add("EASE_FUNC", "EASE") )
    System.println( "Error creating ease column" );
  // adds 2 keyframes on a 3DPATH at frame 6 and 12
  // with values x=2, y=2, z=1, tension=3, continuity=-1, bias=1
  func.addKeyFrame3DPath( "3DPATH_FUNC", 6, 2, 2, 1, 3, -1, 1 );
  func.addKeyFrame3DPath( "3DPATH_FUNC", 12, 2, 2, 1, 3, -1, 1);
  // removes a keyframe on 3DPATH at frame 12
  func.removePoint3DPath( "3DPATH_FUNC", 12 );
  // prints the number of points on a 3DPath column
  var pathPoints = func.numberOfPoints3DPath("3DPATH_FUNC");
  System.println( "3DPATH_FUNC column has " + pathPoints + "points" );
  // adds a keyframe on a BEZIER at frame 10 with values y=5,
  // handle_leftx=9, handle_lefty=5, handle_rightx=12,
  // handle_righty=-0.5, ant seg=false, continuity=smooth
  if ( ! func.setBezierPoint( "BEZIER_FUNC", 10, 5, 9, 5, 12, - 0.5, false, "SMOOTH" ) )
    System.println( "Error creating point on bezier" );
  // sets the step value for a function column starting at frame 1 upto frame 15 hold 2
  func.setHoldStartFrame("BEZIER_FUNC", 1);
  func.setHoldStopFrame("BEZIER_FUNC", 15);
  func.setHoldStep("BEZIER_FUNC", 2);
  // prints the number of points on a function column
  var bezPoints = func.numberOfPoints("BEZIER_FUNC");
  System.println( "BEZIER_FUNC column has " + bezPoints + " points" );
  // adds a keyframe on an EASE at frame 10 with values y=5,
  // ease_inx=0, ease_iny=0, ease_outx=0, ease_outy=180
  // ant seg=true, continuity=straight
  if ( ! func.setEasePoint( "EASE_FUNC", 10, 6, 0, 0, 0, 180, true, "STRAIGHT" ) )
  System.println( "Error creating point on ease" );

Member Function Documentation

bool func::addCtrlPointAfterPath3d	(	String	columnName,
		int	point,
		double	x,
		double	y,
		double	z,
		double	tension,
		double	continuity,
		double	bias
	)

slot

adds a keyframe after a point on a 3D Path and sets the X, Y and Z values, as well as the tension, continuity and bias

Parameters

columnName,:	The name of the column
point	: The number of the point on the curve, from 0 to n, where n is the total number of points. The last point on the curve is n-1.
x,:	x value for the point
y,:	Y value for the point
z,:	z value for the point
tension,:	tension value of the keyframe
continuity,:	continuity value of the keyframe
bias,:	bias value of the keyframe

bool func::addKeyFramePath3d	(	String	columnName,
		int	frame,
		double	x,
		double	y,
		double	z,
		double	tension,
		double	continuity,
		double	bias
	)

slot

adds a keyframe to a 3D Path and sets the X, Y and Z value, as well as the tension, continuity and bias.

Parameters

columnName,:	The name of the column
frame,:	Frame number for the point
x,:	x value for the point
y,:	Y value for the point
z,:	z value for the point
tension,:	tension value of the keyframe
continuity,:	continuity value of the keyframe
bias,:	bias value of the keyframe

double func::angleEaseIn	(	String	columnName,
		int	point
	)

slot

returns the angle of the ease-in handle

Parameters

columnName,:	The name of the column
point	: The number of the point on the curve, from 0 to n, where n is the total number of points. The last point on the curve is n-1.

double func::angleEaseOut	(	String	columnName,
		int	point
	)

slot

returns the angle of the ease-out handle

Parameters

columnName,:	The name of the column
point	: The number of the point on the curve, from 0 to n, where n is the total number of points. The last point on the curve is n-1.

int func::holdStartFrame ( String columnName )

slot

returns the Start value from the Hold Value Editor dialog box, for Bezier, Ease and Velo-based Function Editors.

Parameters