texture_view (Clase)
Proporciona acceso de lectura y de escritura a una textura. texture_view solo se puede usar para leer texturas cuyo tipo de valor es int, unsigned int o float que tienen un bpse de 32 bits predeterminado. Para leer otros formatos de textura, use texture_view<const value_type, _Rank>.
Sintaxis
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>;
Parámetros
value_type
Tipo de los elementos del agregado de textura.
_Rank
Rango de texture_view.
Miembros
Definiciones de tipos públicas
| Nombre | Descripción |
|---|---|
value_type |
Tipo de los elementos de los agregados de textura. |
coordinates_type |
Tipo de la coordenada utilizada para especificar un elemento de textura en texture_view, es decir, que short_vector tiene el mismo rango que la textura asociada que tiene un tipo de valor de float. |
gather_return_type |
Tipo de valor devuelto utilizado para las operaciones de recopilación, es decir, un short_vector de rango 4 que contiene los cuatro componentes de color homogéneos recopilados de los cuatro valores de elementos de textura muestreados. |
Constructores públicos
| Nombre | Descripción |
|---|---|
| Constructor texture_view | Con sobrecarga. Crea una instancia de texture_view. |
| Destructor ~texture_view | Destruye la instancia de texture_view. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| gather_alpha | Con sobrecarga. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes alfa (w) de los cuatro elementos de textura muestreados. |
| gather_blue | Con sobrecarga. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes azules (z) de los cuatro elementos de textura muestreados. |
| gather_green | Con sobrecarga. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes verdes (y) de los cuatro elementos de textura muestreados. |
| gather_red | Con sobrecarga. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes rojos (x) de los cuatro elementos de textura muestreados. |
| get | Con sobrecarga. Obtiene el valor del elemento por índice. |
| sample | Con sobrecarga. Muestrea la textura en las coordenadas y el nivel de detalle especificados mediante la configuración de muestreo especificada. |
| set | Establece el valor de un elemento por índice. |
Operadores públicos
| Nombre | Descripción |
|---|---|
| operator() | Con sobrecarga. Obtiene el valor del elemento por índice. |
| operator[] | Con sobrecarga. Obtiene el valor del elemento por índice. |
| operator= | Con sobrecarga. Operador de asignación. |
Miembros de datos públicos
| Nombre | Descripción |
|---|---|
| value_type | Tipo de valor de los elementos de texture_view. |
Jerarquía de herencia
_Texture_base
texture_view
Requisitos
Encabezado: amp_graphics.h
Espacio de nombres: concurrency::graphics
~texture_view
Destruye la instancia de texture_view.
~texture_view() restrict(amp, cpu);
texture_view
Crea una instancia de texture_view.
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);
Parámetros
_Src
[1, 2] Constructor texture en la que se crea la escritura texture_view.
[3, 4] Constructor texture en la que se crea el objeto texture_view que no se puede escribir.
_Other
[5] Constructor de copia Objeto texture_view que se puede escribir del origen.
[6, 7] Constructor de copia Objeto texture_view que no se puede escribir del origen.
_Mipmap_level
Nivel de asignación de MIP específico en el objeto texture de origen al que se enlaza este objeto texture_view de escritura. El valor predeterminado es 0, que representa el nivel superior de MIP (más detallado).
_Most_detailed_mip
Nivel superior (más detallado) de MIP para la vista, en relación con el objeto especificado texture_view.
_Mip_levels
Número de niveles de asignación de MIP accesibles a través de texture_view.
gather_red
Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes rojos (x) de los cuatro elementos de textura muestreados.
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);
Parámetros
_Address_mode
Modo de dirección que se va a usar para muestrear texture_view. El modo de dirección es el mismo para todas las dimensiones.
_Sampler
Configuración del objeto sampler que se va a usar para muestrear texture_view.
_Coord
Coordenadas de las que se va a tomar la muestra. Los valores de coordenadas fraccionarios se usan para interpolar entre elementos de textura de ejemplo.
Valor devuelto
Vector corto de rango 4 que contiene el componente rojo (x) de los 4 valores de textura muestreados.
gather_green
Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes verdes (y) de los cuatro elementos de textura muestreados.
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);
Parámetros
_Address_mode
Modo de dirección que se va a usar para muestrear texture_view. El modo de dirección es el mismo para todas las dimensiones.
_Sampler
Configuración del objeto sampler que se va a usar para muestrear texture_view.
_Coord
Coordenadas de las que se va a tomar la muestra. Los valores de coordenadas fraccionarios se usan para interpolar entre elementos de textura de ejemplo.
Valor devuelto
Vector corto de rango 4 que contiene el componente verde (y) de los 4 valores de textura muestreados.
gather_blue
Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes azules (z) de los cuatro elementos de textura muestreados.
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);
Parámetros
_Address_mode
Modo de dirección que se va a usar para muestrear texture_view. El modo de dirección es el mismo para todas las dimensiones.
_Sampler
Configuración del objeto sampler que se va a usar para muestrear texture_view.
_Coord
Coordenadas de las que se va a tomar la muestra. Los valores de coordenadas fraccionarios se usan para interpolar entre elementos de textura de ejemplo.
Valor devuelto
Vector corto de rango 4 que contiene el componente rojo (x) de los 4 valores de textura muestreados.
gather_alpha
Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes alfa (w) de los cuatro elementos de textura muestreados.
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);
Parámetros
_Address_mode
Modo de dirección que se va a usar para muestrear texture_view. El modo de dirección es el mismo para todas las dimensiones.
_Sampler
Configuración del objeto sampler que se va a usar para muestrear texture_view.
_Coord
Coordenadas de las que se va a tomar la muestra. Los valores de coordenadas fraccionarios se usan para interpolar entre elementos de textura de ejemplo.
Valor devuelto
Vector corto de rango 4 que contiene el componente alfa (w) de los 4 valores de textura muestreados.
get
Obtiene el valor del elemento en el índice especificado.
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);
Parámetros
_Index
Índice del elemento que se va a obtener, posiblemente multidimensional.
_Mip_level
Nivel de asignación de MIP desde el que se debe obtener el valor. El valor predeterminado 0 representa el nivel de asignación de MIP más detallado.
Valor devuelto
El valor del elemento.
operator=
Asigna una vista de la misma textura que el objeto texture_view especificado a esta instancia de texture_view.
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);
Parámetros
_Other
[1, 2] Constructor de copia Objeto texture_view grabable.
[3] Constructor de copia Objeto texture_view no grabable.
Valor devuelto
Referencia a esta instancia de texture_view.
operator[]
Devuelve el valor del elemento por índice.
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);
Parámetros
_Index
Índice, posiblemente multidimensional.
_I0
Índice unidimensional.
Valor devuelto
Valor del elemento indexado por _Index.
operator()
Devuelve el valor del elemento por índice.
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);
Parámetros
_Index
Índice, posiblemente multidimensional.
_I0
Componente más significativo del índice.
_I1
Componente siguiente al más significativo del índice.
_I2
Componente menos significativo del índice.
Valor devuelto
Valor del elemento indexado por _Index.
sample
Muestrea la textura en las coordenadas y el nivel de detalle especificados mediante la configuración de muestreo especificada.
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);
Parámetros
_Filter_mode
Modo de filtro que se va a usar para muestrear el objeto texture_view. El modo de filtro es el mismo para los filtros de minimización, maximización y asignación de MIP.
_Address_mode
Modo de dirección que se va a usar para muestrear el objeto texture_view. El modo de dirección es el mismo para todas las dimensiones.
_Sampler
Configuración del objeto sampler que se va a usar para muestrear el objeto texture_view.
_Coord
Coordenadas de las que se va a tomar la muestra. Los valores de coordenadas fraccionarios se usan para interpolar entre valores de textura.
_Level_of_detail
El valor especifica el nivel de asignación de MIP del que se va a muestrear. Los valores fraccionarios se usan para interpolar entre dos niveles de asignación de MIP. El nivel de detalle predeterminado es 0, que representa el nivel de MIP más detallado.
Valor devuelto
Valor de muestra interpolado.
set
Establece el valor del elemento en el índice especificado en el valor especificado.
void set(
const index<_Rank>& _Index,
const value_type& value) const restrict(amp);
Parámetros
_Index
Índice del elemento que se va a establecer, posiblemente multidimensional.
value
Valor en el que se va a establecer el elemento.
value_type
Tipo de valor de los elementos del objeto texture_view.
typedef typename const value_type value_type;