﻿     Введение
     
     Приложение OsmAndTools предназначено:
     
     1. для конвертирования данных из текстового формата Loadstone в формат  Избранное» OsmAnd Access (файл favourites.gpx);
     
     2. для работы с коллекциями точек, извлечённых из одного или нескольких текстовых файлов формата Loadstone или файлов избранного для OsmAnd (слияние, редактирование, выборка по условию) с последующим сохранением данных в файл «Избранное» OsmAnd Access (файл favourites.gpx).
     
     Инструмент не имеет ограничения на количество конвертируемых точек, но мы не рекомендуем использовать большие базы точек. В нашем представлении, Избранное, это не очень большое количество точек, которые вам необходимы для быстрого обнаружения при повседневном использовании навигации. Если вы создадите базу избранного, состоящую из нескольких десятков тысяч точек, процесс загрузки файла в OsmAnd, будет длиться несколько часов.
     
     Требования к установке
     
     Программа ориентирована на платформы Windows XP (сервиспак 3) x86, Windows Vista x86, Windows 7 x86. На платформах Windows x64 данная программа будет работать при наличии в операционной системе поддержки 32-битных приложений. Для работы программы необходим Microsoft framework dotNET 4.0.
     
     dotNET 4.0 – это бесплатный набор библиотек от компании Microsoft. Он необходим многим программам, и вполне возможно, уже установлен на вашем компьютере. Если фреймвёрк не установлен, то при запуске программа сообщит об этом. Скачать фреймвёрк можно с официального сайта Микрософт
     http://www.microsoft.com/ru-ru/download/details.aspx?id=17718
     или, например, отсюда:
     http://yadi.sk/d/PFS6dyNhJpi64
     
     1. Знакомство с интерфейсом программы
     
     В верхней части экрана расположена строка меню, обеспечивающая доступ ко всем функциональным возможностям приложения. Рабочая область окна содержит кнопку "Выбрать все" и таблицу из пяти колонок.
     
     Концепция программы предусматривает работу с двумя таблицами, которые поочерёдно выводятся на экран. Первая таблица ("Добавленные точки") предназначена для размещения данных, добавленных пользователем из одного или нескольких файлов. Вторая таблица, "Отобранные точки",  -  для размещения данных, отобранных пользователем вручную из первой таблицы. Переход от таблицы к таблице производится через меню или посредством горячих клавиш "F7" и "F8".
     
     Кнопка "Выбрать все" позволяет отметить все строки в таблице.
     
     Таблицы "Добавленные точки" и "Отобранные точки"
     
     Эти две таблицы имеют одинаковую структуру и содержат 5 колонок:
     1) Отметить;
     2) Имя;
     3 Категория;
     4 Широта;
     5 Долгота.
     
     Первая колонка, "Отметить", содержит ячейки с флажками. При нажатии клавиши "Пробел" изменяется состояние флажка. Флажок имеет два состояния: "Отмечено" (true) и "Не отмечено" (false).
     
     Вторая колонка, "Имя", содержит ячейки с информацией о названии точки. Для перехода в режим редактирования нажмите клавишу "Пробел" или клавишу "F2". Нажатие любой буквенно-цифровой клавиши также переводит ячейку в режим редактирования, но при этом вся содержащаяся в ячейке информация замещается введенным символом.
     
     Нажатие клавиши "ESC" приводит к отмене внесённых в ячейку изменений и выходу из режима редактирования.
     
     Клавиша "Enter" сохраняет изменения, внесенные в текущую ячейку, и передает фокус ячейке, расположенной непосредственно под текущей ячейкой. Если фокус находится в последней строке, изменения сохраняются без передачи Фокуса.
     
     Комбинация клавиш CTRL + Enter производит сохранение изменений, внесенных в текущую ячейку, без передачи фокуса.
     
     Эта ячейка не может быть пустой.
     
     Третья колонка, "Категория", содержит элемент ComboBox (выпадающий список).
     Нажатие клавиши "Пробел" или "F4" переводит ячейку в режим редактирования и отображает раскрывающийся список имеющихся категорий.
     Для перемещения по списку используйте вертикальные стрелки.
     
     Четвертая и пятая колонки - "Широта" и "Долгота" -  находятся в режиме "только чтение" и редактированию не подлежат.
     
     Меню приложения
     
     Для того чтобы получить доступ к строке меню при помощи клавиатуры, следует нажать клавишу ALT. При этом выделяется первый пункт строки меню.
     
     Строка меню содержит следующие пункты:
     - файл;
     - конвертеры;
     - операции;
     - сервис.
     
     Пункт строки меню "Файл"
     
     Открыть
     
     При активации этого пункта меню открывается стандартное диалоговое окно открытия файла. Приложение работает с базами точек в формате Loadstone и с файлами избранного OsmAnd (favourites.gpx).
     
     Если путь к файлу указан верно и файл имеет правильный формат, то из него будут извлечены данные для последующей обработки.
     
     При успешном открытии файла некоторые его строки могут не войти в извлечённый результат из-за несоответствия формату. Информацию об этих строках можно найти в файле "error.log".
     
     Наличие пустых и ошибочных  строк в файле не отменяет его открытия, но эти строки исключаются из результата.
     
     При открытии текстового файла в формате Loadstone, как правило, количество добавленных строк на 3 меньше количества обработанных строк. Эти три строки -  служебные заголовки в начале файла.
     
     При открытии файла избранного OsmAnd (favourites.gpx) отсутствующие категории в словарь категорий добавляются автоматически.
     
     Добавить из файла
     
     Активация этого пункта меню позволяет добавить к уже открытым в приложении данным информацию из другого файла.
     
     Процесс открытия файла протекает аналогично предыдущему пункту. Однако, таблица перед открытием не очищается, а к имеющимся в ней данным добавляются данные из открываемого файла. Второй экземпляр полностью совпадающих строк автоматически удаляется. Строки сортируются в алфавитном порядке по имени точки.
     
     Сохранить
     
     Открытую в приложении коллекцию точек, а также результаты выборок (отобранные точки), можно сохранить для дальнейшего использования. Если в приложении хранится такая коллекция или коллекция отобранных точек, то при следующем запуске они будут открыты (файлы points.xml и results.xml).
     
     Выход
     
     При активации этого пункта меню происходит выход из программы.
     
     Пункт строки меню "Конвертеры"
     
     Все подпункты  этого пункта строки меню производят прямую (без открытия для редактирования) конвертацию файлов из формата Loadstone в формат избранного для OsmAnd (favourites.gpx). Готовый файл будет располагаться по пути:
     OsmAndTools\output\
     В папке OsmAndTools\ Вы можете обнаружить файл error.log, который содержит информацию о строках исходного файла, имеющих неправильный формат.
     
     Извлечь всё
     
     При активации этого пункта меню открывается стандартное диалоговое окно открытия файла. Если путь к файлу указан верно и файл имеет формат точек Loadstone, из него будут извлечены все доступные точки, которые будут распределены в две категории: Перекрестки, и POI.
     
     Пункты меню "Извлечь перекрестки" и "Извлечь POI"
     
     Действие этих пунктов меню аналогично действию предыдущего пункта
     и отличается лишь тем, что из исходного файла извлекаются не все точки, а только точки, принадлежащие к заявленной категории.
     
     Следует помнить, что в исходном файле в качестве разделителя между названиями улиц, которые составляют перекресток, должен использоваться знак "@" (Собачка).
     
     Пункт строки меню "Операции"
     
     Отбор по категориям
     
     Активация этого пункта меню позволяет отобрать (отфильтровать) из коллекции точек точки, принадлежащие к одной или нескольким категориям, для дальнейшей обработки (редактирования, удаления, копирования или перемещения в "Отобранные" и др.).
     
     Поиск
     
     Активация этого пункта меню позволяет производить поиск по названиям точек. Обратите внимание, будет найдено только точное соответствие заданной поисковой строке.
     
     Снять фильтр
     
     В результате операций поиска и отбора по категориям в таблице остаются  строки, удовлетворяющие заданным критериям. Остальные строки временно скрываются. Активация данного пункта меню снимает все фильтры, наложенные на таблицу, т.е. все скрытые строки становятся видимыми.
     
     Отмеченные точки
     
     Этот пункт меню имеет вложенные подпункты, обеспечивающие доступ к операциям, которые можно произвести с отмеченными точками:
     Сохранить в избранное для OsmAnd
     Изменить категорию
     Скопировать в отобранные
     Переместить в отобранные
     Удалить
     
     Сохранить в избранное для OsmAnd
     
     Если в таблице имеются отмеченные точки, то при активации этого пункта меню все они будут сохранены в файл избранного для OsmAnd (favourites.gpx). Эта операция возможна для обеих таблиц приложения.
     
     Изменить категорию
     
     Активировав этот пункт меню, Вы можете изменить категорию отмеченных точек на любую другую из Вашего словаря категорий.
     
     Скопировать в отобранные
     
     При активации этого пункта меню запускается операция копирования строк из таблицы "Добавленные точки" в таблицу "Отобранные точки".
     
     Переместить в отобранные
     При активации этого пункта меню запускается операция перемещения строк из таблицы "Добавленные точки" в таблицу "Отобранные точки".
     
     Удалить
     
     Активация этого пункта меню приводит к удалению отмеченных строк из текущей таблицы.
     
     Добавленные точки
     
     При активации данного пункта меню в рабочей области окна приложения выводится таблица "Добавленные точки".
     
     Отобранные точки
     
     При активации данного пункта меню в рабочей области окна приложения выводится таблица "Отобранные точки".
     
     Очистить таблицу
     
     Активация этого пункта меню приводит к
     удалению всех данных из текущей таблицы.
     
     Пункт строки меню "Сервис"
     
     Редактор категорий
     
     Активация данного пункта меню позволяет внести изменения в справочник категорий.
     
     Следует помнить, что удаление категорий или изменение их порядка во время редактирования данных может привести к неожиданному результату. Операции со словарём пользовательских категорий лучше производить заранее.
     
     Программа изначально имеет две категории (POI и перекрёстки), которые изменить нельзя. Пользователь может добавить дополнительные категории и производить с ними все необходимые действия (редактирование, удаление, сортировка).
     
     При активации данного пункта меню открывается окно, содержащее таблицу пользовательских категорий, текстовое поле "Имя" и три кнопки - "Добавить", "Сохранить" и "Отменить". Таблица пользовательских категорий состоит из одной колонки - "Название категории".
     
     Для удаления категории из таблицы нажмите комбинацию клавиш Shift + Пробел и клавишу Del.
     
     Для того, чтобы добавить новую категорию, напишите её название в текстовом поле "Имя" и нажмите кнопку "Добавить". Новая категория появится в последней строки таблицы.
     
     Для сохранения всех внесённых изменений нажмите кнопку "Сохранить".
     
     При нажатии на кнопку "Закрыть" приложение выходит в основное окно. Если не была нажата кнопка "Сохранить, внесённые данные будут потеряны.
     
     Работа с таблицами приложения
     
     Для навигации по таблице используйте вертикальные и горизонтальные стрелки.
     
     Для перехода в режим редактирования нажмите клавишу "Пробел" или клавишу "F2". Нажатие любой буквенно-цифровой клавиши также переводит ячейку в режим редактирования, но при этом вся содержащаяся в ячейке информация замещается введенным символом.
     
     Нажатие клавиши "ESC" приводит к отмене внесённых в ячейку изменений и выходу из режима редактирования.
     
     Клавиша "Enter" сохраняет изменения, внесенные в текущую ячейку, и передает фокус ячейке, расположенной непосредственно под текущей ячейкой. Если фокус находится в последней строке, изменения сохраняются без передачи Фокуса.
     
     Комбинация клавиш CTRL + Enter производит сохранение изменений, внесенных в текущую ячейку, без передачи фокуса.
     
     Для удаления строки из таблицы нажмите комбинацию клавиш Shift + Пробел (выделяет текущую строку) и клавишу Del.
     
     Горячие клавиши
     
     F5 - Копировать отмеченные строки в отобранные
     F6 - переместить отмеченные строки в отобранные
     F7 - перейти в таблицу "Добавленные точки".
     F8 - перейти в таблицу "Отобранные точки".
     F9 - снять фильтр
     ALT + F4 - Выход
     CTRL + SHIFT + C - отбор по категориям
     CTRL + F - поиск
     CTRL + I - сохранить в избранное для OsmAnd
     CTRL + O -  открыть файл
     CTRL + SHIFT + O - Добавить из файла
     CTRL +S - Сохранить
     SHIFT + DEL - удалить отмеченные строки
