ApplyTextureToMesh - ComfyUI Built-in Node Documentation

This node attaches baked texture images to a mesh’s UV layout so they can be exported together with the mesh by the SaveGLB node. Connect the same UV-unwrapped mesh you used for baking, along with the baked image maps. Optional metallic, roughness, and occlusion maps are packed into a single ORM texture, and supplying a normal map also stores the smooth normals and tangents needed for correct shading.

Inputs

Parameter	Description	Data Type	Required	Range
`mesh`	The UV-unwrapped mesh that the baked textures will be attached to. Must be the same mesh used during baking; an error is raised if the mesh has no UVs.	MESH	Yes	—
`base_color`	The baked base color image. Stored as the mesh’s texture and clamped to the 0-1 range.	IMAGE	Yes	—
`metallic`	The baked metallic map. Used as the blue channel of the combined ORM texture; defaults to 0 when not provided.	IMAGE	No	—
`roughness`	The baked roughness map. Used as the green channel of the combined ORM texture; defaults to 1 when not provided.	IMAGE	No	—
`occlusion`	The baked ambient occlusion map. Used as the red channel of the combined ORM texture; defaults to 1 when not provided. When provided, the ORM texture is also marked as the occlusion texture for SaveGLB.	IMAGE	No	—
`normal_map`	The baked tangent-space normal map. When provided, the node recomputes the per-vertex tangent basis and exports smooth vertex normals so the normal map shades correctly.	IMAGE	No	—

Note: When any of metallic, roughness, or occlusion is connected, all three are packed into a single glTF ORM texture with channels R = occlusion, G = roughness, B = metallic. Missing maps are filled with defaults (occlusion 1, roughness 1, metallic 0), and maps with different resolutions are resized to the largest width and height. When normal_map is connected, the mesh’s normals are replaced with computed smooth vertex normals and a tangent basis is added. UV coordinates that fall outside the [0,1] range are uniformly scaled into [0,1] while preserving aspect ratio.

Outputs

Output Name	Description	Data Type
`mesh`	The input mesh with the texture images attached to its UV layout, ready to be saved by SaveGLB.	MESH

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf

​Inputs

​Outputs

Inputs

Outputs