RU:OSM2World

The 3D Development team are currently working on unifying 3D related tags.
For first results see Simple 3D Buildings.

OSM2World

Автор:

Tobias Knerr and other contributors

Лицензия:

GNU LGPL (бесплатно)

Платформ:

Windows, Linux, и macOS

Версия:

0.1.9 (2012-01-11)

Язык:

английский

Веб-сайт:

http://osm2world.org

Исходный код:

https://code.launchpad.net/osm2world

Язык
программирования:

Java

Creates a 3D model of the world from OSM data.

Features

Feature	Value
Map Display (Not set)
Routing (Not set)
Navigating (Not set)
Tracking (Not set)
Monitoring (Not set)
Editing (Not set)
Rendering (Not set)
Accessibility (Not set)

OSM2World (osm2world.org) это конвертер, который создает трехмерную модель мира на основе данных OpenStreetMap. Модель может быть экспортирована в различные форматы.

Форматы экспорта

В данный момент поддерживается файлы Wavefront .obj, файлы .pov для POVRay raytracer, прямой вывод через JOGL (OpenGL bindings for Java) и изображения .png, генерируемые с использованием JOGL. Дополнительные форматы могут быть добавлены при необходимости.

Как использовать OSM2World

Close-up rendering example

Инсталляция

Для OSM2World требуется Java Runtime Environment 1.6 и выше. Если вы пользуетесь JOSM, то она вероятно у вас уже есть.

Если Java установлена, зайдите на osm2world.org/download и скачайте zip архив скомпилированной программы. Распакуйте его куда-нибудь на вашем компьютере.

Графический интерфейс

OSM2World GUI with a terrain debugging view

Запустите OSM2World из командной строки, используя командный файл/скрипт, подходящий вашей системе. Это позволит вам открывать файлы OSM и просматривать модели:

левая кнопка мыши перемещает позицию камеры
правая кнопка мыши вращает камеру
колесико мыши приближает и удаляет камеру

Навигация с клавиатуры доступна как альтернатива. Различные отладочные слои можно отобразить и экспортировать в .png, .pov и .obj при возможности. Учтите, что в этот момент ухудшится качество визуализации и производительность, поскольку процесс отладки имеет более высокий приоритет.

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

Это краткая документация о командной строке OSM2World. Важно понимать, что синтаксис командной строки пока непостоянен, и вероятно изменится в будущем.

Ввод и вывод

Результат примера экспорта в PNG

-i/--input <file> входной файл .osm, .osm.gz, .osm.bz2 или .osm.pbf
-o/--output <file> ... один и более выходных файлов. Расширение имени файла определяет формат файла. Возможны файлы .obj, .pov и .png.
--resolution <horiz_res>,<vert_res> размер в пикселях для зависимых от разрешения выводов (.png)

gt;

Камера

Определение камеры и позиции для просмотра опционально (но рекомендуется) для .pov файлов и необходимо для вывода в .png. Вы можете использовать ортогональную или перспективную проекцию. От выбора проекции зависит набор доступных параметров камеры.

Ортогональная проекция:

--oview.angle <angle_deg> угол ортогональной проекции в градусах; по умолчанию 30. Работает в пределах > 0° и < 90°.
--oview.from <N/E/S/W> фундаментальное направление, от которого будет строиться просмотр в ортогональной проекции; по умолчанию принимается Юг (S).
есть два способа задания границ (для уровня elevation=0) отображаемой сцены:
- --oview.bbox <lat>,<lon> <lat>,<lon> ... список координат; будут использованы ближайшие границы, охватывающие данные координаты
- --oview.tiles <zoom>,<tileX>,<tileY> ... один и более тайлов (определяется уровнем зума и координатами x/y); будут использованы ближайшие границы, содержащие все эти тайлы

Перспективная проекция:

--pview.pos <lat>,<lon>,<ele> позиция камеры для перспективной проекции
--pview.lookAt <lat>,<lon>,<ele> look-at для перспективной проекции
--pview.aspect <value> соотношение сторон (ширина / высота) для перспективной проекции; по умолчанию, соотношение сторон текущего разрешения
--pview.fovy <angle_deg> vertical field угла просмотра для перспективной проекции, в градусах; по умолчанию 45.

Логи

--performancePrint печатает в командную строку время выполнения каждой фазы конвертации
--performanceTable <file> добавляет время выполнения в файл после конвертации, в текстовой таблицы

Прочие параметры

Пример альтернативной цветовой схемы с использованием параметра --config

--config <file> файл properties с дополнительными параметрами (смотрите /Configuration file). Может использоваться как в графическом режиме, так и в командной строке.
--gui запускает графический интерфейс
--help печатает краткое описание доступных параметров командной строки
--version печатает текущую версию OSM2World

Если вы используете --gui, --help или --version, OSM2World не станет выполнять конвертацию, а исполнит указанную команду.

Файлы параметров

--parameterFile <file> файл, содержащий по одному набору параметров на каждую строку.

Если вы желаете выполнить несколько обработок, вы можете записать их параметры (без указания имени программы) в файл и передать его в качестве аргумента в OSM2World. Строки начинающиеся с # игнорируются.

По возможности, желательно сгруппировать эти обработки - например, чтобы они содержали одинаковые параметры --input и --config. Так вы можете, скажем, быстро отрендерить одни и те же данные с разных ракурсов.

Примеры

 ./osm2world -i example.osm -o image.png --pview.pos +50.2607,+10.965,+110.0 --pview.lookAt 50.2623367,10.9640632,0

Пишет OpenGL рендеринг 3D модели, сгенерированной из example.osm в image.png. Рендеринг использует перспективную проекцию с заданными координатами позиции и look at камеры.

 ./osm2world -i example.osm -o tileexample.pov

Создает 3D модель из example.osm и экспортирует ее в POVRay файл example.pov. Файл POVRay не будет содержать настройки камеры, так что вам предстоит установить их вручную перед открытием example.pov в POVRay.

 ./osm2world -i example.osm -o tileexample.pov --oview.tiles 12,2186,1312 12,2186,1313

Создает 3D модель из example.osm и экспортирует ее в POVRay файл example.pov. Файл POVRay не будет содержать нужные настройки камеры для ортогональной проекции. Для отображения выбрана минимально возможная область, который включает в себя два тайла 2186,1312 и 2186,1313 (на 12 зуме). камера смотрит на эту область с Юга. Параметр --oview.angle не задан, так что по умолчанию взято 30 градусов. Этот угол в частности интересен тем, что под ним два "обычных" квадратных тайла вписываются в один квадратный ортогональный тайл (а всё потому, что sin(30°)=0.5).

Интерфейс библиотеки

Вы можете использовать OSM2World в качестве библиотеки Java. The preferred way to do this is by using the ConversionFacade class that wraps the whole conversion into a single method call. It lets you provide input data and set output targets. You can also choose which kinds of world objects you want to be created and provide fine-tuning parameters - or you can just stick to the defaults, of course. Have a look at the javadoc.

Если вам нужна большая функциональность, непонятен код и т.д., просто скажите!

Планы и ограничения

Данные о высотах

Функция в вычисления высот в OSM2World пока еще хрупкая и деактивирована по умолчанию, но присутствует как экспериментальная опция. Вычисления опираются на атрибуты объектов (таких как incline=*, layer=*, tunnel=* и bridge=*) и абсолютная высота (ele=*, как собственно из OSM, так и с других источников: SRTM или OpenDEM).

Возможные проблемы

Рекомендуется загружать только маленькие карты, особенно в графическом интерфейсе. В OSM2World есть пара мест, где используются очень неэффективные заполнители алгоритма.
Если для OSM2World не хватает RAM, вы можете поправить стартовые скрипты, увеличив параметр -Xmx
Если у вас есть еще вопросы, воспользуйтесь страницей обсуждения, или примите участие в соответствующих дискуссиях в форумах и списках рассылки. Вы также можете связаться с User:Tordanik напрямую.