.. _cemSxSpeedRatio_Get:

cemSxSpeedRatio_Get
====================
--------------------


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

 t_i32 cemSxSpeedRatio_Get(
    LONG Axis,
    LONG SpeedMode,
    LONG VelRatio,
    LONG AccRatio,
    LONG DecRatio
  )


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

- 단축 구동 시 해당 축에 대해 설정되어 있는 속도 모드 및 속도 비율을 반환합니다. 



PARAMETER
`````````````
- Axis : 축 번호 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 
  (최대 통합 축 개수 - 1) 이하의 값을 축 번호로 설정할 수 있습니다.

\

- SpeedMode : cemSxSpeedRatio_Set 함수의 인자이며, 속도 모드를 설정합니다. 설정 가능한
  속도 모드는 다음과 같습니다.

+--------------------+-----------------------------------------------------------------------+
| Value              | Meaning                                                               |
+====================+=======================================================================+
| 0 (cemSMODE_C)     | CONSTANT 속도 모드 => 가감속을 수행하지 않습니다.                     |
+--------------------+-----------------------------------------------------------------------+
| 1 (cemSMODE_T)     | TRAPEZOIDAL 속도 모드 => 사다리꼴 가감속을 수행합니다.                |
+--------------------+-----------------------------------------------------------------------+
| 2 (cemSMODE_S)     | S-CURVE 속도 모드 => S-CURVE 가감속을 수행합니다.                     |
+--------------------+-----------------------------------------------------------------------+



- VelRatio : 작업 속도 비율(Ratio) 을 설정 혹은 반환. 이 값의 단위는 % 입니다.

- AccRatio : 가속도 비율(Ratio) 을 설정 혹은 반환합니다. 이 값의 단위는 % 입니다.

- DecRatio : 감속도 비율(Ratio) 을 설정 혹은 반환합니다. 이 값의 단위는 %입니다.



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

- DLL 호출 성공 여부를 반환합니다.

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





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

.. code-block:: cpp
 :linenos:

 C/C++

 #include "ceSDK.h"
 #include "ceSDKDef.h"
 void OnSetSpeed ()
 {
 long nAxisNo = 1; // 모션 이송 속도를 설정할 대상 축을 선택합니다.
 
 /* 단축 모션의 작업 속도 비율을 설정합니다. cemCfgSpeedPattern_Set()함수를 통해서 
 설정된 모션 이송 속도를 기준으로 속도 비율이 적용됩니다. */
 
 cemCfgSpeedPattern_Set ( nAxisNo, cemSMODE_T, 1000, 10000, 10000 );
 cemSxSpeedRatio_Set ( nAxisNo, // 대상 축 선택
                      cemSMODE_T, // 속도 모드 선택
                      50, // 작업 속도 비율. 1000 * 0.5 = 500 pps 
                      80, // 가속도 비율. 10000 * 0.8 = 8000 pps²
                      80 // 감속도 비율. 10000 * 0.8 = 8000 pps²
                      );
 }


.. seealso:: :ref:`cemCfgSpeedPattern_Set`, :ref:`cemCfgSpeedPattern_Get`, :ref:`cemSxSpeedRatio_Set`