Partager via


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 intou 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;

Voir aussi

Concurrency::graphics, espace de noms