1. Introduction¶
1.1. 함수의 명명 규칙¶
ComiMLink2 에서 제공하는 모든 함수는 다른 API 함수와 이름이 중복되는 것을 피하기 위하여 아래의 예와 같이 “cml”이라는 첨두어가 붙습니다.
“cml” 첨두어 바로 다음에는 해당 함수가 속하는 기능의 그룹을 대표하는 첨두어가 이어집니다.
첨두어 적용 |
적용 함수 |
---|---|
General Functions (Gn) |
cmlGnLoadDevice() / cmlGnSetServoOn () |
환경설정 함수들 (Cfg) |
cmlCfgSetMioProperty() / cmlCfgSetSpeedPattern() |
원점복귀 관련 함수들 (Home) |
cmlHomeMove() / cmlHomeSetConfig() |
단축구동 관련 함수들 (Sx) |
cmlSxMoveStart() / cmlSxStop() |
다축구동 관련 함수들 (ml) |
cmlmlMoveStart() / cmlmlMoveToStart() |
보간구동 관련 함수들 (Ix) |
cmlIxMapAxes() / cmlIxLine() |
1.2. 데이터형 표기¶
본 매뉴얼에서의 데이터 형 표기는 아래 표와 같습니다.
Data type |
Description |
C/C++ |
VB 6.0 |
Delphi |
C# |
---|---|---|---|---|---|
VT_EMPTY |
반환값이 없는 데이터 표현 운영체제가 특정 정보를 유지하기 위해 붙은 고유 번호 |
void |
void |
||
VT_HANDLE |
반환값이 없는 데이터 표현 운영체제가 특정 정보를 유지하기 위해 붙은 고유 번호 |
void * |
Long(ByRef) |
THandle |
IntPtr |
VT_I4 |
4 바이트 부호있는 정수 표현형 |
long |
Long(ByVal) |
LongInt |
Int |
VT_PI4 |
4 바이트 부호있는 정수 변수의 주소 값(포인터) 또는 배열주소 표현형 |
long * |
Long(ByRef) |
PLongInt |
Int[] |
VT_R4 |
4 바이트 부호있는 실수 표현형 |
float |
Double(ByVal) |
Double |
Float |
VT_PR4 |
4 바이트 부호있는 실수 변수의 주소 값(포인터) 또는 배열주소 표현형 |
float * |
Double(ByRef) |
PDouble |
float[] |
VT_R8 |
8 바이트 부호있는 실수 표현형 |
double |
Double(ByVal) |
Double |
double |
VT_PR8 |
8 바이트 부호있는 실수변수의 주소 |
double * |
Double(ByRef) |
PDouble |
double[] |
VT_STR |
값(포인터) 또는 배열주소 표현형 VT_STR 선형 메모리 상의 문자열 선두 주소를 지시하는 4 바이트 주소 표현형 |
char * |
String (ByVal) |
PChar |
String |