cmmMxIsDone

SYNOPSIS

VT_I4 cmmMxIsDone(
    [in] VT_I4 NumAxes, [in] VT_PI4 AxisList, [out] VT_PI4 IsDone
    )

DESCRIPTION

  • 여러 개의 축에 대하여 지정한 모든 축의 모션이 완료됐는지를 확인합니다. 이 함수는 다축제어뿐 아니라 원점복귀나 단축모션제어 작업시에도 활용할 수 있습니다.

PARAMETER

  • NumAxes : 동시에 작업을 수행할 대상 축의 수

  • ChannelList : 작업완료를 확인할 대상 축의 배열 주소값. 이 배열의 크기는 NumAxes 값과 일치하거나 커야합니다.

  • IsDone : 다축구동 완료 여부를 판단할 수 있는 매개변수 입니다.

Value

Meaning

cmFALSE

모션작업이 완료되지 않음

cmTRUE

모션작업이 완료됨

RETURN VALUE

Value

Meaning

음수

수행 실패

cmERR_NONE

수행 성공

EXAMPLE

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
C/C++

long nIsDone;
long nAxisList[2] = {cmX1, cmY1};
double fDistList[2] = {1000, 1000};

if(cmmMxMove(2, nAxisList, fDistList, cmFALSE) != cmERR_NONE){
       //Handle 은 사용자가 생성한 폼의 핸들 값입니다.
       cmmErrShowLast(Handle);
       return;
}

while (1){
   cmmMxIsDone(2, nAxisList, &nIsDone);
   if(nIsDone == cmTRUE) break;
   else{
       // 다축 모션이 종료되지 않은 경우입니다. 적절한 처리를 합니다.
   }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
Visual Basic

Dim nAxisList(2) As Long
Dim fDistList(2) As Double

‘ 대상 축 설정
nAxisList(0) = cmX1
nAxisList(1) = cmY1

‘ 대상 축에 대한 이송 거리 설정
fDistList(0) = 1000
fDistList(1) = 1000

If(cmmMxMove(2, nAxisList(0), fDistList(0), cmFALSE) <> cmERR_NONE) Then
   Call cmmErrShowLast(Handle) ‘에러처리
   Exit Sub
End If

While(cmmMxIsDone(2, nAxisList(0), cmTRUE) <> cmERR_NONE)
   Call cmmErrShowLast(Handle) ‘에러처리
   Exit Sub
End If

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Delphi

// 대상 축 설정
nAxisList[0] := cmX1;
nAxisList[1] := cmY1;

// 대상 축에 대한 이송 거리 설정
fDistList[0] := 1000;
fDistList[1] := 1000;

if(cmmMxMove(2, @nAxisList, @fDistList) <> cmERR_NONE) then begin
   cmmErrShowLast(Handle);
   // 에러 발생에 대한 적절한 처리를 수행합니다.
end;

while(cmmMxIsDone(2, @nAxisList, @IsDone) <> cmERR_NONE) do begin

   // 여기서 IsDone 이 cmTRUE 이면 Loop 를 탈출하면 됩니다.
   …
end;

if(cmmErrGetLastCode() <> cmERR_NONE) then begin
   cmmErrShowLast(Handle);
   // 에러 발생에 대한 적절한 처리를 수행합니다.
end;

See also

cmmMxWaitDone