| docs/ | Документация по Vizi |
| readme.html | Этот файл |
| WhatsNew.txt | Что уже сделано |
| ToDo.txt | Что еще нужно сделать |
| meta/ | Файлы необходимые для работы Vizi |
| scripts | Содержит build файл и xsl скрипты |
| vizi-<version>.jar | Билд текущей версии Vizi |
| projects/ | Проекты, входящие в поставку |
| FindMaximum/ | Визуализатор алгоритма нахождения максимума (пример0 |
| vizi/ | Исходные коды Vizi |
| ant.bat | Запускает ANT |
| build.properties | Конфигурация build скрипта в строчке project= укажите путь к свойствам проекта (исходно — к проекту FindMaximum). |
| meta/bin/ | Apache Ant (http://ant.apache.org).
Если Ant находится в другом месте, должна быть установлена переменная окружения ANT_HOME. |
| meta/classes-1.1.8.jar | Java-классы от JDK v.1.1.8 используются для проверки визуализатора на совместимость. |
| build/ | Создается при построении проекта. Содержит автоматически сгенерированные файлы. |
| jars/ | Содержит откомпилированные классы и сконвертированные .property файлы. |
| properties/ | Содержит автоматически создаваемые .property файлы. |
| temp/ | Содержит временные файлы. |
| deploy/ | Содержит автоматически сгенерированные HTML и cmd файлы для проектов на русском и английском языка и jar файлы для Vizi и визуализатора. |
| vizi-<version>.jar | Запакованный Vizi. |
| <имя визуализатора>.jar | Запакованный визуализатор. |
| <имя визуализатора>_*.html | HTML с визуализатором на соответсвующем языке. |
| <имя визуализатора>_*.cmd | Скрипт запуска визуализатора из командной строки. |
Для запуска build-скрипта используется файл ant.bat с параметром, определяющим что требуется сделать. По умолчанию используется цель all.
| all |
Генерирует исходники автомата, файлы сообщения,
компилирует проект, создает .jar и .html файлы. Если в каталоге проекта находится файл classes-1.1.8.jar, то при компиляции осущетсвляется проверка на использование только методов и классов определенных в jdk 1.1.8. |
| clean | Удаляет автоматически созданные каталоги. |
| jars | компилирует проект и создает jar-файлы с визуализатором. |
| htmls | Создает html-файлы для запуска визуализатора. |
| cmds | Создает командные файлы для запуска визуализатора. |
| description | Создает документацию к параметрам визуализатора. |
| check | Создает командный файл для автоматической проверки автомата. |
| api-docs | Компилирует java-doc комеентарии исходный текстов Vizi. |
| vizi | Компилирует Vizi. |
Действия для автоматического обращения заключаются в тэг <action> в место тэга <direct>.
ВСЕ присваивания переменным модели, записываются в виде:
d.<что-то там> @= <выражение>
либо
d.<что-то там>[индекс] @= <выражение>
Например:
d.max @= d.a[d.i];
d.i @= d.i + 1; // Вместо d.i++;
d.a[d.i] @= d.i;
d.a.b[d.z[i][j]] @= d.q[i][j];
Для всех присваиваний такого рода автоматически создается код, обращающий их.
ПРИМЕЧАНИЕ: Присваивания не переменным модели нельзя записывать таким образом!!!
SaveLoadDialog позволяет унифицировать окна сохраниения/восстановления состояния визуализатора. При этом он определяет возможность работы с файлами и буфером обмена и оторажает соотвествующие элементы интерфейса.
Для использования SaveLoadDialog вы создаете класс унаследованный от него и определяющий метод load. Метод load может возвращать логическое значение или бросать исключение. Если метод вернул "true", то SaveLoadDialog закрывается. Если метод бросил исключение, то сообщения этого исключения отображается в строке комментария, что позволяет генерировать сообщение в месте обнаружения ошибки.
Для SaveLoadDialog определены следующие свойства:
| comment | - | комментарий отображаемый в строке комментария. | |
| content | - | текущее содержимое. | |
| initialContent | - | исходной содержимое (используется при нажатии на кнопку "вернуть". | |
При конфигурации доступны следующие параметры:
| SaveLoadDialog | |
| -CommentPane-lines | Высота области комментария в строках |
| -columns | Исходное количество столбцов в области ввода |
| -rows | Исходное количество строк в области ввода |
SmartTokenizer позволяет в удобном виде разбирать данные полученые от SaveLoadDialog. Он позволяет легко читать числа (целые и вещественные) и строчки. При этом, выводятся локализованные сообщения об ошибках. Так же возможна проверка на окончение ввода. При разборе игнорируются комментарии (как /* */ так и //). При заключении строки в кавычки она считывается как одно слово.
SmartTokenizer удобно использовать непосредственно в методе load SaveLoadDialog, так как при этом практически не придется делать обработку ошибок.
В Vizi входит автоматический проверяльщик автоматов на правильность обращения.
Для использования проверяльщика запустивть build-скрипт с параметром check. При этом, в каталоге deploy будет создан файл вида Check<имя визуализатора>.cmd. Этот при запуске получившегося файла указыватся размер (уровень) шага проверки. Проверяльщик прогоняет визуализатор до всех шагов указанного уровня и проверяет правильность обращения.
Для использования проверяльщика в вашу модель данных должны быть включены значения переменных по умолчанию, задающих пример на котором производится проверка.
Если при проверке вы получаете NullPointerException, то скорее всего это означает, что переменная апплета используется не только для рисования, что не правильно.