# MMD-AR Viewer for Android ver 1.0.1.1

This document is written not in English but in Engrish.
MMD-AR Viewer for Android is an AR (Augmented Reality) software based on marker detection method. This software ovarlay MikuMikuDance (MMD) Model object on the video camera image.

## Environment Information

Android Tablets (Tegra2 CPU or higher one) or higher.
Perhaps this software should not work on smartphone devices due to requiring very heavy processing.

### Develop and Test Enviroment

Eee Pad Transformer TF101

## How to Use

1. Before install this software, Download AR marker image from developer's site (here) and print out it on paper.
2. Copy MMD model files (*pmd and texture files) and motion files (*vmd) in Android storage or SD card.
3. Install MMD-AR Viewer and start.
4. When you start MMD-AR in first time, configuration dialog would be displayed, choose a MMD model data file (*.pmd) and a Motion Data File (*.vmd)
   (You can call configuration later. Tap "Configuration" button from menu.)
5. Tap "Accept" button after choosing files, then main view would be displayed.
6. Camera preview is displayed on main view. When you look at AR marker, MMD object CG would be displayed and overlay on preview image.

## Developer's Site

"MMD-AR Viewer for Android" Developer's site.
URL: http://sourceforge.jp/projects/mmd-ar-vwr-andr/
get latest source code and information about MMD-AR Viewer.

## Available MMD Data File

- MikuMikuDance Model Data shipped with MikuMikuDance is confirmed to display.
- MMD data using ShpereMap function (use texture files just like *.spa or *.sph) is available but rendered as a normal texture.

## Library and Tools

- NyARToolkit for Android
  NyARToolkit implementation work on Android OS.（distributed under Apache Software License, 2.0）
- nymmd
  MikuMikuDance play library implemented using OpenGL （distributed under GNU GPL v2 License>
- Android File Dialog
  Android File Dialog implementation （distributed under New BSD License）
- defaulticon
  Free icon images （distributed under Creative Commons Attribution-No Derivative Works 3.0 )
- ARToolKit Marker Generator Online
  ARToolKit Generator web service.

## Limitation

- After resumed from sleep mode, preview image freezes. When this phenomenon happened, choose "Settings" from menu and back to main view to recover.
- When texture image size is not normalized （ex: 256 pix X 256 pix）, Such a texture image is resized.
- PMX model data file (*.pmx) is not available.
- MMD data using SphereMap function (use texture files just like *.spa or *.sph) is available but rendered not as a sphereMap texture but as a normal texture.
- Collision Detection and Physics is unavailable.
- Refresh rate depends on many factors such as the length of motion data, the complexity of model data and the preference of preview resolution.

## Planned Improvements

- Recording function.
- Display smoothly (If possible).
- Improve error handling.

## License

MMD AR Viewer is distributed under GNU GPL v3. Click "License" button and see details.