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

형식: IDirect3DVertexBuffer9*

원본 화면에서 원하는 문자 모양을 묶는 사각형(D3DCOMPOSERECTDESC 참조)이 포함된 꼭짓점 버퍼(IDirect3DVertexBuffer9 참조)에 대한 포인터입니다.

[in] NumRects

형식: UINT

작업에 사용되는 사각형 또는 문자 모양 수입니다. 이 숫자는 원본 표면과 대상 화면 모두에 적용됩니다. 범위는 D3DCOMPOSERECTS_MAXNUMRECTS 0입니다.

[in] pDstRectDescs

형식: IDirect3DVertexBuffer9*

원본 표면에서 표시된 문자 모양을 복사할 대상을 설명하는 사각형(D3DCOMPOSERECTDESTINATION 참조)이 포함된 꼭짓점 버퍼(IDirect3DVertexBuffer9 참조)에 대한 포인터입니다.

[in] Operation

형식: D3DCOMPOSERECTSOP

원본 및 대상 표면을 결합하는 방법을 지정합니다. D3DCOMPOSERECTSOP를 참조하세요.

[in] Xoffset

형식: INT

모든 대상 사각형의 x 좌표에 추가된 값입니다. 이 값은 음수일 수 있으며 결과가 표면의 범위를 벗어나면 문자 모양이 거부되거나 잘립니다.

[in] Yoffset

형식: INT

모든 대상 사각형의 y 좌표에 추가된 값입니다. 이 값은 음수일 수 있으며 결과가 표면의 범위를 벗어나면 문자 모양이 거부되거나 잘립니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK.

설명

1비트 원본 표면의 문자 모양은 이 메서드를 사용하여 다른 1비트 텍스처 표면에 함께 배치됩니다. 그런 다음 대상 표면을 텍스트 문자열을 필터링하고 다른 단색이 아닌 표면으로 스케일링하는 일반적인 텍스처링 작업의 원본으로 사용할 수 있습니다.

이 메서드에는 여러 제약 조건( StretchRect와 유사)이 있습니다.

• Surface를 잠글 수 없습니다.
• 원본 및 대상 표면은 동일한 표면일 수 없습니다.
• 원본 및 대상 표면은 D3DFMT_A1 형식으로 만들어야 합니다.
• 원본 표면과 두 꼭짓점 버퍼는 모두 D3DPOOL_DEFAULT 플래그를 사용하여 만들어야 합니다.
• 대상 표면은 D3DPOOL_DEFAULT 또는 D3DPOOL_SYSTEMMEM 플래그를 사용하여 만들어야 합니다.
• 원본 사각형은 원본 표면 내에 있어야 합니다.

요구 사항

추가 정보

IDirect3DDevice9Ex