Creating/Exporting Model Templates
Updated: 06/25/2024
This page describes how to create a model template and export it from the editor.
By setting “adjustment parameters” on a template model, you can adjust the position and size more precisely.
Adjustment parameters are only used to adjust the position and size during layout, so they are automatically deleted after the template is applied.
For an explanation of the basic functionality, see “About model templates“.
Create a model for your template
Adjustment parameters can be created by adding a half-width “@” to the beginning of the template model’s parameter ID.
The adjustment parameters basically use the blend shape parameters.
By using blend shape parameters, you no longer need to worry about parameter multiplication, and it is possible to link multiple adjustment parameters to a specific deformer.
Official template model parameter names have “@” added to them to make them easier to distinguish during layout. (It is not necessary to include “@” in the name.)
Let’s create our own model using the official template as a reference.
Display in model template selection dialog
The model you want to use for your template can be exported as a model template information file (.template.json).
The exported model template will then be placed in a specific folder and can be displayed in the model template selection dialog.
Prepare a template model
When you export a template, the entire model is included.
If you want to cut out part of an existing model to use as a template, copy the objects you want and paste them into the new model file.
This makes it easy to create models for each part.
Export as a model template
Exports the model being edited in the modeling view as a [Model Template].
Select the [Modeling] menu → [Model Templates] → [Export Template…] to open the [Export Template] dialog.
After entering each item, press OK and the Model Template will be written out.
name:
This is the name that will be displayed in the Model Template Selection.
image:
This is the image that will be displayed as a thumbnail in [Select Model Template].
GIF, PNG, and JPG can be used.
If you want to maintain the aspect ratio, we recommend creating a square image.
If you export with this field left blank, a still image of the entire model will be automatically set as “thumbnail.png”.
Attachments:
These are the files that appear in the clip menu in [Select Model Template].
Click an item in the menu to duplicate that file.
The exported model template can then be selected from the Model Template Selection dialog.
Model template information (JSON)
This file contains information for displaying the model templates in the Model Template Selection.
The model template information is represented in JSON format and consists of the following eight properties:
| Number | Properties | Description |
|---|---|---|
| 1 | FormatVersion | A number that indicates the format of the model template information. |
| 2 | ModelVersion | The number for the model in the model template. |
| 3 | Name | The Name of the model template. |
| 4 | BaseModel | This is a model template CMO3 file. |
| 5 | Thumbnai | This is the image of the model template. |
| 6 | Description | The description of the model template. |
| 7 | Author | The author of the model template. |
| 8 | AttachmentFiles | This is the Attachment for the model template. |
About Legacy Model Templates
Template models used in versions prior to Cubism 5.1 can be downloaded as legacy model templates from the link below.
By placing them in a specific folder, they can be displayed in the [Model Template Selection] dialog.
Download the Legacy Model Template
In the Select Model Template dialog, click the Edit menu and then Open Model Template Folder to open the save location.
Unzip the downloaded legacy model template and place it in the save location.
Close the Model Template Selection dialog and then reopen it to display the model.
