Model loading and placement

(Updated 06/10/2021)

To create an animation, a model must be placed in the scene.
This section describes:

  • Animation File Creation Procedure
  • Scene Creation Procedure
  • Model Placement Procedure
  • Reloading and replacing models

See the tutorial video “Creating Animations” for basic instructions on how to use the Animation Workspace.


Create a new animation file

First, let's create an animation file.

  1. Launch Cubism Editor.
  2. Click on the [File] menu -> [New] -> [Animation].

An animation file containing one new scene has been created.

You can also create animation files by switching to the [Animation Workspace] and dragging and dropping models onto the [Timeline] palette.


Create new scene

When an animation file is created, a scene called “Scene1” is automatically created.
Settings such as scene name, size, length, and frame rate can be set and edited in the [Inspector] palette.

For more information, see the “Scene Management and Settings” page.


Adding Scenes

To add a new scene, click the [Create new scene] button in the [Scene] palette.

You can enter a [Scene name] and [Tag] at the time of creation, but you can edit them later in the [Inspector] palette in the same way as above.


Loading model files

Drag and drop models onto the [Timeline] palette to place them on the view.

Model data created with Cubism 2.1 can also be placed.


Reloading model files

If changes are made to the model during animation creation, follow the steps below to [Reload data] to reflect the model changes.

  1. Overwrites and saves the model with changes made in the [Model Workspace].
  2. Switch to the [Animation Workspace] and click to expand the animation data in the [Project] palette.
  3. Right-click on the placed model name and execute [Reload data] to reflect the changes.

Note that if the model is changed first and the animation data is opened later, there is no need to reload the model.



Replacing model files

If you want to replace the model saved under a different name or with a different model, click [Replace Data].

If the parameter IDs or ranges are different between the model before and after the replacement, the movement may be incorrect.
Note that even if the same parameters are used, the pose, facial expression, and display state of the parts may change depending on the creation of the parameters.


To replace the model in all scenes

  1. In the [Animation Workspace], click to expand the animation data in the [Project] palette.
  2. Right-click on the name of the model you wish to change and click on [Replace Data] to open the Explorer.
  3. Select the model to be replaced and click [ Open ] to apply the replacement.

To change the model only for a specific scene

  1. Select the [Scene name] you wish to replace the model with and display it in the view, then click on the track of the model you wish to replace or on the view to select the model.
  2. Click [Animation] menu -> [Material] -> [Replace Selected Model] to open the Explorer.
  3. Select the model to be replaced and click [ Open ] to apply the replacement.


How to handle the material to maintain links to the material

If you are using materials such as model files, voices, background images, etc., and if the relative paths between the animation file and the material files are not changed,
the link will not be broken the next time the animation file is imported, even if it is moved to another drive or PC.
If you change the relative path of an animation file or material by moving it to a different folder, the link may be broken, and
the animation file will need to be linked as follows when importing animation files.



Note when the link to the material is broken

Animation files may contain external links to materials such as audio or background images.
External links are managed by absolute paths, so the [Inspector] palette displays the paths in your own environment.

However, if you pass the data to someone else, your absolute path information is stored in the material's link, so if the material is broken, the path will be visible to others.
If you are concerned about the display of absolute paths when links are broken, check the “Do not display absolute paths when links are broken” checkbox in the [Inspector] palette.

Once the Do not show absolute path is checked, it will not be unchecked until the broken link is fixed.
If you want to display again with absolute paths, fix the broken links once and uncheck the box.
(If you fix a broken link in your environment, it will be rewritten to the absolute path of your environment.)


Importing data created with Cubism 2.1

Placement of model data created with Cubism 2.1

Model data created in Cubism 2.1 can be used in Cubism 3.
Create animation data and drag & drop the model data (.cmox) created in Cubism 2.1 into the [Animation View] or [Timeline] palette.


Importing animation data created with Cubism 2.1

Animation data created in Cubism 2.1 can be used in Cubism 3 without modification.

To proceed, select [Open] from the [File] menu and select the animation data (.canx) created in Cubism 2.1.
Or drag & drop the animation data into the [Timeline] palette.

When saving the file, it will be saved in Cubism 3 specification (.can3 format).

If you create an animation using a model (.cmox) created with Cubism3 and make changes to the model during the process, the model will be saved in the Cubism3 specification (.cmo3).
Therefore, even models with the same name are treated as different files, so when returning to animation work, the model must be replaced rather than reloaded.


When importing Cubism2-based animation files from [3.0.00] to [3.0.16],
there was a problem with the model track opacity settings not being reproduced.
(The reason is that the opacity was changed to a new calculation method from Cubism3.)

Therefore, when a Cubism2 series model is imported into Cubism3, a confirmation dialog box will appear if an inconsistency is found in the overall opacity of the model track.
There are two ways to convert the opacity settings of animation files created with Cubism2 series to Cubism3.

[Select OK in the confirmation dialog box]

If you choose OK, the preview content set on the timeline in the current Cubism3 will be retained.

[Select Cancel in the confirmation dialog box]

If Cancel is selected, the opacity display of the model track is adjusted to the Cubism2 series animation file.
If you had reconfigured the settings in the current Cubism3, they may be different from what you previewed.

This confirmation dialog is for files imported from Cubism2 series to Cubism3.0.00 to 3.0.16.
Models newly created from Cubism 3 or imported from Cubism 2 series to Cubism 3.1 or later versions will not have any inconsistency problems.

© 2010 - 2022 Live2D Inc.