mpiMotionModify

Declaration 
long mpiMotionModify(MPIMotion       motion,
                     MPIMotionType   type,
                     MPIMotionParams *params)
Required Header stdmpi.h
Description

MotionModify modifies the parameters of a Motion object (motion) if motion is in progress (MPIStateMOVING). The types of motion whose parameters can be modified while moving are MPIMotionTypeTRAPEZOIDAL, MPIMotionTypeS_CURVE, MPIMotionTypeVELOCITY, MPIMotionTypePT and MPIMotionTypePVT.

Use the MPIMotionAttrAUTO_START attribute to automatically start a motion profile if the MotionModify call is made too late (i.e., after the previous move has finished).

Return Values
MPIMessageOK if MotionModify successfully modifies the parameters of a Motion object
MPIMotionMessageIDLE if no Motion was in progress when MotionModify was called. In order for MotionModify to work, there must be a Motion in progress.
MPIMotionMessageAUTO_START if MotionModify was called when no motion was in progress and the Auto-Start attribute was specified. In this case, the MotionModify is automatically converted into a MotionStart.
MPIMotionMessagePROFILE_ERROR if the controller cannot generate the motion profile (based on the specified motion parameters and attributes).
For more Returns, click here  
See Also