@ud-viz/widget_legonizer

widget layer choice of the itowns framework


Keywords
itowns, javascript, nodejs, threejs, webgl-game, webgl2
License
LGPL-2.1
Install
npm install @ud-viz/widget_legonizer@4.3.0

Documentation

UD-Viz : Urban Data Vizualisation

CodeQL CI status Documentation Status

UD-Viz is a javascript mono repository for creating web applications for visualizing and interacting with geospatial 3D urban data.

Online documentation β€” Developers β€” License β€” Getting Started β€” Architecture

Online demos:

UD-VizExamples Mosaic IMUV Flying Campus Mosaic Deambulation Bron Mosaic

UI Data Driven Mosaic Multimedia Viz Mosaic Multimedia Viz Mosaic

3D tiles related

Py3dTilers Mosaic Point Clouds Mosaic

Directory Hierarchy

UD-Viz (repo)
β”œβ”€β”€ bin                       # Monorepo scripts
β”œβ”€β”€ docs                      # Documentation
β”œβ”€β”€ examples                  # Examples of the ud-viz framework
β”œβ”€β”€ test                      # Monorepo test scripts
β”œβ”€β”€ packages                  # Packages folder
β”œβ”€β”€ .eslintrc.js              # Linting rules and configuration
β”œβ”€β”€ .gitignore                # Files/folders ignored by Git
β”œβ”€β”€ .prettierrc               # Formatting rules
β”œβ”€β”€ travis.yml                # Continuous integration entrypoint
β”œβ”€β”€ favicon.ico               # Landing page icon
β”œβ”€β”€ index.html                # Landing page entrypoint
β”œβ”€β”€ package-lock.json         # Latest npm package installation file
β”œβ”€β”€ package.json              # Global npm project description
β”œβ”€β”€ Readme.md                 # It's a me, Mario!
β”œβ”€β”€ style.css                 # Landing page style

Github repositories:

Repository Link Description
UD-Viz-docker https://github.com/VCityTeam/UD-Viz-docker Docker, which performs all the steps described in Getting Started.
UD-Viz-template https://github.com/VCityTeam/UD-Viz-template A basis for creating your application using UD-Viz.

Getting Started

Installing node/npm

For the node/npm installation instructions refer here

UD-Viz has been reported to work with versions:

  • node version 18.X
  • npm version: 9.X

Installing the UD-Viz framework per se

Clone the UD-Viz repository and install requirements with npm

git clone https://github.com/VCityTeam/UD-Viz.git
cd UD-Viz
npm install # resolve dependencies based on the package.json (and package-lock.json if it exists)

Install ImageMagick and GraphicsMagick

For the install imagemagick and graphicsmagick binary sub dependencies since the server needs gm.

  • Linux

     sudo apt-get install -y imagemagick graphicsmagick
  • Windows

    • It seems not necessary to install imagemagick on windows.
    • Download and install graphicsmagick from graphicmagick-binaries (@ud-viz/game_node_template has been reported to work with version 1.3.34-Q8)

    ⚠️ TIP : allias gm doesn't work in powershell because it conflicts with the command Get-Member !!!!

  • OSX

    brew install imagemagick graphicsmagick

How to run it locally?

npm run start

After running go to localhost:8000 which links to documentation and examples