Compartir a través de


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;

Consulte también

Concurrency::graphics (espacio de nombres)