mpiMotionAxisListSet

Declaration

	long mpiMotionAxisListSet(MPIMotion motion, long axisCount, MPIAxis *axisList)
	Required Header: stdmpi.h

Description

mpiMotionAxisListSet creates a coordinate system of axisCount dimensions, using the Axis handles specified by axisList. Any existing coordinate system is completely replaced.

The axisList parameter is the address of an array of axisCount Axis handles, or is NULL (if axisCount is equal to zero).

A coordinate system may also be created incrementally (i.e. one Axis at a time) by using the append and/or insert methods described in this section. The initial Axis of a coordinate system may be specified using the axis parameter of mpiMotionCreate(...). The list methods in this section may be used to examine and manipulate a coordinate system (i.e. axis list) regardless of how it was created.

NOTE: User must call mpiMotionAction(..., MEIActionMAP) after calling mpiMotionAxisListSet(...) to complete new axis map configuration.

Return Values
MPIMessageOK

Sample Code


     /* Creates a 1:1 mapping between motion supervisor and axis */
     MPIMotion motion;
     MPIAxis axis;
     long returnValue;

     axis = mpiAxisCreate(control, axisNumber);
     returnValue = mpiAxisValidate(axis);
     msgCHECK(returnValue);	
	
     motion = mpiMotionCreate(control,
                              axisNumber,
                              NULL);
     returnValue = mpiMotionValidate(motion);
     msgCHECK(returnValue);

     returnValue = mpiMotionAxisListSet(motion,
                                        1,
                                        &axis);
     msgCHECK(returnValue);
	
     returnValue = mpiMotionAction(motion, MEIActionMAP);
     msgCHECK(returnValue);

     /* Don't forget to delete your motion supervisor and axis objects */