IGraphicsContext

Checks if this IGraphicsContext is capable of creating an instance of IRenderEffectBase for the given render effect parameters.

Checks if this IGraphicsContext is capable of creating an instance of ISwapChain for the given native window.

Requests to clear the graphics resource cache.

The graphics resource cache will be cleared upon the next call to IBeginEnd.End when there are no pending resource loading jobs (see ResourceLoader.IsLoading). Before clearing the cache, the method waits for the GPU to finish all pending work.

Clears pixels to the given values on the render targets that have been specified by the most recent call to SetRenderTarget.

An implementation can choose to either clear all pixels (e.g. Direct3D 10/11), or to clear only those that are inside of the current viewport rectangle (e.g. Direct3D 9). This behaviour is not exposed, so the ClearRenderTarget method should only be called after SetRenderTarget and before SetViewport.

Creates a new graphics fence object.

Creates a buffer for drawing geometry.

Geometry buffers should be created once and then re-used over many frames. Creating new geometry buffers frequently can have significant impact on performance.

Creates an instance of IRenderEffectBase for the given render effect parameters.

The documentation of the concrete implementation class of parameters ⁱⁿ depicts the render effect interface that will be implemented by the returned object.

Creates a new off-screen render target.

Creates a swap chain render target for the given window.

When the swap chain render target is created, the following format flags are used:

Creates an ITextureCube with ResourceAccessPattern.Dynamic access.

Creates a new graphics timer object.

Obtains a snapshot of the given render target.

Registers the given render effect factory.

Sets the clip rectangle on the current render target.

Sets the geometry buffers to use for drawing geometry.

This method should be called to clear all geometry buffers bindings after all rendering work has been done.

If IGeometryBuffer.Instances is not null, the cartesian product of the vertices and instances in geometryBuffer ^opt is used to draw instanced geometry: Each vertex in IGeometryBuffer.Vertices that is referenced by subsequent calls to IPrimitiveRenderer is duplicated instanceCount ^opt times; instance data from IGeometryBuffer.Instances is appended to the vertex data, which is then consumed by GPU shaders.

The firstInstance ^opt and instanceCount ^opt parameters choose the range of instances that will be used by subsequent calls to IPrimitiveRenderer. If IGeometryBuffer.Instances is null, these parameters are ignored.

Sets the render targets for subsequent draw calls.

Setting the render targets will also reset the viewport (see SetViewport) and clip rectangle (see SetClip) to the size of the first render target (see IRenderTarget.Size). The screen size of the shared Graphics object will be set accordingly, too.

The depth/stencil buffer of the first render target will be used.

The calling code is responsible for handling the required calls the IRenderTarget.Finish method for each used render target.

Backs up the current render targets and the current depth/stencil buffer.

Calls to SetRenderTargetBackup and SetRenderTargetRestore must be balanced and may be nested.

Restores the backed-up render targets and the depth/stencil buffer.

Calls to SetRenderTargetBackup and SetRenderTargetRestore must be balanced and may be nested.

Sets the viewport rectangle on the current render target.

Checks if this graphics context is still valid.

Once a graphics context has become invalid, it must be detached from the application and all graphics resources have to be re-created (e.g. via IApplication.GraphicsContextDetach and IApplication.GraphicsContextAttach).

Checks if the given render target format is supported by this graphics context.

Returns the IBufferFactory for this graphics context.

Returns the shared ResourceCache object for this graphics context.

Returns a human readable description of the underlying graphics device.

Returns the shared Graphics object for this graphics context.

The bounds of the shared Graphics object are set automatically to the bounds of the current render target. If the graphics context is not active or if no render target has been set, the bounds of the Graphics object will be empty, i.e. the screen size will be zero (see Graphics.ScreenSize).

Is the near-clipping plane mapped to 0 in clip-space (true), or is it mapped to -1 (false)?

Returns the IMeshDispatcher for this graphics context.

Human readable name of this graphics context.

Returns the IPrimitiveRenderer for this graphics context.

The number of render targets that can be used simultaneously during rendering.

Returns the path to the shader repository.

The pixel size of the render targets that have been specified by the most recent call to SetRenderTarget.

If no render target is bound to index 0, Vec2I.Zero is returned.

Returns the ITextureFactory for this graphics context.

The pixel size of the current viewport that has been specified by the most recent call to SetViewport.

Returns the IWorkDispatcher for this graphics context.

Loads an ITextureCube resource.

Sets the geometry buffers to use for drawing geometry.

If IGeometryBuffer.Instances is not null, the cartesian product of the vertices and instances in geometryBuffer ⁱⁿ is used to draw instanced geometry: Each vertex in IGeometryBuffer.Vertices that is referenced by subsequent calls to IPrimitiveRenderer is duplicated RangeI.Length times; instance data from IGeometryBuffer.Instances is appended to the vertex data, which is then consumed by GPU shaders.

The instances ⁱⁿ parameter chooses the range of instances that will be used by subsequent calls to IPrimitiveRenderer. If IGeometryBuffer.Instances is null, this parameter is ignored.

Sets the render target for subsequent draw calls.

Setting the render target will also reset the viewport (see IGraphicsContext.SetViewport) and clip rectangle (see IGraphicsContext.SetClip) to the size of the given render target (see IRenderTarget.Size). The screen size of the shared Graphics object will be set accordingly, too.

The depth/stencil buffer of the given render target will be used.

Collects textual information about this graphics context.