(WORK IN PROGRESS)

Welcome to GeoPose Sandbox, a testing environment to validate the different elements of the OGC GeoPose specification, with the goal of facilitating the definition and implementation of the standard. While this project is exploratory in nature, the (TypeScript) code is being primarily written with clarity/simplicity in mind and might offer guidance to those who are trying to include GeoPose in their own projects.

Additionally, to better explain the core concepts behind the GeoPose standard, this sandbox also includes a basic 3DUI system based on Three.js that takes advantage of the same ideas to enable the creation of simple but engaging WebXR-based interaction spaces.

Installation

You can install the Geopose Sandbox using the following NPM command:

npm install geopose-sandbox

Folder Structure

This projects follows a simple folder structure:

• builds: The JavaScript files generated by the build process, including a basic, module-based and minified versions.
• docs: The documentation files of the project including the auto-generated ones from the code.
• sources: The Typescript source files, divided in three basic parts (each dependent on the previous ones).
  • data: A collection of structures to facilitate the definition, conversion and serialization of Geopose-related data.
  • logic: The logic representation of the data structures (in the Threejs engine).
  • user: A relatively simple collection of classes to define user interaction spaces.
• tests: A collection of test that focus on different aspects of the Geopose Sandbox.
• utilities: The custom build system for the project and other external tools.

Note: Right now, the main branch is an stub. The latest version is available in the development branch.