APIDb_DrawOrderInitID

BTF/STB 시스템으로 지정한 순서대로 요소들을 가져오기 위해 현재 데이터베이스 상에서 하나의 루프를 초기화합니다.

    GSErrCode ACAPI_Database (
        APIDb_DrawOrderInitID
    );

 

리턴 값

NoError

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

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

 

설명

이 함수는 서버 애플리케이션이 디스플레이에 그리는 순서대로 요소를 가져오기 위한 루프를 설정하는 데 사용합니다. 일단 루프가 초기화되면 요소 레퍼런스들을 순서대로 가져오기 위해 APIDb_DrawOrderGetNext 함수를 반복해서 호출할 수 있습니다.

루프를 리셋하기 위해 이 함수를 언제든지 호출할 수 있습니다. 루프를 재시작하기 위해 모든 요소들을 스캔할 필요는 없습니다.

요소들의 순서는 사용자가 호출한 BTF / STB 커맨드들에 의해 달라질 수 있습니다. 또한 이번 이슈에 대한 정보를 제공하는 포맷을 가진 외부 파일을 여는 동안에 기본 순서를 가져올 수 있습니다.

다 마친 후에 서버 애플리케이션이 캐시된 데이터를 해제하도록 허락하려면 APIDb_DrawOrderTerm을 호출하십시오.

 

예제

API_Elem_Head       elem_head;
GSErrCode           err;

err = ACAPI_Database (APIDb_DrawOrderInitID, NULL, NULL);
while (err == NoError) {
    err = ACAPI_Database (APIDb_DrawOrderGetNextID, (void *) (Int32) APIFilt_OnActFloor, &elem_head);
    if (err == NoError) {
        /* ... */
    }
}
if (err == APIERR_NOMORE)
    err = NoError;

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

APIDb_DrawOrderGetNext, APIDb_DrawOrderTerm, ACAPI_Database, API 함수