texture_view-Klasse
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.
_Sampler
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.
_Sampler
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.
_Sampler
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.
_Sampler
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.
_Sampler
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für