М. Ву, Т. Девис, Дж. Нейдер, Д. Шрайнер - OpenGL. Руководство по программированию (Библиотека программиста) (2006), страница 103

предоставляет подпрограммы-инструменты, служащие для упрощения выбора в некоторых случаях, ограничивая рисование небольшой областью окна просмотра. Обычно вы используете такую подпрограмму, чтобы выяснить, какой объект нарисован вблизи указателя мыши, тем самым вы можете идентифицировать выбранный пользователем объект. (Вы можете также разграничить область выбора, указав дополнительные плоскости отсечения. Помните, что эти плоскости действуют в отношении мировых координат, но не в системе координат экрана.) Поскольку выбор с помощью указателя (р!сЫпд) является частным случаем выбора (зе!есг!оп), сначала в этой главе мы рассмотрим выбор в принципе, и лишь затем — выделение указателем мыши.

Основные шаги Чтобы задействовать механизм выбора, вы должны выполнить следующие шаги. 1. Указать массив, который будет использоваться для возвращаемых записей реакции, с помощью В15е1естВиттег О. 2. Войти в режим выбора посредством задания параметра 61 5 Ес ВСт для команды В1Репоегцоое(). 3. Инициализировать стек имен командами В11п!(йааез() и В1Ризлйаве(). 4.

Определить видимый объем, в котором будет возможен выбор. Обычно он не отличается от видимого объема вашей оригинальной нарисованной сцены, поэтому вероятно, что вы захотите сохранить и после восстановить текущее состояние преобразования — с помощью В1Ризлнасг!х() и В1Рорпатг1х(). 5. Поочередно вызывать команды отображения примитивов и команды манипулирования стеком имен с целью присвоить каждому заслуживающему интерес примитиву соответствующее имя, 6. Выйти из режима выбора и обработать возвращенные механизмом выбора записи реакции.

чо!г! В15е1естботтег(01л!ге! з(ге, 01п!п( 'ЬиЦег); Задает массив, используемый для возвращаемых при выборе данных. Аргумент ЬиДег — это указатель на массив беззнаковых целых, куда помешаются зти данные, а аргумент зые указывает максимальное количество значений, которые могут быть сохранены в массиве. Вам следует сделать вызов В15е1ессаиттег() перед входом в режим выбора. Выбор 469 сз1.!пс В1йепбегИобе(01еппщ тоЫе); Управляет тем, в каком режиме приложение будет выполнять визуализацию — в режиме выбора или обратной связи.

Аргумент режима то/(е задается равным 6С йЕМОЕй (по умолчанию), 6С 5ЕСЕСТ или 61 РЕЕОВАСК. Приложение остается в указанном режиме до того момента, пока снова не будет выдана команда В1йепбегМобе() с другим аргументом режима. Перед входом в режим выбора нужно вызвать команду В15е1ессвиттег() для задания массива выбора. Аналогично, перед активизацией режилса обратной связи следует вызвать В1реебвасКВигтег() для задания массива ланных обратной связи.

Возвращаемое значение В1йепбегИобе() для текущего режима визуализации (то есть не значения аргумента тог(е); 61 5ЕсЕСТ или 61 РЕЕОВАСК представляет собой количество зарегистрированных попаданий или количество значений, помещенных в массив обратной связи; отрицательное число означает выход за границы (переполнение) массива. Вы можете использовать параметр 61 йЕМОЕй ИОВЕ совместно с В16ес1псекегу() для получения идентификатора текущего режима. В следующем разделе описаны команды для манипулирования стеком имен. Создание стека имен Как упоминалось в предыдущем разделе, стек имен закладывает основу для возвращаемой вам информации выбора.

Чтобы создать стек имен, сначала инициализируйте его командой В11п! (навез(), которая просто очищает стек, и затем добавьте целочисленные идентификаторы-имена во время выполнения соответствующих команд отображения. Как и следовало ожидать, команды, манипулирующие стеком, позволяют вам затолкнуть имя в него (В! Ризпйаве () ), вытолкнуть из него имя (В1Рорнаве()) и заменить имя на вершине стека другим (й11оабнаве()).

Листинг 13.1 демонстрирует, как программа может манипулировать стеком с помощью этих кома!Сд. Листинг 13.1. Создание стека имен я11птснавез(), я1Розпнаве(0); я1Розьнатгтх(); /* сохранение текущего соСтояния ПРеобразования /" здесь создается желаемый для вас видимый объем '/ й1(оабнаве( 1); бгаизовеОЬ)есС(); З1(оабнаве(2); ОгаидпослегОЬ)ест(): З1(оабкаве(З): бгаитеСАпогпегОЬ)есС(); Оган) озтопеногеОЬ)есС(); я1Рориасгтх(); /' восстановление предшествующего состояния преобразования '/ 470 Глава 13 ° Выбор и обратная связь В этом примере первые два рисуемых объекта имеют собственные имена, а третий и четвертый объекты совместно использу|от одно имя. При таких условиях выбор третьего или четвертого объекта повлечет возврат только одной записи реакции.

Вы вправе иметь множество объектов, разделяющих одно и то же имя, если различение объектов между собой не обязательно. уоЫ к1?п!(Навез(уоЫ); Очищает стек имен, который в результате становится пустым. ноЫ 61Рцзййаве(СЕц1п( пате); Заталкивает нмя пате в стек имен, Если при помещении имени в стек последний переполняется, генерируется ошибка 6( 5ТАСК ОНЕКРСОИ. Глубина стека имен может варьироваться в зависимости от реализации ОрепС1, но в него должны умешаться по меньшей мере 64 имени. Вы можете использовать параметр 6с мАме 5тАск ОеРтн совместно с к16ес1псекегуО для выяснения глубины вашего стека имен, уоЫ В1Рорйаве(тоЫ); Выталкивает одно имя из вершины стека имен.

При выталкивании из пустого стека генерируется ошибка 6С 5ТАСК ОМОЕМРСОМ. уоЫ х1Соадйаве(С1л1пс пате); Замещает значение на вершине стека имен именем пате. Если стек в исходном положении пуст, как это должно быть после вызова 611п)(навез (), команда я1(оапйаве О генерирует ошибку 6( 1МНА(10 ОРЕЙАТ10М. Во избежание атого хотя бы раз вызовите к1Рцзлйаве(), чтобы положить что-нибудь на вершину стека, перед вызовом 61(оас)йаве(). Вызовы 61Рцзййаве О, к1Рорйаве О и 61Соасйаве О игнорируются, если вы не переключились в режим выбора.

Вы заметите, что это упрощает кодирование, так как можно использовать один и тот же код, выполняющий отображение, в двух режимах — выбора н при обычной визуализации. Буфер выбора В режиме выбора примитивы, попадающие в видимый объем, вызывают запись реакции при выделении. Каждый раз при выполнении команды манипуляции стеком имен или вызове к1йепсегйопе() ОрепСЕ создает запись нажатия в массив таких записей. По ходу этого процесса обьекты с одинаковым именем — например, скомпонованные из более чем одного примитива — не вызывают повторную генерацию записи. Также гарантируется, что при вызове 61РепбегМобео избыточные записи выделений не попадут в возвращаемый массив.

ПРИМ)ЕЧАНИЕ В дополнение к геометрическим примитивам допустимые координаты позиции растра, вырабзтываемые вызовами дгяавегРозо или фуу~пооугРоз(), тоже могут оказаться причиной выбора нажатия. Также, если при активном режиме выбора походу отображения отбраковыааются (сцйпд) многоугольники, зто не приводит к формированию записи реакции. Выбор 471 Каждая запись нажатия состоит из следующих четырех элементов в указанном порядке: ° количество имен в стеке имен на момент выбора; ° максимальные и минимальные оконные координаты г для всех вершин всех примитивов, попадающих в видимый объем на момент последнего выбора. Эти два значения, которые лежат в диапазоне 10, 11, умножаются на 2" — 1 и округляются к ближайшему беззнаковому целому; ° содержимое стека имен во время ответа на выбор, где первым следует самый нижний элемент.

Когда вы входите в режим выбора, ОрепСЕ инициализирует указатель на начало массива записей реакции. Каждый раз при включении в массив новой записи указатель соответствующим образом обновляется. Если прн этом происходит выход за границы массива (превышение значения аргумента яге команды я15е1есСВОТТег () ), Орепбс.

записывает столько данных, сколько вмещает массив, и устанавливает признак переполнения. Когда вы покидаете режим выбора с помощью к(не оде гИопе (), эта команда возвращает количество принятых к рассмотрению записей реакции (включая неполную запись при ее наличии), очищает стек имен, сбрасывает флаг переполнения и указатель стека имен. Если был установлен флаг переполнения, возвращаемое значение равно -1. Пример выбора В программе из листинга 13.2 на экране рисуются четыре треугольника (зеленый, красный и два желтых, созданных с помощью ОгаиТгсапя1е() ) и каркасная рамка, представляющая собой видимый объем (6 гаиЧ(еиЧО1иве () ). Затем происходит повторное построение треугольников (зе1есспь) ее сз () ), но уже при активном режиме выбора.