Classe texture_view

Artigo
05/02/2022
8 minutos para o fim da leitura

Fornece acesso de leitura e acesso de gravação a uma textura. texture_view Só pode ser usado para ler texturas cujo tipo de valor seja int , unsigned int ou float que tenham o padrão de 32 bits bpse. 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

Name	Descrição
`value_type`	O tipo dos elementos na textura é agregado.
`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 cores homogêneos coletados dos quatro valores de Texel amostrados.

Construtores públicos

Name	Descrição
Construtor de texture_view	Sobrecarregado. Constrói uma `texture_view` instância do.
~ texture_view destruidor	Destrói a `texture_view` instância.

Métodos públicos

Name	Descrição
gather_alpha	Sobrecarregado. Amostra a textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes alfa (w) dos quatro exemplos de texels.
gather_blue	Sobrecarregado. Amostra a textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes azuis (z) dos quatro texels de amostra.
gather_green	Sobrecarregado. Amostra a textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes verdes (y) dos quatro exemplos de texels.
gather_red	Sobrecarregado. Amostra a textura nas coordenadas especificadas usando a configuração de amostragem especificada e retorna os componentes vermelhos (x) dos quatro texels de amostra.
get	Sobrecarregado. Obtém o valor do elemento por índice.
Nova	Sobrecarregado. Amostra a textura nas coordenadas especificadas e o nível de detalhes usando a configuração de amostragem especificada.
set	Define o valor de um elemento por índice.

Operadores públicos

Name	Descrição
operador ()	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

Name	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: simultaneidade:: Graphics

~ texture_view

Destrói a texture_view instância.

~texture_view() restrict(amp, cpu);

texture_view

Constrói uma texture_view instância do.

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 no texture em que o writable texture_view é criado.

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

_Other
[5] Construtor de cópia da origem gravável texture_view .

[6, 7] Copiar construtor a origem não gravável texture_view .

_Mipmap_level
O nível de mipmap específico na origem texture ao qual este texture_view é vinculado. O valor padrão é 0, que representa o nível de MIP de nível superior (mais detalhado).

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

_Mip_levels
O número de níveis de mipmap acessíveis por meio do texture_view .

gather_red

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

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

_Sampler
A configuração de amostra a ser usada para fazer a amostragem do texture_view .

_Coord
As coordenadas das quais obter o exemplo. Os valores de coordenadas fracionárias são usados para fazer a interpolação entre texels de exemplo.

Valor Retornado

Um vetor curto de classificação 4 que contém o componente vermelho (x) dos 4 valores de texel amostrados.

gather_green

Amostra a 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 amostrar o texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do exemplo a ser usada para amostrar o texture_view.

_Coord
As coordenadas das que a amostra será coletada. Os valores de coordenada fracionada são usados para interpolar entre os exemplos de texels.

Valor Retornado

Um vetor curto de classificação 4 que contém o componente verde (y) dos 4 valores de texel amostrados.

gather_blue

Amostra a 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 amostrar o texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do exemplo a ser usada para amostrar o texture_view.

_Coord
As coordenadas das que a amostra será coletada. Os valores de coordenada fracionada são usados para interpolar entre os exemplos de texels.

Valor Retornado

Um vetor curto de classificação 4 que contém o componente vermelho (x) dos 4 valores de texel amostrados.

gather_alpha

Amostra a 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 amostrar o texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do exemplo a ser usada para amostrar o texture_view.

_Coord
As coordenadas das que a amostra será coletada. Os valores de coordenada fracionada são usados para interpolar entre os exemplos de texels.

Valor Retornado

Um vetor curto de classificação 4 que contém o componente alfa (w) dos 4 valores de 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 obter, 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 Retornado

O valor do elemento.

operator=

Atribui uma exibição da mesma textura que o especificado texture_view a essa 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] Copiar Construtor Um objeto que pode ser escrito texture_view .

[3] Copiar Construtor Um objeto não pode ser escrito texture_view .

Valor Retornado

Uma referência a essa texture_view instância.

operator[]

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 Retornado

O valor do elemento indexado por _Index.

operator()

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 próximo ao mais significativo do índice.

_I2
O componente menos significativo do índice.

Valor Retornado

O valor do elemento indexado por _Index.

exemplo

Amostra a textura nas coordenadas e no nível de detalhes especificados 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 amostrar o 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 amostrar o texture_view. O modo de endereço é o mesmo para todas as dimensões.

_Sampler
A configuração do exemplo a ser usada para amostrar o texture_view.

_Coord
As coordenadas das que a amostra será coletada. Os valores de coordenada fracionada são usados para interpolar entre valores de texel.

_Level_of_detail
O valor especifica o nível de mipmap a ser amostrado. Valores fracionais 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 Retornado

O valor de amostra 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

Namespace Concurrency::graphics

Classe texture_view

Esta página é útil?

Sintaxe

Parâmetros

Membros

Typedefs públicos

Construtores públicos

Métodos públicos

Operadores públicos

Membros de Dados Públicos

Hierarquia de herança

Requisitos

~ texture_view

texture_view

Parâmetros

gather_red

Parâmetros

Valor Retornado

gather_green

Parâmetros

Valor Retornado

gather_blue

Parâmetros

Valor Retornado

gather_alpha

Parâmetros

Valor Retornado

get

Parâmetros

Valor Retornado

operator=

Parâmetros

Valor Retornado

operator[]

Parâmetros

Valor Retornado

operator()

Parâmetros

Valor Retornado

exemplo

Parâmetros

Valor Retornado

set

Parâmetros

value_type

Confira também