Skip to content

jsartolkitNFT is a smaller version of jsartoolkit5 with only NFT support

License

Notifications You must be signed in to change notification settings

subjectdenied/jsartoolkitNFT

 
 

Repository files navigation

Built with Grunt Dependabot Badge Build Status Build Status

JSARToolKitNFT

Emscripten port of WebARKitLib to JavaScript. Modified and lighter version of JSARToolKit5.

Try the example !! kalwalt.github.io/jsartoolkitNFT/examples/arNFT_example.html

Markers Types

JSARToolKitNFT support only this types of markers:

  • NFT (natural feature tracking) markers ✅ 🎉 🎨

has WASM embedded in a single file!

Using the library 💥

You can use raw.githack.com links:

WASM version of the libary:

<script src="https://raw.githack.com/kalwalt/jsartoolkitNFT/master/build/artoolkitNFT_wasm.js">

NO WASM minified:

<script src="https://raw.githack.com/kalwalt/jsartoolkitNFT/master/build/artoolkitNFT.min.js">

or you can install with npm:

npm i @kalwalt/jsartoolkit-nft

or you can clone the repository with git, follow the instructions below:

Clone the repository 🌀

  1. Clone this repository
  2. Clone ARToolKit5 project to get the latest source files. From within JSARToolKitNFT directory do git submodule update --init. If you already cloned ARToolKit5 to a different directory you can:
  • create a link in the jsartoolkitNFT/emscripten/ directory that points to ARToolKit5 (jsartoolkitNFT/emscripten/artoolkit5) (Linux and macOS only)
  • or, set the WEBARKITLIB_ROOT environment variable to point to your ARToolKit5 clone
  • or, change the tools/makem.js file to point to your artoolkit5 clone (line 20)

ARnft library

JSARToolKitNFT is used by ARnft a small libary that help developers to create WebAR apps.

Project Structure 📂

  • build/ (compiled debug and minified versions of JSARToolKitNFT)
  • doc/ (documentation, coming...)
  • emscripten/ (source code for ARToolKit)
  • examples/ (demos and examples using JSARToolKitNFT)
  • js/ (compiled versions of ARToolKit.js with Three.js helper api)
  • tools/ (build scripts for building JSARToolKitNFT)

WebAssembly 👋

JSARToolKitNFT supports WebAssembly. The libary builds WebAssembly artifacts during the build process, WASM is embdded in a single file. This is build/artoolkitNFT_wasm.js. To use it, include the artoolkit_wasm.js into your html page like this:

<script src="../build/artoolkitNFT_wasm.js"></script>

As loading the WebAssembly artifact is done asynchronously, there is a callback that is called when everything is ready.

window.addEventListener('artoolkitNFT-loaded', () => {
    //do artoolkit stuff here
});

See the example for details.

Build the project 🔨

Go to the wiki for more infos

About

jsartolkitNFT is a smaller version of jsartoolkit5 with only NFT support

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 98.6%
  • Other 1.4%