Compartir por


Clase texture_view

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

tipo_de_valor
Tipo de los elementos del agregado de textura.

_Rango
Rango de texture_view.

Miembros

Definiciones de tipos públicas

Nombre Descripción
value_type Tipo de elementos de los agregados de textura.
coordinates_type Tipo de coordenada utilizada para especificar un texel en texture_view, es decir, un short_vector que tiene el mismo rango que la textura asociada y un tipo de valor de float.
gather_return_type Tipo de valor devuelto utilizado para las operaciones de agregación, es decir, un de orden 4 short_vector que contiene los cuatro componentes de color homogéneos reunidos de los cuatro valores de texel muestreados.

Constructores públicos

Nombre Descripción
Constructor texture_view Sobrecargado Crea una instancia de texture_view.
~texture_view Destructor Destruye la instancia de texture_view.

Métodos públicos

Nombre Descripción
gather_alpha Sobrecargado 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 Sobrecargado 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 Sobrecargado 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 Sobrecargado 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.
Obtener Sobrecargado Obtiene el valor del elemento por índice.
muestra Sobrecargado Muestrea la textura en las coordenadas y el nivel de detalle especificados mediante la configuración de muestreo especificada.
ajustar Establece el valor de un elemento por índice.

Operadores públicos

Nombre Descripción
operator() Sobrecargado Obtiene el valor del elemento por índice.
operador [] Sobrecargado Obtiene el valor del elemento por índice.
operator= Sobrecargado Operador de asignación.

Miembros de datos públicos

Nombre Descripción
tipo_de_valor 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);

vista_de_textura

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

_Fuente
[1, 2] Constructor texture en el que se crea el elemento escribible texture_view.

[3, 4] El constructor texture sobre el cual se crea el elemento texture_view no escribible.

_Other
[5] Constructor de copia Objeto texture_view que se puede escribir del origen.

[6, 7] Constructor de copia El origen texture_view no es escribible.

_Mipmap_level
El nivel específico de mipmap en el texture de origen al que se enlaza este texture_view escribible. 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 mipmap 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

_modo_de_dirección
El modo de dirección que se utilizará para muestrear el 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 texeles de muestra.

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

_modo_de_dirección
Modo de dirección para usar en el muestreo de texture_view. El modo de dirección es el mismo para todas las dimensiones.

_Sampleador
Configuración del muestreador que se va a usar para muestrear texture_view.

_Coord
Coordenadas de las que se va a tomar la muestra. Los valores fraccionarios de coordenadas se utilizan para interpolar entre texels de muestra.

Valor devuelto

Vector de rango corto 4 que incluye el componente verde (y) de los 4 valores de texel 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

_modo_de_dirección
El modo de dirección a utilizar 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 utilizan para interpolar entre texels de muestra.

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

_modo_de_dirección
El modo de dirección que se utilizará para muestrear el texture_view. El modo de direccionamiento es el mismo para todas las dimensiones.

_Sampler
Configuración del 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 texeles de muestra.

Valor devuelto

Vector corto de nivel 4 que contiene el componente alfa (w) de los 4 valores de texel muestreados.

obtener

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

_Índice
Índice del elemento que se va a obtener, que podría ser multidimensional.

_Mip_level
El nivel de mipmap desde el que se debe obtener el valor. El valor predeterminado 0 representa el nivel de mipmap más detallado.

Valor devuelto

El valor del elemento.

operador =

Asigna a esta instancia de texture_view una vista de la misma textura que la especificada por 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 de un objeto texture_view grabable.

[3] Constructor de copia Objeto texture_view no escribible.

Valor devuelto

Referencia a esta instancia de texture_view.

operador[]

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

_Índice
Í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

_Índice
Í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.

muestra

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 para el muestreo de texture_view. El modo de filtro es el mismo para los filtros de minimización, maximización y mipmap.

_modo_de_dirección
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 "sampler" que se va a usar para muestrear el "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 texel.

_Nivel_de_Detalle
El valor especifica el nivel de mipmap del que se va a tomar la muestra. Los valores fraccionarios se utilizan para interpolar entre dos niveles de mipmap. El nivel de detalle predeterminado es 0, que representa el nivel de MIP más detallado.

Valor devuelto

Valor de muestra interpolado.

establecer

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

_Índice
Índice del elemento que se va a establecer, posiblemente multidimensional.

valor
Valor en el que se va a establecer el elemento.

tipo_de_valor

Tipo de valor de los elementos del objeto texture_view.

typedef typename const value_type value_type;

Consulte también

Concurrency::graphics Namespace