Edit Texture Atlas

(Updated 06/16/2022)

A texture atlas is an image of the parts that make up a character, etc., arranged on a plane.
In [Edit Texture Atlas], you can add or delete textures, resize individual parts, etc.


Texture Atlas Basic Operation

Click the [Edit Texture Atlas] button on the toolbar.

The [New Texture Atlas Settings] dialog box appears.

The [New Textured Atlas Settings] dialog allows you to configure the following settings.

Name Details
Texture Name  You can enter any name you wish. 
 Width You can choose the width of the texture size.
 Height You can choose the texture size height.
 Initial arrangement

Image for model in display state:
Only ArtMesh that are visible in the [Part] palette will be placed in the atlas.

Images for all models:
Place all ArtMeshes on the [Part] palette into the atlas, regardless of their visibility.

No placement:
No ArtMesh is placed, creating an empty texture atlas.

 Automatic layout setting

ArtMesh placement is automatically done according to texture size.
This button opens a dialog box for settings at the time of placement.

Details are explained in the “About Automatic Layout” section within this page.

Enter each item and click [OK]. The [Edit Texture Atlas] dialog box opens.

The width and height of each texture size can be changed, but depending on the SDK platform and environment at the time of embedding,
there may be cases where only squares are supported, so please consult with the developer before setting up the texture size.


About the Edit Texture Atlas Dialog

The following is a detailed description of each feature of the [Edit Texture Atlas] dialog.

Number Name Details
(1) Menu

Various menus are displayed.
File Edit Show Texture Scale Setting

Details are explained in the “Menu Bar Details” section of this page.

(2) Texture Details

You can display texture size and change the position, angle, and magnification of the currently selected object.
If the [Lock Angle and Magnification] checkbox is checked, the angle and magnification cannot be edited.

(3) Automatic Layout Automatically changes the placement and magnification of each object.
(4) Margin Adjust the spacing at which each object is placed.
(5) Texture addition Add texture.
(6) Texture deletion Delete texture.
(7) Texture List

List of textures currently being created.
Selecting toggles the texture to be edited.

Texture renaming: Right-click on the tab in the red frame => Rename texture

Texture name Pop-up:
Hover over the tabs in the red frame area to see the texture name.

Tabbed movement of textures:
The order of textures can be rearranged by dragging and dropping tabs.

(8) Texture

Textures are displayed. You can also select an ArtMesh directly from here and adjust it manually.

More information is provided in the “Manual Layout” section within this page.

(9) Image List for Models

Use the pull-down menu to switch between textures that are placed or not placed in the texture atlas.

Displays all textures.

Placed only:
Only textures placed in the texture atlas are displayed.

Unplaced only:
Only textures not placed in the texture atlas will be displayed.

Only visible and unplaced:
Only textures that are not placed in the texture atlas are displayed in the display state.

Already placed in the model and only in the selected state:
Only textures that have already been placed on the model and selected in the texture atlas will be displayed.

Details are explained in the “Model Image Listing Details” section on this page.

(10) Display Options It changes the background color, zooms in and out of the screen, displays the entire texture, displays it with respect to the center, displays it in full size, and displays the pointer's current position.

Starting with the 3.0.16 version, the width and height of the texture atlas size can be changed.
However, when resizing, you need to make sure that the SDK is supported on your platform,
so it is basically recommended that the width and height be the same size.

Texture atlas size (4096 x 4096px) Texture atlas size (4096 x 2048px)


If you open the [Edit Texture Atlas] dialog with only one art mesh selected on the canvas,
the dialog will open with its associated texture selected.


Menu bar details

Name Description

Lock Texture (beta): Used for exporting and replacing textures in PNG files. (cmox files are locked by default)

Export Texture Image (beta): Export the texture as an image.
Texture image replacement (beta): Replaces PNG files.

Edit Undo: Returns to the original by one step.
Redo: go one step further.
Select All:
Selects all placed textures.
display Show original texture: Checking the box allows you to move or scale an object to keep it in the same state as it was before the change.

Texture additions: Add texture.
Texture deletion: Delete texture.
Texture resizing: Resizes the current texture.
Auto Layout: Automatically changes the placement and magnification of each object.
Initialize data for Atlas: Restores changes to each object to its initial state.
Texture generation method: Basically, select “High Quality”.

If texture scaling or rotation causes degradation of texture edges, etc., make sure that the “High Quality” checkbox is checked for the texture generation method.
If “Low Quality” is checked, switching to “High Quality” will improve the deterioration.

Magnification setting

Specifies the magnification of the selected object.

In Cubism2, a texture atlas was created when the model was created, but
in Cubism3, it will be created in the final stage when it is incorporated into the SDK.
Therefore, there is no need to be aware of the atlas when using it in motion picture productions.


Model Image List Details

The [Model Guide Image List] allows you to view and edit images that have been placed or not placed in the texture atlas.

How to exclude placed images

Select art meshes on the texture that are not needed for export and press the [Backspace] key or the [Delete] key to exclude them.
Excluded ArtMesh can be viewed by toggling the Model Image List to [Unplaced Only] or  [Visible and Unplaced Only].


How to place unplaced images

If you selected [Model Guide Image as Displayed] or [Do not place] when creating the Texture Atlas,
the ArtMesh is excluded from the texture and enters the [Not Placed Only] and [Visible and Not Placed Only] lists.

To place an unplaced ArtMesh on a texture, double-click the ArtMesh you wish to place from the list.
Or right-click on the ArtMesh you wish to place and execute [Place selected elements in texture atlas].

If additional parts are loaded after the texture atlas is created, the ArtMesh will still appear in the [Unplaced Only], [Visible and Unplaced Only] list.



About Automatic Layout

The imported texture automatically sets the layout of each PSD layer so that it fits neatly within the texture area.

There are several ways to open the auto-layout settings.


Create new texture atlas:

Click the [Perform Automatic Layout] button at the bottom of the [New Textured Atlas Settings] dialog that appears when you first create the textured atlas.


Editing an existing texture atlas:

In the [Edit Texture Atlas] window, make a selection of the texture you wish to set and click the [Auto Layout] button.



Automatic layout setting


Auto-layout allows for fixed magnification, rotation, and placement of non-overlapping meshes.
This setting can be specified when creating a new texture atlas as well as when auto-laying out an existing texture atlas.






Interval at which objects are placed
Possible setting range is 0 to 50px


Allocation criteria

Select portions so that they do not overlap when placing

Mesh: Arrange meshes so that they do not overlap
Model Guide Image: Arrange images for models so that they do not overlap.



Magnification of object (*1)

Set automatically: Automatically set the magnification so that all objects can be placed
User designation: Placed at the specified magnification (the portion that cannot be placed is not placed) The range that can be set is 1 to 100%.


Allow rotation

Allow it to rotate and position itself to fit in the gap

*1 Objects that do not fit into the target texture atlas will be returned to the image list for the model when the magnification is fixed and auto-layout is performed.


[Auto Layout] lays out the ArtMesh at the appropriate magnification for the size of the texture.
Therefore, if the texture size is small, the magnification may not be 100% for all ArtMeshes.

In such a case, select [Texture] menu > [Resize Texture], set a larger texture size, and execute auto-layout again.
Or select [Texture] menu -> [Add Texture] to add a texture,
move any ArtMesh that did not fit in the first texture to a new texture, then run auto-layout again.

See the “Move Art Mesh to Another Texture” item in the “Manual Layout” section below for instructions on how to move the ArtMesh to a new texture.


About manual layout

The following manual adjustments can be made to the ArtMesh placed in the atlas.

Moving the ArtMesh

After placement on the texture, if ArtMesh overlap each other or extend beyond the texture, move the ArtMesh manually.
Layout is done in the available space so that there is no overlap with the surrounding ArtMesh.

If ArtMeshes overlap or extend beyond each other, they will look wrong on the model, as shown in the figure below.

Texture atlas placement Appearance on the model


In such cases, the following steps can be taken to fix the problem.

Click to select the part to be moved, then drag and drop it to a position where the ArtMeshes do not overlap each other and do not protrude from the texture.
When you select an ArtMesh, a bounding box appears, allowing you to scale, rotate, and move it.

Unlike normal editing, zooming in and out maintains the aspect ratio without pressing the [Shift] key, but the [Scale] changes.
Therefore, please be careful when scaling up or down, as this may affect the appearance of the image when exported.




Move “ArtMesh” to another texture

To move an “ArtMesh” between multiple textures, first select the “ArtMesh” to be moved.

Next, select the destination texture. After moving to the desired texture, deselect it.

“ArtMesh” can also be moved by removing it from the texture, selecting the destination texture, and placing the “ArtMesh” on it.


Change the magnification

Select the ArtMesh for which you want to set the magnification and enter the [Scale].

Magnification can be set for each ArtMesh, and [Scale] can also be set with multiple ArtMeshes selected.

Magnification 10% Magnification 100% Image display for models (toggle by [T] key)

If the magnification is less than 100%, the resolution of the exported model will be reduced. However, the size and number of textures can be reduced by deliberately reducing the magnification in areas that are not visible.
To see the state of the model exported from the texture atlas, press the [T] key in the canvas view to switch to the [Texture Atlas View].


If you are editing a mesh after creating a texture atlas,
it may overlap the surrounding ArtMeshes or extend beyond the texture atlas.

After the texture atlas is finished, you can edit the mesh by changing the [Mesh Edit mode] display to [Atlas View].
You can make adjustments while checking to make sure that the mesh does not overlap with other ArtMeshes or extend beyond the texture atlas.



Add and resize texture atlas

If the area of the texture is not enough, use [Add Texture] or [Resize Texture].


Addition of Texture Atlas

To add a texture, click on the [Texture] menu, then [Add Texture].
When the [New Texture Atlas Settings] dialog box opens, enter the [Texture Name], [Width], and [Height], then click [OK].



Texture resizing

To resize the texture, click on the [Texture] menu, then [Resize Texture].
Enter the [Width] and [Height] and click [OK].



Delete Texture

If the texture is no longer needed, [Delete Texture] is performed.
At this time, [Delete Texture] cannot be performed on the texture where the ArtMesh is placed.

First, display the texture you wish to delete, select all ArtMeshes using [Ctrl] + [A] keys, and then use [Backspace] or [Delete] keys to exclude them.
Next, click on the [Texture] menu, then [Delete Texture].

If there is only one texture atlas, [Delete Texture] cannot be executed.
If you wish to delete (initialize) the entire atlas, initialize the data for the atlas as described below.


Initialize data for Atlas

Initialize the texture atlas.
Click on the [Texture] menu, then [Initialize Data for Atlas].

Please note that this operation cannot be Undo or canceled.

When the [New Texture Atlas Settings] dialog box opens, enter the [Texture Name], [Width], and [Height], then click [OK].
If you do not need to recreate the atlas, click [Cancel].

© 2010 - 2022 Live2D Inc.