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

Класс texture_view

Предоставляет доступ на чтение и запись к текстуре. 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>;

Параметры

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

_Ранг
Ранг texture_view.

Участники

Общедоступные typedefы

Имя Описание
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) компоненты четырех выбранных текселей.
Получить Перегружен. Возвращает значение элемента по индексу.
пример Перегружен. Отбирает текстуру по указанным координатам и уровню детализации, используя указанную конфигурацию выборки.
установить Задает значение элемента по индексу.

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

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

Публичные члены данных

Имя Описание
тип значения Тип значения элементов 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_view.

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

_Другой
[5] Конструктор копирования для записываемого источника texture_view.

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

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

_Most_detailed_mip
Наиболее подробный уровень 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.

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

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

Короткий вектор ранга 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.

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

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

Короткий вектор ранга 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.

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

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

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

получить

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

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

Параметры

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

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

Параметры

_Другой
[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);

Параметры

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

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

Параметры

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

_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
Координаты, из которых нужно выполнить выборку. Значения дробной координаты используются для интерполяции между значениями текселя.

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

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

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

набор

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

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

Параметры

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

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

value_type

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

typedef typename const value_type value_type;

См. также

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

  • Last updated on