
_/_/  "MocuMocuDance" Ver.1.06 Manual  _/_/


# Description

"MocuMocuDance" is an application to view MikuMikuDance(MMD)
models and motions by Oculus Rift or Steam VR.

When you load a motion file, if sound file is exist,
it plays the sound concurrently.


# Loadable file format

Character     PMX
Motion        VMD, VPD(Pose)
Sound         MP3, WAV, WMA, FLAC
Field         PMX, MQO(Metasequoia)


# Recommended specifications

OS          : Windows 8.1/10 64bit
DirectX     : DirectX11
CPU         : Intel Core i7
Memory      : 4GB
GPU         : GeForce GTX 970 or later
Oculus Rift : 1.20.0 or later
Steam VR    : OpenVR 1.12.5 or later


# Support input devices

Oculus Touch
Vive Controller
LeapMotion   : Gemini
Joypad       : DirectInput(XInput is not supported)


# Oculus Rift

You need to install follow software.

Oculus Rift Setup
https://www.oculus.com/en-us/setup/

And, Change to "Unknown Sources" setting on.


# Steam VR

You need to install follow software.

steam://install/250820

This app doesn't support HTC Vive controller.


# MocuMocuDanceForVive

MocuMocuDanceForVive.exe Supported HTC Vive/Pro/Pro Eye/Cosmos only.

You can use Vive Hand Tracking.

Requirements OpenCL and "Microsoft Visual C++ Runtime 2015".


Camera Setup / Vive Hand Tracking
https://hub.vive.com/storage/tracking/misc/steamvr.html


# DirectX

This app needs to install DirectX June2010 ver.

DirectX End-User Runtimes (June 2010) 
https://www.microsoft.com/en-us/download/details.aspx?id=8109


# Controls

[Esc]                Exit
[F1]                 Show how to controll
[F7]                 Reset view angle
[F8]                 Toggle VR Camera View (LeapMotion or HTC Vive only)

[Mouse Right Button] Open menu, Cancel
[Space]
[Mouse Left Button]  Decide selected menu item
[Enter]
[Mouse Wheel]        Move menu item cursor
[Up][Down]
[Left][Right]        Slider setting, Favorite character setting

[W][A][S][D]         Move
[Q][E]               Rotate Left/Right
[R][F]               Move Up/Down
[T][G]               Rotate Up/Down
[Shift]              Move/Rotate first
[Ctrl]               Move/Rotate slow

[Y]                  Physics Engine on/off
[U]                  Tone Mapping on/off
[I]                  Morphing on/off
[O]                  Change Move/Manipulation Mode
[P]                  Stop/Restart motion

[H]                  Shadow on/off
[J]                  Toggle Rendering Mode
[K]                  Relief Mapping on/off
[L]                  Light Scattering on/off

[Z][X]               Shot fluid, Clear all fluid

[1][2]               Seek voide pos

[C]                  Toggle camera collect rotate
[V]                  Reset Physics
[B]                  Look at me on/off
[N]                  Reset Oculus center position
[M]                  Toggle Oculus mirror mode
[PageUp/PageDown]    Load prev/next scene


# HTC Vive Controller

Menu button          Open menu, Cancel, Clear all fluid
Trigger              Decide, Shot fluid
Trackpad             Move/Rotate Camera, Move menu cursor
Grip L Button        Camera Move
Grip R Button        Camera Rotate

Grip Button          Move offset pos on selected bone


# Folders

When you open a load menu, this app finds in each folder.

Character    UserFile/Model
Motion       UserFile/Motion
Field        UserFile/Field
Accessory    UserFile/Accessory
Voice        UserFile/Voice
BGM          UserFile/BGM


# Sound file

When you load a motion file, if sound file is exist,
it plays the sound concurrently.

ex)

Motion filename : dance.vmd
Sound filename  : dance.mp3


# Motion setting file

When you load a motion file, if motion setting file is exist,
it loads the file concurrently.

ex)

Motion filename          : dance.vmd
Motion setting filename  : dance.setting.txt

This file is text file.

------------------------------------
SoundOffsetTime = -0.5;
------------------------------------


# Fluid physics

It's heavy. And, It requires ComputeShader5.0.


# How to WaterPlane and Underwater rendering

You need to create a setting text file.

ex)

Field filename          : pool.pmx
Field setting filename  : pool.setting.txt

You need to write a water setting.

----------------------------------------------------
Water = "material name", 0.41, 0.61, 0.90, 0.5;
WaterHeight = 3.0;
----------------------------------------------------

"material name" is a waterplane material name.
This name is able to check to use PmxEditor.

This setting text file character code is Shift-JIS.

No.2-5 "Water" parameter is water color RGBA.


# Voice

16bit mono WAV format only.


# VRM file support

This version is alpha version. It's not supported Morph,
Collider, NormalMap and MToon(ToonRendering).

The motion playing is easy bone mapping.


# Startup exe options

-nostartupdlg
-steamvr


# Redistribute

Redistributing this application is forbidden.

If you want to download this applicaion, you must download
from the official website.


# User policy

Non commercial use


# Disclaimer

I'm not responsible for any damages resulting from use.


# Included data

* Tda-type Hatsune Miku Append Ver1.00

  Tda
  http://u16hp.blog134.fc2.com/


* MikuMikuDance Masisi's House model data

  masisi
  http://www10.plala.or.jp/masisi/


* MikuMikuDance(MMD) Toon01~10.bmp

  VPVP
  http://www.geocities.jp/higuchuu4/index_e.htm


* nakano sisters voice data vol.1

  All rights:Gumming Inc.
  Character Voice(Naka)FMisato Kanamori
  Character Voice(Kano)FMai Hamada

  http://nakasis.com/
  http://gumming.co.jp/


# Icon

This application's icon is drawn "Hatsune Miku". She is a
character of Crypton Future Media, INC.

http://piapro.jp/license/pcl/summary


Icon created by Kafuji


# License

* MikuMikuDance(MMD)

  VPVP
  http://www.geocities.jp/higuchuu4/index_e.htm


* PMX

  http://kkhk22.seesaa.net/


* Texture

  Texture Labs
  http://texturelabs.org/

  Caustics Generator
  http://www.dualheights.se/caustics/


  Humus
  http://www.humus.name/

  Creative Commons Attribution 3.0 Unported License
  http://creativecommons.org/licenses/by/3.0/


* Steam VR / OpenVR

  http://steamcommunity.com/steamvr
  Copyright (c) 2015, Valve Corporation


* libjpeg

  http://www.ijg.org/
  this software is based in part on the work of the Independent JPEG Group


* Bullet

  http://bulletphysics.org/


* OpenJTalk

  http://open-jtalk.sourceforge.net/


* Julius, Julius dictation kit

  http://julius.osdn.jp/


* MeCab, IPA dic

  http://taku910.github.io/mecab/


* MMDAgent, HTS Voice "Mei"

  http://www.mmdagent.jp/


* OpenSubdiv, Copyright 2013 Pixar

  http://www.pixar.com/


* VIVE Hand Tracking SDK

  https://developer.vive.com/resources/knowledgebase/vive-hand-tracking-sdk/


* FLAC

  https://xiph.org/flac/
  Copyright (C) 2000-2009  Josh Coalson
  Copyright (C) 2011-2016  Xiph.Org Foundation


* Ultraleap

  https://www.ultraleap.com/


* LeapCxx

  https://github.com/leapmotion/LeapCxx


# Developer

Yudai Senoo

Web Site  : http://www.vrai.jp/

Twitter   : https://twitter.com/senooyudai


# Change log

* Ver.1.06 2021/12/20

 + Supported LeapMotion Gemini.
 + Updated VIVE Hand Tracking.


* Ver.1.05 2020/12/27

 + When moving the slider, the speed is adjusted when the Ctrl / Shift key is pressed.
 + A menu has been added that allows you to select either "Y-axis rotation" or "Y-axis movement" for the touchpad (stick) function of the VR right controller.
 + Updated Oculus SDK 23.0.0


* Ver.1.04 2020/10/17

 + When using Oculus Touch in SteamVR mode, you can move without pressing the stick button.
 + The left and right VR controllers display each 3D model.


* Ver.1.03 2020/09/13

 + Supported FLAC Sound File
 + Camera Move/Rotate by VR Controller Grip Button
 + Updated Vive Hand Tracking SDK 0.9.3


* Ver.1.02 2020/08/22

 + Added Gravity Setting


* Ver.1.01 2020/08/10

 + Added VR Chroma Key Setting
 + Optimized


* Ver.1.00 2020/06/17

 + Supported Vive Hand Tracking (MocuMocuDanceForVive.exe only)
 + To 64bit exe
 + Deleted Script Menu
 + Updated OpenVR 1.12.5


* Ver.0.99 2020/02/09

 + Added Pupil setting
 + Added Slider menu text value
 + Updated OpenVR 1.9.16


* Ver.0.98 2019/03/13

 + Remove VRM loader
 + Fixed some bugs


* Ver.0.97 2019/01/20

 + Supported material morph edge color
 + Fixed VRM bone z-coordinate
 + Supported window resizing (WindowMode only)


* Ver.0.96 2019/01/06

 + Support vertex morphing for VRM
 + Sort morph list by defined order
 + Use ComputeShader to vertex morph
 + Remove limiting the number of morph processing
 + Add morph processing type menu


* Ver.0.95 2019/01/04

 + Add startup exe options
 + Add close app menu


* Ver.0.94 2019/01/03

 + Fix VRM loading


* Ver.0.93 2019/01/03

 + Support VRM file (alpha version)
 + Support model file D&D loading
 + Fix AR mode for HTC Vive Pro
 + Update OpenVR 1.1.3b

  VRM support is alpha version. It's not supported Morph,
  Collider, NormalMap and MToon(ToonRendering).


* Ver.0.92 2018/05/12

 + Support camera motion
 + Add camera motion menu
 + Add Field move mode
 + Add move mode menu
 + Add field pos and rotate reset menu
 + Add camera view angle reset shortcut key
 + Update OpenVR SDK 1.0.14


* Ver.0.91 2018/02/09

 + Improve water plane rendering
 + Add Water bump setting
 + Add character position reset menu
 + Add Fluid shot Y offset from camera setting
 + Add Fluid shot angle from camera setting


* Ver.0.90 2017/12/10

 + Add support texture color material morph
 + Change script engine OnIdle() call timing
 + Fix script engine
 + Change default settin LeapMotion Hand collision detection mode
 + Add field bone/rigid load setting
 + Improve player move by Oculus Touch
 + Fix Y-axis move lock by Oculus Touch
 + Update OpenVR SDK 1.0.11
 + Update Oculus SDK 1.20.0


* Ver.0.89 2017/11/04

 + Add VR camera mask setting


* Ver.0.88 2017/10/21

 + Add LeapMotion Hand collision detection mode
 + Improve LeapMotion Hand modeling
 + Fix some bugs


* Ver.0.87 2017/10/17

 + Improve JPEG loading
 + Add an error message for unsupported DDS file
 + Improve forbid check


* Ver.0.86 2017/10/09

 + Add PNG support format 1bit-color


* Ver.0.85 2017/10/06

 + Fix showing bug with length 0 bone local axis
 + Fix moving menu cursor by VR controller


* Ver.0.84 2017/09/21

 + Fix old motion file loading


* Ver.0.83 2017/09/14

 + Support IK off setting motion file
 + Add voice play pos seek slider
 + Add "Cat Feather Toy" for VR Controller object


* Ver.0.82 2017/07/19

 + Support Oculus Touch
 + Improve slider move speed by Vive controller
 + Update Oculus SDK 1.16.0


* Ver.0.81 2017/07/08

 + Add look at vr controller interaction
 + Support BoneMorph
 + Fix menu position after scene loading
 + Skip field loading when scene loading
 + Add character scale setting in setting text


* Ver.0.80 2017/06/25

 + Add AR cache view mode
 + Fix to load pmx files include QDEF


* Ver.0.79 2017/05/18

 + Add to show HTC Vive front camera view
 + Support HTC Vive controller
 + Add to render mirror
 + Add Sound volume menu
 + Add some character interaction
 + Add character normal setting


* Ver.0.78 2016/06/19

 + Update Oculus SDK 1.4.0
 + Update OpenVR SDK 1.0.1
 + Update French language text


* Ver.0.77 2016/06/09

 + Strengthen to forbid to load each pmx file
 + Add to use fluid setting menu
 + Change use fluid default setting to disable
 + Change default fluid color
 + Update French language text


* Ver.0.76 2016/06/07

 + Add to forbid to load each pmx file


* Ver.0.75 2016/06/06

 + Add to forbid to load each pmx file
 + Add French language setting
 + Add LipSync enable setting


* Ver.0.74 2016/05/07

 + Fix motion sound mono conversion
 + Improve caustics in water
 + Update OpenVR 0.9.20
 + Supported joypad POV button


* Ver.0.73 2016/05/02

 + Add LeapMotion camera image show mode


* Ver.0.72 2016/05/02


* Ver.0.71 2016/05/01

 + Supported OculusRemote
 + Add play sound device selecter
 + Supported mp3,wma file format to voice


* Ver.0.70 2016/04/25

 + Improve physics engine parameters
 + Update Oculus SDK 1.3.2
 + Change character setting menu order


* Ver.0.69 2016/04/19

 + You can use joypads at same time


* Ver.0.68 2016/04/14

 + Add forefinger flick fluid shot function
 + Adjust fluid shot direction
 + Fix distortion on SteamVR
 + Clamp MMD Mass parameter


* Ver.0.67 2016/04/09

 + Add character bone move mode
 + Add bone move function by LeapMotion
 + Add bone lock function


* Ver.0.66 2016/04/03

 + Add character scale setting
 + Add exe file for Oculus Runtime 0.8.0
 + Add shadow mode setting menu
 + Add scene save shadow mode
 + Delete corner black fill by SteamVR
 + Improve drop frame to shot fluid
 + Fix load Exif Jpeg
 + Fix water animation


* Ver.0.65 2016/03/29

 + Oculus Runtime 1.3.0
 + Fix CCD-IK
 + Unsupported DDS texture file


* Ver.0.64 2016/03/21

 + Improve drop frame to shot fluid
 + Add LeapMotion hand mirroring setting
 + Support SteamVR(OpenVR) 0.9.19
 + Support PMX vertex color option


* Ver.0.63 2016/03/12

 + Fix player position and pose by position tracking


* Ver.0.62 2016/03/06

 + Add to support Steam VR (OpenVR)


* Ver.0.61 2016/02/28

 + Add to support VPD pose file
 + Fix character move/rotate for Oculus Rift
 + Delete YouTube player


* Ver.0.60 2016/02/22

 + Add motion frame sync setting menu


* Ver.0.59 2016/02/20

 + Add Virtual window view
 + Add Joypad exclusive mode


* Ver.0.58 2016/02/13

 + Add 3D Sound (Character voice only)
 + Fix OculusRift position tracking


* Ver.0.57 2016/02/07

 + Add Lip Synch


* Ver.0.56 2016/01/31

 + Add full screen option on startup
 + Improve PNG loading


* Ver.0.55 2016/01/29

 + Add waterplane and underwater rendering


* Ver.0.54 2016/01/17

 + Speed up camera rotate
 + Add camera move/rotate speed setting menu


* Ver.0.53 2015/12/27

 + Fix bone rotation
 + Save fluid particle size and quantity
 + Asynchronous to make file list


* Ver.0.52 2015/12/16

 + Fix bone rotation


* Ver.0.51 2015/12/13

 + Improve "Look at me"
 + Set each character "Look at me" setting
 + Improve a menu


* Ver.0.50 2015/12/11

 + Support Oculus Runtime 0.8
 + Fix motion interpolation
 + Add PNG support format Alpha-only and 4bit-color
 + Change Icon


* Ver.0.49 2015/12/06

 + Add SSAO


* Ver.0.48 2015/11/15

 + Change to rotate character on view coordinate system
 + Save shadowmap resolution
 + Fix skydome size by far clipping distance


* Ver.0.47 2015/11/08

 + Add favorite character load menu
 + add fluid color setting
 + fix to draw edge by alpha=0


* Ver.0.46 2015/10/31

 + Add Camera projection setting


* Ver.0.45 2015/10/15

 + Add joypad deadzone customize
 + Target with neck bone while looking me
 + Open scene file by command line parameter
 + Load 32bpp BMP file as RGBA format
 + Add light scattering setting menu
 + Add tone mapping setting menu
 + Default tone mapping setting is on
 + Save scene file with physics setting each character
 + Save scene file with light settings
 + Influence tone mapping to sky sphere
 + Influence tone mapping to fluid
 + Clear Z-Buffer while drawing a menu


* Ver.0.44 2015/10/09

 + Improve fluid simulation
 + Add fluid orange color
 + Ignore Z buffer while drawing a menu


* Ver.0.43 2015/10/05

 + Add Joypad customize function for Xbox one controller on Windows10


* Ver.0.42 2015/10/02

 + Fix scene save is not included motion bug


* Ver.0.41 2015/09/28

 + Change scene save file name format on English mode
   (Not included a source character/field file name)


* Ver.0.40 2015/09/26

 + Fix to disable morph while motion stopped
 + Load group morph
 + Set morphs
 + Add to disable morph to motion
 + Increase number of vertex morph 4 to 8
 + SceneSave morph setting
 + Change Camera Y-Axis Lock default setting to on
 + Save camera lock setting
 + Enable camera rotate while menu showing
 + Show menu to left
 + Fix menu position
 + Add joypad axis config setting
 + Change joypad default setting for Xbox One Controller
 + Update LeapMotion 2.3.1


* Ver.0.39 2015/10/05

 + Add Joypad Customize function for Xbox one controller on Windows10


* Ver.0.39 2015/09/06

 + Add talk script (Japanese only)
 + Fix morph update while motion playing


* Ver.0.38 2015/08/06

 + Collect camera rotate
 + Lock X-Axis rotate by default


* Ver.0.37 2015/08/01

 + Speed up run
 + Add error text


* Ver.0.36 2015/08/01

 + Add error text


* Ver.0.35 2015/07/31

 + Fix IK and motion
 + Reflect MMD self shadow flag while MMD Rendering Mode


* Ver.0.34 2015/07/25

 + Changed character code translation


* Ver.0.33 2015/07/24

 + Add MMD Rendering Mode
 + Add Lock Camera X-Axis/Y-Axis Rotate/Move function


* Ver.0.32 2015/07/19

 + Fix physics engine
 + Fix motion bezier interpolation


* Ver.0.31 2015/07/12

 + Add Lighting setting menu
 + Include field objects to make shadow
 + Add Shadowmap Resolution setting menu
 + Delete Light rotate mode


* Ver.0.30 2015/07/04

  + Add scene save/load function
  + Add a model data menu sorted creation filetime
  + Update LeapMotion 2.2.7
  + Add this english manual


* Ver.0.29 2015/06/26

  + Update Oculus SDK 0.6.0.1


