About Cubism Viewer (for OW)

(Updated 05/19/2022)

Cubism Viewer (for OW) is a viewer intended only for validation of data created with Cubism.
In addition to displaying the model, you can check physics, line-of-sight tracking, and playback of multiple motions.

An operational form similar to Cubism2.1 is called “Original Workflow”.
Cubism Viewer (for OW) allows you to view the arms, etc. using parameter fades used in Cubism 2.1.
Allows switching poses and creating facial expressions.
This allows for facial expression settings, pose settings, motion lists, etc. similar to Cubism 2.1.

Models and motions that can be handled in Cubism Viewer are data exported for embedded use.
Please note that .cmo3 and .can3 for editing cannot be handled.

 

About the screen of Cubism Viewer (for OW)

Number Item Detail
(1) Menu area A menu appears that allows you to load models, manipulate parameters, and play back motion.
The menu to be displayed is selected from the drop-down at the top.
(2) Resource Area The loaded data or data created on Cubism Viewer will be displayed here.
(3) Setting item area

You can change and check settings related to expression setting files and motion files.
The settings can be saved in a model configuration file.
[File] menu -> [Export] -> [Model Settings (model3.json)]

(4) Model display area

The loaded model is displayed here. The model can be moved or scaled.
The [Show] menu allows you to change the background color, display the model with a transparent background, and display the hit criteria.

 

How to start Cubism Viewer (for OW)

Cubism Viewer (for OW) is enclosed with the Cubism Editor installer.
After the expansion, it is placed in the same hierarchy as the executable file, so it can be started from the area in the red frame in the figure below.

Once launched, drop the .moc3 or .model3.json file into the loading dialog to launch the Viewer.

 

You can switch the display language from the [File] menu -> [Language]. 

Number Item Details
(1) Language Switching You can select from [Japanese], [English], [Korean], or [Chinese].
(2) Revert to the language of the installation (Windows version) Switches to the language selected during installation.
Revert to OS system language (macOS version) It will refer to the language of the OS.

The following are the specifications at the time of language setting.

• The language will be switched when the editor is restarted after setting.
• Language settings are shared within editors of the same minor version (e.g., 4.2 series).
• Language switching, which is done through the editor's [Setting] menu, takes precedence over the installation settings and OS settings.

 

How to create basic embedded data

Cubism2.1 Viewer ( for OW ) *Conventional Viewer   Cubism Viewer ( for OW )

Execute moc file export from Modeler

[File to be written out]
• Texture file (.png)
• MOC file (.moc)
• Model file (.model.json)

 

Execute export as moc3 file from Modeler

[File to be written out]
• Texture file (.png)
• moc3 file (.moc3)
• Model file (.model3.json)
* Includes link to physics settings (.physics3.json)

 

“Output motion data” from Animator

[File to be written out]
• Motion file (.mtn)

 

“Export motion file” from Animator

[File to be written out]
• Motion file (.motion3.json)

 
Load the following files into the Viewer
• MOC file (.moc)
• Exported motion (.mtn) file
  Load the following files into the Viewer
• moc3 file (.moc3)  * .model3.json is also acceptable

=> File is loaded and the Viewer starts up

• Exported motion (.motion3.json) file

 
Configure settings in the Viewer
• Pose setting (.pose.json)
• Physics calculation settings (.physics.json)
• Expression setting (.exp.json)
  Configure settings in the Viewer
• Pose setting (.pose3.json)
• Expression setting (.exp3.json)

[Notes]
=> Files set in Viewer are marked with an asterisk in the upper right corner of their names.

 
Exporting Model Setting Files
• Model configuration file (.model.json)
  Exporting Model Setting Files
• Model configuration file (.model3.json)

[Notes]
=> When you overwrite the (.model3.json) output from CubismEditor at output, the file created by Viewer (marked with an asterisk) will be saved together.

TIPS
In Cubism3 or later, the physics settings (physics3.json) are done on the CubismEditor side, so only the name is displayed in the tree in the Viewer.

 

Menu

File Menu

Item Detail
Add Facial expression:
Add motion for facial expressions.
In the setting item area, place a check mark on the parameter for which you wish to set the expression and adjust the parameter.

Pose:
Create a configuration file in json format to reflect the arm switching mechanism created in the model and motion.
For detailed instructions, please refer to the “Pose Settings” page.
Read in Motion for facial expressions (motion3.json / exp3.json):
Load [motion3.json] for facial expressions exported in the animation process into Cubism Viewer.
Export

Model settings (model3.json):
Export the settings made in Cubism Viewer as a json format file.
Shortcut key [Ctrl] + [S]

All facial expression motions:
Export all motions for facial expressions as json format files.
For a detailed explanation, please refer to the “Expression Settings and Export” page.

Pose:
Export the pose switching settings in a json format configuration file.
For a detailed explanation, please refer to the “Pose Settings” page.

Setting Include the extension in the default expression name:
Include the extension in the default expression name when adding an expression.

Edit menu

Item Detail
Restore parameters to default values  Reset parameters to default values.
Stopping Motion  Stops the motion being played.
Difference Comparison  Information from two moc3 data can be compared and checked on the Viewer.
See “Comparing Two MOC3 Data Information” for details.

Show Menu

Item Detail
Display of hit decisions  Displays the set hit decision.
Enable Mipmap  Enable mipmap.
* Basically, we recommend that you check the box
Background transparency (beta)  Displays the model with a transparent background.
Background color setting  Sets the background color.
Frame rate display  The frame rate is displayed in the upper right corner of the model display area.

Animation Menu

Item Detail
Enable facial expressions  Enables playback of motion for facial expressions.
Automatic eye crack  Make it blink automatically.
Enable Physics  Enable physics settings.
Enable Pose Switching  Enable Pose Switching.
Idle motion  Enables idling motion.
Cursor tracking  Enables cursor tracking on the model display area.
Breath  Enable breathing.
Use the old motion playback method Enable the old motion playback method. 
The [Use Old Motion Playback Method] checkbox in the lower right corner of the model display area is checked.
For a detailed explanation, please refer to the page “When motion3.json reproducibility deteriorates”.
Cursor tracking settings Opens a dialog box for cursor tracking settings.

 

 

About Cubism Viewer (for OW) Features

Cursor tracking settings

Check [Animation] menu -> [Follow Cursor] and drag on the view to move the model following the mouse cursor.
You can also set the parameters you wish to follow in the [Animation] menu -> [Cursor Tracking Settings], which allows you to simulate the actual device.

Impact (%):
The degree of influence can be set to affect the movement of the parameter.
A stronger setting will result in a larger movement, while a weaker setting will result in a smaller movement.

Reflect: The cursor tracking is inverted.

Type:
Set the type of parameter you want the cursor to follow.
• In the case of left mouse dragging
(Left mouse X: horizontal movement, Left mouse Y: vertical movement)

• In the case of right mouse dragging
(Right mouse X: horizontal movement, Left mouse Y: vertical movement)

Cursor tracking settings are saved in the model data (cmo3) but are not exported to the embedded data.
If you want the cursor to follow when embedding, configure the settings on the SDK side.

* Cursor tracking settings can also be checked in [Physics and Scene Blend Settings].

 

Image confirmation of curve curves

Select motion3.json, right-click, and then click “View Motion Changes in Image” to view the curve in an image.

 

 

List of drawing order and number of polygons (ArtMesh) information

You can check information such as the order in which ArtMeshes are drawn and the number of polygons.
Click on a moc3 file in the tree -> Select “ArtMesh” from the pull-down menu

The selected ArtMesh blinks blue in the view.

 

 

Display of motion curve type

The motion inspector in the [OW Viewer] now displays the target version inferred from the information contained in the motion.

If you are using “SDK (Others)” in the target version, please consult with the developer and consider whether to check the box.
For details, please refer to the SDK manual, “When the reproducibility of motion3.json is degraded”.

The notation on the inspector will be as follows:

Use the old motion playback method

Prior to 4.1, Cubism Viewer (for OW) reproduced any motion file with the same curves as the animation in the Cubism editor.
In Cubism Viewer (for OW) from 4.1 alpha1 to alpha3, motion will be reproduced with the curves reproduced by the SDK.
Also, in Cubism Viewer (for OW) after 4.1 alpha4, the curve reproduction state can be controlled by checking “Use old motion playback method”.

With the “Use old motion playback method” checked, the motion is played back with the Bezier curve motion with the Bezier handle fixed at 1/3 or 2/3.

If you are using the SDK (Others) in the target version, please consult with the developer and consider whether to check the box.
For details, please refer to the page “Degradation of motion3.json reproducibility” in the [Cubism SDK Manual].

 

Waveform Comparison

Cs that are played back with unsupported SDKs are now displayed in light blue in the curve check function for motions exported with [SDK (Others)].

 

Comparison of two moc3 data information

Two moc3 data information can be compared and checked on the Viewer.

The confirmation procedure is as follows:

  1. Drag and drop the two data you want to compare into the Viewer
  2. [Edit] menu -> [Compare Difference]
  3. A confirmation dialog box appears

 

(1) File Information

The name of the file you want to compare, the date/time the file was created, and the location of the file will be displayed.

 

(2) Categories and detailed items

Canvas:

Comparative information on the canvas will be displayed.

Part:

Comparative information on parts will be displayed.

Parameter:

Min, Default, and Max values are compared and displayed for each ID.

ArtMesh:

Information on the following items for each ID is displayed for comparison.

1. Blend mode
2. Culling
3. Texture number
4. Draw order
5. Rendering sequence
6. Mask
7. Number of vertices
8. Polygon count

 

Changes from Cubism2.1 Viewer (for OW)

The following changes are made in Cubism 2.1 and 3 or later.

 

 

Motion setting

  Changes Cubism2.1 Viewer (for OW) Cubism Viewer ( for OW ) 
1 Motion file name .mtn .motion3.json
2 Change of description in the file (general)   Change all key elements to leading uppercase
'type' -> 'Type', etc.
3 Group

 idle

Automatically identified and marked as “idle” in the group

 Idle

[Notes]
Must be set to idle by clicking on the “Idle” button to the right of the group name.

(Group names start with a capital letter)

4 Automatic eye crack motion set mult

 

Pose setting

  Changes Cubism2.1 Viewer (for OW) Cubism Viewer ( for OW )
1 Pose file name .pose.json .pose3.json
2 Change of description in the file (general)   Change all key elements to leading uppercase
'type' -> 'Type', etc.
3 Structure

'parts_visible'

Example of structural modification:
'parts_visible' : [ { 'group' : [group settings] } ,{ 'group' : [group settings] } ]

'Groups'

Example of structural modification:
'Groups' : [ [ group settings ], [ group settings ] ]

 

Facial Expression Setting

  Changes Cubism2.1 Viewer (for OW) Cubism Viewer ( for OW )
1 Expression File Name .exp.json .exp3.json
* Default expression name without extension (*1)
(e.g.) File name: abc.exp3.json -> Default expression name: abc
2 Change of description in the file (general)   Change all key elements to leading uppercase
'type' -> 'Type', etc.
3 Change the description in the file fade_in /out FadeIn , FadeOut
4 Change the description in the file 'params' 'Parameters'
5 Change the description in the file 'calc'
'add'
'mult'
Add is omitted in 'set'2.1
'Blend'
'Add'
'Multiply'
Not omitted in 'Overwrite' 3.x
5 Change the description in the file

'val'

2.1 had a value for expression (e.g., 1.2 if the eyes are wide open)

'Value'

In 3.x, change to have values that are added and multiplied (+0.2 if you want to open your eyes)

*1 Even if moc3/model3.json exported with the previous specification is read by OWViewer after the change, the expression names already set will not change.
The above modified specifications will be applied when loading a new motion for facial expressions.
It is also possible to make the Viewer work with the previous specifications by checking the [File] menu -> [Setting] -> [Add extension to default expression name].
This setting is saved as a Viewer setting.

 

Model file

  Changes 2.1Viewer Viewer ( Original Workflow ) 
1 File name of the model file .model.json .model3.json
2 Change of description in the file (general)   Change all key elements to leading uppercase
'type' -> 'Type', etc.
3 Hit judgment ID naming convention:
D_REF.
ID naming convention:
HitArea Add HitArea item:
For the time being, we will not export from the editor, but will use the viewer to find 'HitArea**', display it in the list, and set the name. (Export model3.json from the Viewer)

 

Blink and lip-sync motion burn-in

Motion set in “Eye blinking” and “Lip-sync” can be baked into Live2D parameters when exporting motion.
Since “Scale” and “effect” data are not exported to motion3.json, this feature can be used to completely reproduce the motion of an animation in the Viewer.

Note, however, that motion3.json must be written out again if adjustments are necessary.
* When using OWViewer, the motion burn-in function for blinking and lip-sync is recommended.


When setting motion data, check the “Burn Lip Sync and Blink into Motion” checkbox.
Motion burn-in method:

 

If this item is enabled, “Lip-sync” and “Eye blinking” will not be exported to motion3.json separately, so the items will be grayed out.

 

If you click “OK” in this state, on the parameters checked in the blink and lip-sync settings,
it is burned as a keyframe and output as motion3.json.

If a keyframe is set for the parameter to which the “Eye blinking” or “Lip-sync” function is applied,
the curves for the above effects are calculated (multiplied for blinking, added for lip-sync) to the parameter.

 

Statistics

You can check the statistics of the moc3 file.
Click on the moc3 file name -> Select “Statistics” from the pull-down menu to display the target version and other information.

© 2010 - 2022 Live2D Inc.