Git Product home page Git Product logo

azul's Introduction

Icon azul

azul is a CityGML viewer for macOS 10.12, although it also works with minor issues on 10.11. It supports loading multiple files, selecting objects by clicking them or selecting them in the sidebar, and browsing their attributes. It is currently pre-release software, but it is pretty stable and most CityGML datasets already work without problems. It is available under the GPLv3 licence.

Controls

  • Pan: scroll

  • Rotate: drag on left click, rotate on trackpad

  • Zoom: pinch on trackpad, drag on right click

  • Select: click on object (in view or sidebar)

  • Centre view: double click (in view or sidebar object), h or cmd+shift+h (to dataset centre)

  • New file (clear view): n or cmd+n

  • Open file: o or cmd+o

  • Show bounding box: b or cmd+shift+b

  • Show edges: e or cmd+shift+e

  • Toggle Metal/OpenGL rendering: g or cmd+opt+ctrl+g

Download

You can download the latest stable release of azul in the releases page or from the App Store. If you want more information on how to compile it from source, see below.

Random3DCity

CityGML 2.0 sample dataset

Ettenheim

Lyon

New York City

Technical details

azul is written mostly in Swift 3 and C++11 with a bit of Objective-C and Objective-C++ to bind them together. It uses Metal (when available) or OpenGL (otherwise) for visualisation and simd (with Metal) or GLKit (with OpenGL) for matrix computations. It uses pugixml in order to parse XML since it is much faster than Apple's XMLParser, as well as the CGAL Triangulation package to triangulate concave polygons for display.

Not implemented / ideas for the future

  • Textures: not shown
  • Implicit representations: coordinate transformations are not applied
  • Support for very big datasets (over around 2 GB): app crashes if any single Metal buffer is > 1 GB
  • Shifting the rotation point out of the data plane
  • Showing the data plane and rotation point
  • Animations when re-centering
  • Keyboard navigation
  • Sorting and grouping objects in sidebar
  • Multi-threaded file loading and ray shooting
  • Customising colours
  • QuickLook plug-in
  • Icon previews
  • iOS support

Compilation

We have included an Xcode 8 project to easily compile azul. Note that older versions of Xcode cannot compile Swift 3.

azul depends on the following libraries: Boost, CGAL, GMP, MPFR and pugixml. These can be easily obtained using Homebrew. However, we also provide bundled versions of the first four for convenience, and pugixml works well as a static library. The provided libraries assume that they will be put into the Frameworks folder in the azul app bundle (i.e. their install names and cross dependencies are set to @rpath/xxx.dylib), but they are otherwise identical to those that can be obtained from Homebrew.

Licence

In order to comply with the CGAL Triangulation package license, azul is available under the GPLv3 licence.

azul's People

Contributors

kenohori avatar

Watchers

 avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.