set_user_cart_coord(u1, v1, pos, ref)
기능
사용자가 입력좌표계(ref) 기준의 벡터 u1과 v1를 사용하여 새로운 직교 좌표계를 설정할 수 있습니다. 직교 좌표계의 원점은 입력좌표계(ref) 기준의 pos에 위치하고, x축/y축 basis는 vector u1과 v1에 주어집니다. 나머지 방향은 u1 x v1에 의해 정해집니다. u1과 v1이 orthogonal 하지 않은 경우, u1과 v1이 span 하는 평면상에 u1과 수직인 v1’를 y축의 방향 vector로 설정합니다. Workcell Item에서 설정한 좌표계를 포함하여 총 100개의 사용자좌표계를 설정할 수 있으며, 100개가 넘어가면 새로운 직교 좌표계를 설정할 수 없습니다. 명령어를 통해 설정한 사용자좌표계는 프로그램 실행 종료 시 삭제되므로, 사용자좌표계 정보를 유지하려면 Workcell Item에서 사용자좌표계를 설정하세요.
인수
| 인수명 | 자료형 | 기본값 | 설명 |
|---|---|---|---|
u1 | float[3] | - | X축 단위벡터 |
v1 | float[3] | - | y축 단위벡터 |
pos | posx list (float[6]) | - | posx 또는 position list |
ref | int | DR_BASE | reference coordinate
|
리턴
| 값 | 설명 |
|---|---|
양의 정수 | Coordinate 설정 성공 |
-1 | Coordinate 설정 실패 |
예외
| 예외 | 설명 |
|---|---|
DR_Error (DR_ERROR_TYPE) | 인수들의 데이터형 오류 시 |
DR_Error (DR_ERROR_VALUE) | 인수의 값이 유효하지 않을 시 |
DR_Error (DR_ERROR_RUNTIME) | C Extension 모듈 에러 발생 시 |
DR_Error (DR_ERROR_STOP) | 프로그램 강제 종료 시 |
예제
u1 = [1, 1, 0]
v1 = [-1, 1, 0]
pos = posx(10, 20, 30, 0, 0, 0)
user_tc1 = set_user_cart_coord(u1, v1, pos)
user_tc2 = set_user_cart_coord(u1, v1, pos, ref=DR_WORLD)