/// <summary>
/// Gets the data from the texture.
/// </summary>
/// <typeparam name="T">Type of data in the array.</typeparam>
/// <param name="data">Array of data.</param>
/// <param name="mipLevel">Mip map level to access.</param>
/// <param name="subimage">Rectangle representing a sub-image of the 2D texture to read from, if null the whole image is read from.</param>
/// <param name="startIndex">Starting index in the array to start writing to.</param>
/// <param name="elementCount">Number of elements to read.</param>
/// <exception cref="System.ArgumentException">Thrown if the format byte size of the type to read and the texture do not match, the subimage
/// dimensions are invalid, or if the total size to read and the total size in the texture do not match</exception>
/// <exception cref="Tesla.Core.TeslaException">Thrown if there was an error reading from the texture.</exception>
public override void GetData <T>(T[] data, int mipLevel, Rectangle?subimage, int startIndex, int elementCount)
{
if (_texture2D == null || _texture2D.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
if (mipLevel < 0 || mipLevel >= _mipCount)
{
throw new ArgumentOutOfRangeException("mipLevel", String.Format("Mip level is out of range. Must be between 0 and {0}.", _mipCount.ToString()));
}
//Throws null or out of range exception
D3D10Helper.CheckArrayBounds(data, startIndex, elementCount);
int formatSize = D3D10Helper.FormatSize(base.Format);
int elemSize = MemoryHelper.SizeOf <T>();
CheckSizes(formatSize, elemSize);
//Calc subresource dimensions
int width = (int)MathHelper.Max(1, base.Width >> mipLevel);
int height = (int)MathHelper.Max(1, base.Height >> mipLevel);
//Get the dimensions, if its null we copy the whole texture
Rectangle rect;
if (subimage.HasValue)
{
rect = subimage.Value;
CheckRectangle(rect, ref width, ref height);
}
else
{
rect = new Rectangle(0, 0, width, height);
}
CheckTotalSize(base.Format, ref formatSize, ref width, ref height, elemSize, elementCount);
//Create staging
CreateStaging();
try {
int row = rect.Y;
int col = rect.X;
//Do resource copy
if (base.Format == SurfaceFormat.DXT1 || base.Format == SurfaceFormat.DXT3 || base.Format == SurfaceFormat.DXT5)
{
_graphicsDevice.CopyResource(_texture2D, _staging);
}
else
{
D3D.ResourceRegion region = new D3D.ResourceRegion();
region.Left = col;
region.Right = col + width;
region.Top = row;
region.Bottom = row + height;
region.Front = 0;
region.Back = 1;
_graphicsDevice.CopySubresourceRegion(_texture2D, mipLevel, region, _staging, mipLevel, col, row, 0);
}
SDX.DataRectangle dataRect = _staging.Map(mipLevel, D3D.MapMode.Read, D3D.MapFlags.None);
SDX.DataStream ds = dataRect.Data;
int pitch = dataRect.Pitch;
int index = startIndex;
int count = elementCount;
//Compute the actual number of elements based on the format size and the element size we're copying the bytes into
int actWidth = (int)MathHelper.Floor(width * (formatSize / elemSize));
//Go row by row
for (int i = row; i < height; i++)
{
//Set the position
ds.Position = (i * pitch) + (col * formatSize);
//Break if we've run out of elements or on the very last row that isn't complete
if (count <= 0)
{
break;
}
else if (count < actWidth)
{
ds.ReadRange <T>(data, index, count);
break;
}
//Otherwise, copy the whole row and increment/decrement the index and count
ds.ReadRange <T>(data, index, actWidth);
index += actWidth;
count -= actWidth;
}
_staging.Unmap(mipLevel);
} catch (Exception e) {
throw new TeslaException("Error reading from D3D10 Texture2D.", e);
}
}
/// <summary>
/// Gets the data from the texture.
/// </summary>
/// <typeparam name="T">Type of data in the array</typeparam>
/// <param name="data">The array of data</param>
/// <param name="mipLevel">Mip map level to read from</param>
/// <param name="left">Right-most width position in the texture at which to acess. (0 or greater)</param>
/// <param name="right">Right-most width position in the texture at which to acess. (width or less)</param>
/// <param name="top">Top-most height position in the texture at which to acess. (0 or greater)</param>
/// <param name="bottom">Bottom-most height position in the texture at which to acess. (height or less)</param>
/// <param name="front">Front-most depth position in the texture at which to acess. (0 or greater)</param>
/// <param name="back">Back-most depth position in the texture at which to acess. (depth or less)</param>
/// <param name="startIndex">Starting index in the array to start reading from.</param>
/// <param name="elementCount">Number of elements to write.</param>
/// <exception cref="System.ArgumentException">Thrown if the format byte size of the type to read and the texture do not match, the subimage
/// dimensions are invalid, or if the total size to read and the total size in the texture do not match</exception>
/// <exception cref="Tesla.Core.TeslaException">Thrown if there was an error reading from the texture.</exception>
public override void GetData <T>(T[] data, int mipLevel, int left, int right, int top, int bottom, int front, int back, int startIndex, int elementCount)
{
if (_texture3D == null || _texture3D.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
if (mipLevel < 0 || mipLevel >= _mipCount)
{
throw new ArgumentOutOfRangeException("mipLevel", String.Format("Mip level is out of range. Must be between 0 and {0}.", _mipCount.ToString()));
}
//Throws null or out of range exception
D3D10Helper.CheckArrayBounds(data, startIndex, elementCount);
int formatSize = D3D10Helper.FormatSize(base.Format);
int elemSize = MemoryHelper.SizeOf <T>();
CheckSizes(formatSize, elemSize);
//Calc subresource dimensions
int width = (int)MathHelper.Max(1, base.Width >> mipLevel);
int height = (int)MathHelper.Max(1, base.Height >> mipLevel);
int depth = (int)MathHelper.Max(1, base.Depth >> mipLevel);
//Ensure box dimensions
CheckBox(left, right, top, bottom, front, back, ref width, ref height, ref depth);
CheckTotalSize(base.Format, ref formatSize, ref width, ref height, ref depth, elemSize, elementCount);
//Create staging
CreateStaging();
try {
int row = left;
int col = top;
int slice = front;
//Do resource copy
if (base.Format == SurfaceFormat.DXT1 || base.Format == SurfaceFormat.DXT3 || base.Format == SurfaceFormat.DXT5)
{
_graphicsDevice.CopyResource(_texture3D, _staging);
}
else
{
D3D.ResourceRegion region = new D3D.ResourceRegion();
region.Left = col;
region.Right = right;
region.Top = row;
region.Bottom = bottom;
region.Front = slice;
region.Back = back;
_graphicsDevice.CopySubresourceRegion(_texture3D, mipLevel, region, _staging, mipLevel, col, row, slice);
}
SDX.DataBox dataBox = _staging.Map(mipLevel, D3D.MapMode.Read, D3D.MapFlags.None);
SDX.DataStream ds = dataBox.Data;
int rowPitch = dataBox.RowPitch;
int slicePitch = dataBox.SlicePitch;
int index = startIndex;
int count = elementCount;
//Compute the actual number of elements based on the format size and the element size we're copying the bytes into
int actWidth = (int)MathHelper.Floor(width * (formatSize / elemSize));
//Go slice by slice
for (int k = slice; k < back; k++)
{
//Go row by row
for (int i = row; i < bottom; i++)
{
//Set the position
ds.Position = (k * slicePitch) + (i * rowPitch) + (col * formatSize);
//Break if we've run out of elements or on the very last row that isn't complete
if (count <= 0)
{
break;
}
else if (count < actWidth)
{
ds.ReadRange <T>(data, index, count);
break;
}
//Otherwise, copy the whole row and increment/decrement the index and count
ds.ReadRange <T>(data, index, actWidth);
index += actWidth;
count -= actWidth;
}
}
_staging.Unmap(mipLevel);
} catch (Exception e) {
throw new TeslaException("Error reading from D3D10 Texture3D.", e);
}
}
/// <summary>
/// Gets the back buffer data.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="subimage">The rectangle representing the sub-image. Null value means to grab the whole back buffer.</param>
/// <param name="data">The data.</param>
/// <param name="startIndex">The starting index in the array.</param>
/// <param name="elementCount">The number of eleemnts to read</param>
public override void GetBackBufferData <T>(Rectangle?subimage, T[] data, int startIndex, int elementCount)
{
if (_backBuffer.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
//Throws null or out of range exception
D3D10Helper.CheckArrayBounds(data, startIndex, elementCount);
//Calc subresource dimensions
int width = _presentParams.BackBufferWidth;
int height = _presentParams.BackBufferHeight;
//Get the dimensions, if its null we copy the whole texture
Rectangle rect;
if (subimage.HasValue)
{
rect = subimage.Value;
CheckRectangle(rect, width, height);
}
else
{
rect = new Rectangle(0, 0, width, height);
}
if (elementCount > rect.Width * rect.Height)
{
throw new ArgumentOutOfRangeException("elementCount", "Number of elements to read is larger than contained in the specified subimage.");
}
//Create staging
CreateStaging();
try {
int row = rect.Y;
int col = rect.X;
int rectWidth = rect.Width;
int rectHeight = rect.Height;
//Do resource copy
if (row == 0 && col == 0 && rectWidth == width && rectHeight == height)
{
_graphicsDevice.CopyResource(_backBuffer, _staging);
}
else
{
D3D.ResourceRegion region = new D3D.ResourceRegion();
region.Left = col;
region.Right = col + rectWidth;
region.Top = row;
region.Bottom = row + rectHeight;
region.Front = 0;
region.Back = 1;
_graphicsDevice.CopySubresourceRegion(_backBuffer, 0, region, _staging, 0, col, row, 0);
}
SDX.DataRectangle dataRect = _staging.Map(0, D3D.MapMode.Read, D3D.MapFlags.None);
SDX.DataStream ds = dataRect.Data;
int elemSize = MemoryHelper.SizeOf <T>();
int formatSize = D3D10Helper.FormatSize(_presentParams.BackBufferFormat);
int pitch = dataRect.Pitch;
int index = startIndex;
int count = elementCount;
//Compute the actual number of elements based on the format size and the element size we're copying the bytes into
int actWidth = (int)MathHelper.Floor(rectWidth * (formatSize / elemSize));
//Go row by row
for (int i = row; i < height; i++)
{
//Set the position
ds.Position = (i * pitch) + (col * formatSize);
//Break if we've run out of elements or on the very last row that isn't complete
if (count <= 0)
{
break;
}
else if (count < actWidth)
{
ds.ReadRange <T>(data, index, count);
break;
}
//Otherwise, copy the whole row and increment/decrement the index and count
ds.ReadRange <T>(data, index, actWidth);
index += actWidth;
count -= actWidth;
}
_staging.Unmap(0);
} catch (Exception e) {
throw new TeslaException("Error reading from D3D10 Texture2D.", e);
}
}
/// <summary>
/// Gets the data from the texture.
/// </summary>
/// <typeparam name="T">Type of data in the array.</typeparam>
/// <param name="data">Array of data</param>
/// <param name="mipLevel">Mip map level to access</param>
/// <param name="left">The left-most position in the 1D texture at which to access.</param>
/// <param name="right">The right-most position in the 1D texture at which to acess.</param>
/// <param name="startIndex">Starting index in the array to start writing to.</param>
/// <param name="elementCount">Number of elements to read.</param>
public override void GetData <T>(T[] data, int mipLevel, int left, int right, int startIndex, int elementCount)
{
if (_texture1D.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
if (mipLevel < 0 || mipLevel >= _mipCount)
{
throw new ArgumentOutOfRangeException("mipLevel", String.Format("Mip level is out of range. Must be between 0 and {0}.", _mipCount.ToString()));
}
//Throws null or out of range exception
D3D10Helper.CheckArrayBounds(data, startIndex, elementCount);
SurfaceFormat format = base.Format;
int formatSize = D3D10Helper.FormatSize(format);
int elemSize = MemoryHelper.SizeOf <T>();
CheckSizes(formatSize, elemSize);
//Calc subresource dimensions
int width = (int)MathHelper.Max(1, base.Width >> mipLevel);
//Check the line
CheckLine(ref width, left, right);
//Check the total size - fixes up the proper sizes if we're using a compression format
CheckTotalSize(format, ref formatSize, ref width, elemSize, elementCount);
//Create staging
CreateStaging();
try {
//Copy from the texture to staging
if (format == SurfaceFormat.DXT1 || format == SurfaceFormat.DXT3 || format == SurfaceFormat.DXT5)
{
_graphicsDevice.CopyResource(_texture1D, _staging);
}
else
{
D3D.ResourceRegion region = new D3D.ResourceRegion();
region.Left = left;
region.Right = right;
region.Top = 0;
region.Bottom = 1;
region.Front = 0;
region.Back = 1;
_graphicsDevice.CopySubresourceRegion(_texture1D, mipLevel, region, _staging, mipLevel, left, 0, 0);
}
SDX.DataStream ds = _staging.Map(mipLevel, D3D.MapMode.Read, D3D.MapFlags.None);
//Compute the actual number of elements based on the format size and the element size we're copying the bytes into
int actWidth = (int)MathHelper.Floor(width * (formatSize / elemSize));
//Read data
ds.Position = left * formatSize;
ds.ReadRange <T>(data, startIndex, actWidth);
_staging.Unmap(mipLevel);
} catch (Exception e) {
throw new TeslaException("Error reading from D3D10 Texture2D.", e);
}
}
/// <summary>
/// Writes data from the array to the index buffer.
/// </summary>
/// <typeparam name="T">The type of data in the index buffer - int or short.</typeparam>
/// <param name="data">Array to copy the data from</param>
/// <param name="startIndex">Starting index in the array at which to start copying from</param>
/// <param name="elementCount">Number of indices to write</param>
/// <param name="offsetInBytes">Offset from the start of the index buffer at which to start writing at</param>
/// <param name="writeOptions">Write options, used only if this is a dynamic buffer. None, discard, no overwrite</param>
/// <remarks>See implementors for exceptions that may occur.</remarks>
public override void SetData <T>(T[] data, int startIndex, int elementCount, int offsetInBytes, DataWriteOptions writeOptions)
{
if (_buffer == null || _buffer.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
//Throws null or out of range exception
D3D10Helper.CheckArrayBounds(data, startIndex, elementCount);
int numBytes = MemoryHelper.SizeOf <T>();
int ibSize = base.IndexCount * ((base.IndexFormat == IndexFormat.SixteenBits) ? 2 : 4);
int dataSize = elementCount * numBytes;
if (offsetInBytes < 0 || offsetInBytes > ibSize)
{
throw new ArgumentOutOfRangeException("offsetInBytes", "Byte offset is out of range.");
}
if ((offsetInBytes + dataSize) > ibSize)
{
throw new ArgumentOutOfRangeException("data", "Byte offset and the number of elements to write will cause a buffer overflow.");
}
bool usesStaging = false;
if (base.BufferUsage == ResourceUsage.Static || writeOptions == DataWriteOptions.None)
{
CreateStaging();
usesStaging = true;
}
try {
if (usesStaging)
{
using (SDX.DataStream ds = _staging.Map(D3D.MapMode.Write, D3D.MapFlags.None)) {
ds.Position = offsetInBytes;
ds.WriteRange <T>(data, startIndex, elementCount);
_staging.Unmap();
//If we're writing to the entire IB just copy the whole thing
if (offsetInBytes == 0 && startIndex == 0 && dataSize == ibSize)
{
_graphicsDevice.CopyResource(_staging, _buffer);
}
else
{
D3D.ResourceRegion region = new D3D.ResourceRegion();
region.Left = offsetInBytes;
region.Right = offsetInBytes + dataSize;
region.Front = region.Top = 0;
region.Back = region.Bottom = 1;
_graphicsDevice.CopySubresourceRegion(_staging, 0, region, _buffer, 0, offsetInBytes, 0, 0);
}
}
}
else
{
D3D.MapMode mode = (writeOptions == DataWriteOptions.Discard) ? D3D.MapMode.WriteDiscard : D3D.MapMode.WriteNoOverwrite;
using (SDX.DataStream ds = _buffer.Map(mode, D3D.MapFlags.None)) {
ds.Position = offsetInBytes;
ds.WriteRange <T>(data, startIndex, elementCount);
_buffer.Unmap();
}
}
} catch (Exception e) {
throw new TeslaException("Error writing to D3D10 Buffer.", e);
}
}
/// <summary>
/// Convienence method that takes an array of data buffers, each representing a vertex element (in the order
/// declared by the vertex declaration), and writes all of the data to the vertex buffer. The buffers must match
/// the vertex declaration as well as the byte sizes of each element and all be of the same length.
/// </summary>
/// <param name="data">Array of databuffers representing the vertex data.</param>
/// <exception cref="System.ArgumentNullException">Thrown if data is null.</exception>
/// <exception cref="System.ArgumentOutOfRangeException">Thrown if the number of buffers do not match the number
/// of vertex elements, or if the number of vertices in each buffer does not match the vertex count,
/// or if there is a byte size mismatch of any kind.</exception>
public override void SetInterleavedData(params DataBuffer[] data)
{
if (_buffer == null || _buffer.Disposed)
{
throw new ObjectDisposedException(GetType().Name);
}
if (data == null || data.Length == 0)
{
throw new ArgumentNullException("data", "Data cannot be null.");
}
VertexDeclaration vertexDecl = base.VertexDeclaration;
int vertexCount = base.VertexCount;
//Verify if the incoming vertex streams match right with the supplied vertex declaration
VertexElement[] elems = vertexDecl.VertexElements;
if (elems.Length != data.Length)
{
throw new ArgumentOutOfRangeException("data", "Number of vertex streams do not match up the number of declared vertex elements.");
}
int totalSizeInBytes = 0;
int vertexStride = 0;
for (int i = 0; i < data.Length; i++)
{
DataBuffer db = data[i];
VertexElement element = elems[i];
int vSizeInBytes = db.ElementSizeInBytes;
int vCount = db.SizeInBytes / vSizeInBytes;
if (vCount != vertexCount)
{
throw new ArgumentOutOfRangeException("data", "Vertex count mismatch, buffers must be of same length.");
}
if (vSizeInBytes != VertexDeclaration.GetVertexElementSize(element.Format))
{
throw new ArgumentOutOfRangeException("data", "Supplied vertex buffer element size mismatch with actual vertex element size.");
}
totalSizeInBytes += db.SizeInBytes;
vertexStride += vSizeInBytes;
db.Position = 0;
}
if (totalSizeInBytes != vertexDecl.VertexStride * vertexCount)
{
throw new ArgumentOutOfRangeException("data", "Vertex data must match the size of the vertex buffer in bytes!");
}
CreateStaging();
try {
using (SDX.DataStream interleaved = _staging.Map(D3D.MapMode.Write, D3D.MapFlags.None)) {
byte[] vertex = new byte[vertexStride];
for (int i = 0; i < vertexCount; i++)
{
int startIndex = 0;
for (int j = 0; j < data.Length; j++)
{
DataBuffer db = data[j];
int elementSize = db.ElementSizeInBytes;
db.Get(vertex, startIndex, elementSize);
startIndex += elementSize;
}
interleaved.Write(vertex, 0, vertexStride);
}
_staging.Unmap();
//Copy entire resource
_graphicsDevice.CopyResource(_staging, _buffer);
}
} catch (Exception e) {
throw new TeslaException("Error writing to D3D10 Buffer.", e);
}
}
