13 mac_downloadtrajectory, 14 mac_removetrajectory – ElmoMC Multi-Axis Motion Controller-Maestro User Manual

Page 118

Advertising
background image

6.13 MAC_DownloadTrajectory

This function enables the user to download trajectory to Multi-axes supervisor

A trajectory is a text file that contains a sequence of PVT points, created by the user.

Syntax:

int MAC_DownloadTrajectory

( COMMUNICATION_HANDLE

hCommunication, LPCTSTR cszLocalPath );

Input Parameters:

COMMUNICATION_HANDLE hCommunication

Multi-axes supervisor communication handle.

LPCTSTR cszLocalPath

Path to trajectory file on desktop computer.

Return Value:

0 OK,
> 0 communication error codes:

1

The API library is not initialized;

2

Zero Communication handle;

3

Bad Communication handle;

4

Unable to create interface ITNElmoPublic;

5

Download Trajectory failed;

Use MAC_GetLastError to retrieve the error string.

Sample:

int retVal = MAC_DownloadTrajectory( hCom, szPath );

6.14 MAC_RemoveTrajectory

This function enables the user to remove trajectory from Multi-axes supervisor

Syntax:

int MAC_RemoveTrajectory( COMMUNICATION_HANDLE hCommunication,
LPCTSTR cszName );

Input Parameters:

COMMUNICATION_HANDLE hCommunication

Multi-axes supervisor communication handle.

LPCTSTR cszName

Trajectory name, if * - remove all.

Return Value:

0 OK,
> 0 communication error codes:

1

The API library is not initialized;

2

Zero Communication Handle;

3

Bad Communication Handle;

4

Unable to create interface ITNElmoPublic;

Maestro

Software Manual

The Maestro API

MAN-MASSW (Ver. Q)

6-11

Advertising