Open or share a scene via a link

A link to the web application can contain options to define a scene. These options are handed over via query parameters that allow the inclusion of resources that are hosted on other websites. For example a character card on an image host website or a music video on youtube.

Convenient interface

You can open the interface by clicking on the top main menu button .

Syntax

INFO

Since the interface to create links is deployed now and covers all the brain work, you might skip the following syntax explanation and just use the interface.

The options of a scene are passed after a question mark and separated by an & sign: https://ero.dance/ ? option1 = value & option2 = value.

Each option starts with its option key name and will be followed by an optional number. A = sign marks its following value.

Options

option	value type	description	default value
x	.bpmx | .pmx | .pmv | .png	Model
m	.bvmd | .vmd | .png	Motion
a	.webm | .mp3 | .wav | .png	Audio
c	boolean	2D camera and audio
stage	.png | .bpmx | .pmx | .pmv	Stage
arb	.zip | .png	Arbitrary data
d	path	Directory
background	boolean	Background color	#404065FF
loop	boolean	Loop scene	true
shadow	boolean	Show shadow	true

Except of the option d all options with the same number regard to each other. In the following example will the motion m1 applied to x1 and m2 to x2: m1=motionOne.bvmd&m2=motionTwo.bvmd&x1=modelOne.bpmx&x2=modelTwo.bpmx

The order of the options have no effect. If there is no number defined it counts as number 0.

Audio

The audio file with the highest number will be used as audio source.

Youtube Audio

You can also enter a youtube video link as audio source.

Youtube Audio Source

Some videos are restricted and not allowed to embed.

Synchronization

To synchronize a motion file with a youtube video, you can add a time parameter to the video link. Add t= and then the seconds. This parameter can be a negative value or a floating point.

Depending on your youtube link format there have to be a ?or & sign before the t=. Example youtu.be/wa0_0lLAozc?t=5.5 for 5.5 seconds.

TIP

This example with youtu.be and without https://www. in front is also the shortest version to mention a youtube link.

For links the & sign is not directly allowed in ero.dance links. Therefore, you have to replace it if it is in your youtube link with %26. In example https://www.youtube.com/watch?v=wa0_0lLAozc&t=5 need to be change to https://www.youtube.com/watch?v=wa0_0lLAozc%26t=5.

Path

This parameter helps to shorten the whole link if files share similar paths. You can specify multiple path parts by writing a number to it (d0, d1, d2 and so on). Specifying no number regards to 0.

Write the path number followed by : before a file to use the defined part, see the following example

https://ero.dance/?x=https://filestorage.test/model/mywaifu.bpmx&a=https://filestorage.test/song/mymusic.mp3&m=https://filestorage.test/song/motion/mydance.bvmd&m1=https://filestorage.test/song/motion/myact.bvmd

The part https://filestorage.test/ is used four times. By setting it to d, the link can be shrank to

https://ero.dance/?d=https://filestorage.test/&x=0:model/mywaifu.bpmx&a=0:song/mymusic.mp3&m=0:song/motion/mydance.bvmd&m1=0:song/motion/myact.bvmd

Paths can also be used in other path definitions, see how d1 builds up on d. The end result would be

https://ero.dance/?d=https://filestorage.test/&d1=0:song/motion/&x=0:model/mywaifu.bpmx&a=1/mymusic.mp3&m=1:mydance.bvmd&m1=1:myact.bvmd

Model

Model files are added with the option x.

Pose

Pose is the position and orientation of a model in 3d coordinates. That are 6 numbers (3 translational values and 3 rotational values). They are defined in front of the file path, in order and separated by |. If you miss the latter values, they are set to 0.

Parameter order	value type	description
1	number	Translation in x
2	number	Translation in y
3	number	Translation in z
4	number	Rotation
5	number	Pitch
6	number	Yaw

Rotation, pitch and yaw are in radiant

${\alpha }_{rad}={\alpha }_{deg}\cdot \frac{\pi }{180}$

Example to set only the y and z position to 5.3 and 4.2: x=0|5.3|4.2|myFilePath/myModel.bpmx

2D Camera and Audio

The 2D camera defines the typical MMD camera motion. Since the perspective in AR/VR is always your real life head, this perspective can only be seen in desktop mode. By loading multiple motions into one scene with multiple MMD camera motions, the motion with the highest number will be selected as default mmd camera. Otherwise use the c option to select one of the motion files. The c option needs no value, just its following number defines the selected motion file.

In Example, you select the motion file of m1 by mentioning the option c1: m=motionZero.bvmd&m1=motionOne.bvmd&m2=motionTwo.bvmd&c1

Arbitrary data

All the containing data like model, motion and audio of the file will be used for a scene.

Background color

You can change it with the background color for the screen mode. The value is a hex color code, starting with # and followed by 6 or 8 digits. The first 6 digits are the RGB color code, the last 2 digits are the alpha value. The alpha value is optional and if not set, it will be set to FF (fully opaque).

Loop

If loop is set to false, the scene will stop after the last frame.

Shadow

If shadow is set to false, all scene shadows will be hidden.

TIP

If the model has fixed shadows, you may deactivate them in the model settings.