APIDb_StartClippingSessionID

자르고자 하는 새로 생성된 요소들의 클리핑 세션(clipping session)을 설정합니다.

    GSErrCode ACAPI_Database (
        APIDb_StartClippingSessionID
    );

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_NESTING

데이터베이스에 대한 클리핑 세션이 열려 있습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 임시 데이터베이스를 생성하고 후속 ACAPI_Element_Create 호출들을 거기로 리다이렉트합니다. 이 세션 도중 생성된 요소들은 주어진 클리핑(clipping) 영역과 변환을 적용하여 APIDb_DoClipID 커맨드로 실제 요소 데이터베이스로 복사할 수 있습니다. 대상 데이터베이스를 복원하기 위해 APIDb_StopClippingSessionID 데이터베이스 함수로 클리핑 세션(clipping session)을 닫아야 합니다.

2D 드로잉 요소들만 자를 수 있음을 참고하십시오. 벽, 기둥과 같은 건설 요소들은 클리핑 알고리즘에 참여하지 못할 것입니다.

 

예제

API_Region          clipRegion;
API_Element         element;
GSErrCode           err;

BNZeroMemory (&clipRegion, sizeof (API_Region));
clipRegion.box.xMin = 0.0;
clipRegion.box.xMax = 2.0;
clipRegion.box.yMin = 1.54;
clipRegion.box.yMax = 2.54;

err = ACAPI_Database (APIDb_StartClippingSessionID, NULL, NULL);
if (err == NoError) {
    /* ... */
    err = ACAPI_Element_Create (&element, NULL);
    /* ... */
    err = ACAPI_Database (APIDb_DoClipID, &clipRegion, NULL);
}
err = ACAPI_Database (APIDb_StopClippingSessionID, NULL, NULL);

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

API_Region
APIDb_DoClipID
APIDb_StopClippingSessionID
ACAPI_Element_Create
ACAPI_Database
API 함수