Pi функции работы с образами (image). См. раздел "Работа с образами" в главе "Необработанное рисование и мультипликация";

Pm функции работы с памятью, которые можно использовать для уменьшения мерцания. См. раздел "Мультипликация" в главе "Необработанное рисование и мультипликация";

Pp функции печати, позволяющие устанавливать режимы и управлять печатью. См. главу "Печать";

Pt функции набора инструментов виджетов для создания, реализации и уничтожения виджетов, получении и установки ресурсов и прочая. Кроме использования виджетов в библиотеке виджетов Photon'а, Вы можете использовать виджеты третьей стороны или свои собственные виджеты;

Px функции расширений, работающие с загружаемыми образами, с файлами конфигурации, и другие полезные подпрограммы. Эти подпрограммы отсутствуют в библиотеке совместного доступа, чтобы их использовать, необходимо линковать приложения с библиотекой phexlib;

Rt функции таймера реального времени. См. раздел "Таймеры" в главе "Работа с кодом";

wc функции работы со строками символов расширенного (16-битного) набора. См. приложение "Поддержка многоязычности Unicode".

Функции и структуры данных этих библиотек описаны в книге "Справочник по библиотеке Photon'а". Функции mbstr, Pd, Pf, Pg, Ph, Pi, Pm, Pp, Pt, Rt и wc находятся в главной библиотеке Photon'а. Функции, используемые для растеризации потока рисования Photon'а, находятся в библиотеке phrender. Библиотеки ph, phrender и Ap доступны в форме общего доступа и в статической.

Вы можете линковать Ваше приложение с библиотеками общего доступа, делая Ваше приложение меньшим по размеру. Для более полной информации, см. раздел "Выбор библиотек" в главе "Генерирование, компилирование и запуск кода".

 Библиотека общего доступа ph не включает ничего, что требует операций с плавающей запятой (кроме виджета PtNumericFloat). Статическая версия это делает.

Функции Al и Px включены в библиотеку расширения phexlib, которая доступна только в статической форме.

! Библиотека photon предназначена только для приложений, созданных под микро-GUI Photon'а версии 1.14. Не комбинируйте эту библиотеку с текущими библиотеками или хеадер-файлами, в противном случае Ваше приложение не будет работать правильно.

Обзор построения приложений под PhAB

Шаг 1. Создание модулей

Для создания приложения пользовательского интерфейса в PhAB, Вы начинаете работу с первичными строительными блоками, называемыми модулями. Модули выглядят и функционируют по большей части так, как Вы видите в большинстве приложений Photon'а. Вы можете проектировать пользовательский интерфейс просто с одним модулем, но в большинстве приложений Вы, вероятно, будете использовать несколько модулей и предназначать каждому свою роль. Как правило, каждый модуль группирует вместе взаимосвязанную информацию и позволяет пользователю особым образом взаимодействовать с этой информацией. Чтобы помочь Вам управлять требованиями виртуальности любого приложения, PhAB предоставляет несколько типов модулей:

• window – обычно используется для главной деятельности приложений. Типичное приложение имеет одно основное окно, которое открывается, когда окно стартует.

• dialog – позволяет приложению обмениваться информацией с пользователем.

• menu – предоставляет пользователю команды.

• icon – определяет иконку для приложения.

• picture – может быть использовано различным образом. Например, Вы можете использовать картинку для обеспечения удобной базы данных виджетов или для изменения содержания существующего модуля.

Для получения более полной информации, см. главу "Работа с модулями".

Шаг 2. Добавление виджетов

После того, как вы создали модуль, Вы готовы разместить на нём виджеты. Для добавления виджета просто щёлкните на желаемой иконке в палитре виджетов PhAB, затем щёлкните там, где Вы хотите его поместить. PhAB даёт Вам возможность добавить любой виджет, пришедший с окружением разработки Photon. Вы можете назначить для виджета:

• отображаемые или редактируемые величины – примерные включённые надписи (examples include labels), текст или многострочный текст;

• наличие выбора – примерные включённые списки (examples include lists), комбинированные управляющие элементы (comboboxes), и группы;

• отображение графики – примерные включённые побитовые карты, образы, линии, прямоугольники, эллипсы и многоугольники;

• отображение областей скроллирования – примерные включённые линейки прокрутки и контейнеры скроллирования;

• инициализирующие действия – примерные включённые кнопки, содержащие текст или образы.

Для задания того, как виджет выглядит и функционирует, Вы устанавливаете его атрибуты или ресурсы. Панели управления и Редакторы ресурсов PhAB'а делают это простым. Просто щёлкните на ресурсе, который Вы желаете изменить, и затем выберите или введите новое значение.

Вы можете определить событие виджету (you can event customize) и затем сохранить его, как шаблон для использования при создании подобных виджетов.

Для более полной информации см. главу "Редактирование ресурсов и ответных реакций в PhAB".

Шаг 3. Прикрепление ответных реакций

Вы создали свои модули и разместили на них виджеты. Теперь Вы готовы определить, как приложение должно работать. Чтобы сделать это, Вы используете ответные реакции.

Каждый виджет Photon'а поддерживает несколько типов ответных связей. Для прикрепления функций, написанных на коде (code functions) к ответной реакции, Вы устанавливаете ресурс или используете предусмотренную удобную функцию. Каждый раз, когда встречается состояние ответной реакции, виджет выполняет функцию на коде.

В PhAB Вы свободны концентрироваться в Ваших ответных реакциях на написание кода, специфического для приложения – Ва не придётся создавать код для "склеивания" интерфейсных компонентов вместе, потому что PhAB обеспечивает уровень ответных реакций, называемый линкованием ответных реакций (link callback). Используя линкование ответных реакций, Вы можете прикрепить ресурс ответной реакции виджета непосредственно к окнам, диалогам, меню и многим другим вещам, кроме кода приложения.

Линкование ответных реакций также позволяет Вам добавить функциональность, которая не была доступна, когда Вы прикрепляли ответные реакции "вручную". Например, если Вы подлинковали диалог к виджету кнопки, Вы можете задать, где появляется диалог. Вы можете также задать установочную функцию, которая будет автоматически вызываться перед реализацией диалога, после его реализации, либо и так и сяк.

Расширенная функциональность, обеспечиваемая подлинковыванием ответных реакций, есть простейший способ конструирования пользовательского интерфейса. Фактически Вы можете создать прототип целого приложения без необходимости написания какого-либо кода. Для получения более полной информации см. главу "Редактирование ресурсов и ответных реакций в PhAB".

Шаг 4. Генерация кода

Вы создали модули своего приложения и создали подлинкованные ответные реакции для склеивания вместе различных компонентов. Теперь Вы готовы сгенерировать и откомпилировать код для запуска Вашего проекта приложения в исполняемом виде.

Чтобы сделать это, Вы открываете диалог "Build+Run" и просто щёлкаете несколько кнопок. Вот так. Этот диалог включает файловый менеджер, так что Вы можете также редактировать исходный код и манипулировать файлами – без необходимости выхода из окружения PhAB.

Для получения более полной информации см. главу "Генерация, компиляция и запуск кода на выполнение".

Шаг 5. Запуск Вашего приложения на выполнение

После того, как Вы сгенерировали, откомпилировали и отлинковали Ваше приложение, Вы можете запустить его на выполнение прямо из диалога "Build+Run". Используя этот же самый диалог, Вы можете даже запустить Ваше приложение под отладчиком для плавной отладки.

Для получения более полной информации см. главу "Генерация, компиляция и запуск кода на выполнение".

Шаг 6. Повторение любого предыдущего шага

После того, как Вы сгенерировали и откомпилировали Ваше приложение, Вы можете изменить интерфейс, прикрепить ответные реакции и перегенерировать код столько раз, сколько нужно.

Написание приложений без PhAB

Мы рекомендуем при разработке Вашего приложения использовать PhAB. Однако, если Вы не планируете использовать PhAB, Вам стоит прочесть полностью это руководство (особенно главу "Программирование Photon'а без PhAB"), чтобы познакомиться со всеми фундаментальными основами Photon'а перед тем, как начать создание приложения. Затем стоит просмотреть "Справочник виджетов".

Глава 1. Уроки

Лучшим способом получить знания о PhAB – это использовать его. Эта глава представляет из себя практические уроки, позволяющие Вам быстро начать создавать приложения:

• Перед тем как Вам начать...

• Привет, мир

• Редактирование ресурсов

• Создание меню и столбцов меню

• Создание диалогов

• Создание окон

Более внимательно вопросы использования PhAB мы рассмотрим в последующих главах.

Первые два урока охватывают основное: создание виджетов, изменение вида и поведение виджетов, генерирование кода, запуск Вашего приложения на исполнение и прочая.

Остальные уроки идут дальше базовых, показывая Вам, как создавать работающие меню, диалоги и окна. Когда Вы завершите изучение этих уроков, вы будете готовы начать проектирование почти любого приложения Photon'a.

Перед тем как Вам начать...

Вы можете запустить PhAB из меню "Launch" в левом нижнем углу экрана; выбрать подменю "Development" и затем выбрать "Builder". Вы можете также запустить его из окна консоли pterm, набрав: appBuilder. Для получения информации об опциях командной строки см. тему "appBuilder" в "Справочнике утилит QNX".

Перед тем как начать уроки, ознакомьтесь с интерфейсом пользователя PhAB:

Рис. 1-1. Общий вид пользовательского интерфейса

Столбец меню Импорт графики создание окон и диалогов, генерирование С и/или С++ кода для обеспечения всего Вашего пользовательского интерфейса в целом, и пр.

Столбцы инструментов Экономьте время – используйте столбцы инструментов: парой щелчков мышью Вы можете копировать, перемещать, выравнивать, группировать или изменять размеры любого числа виджетов.

Рабочая область: предоставляет Вам плоскую область, где Вы можете работать одновременно с несколькими модулями приложения.

Палитра виджетов: позволяет легко добавлять виджеты в Ваше приложение. Просто щёлкните на нужном Вам виджете, а затем щёлкните там, где Вы хотите его разместить.

Панели управления: позволяют Вам полностью настраивать виджеты Вашего приложения. Вы можете выбрать текстовые шрифты, модифицировать цвета, подстраивать побитовые отображения и прикреплять ответные реакции, которые будут раскрывать диалоги или активизировать приготовленный Вами С и/или С++ код.

Палитра виджетов и панели управления инициируются в одном окне, но Вы можете оттащить любое из них в отдельное окно. Для переключения между панелями в окне щёлкните на ярлыке вверху и выберите панель из меню.

Если Вы выбрали панель управления, Вы можете переотобразить её, выбрав соответствующий пункт из меню "View".

Урок 1 – Привет, мир

На этом уроке мы научимся, как использовать PhAB для создания и компиляции простого приложения.

Создание приложения

1. Выберите в меню "File" пункт "New" для создания нового приложения. PhAB отобразит диалог, позволяющий Вам выбрать стиль принимаемого по умолчанию базового окна нового приложения:

2. Выберите стиль и щёлкните "Continue"; PhAB создаст базовое окно и отобразит его.

1. Как только Вы создали новое приложение, хорошей идеей будет сохранить его и присвоить имя. Выберите пункт "Save As" в меню "File", чтобы открыть диалог "Application Selector". Щёлкните на область "Application Name", наберите tut1, затем нажмите клавишу <Enter> либо щёлкните на "Save Application".

2. Взгляните на брусок заголовка PhAB'а. На нём теперь указывается, что имя текущего приложения – tut1.

3. Если палитра виджета не отображается, щёлкните на ярлычке вверху текущей панели управления и выберите из появившегося меню "Widgets".

4. Оторвите палитру виджетов от других панелей управления, нажав кнопку мыши на ярлыке и, удерживая кнопку нажатой, перемещайте палитру на рабочую область PhAB'a.

5. Если хотите, измените размеры палитры виджетов и панелей управления.

6. Перейдите к палитре виджетов и щёлкните на иконке виджета PtLabel:

1. Переместите указатель мыши на базовое окно приложения (указатель превратится в крестик) и щёлкните в любом месте где-нибудь возле центра окна.

PhAB автоматически выполнит следующее:

• создаст новый виджет PtLabel

• выделит виджет, так что Вы сможете редактировать его ресурсы

• разместит метки-манипуляторы для изменения размеров вокруг виджета

• отобразит ресурсы виджета на контрольных панелях Resources (ресурсы) и Callbacks (ответные реакции).

1. Перейдите к панели управления Resources и подведите текст "Label1" возле ресурса "Label Text".

2. Измените текст на "Hello World". Как только Вы это наберёте, текст на виджете изменится:

Генерирование кода

Теперь Вы готовы генерировать, компилировать и выполнять приложение.

1. Из меню "Application " выберите пункт "Build+Run". PhAB автоматически сохранит Ваше приложение и затем отобразит диалог "Build+Run".

2. Щёлкните на кнопке "Generate". Вы увидите диалог для выбора платформы – комбинацию операционной системы, компьютера и компилятора, которую Вы будете пользовать. Выберите соответствующую. Например, если Вы используете ОC QNX, машину Intel x86 и компилятор gcc, выберите ntox86 и gcc.

3. Щёлкните на кнопке "Generate" для запуска процесса генерации кода. Вы увидите диалог хода работы: