IDirect3DDevice9Ex::ComposeRects 메서드(d3d9.h)
다른 표면의 문자 모양 알파벳을 사용하여 텍스트 문자열을 한 화면에 복사합니다. 컴퍼지션은 비트 연산을 사용하여 GPU에서 수행됩니다.
구문
HRESULT ComposeRects(
[in] IDirect3DSurface9 *pSrc,
[in] IDirect3DSurface9 *pDst,
[in] IDirect3DVertexBuffer9 *pSrcRectDescs,
[in] UINT NumRects,
[in] IDirect3DVertexBuffer9 *pDstRectDescs,
[in] D3DCOMPOSERECTSOP Operation,
[in] int Xoffset,
[in] int Yoffset
);
매개 변수
[in] pSrc
형식: IDirect3DSurface9*
알파벳 문자 모양을 제공하는 원본 표면( IDirect3DSurface9에서 준비)에 대한 포인터입니다. 이 표면은 D3DUSAGE_TEXTAPI 플래그를 사용하여 만들어야 합니다.
[in] pDst
형식: IDirect3DSurface9*
문자 모양 데이터를 수신하는 대상 표면( IDirect3DSurface9에서 준비됨)에 대한 포인터입니다. 표면은 텍스처의 일부여야 합니다.
[in] pSrcRectDescs
원본 화면에서 원하는 문자 모양을 묶는 사각형(D3DCOMPOSERECTDESC 참조)이 포함된 꼭짓점 버퍼(IDirect3DVertexBuffer9 참조)에 대한 포인터입니다.
[in] NumRects
형식: UINT
작업에 사용되는 사각형 또는 문자 모양 수입니다. 이 숫자는 원본 표면과 대상 화면 모두에 적용됩니다. 범위는 D3DCOMPOSERECTS_MAXNUMRECTS 0입니다.
[in] pDstRectDescs
원본 표면에서 표시된 문자 모양을 복사할 대상을 설명하는 사각형(D3DCOMPOSERECTDESTINATION 참조)이 포함된 꼭짓점 버퍼(IDirect3DVertexBuffer9 참조)에 대한 포인터입니다.
[in] Operation
원본 및 대상 표면을 결합하는 방법을 지정합니다. D3DCOMPOSERECTSOP를 참조하세요.
[in] Xoffset
형식: INT
모든 대상 사각형의 x 좌표에 추가된 값입니다. 이 값은 음수일 수 있으며 결과가 표면의 범위를 벗어나면 문자 모양이 거부되거나 잘립니다.
[in] Yoffset
형식: INT
모든 대상 사각형의 y 좌표에 추가된 값입니다. 이 값은 음수일 수 있으며 결과가 표면의 범위를 벗어나면 문자 모양이 거부되거나 잘립니다.
반환 값
형식: HRESULT
메서드가 성공하면 반환 값이 D3D_OK.
설명
1비트 원본 표면의 문자 모양은 이 메서드를 사용하여 다른 1비트 텍스처 표면에 함께 배치됩니다. 그런 다음 대상 표면을 텍스트 문자열을 필터링하고 다른 단색이 아닌 표면으로 스케일링하는 일반적인 텍스처링 작업의 원본으로 사용할 수 있습니다.
이 메서드에는 여러 제약 조건( StretchRect와 유사)이 있습니다.
- Surface를 잠글 수 없습니다.
- 원본 및 대상 표면은 동일한 표면일 수 없습니다.
- 원본 및 대상 표면은 D3DFMT_A1 형식으로 만들어야 합니다.
- 원본 표면과 두 꼭짓점 버퍼는 모두 D3DPOOL_DEFAULT 플래그를 사용하여 만들어야 합니다.
- 대상 표면은 D3DPOOL_DEFAULT 또는 D3DPOOL_SYSTEMMEM 플래그를 사용하여 만들어야 합니다.
- 원본 사각형은 원본 표면 내에 있어야 합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | d3d9.h |
라이브러리 | D3D9.lib |