Automatic Mesh generator

Updated: 05/13/2021

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

There are two types of mesh editing: “Auto Generation,” which can be generated automatically by simply specifying values related to the density of points, and “Edit manually,” in which points can be edited by hitting them one by one.
On this page you will learn how to automatically generate an ArtMesh.

For more information on manual editing, see the “Edit Mesh Manually page.

Automatic Mesh generator

First, we will explain the simplest procedure for generating a finer mesh starting in the state immediately after PSD import.
Press Ctrl + A to select all ArtMeshes.

Click on [Automatic Mesh generator] on the toolbar.

The [Automatic Mesh generator] dialog box will appear. First confirm the default settings.
Click on the text box portion (anywhere) in [Setting] and press Enter.

A mesh has been created with the set values.


To allow you to select one ArtMesh after another and apply the desired values in the dialog box, the dialog box does not close automatically and remains in the foreground.

It can be moved as needed or closed with the X in the upper right corner.

Automatic mesh generation can be applied to an individual ArtMesh alone.
Furthermore, the shape of the mesh can be changed after application, allowing adjustment until the desired shape is achieved.
Note: Auto generation is not recommended because the shape will change after the parameters are set.

[Automatic Mesh generator] Dialog Box

You can save the values in [Setting] in the dialog box as a preset.

Combo boxThe name of the preset you created will be displayed.
AddAdd the current value to the preset. Click to open a dialog box to enter a name, and after entering the name, click [OK] to save the file.
DeleteDelete the preset selected in the combo box.
OverwriteClicking [Overwrite] after changing the value of the current preset will overwrite it with that value.
[>] buttonOther menus will be displayed. Click [Open Settings] to open the folder where the preset data (xml format) is saved.


Dot interval (pixels)Specifies the interval at which vertices are created. If 50 is specified, it will create one vertex in an area of roughly 50 x 50 pixels. (Images from left to right, with larger and smaller interval)
Boundary margin (outside)Specifies the average margin between the opaque pixel (the area with the picture) and the surrounding mesh.*1
Boundary margin (inside)Specifies the average distance from the boundary of an opaque pixel (the area with the picture) to the inner mesh surrounding it.*1
Minimum margin of boundaryIf the opaque pixels and the mesh are close to each other, such as at a corner, add a point so that the [Boundary margin] specified above can be maintained.*1
(Image shows comparison of large and small values)
Minimum number of points of boundarySpecifies the minimum number of points that enclose a single region. In the case of 3, a triangle consisting of 3 points is the shape of the least case. In the case of 4, a quadrangle consisting of 4 points is the shape of the least case.
Alpha value to be considered transparentSpecifies the alpha value (transparency from 0 to 255, where 0 is transparent) at which the texture is considered transparent. Increase the value if you do not want to capture near-transparent dust, etc. Usually 0 is fine.

*1 The specified value is expressed in terms of pixels when the texture size is 1024. If 10 is set and the number of pixels is 2048, the margin is actually 20.

Default setting values for automatic mesh generator

The default setting values for the automatic mesh generator are shown in the figure below.

StandardDeformation (small)Deformation (large)

What to do if the automatic mesh generator does not work

If the automatic mesh generator does not result in a well-formed division, such as if there are missing meshes, there may be unnecessary translucent areas left in the PSD.
(e.g., dust left over from the creation of the illustration)

The figure below shows the unnecessary translucent areas left in the PSD for easy viewing.

In such cases, gradually increase the “alpha value to be considered transparent” from 0 and adjust the mesh division a little at a time.

In this example, the “alpha value to be considered transparent” is set to 10.
Of the opacity from 0 to 255, the area where the opacity is up to 10 will be considered transparent.

In this way, unwanted dust areas can be excluded from the calculation, resulting in a well-formed mesh shape.

What to do when the texture display disappears after automatic mesh generation

The automatic mesh generator may cause the texture display to disappear when there are meshes that are not closed.
In this case, the texture display can be restored by changing the value and automatically generating the mesh again, or by canceling the automatic generation with Undo.
Please note that if you change the keyform and then perform automatic mesh generation, the deformation may be reset to its original shape.

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