Partilhar via


texture_view Classe

Fornece acesso de leitura e gravação a uma textura. texture_view só pode ser usado para ler texturas cujo tipo de valor é int, unsigned intou float que têm bpse de 32 bits padrão. Para ler outros formatos de textura, use texture_view<const value_type, _Rank>.

Sintaxe

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
O tipo dos elementos no agregado de textura.

_Rank
A classificação do texture_view.

Membros

Typedefs Públicos

Nome Descrição
value_type O tipo dos elementos nos agregados de textura.
coordinates_type O tipo da coordenada usada para especificar um texel no texture_view—ou seja, um short_vector que tem a mesma classificação que a textura associada que tem um tipo de valor de float.
gather_return_type O tipo de retorno usado para operações de coleta, ou seja, uma classificação 4 short_vector que contém os quatro componentes de cor homogêneos coletados dos quatro valores de texel amostrados.

Construtores Públicos

Nome Descrição
texture_view Construtor Sobrecarregado. Constrói uma texture_view instância.
~texture_view Destruidor Destrói a texture_view instância.

Métodos Públicos

Nome Descrição
gather_alpha Sobrecarregado. Recolhe amostras da textura nas coordenadas especificadas utilizando a configuração de amostragem especificada e devolve os componentes alfa (w) dos quatro texels amostrados.
gather_blue Sobrecarregado. Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes azuis (z) dos quatro texels amostrados.
gather_green Sobrecarregado. Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes verdes (y) dos quatro texels amostrados.
gather_red Sobrecarregado. Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes vermelhos (x) dos quatro texels amostrados.
obter Sobrecarregado. Obtém o valor do elemento por índice.
amostra Sobrecarregado. Coleta amostras da textura nas coordenadas especificadas e no nível de detalhe usando a configuração de amostragem especificada.
definido Define o valor de um elemento por índice.

Operadores Públicos

Nome Descrição
operador(es) Sobrecarregado. Obtém o valor do elemento por índice.
operador[] Sobrecarregado. Obtém o valor do elemento por índice.
operador= Sobrecarregado. Operador de atribuição.

Membros de Dados Públicos

Nome Descrição
value_type O tipo de valor dos elementos do texture_view.

Hierarquia de herança

_Texture_base

texture_view

Requerimentos

Cabeçalho: amp_graphics.h

Namespace: simultaneidade::gráficos

~texture_view

Destrói a texture_view instância.

~texture_view() restrict(amp, cpu);

texture_view

Constrói uma texture_view instância.

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] Construtor O texture no qual o gravável texture_view é criado.

[3, 4] Construtor O texture no qual o não-gravável texture_view é criado.

_Other
[5] Copy Constructor A fonte gravável texture_view.

[6, 7] Copy Construtor A fonte não gravável texture_view.

_Mipmap_level
O nível mipmap específico na fonte texture à qual este gravável texture_view se liga. O valor padrão é 0, que representa o nível de mip de nível superior (mais detalhado).

_Most_detailed_mip
Nível superior (mais detalhado) nível mip para a exibição, relativo ao objeto especificado texture_view .

_Mip_levels
O número de níveis de mipmap acessíveis através do texture_view.

gather_red

Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes vermelhos (x) dos quatro texels amostrados.

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
O modo de endereço a ser usado para obter a amostra do texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do amostrador a ser usada para a amostra do texture_view.

_Coord
As coordenadas de onde retirar a amostra. Os valores das coordenadas fracionárias são usados para interpolar entre os texels da amostra.

Valor de retorno

Um vetor curto de classificação 4 contendo o componente vermelho (x) dos 4 valores de texel amostrados.

gather_green

Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes verdes (y) dos quatro texels amostrados.

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
O modo de endereço a ser usado para obter a amostra do texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do amostrador a ser usada para a amostra do texture_view.

_Coord
As coordenadas de onde retirar a amostra. Os valores das coordenadas fracionárias são usados para interpolar entre os texels da amostra.

Valor de retorno

Um vetor curto de classificação 4 contendo o componente verde (y) dos 4 valores de texel amostrados.

gather_blue

Coleta amostras da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes azuis (z) dos quatro texels amostrados.

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
O modo de endereço a ser usado para obter a amostra do texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do amostrador a ser usada para a amostra do texture_view.

_Coord
As coordenadas de onde retirar a amostra. Os valores das coordenadas fracionárias são usados para interpolar entre os texels da amostra.

Valor de retorno

Um vetor curto de classificação 4 contendo o componente vermelho (x) dos 4 valores de texel amostrados.

gather_alpha

Recolhe amostras da textura nas coordenadas especificadas utilizando a configuração de amostragem especificada e devolve os componentes alfa (w) dos quatro texels amostrados.

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
O modo de endereço a ser usado para obter a amostra do texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do amostrador a ser usada para a amostra do texture_view.

_Coord
As coordenadas de onde retirar a amostra. Os valores das coordenadas fracionárias são usados para interpolar entre os texels da amostra.

Valor de retorno

Um vetor curto de classificação 4 contendo o componente alfa (w) dos 4 valores de texel amostrados.

obter

Obtém o valor do elemento no í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
O índice do elemento a obter, possivelmente multidimensional.

_Mip_level
O nível mipmap a partir do qual devemos obter o valor. O valor padrão 0 representa o nível mipmap mais detalhado.

Valor de retorno

O valor do elemento.

operador=

Atribui uma exibição da mesma textura especificada texture_view a esta texture_view instância.

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] Copy Construtor Um objeto gravável texture_view .

[3] Construtor Copy: Um objeto não gravável texture_view .

Valor de retorno

Uma referência a este texture_view caso.

operador[]

Retorna o valor do 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
O índice, possivelmente multidimensional.

_I0
O índice unidimensional.

Valor de retorno

O valor do elemento indexado por _Index.

operador()

Retorna o valor do 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
O índice, possivelmente multidimensional.

_I0
O componente mais significativo do índice.

_I1
O componente mais significativo do índice.

_I2
O componente menos significativo do índice.

Valor de retorno

O valor do elemento indexado por _Index.

amostra

Coleta amostras da textura nas coordenadas especificadas e no nível de detalhe usando a configuração de amostragem 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
O modo de filtro a ser usado para obter amostras do texture_view. O modo de filtro é o mesmo para os filtros de minimização, maximização e mipmap.

_Address_mode
O modo de endereço a ser usado para obter a amostra do texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do amostrador a ser usada para a amostra do texture_view.

_Coord
As coordenadas de onde retirar a amostra. Os valores das coordenadas fracionárias são usados para interpolar entre os valores texel.

_Level_of_detail
O valor especifica o nível mipmap a partir do qual a amostra será amostrada. Os valores fracionários são usados para interpolar entre dois níveis de mipmap. O nível padrão de detalhe é 0, que representa o nível de mip mais detalhado.

Valor de retorno

O valor da amostra interpolada.

conjunto/configuração

Define o valor do elemento no índice especificado para o valor especificado.

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

Parâmetros

_Index
O índice do elemento a definir, possivelmente multidimensional.

valor
O valor para definir o elemento para.

value_type

O tipo de valor dos elementos do texture_view.

typedef typename const value_type value_type;

Ver também

Simultaneidade::namespace de gráficos