ACAPI_3D_DecomposePgon

3D 모델의 폴리곤을 볼록한 폴리곤들로 분해합니다.

    GSErrCode  ACAPI_3D_DecomposePgon (
        Int32        ipgon,
        Int32***     cpoly
    );

 

파라미터

ipgon

[in] 3D 모델의 폴리곤의 인덱스입니다.

cpoly

[out] 서브 폴리곤들의 정점들을 포함하는 배열을 가리킵니다.

 

리턴 값

NoError

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

APIERR_BADPARS

전달된 파라미터가 NULL입니다; cpoly

APIERR_REFUSEDCMD

3D 모델이 현재 컨텍스트에서 이용할 수 없습니다. 또는

폴리곤 타입이 직접 쿼리를 받을 수 없습니다; 활성 바디 없음

APIERR_BADINDEX

폴리곤 인덱스가 범위 밖입니다.

APIERR_MEMFULL

메모리가 부족합니다.

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

 

설명

이 함수는 폴리곤을 볼록한 폴리곤들로 분해하는 데 사용합니다. 폴리곤은 ipgon 인덱스에 의해 정의됩니다.

분해된 폴리곤은 cpoly Int32 배열에 리턴됩니다. 이것은 다음 값들을 포함합니다:

[-n], [-m1], i1, i2, ... i(m1), [-m2], j1, j2, ... j(m2)...

여기서:

• 음수 값들은 어떤 종류의 측정을 의미함
• 양수 값들은 정점 인덱스들을 의미함

파라미터	설명
n	서브 폴리곤들의 수입니다.
mi	다음 서브 폴리곤의 정점들의 수입니다.
i1 .. i(m1) j1 .. j(m2)	서브 폴리곤들의 실제 VERT 인덱스들입니다. 이 함수는 새로운 포인트들을 생성하지 않습니다. 그래서 이 인덱스들은 본래의 VERT 인덱스들을 참조합니다.

더 이상 필요하지 않으면 리턴된 핸들을 폐기하는 것을 잊지 마십시오.

 

요구사항

버전: API 1.3 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_3D_GetComponent,
3D 관리자, API 함수