texture_view (Clase)texture_view Class

Proporciona acceso de lectura y acceso de escritura a una textura.Provides read access and write access to a texture. texture_viewsolo se puede usar para leer texturas cuyo tipo de valor sea int , unsigned int , o float que tengan un valor predeterminado de 32 bits bpse.texture_view can only be used to read textures whose value type is int, unsigned int, or float that have default 32-bit bpse. Para leer otros formatos de textura, use texture_view<const value_type, _Rank> .To read other texture formats, use texture_view<const value_type, _Rank>.

SintaxisSyntax

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ámetrosParameters

value_typevalue_type
Tipo de los elementos del agregado de textura.The type of the elements in the texture aggregate.

_Rank_Rank
Rango de texture_view .The rank of the texture_view.

MiembrosMembers

Definiciones de tipos públicasPublic Typedefs

NombreName DescripciónDescription
value_type Tipo de los elementos de los agregados de textura.The type of the elements in the texture aggregates.
coordinates_type El tipo de la coordenada que se usa para especificar un textura en el, es texture_view decir, un objeto short_vector que tiene el mismo rango que la textura asociada que tiene un tipo de valor float .The type of the coordinate used to specify a texel in the texture_view—that is, a short_vector that has the same rank as the associated texture that has a value type of float.
gather_return_type El tipo de valor devuelto que se usa para las operaciones de recopilación, es decir, un rango 4 short_vector que contiene los cuatro componentes de color homogéneos que se recopilan de los cuatro valores de textura muestreados.The return type used for gather operations—that is, a rank 4 short_vector that holds the four homogenous color components gathered from the four texel values sampled.

Constructores públicosPublic Constructors

NombreName DescripciónDescription
Constructor de texture_viewtexture_view Constructor Sobrecargado.Overloaded. Construye una texture_view instancia de.Constructs a texture_view instance.
~ texture_view destructor~texture_view Destructor Destruye la texture_view instancia de.Destroys the texture_view instance.

Métodos públicosPublic Methods

NOMBREName DescripciónDescription
gather_alphagather_alpha Sobrecargado.Overloaded. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes alfa (w) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the alpha (w) components of the four sampled texels.
gather_bluegather_blue Sobrecargado.Overloaded. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes azules (z) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the blue (z) components of the four sampled texels.
gather_greengather_green Sobrecargado.Overloaded. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes verdes (y) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the green (y) components of the four sampled texels.
gather_redgather_red Sobrecargado.Overloaded. Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes rojo (x) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the red (x) components of the four sampled texels.
getget Sobrecargado.Overloaded. Obtiene el valor del elemento por índice.Gets the element value by index.
AdventureWorkssample Sobrecargado.Overloaded. Muestrea la textura en las coordenadas especificadas y el nivel de detalle mediante la configuración de muestreo especificada.Samples the texture at the specified coordinates and level of detail by using the specified sampling configuration.
setset Establece el valor de un elemento por índice.Sets the value of an element by index.

Operadores públicosPublic Operators

NombreName DescripciónDescription
operador ()operator() Sobrecargado.Overloaded. Obtiene el valor del elemento por índice.Gets the element value by index.
Operator[]operator[] Sobrecargado.Overloaded. Obtiene el valor del elemento por índice.Gets the element value by index.
operador =operator= Sobrecargado.Overloaded. Operador de asignación.Assignment operator.

Miembros de datos públicosPublic Data Members

NombreName DescripciónDescription
value_typevalue_type Tipo de valor de los elementos de texture_view .The value type of the elements of the texture_view.

Jerarquía de herenciaInheritance Hierarchy

_Texture_base

texture_view

RequisitosRequirements

Encabezado: amp_graphics. hHeader: amp_graphics.h

Espacio de nombres: Concurrency:: GraphicsNamespace: concurrency::graphics

~ texture_view~texture_view

Destruye la texture_view instancia de.Destroys the texture_view instance.

~texture_view() restrict(amp, cpu);

texture_viewtexture_view

Construye una texture_view instancia de.Constructs a texture_view instance.

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ámetrosParameters

_Src_Src
[1,2] Constructor texture en el que se crea el que se puede escribir texture_view .[1, 2] Constructor The texture on which the writable texture_view is created.

[3,4] Constructor texture en el que se crea la no modificable texture_view .[3, 4] Constructor The texture on which the non-writable texture_view is created.

_Other_Other
[5] constructor de copias que se puede escribir en el origen texture_view .[5] Copy Constructor The source writable texture_view.

[6, 7] No se puede escribir en el constructor de copia texture_view .[6, 7] Copy Constructor The source non-writable texture_view.

_Mipmap_level_Mipmap_level
Nivel de mipmap específico del origen texture al que se enlaza este grabable texture_view .The specific mipmap level on the source texture that this writeable texture_view binds to. El valor predeterminado es 0, que representa el nivel de MIP de nivel superior (más detallado).The default value is 0, which represents the top level (most detailed) mip level.

_Most_detailed_mip_Most_detailed_mip
Nivel de MIP de nivel superior (más detallado) de la vista, en relación con el texture_view objeto especificado.Top level (most detailed) mip level for the view, relative to the specified texture_view object.

_Mip_levels_Mip_levels
El número de niveles de mipmap accesibles a través de texture_view .The number of mipmap levels accessible through the texture_view.

gather_redgather_red

Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes rojo (x) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the red (x) components of the four sampled texels.

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ámetrosParameters

_Address_mode_Address_mode
Modo de dirección que se va a utilizar para muestrear el texture_view .The address mode to use to sample the texture_view. El modo de dirección es el mismo para todas las dimensiones.The address mode is the same for all dimensions.

_Sampler_Sampler
La configuración de muestra que se va a usar para muestrear el texture_view .The sampler configuration to use to sample the texture_view.

_Coord_Coord
Coordenadas de las que se va a tomar la muestra.The coordinates to take the sample from. Los valores de coordenadas fraccionarios se utilizan para interpolar entre textura de ejemplo.Fractional coordinate values are used to interpolate between sample texels.

Valor devueltoReturn Value

Un vector corto de rango 4 que contiene el componente rojo (x) de los 4 valores de textura muestreados.A rank 4 short vector containing the red (x) component of the 4 sampled texel values.

gather_greengather_green

Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes verdes (y) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the green (y) components of the four sampled texels.

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ámetrosParameters

_Address_mode_Address_mode
Modo de dirección que se va a utilizar para muestrear el texture_view .The address mode to use to sample the texture_view. El modo de dirección es el mismo para todas las dimensiones.The address mode is the same for all dimensions.

_Sampler_Sampler
La configuración de muestra que se va a usar para muestrear el texture_view .The sampler configuration to use to sample the texture_view.

_Coord_Coord
Coordenadas de las que se va a tomar la muestra.The coordinates to take the sample from. Los valores de coordenadas fraccionarios se utilizan para interpolar entre textura de ejemplo.Fractional coordinate values are used to interpolate between sample texels.

Valor devueltoReturn Value

Un vector corto de rango 4 que contiene el componente verde (y) de los 4 valores de textura muestreados.A rank 4 short vector containing the green (y) component of the 4 sampled texel values.

gather_bluegather_blue

Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes azules (z) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the blue (z) components of the four sampled texels.

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ámetrosParameters

_Address_mode_Address_mode
Modo de dirección que se va a utilizar para muestrear el texture_view .The address mode to use to sample the texture_view. El modo de dirección es el mismo para todas las dimensiones.The address mode is the same for all dimensions.

_Sampler_Sampler
La configuración de muestra que se va a usar para muestrear el texture_view .The sampler configuration to use to sample the texture_view.

_Coord_Coord
Coordenadas de las que se va a tomar la muestra.The coordinates to take the sample from. Los valores de coordenadas fraccionarios se utilizan para interpolar entre textura de ejemplo.Fractional coordinate values are used to interpolate between sample texels.

Valor devueltoReturn Value

Un vector corto de rango 4 que contiene el componente rojo (x) de los 4 valores de textura muestreados.A rank 4 short vector containing the red (x) component of the 4 sampled texel values.

gather_alphagather_alpha

Muestrea la textura en las coordenadas especificadas mediante la configuración de muestreo especificada y devuelve los componentes alfa (w) de los cuatro textura muestreados.Samples the texture at the specified coordinates by using the specified sampling configuration and returns the alpha (w) components of the four sampled texels.

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ámetrosParameters

_Address_mode_Address_mode
Modo de dirección que se va a utilizar para muestrear el texture_view .The address mode to use to sample the texture_view. El modo de dirección es el mismo para todas las dimensiones.The address mode is the same for all dimensions.

_Sampler_Sampler
La configuración de muestra que se va a usar para muestrear el texture_view .The sampler configuration to use to sample the texture_view.

_Coord_Coord
Coordenadas de las que se va a tomar la muestra.The coordinates to take the sample from. Los valores de coordenadas fraccionarios se utilizan para interpolar entre textura de ejemplo.Fractional coordinate values are used to interpolate between sample texels.

Valor devueltoReturn Value

Un vector corto de rango 4 que contiene el componente alfa (w) de los 4 valores de textura muestreados.A rank 4 short vector containing the alpha (w) component of the 4 sampled texel values.

Obtenerget

Obtiene el valor del elemento en el índice especificado.Gets the value of the element at the specified index.

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ámetrosParameters

_Index_Index
Índice del elemento que se va a obtener, posiblemente multidimensional.The index of the element to get, possibly multi-dimensional.

_Mip_level_Mip_level
Nivel de mipmap del que se debe obtener el valor.The mipmap level from which we should get the value. El valor predeterminado 0 representa el nivel de mipmap más detallado.The default value 0 represents the most detailed mipmap level.

Valor devueltoReturn Value

El valor del elemento.The value of the element.

operador =operator=

Asigna una vista de la misma textura que la especificada texture_view a esta texture_view instancia.Assigns a view of the same texture as the specified texture_view to this texture_view instance.

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ámetrosParameters

_Other_Other
[1,2] El constructor de copia es un texture_view objeto grabable.[1, 2] Copy Constructor A writable texture_view object.

[3] constructor de copias de un objeto no grabable texture_view .[3] Copy Constructor A non-writable texture_view object.

Valor devueltoReturn Value

Referencia a esta texture_view instancia.A reference to this texture_view instance.

operador []operator[]

Devuelve el valor del elemento por índice.Returns the element value by index.

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ámetrosParameters

_Index_Index
Índice, posiblemente multidimensional.The index, possibly multi-dimensional.

_I0_I0
Índice unidimensional.The one-dimensional index.

Valor devueltoReturn Value

Valor del elemento indizado por _Index .The element value indexed by _Index.

operador ()operator()

Devuelve el valor del elemento por índice.Returns the element value by index.

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ámetrosParameters

_Index_Index
Índice, posiblemente multidimensional.The index, possibly multi-dimensional.

_I0_I0
Componente más significativo del índice.The most-significant component of the index.

_I1_I1
El siguiente componente más significativo del índice.The next-to-most-significant component of the index.

_I2_I2
El componente menos significativo del índice.The least-significant component of the index.

Valor devueltoReturn Value

Valor del elemento indizado por _Index .The element value indexed by _Index.

AdventureWorkssample

Muestrea la textura en las coordenadas especificadas y el nivel de detalle mediante la configuración de muestreo especificada.Samples the texture at the specified coordinates and level of detail by using the specified sampling configuration.

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ámetrosParameters

_Filter_mode_Filter_mode
Modo de filtro que se va a utilizar para muestrear el texture_view.The filter mode to use to sample the texture_view. El modo de filtro es el mismo para los filtros de minimización, maximización y mipmap.The filter mode is the same for the minimization, maximization, and mipmap filters.

_Address_mode_Address_mode
Modo de dirección que se va a utilizar para muestrear el texture_view.The address mode to use to sample the texture_view. El modo de dirección es el mismo para todas las dimensiones.The address mode is the same for all dimensions.

_Sampler_Sampler
La configuración de muestra que se va a usar para muestrear el texture_view.The sampler configuration to use to sample the texture_view.

_Coord_Coord
Coordenadas de las que se va a tomar la muestra.The coordinates to take the sample from. Los valores de coordenadas fraccionarios se utilizan para interpolar entre los valores de textura.Fractional coordinate values are used to interpolate between texel values.

_Level_of_detail_Level_of_detail
El valor especifica el nivel de mipmap del que se va a muestrear.The value specifies the mipmap level to sample from. Los valores fraccionarios se utilizan para interpolar entre dos niveles de mipmap.Fractional values are used to interpolate between two mipmap levels. El nivel de detalle predeterminado es 0, que representa el nivel de MIP más detallado.The default level of detail is 0, which represents the most detailed mip level.

Valor devueltoReturn Value

Valor de ejemplo interpolado.The interpolated sample value.

conjuntoset

Establece el valor del elemento en el índice especificado en el valor especificado.Sets the value of the element at the specified index to the specified value.

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

ParámetrosParameters

_Index_Index
Índice del elemento que se va a establecer, posiblemente multidimensional.The index of the element to set, possibly multi-dimensional.

valuevalue
Valor en el que se va a establecer el elemento.The value to set the element to.

value_typevalue_type

Tipo de valor de los elementos de la texture_view.The value type of the elements of the texture_view.

typedef typename const value_type value_type;

Consulte tambiénSee also

Concurrency::graphics (Espacio de nombres)Concurrency::graphics Namespace