|
42 | 42 | 5. **Asset source**: Assets from Khronos Sample Assets, Maya/Babylon exporter, or Blender/glTF 2.0 exporter typically work best |
43 | 43 |
|
44 | 44 | ??? question "Can I import animations from glTF/glb files?" |
45 | | - Yes! The plugin supports animation import including skeletal animations, transform-based animations, and morph targets. Configure your animation settings using the [Animation Settings](animation_settings.md) options before importing. You can also use the [Show Animation Clips](show_animation_clips.md) feature to manage multiple animation clips, which are automatically organized in Maya's Time Editor. |
| 45 | + Yes! The plugin supports animation import including skeletal animations, transform-based animations, and morph targets. Configure your animation settings using the [Animation Settings](animation_settings.md) options before importing. You can enable "Open Time Editor Window" to automatically open Maya's Time Editor after import for immediate access to animation clips. You can also use the [Show Animation Clips](show_animation_clips.md) feature to manage multiple animation clips, which are automatically organized in Maya's Time Editor. |
46 | 46 |
|
47 | 47 | ??? question "How do I handle material variants?" |
48 | 48 | Material variants are supported through the [Show Material Variants](show_material_variants.md) feature. This allows you to switch between different material configurations defined in your glTF file. |
|
54 | 54 |
|
55 | 55 | 1. **Shader type selection**: Choose the appropriate shader type in [Material Settings](material_settings.md) - Standard Surface (default), Arnold, OpenPBR (Maya 2025+), or Stingray |
56 | 56 | 2. **Shader limitations**: Note that Stingray only supports basic properties (BaseColor, ORM, Normal, Emissive), and OpenPBR may have rendering limitations with Arnold |
57 | | - 3. **Texture paths**: Ensure textures are properly linked |
58 | | - 4. **Maya's material system**: Some glTF material features may need manual adjustment |
59 | | - 5. **Lighting setup**: Your Maya scene lighting affects material appearance |
| 57 | + 3. **Ambient Occlusion**: Enable "Import Ambient Occlusion" in [Material Settings](material_settings.md) to import AO from ORM texture (R channel) and multiply with base color for added depth |
| 58 | + 4. **Texture paths**: Ensure textures are properly linked |
| 59 | + 5. **Maya's material system**: Some glTF material features may need manual adjustment |
| 60 | + 6. **Lighting setup**: Your Maya scene lighting affects material appearance |
60 | 61 |
|
61 | 62 | ??? question "Can I extract textures during import?" |
62 | 63 | The importer handles textures differently depending on the file type: |
63 | 64 |
|
64 | | - - **GLB files**: The importer needs to extract and save textures using the [Image Extraction](image_extraction.md) feature because textures are embedded in the binary file. By default, textures are saved to your Maya project's sourceimages directory. You can enable "Use Relative Path" to save textures relative to the GLB file location, which is useful for portable project structures. |
| 65 | + - **GLB files**: The importer needs to extract and save textures using the [Image Extraction](image_extraction.md) feature because textures are embedded in the binary file. By default (when "Use Relative Path" is unchecked), textures are saved to your Maya project's sourceimages directory (e.g., `C:\Users\{User name}\Documents\maya\projects\default\sourceimages\gltf_textures`). When "Use Relative Path" is enabled, textures are saved relative to the GLB file location, which is useful for portable project structures. |
65 | 66 |
|
66 | 67 | - **GLTF files**: Extraction is not needed because textures are external files. The texture image paths will be set relative to the GLTF file location automatically. |
67 | 68 |
|
|
71 | 72 | - **Standard Surface** (default): Best for general use with Arnold and other renderers |
72 | 73 | - **Arnold**: Optimized for Arnold renderer workflows |
73 | 74 | - **OpenPBR** (Maya 2025+): Industry-standard PBR shader, though Arnold may not render all properties correctly |
74 | | - - **Stingray**: Legacy option, only supports basic material properties |
| 75 | + - **Stingray**: Legacy option, only supports basic material properties (BaseColor, ORM, Normal, Emissive) |
75 | 76 |
|
76 | | - Some manual adjustment may be required for optimal results depending on your chosen shader type. |
| 77 | + Additionally, you can enable "Import Ambient Occlusion" to import AO from ORM texture (R channel) and multiply it with base color for enhanced depth and shadow detail. Some manual adjustment may be required for optimal results depending on your chosen shader type. |
77 | 78 |
|
78 | 79 | ## Performance Questions |
79 | 80 |
|
|
91 | 92 |
|
92 | 93 | **For Static Geometry (No Animation Needed):** |
93 | 94 | - Disable "Import Animations" in [Animation Settings](animation_settings.md) to skip all animation processing |
94 | | - - Enable "Skip Skin Binding" in [Geometry Options](geometry_options.md) to avoid processing skeleton and skinning data, which significantly speeds up imports for complex rigged assets |
| 95 | + - Disable "Import Skin Binding" in [Geometry Options](geometry_options.md) to avoid processing skeleton and skinning data, which significantly speeds up imports for complex rigged assets |
95 | 96 |
|
96 | 97 | **For Geometry Optimization:** |
97 | 98 | - Use "Merge Vertices" in [Geometry Options](geometry_options.md) to reduce geometry complexity, which can speed up processing for high-poly models |
98 | 99 |
|
99 | 100 | **For Material Optimization:** |
100 | | - - Enable "Skip Material Creation" in [Material Settings](material_settings.md) if you only need geometry and plan to assign materials manually later |
| 101 | + - Disable "Import Materials" in [Material Settings](material_settings.md) if you only need geometry and plan to assign materials manually later |
101 | 102 |
|
102 | 103 |
|
103 | 104 | These optimizations are particularly effective for large files, complex rigged assets, or when you only need specific aspects of the imported content. |
104 | 105 |
|
105 | 106 | ## Troubleshooting |
106 | 107 |
|
107 | 108 | ??? question "The plugin menu doesn't appear in Maya" |
108 | | - If the [glTF2.0](glb_gltf_menu.md) is not visible: |
| 109 | + If the [glTF2.0](gltf2_0_menu.md) menu is not visible: |
109 | 110 |
|
110 | 111 | 1. Verify the plugin is properly installed |
111 | 112 | 2. Check that the plugin is loaded in Maya's Plugin Manager |
|
125 | 126 | Animation issues can often be resolved by: |
126 | 127 |
|
127 | 128 | 1. Checking [Animation Settings](animation_settings.md) configuration - Ensure "Import Animations" is enabled |
128 | | - 2. Using [Show Animation Clips](show_animation_clips.md) to manage multiple animations - All clips are organized in Maya's Time Editor |
129 | | - 3. Verifying timeline settings in Maya |
130 | | - 4. Note: Transform-based animations work better than joint-based animations - Sketchfab assets with rigged animations may require preprocessing (see [Asset Compatibility and Workarounds](compatibility_and_workarounds.md)) |
| 129 | + 2. Enabling "Open Time Editor Window" in [Animation Settings](animation_settings.md) to automatically open the Time Editor after import for easier access to animation clips |
| 130 | + 3. Using [Show Animation Clips](show_animation_clips.md) to manage multiple animations - All clips are organized in Maya's Time Editor |
| 131 | + 4. Verifying timeline settings in Maya |
| 132 | + 5. Note: Transform-based animations work better than joint-based animations - Sketchfab assets with rigged animations may require preprocessing (see [Asset Compatibility and Workarounds](compatibility_and_workarounds.md)) |
131 | 133 |
|
132 | 134 | ## Advanced Usage |
133 | 135 |
|
|
138 | 140 | For large scenes: |
139 | 141 |
|
140 | 142 | 1. Consider splitting the scene into smaller files |
141 | | - 2. Use selective import options - Enable "Skip Skin Binding" if you don't need animation, or "Skip Material Creation" to import geometry only |
| 143 | + 2. Use selective import options - Disable "Import Skin Binding" if you don't need animation, or disable "Import Materials" to import geometry only |
142 | 144 | 3. Optimize geometry before import |
143 | 145 | 4. Monitor Maya's memory usage |
144 | 146 | 5. Use "Merge Vertices" option to reduce geometry complexity |
|
153 | 155 | ??? question "What's the difference between 'No merging' and 'Merge Vertices' geometry options?" |
154 | 156 | - **No merging** (default): Preserves original mesh structure, keeps components separate along UV seams, maintains material assignments per mesh |
155 | 157 | - **Merge Vertices**: Automatically combines vertices that share the same position, can reduce geometry complexity but may affect color sets |
156 | | - - **Skip Skin Binding**: When enabled, ignores skin binding data and imports static geometry only - useful when you don't need animation or deformation |
| 158 | + - **Import Skin Binding**: When enabled (default), imports skin binding data and applies it to geometry with skeleton/deformation data. When disabled, ignores skin binding data and imports static geometry only - useful when you don't need animation or deformation |
157 | 159 |
|
158 | 160 | ??? question "Can I modify import settings after import?" |
159 | 161 | Import settings apply during the import process. To change settings, you'll need to re-import the file with new configuration options. However, you can modify materials, apply material variants using [Show Material Variants](show_material_variants.md), and manage animation clips using [Show Animation Clips](show_animation_clips.md) after import. |
|
0 commit comments