.. _cemSxCorrection_Get:

cemSxCorrection_Get
=====================
---------------------


SYNOPSYS
`````````````
.. code-block:: none

  t_i32 cemSxCorrection_Get(
    LONG Axis,
    LONG* CorrMode,
    DOUBLE* CorrAmount,
    DOUBLE* CorrVel,
    LONG* CntrMask
  )
  

DESCRIPTION
`````````````

- 백래쉬 또는 슬립 보정 설정 상태를 반환합니다.



PARAMETER
`````````````
- Axis : 축 번호

\

- CorrMode : 보정 모드를 설정 혹은 반환.

+------------------+------------------------------------------+
| BIT No           | Meaning                                  |
+==================+==========================================+
| 0 (cemCORR_DIS)  | 보정기능을 비활성화합니다.               |
+------------------+------------------------------------------+
| 1 (cemCORR_BACK) | 보정모드를 백래쉬 보정모드로 설정합니다. |
+------------------+------------------------------------------+
| 2 (cemCORR_SLIP) | 보정모드를 슬립 보정모드로 설정합니다.   |
+------------------+------------------------------------------+


- CorrAmount : 보정 펄스의 수를 설정 혹은 반환합니다. 단, 이 값은 논리적 단위 거리로 설정해야
  합니다. 따라서 “Unit distance”(Du)를 ‘1’이 아닌 값으로 설정한 경우에 실제 출력되는 보정 펄스
  수(Nc)는 다음과 같습니다.

                        Nc = CorrAmount * Du
\

- CorrVel : 보정펄스의 출력 주파수를 설정 혹은 반환. 단, 이 값은 논리적 속도 단위로 설정. 
  따라서 “Unit speed”(Vu)를 ‘1’이 아닌 값으로 설정한 경우에 실제 출력 주파수(Fc)는 다음과 같습니다.

                        Fc (PPS) = CorrVel * Vu
\

- CntrMask : 보정펄스가 출력되는 동안에 각 카운터의 동작 여부를 아래의 표와 같이 각 비트 별로 설정 혹은 반환

+-------+------------------------------------------------------------------+
| Value | Meaning                                                          |
+=======+==================================================================+
| BIT0  | 1 : 보정펄스 출력 시에 Command Counter 가 동작하는 모드입니다.   |
+-------+------------------------------------------------------------------+
| BIT1  | 1 : 보정펄스 출력 시에 Feedback Counter 가 동작하는 모드입니다.  |
+-------+------------------------------------------------------------------+
| BIT2  | 1 : 보정펄스 출력 시에 Deviation Counter 가 동작하는 모드입니다. |
+-------+------------------------------------------------------------------+
| BIT3  | 1 : 보정펄스 출력 시에 General Counter 가 동작하는 모드입니다.   |
+-------+------------------------------------------------------------------+




RETURN VALUE
`````````````

- 수행 여부를 반환합니다.

+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+



EXAMPLE
`````````````

- cemSxCorrection_Set예제도 참고해주시길 바랍니다.

.. code-block:: cpp
 :linenos:
 :emphasize-lines: 5

 #include “ceSDK.h”
 #include “ceSDKDef.h”
 long nSerialChNo = 0; // 시리얼 채널(Port) 번호
 // 0 번 시리얼 포트의 송신 버퍼를 비웁니다.
 if ( cesTxReset ( nSerialChNo ) != ceERR_NONE )
 {
 OutputDebugString ( "cesTxReset has been failed" );
 }
 // 0 번 시리얼 포트의 수신 버퍼를 비웁니다.
 if ( cesRxReset ( nSerialChNo ) != ceERR_NONE )
 {
 OutputDebugString ( "cesRxReset has been failed" );
 }



.. seealso:: :ref:`cemSxCorrection_Get`