Класс texture_view

Статья
10/12/2023

Предоставляет доступ на чтение и запись к текстуре. texture_view можно использовать только для чтения текстур, тип значения которых имеет intзначение , unsigned intили float с 32-разрядным битом по умолчанию. Для чтения других форматов текстур используйте texture_view<const value_type, _Rank>.

Синтаксис

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>;

Параметры

value_type
Тип элементов в агрегате текстуры.

_Rank
Ранг texture_view.

Участники

Общедоступные определения типов

Имя	Описание
`value_type`	Тип элементов в агрегатах текстуры.
`coordinates_type`	Тип координаты, используемой для указания текселя в `texture_view`short_vector />, то есть имеет тот же ранг, что и связанная текстура с типом `float`значения.
`gather_return_type`	Возвращаемый тип, используемый для операций сбора, то есть ранг 4 `short_vector` , содержащий четыре однородные компоненты цвета, собранные из четырех выборочных значений текселя.

Открытые конструкторы

Имя	Описание
Конструктор texture_view	Перегружен. `texture_view` Создает экземпляр.
Деструктор ~texture_view	Уничтожает `texture_view` экземпляр.

Открытые методы

Имя	Описание
gather_alpha	Перегружен. Примеры текстуры с заданными координатами с помощью указанной конфигурации выборки и возвращают компоненты альфа-(w) четырех выборочных текселей.
gather_blue	Перегружен. Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают компоненты синих (z) четырех выборочных текселей.
gather_green	Перегружен. Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают зеленые компоненты (y) четырех выборочных текселей.
gather_red	Перегружен. Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают красные (x) компоненты четырех выборочных текселей.
get	Перегружен. Возвращает значение элемента по индексу.
sample	Перегружен. Примеры текстуры по указанным координатам и уровню детализации с помощью указанной конфигурации выборки.
set	Задает значение элемента по индексу.

Открытые операторы

Имя	Описание
operator()	Перегружен. Возвращает значение элемента по индексу.
оператор[]	Перегружен. Возвращает значение элемента по индексу.
operator=	Перегружен. Оператор присвоения.

Открытые члены данных

Имя	Описание
value_type	Тип значения элементов `texture_view`элемента .

Иерархия наследования

_Texture_base

texture_view

Требования

Заголовок: amp_graphics.h

Пространство имен: параллелизм::графика

~texture_view

Уничтожает texture_view экземпляр.

~texture_view() restrict(amp, cpu);

texture_view

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);

Параметры

_Src
[1, 2] Конструктор, texture на котором создается записываемая запись texture_view .

[3, 4] Конструктор, texture на котором создается недоступная texture_view запись.

_Other
[5] Конструктор копирования исходной записи texture_view.

[6, 7] Скопируйте конструктор источника, не допускающего texture_viewзаписи.

_Mipmap_level
Определенный уровень MIP-карты в источнике texture , к которому привязывается эта возможность texture_view записи. Значение по умолчанию — 0, представляющее уровень верхнего (наиболее подробного) mip-уровня.

_Most_detailed_mip
Уровень верхнего уровня (наиболее подробный) для представления относительно указанного texture_view объекта.

_Mip_levels
Количество уровней mipmap, доступных через texture_view.

gather_red

Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают красные (x) компоненты четырех выборочных текселей.

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);

Параметры

_Address_mode
Режим адреса, используемый для выборки texture_view. Режим адреса одинаков для всех измерений.

_Сборники
Конфигурация примера, используемая для выборки texture_view.

_Coord
Координаты, из которые нужно выполнить выборку. Значения дробной координаты используются для интерполяции между образцами текселей.

Возвращаемое значение

Ранг 4 короткий вектор, содержащий красный компонент (x) из 4 выборочных значений текселя.

gather_green

Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают зеленые компоненты (y) четырех выборочных текселей.

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);

Параметры

_Address_mode
Режим адреса, используемый для выборки texture_view. Режим адреса одинаков для всех измерений.

_Сборники
Конфигурация примера, используемая для выборки texture_view.

Возвращаемое значение

Ранг 4 короткий вектор, содержащий зеленый компонент (y) из 4 выборочных значений текселя.

gather_blue

Примеры текстуры по указанным координатам с помощью указанной конфигурации выборки и возвращают компоненты синих (z) четырех выборочных текселей.

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);

Параметры

_Address_mode
Режим адреса, используемый для выборки texture_view. Режим адреса одинаков для всех измерений.

_Сборники
Конфигурация примера, используемая для выборки texture_view.

Возвращаемое значение

Ранг 4 короткий вектор, содержащий красный компонент (x) из 4 выборочных значений текселя.

gather_alpha

Примеры текстуры с заданными координатами с помощью указанной конфигурации выборки и возвращают компоненты альфа-(w) четырех выборочных текселей.

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);

Параметры

_Address_mode
Режим адреса, используемый для выборки texture_view. Режим адреса одинаков для всех измерений.

_Сборники
Конфигурация примера, используемая для выборки texture_view.

Возвращаемое значение

Ранг 4 короткий вектор, содержащий компонент альфа -(w) из 4 выборочных значений текселя.

get

Возвращает значение элемента по указанному индексу.

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);

Параметры

_Index
Индекс элемента, который требуется получить, возможно, многомерный.

_Mip_level
Уровень mipmap, из которого мы должны получить значение. Значение по умолчанию 0 представляет самый подробный уровень mipmap.

Возвращаемое значение

Значение элемента.

operator=

Назначает представление той же текстуры, что и указанный texture_view экземпляру 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);

Параметры

_Other
[1, 2] Скопируйте объект Конструктора A, доступный для texture_view записи.

[3] Копирование конструктора A недоступного texture_view для записи объекта.

Возвращаемое значение

Ссылка на этот texture_view экземпляр.

оператор[]

Возвращает значение элемента по индексу.

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);

Параметры

_Index
Индекс, возможно, многомерный.

_I0
Одномерный индекс.

Возвращаемое значение

Значение элемента, индексированного по _Index.

operator()

Возвращает значение элемента по индексу.

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);

Параметры

_Index
Индекс, возможно, многомерный.

_I0
Наиболее значимый компонент индекса.

_I1
Следующий к наиболее значимым компоненту индекса.

_I2
Наименее значимый компонент индекса.

Возвращаемое значение

Значение элемента, индексированного по _Index.

пример

Примеры текстуры по указанным координатам и уровню детализации с помощью указанной конфигурации выборки.

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);

Параметры

_Filter_mode
Режим фильтра, используемый для выборки texture_view. Режим фильтра одинаков для фильтров минимизации, максимизации и mipmap.

_Address_mode
Режим адреса, используемый для выборки texture_view. Режим адреса одинаков для всех измерений.

_Сборники
Конфигурация примера, используемая для выборки texture_view.

_Coord
Координаты, из которые нужно выполнить выборку. Значения дробной координаты используются для интерполяции между значениями текселя.

_Level_of_detail
Значение задает уровень MIP-карты для примера. Дробные значения используются для интерполяции между двумя уровнями mipmap. Уровень детализации по умолчанию равен 0, который представляет самый подробный уровень MIP.

Возвращаемое значение

Интерполированное значение образца.

set

Задает значение элемента по указанному индексу заданному значению.

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

Параметры

_Index
Индекс элемента, который нужно задать, возможно, многомерный.

значение
Значение, которое необходимо присвоить элементу.

value_type

Тип значения элементов texture_view.

typedef typename const value_type value_type;

См. также

Пространство имен Concurrency::graphics

Поделиться через

Класс texture_view

Синтаксис

Параметры

Участники

Общедоступные определения типов

Открытые конструкторы

Открытые методы

Открытые операторы

Открытые члены данных

Иерархия наследования

Требования

~texture_view

texture_view

Параметры

gather_red

Параметры

Возвращаемое значение

gather_green

Параметры

Возвращаемое значение

gather_blue

Параметры

Возвращаемое значение

gather_alpha

Параметры

Возвращаемое значение

get

Параметры

Возвращаемое значение

operator=

Параметры

Возвращаемое значение

оператор[]

Параметры

Возвращаемое значение

operator()

Параметры

Возвращаемое значение

пример

Параметры

Возвращаемое значение

set

Параметры

value_type

См. также

Обратная связь

Обратная связь

Дополнительные ресурсы