DirectX9Context

Description

class Tinman.AddOns.DirectX9.DirectX9Context

Derived from: GraphicsContext ^abstract

Full source code is included in the Tinman 3D SDK download.

An implementation of the IGraphicsContext interface for DirectX 9.

You can use the DirectX9ContextFactory object to configure and create an instance of this class. Also you can use the ForDevice method to wrap an existing IDirect3DDevice9* COM pointer.

The returned INativeHandles can be interpreted as follows:

LowLevel.IsWindows == true :
- DirectX9Context:
  The IDirect3DDevice9* COM pointer (do not call Release on it).
- IIndexBuffer (created by IGraphicsContext.BufferFactory):
  The IDirect3DIndexBuffer9* COM pointer (do not call Release on it).
- IVertexBuffer (created by IGraphicsContext.BufferFactory):
  The IDirect3DVertexBuffer9* COM pointer (do not call Release on it).
- ITexture2D (created by IGraphicsContext.TextureFactory:
  The IDirect3DTexture9* COM pointer (do not call Release on it).
- ITextureCube (created by IGraphicsContext.CreateTextureCube):
  The IDirect3DCubeTexture9* COM pointer (do not call Release on it).
- IRenderTarget (created by IGraphicsContext.CreateRenderTarget or IGraphicsContext.CreateSwapChain):
  The IDirect3DSurface9* COM pointer of the backbuffer surface (do not call Release on it).

Using Direct3D 9 imposes the following restrictions:

Line feature level LineFeatureLevel.DX10 is not available.
Terrain feature level TerrainFeatureLevel.DX10 is not available.
Terrain feature level TerrainFeatureLevel.DX11 is not available.
Terrain feature level TerrainFeatureLevel.DX12 is not available.
RenderStageFlags.OrderIndependentTransparency is not available when using multi-sampling (see IGraphicsContext.IsMultiSample).

Public / Constructors

ForDevice

[OwnerReturn]
public static method ForDevice → (4)

deviceHandle ⁱⁿ : IntPtr ^own: The IDirect3DDevice9* COM pointer. Upon disposal, Release will be called on the COM pointer.
shaderRepository ^opt : Path = null: Path to the shader repository (see IGraphicsContextFactory.ShaderRepository).
availableVideoMemory ^opt : int32 = 0: [>=0]
See IGraphicsContextFactory.AvailableVideoMemory.
maximumTextureSize ^opt : int32 = 0: [>=0]
See IGraphicsContextFactory.MaximumTextureSize.
returns → DirectX9Context: The graphics context or null if deviceHandle ⁱⁿ is zero.

Creates a new instance of DirectX9Context for the given native handle.

RenderException: If a graphics subsystem error has occurred.

Protected / Constructors