IDirect3DDevice9::SetTransform 메서드

단일 장치의 변환 관련 스테이트를 설정한다.

구문

HRESULT SetTransform(      

    D3DTRANSFORMSTATETYPE State,
    CONST D3DMATRIX *pMatrix
);

파라미터

State

[in] 변경 대상의 장치 스테이트 변수. 이 파라미터에는,D3DTRANSFORMSTATETYPE 열거형의 임의의 멤버 또는D3DTS_WORLDMATRIX 매크로를 지정할 수 있다.

pMatrix

[in] 현재의 변환을 변경하는 D3DMATRIX 구조체의 포인터.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

인수의 1 개가 무효인 경우는,D3DERR_INVALIDCALL 를 돌려준다.

참조

IDirect3DDevice9::GetTransform ,IDirect3DDevice9::SetRenderState ,D3DTS_WORLD ,D3DTS_WORLDn,D3DTS_WORLDMATRIX

IDirect3DVertexBuffer9::Unlock 메서드

정점 데이터를 언락 한다.

구문

HRESULT Unlock(VOID);

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

실패했을 경우는,D3DERR_INVALIDCALL 를 돌려준다.

참조

IDirect3DVertexBuffer9::Lock

IDirect3DIndexBuffer9::Lock 메서드

인덱스 데이터의 범위를 잠그어, 인덱스 버퍼 메모리의 포인터를 얻어온다.

구문

HRESULT Lock(      

    UINT OffsetToLock,
    UINT SizeToLock,
    VOID **ppbData,
    DWORD Flags
);

파라미터

OffsetToLock

[in] 잠그는 인덱스 데이터에의 오프셋(offset) (바이트 단위). 인덱스 버퍼 전체를 잠그려면 ,SizeToLock 와 OffsetToLock 의 양쪽 모두의 파라미터에 0 을 지정한다.

SizeToLock

[in] 잠그는 인덱스 데이터의 사이즈 (바이트 단위). 인덱스 버퍼 전체를 잠그려면 ,SizeToLock 와 OffsetToLock 의 양쪽 모두의 파라미터에 0 을 지정한다.

ppbData

[out] 돌려주어진 인덱스 데이터를 포함한 메모리 버퍼에의 VOID* 포인터.

Flags

[in] 실행하는 잠금의 종류를 기술하는, 0 개 이상의 잠금 플래그의 편성. 이 메서드에 사용할 수 있는 플래그는 다음대로.

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NO_SYSLOCK
• D3DLOCK_READONLY
• D3DLOCK_NOOVERWRITE

플래그에 대해서는, 「D3DLOCK 」를 참조할것.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

실패했을 경우는,D3DERR_INVALIDCALL 를 돌려준다.

주의

인덱스 버퍼의 처리에서는, 잠금의 호출을 여러 차례 실시할 수 있다. 다만, 잠금의 호출 회수와 언락의 호출 회수가 일치하고 있을 필요가 있다. 현재 설정해 있는 인덱스 버퍼로 잠금 카운트가 남아 있는 경우,IDirect3DDevice9::DrawPrimitive 의 호출은 실패한다.

D3DLOCK_DISCARD 및 D3DLOCK_NOOVERWRITE 플래그는, D3DUSAGE_DYNAMIC 로 생성 된 버퍼 에 대해서만 유효하다.

D3DLOCK_DISCARD 및 D3DLOCK_NOOVERWRITE. 의 사용법에 대해서는, 「프로그래밍의 힌트」를 참조할것.

참조

IDirect3DIndexBuffer9::Unlock

IDirect3DIndexBuffer9 인터페이스

인덱스 버퍼 리소스를 조작하려면 ,IDirect3DIndexBuffer9 인터페이스의 메서드를 사용한다.

IDirect3DIndexBuffer9 멤버

FreePrivateData	이 리소스에 관련지을 수 있는 지정된 Private 데이터를 릴리즈 한다.
GetDesc	인덱스 버퍼 리소스의 기술을 얻어온다.
GetDevice	리소스에 관련지을 수 있는 장치를 얻어온다.
GetPriority	이 리소스에 대한 우선 순위를 얻어온다.
GetPrivateData	리소스에 관련된 Private 데이터가 제공된 버퍼에 복사 한다.
GetType	리소스의 타입을 돌려준다.
Lock	인덱스 데이터의 범위를 잠그어, 인덱스 버퍼 메모리의 포인터를 얻어온다.
PreLoad	관리되는 리소스를 프리로드 한다.
SetPriority	이 리소스에 리소스 관리의 우선 순위를 할당한다.
SetPrivateData	Microsoft® Direct3D® 는 아니고, 애플리케이션에서의 사용이 의도되고 있는 리소스와 데이터를 관련짓는다. 데이터는 값으로 건네받아 복수의 데이터 세트를 단일의 리소스와 관련지을 수가 있다.
Unlock	인덱스 데이터를 언락 한다.

주의

IDirect3DIndexBuffer9 인터페이스를 얻어오려면,IDirect3DDevice9::CreateIndexBuffer 메서드를 호출한다.

이 인터페이스는,IDirect3DResource9 인터페이스로부터 추가 기능을 계승한다.

이 인터페이스는, 모든 구성 요소 개체 모델 (COM) 인터페이스와 같이,IUnknown 인터페이스로부터 계승한다.

LPDIRECT3DINDEXBUFFER9 및 PDIRECT3DINDEXBUFFER9 형은,IDirect3DIndexBuffer9 인터페이스의 포인터로서 정의된다.

typedef struct IDirect3DIndexBuffer9 *LPDIRECT3DINDEXBUFFER9, *PDIRECT3DINDEXBUFFER9;

인터페이스의 정보

상속받은곳	IUnknown
헤더	d3d9.h
임포트 라이브러리	d3d9.lib
최저한의 operating system	Windows 98

참조

IDirect3DDevice9::CreateIndexBuffer

D3DFORMAT

다양한 종류의 표면 포맷을 정의한다.

구문

포맷에는 몇개의 종류가 있다.

• 부호 없음 포맷
• 부호 첨부 포맷
• 믹스 포맷
• FOURCC 포맷
• 버퍼 포맷
• 부동 소수점 포맷
• IEEE 포맷
• 백 버퍼 또는 디스플레이 포맷

모든 포맷은, 왼쪽에서 오른쪽으로 최상정도 비트 (MSB)로부터 최하정도 비트 (LSB)의 순서에 나타나고 있다. 예를 들어, D3DFORMAT_ARGB 는, MSB 채널 A (알파)로부터 LSB 채널 B (파랑)의 순서이다. 표면 데이터를 암벽 횡단 할 때 데이터는 LSB 로부터 MSB 의 순서로 메모리에 저장 된다. 이것은, 메모리내의 채널의 순서가, LSB (파랑)로부터 MSB (알파)의 순서인 것을 의미한다.

미정도리의 채널 (G16R16 나 A8 등)을 포함한 포맷의 디폴트값은 1 이다. 유일한 예외는 A8 포맷으로, 3 개의 컬러 채널에 대해서 000 에 초기화된다.

부호 없음 포맷

이러한 정수는, 픽셀 셰이더에 대한 텍스처 주소 명령의 작동코드를 참조한다.

부호 없음 포맷의 데이터는, 정이 아니면 안된다. 부호 없음 포맷에서는, 적 (R), 록 (G), 청 (B), 알파 (A), 휘도(Luminance) (L), 팔레트 (P) 데이터를 조합해 사용한다. 팔레트 데이터는, 색팔레트의 인덱스 생성에 사용하므로, 컬러 인덱스 데이터라고도 부른다.

부호 첨부 포맷

부호 첨부 포맷의 데이터는, 정이어도 부여도 괜찮다. 부호 첨부 포맷에서는, (U), (V), (W), (Q) 데이터를 조합해 사용한다.

믹스 포맷

믹스 포맷에는, 부호 없음 데이터와 부호 첨부 데이터를 조합해 저장 할 수 있다.

FOURCC 포맷

4 문자 코드 (FOURCC) 포맷의 데이터는, 압축 데이터이다.

MAKEFOURCC

4 문자 코드를 생성하는 매크로를 다음에 나타낸다.

#define MAKEFOURCC(ch0, ch1, ch2, ch3)                              \
                ((DWORD)(BYTE)(ch0) | ((DWORD)(BYTE)(ch1) << 8) |   \
                ((DWORD)(BYTE)(ch2) << 16) | ((DWORD)(BYTE)(ch3) << 24 ))

정의 끝난 FOURCC 포맷을 다음에 나타낸다.

버퍼 포맷

깊이 버퍼, 스텐실 버퍼, 정점 버퍼, 인덱스 버퍼는, 각각 고유의 포맷을 갖는다.

D3DFMT_D16_LOCKABLE 를 제외하는 모든 스텐실 포맷은, 각 픽셀에 특정의 비트 오더를 지정하지 않기 때문에, 드라이버는 깊이 채널로서 지정된 비트수보다 넓은 채널을 사용할 수 있다 (다만, 스텐실 채널은 사용할 수 없다).

부동 소수점 포맷

이러한 플래그는, 부동 소수점의 표면 포맷에 사용한다. 채널 근처 16 비트를 사용하는 이러한 포맷은, s10e5 포맷이라고도 부른다.

IEEE 포맷

이러한 플래그는, 부동 소수점의 표면 포맷에 사용한다. 채널 근처 32 비트를 사용하는 이러한 포맷은, s23e8 포맷이라고도 부른다.

그 외

그 외의 플래그는, 이것뿐이어, 미정도리의 포맷에 사용한다.

백 버퍼 또는 디스플레이 포맷

이러한 포맷은, 백 버퍼 또는 디스플레이 에 대해서만 유효하다.

주의

비트 오더는, 최상정도 바이트가 선두이다. 따라서, D3DFMT_A8L8 는, 이 2 바이트 포맷의 상위 바이트가 알파인 것을 나타내고 있다. D3DFMT_D16 는, 16 비트의 정수값으로, 애플리케이션으로 잠금 가능한 표면을 나타낸다.

픽셀 포맷이 선택되고 있는 것은, 확립되어 있는 FOURCC 방식을 도입할 뿐만 아니라, 하드웨어 벤더가 정의하는 확장 포맷의 표현을 가능하게 하기 위한(해)이다. Microsoft® Direct3D® 런타임이 인식하는 포맷군은,D3DFORMAT 로 정의되고 있다.

독립한 하드웨어 vender (IHV)가 제공하는 포맷 및 많은 FOURCC 코드는, 일람에는 나타나지 않기 때문에 주의할 필요가 있다. 이 열거형의 포맷은, 런타임에 의해 인정되고 있는 점이 다른 포맷과 다르다. 즉, 레퍼런스 래스터라이저는, 이러한 형태의 모두로 동작한다. IHV 제공의 포맷은, 카드 마다 각각의 IHV 가 지원 한다.

관련 항목

• IDirect3D9::CheckDeviceFormat

D3DPOOL 열거형

리소스의 버퍼를 보관 유지하는 메모리 클래스를 정의한다.

구문

typedef enum _D3DPOOL {
    D3DPOOL_DEFAULT = 0,
    D3DPOOL_MANAGED = 1,
    D3DPOOL_SYSTEMMEM = 2,
    D3DPOOL_SCRATCH = 3,
    D3DPOOL_FORCE_DWORD = 0x7fffffff
} D3DPOOL;

정수

D3DPOOL_DEFAULT

리소스는, 리소스에 대해서 요구된 사용 방법으로 가장 적합한 메모리 풀에 놓여진다. 이것은, 보통, 로컬 비디오 메모리와 AGP (Accelerated Graphics Port) 메모리의 양쪽 모두를 포함한, 비디오 메모리이다. D3DPOOL_DEFAULT 풀은, D3DPOOL_MANAGED 및 D3DPOOL_SYTEMMEM 로부터 독립하고 있어, 리소스가 장치 액세스용의 우선 메모리에 배치되는 것을 지정한다. D3DPOOL_DEFAULT 는, 이 리소스의 메모리 풀 타입으로서 D3DPOOL_MANAGED 또는 D3DPOOL_SYSTEMMEM 의 어느쪽이든을 선택해야 하는 것을 나타내고 있는 것은 아니기 때문에 주의 해야 한다. D3DPOOL_DEFAULT 풀에 배치된 텍스처는, 그것들이 동적 텍스처인가, 또는 Private의 4 문자 코드 (FOURCC) 드라이버 포맷인 경우만 잠글 수 있다. 잠글 수 없는 텍스처에 액세스 하려면 ,IDirect3DDevice9::UpdateSurface,IDirect3DDevice9::UpdateTexture ,IDirect3DDevice9::GetFrontBufferData,IDirect3DDevice9::GetRenderTargetData 등의 함수를 사용할 필요가 있다. D3DPOOL_MANAGED 는, 대부분의 애플리케이션으로 D3DPOOL_DEFAULT 보다 적합한 경우가 많다. Microsoft® Direct3D® 런타임에는 미지의, 드라이버 독자적인 픽셀 포맷으로 생성 된 일부의 텍스처를 잠글 수 있는 것에 주의 해야 한다. 또, 텍스처와는 달라, 스왑 체인 백 버퍼, 렌더링 타겟, 정점 버퍼, 및 인덱스 버퍼를 잠글 수 있게도 주의 해야 한다. 장치가 손실했을 경우는, D3DPOOL_DEFAULT 를 사용해 생성 한 리소스는,IDirect3DDevice9::Reset 를 호출하기 전에 릴리즈 해야 한다. 더 자세한 정보는, 「장치의 손실」을 참조할것.

D3DPOOL_DEFAULT 를 사용해 리소스를 생성 할 때 비디오 카드 메모리가 이미 사용되고 있는 경우는, 요구를 채우는 충분한 메모리를 릴리즈 하기 위해서, 관리되는 리소스가 제거된다.

D3DPOOL_MANAGED

리소스는, 필요에 따라서, 장치로부터 액세스 할 수 있는 메모리에 자동적으로 복사 된다. 관리되는 리소스는, 시스템 메모리에 백업 되므로, 장치가 손실했을 때에 생성 다시 할 필요가 없다. 더 자세한 정보는 「리소스의 관리」를 참조할것. 관리되는 리소스는 잠글 수 있다. 시스템 메모리의 복사만이 직접 변경된다. Direct3D 는, 필요에 따라서, 드라이버가 액세스 가능한 메모리로 변경 내용을 복사 한다.

D3DPOOL_SYSTEMMEM

보통, 3D 장치에 의해 액세스 할 수 없는 메모리. 시스템 RAM 를 사용하지만, 페이징 가능한 RAM 가 줄어들 것은 없다. 이러한 리소스는, 장치가 손실해도 생성 다시 할 필요가 없다. 이 풀의 리소스는 잠글 수가 있어 D3DPOOL_DEFAULT 를 사용해 생성 된 메모리 리소스에 대한 IDirect3DDevice9::UpdateSurface 또는 IDirect3DDevice9::UpdateTexture 처리의 전송원으로서 사용할 수 있다.

D3DPOOL_SCRATCH

리소스는, 시스템 RAM 에 배치되므로, 장치가 손실했을 때에 생성 다시 할 필요가 없다. 이러한 리소스는, 장치의 사이즈나 포맷의 제한에 의해 구속되지 않는다. 따라서, Direct3D 장치로부터 액세스 하는 일도, 텍스처 또는 렌더링 타겟으로서 설정하는 일도 할 수 없다. 다만, 이러한 리소스는 항상 생성, 잠금, 복사가 가능하다.

D3DPOOL_FORCE_DWORD

이 열거형을 강제적으로 32 비트 사이즈에 컴파일 한다. 이 값은 사용되지 않았다.

주의

모든 리소스로 모든 풀 타입이 유효하다. 이것에는, 정점 버퍼, 인덱스 버퍼, 텍스처, 및 표면이 포함된다.

렌더링 타겟 및 스텐실 표면용의 풀 타입에는, 몇개의 제약이 있다.

풀	D3DUSAGE_RENDERTARGET	D3DUSAGE_DEPTHSTENCIL
D3DPOOL_DEFAULT	x	x
D3DPOOL_MANAGED
D3DPOOL_SCRATCH
D3DPOOL_SYSTEMMEM

동적인 사용 방법 및 밉맵의 사용 방법에 대해서도, 풀 타입에 제약이 있다.

Pool	D3DUSAGE_DYNAMIC	D3DUSAGE_AUTOGENMIPMAP
D3DPOOL_DEFAULT	x	x
D3DPOOL_MANAGED		x
D3DPOOL_SCRATCH
D3DPOOL_SYSTEMMEM	x

사용 방법 타입의 더 자세한 정보는, 「D3DUSAGE 」를 참조할것.

1 개의 리소스 (밉맵의 밉레벨)에 포함되는 다른 개체에 대해서 복수의 풀을 혼재시킬 수 없다. 또, 풀이 선택되고 있는 경우, 그것을 변경할 수 없다.

애플리케이션에서는, 대부분의 정적 리소스에 대해서 D3DPOOL_MANAGED 를 사용할 필요가 있다. 이것에 의해, 손실한 장치를 처리할 필요가 없어진다. 관리되는 리소스는 런타임에 의해 복원된다. 이것은, 특히 UMA 시스템으로 유효하다. 그 이외의 동적 리소스에 대해서는, D3DPOOL_MANAGED 는 사용하지 않는 것이 좋다. 실제, D3DPOOL_MANAGED 를 D3DUSAGE_DYNAMIC 와 함께 사용해, 인덱스 버퍼 및 정점 버퍼를 생성 할 수 없다.

동적 텍스처의 경우, 비디오 메모리와 시스템 메모리의 텍스처의 페어를 사용해, D3DPOOL_DEFAULT 를 지정해 비디오 메모리를, D3DPOOL_SYSTEMMEM 를 지정해 시스템 메모리를 할당하는 일이 있다. 잠금 메서드를 사용해, 시스템 메모리 텍스처의 비트를 잠금 및 변경할 수 있다. 그 후,IDirect3DDevice9::UpdateTexture 를 사용해, 비디오 메모리 텍스처를 갱신할 수 있다.

열거형의 정보

헤더	d3d9types.h
최저한의 operating system	Windows 98

참조

IDirect3DDevice9::CreateCubeTexture ,IDirect3DDevice9::CreateIndexBuffer ,IDirect3DDevice9::CreateTexture,IDirect3DDevice9::CreateVolumeTexture ,IDirect3DDevice9::CreateVertexBuffer ,D3DINDEXBUFFER_DESC,D3DSURFACE_DESC ,D3DVERTEXBUFFER_DESC ,D3DVOLUME_DESC

D3DUSAGE

리소스의 사용법을 지정하는 옵션. 다음 표에, 각 리소스 타입의 사용법을 정리한다. 2 번째의 표에, 각 리소스 타입으로 이용할 수 있는 사용법을 나타낸다.

사용법

사용법과 풀의 편성

특정의 풀 타입에 대해서, 특정의 사용법을 사용할 수 있다. 더 자세한 정보는, 「D3DPOOL 」를 참조할것.

사용법과 리소스의 편성

사용법은, 리소스를 생성 할 경우에 지정하는지, 기존의 리소스의 능력을 테스트할 경우에 CheckDeviceFormat 를 사용해 지정한다. 이 표는, 각각의 리소스 타입에 적용 가능한 사용법을 나타내고 있다.

하드웨어가 이러한 사용법을 지원 하고 있을지 어떨지를 체크하려면 ,IDirect3D9::CheckDeviceFormat 를 사용하는 것.

이하에 리소스 생성 메서드를 나타낸다.

• IDirect3DDevice9::CreateCubeTexture
• IDirect3DDevice9::CreateDepthStencilSurface
• IDirect3DDevice9::CreateIndexBuffer
• IDirect3DDevice9::CreateOffscreenPlainSurface
• IDirect3DDevice9::CreateRenderTarget
• IDirect3DDevice9::CreateTexture
• IDirect3DDevice9::CreateVertexBuffer
• IDirect3DDevice9::CreateVolumeTexture

풀 타입의 더 자세한 정보는, 「D3DPOOL 」를 참조할것.

정수 정보

관련 항목

• D3DUSAGE_QUERY