diff --git a/docs/blender_docs/scene_gltf2.rst b/docs/blender_docs/scene_gltf2.rst index faf7f1d80..cca4e856f 100644 --- a/docs/blender_docs/scene_gltf2.rst +++ b/docs/blender_docs/scene_gltf2.rst @@ -270,10 +270,6 @@ All Image Texture nodes used for clearcoat shading should have their *Color Spac Sheen ^^^^^ -When the *Sheen BSDF* node is used in addition to Principled BSDF node, the ``KHR_materials_sheen`` glTF -extension will be included in the export. The Sheen Color will be exported from Color socket of Sheen node. -Sheen Roughness will be exported from Roughness socket. - If a Sheen Roughness Texture is used, glTF requires the values be written to the alpha (``A``) channel. .. figure:: /images/addons_import-export_scene-gltf2_material-sheen.png @@ -283,49 +279,15 @@ If a Sheen Roughness Texture is used, glTF requires the values be written to the Sheen BSDF node is only available on Cycles render engine. You may have to temporary switch to Cycles to add this node, and get back to EEVEE. -.. note:: - - Because the node tree is adding 2 Shaders (Principled and Sheen), - the resulting shader is not fully energy conservative. - You may find some difference between Blender render, and glTF render. - Sheen models are not fully compatible between Blender and glTF. - This trick about adding Sheen Shader is the most accurate - approximation (better that using Sheen Principled sockets). - Specular ^^^^^^^^ -When the *Specular* or *Specular Tint* input of Principled BSDF node have a non default value or +When the *Specular IOR Level* or *Specular Tint* input of Principled BSDF node have a non default value or Image Texture node connected, the ``KHR_materials_specular`` glTF extension will be included in the export. -.. note:: - - Specular models are not fully compatible between Blender and glTF. - By default, Blender data are converted to glTF at export, - with a possible loss of information. - Some conversion are also performed at import, will a possible loss of information too. - - -At import, a custom node group is created, to store original Specular data, not converted. - -.. figure:: /images/addons_import-export_scene-gltf2_material_specular-custom-node.png - -At export, by default, Specular data are converted from Principled BSDF node. - -You can export original Specular data, enabling the option at export. -If enabled, Principled Specular data are ignored, only data from custom node are used. - -.. figure:: /images/addons_import-export_scene-gltf2_material_specular-export-option.png - - -.. tip:: - - If you enable Shader Editor Add-ons in preferences, you will be able to add this custom node group from Menu: - Add > Output > glTF Material Output - .. figure:: /images/addons_import-export_scene-gltf2_addon-preferences-shader.png Transmission ^^^^^^^^^^^^ diff --git a/images/addons_import-export_scene-gltf2_material-base-color-image-hookup.png b/images/addons_import-export_scene-gltf2_material-base-color-image-hookup.png index b91675e20..13f6172f4 100644 Binary files a/images/addons_import-export_scene-gltf2_material-base-color-image-hookup.png and b/images/addons_import-export_scene-gltf2_material-base-color-image-hookup.png differ diff --git a/images/addons_import-export_scene-gltf2_material-clearcoat.png b/images/addons_import-export_scene-gltf2_material-clearcoat.png index 4da63e8a6..9116eab51 100644 Binary files a/images/addons_import-export_scene-gltf2_material-clearcoat.png and b/images/addons_import-export_scene-gltf2_material-clearcoat.png differ diff --git a/images/addons_import-export_scene-gltf2_material-metal-rough.png b/images/addons_import-export_scene-gltf2_material-metal-rough.png index a6b358de0..ca882ee16 100644 Binary files a/images/addons_import-export_scene-gltf2_material-metal-rough.png and b/images/addons_import-export_scene-gltf2_material-metal-rough.png differ diff --git a/images/addons_import-export_scene-gltf2_material-normal.png b/images/addons_import-export_scene-gltf2_material-normal.png index fa9c605ee..8b8f75211 100644 Binary files a/images/addons_import-export_scene-gltf2_material-normal.png and b/images/addons_import-export_scene-gltf2_material-normal.png differ diff --git a/images/addons_import-export_scene-gltf2_material-occlusion-only.png b/images/addons_import-export_scene-gltf2_material-occlusion-only.png index cbfe8f899..01bf18b98 100644 Binary files a/images/addons_import-export_scene-gltf2_material-occlusion-only.png and b/images/addons_import-export_scene-gltf2_material-occlusion-only.png differ diff --git a/images/addons_import-export_scene-gltf2_material-orm-hookup.png b/images/addons_import-export_scene-gltf2_material-orm-hookup.png index 813196285..acd8f6e8e 100644 Binary files a/images/addons_import-export_scene-gltf2_material-orm-hookup.png and b/images/addons_import-export_scene-gltf2_material-orm-hookup.png differ diff --git a/images/addons_import-export_scene-gltf2_material-principled.png b/images/addons_import-export_scene-gltf2_material-principled.png index 6c2f41650..623faccad 100644 Binary files a/images/addons_import-export_scene-gltf2_material-principled.png and b/images/addons_import-export_scene-gltf2_material-principled.png differ diff --git a/images/addons_import-export_scene-gltf2_material-sheen.png b/images/addons_import-export_scene-gltf2_material-sheen.png index f48fb7eeb..c7fdc6941 100644 Binary files a/images/addons_import-export_scene-gltf2_material-sheen.png and b/images/addons_import-export_scene-gltf2_material-sheen.png differ diff --git a/images/addons_import-export_scene-gltf2_material-specular.png b/images/addons_import-export_scene-gltf2_material-specular.png new file mode 100644 index 000000000..69942ea27 Binary files /dev/null and b/images/addons_import-export_scene-gltf2_material-specular.png differ diff --git a/images/addons_import-export_scene-gltf2_material-volume.png b/images/addons_import-export_scene-gltf2_material-volume.png index 130908bd1..48e6a3439 100644 Binary files a/images/addons_import-export_scene-gltf2_material-volume.png and b/images/addons_import-export_scene-gltf2_material-volume.png differ diff --git a/images/addons_import-export_scene-gltf2_material_specular-custom-node.png b/images/addons_import-export_scene-gltf2_material_specular-custom-node.png deleted file mode 100644 index bec3a2b71..000000000 Binary files a/images/addons_import-export_scene-gltf2_material_specular-custom-node.png and /dev/null differ diff --git a/images/addons_import-export_scene-gltf2_material_specular-export-option.png b/images/addons_import-export_scene-gltf2_material_specular-export-option.png deleted file mode 100644 index b33b3b7af..000000000 Binary files a/images/addons_import-export_scene-gltf2_material_specular-export-option.png and /dev/null differ