texture_view-Klasse

Artikel
10/12/2023

Stellt einer Textur Lese- und Schreibzugriff zur Verfügung. texture_view kann nur verwendet werden, um Texturen zu lesen, deren Werttyp int, unsigned int oder float mit 32-Bit-Standard ist. Verwenden Sie zum Lesen anderer Texturformate texture_view<const value_type, _Rank>.

Syntax

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

Parameter

value_type
Der Typ der Elemente im Texturaggregat.

_Rank
Der Rang des texture_view-Objekts.

Member

Öffentliche Typedefs

Name	Beschreibung
`value_type`	Der Typ der Elemente in den Texturaggregaten.
`coordinates_type`	Der Koordinatentyp, mit dem ein Texel im `texture_view`-Objekt angegeben wird, d. h. ein `short_vector`-Objekt, das den gleichen Rang wie die zugeordnete Textur mit dem Werttyp `float` hat.
`gather_return_type`	Der Rückgabetyp, der für Erfassungsvorgänge verwendet wird, d. h. ein `short_vector`-Objekt mit Rang 4, das die vier homogenen Farbkomponenten enthält, die von den vier geprüften Texelwerten erfasst wurden.

Öffentliche Konstruktoren

Name	Beschreibung
texture_view-Konstruktor	Überladen. Erstellt eine `texture_view`-Instanz.
~texture_view Destruktor	Zerstört die `texture_view`-Instanz.

Öffentliche Methoden

Name	Beschreibung
gather_alpha	Überladen. Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die blauen (w)-Komponenten der vier geprüften Texel zurück.
gather_blue	Überladen. Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die blauen (z)-Komponenten der vier geprüften Texel zurück.
gather_green	Überladen. Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die grünen (y)-Komponenten der vier geprüften Texel zurück.
gather_red	Überladen. Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die roten (x)-Komponenten der vier geprüften Texel zurück.
get	Überladen. Ruft den Elementwert durch Index ab.
sample	Überladen. Prüft die Textur an den festgelegten Koordinaten und den Detailgrad mithilfe der angegebenen Samplingkonfiguration.
set	Legt den Wert eines Elements mithilfe des Index fest.

Öffentliche Operatoren

Name	Beschreibung
operator()	Überladen. Ruft den Elementwert durch Index ab.
operator[]	Überladen. Ruft den Elementwert durch Index ab.
operator=	Überladen. Zuweisungsoperator.

Öffentliche Datenmember

Name	Beschreibung
value_type	Der Werttyp der Elemente des `texture_view`-Objekts.

Vererbungshierarchie

_Texture_base

texture_view

Anforderungen

Kopfzeile: amp_graphics.h

Namespace: Parallelität::graphics

~texture_view

Zerstört die texture_view-Instanz.

~texture_view() restrict(amp, cpu);

texture_view

Erstellt eine texture_view-Instanz.

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

Parameter

_Src
[1, 2] Konstruktor Der texture Konstruktor, auf dem die schreibbare texture_view Datei erstellt wird.

[3, 4] Konstruktor Der texture Konstruktor, für den die nicht schreibbare texture_view Datei erstellt wird.

_Other
[5] Kopieren Sie den Konstruktor die Quelle, die schreibbar ist texture_view.

[6, 7] Kopieren Sie den Konstruktor Die Quelle, die nicht schreibbar ist texture_view.

_Mipmap_level
Die bestimmte MipMap-Ebene auf dem texture-Quellobjekt, an das dieses schreibbare texture_view-Objekt gebunden wird. Der Standardwert ist 0, was die oberste (ausführlichste) MIP-Ebene darstellt.

_Most_detailed_mip
Die oberste (ausführlichste) Mip-Ebene für die Ansicht, relativ zum angegebenen texture_view-Objekt.

_Mip_levels
Die Anzahl von MipMap-Ebenen, die über das texture_view-Objekt verfügbar sind.

gather_red

Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die roten (x)-Komponenten der vier geprüften Texel zurück.

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

Parameter

_Address_mode
Der Adressmodus zum Prüfen des texture_view-Objekts. Der Adressmodus ist für alle Dimensionen identisch.

_Probierer
Die Samplerkonfiguration zur Prüfung des texture_view-Objekts.

_Coord
Die Koordinaten, an denen die Stichprobe genommen werden soll. Bruchkoordinatenwerte werden verwendet, um zwischen Beispieltexeln zu interpolieren.

Rückgabewert

Ein kurzer Vektor des Rangs 4, der die rote (x)-Komponente der 4 geprüften Texelwerte enthält.

gather_green

Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die grünen (y)-Komponenten der vier geprüften Texel zurück.

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

Parameter

_Address_mode
Der Adressmodus zum Prüfen des texture_view-Objekts. Der Adressmodus ist für alle Dimensionen identisch.

_Probierer
Die Samplerkonfiguration zur Prüfung des texture_view-Objekts.

_Coord
Die Koordinaten, an denen die Stichprobe genommen werden soll. Bruchkoordinatenwerte werden verwendet, um zwischen Beispieltexeln zu interpolieren.

Rückgabewert

Ein kurzer Vektor des Rangs 4, der die grüne (y)-Komponente der 4 geprüften Texelwerte enthält.

gather_blue

Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die blauen (z)-Komponenten der vier geprüften Texel zurück.

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

Parameter

_Address_mode
Der Adressmodus zum Prüfen des texture_view-Objekts. Der Adressmodus ist für alle Dimensionen identisch.

_Probierer
Die Samplerkonfiguration zur Prüfung des texture_view-Objekts.

_Coord
Die Koordinaten, an denen die Stichprobe genommen werden soll. Bruchkoordinatenwerte werden verwendet, um zwischen Beispieltexeln zu interpolieren.

Rückgabewert

Ein kurzer Vektor des Rangs 4, der die rote (x)-Komponente der 4 geprüften Texelwerte enthält.

gather_alpha

Prüft die Textur an den angegebenen Koordinaten mithilfe der angegebenen Samplingkonfiguration und gibt die blauen (w)-Komponenten der vier geprüften Texel zurück.

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

Parameter

_Address_mode
Der Adressmodus zum Prüfen des texture_view-Objekts. Der Adressmodus ist für alle Dimensionen identisch.

_Probierer
Die Samplerkonfiguration zur Prüfung des texture_view-Objekts.

_Coord
Die Koordinaten, an denen die Stichprobe genommen werden soll. Bruchkoordinatenwerte werden verwendet, um zwischen Beispieltexeln zu interpolieren.

Rückgabewert

Ein kurzer Vektor des Rangs 4, der die Alpha-(w)-Komponente der 4 geprüften Texelwerte enthält.

get

Ruft den Wert des Elements am angegebenen Index ab.

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

Parameter

_Index
Der Index des abzurufenden Elements, möglicherweise mehrdimensional.

_Mip_level
Die MipMap-Ebene, von der der Wert abgerufen werden soll. Der Standardwert 0 stellt die ausführlichste MipMap-Ebene dar.

Rückgabewert

Der Wert des Elements.

operator =

Weist dieser texture_view-Instanz eine Ansicht der gleichen Textur wie die angegebene texture_view zu.

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

Parameter

_Other
[1, 2] Kopieren Sie Konstruktor A beschreibbares texture_view Objekt.

[3] Kopieren Sie Konstruktor A nicht schreibbares texture_view Objekt.

Rückgabewert

Ein Verweis auf diese texture_view-Instanz.

operator[]

Gibt den Elementwert durch Index zurück.

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

Parameter

_Index
Der Index, möglicherweise mehrdimensional.

_I0
Der eindimensionale Index.

Rückgabewert

Der durch _Index indizierte Elementwert.

Operator()

Gibt den Elementwert durch Index zurück.

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

Parameter

_Index
Der Index, möglicherweise mehrdimensional.

_I0
Die wichtigste Komponente des Index.

_I1
Die zweitwichtigste Komponente des Index.

_I2
Die unwichtigste Komponente des Index.

Rückgabewert

Der durch _Index indizierte Elementwert.

Beispiel

Prüft die Textur an den festgelegten Koordinaten und den Detailgrad mithilfe der angegebenen Samplingkonfiguration.

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

Parameter

_Filter_mode
Der Filtermodus, der für das Sampling des texture_view-Objekts verwendet werden soll. Der Filtermodus ist für die Reduzierung, die Maximierung und die MipMap-Filter derselbe.

_Address_mode
Der Adressmodus, der zum Sampling des texture_view-Objekts verwendet werden soll. Der Adressmodus ist für alle Dimensionen identisch.

_Probierer
Die Samplerkonfiguration, die zum Sampling des texture_view-Objekts verwendet werden soll.

_Coord
Die Koordinaten, an denen die Stichprobe genommen werden soll. Bruchkoordinatenwerte werden verwendet, um zwischen Texelwerten zu interpolieren.

_Level_of_detail
Der Wert gibt die MipMap-Ebene für das Sampling an. Bruchwerte werden verwendet, um zwischen zwei MipMap-Ebenen zu interpolieren. Das Standarddetailniveau ist 0, was die ausführlichste MIP-Ebene darstellt.

Rückgabewert

Der interpolierte Beispielwert.

set

Legt den Wert des Elements am angegebenen Index auf den angegebenen Wert fest.

void set(
    const index<_Rank>& _Index,
    const value_type& value) const restrict(amp);

Parameter

_Index
Der Index des festzulegenden Elements, möglicherweise mehrdimensional.

value
Der Wert, auf den das Element festgelegt werden soll.

value_type

Der Werttyp der Elemente des texture_view-Objekts.

typedef typename const value_type value_type;

Siehe auch

Concurrency::graphics Namespace

Freigeben über

texture_view-Klasse

Syntax

Parameter

Member

Öffentliche Typedefs

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Operatoren

Öffentliche Datenmember

Vererbungshierarchie

Anforderungen

~texture_view

texture_view

Parameter

gather_red

Parameter

Rückgabewert

gather_green

Parameter

Rückgabewert

gather_blue

Parameter

Rückgabewert

gather_alpha

Parameter

Rückgabewert

get

Parameter

Rückgabewert

operator =

Parameter

Rückgabewert

operator[]

Parameter

Rückgabewert

Operator()

Parameter

Rückgabewert

Beispiel

Parameter

Rückgabewert

set

Parameter

value_type

Siehe auch

Feedback

Zusätzliche Ressourcen