ResourceUsage Enumeration
Collapse the table of content
Expand the table of content

ResourceUsage Enumeration

XNA Game Studio Express
Defines options that identify the behavior of a resource.

Namespace: Microsoft.Xna.Framework.Graphics
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

public enum ResourceUsage

 Member nameDescription
AutoGenerateMipMapThe resource will automatically generate mipmaps. Automatic generation of mipmaps is not supported for volume textures and depth stencil surfaces/textures.
DoNotClipIndicates that the vertex buffer content will never require clipping.

Indicates that the vertex buffer requires dynamic memory use. This is useful for drivers because it enables them to decide where to place the buffer. In general, static vertex buffers are placed in video memory and dynamic vertex buffers are placed in AGP memory. Note that there is no separate static use. If you do not specify Dynamic, the vertex buffer is made static.

Textures can specify Dynamic. However, textures created with ResourceManagementMode.Automatic cannot use Dynamic.


(XBox 360 only) Linear texture memory format. Linear formats are arranged in memory using a left-to-right and top-to-bottom layout (with pixels contiguous in memory for each row, and rows contiguous except for possible alignment padding). Use a linear format when doing dynamic CPU updates to textures where you do not want the overhead of translating tile addresses using the CPU, the textures will not be referenced often during the frame, and you do not mind less efficient GPU performance.

This flag is only valid when used for texture creation on XBox 360, and will be ignored if utilized elsewhere. On XBox, most formats are created as Tiled if it is applicable.

PointsIndicates that the vertex or index buffer will be used for drawing point sprites. The buffer will be loaded in system memory if software vertex processing is needed to emulate point sprites.
ResolveTargetThis texture resource will be used as the destination texture in a call to GraphicsDevice.ResolveBackBuffer.

If this flag is used, vertex processing is done in software. If this flag is not used, vertex processing is done in hardware.


(XBox 360 only) Tiled texture memory format. Tiled formats are arranged using a memory layout designed to maximize the cache coherency of texture fetches and balance the access workload of the memory controllers. The exact pixel arrangement of tiled formats varies based on the bit depth of the format; however, pixels that are close to one another spatially are located close to one another in memory. For example, two pixels adjacent to one another in a vertical column would be separated in memory by an entire row of pixels for a linear format, but could be separated by only a few bytes for a tiled format.

The tiled texture format is usually more efficient than the linear texture format.

This flag is only valid when used for texture creation on XBox 360, and will be ignored if utilized elsewhere. On XBox, most formats are created as Tiled if it is applicable.

WriteOnlyInforms the system that the application writes only to the vertex buffer. Using this flag enables the driver to choose the best memory location for efficient write operations and rendering. Attempts to read from a vertex buffer that is created with this capability will fail.

Xbox 360, Windows XP SP2, Windows Vista

© 2016 Microsoft