Readme¶

This project is part of NUBOMEDIA www.nubomedia.eu

ARModule contains marker detector filter utilizing ALVAR augmented reality library ie ALVAR markers can be detected from the video image. ARModule can render 2D and 3D augmentation with OpenCV and Irrlicht rendering engine above the detected ALVAR marker. ARModule can also and send events about markers to the Kurento Client.

The repository contains documentation for installing and utilising the ArModule. The repository contains description of the architecture of the ARModule and also the source code of the ARModule implementation.

Alvar Markers

Some Alvar markers can be found eg from: AlvarMarkers Eg the zero marker is defined as MarkerData_0.png

Artifacts:

Maven Central: http://repo1.maven.org/maven2/fi/vtt/nubomedia/armodule/arfilterdemo/

Npm: https://www.npmjs.com/package/fi-vtt-nubomedia-kurento-module-armarkerdetector

Licensing and distribution

ArModule is licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Irrlicht Engine, the zlib and libpng. The Irrlicht Engine is based in part on the work of the Independent JPEG Group The module utilizes IJG code when the Irrlicht engine is compiled with support for JPEG images.

Contribution policy

You can contribute to the Nubomedia community through bug-reports, bug-fixes, new code or new documentation. For contributing to the Nubomedia community, drop a post to the [Nubomedia Public Mailing List] providing full information about your contribution and its value. In your contributions, you must comply with the following guidelines

You must specify the specific contents of your contribution either through a detailed bug description, through a pull-request or through a patch.
You must specify the licensing restrictions of the code you contribute.
For newly created code to be incorporated in the Nubomedia code-base, you must accept Nubomedia to own the code copyright, so that its open source nature is guaranteed.
You must justify appropriately the need and value of your contribution. The Nubomedia project has no obligations in relation to accepting contributions from third parties.
The Nubomedia project leaders have the right of asking for further explanations, tests or validations of any code contributed to the community before it being incorporated into the Nubomedia code-base. You must be ready to addressing all these kind of concerns before having your code approved.

Support

[NUBOMEDIA]: http://www.nubomedia.eu [Nubomedia Public Mailing List]: https://groups.google.com/forum/#!forum/nubomedia-dev