=============================================
Introduction
=============================================

.. _introduction_01:

함수의 명명 규칙
----------------
* CMMSDK 에서 제공하는 모든 함수는 다른 API 함수와 이름이 중복되는 것을 피하기 위하여 “cmm”이라는 첨두어가 붙습니다. 

\

* "cmm" 뒤에 해당 함수가 속하는 기능의 그룹을 대표하는 첨두어가 이어집니다.

예시
^^^^^

+----------------------------------+------------------------------------------+
| 구분                              | 함수                                     |
+==================================+==========================================+
| General Functions (Gn)           | cmmGnDeviceLoad / cmmGnSetServoOn        |
+----------------------------------+------------------------------------------+
| 환경설정 함수들 (Cfg)            | cmmCfgSetMioProperty / cmmCfgSetOutMode  |
+----------------------------------+------------------------------------------+
| 원점복귀 관련 함수들 (Home)      |  cmmHomeMove / cmmHomeSetConfig          |
+----------------------------------+------------------------------------------+
| 단축구동 관련 함수들 (Sx)        | cmmSxSetSpeedRatio / cmmSxMove           |
+----------------------------------+------------------------------------------+
| 다축구동 관련 함수들 (Mx)        | cmmMxMove / cmmMxStop                    |
+----------------------------------+------------------------------------------+
| 보간구동 관련 함수들 (Ix)        | cmmIxMapAxes / cmmIxLine                 |
+----------------------------------+------------------------------------------+
-----


.. _introduction_02:

데이터형 표기
-------------

* 본 매뉴얼에서의 데이터 형 표기는 아래 표와 같습니다.

+-----------+-------------------------------------------------------------------------------------+--------+---------------+----------+----------+
| Data Type | Description                                                                         | C/C++  |    VB 6.0     |  Delphi  |    C#    |
+===========+=====================================================================================+========+===============+==========+==========+
| VT_EMPTY  | 반환값이 없는 데이터 표현 운영체제가 특정 정보를 유지하기 위해 붙은 고유 번호       | void   |       x       |     x    | 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    | 선형 메모리 상의 문자열 선두 주소를 지시하는 4 바이트 주소 표현형                   | char   | String(ByVal) | PChar    | String   |
+-----------+-------------------------------------------------------------------------------------+--------+---------------+----------+----------+


-----


.. _introduction_03:

파라미터 In / Out 표기
----------------------

* 본 매뉴얼에서는 "[in]"과 "[out]" 표기를 사용해 파라미터가 함수에 전달되는 것인지, 전달받는 것인지 명시하였습니다. 


* 이 표기는 본 매뉴얼에서만 사용되는 것이며, 실제 헤더파일에는 표기되어 있지 않습니다.