Classe texture_view
Fornece acesso de leitura e acesso de gravação a uma textura. O texture_view só pode ser usado para ler texturas cujo tipo de valor seja int, unsigned int ou float, que tenham padrão bpse de 32 bits. 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 na agregação de textura.
_Rank
A classificação do texture_view.
Membros
Typedefs públicos
| Nome | Descrição |
|---|---|
value_type |
O tipo dos elementos nas agregações 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, um short_vector de classificação 4 que contém os quatro componentes de cor homogênea coletados dos quatro valores texel amostrados. |
Construtores públicos
| Nome | Descrição |
|---|---|
| Construtor texture_view | Sobrecarregado. Constrói uma instância de texture_view. |
| Destruidor ~texture_view | Destrói a instância texture_view. |
Métodos públicos
| Nome | Descrição |
|---|---|
| gather_alpha | Sobrecarregado. Faz amostragem da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes alfa (w) dos quatro texels amostrados. |
| gather_blue | Sobrecarregado. Faz amostragem 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. Faz amostragem 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. Faz amostragem da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes vermelhos (x) dos quatro texels amostrados. |
| get | Sobrecarregado. Obtém o valor do elemento por índice. |
| sample | Sobrecarregado. Faz amostragem da textura nas coordenadas especificadas e no nível de detalhes usando a configuração de amostragem especificada. |
| set | Define o valor de um elemento por índice. |
Operadores públicos
| Nome | Descrição |
|---|---|
| operador() | Sobrecarregado. Obtém o valor do elemento por índice. |
| operador[] | Sobrecarregado. Obtém o valor do elemento por índice. |
| operator= | 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
Requisitos
Cabeçalho: amp_graphics.h
Namespace: concurrency::graphics
~texture_view
Destrói a instância texture_view.
~texture_view() restrict(amp, cpu);
texture_view
Constrói uma instância 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] Construtor O texture no qual o texture_view gravável é criado.
[3, 4] Construtor O texture no qual o texture_view não gravável é criado.
_Other
[5] Construtor de cópia A origem gravável do texture_view.
[6, 7] Construtor de cópia A origem não gravável do texture_view.
_Mipmap_level
O nível de mipmap específico na origem texture ao qual esse texture_view gravável está associado. 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) de mip para a exibição, em relação ao objeto texture_view especificado.
_Mip_levels
O número de níveis de mipmap acessíveis por meio do texture_view.
gather_red
Faz amostragem 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 fazer a amostragem de texture_view. O modo de endereço é o mesmo para todas as dimensões.
_Sampler
A configuração da amostra a ser usada para fazer a amostragem de texture_view.
_Coord
As coordenadas das qual tirar a amostra. Valores de coordenadas fracionárias são usados para interpolar entre texels de amostra.
Valor de Devolução
Um vetor curto de classificação 4 que contém o componente vermelho (x) dos quatro valores texel amostrados.
gather_green
Faz amostragem 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 fazer a amostragem de texture_view. O modo de endereço é o mesmo para todas as dimensões.
_Sampler
A configuração da amostra a ser usada para fazer a amostragem de texture_view.
_Coord
As coordenadas das qual tirar a amostra. Valores de coordenadas fracionárias são usados para interpolar entre texels de amostra.
Valor de Devolução
Um vetor curto de classificação 4 que contém o componente verde (y) dos quatro valores texel amostrados.
gather_blue
Faz amostragem 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 fazer a amostragem de texture_view. O modo de endereço é o mesmo para todas as dimensões.
_Sampler
A configuração da amostra a ser usada para fazer a amostragem de texture_view.
_Coord
As coordenadas das qual tirar a amostra. Valores de coordenadas fracionárias são usados para interpolar entre texels de amostra.
Valor de Devolução
Um vetor curto de classificação 4 que contém o componente vermelho (x) dos quatro valores texel amostrados.
gather_alpha
Faz amostragem da textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna 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 fazer a amostragem de texture_view. O modo de endereço é o mesmo para todas as dimensões.
_Sampler
A configuração da amostra a ser usada para fazer a amostragem de texture_view.
_Coord
As coordenadas das qual tirar a amostra. Valores de coordenadas fracionárias são usados para interpolar entre texels de amostra.
Valor de Devolução
Um vetor curto de classificação 4 que contém o componente alfa (w) dos quatro valores texel amostrados.
get
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 ser obtido, possivelmente multidimensional.
_Mip_level
O nível de mipmap do qual devemos obter o valor. O valor padrão 0 representa o nível de mipmap mais detalhado.
Valor de Devolução
O valor do elemento.
operator=
Atribui uma exibição da mesma textura que a texture_view especificada a esta instância 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] Construtor de cópia Um objeto texture_view gravável.
[3] Construtor de cópia Um objeto texture_view não gravável.
Valor de Devolução
Uma referência a essa instância de texture_view.
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 Devolução
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 segundo componente mais significativo do índice.
_I2
O componente menos significativo do índice.
Valor de Devolução
O valor do elemento indexado por _Index.
sample
Faz amostragem da textura nas coordenadas especificadas e no nível de detalhes 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 fazer amostragem 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 fazer amostragem do texture_view. O modo de endereço é o mesmo para todas as dimensões.
_Sampler
A configuração da amostra a ser usada para fazer amostragem do texture_view.
_Coord
As coordenadas das qual tirar a amostra. Valores de coordenadas fracionárias são usados para interpolar entre valores texel.
_Level_of_detail
O valor especifica o nível de mipmap do qual amostrar. Valores fracionários são usados para interpolar entre dois níveis de mipmap. O nível padrão de detalhes é 0, que representa o nível de mip mais detalhado.
Valor de Devolução
O valor de exemplo interpolado.
set
Define o valor do elemento no índice especificado como o valor especificado.
void set(
const index<_Rank>& _Index,
const value_type& value) const restrict(amp);
Parâmetros
_Index
O índice do elemento a ser definido, possivelmente multidimensional.
value
O valor com o qual o elemento será definido.
value_type
O tipo de valor dos elementos do texture_view.
typedef typename const value_type value_type;
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de