texture Class

Article
04/28/2015

A texture is a data aggregate on an accelerator_view in the extent domain. It is a collection of variables, one for each element in an extent domain. Each variable holds a value corresponding to C++ primitive type (unsigned int, int, float, double), a scalar type (norm, or unorm), or a short vector type.

template <
   typename _Value_type,
   int _Rank
>
class texture;

Parameters

_Value_type
The type of the elements in the texture.
_Rank
The rank of the texture.

Members

Public Typedefs

Name	Description
scalar_type	Scalar types.
value_type	Value types.

Public Constructors

Name	Description
texture::texture Constructor	Initializes a new instance of the texture class.
texture::~texture Destructor	Destroys the texture object.

Public Methods

Name	Description
texture::copy_to Method	Copies the texture object to the destination, by doing a deep copy.
texture::data Method	Returns a CPU pointer to the raw data of this texture.
texture::get Method	Returns the value of the element at the specified index.
texture::get_associated_accelerator_view Method	Returns the accelerator_view that is the preferred target for this texture to be copied to.
texture::get_depth_pitch Method	Returns the number of bytes between each depth slice in a 3D staging texture on the CPU.
texture::get_row_pitch Method	Returns the number of bytes between each row in a 2D or 3D staging texture on the CPU.
texture::set Method	Sets the value of the element at the specified index.

Public Operators

Name	Description
texture::operator() Operator	Returns the element value that is specified by the parameters.
texture::operator[] Operator	Returns the element that is at the specified index.
texture::operator= Operator	Copies the specified texture object to this one.

Public Constants

Name	Description
texture::rank Constant	Gets the rank of the texture object.

Public Data Members

Name	Description
texture::associated_accelerator_view Data Member	Gets the accelerator_view that is the preferred target for this texture to be copied to.
texture::depth_pitch Data Member	Gets the number of bytes between each depth slice in a 3D staging texture on the CPU.
texture::row_pitch Data Member	Gets the number of bytes between each row in a 2D or 3D staging texture on the CPU.

Inheritance Hierarchy

_Texture_base

texture

Requirements

Header: amp_graphics.h

Namespace: Concurrency::graphics