About Source Image and Model Guide Image

Updated: 08/19/2021

This page is for Cubism version 4.2 or earlier. Click here for the latest version.

Cubism divides imported PSD images into two levels of data structure, “Source Image” and “model guide image,” for use.
This section describes the basic structure and image definitions.

Basic Structure

Project palette

Model Name
|- Source image
| |- MyPsdFileA
|   |- MyLayerGroup1
|     |- MyLayerGroup1-1
|        |- MyLayer1
|       |- MyLayer2
|- Model guide image
|  |- MyPsdFileA …. Model guide image group name generated from source image MyPsdFileA
|    |- MyLayer1 …. Model guide image generated from MyLayer1
|    |- MyLayer2 …. Model guide image generated from MyLayer2

What is a Source Image?

The source image is data that preserves the layer hierarchy and layer information of the imported PSD image as much as possible in its original form.

Cubism only has layer information such as opacity and basic blend modes (normal, multiply, additive, etc.), but we plan to develop the layer information to include clipping masks, layer masks, etc. in the future.
Note: There are no plans to support layering effects.

What is a Model Guide Image?

The model guide image is an image in which each layer of the “Source Image” is converted into simple data that can be used in the actual model data.
In model guide images, each layer of the PSD source image is held as flat data with no hierarchy.

In Cubism 3 and later versions, each ArtMesh is defined by mapping it to a model guide image, not to a source image.
Model guide images are usually generated from the layer of a source image and thus retain their relationship to the original layer.

In addition, each model guide image is typically placed at the same coordinates as the PSD layer of the source image from which it was generated.
In Cubism 3 and later versions, the shape of the ArtMesh can be restored using that placement information.

Re-import PSD Files

This section describes the relationship between the source image and the model guide image when a model is created using the PSD file MyPsdFileA and then replaced with MyPsdFileB (which is a modified version of MyPsdFileA).
If MyPsdFileB is re-imported, the source image will be two files, MyPsdFileA and MyPsdFileB, as shown below.

Model Name
|- Source image
| |- MyPsdFileA … The source image that was imported first
| |- MyLayerGroup1
| |- MyLayer1
| |- MyLayer2
|
| |- MyPsdFileB … Re-imported source image
| |- MyLayerGroup1
| |- MyLayer1
|   |- MyLayer2_2 … Layer with modified contents of MyLayer2
|   |- MyLayer3 … Newly created layer
|
|- Model guide image
| |- MyPsdFileA … Model guide image group name generated from source image MyPsdFileA
|   |- MyLayer1 … Model guide image generated from MyLayer1
|   |- MyLayer2 … Model guide image generated from MyLayer2
|   |- MyLayer3 … Model guide image generated from MyLayer3

Edit the Source Image

The project palette is structured as follows:

Project palette
|- Source image (List)
|  |- Source image … (1)
| |- Source image group name 1
|   |- Source image group name 1-1
|     |- Source image layer 1 … (2)
|       |- Source image layer 2
|       |- Source image layer 3
|   |- Source image group name 1-2
|     |- Source image group name 1-3

(1) Editing source images

Right-click menu

Select related model imagesSelect the “Model Guide Image” associated with the currently selected source image.
Switch to currentWhen multiple source images are loaded, the selected image is switched to the current one.
Export PSD (beta)Export the source image as a PSD.
Delete unused layersDelete unused source image layers, if any.
Delete empty layer groupDelete the empty layer group.
DeleteDelete a source image.
Note: At this time, it is possible to delete the source image, leaving only the object (model guide image) that uses the source image.

(2) Editing the source image layer

Right-click menu

Select related model imagesSelect the “Model Guide Image” associated with the currently selected source image.
Set as input image for the model guide image used in selected ArtMeshSet as the input image for the selected object.
It is also possible to reconnect with the model guide image.
Create model guide imageCreate a model guide image of the selected object.
The created model guide image will be placed at the bottom of the project palette.

Editing Model Guide Image

The project palette is structured as follows:

Project palette
|- Source image
|   |- Group name 1
|
|- Model guide image (List) … (1)
|   |- Model guide image group name 1 … (2)
|   |- Model guide image name 1-1 … (3)
|   |- Source image for model guide image 1
|   |- >Source image for model guide image 2 … (4)
|
|   |- Model guide image 1-2
|
|   |- Model guide image group name 2
|   |- Model guide image name 2-1
|   |- Model guide image name 2-2

(1) Editing model guide images

The Model guide image (List) is the parent of all model guide images (groups).

Right-click menu

Select the model guide images used in the selected ArtMeshThe model guide image used in the selected ArtMesh is selected.
Delete unused model guide imagesCheck whether the model guide image is used in the “ArtMesh” or “Texture Atlas,” and if not, delete it.
Delete empty groupsIf the model guide image group is empty, delete it.

(2) Editing model guide image groups

Right-click menu

Select related ArtMeshSelect all ArtMeshes that use model guide images in the group.
Delete unused model guide imagesCheck whether the model guide images in the group are used in the “ArtMesh” or “Texture Atlas,” and if not, delete them.
Disconnect from source images except in useFor each model guide image in a group, if it is connected to multiple source images, disconnect the one that is not currently set as the current source image (the model guide image for which > is not displayed in (4) in the above figure).
Delete groupsIf the model guide image group is empty, delete it.

Additional functions for inspector
When a model guide image group is selected, the group name is displayed in the [Inspector].
The group name can be changed in the [Inspector].

In addition, the Memo function can be used to keep track of related information.

(3) Model guide image

Model guide images refer to each image under the list, not to the list (1) itself.

Right-click menu

Select related ArtMeshSelect all ArtMeshes that use model guide images in the group.
Create ArtMeshCreate a new ArtMesh from the model guide image.
Set as input image for selected ArtMeshSet the model guide image as the input image for the object currently selected in the View.
Delete model guide images (in use)Check whether the model guide images in the group are used in the “ArtMesh” or “Texture Atlas,” and if not, delete them.
Disconnect from source images except in useFor each model guide image in a group, if it is connected to multiple source images, disconnect the one that is not currently set as the current source image (the model guide image for which > is not displayed in (4) in the above figure).
Remove improper connection of ArtMesh (beta)This can be used for recovery in case some bug has caused multiple model guide images to be associated with the ArtMesh.

Additional functions for inspector
When a model guide image is selected, the following information is displayed in the [Inspector].

Name The name of the model guide image is displayed.
ArtMesh count The number of selected model guide images that are actually used as ArtMeshes are displayed.
Texture atlas count The number of selected model guide images that have been placed as a texture atlas is displayed.
Memo Information can be preserved.
Images Thumbnails of [Model Guide Images] will be displayed.

(4) Source images for model guide images

Multiple source images for the model guide images are displayed when multiple source images are switched, such as after replacement, and the name of the source image name in the current state is prefixed with “>.”

Note: If there is only one source image, the “>” will not be attached.

Right-click menu

Switch to currentFor each model guide image in a group, if it is connected to multiple source images, disconnect the one that is not currently set as the current source image (the model guide image for which > is not displayed in (4) in the above figure).
Disconnect from source imageFor a model guide image, if it is connected to multiple source images, disconnect the one that is not currently set as the current source image (the model guide image for which > is not displayed in (4) in the above figure).

Different Usage of Source Images and Model Guide Images: Future Development

For future development

– To freely draw a picture (source image) by utilizing clipping masks, etc., and
– To synthesize the result and dynamically animate it as a simple texture (model guide image).

In order to achieve both of the above, we have a two-step structure: “source image” and “model guide image.”

Since Cubism 3 and later versions do not yet have the functionality to fully utilize this feature, it may seem like a wasteful structure, but please understand it is structured this way for future development.

Was this article helpful?
YesNo
Please let us know what you think about this article.