texture, classe
Une texture est un agrégat de données sur un accelerator_view domaine d’étendue. Il s’agit d’une collection de variables, une pour chaque élément d’un domaine d’étendue. Chaque variable contient une valeur correspondant au type primitif C++ ( unsigned int, intfloat, , double), à un type scalaire ( normou unorm) ou à un type de vecteur court.
Syntaxe
template <typename value_type, int _Rank>
class texture;
Paramètres
value_type
Type des éléments dans la texture.
_Rang
Classement de la texture.
Membres
Typedefs publics
| Nom | Description |
|---|---|
scalar_type |
Types scalaires. |
value_type |
Types valeur. |
Constructeurs publics
| Nom | Description |
|---|---|
| constructeur de texture | Initialise une nouvelle instance de la classe texture. |
| ~Destructeur de texture | Détruit l’objet texture . |
Méthodes publiques
| Nom | Description |
|---|---|
| copy_to | Copie l’objet texture vers la destination, en effectuant une copie approfondie. |
| data | Retourne un pointeur processeur vers les données brutes de cette texture. |
| get | Retourne la valeur de l’élément à l’index spécifié. |
| get_associated_accelerator_view | Retourne l’accelerator_view qui est la cible préférée pour cette texture à copier. |
| get_depth_pitch | Retourne le nombre d’octets entre chaque tranche de profondeur dans une texture intermédiaire 3D sur le processeur. |
| get_row_pitch | Retourne le nombre d’octets entre chaque ligne d’une texture intermédiaire 2D ou 3D sur l’UC. |
| set | Définit la valeur de l’élément à l’index spécifié. |
Opérateurs publics
| Nom | Description |
|---|---|
| operator() | Retourne la valeur de l’élément spécifiée par les paramètres. |
| operator[] | Retourne l’élément qui se trouve à l’index spécifié. |
| operator= | Copie l’objet de texture spécifié dans celui-ci. |
Constantes publiques
| Nom | Description |
|---|---|
| constante de classement | Obtient le rang de l’objet texture . |
Membres de données publics
| Nom | Description |
|---|---|
| associated_accelerator_view | Obtient l’accelerator_view qui est la cible préférée pour cette texture à copier. |
| depth_pitch | Obtient le nombre d’octets entre chaque tranche de profondeur dans une texture intermédiaire 3D sur le processeur. |
| row_pitch | Obtient le nombre d’octets entre chaque ligne d’une texture intermédiaire 2D ou 3D sur le processeur. |
Hiérarchie d'héritage
_Texture_base
texture
Spécifications
En-tête : amp_graphics.h
Espace de noms : Concurrency ::graphics
~texture
Détruit l’objet texture .
~texture() restrict(cpu);
associated_accelerator_view
Obtient l’accelerator_view qui est la cible préférée pour cette texture à copier.
__declspec(property(get= get_associated_accelerator_view)) Concurrency::accelerator_view associated_accelerator_view;
copy_to
Copie l’objet texture vers la destination, en effectuant une copie approfondie.
void copy_to(texture& _Dest) const;
void copy_to(writeonly_texture_view<value_type, _Rank>& _Dest) const;
Paramètres
_Dest
Objet cible de la copie.
_Rang
Classement de la texture.
value_type
Type des éléments dans la texture.
données
Retourne un pointeur processeur vers les données brutes de cette texture.
void* data() restrict(cpu);
const void* data() const restrict(cpu);
Valeur de retour
Pointeur vers les données brutes de la texture.
depth_pitch
Obtient le nombre d’octets entre chaque tranche de profondeur dans une texture intermédiaire 3D sur le processeur.
__declspec(property(get= get_depth_pitch)) unsigned int depth_pitch;
get
Retourne la valeur de l’élément à l’index spécifié.
const value_type get(const index<_Rank>& _Index) const restrict(amp);
Paramètres
_Index
Index de l’élément .
Valeur de retour
Valeur de l’élément à l’index spécifié.
get_associated_accelerator_view
Retourne le accelerator_view qui est la cible préférée pour cette texture à copier.
Concurrency::accelerator_view get_associated_accelerator_view() const restrict(cpu);
Valeur de retour
Le accelerator_view qui est la cible préférée pour cette texture à copier.
get_depth_pitch
Retourne le nombre d’octets entre chaque tranche de profondeur dans une texture intermédiaire 3D sur le processeur.
unsigned int get_depth_pitch() const restrict(cpu);
Valeur de retour
Nombre d’octets entre chaque tranche de profondeur dans une texture intermédiaire 3D sur le processeur.
get_row_pitch
Retourne le nombre d’octets entre chaque ligne d’une texture intermédiaire 2 dimensions ou entre chaque ligne d’une tranche de profondeur en texture intermédiaire 3 dimensions.
unsigned int get_row_pitch() const restrict(cpu);
Valeur de retour
Nombre d’octets entre chaque ligne d’une texture intermédiaire 2 dimensions ou entre chaque ligne d’une tranche de profondeur en texture intermédiaire 3 dimensions.
operator()
Retourne la valeur de l’élément spécifiée par les paramètres.
const value_type operator() (
const index<_Rank>& _Index) const restrict(amp);
const value_type operator() (
int _I0) const restrict(amp);
const value_type operator() (
int _I0,
int _I1) const restrict(amp);
const value_type operator() (
int _I0,
int _I1,
int _I2) const restrict(amp);
Paramètres
_Index
Index.
_I0
Composant le plus significatif de l’index.
_I1
Composant le plus significatif de l’index.
_I2
Composant le moins significatif de l’index.
_Rang
Rang de l’index.
Valeur de retour
Valeur de l’élément spécifiée par les paramètres.
operator[]
Retourne l’élément qui se trouve à l’index spécifié.
const value_type operator[] (const index<_Rank>& _Index) const restrict(amp);
const value_type operator[] (int _I0) const restrict(amp);
Paramètres
_Index
Index.
_I0
Index.
Valeur de retour
Élément qui se trouve à l’index spécifié.
opérateur =
Copie l’objet de texture spécifié dans celui-ci.
texture& operator= (
const texture& _Other);
texture& operator= (
texture<value_type, _Rank>&& _Other);
Paramètres
_Autre
Objet texture à copier.
Valeur de retour
Référence à cet texture objet.
rank
Obtient le rang de l’objet texture .
static const int rank = _Rank;
row_pitch
Obtient le nombre d’octets entre chaque ligne d’une texture intermédiaire 2D ou 3D sur le processeur.
__declspec(property(get= get_row_pitch)) unsigned int row_pitch;
set
Définit la valeur de l’élément à l’index spécifié.
void set(
const index<_Rank>& _Index,
const value_type& value) restrict(amp);
Paramètres
_Index
Index de l’élément .
_Rang
Rang de l’index.
valeur
Nouvelle valeur de l’élément.
texture
Initialise une nouvelle instance de la classe texture.
texture(const Concurrency::extent<_Rank>& _Ext) restrict(cpu);
texture(int _E0) restrict(cpu);
texture(int _E0, int _E1) restrict(cpu);
texture(int _E0, int _E1, int _E2) restrict(cpu);
texture(
const Concurrency::extent<_Rank>& _Ext,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
int _E1,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
int _E1,
int _E2,
const Concurrency::accelerator_view& _Av) restrict(cpu);
template<typename _Input_iterator>
texture(
const Concurrency::extent<_Rank>& _Ext,
_Input_iterator _Src_first,
_Input_iterator _Src_last) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0, _Input_iterator _Src_first, _Input_iterator _Src_last) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0,
int _E1,
_Input_iterator _Src_first,
_Input_iterator _Src_last) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0,
int _E1,
int _E2,
_Input_iterator _Src_first,
_Input_iterator _Src_last) restrict(cpu);
template<typename _Input_iterator>
texture(
const Concurrency::extent<_Rank>& _Ext,
_Input_iterator _Src_first,
_Input_iterator _Src_last,
const Concurrency::accelerator_view& _Av) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0,
_Input_iterator _Src_first,
_Input_iterator _Src_last,
const Concurrency::accelerator_view& _Av) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0,
int _E1,
_Input_iterator _Src_first,
_Input_iterator _Src_last,
const Concurrency::accelerator_view& _Av) restrict(cpu);
template<typename _Input_iterator>
texture(
int _E0,
int _E1,
int _E2,
_Input_iterator _Src_first,
_Input_iterator _Src_last,
const Concurrency::accelerator_view& _Av) restrict(cpu)) ;
texture(
int _E0,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
int _E0,
int _E1,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
int _E0,
int _E1,
int _E2,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
const Concurrency::extent<_Rank>& _Ext,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) ;
texture(
int _E0,
int _E1,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
int _E1,
int _E2,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
const Concurrency::extent<_Rank>& _Ext,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
int _E0,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
int _E0,
int _E1,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
int _E0,
int _E1,
int _E2,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element) restrict(cpu);
texture(
const Concurrency::extent<_Rank>& _Ext,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) ;
texture(
int _E0,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
int _E1,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
int _E0,
int _E1,
int _E2,
_In_ void* _Source,
unsigned int _Src_byte_size,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av) restrict(cpu);
texture(
const texture& _Src,
const Concurrency::accelerator_view& _Acc_view);
texture(
texture&& _Other);
texture(
const Concurrency::extent<_Rank>& _Ext,
unsigned int _Bits_per_scalar_element,
const Concurrency::accelerator_view& _Av);
texture(
const texture& _Src);
Paramètres
_Acc_view
La accelerator_view qui spécifie l’emplacement de la texture.
_Av
La accelerator_view qui spécifie l’emplacement de la texture.
_Associated_av
Accelerator_view qui spécifie la cible préférée pour les copies vers ou à partir de cette texture.
_Bits_per_scalar_element
Nombre de bits par chaque élément scalaire dans le type scalaire sous-jacent de la texture. En général, la valeur prise en charge est 8, 16, 32 et 64. Si 0 est spécifié, le nombre de bits est identique au scalar_type sous-jacent. 64 est valide uniquement pour les textures à base double.
_Poste
Étendue dans chaque dimension de la texture.
_E0
Composant le plus significatif de la texture.
_E1
Composant le plus important de la texture.
_E2
Composant le moins significatif de l’étendue de la texture.
_Input_iterator
Type de l'itérateur d'entrée.
_Mipmap_levels
Nombre de niveaux mipmap dans la texture sous-jacente. Si 0 est spécifié, la texture aura la plage complète de niveaux mipmap jusqu’à la plus petite taille possible pour l’étendue spécifiée.
_Rang
Rang de l’étendue.
_Source
Pointeur vers une mémoire tampon hôte.
_Src
Pour texture à copier.
_Src_byte_size
Nombre d’octets dans la mémoire tampon source.
_Src_first
Itérateur de début dans le conteneur source.
_Src_last
Itérateur de fin dans le conteneur source.
_Autre
Autre source de données.
_Rang
Rang de la section.