PSD TO 3D TECHNICAL DOCUMENTATION

1 How To Use The Global Parameters And The Regenerate Option

This section shows how to use the Global parameters and the Regenerate option.

1.1 Generate Texture

You can select the layer and click the buttom "Generate PNG(s)" located at the bottom.

  • Textures will be xported as PNG files in a folder created within the PSD source folder.

1.1 Generate Texture - PSD to 3D | e→d films

1.2 Alias and Regenerate

If you have already generated a mesh in your project and made modifications to your PSD, you can reload the PSD and select the layer for a regeneration of its geometry.

1.2.1 Context

  • During a generation, a root transform is created based on the PSD name.
  • All meshses are children of this root transform.
  • If a mesh under this transform exists, that mesh will be delieted and recreated based on the current data layer.

1.2.2 Alias

  • If your PSD has a different name than your original root transform, you can use the alias to specify the root transform name associated to your loaded PSD. The software checks if a mesh with the same name exists in its children and regenerate a mesh component.
  • The node geometry is removed and a new one is created; the history of this replacement operation is deleted.
  • The connection with the material and the shading group is preserved.

1.2.2 Alias - PSD to 3D | e→d films

1.2.3 Scale

The scale value allows to modify the size of the mesh generated.

  • The transform scale is not affected.
  • The scale is applied on the vertex position.
1.3 PSD Group Structure and Depth

In Photoshop you can create a group.

  • Nested groups are supported.
  • If the option to Keep Hierarchy is selected, groups are created in the form of a transform ....

1.3 PSD Group Structure and Depth - PSD to 3D | e→d films

So you can select a value for the PSD group structure:

  • Keep hierarchy will create a transform for each group, and parent the children meshes to them.
  • Flat Hierarchy will create a unique Transform based on the name of the PSD.
    • All mesh will attach parent to this transform.
  • Depth between layers
    • If "Flat Hierarchy" is selected, the z position of the mesh transform will increase by this value.
    • If "Keep Hierarchy" is selected, the z position of the group transform is increased by this value.

1.3 Depth with Hierarchy - PSD to 3D | e→d films

Mesh generation results in Maya
1.3 Mesh Generation in Maya - PSD to 3D | e→d films

1.4 Saved Parameters

All parameters set for a PSD are saved in a JSON file located in the folder bearing the name of the PSD.

When you reload a PSD, if a JSON file is found, all the parameters are automatically loaded.

2 How To Use The Influence Algorithm

This section shows ow to use the influence algorithm.

2.1 What It Does

When you generate a mesh

  • All the quads are the same for the linear algorithm.
  • The curve creates exactly what you draw for the Curve algorithm.

If you want to change the vertex positions of a mesh for a better modelling of the structure, you will need more polygons. To change the polygon resolution, you just ned to create a grayscale layer. This layer is used to decide if a quadrilateral polygon (quad) must be subdivided in smaller quads.

What we do:

  • We use the pixels grey level average to decide if a quad is subdivided or not.
  • The lighter a region is, the more quads are subdivided. The darker a region is, the less quads are subdivided.
2.2 In Photoshop

Create a new layer texture and draw on this layer the influence that you want.

2.2 In Photoshop - PSD to 3D | e→d films

The influence layer has the same name as the layer to influence, with "_influence" suffixed at the end of the name.

  • If the tag "_influence" is absent, the layer will be used as a normal texture layer.

2.2 Example of Influence Layer - PSD to 3D | e→d filmsThis is an example of an influence layer.

2.2 Influence Layer - PSD to 3D | e→d films

2.3 In Maya

Your influence layer is not added to the list of layer on the right.

But in the layer that thte effect is expected, you can see the information "Influence" is either "Active" or "Inactive". That means the influence layer is associated to the layer to influence.

At this point if you select the layer:
A new area appears on the left.
You can activate or disable the influence layer for the generation.
You can adjust the strength of the influence effect, clicking on "Generate" will create a mesh and subdivide the quads in the lighter areas. 

2.3 In Maya - PSD to 3D | e→d films

2.4 Results2.4 Results - PSD to 3D | e→d films

3 How to use the Curve Mask

This section shows how to use the Curve algorithm

3.1 Requirements in Photoshop

To use the curve mask algorithm you have to create a "Vector mask" on the layer.

3.1 Requirements in Photoshop - PSD to 3D | e→d films

Two components are important in the creation of paths"

  • Create a closed path to specify the limit of the mesh, all vectors outside this closed path will be ignored during the mesh generation.
    • Vectors included within a closed path are allowed. The closed path external edge is the limit used for the mesh generation.
  • Open or closed path can be used to create the intersection for the mesh generation.
  • You can overfill te closed path, everything outside will be removed for the generation.

3.1 Paths for Mesh Generation - PSD to 3D | e→d films

3.2 Recommendations

3.2.1 Connection

3.2.1 Connection - PSD to 3D | e→d filmsIf two vectors do not intersect, no vertex will be created during the generation.

3.2.2 Closed Path

3.2.2. Closed Path - PSD to 3D | e→d filmsThe part on the left is not influded according to the closed path in red. As a result, the part on the left won't be created during the mesh generation.

3.3 In Maya Plug-In

In Maya, you have to select a layer with a "curve (layer mask)" → "Available"

On the right section for "Generation algo" → "Vector layer"
You can change the parameter "Merge Vector Distance", however, the default value is usually the best.

Click on Generate on bottom.
3.3 In Maya Plug-In - PSD to 3D | e→d films

3.4 Results

3.4 Results - PSD to 3D | e→d filmsThe mesh in the orange box is the result based on the vector layer mask.

4 Linear Algorithm

This section shows how to use the linear algorithm.

4.1 First Step in Photoshop

The linear algorithm associates layers on left and paths on right in Photoshop.

Requirements:

  • A closed path must exist to use the linear algorithm on a layer.
  • The name of the Path must be the same as the associated layer.
  • The name of the layer and the path souldn't contain space characters.

4.1 First Step in photoshop - PSD to 3D | e→d filmsThere can be many closed paths in a layer path.

4.2 How To Create the Path?

There are 3 possibilities:

4.2.1 Create your own layer paths

  • Create a new path layer with the tool in Photoshop
  • Rename it like you layer texture.
  • Create one or more closed paths per layer.

4.2.2 Use the extension PsdExporter

  • Go in "Window" → "Extension", Select PsdExporter

4.2.2 Use the Extension PsdExporter - PSD to 3D | e→d films

  • A new window will open.

4.2.2 PsdExporter Window - PSD to 3D | e→d films

  • Expand of → specify the number of pixels to expand around the contour of the texture.
    • Create the closed path based on this contour selection.
  • Export the layers → export all the layer in different textures.
    • The best is to use this feature in the Maya plugin (it generates the PNGs faster)
  • Click on "Run ps Code" to export a copy of your PSD and create the Paths associated to each layer texture.

Attention: While the tool creates a copy of your PSD, all your PSD Paths will be removed to clean the path hierarchy to generate only the data you need.

4.2.3 Combine the 2 previous choices

  • First step use the export extension.
  • A new copy of your PSD has been created, with all the closed paths associated to the layer.
  • Edit the paths as you want before you import the PSD in the Maya plugin.
4.3 Import the PSD in Maya
  • Open Maya
  • Go to "Windows" → "Settings/Preferences" → "Plug-in Manager".

4.3 Load Plugin in Maya - PSD to 3D | e→d films

  • Load the plugin.

4.3 Maya Plugin Manager - PSD to 3D | e→d films

  • A new menu appears. Click on "PSD23D" → "psd Window".

4.3 PSD23D psd Window - PSD to 3D | e→d films

  • This Menu opens.

4.3 PSD23D Plugin Window - PSD to 3D | e→d films

  • Click on "Select" on top right.
  • A Dialog box appears and gives you the possibility to select a PSD.

4.3 Select PSD - PSD to 3D | e→d films

At this step the PSD is loaded. All the layers are extracted with all the information. For each layer you have the information about the useful data for the generation of a mesh.

  • Influence 3 states:
    • Not available → No influence laer texture detected.
    • Active → Layer detected and used for the generation.
    • Inactive → Layer detected and not used during the generation.
  • Linear (path) → Available if a closed path for linear generation is detected.
  • Curve (Layer mask) → Available is a vector mask is detected.
4.4 Linear Generation

Select a layer with the "Linear (path):" → Available
4.4 Linear Generation Available - PSD to 3D | e→d films

  • On the right panel selection in "generation algo" → "linear"
    • You can specify the number of polygons expected on the height of the generation.
    • You can set an angle to reorient the quads.
  • Click on "Generate 1 Mesh(es)" on bottom left.
4.5 Results
  1. The mesh in the orance box 1 is a mesh using the orientation.
  2. In the box 2, two different resolutions based on the height polygon.

4.5 Results - PSD to 3D | e→d films

4.6 Control Multilayer
  • All the layers on the left can be selected
  • The controls [ ctrl + A ], [ ctrl + shift + right click ] and [ ctrl + right click ] are supported
  • You can select several layers and change the parameters associated to all the layers
  • You can select several layers and only "generatet the mesh(es)" with the different parameters if you don't midify the parameters.
    4.6 Control Multilayer - PSD to 3D | e→d films
  • The panel on the right allows to batch edit the parameters of the selected layers.
  • The display shows only the first selected layer parameters.
  • The generation uses the parameters saved for each layer, the display is only used for edition.