interface IResourceHandle in Tinman.Engine.Rendering

Base interface for classes that act as handles for loading/creating graphics resources.

[ShutdownSurvive]
interface	IResourceHandle	extends	IEquatable<IResourceHandle>
		base of	IconItem
			IEnvironmentMap
			IModelGeometry
			IPreloadingResourceHandle
			IResourceData
			RenderTargetHandle
			ShadowMapping
			TerrainBuffer
			VertexBufferHandle

Remarks

An implementation of IResourceHandle must provide a correct implementation for GetHashCode().

Methods

CreateResource

Creates a new resource object, using the given graphics context.

[OwnerReturn]
method	CreateResource (Graphics graphics)
type	IResource
params	graphics	[not-null]	The graphics context to use.
returns		[not-null]	The resource object.

Remarks:

Resource objects may implement the IMemoryConsumption interface. In this case, the reported memory consumption will be interpreted as an estimate on how much GPU memory is consumed by the resource. This estimate can then be used for resource caching (e.g. CacheMemory).

Exceptions:

• RenderException:
  If a graphics subsystem error has occurred.
• IOException:
  If an I/O error has occurred while reading the resource data.
• ValidatingException:
  If the data reader has reported an error, for example because of an unsupported file format feature.

Equals

Compares this object with the given one.

[Pure]
method	Equals (IResourceHandle other)
type	bool
params	other		The object to compare to.
returns			true if this object is equal to other, false if not.
inherited	IEquatable.Equals