texture_view, classe
Fournit un accès en lecture et un accès en écriture à une texture. texture_view
ne peut être utilisé que pour lire des textures dont le type valeur est int
, unsigned int
ou float
qui ont par défaut 32 bits bpse. Pour lire d’autres formats de texture, utilisez texture_view<const value_type, _Rank>
.
Syntaxe
template<typename value_type,int _Rank>
class texture_view;
template<typename value_type, int _Rank>
class texture_view
: public details::_Texture_base<value_type, _Rank>;
template<typename value_type, int _Rank>
class texture_view<const value_type, _Rank>
: public details::_Texture_base<value_type, _Rank>;
Paramètres
value_type
Type des éléments dans l’agrégat de texture.
_Rang
Rang du texture_view
.
Membres
Typedefs publics
Nom | Description |
---|---|
value_type |
Type des éléments dans les agrégats de texture. |
coordinates_type |
Type de la coordonnée utilisée pour spécifier un texel dans le texture_view - autrement dit, un short_vector qui a le même rang que la texture associée qui a un type valeur de float . |
gather_return_type |
Type de retour utilisé pour les opérations de collecte, c’est-à-dire un rang 4 short_vector qui contient les quatre composants de couleur homogènes collectés à partir des quatre valeurs texel échantillonné. |
Constructeurs publics
Nom | Description |
---|---|
constructeur texture_view | Surcharge. Construit une texture_view instance. |
~texture_view Destructeur | Détruit l’instance texture_view . |
Méthodes publiques
Nom | Description |
---|---|
gather_alpha | Surcharge. Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants alpha (w) des quatre texels échantillonnés. |
gather_blue | Surcharge. Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants bleus (z) des quatre texels échantillonnés. |
gather_green | Surcharge. Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants verts (y) des quatre texels échantillonnés. |
gather_red | Surcharge. Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants rouges (x) des quatre texels échantillonnés. |
get | Surcharge. Obtient la valeur de l’élément par index. |
Échantillon | Surcharge. Échantillonne la texture aux coordonnées et au niveau de détail spécifiés à l’aide de la configuration d’échantillonnage spécifiée. |
set | Définit la valeur d’un élément par index. |
Opérateurs publics
Nom | Description |
---|---|
operator() | Surcharge. Obtient la valeur de l’élément par index. |
operator[] | Surcharge. Obtient la valeur de l’élément par index. |
operator= | Surcharge. Opérateur d'assignation. |
Membres de données publics
Nom | Description |
---|---|
value_type | Type valeur des éléments du texture_view . |
Hiérarchie d'héritage
_Texture_base
texture_view
Spécifications
En-tête : amp_graphics.h
Espace de noms : concurrency ::graphics
~texture_view
Détruit l’instance texture_view
.
~texture_view() restrict(amp, cpu);
texture_view
Construit une texture_view
instance.
texture_view(// [1] constructor
texture<value_type, _Rank>& _Src) restrict(amp);
texture_view(// [2] constructor
texture<value_type, _Rank>& _Src,
unsigned int _Mipmap_level = 0) restrict(cpu);
texture_view(// [3] constructor
const texture<value_type, _Rank>& _Src) restrict(amp);
texture_view(// [4] constructor
const texture<value_type, _Rank>& _Src,
unsigned int _Most_detailed_mip,
unsigned int _Mip_levels) restrict(cpu);
texture_view(// [5] copy constructor
const texture_view<value_type, _Rank>& _Other) restrict(amp, cpu);
texture_view(// [6] copy constructor
const texture_view<const value_type, _Rank>& _Other) restrict(amp, cpu);
texture_view(// [7] copy constructor
const texture_view<const value_type, _Rank>& _Other,
unsigned int _Most_detailed_mip,
unsigned int _Mip_levels) restrict(cpu);
Paramètres
_Src
[1, 2] texture
Constructeur sur lequel l’écriture est texture_view
créée.
[3, 4] texture
Constructeur sur lequel l’écriture est texture_view
créée.
_Autre
[5] Copy Constructor The source writable texture_view
.
[6, 7] Copy Constructor The source non accessible en écriture texture_view
.
_Mipmap_level
Niveau mipmap spécifique sur la source texture
à laquelle cette propriété accessible texture_view
en écriture est liée. La valeur par défaut est 0, qui représente le niveau de niveau supérieur (le plus détaillé).
_Most_detailed_mip
Niveau supérieur (le plus détaillé) mip pour la vue, par rapport à l’objet spécifié texture_view
.
_Mip_levels
Nombre de niveaux mipmap accessibles via le texture_view
.
gather_red
Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants rouges (x) des quatre texels échantillonnés.
const gather_return_type gather_red(
const sampler& _Sampler,
const coordinates_type& _Coord) const restrict(amp);
template<
address_mode _Address_mode = address_clamp
>
const gather_return_type gather_red(
const coordinates_type& _Coord) const restrict(amp);
Paramètres
_Address_mode
Mode d’adresse à utiliser pour échantillonner le texture_view
. Le mode d’adresse est le même pour toutes les dimensions.
_Échantillonneur
Configuration de l’échantillonneur à utiliser pour échantillonner le texture_view
.
_Coord
Coordonnées à partir de laquelle effectuer l’échantillon. Les valeurs de coordonnées fractionnaires sont utilisées pour interpoler entre les texels d’échantillon.
Valeur de retour
Vecteur court de rang 4 contenant le composant rouge (x) des texels échantillonné 4.
gather_green
Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants verts (y) des quatre texels échantillonnés.
const gather_return_type gather_green(
const sampler& _Sampler,
const coordinates_type& _Coord) const restrict(amp);
template<
address_mode _Address_mode = address_clamp
>
const gather_return_type gather_green(
const coordinates_type& _Coord) const restrict(amp);
Paramètres
_Address_mode
Mode d’adresse à utiliser pour échantillonner le texture_view
. Le mode d’adresse est le même pour toutes les dimensions.
_Échantillonneur
Configuration de l’échantillonneur à utiliser pour échantillonner le texture_view
.
_Coord
Coordonnées à partir de laquelle effectuer l’échantillon. Les valeurs de coordonnées fractionnaires sont utilisées pour interpoler entre les texels d’échantillon.
Valeur de retour
Vecteur court de rang 4 contenant le composant vert (y) des texels échantillonné 4.
gather_blue
Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants bleus (z) des quatre texels échantillonnés.
const gather_return_type gather_blue(
const sampler& _Sampler,
const coordinates_type& _Coord) const restrict(amp);
template<
address_mode _Address_mode = address_clamp
>
const gather_return_type gather_blue(
const coordinates_type& _Coord) const restrict(amp);
Paramètres
_Address_mode
Mode d’adresse à utiliser pour échantillonner le texture_view
. Le mode d’adresse est le même pour toutes les dimensions.
_Échantillonneur
Configuration de l’échantillonneur à utiliser pour échantillonner le texture_view
.
_Coord
Coordonnées à partir de laquelle effectuer l’échantillon. Les valeurs de coordonnées fractionnaires sont utilisées pour interpoler entre les texels d’échantillon.
Valeur de retour
Vecteur court de rang 4 contenant le composant rouge (x) des texels échantillonné 4.
gather_alpha
Échantillonne la texture aux coordonnées spécifiées à l’aide de la configuration d’échantillonnage spécifiée et retourne les composants alpha (w) des quatre texels échantillonnés.
const gather_return_type gather_alpha(
const sampler& _Sampler,
const coordinates_type& _Coord) const restrict(amp);
template<
address_mode _Address_mode = address_clamp
>
const gather_return_type gather_alpha(
const coordinates_type& _Coord) const restrict(amp);
Paramètres
_Address_mode
Mode d’adresse à utiliser pour échantillonner le texture_view
. Le mode d’adresse est le même pour toutes les dimensions.
_Échantillonneur
Configuration de l’échantillonneur à utiliser pour échantillonner le texture_view
.
_Coord
Coordonnées à partir de laquelle effectuer l’échantillon. Les valeurs de coordonnées fractionnaires sont utilisées pour interpoler entre les texels d’échantillon.
Valeur de retour
Vecteur court de rang 4 contenant le composant alpha (w) des texels échantillonné 4.
get
Obtient la valeur de l’élément à l’index spécifié.
const value_type get(
const index<_Rank>& _Index) const restrict(amp);
value_type get(
const index<_Rank>& _Index,
unsigned int _Mip_level = 0) const restrict(amp);
Paramètres
_Index
Index de l’élément à obtenir, éventuellement multidimensionnel.
_Mip_level
Niveau mipmap à partir duquel nous devons obtenir la valeur. La valeur par défaut 0 représente le niveau mipmap le plus détaillé.
Valeur de retour
Valeur de l'élément.
opérateur =
Affecte une vue de la même texture que celle spécifiée texture_view
à cette texture_view
instance.
texture_view<value_type, _Rank>& operator= (// [1] copy constructor
const texture_view<value_type, _Rank>& _Other) restrict(amp, cpu);
texture_view<const value_type, _Rank>& operator= (// [2] copy constructor
const texture_view<value_type, _Rank>& _Other) restrict(cpu);
texture_view<const value_type, _Rank>& operator= (// [3] copy constructor
const texture_view<const value_type, _Rank>& _Other) restrict(amp, cpu);
Paramètres
_Autre
[1, 2] Copy Constructor A writable texture_view
object.
[3] Copy Constructor A non accessible en écriture texture_view
.
Valeur de retour
Référence à cette texture_view
instance.
operator[]
Retourne la valeur de l’élément par index.
const value_type operator[] (const index<_Rank>& _Index) const restrict(amp);
const value_type operator[] (int _I0) const restrict(amp);
value_type operator[] (const index<_Rank>& _Index) const restrict(amp);
value_type operator[] (int _I0) const restrict(amp);
Paramètres
_Index
Index, éventuellement multidimensionnel.
_I0
Index unidimensionnel.
Valeur de retour
Valeur de l’élément indexée par _Index
.
operator()
Retourne la valeur de l’élément par index.
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);
value_type operator() (
const index<_Rank>& _Index) const restrict(amp);
value_type operator() (
int _I0) const restrict(amp);
value_type operator() (
int _I0,
int _I1) const restrict(amp);
value_type operator() (
int _I0,
int _I1,
int _I2) const restrict(amp);
Paramètres
_Index
Index, éventuellement multidimensionnel.
_I0
Composant le plus significatif de l’index.
_I1
Composant le plus significatif de l’index.
_I2
Composant le moins significatif de l’index.
Valeur de retour
Valeur de l’élément indexée par _Index
.
Échantillon
Échantillonne la texture aux coordonnées et au niveau de détail spécifiés à l’aide de la configuration d’échantillonnage spécifiée.
value_type sample(
const sampler& _Sampler,
const coordinates_type& _Coord,
float _Level_of_detail = 0.0f) const restrict(amp);
template<
filter_mode _Filter_mode = filter_linear,
address_mode _Address_mode = address_clamp
>
value_type sample(
const coordinates_type& _Coord,
float _Level_of_detail = 0.0f) const restrict(amp);
Paramètres
_Filter_mode
Mode de filtre à utiliser pour échantillonner le texture_view. Le mode de filtre est le même pour les filtres de minimisation, d’optimisation et de mipmap.
_Address_mode
Mode d’adresse à utiliser pour échantillonner l’texture_view. Le mode d’adresse est le même pour toutes les dimensions.
_Échantillonneur
Configuration de l’échantillonneur à utiliser pour échantillonner le texture_view.
_Coord
Coordonnées à partir de laquelle effectuer l’échantillon. Les valeurs de coordonnées fractionnaires sont utilisées pour interpoler entre les valeurs texels.
_Level_of_detail
La valeur spécifie le niveau mipmap à partir duquel échantillonner. Les valeurs fractionnaires sont utilisées pour interpoler entre deux niveaux mipmap. Le niveau de détail par défaut est 0, qui représente le niveau mip le plus détaillé.
Valeur de retour
Valeur d’exemple interpolée.
set
Définit la valeur de l’élément à l’index spécifié sur la valeur spécifiée.
void set(
const index<_Rank>& _Index,
const value_type& value) const restrict(amp);
Paramètres
_Index
Index de l’élément à définir, éventuellement multidimensionnel.
valeur
Valeur avec laquelle définir l’élément.
value_type
Type valeur des éléments du texture_view.
typedef typename const value_type value_type;