Texture atlas editing

(Updated 2022/06/16)

A texture atlas is an image in which the parts that make up a character are arranged on a plane.
With [Edit texture atlas], you can add or delete textures and change the size of each part.


Basic operation of texture atlas

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

The [New Texture Atlas Settings] dialog is displayed.

The following settings can be made in the [New Texture Atlas Settings] dialog.

name Details
Texture name  You can enter any name. 
 width You can choose the width of the texture size.
 height You can choose the texture size height.
 Initial placement

Image for the model in the displayed state:
[[Part(s)] Displayed on the paletteArtmeshOnly placed in the atlas.

Images for all models:
[[Part(s)] On the paletteArtmeshAre all placed in the atlas, regardless of the display state.

Do not place:
ArtmeshIs not placed, creating an empty texture atlas.

 Automatic layout settings

ArtmeshThe placement of is done automatically according to the texture size.
By pressing this button, you can open the setting dialog at the time of placement.

For more information, see “About Auto Layout” on this page.

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

You can change the width and height of the texture size respectively, SDK Depending on the platform and embedded environment
Since it may not support other than square, please set it after consulting with the developer.


About the texture atlas edit dialog

The details of each function of the [Texture Atlas Edit] dialog are as follows.

number name Details

Various menus are displayed.
File edit display Texture scale setting

For more information, see "Menu Bar Details" on this page.

Texture details

Display texture size, currently selectedObjectYou can change the position, angle, and magnification of.
If you check [Lock Angle and Magnification], the angle and magnification cannot be edited.

Automatic layout each Object It automatically performs the layout and magnification change.
margin each Object Adjust the interval at which to place.
Texture addition Add a texture.
Delete texture Delete the texture.
List of textures

This is a list of currently created textures.
By selecting it, it switches the texture to be edited.

Rename texture: Right-click the tab in the red frame ⇒ rename the texture

Texture name popup:
Hover the tab in the red frame to display the texture name.

Texture tab movement:
You can change the order of textures by dragging and dropping tabs.


The texture is displayed. from here Artmesh You can also directly select and adjust manually.

For more information, see “About manual layout” on this page.

Image list for model

By switching from the pull-down menu, the textures that are placed or not placed in the texture atlas are displayed.

Shows all textures.

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

Not placed only:
Shows only textures that are not placed in the texture atlas.

Displayed and not placed only:
Shows only textures that are not placed in the texture atlas in the visible state.

Already placed in the model and selected only:
Shows only the textures that have been placed in the model and are selected in the texture atlas.

Details are described in "Detailed image list for model" on this page.

Display options Change the background color, enlarge / reduce the screen, display the whole texture, display based on the center, display in full scale, display the current position of the pointer.

From version 3.0.16 you can change the width and height of the size of the texture atlas.
However, When changing the size SDK Need to check if it is supported on So
Basically, we recommend that the width and height be the same size.

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


On canvasArtmeshIf you open the [Edit Texture Atlas] dialog with only one selected
A dialog opens with the associated texture selected.


Menu bar details

name Description

Lock Texture (β): It is used when exporting and replacing with PNG file. (The cmox file is locked by default)

Writing texture image (β): Write out the texture as an image.
Replacement of texture image (β): Replace the PNG file.

Edit Undo: Go back one step.
Redo: Go one step.
select all:
Select all placed textures.
Display Show original texture: When checked, Object You can still display the state before change even if you move, scaled, etc.

Add texture: Add a texture.
Delete texture: Delete the texture.
Change Texture Size: Change the size of the current texture.
Automatic layout: each Object It automatically performs the layout and magnification change.
Initialize data for atlas: each Object Change back to the initial state.
Texture generation method: Basically, please select "high quality".

If the edge of the texture is deteriorated due to the scaling or rotation of the texture, make sure that "High quality" of the texture generation method is checked.
If "Low quality" is checked, you can improve the deterioration by switching to "High quality".

Set scale

Selected Object Specify the magnification of.

In Cubism2, the texture atlas was created when the model was created.
From Cubism3, SDK It will be created at the final stage when it is incorporated into.
Therefore, it is not necessary to be aware of the atlas when using it in movie works.


Image list for model details

In the [Image list for model], you can check and edit the images that are placed or not placed in the texture atlas.

How to exclude placed images

Not needed for exportArtmeshOn the texture and press the Backspace or Delete key to remove it.
ExcludedArtmeshCan be confirmed by switching the model image list to [Unarranged only] [Displayed and unarranged only].


How to place an unplaced image

If you select [Display image for model] or [Do not place] when creating the texture atlas,
Artmesh Will be excluded from the texture and added to the [Unplaced only] [Visible and unplaced only] list.

Unplaced Artmesh If you want to place in the texture, you want to place from the list Artmesh Double-click.
Or want to place Artmesh Right-click and execute [Place Selected Element in Texture Atlas].

Add after creating texture atlas Part(s) Also when you read Artmesh Appears in the [Unplaced only] [Display state and unplaced only] list.



About automatic layout

The imported texture will automatically lay out each layer of the PSD so that it fits nicely within the texture range.

There are several ways to open the automatic layout settings.


Create a new texture atlas:

Click the Run Auto Layout button at the bottom of the New Texture Atlas Settings dialog that appears when you first create a texture atlas.


Editing an existing texture atlas:

Select the texture you want to set in the [Edit Texture Atlas] window and click the [Auto Layout] button.



Automatic layout settings


With automatic layout,You can fix the magnification, allow rotation, and set the meshes so that they do not overlap.
This setting can be specified not only when automatically laying out an existing texture atlas, but also when creating a new texture atlas.





ObjectInterval where
The settable range is 0 to 50px

Placement criteria

Select parts so that they do not overlap when arranging

mesh: Arrange the meshes so that they do not overlap
Image for model: Arrange the model images so that they do not overlap


ObjectMagnification (* 1)

Set automatically:All ofObjectAutomatically set the magnification so that can be placed
User specified: Arrange at the specified magnification (the part that cannot be arranged is not placed) The settable range is 1 to 100%

Allow rotation

Allow rotation to fit in the gap

* 1 When the magnification is fixed and the layout is automatic, it does not fit in the target texture atlas.ObjectWill be returned to the model image list.


[Auto Layout] is an appropriate scaling factor for the size of the texture. Artmesh Lay out.
Therefore, if the texture size is small, all Artmesh The magnification of may not be 100%.

In such a case, select [Texture] menu -> [Resize Texture], set a large texture size, and execute automatic layout again.
Or select [Texture] menu → [Add texture] to add a texture,
It didn't fit in the first texture Artmesh To a new texture and then run auto layout again.

On a new texture Artmesh For how to move, move to "Other textures" in the "Manual layout" item below. Artmesh See the "Move" item.


About manual layout

Placed in the atlas Artmesh For, you can make the following manual adjustments.

Artmesh Move

After placing it on the texture, Artmesh If they overlap each other or if they stick out of the texture, manually Artmesh To move.
Around Artmesh The layout is done in an empty space so that it does not overlap with.

Artmesh If they overlap or stick out, they will look strange on the model as shown below.

Placement of texture atlas Appearance on the model


If this happens, follow the procedure below.

Want to move Part(s) Click to select, drag and drop, Artmesh Move to a position where they don't overlap and stick to the texture.
Artmesh When is selected, a bounding box is displayed, and you can scale, rotate, and move it.

Unlike normal editing, scaling will maintain the aspect ratio without pressing the [Shift] key, but the [magnification] will change.
Therefore, it may affect the appearance at the time of export, so please perform the scaling carefully.




Move the "art mesh" to another texture.

If you want to move an "art mesh" between multiple textures, first select the "art mesh" you want to move.

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

"ArtmeshIs once excluded from the texture, select the texture to move to, and select ""ArtmeshYou can also move by placing "".


Change magnification

Set the magnification Artmesh Select and enter the [Magnification].

Magnification is Artmesh Can be set for each Artmesh It is also possible to set [Magnification] while selecting.

Magnification 10% Magnification 100% Image display for model (switch with [T] key)

If the magnification is 100% or less, the resolution of the exported model will decrease, but you can reduce the size and number of textures by intentionally lowering the invisible parts.
To check the state of the model exported from the texture atlas, press the [T] key in the canvas view and switch to [texture atlas display].


If you edit the mesh after creating the texture atlas,
Placed around Artmesh May overlap or stick out of the texture atlas.

If you want to edit the mesh after finishing the texture atlas, change the display of [Mesh edit mode] to [Atlas display].
other Artmesh You can make adjustments while checking whether or not they overlap with each other, or whether they are protruding from the texture atlas.



Add texture atlas and change size

If the texture area is not enough, click [Add texture] or [Resize texture].


Add texture atlas

To add a texture, click the [Texture] menu → [Add texture].
The [New Texture Atlas Settings] dialog opens. Enter [Texture Name], [Width] and [Height] and click [OK].



Resize texture

To change the texture size, click the [Texture] menu → [Resize Texture].
Enter [Width] and [Height], and click [OK].



Delete texture

If you no longer need the texture, click [Delete texture].
At this time, Artmesh [Delete texture] cannot be performed on the texture where is placed.

First, display the texture you want to delete and press [Ctrl] + [A] to select all Artmesh Select and remove it with the [Backspace] key or the [Delete] key.
Next, click the [Texture] menu → [Delete texture].

[Texture deletion] cannot be executed when there is only one texture atlas.
If you want to delete (initialize) all atlases, initialize the atlas data described later.


Initialize atlas data

Initializes the texture atlas.
Click the [Texture] menu → [Initialize Atlas Data].

Please note that this operation can not be undoed or canceled.

The [New Texture Atlas Settings] dialog opens. Enter [Texture Name], [Width] and [Height] and click [OK].
If you do not need to recreate your atlas, click Cancel.

© 2010 --2022 Live2D Inc.