Возможные проблемы и их устранение

• Программа не работает
  1. Если программа запускается, но во время загрузки внизу появляются цифры (например -5-), то скорее всего у вас в телефоне остались данные от предыдущей версии. Исправляется обычно удалением и повторной установкой программы.
  2. Если предыдущий способ не сработал, или программа вообще не запускается, пишите об этом на почту сайта (projectd8@yandex.ru). В письме укажите модель телефона, на котором программа не работает, и код ошибки (число внизу загрузочного экрана, если есть).
• Программа работает очень медленно
  1. Попробуйте отключить визуальные эффекты в настройках. При этом отключается фоновая анимация и обводка текста в главном меню и всех списках, окно увеличения в рабочей области и интерактивный режим подбора цвета. Если доступ к настройкам получить не удается, отключить эффекты можно удержанием # во время загрузки программы.
  2. Повысить быстродействие в рабочей области можно, уменьшив размеры редактируемого изображения (качество при этом не теряется). Также, можно воспользоваться проводником объектов для создания изображений в режиме конструктора, если визуальный режим неудобен из-за низкой производительности.
• Не работает откытие / сохранение изображений
1. В вашем телефоне отсутствует стандартный доступ к файловой системе (профиль JSR-75), поэтому программа работать будет, но открыть или сохранить что-либо будет невозможно. Можете попробовать адаптировать программу через онлайн-адаптер (разработчик никаких гарантий в этом случае дать не может).
• Не работает определенный элемент интерфейса
  1. Поскольку программа все еще находится в разработке, некоторые элементы интерфейса могут присутствовать, но не выполнять никаких действий (список реализованных функций). В следующих версиях программы эти элементы могут быть задействованы (или удалены).

Основные клавиши управления

В рабочей области назначение клавиш может изменяться. В таблице приведено назначение цифровых клавиш в обычном режиме и режиме редактирования. Назначение клавиш джойстика "Вверх", "Вниз", "Влево", "Вправо" и "Огонь" совпадает с назначением соответствующих им цифровых клавиш 2, 8, 4, 6 и 5.

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

Использование сочетания # + цифровая клавиша соответствует вызову экранной команды с соответствующим номером. Команда на левом софте всегда имеет номер 0. Команды на правом софте имеют номера начиная с 1, при этом если на экране более двух команд, то нумерация соответствует положению команды в софт-меню, если ровно две, то команда на правом софте сама имеет номер 1. Как уже отмечалось выше, сочетания для несуществующих команд отрабатываются, но не имеют эффекта.

Еще одно сочетание - #* - зарезервировано для вызова монитора памяти.

Свойства изображения

• Название и описание - текстовая информация об изображении. Эти поля соответствуют элементам <title> и <desc> документа SVG.
• Исходная ширина и высота. Исходные размеры изображения используются при переключении масштаба в рабочей области, а также при расчете координат при экспорте в SVG. Соответствуют аттрибуту viewBox в SVG.
• Горизонтальное и вертикальное смещение - смещение координат групп в изображении с учетом масштаба. Например, при масштабе 1 и смещении 0 левый верхний угол группы с координатами (0, 0) совпадает с верхним левым углом изображения, при смещении 0.5 и том же масштабе - с центром изображения, при смещении 0.5 и масштабе 2 - с центром верхней левой четверти изображения. Положительные значения соответствуют сдвигу вправо и вниз, отрицательные - влево и вверх. Соответствуют преобразованию translate в SVG.
• Горизонтальный и верткальный масштаб можно представить как размер изображения в собственной системе координат. Например, при масштабе 1 X при движении от левого края иображения до правого принимает значения от 0 до 1, при масштабе 2 - от 0 до 2, и т.д. Таким образом, действие обратно преобразованию scale в SVG.
• Цвет фона - цвет, которым закрашивается область под изображением перед отрисовкой элементов. Задается в формате ARGB, но фактически альфа-канал не используется и может быть любым.
• Использовать цвет - рисовать ли элементы заданными для них цветами или текущим цветом. В рабочей области текущим является цвет, обратный к цвету ее фона.
• Непрозрачный фон - закрашивать ли область под изображнием его фоновым цветом.
• Частота кадров - скорость воспроизведения анимации.
• Конечный кадр - номер кадра, по достижении которого анимация повторяется или останавливается. Общее число кадров на 1 больше номера конечного кадра.
• Число повторов - сколько раз повторять анимацию при воспроизведении. Отрицательные значения соответствуют бесконечному числу повторов.

Опции рисования

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

• Первичный цвет, которым рисуется большинство элементов, а также начальный цвет в градиентах.
• Вторичный цвет - конечный цвет в градиентах.
• Флаги - внешний вид элемента (пунктирный, закрашенный).
• Имя файла с растровым иображением для элементов, в которых оно может использоваться (например, имя текстуры в текстурных элементах).
• Число вершин многоугольников.
• Качество математических кривых и кривых Безье.
• Точный цвет под курсором - цвет точки непосредственно под курсором.
• Средний цвет под курсором - усредненный цвет точки под курсором и восьми соседних с ней точек.
• X и Y курсора в интервале от 0 до 1 относительно текущих размеров изображения.

Основы визуального редактирования

Визуальное редактирование включается при создании нового элемента из меню "Инструменты" или при выделении / редактировании элемента в проводнике объектов. Режим редактирования отмечается именем текущего элемента в верхнем левом углу рабочей области и кодом текущего параметра (если выбран). Меняется и назначение клавиш 1, 3, 7 и 9, как описано выше.

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

Клавиша 5 тоже служит для перехода к следующему параметру, но она, в отличие от клавиши 3, после достижения последнего параметра позволяет сразу перейти к созданию следующего элемента (при создании элементов из меню "Инструменты") или выйти из режима редактирования (при выделении / редактировании элементов в проводнике объектов). Также, для элементов с потенциально неограниченным числом параметров (таких как полилинии и кривые Безье) клавиша 5 может добавить следующий (новый) параметр.

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

Редактирование полилиний и кривых Безье

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

Параметры элементов и их коды

Подбор цвета

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

Изменение цвета осуществляется с помощью цифровой клавиатуры.

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

Импорт дискретной анимации

Анимацию можно создавать на основе существующих растровых изображений. Для этого в главном меню нужно выбрать команду "Открыть", затем в проводнике файлов установить курсор на папку с исходными файлами и снова выбрать команду "Открыть". При этом каждое растровое изображение из этой папки будет помещено в отдельный кадр векторного изображения. Изображения считываются в алфавитном порядке.

Разрешение всей анимации изначально определяется как разрешение наибольшего исходного изображения, но в дальнейшем может быть изменено. При включенной опции "Автомасштаб при импорте" изображения при добавлении сразу масштабируются к этому разрешению, и в результате процесс может занять некоторое время. Также следует учитывать, что исходное изображение считается при анализе разрешения большим, только если оно имеет большую ширину и большую высоту одновременно. Иными словами, если текущий размер анимации 320x240 и следующий добавляемый кадр имеет разрешение 640x480, то размер всей анимации устанавливается в 640x480, но кадр размером 240x320 не приведет к установке размера анимации 320x320.

Параметры экспорта GIF

• Динамическая палитра
  • При включенной опции для каждого кадра анимации создается индивидуальная палитра. При этом изображение будет более высокого качества, но могут возникнуть проблемы при сохранении изображений большого размера с большим количеством цветов.
  • При выключенной опции для всех кадров анимации используется общая унифицированная палитра. Это может быть полезно в случае некорректной работы алгоритма квантизации (при возникновении искажений на изображении).
• Распределение ошибки
  • При включенной опции к изображению применяется алгоритм Флойда-Штейнберга для распределения ошибок квантизации. При этом увеличивается количество воспринимаемых цветов, но на изображении может появиться "зернистость", возможно искажение мелких деталей.
  • При выключенной опции распределение ошибок не применяется. При этом на изображении могут наблюдаться резкие переходы между цветами и большие однотонные области, возможна потеря мелких деталей.

Экспорт анимации

В программе поддерживается создание анимированных GIF файлов, но возможен экспорт анимации и в другие форматы.

При экспорте в PNG возможен экспорт всей анимации в виде нумерованого набора файлов (0.png, 1.png, 2.png и т.д.). Для этого при вводе имени файла нужно стереть расширение png (вместе с точкой) и вместо него дописать слеш, то есть переделать имя файла в имя папки. Тогда в указанную папку будет экспортирована вся анимация, где каждый кадр будет сохранен в файле с именем, равным его номеру, то есть первый кадр получит имя 0.png, второй - 1.png и т.д. В дальнейшем полученный набор кадров можно использовать для сборки GIF анимации сторонними программами.

При экспорте в SVG анимация записывается в файл в виде дискретного набора кадров.