Document GLTFLight and GLTFSpecGloss

This commit is contained in:
Aaron Franke 2022-08-14 13:55:41 -05:00
parent f2a6168414
commit 3bbb50359d
No known key found for this signature in database
GPG key ID: 40A1750B977E56BF
4 changed files with 18 additions and 0 deletions

View file

@ -1,10 +1,13 @@
<?xml version="1.0" encoding="UTF-8" ?> <?xml version="1.0" encoding="UTF-8" ?>
<class name="GLTFLight" inherits="Resource" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd"> <class name="GLTFLight" inherits="Resource" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
<brief_description> <brief_description>
Represents a GLTF light.
</brief_description> </brief_description>
<description> <description>
Represents a light as defined by the [code]KHR_lights_punctual[/code] GLTF extension.
</description> </description>
<tutorials> <tutorials>
<link title="KHR_lights_punctual GLTF extension spec">https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_lights_punctual</link>
</tutorials> </tutorials>
<members> <members>
<member name="color" type="Color" setter="set_color" getter="get_color" default="Color(1, 1, 1, 1)"> <member name="color" type="Color" setter="set_color" getter="get_color" default="Color(1, 1, 1, 1)">

View file

@ -1,21 +1,29 @@
<?xml version="1.0" encoding="UTF-8" ?> <?xml version="1.0" encoding="UTF-8" ?>
<class name="GLTFSpecGloss" inherits="Resource" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd"> <class name="GLTFSpecGloss" inherits="Resource" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
<brief_description> <brief_description>
Archived GLTF extension for specular/glossy materials.
</brief_description> </brief_description>
<description> <description>
KHR_materials_pbrSpecularGlossiness is an archived GLTF extension. This means that it is deprecated and not recommended for new files. However, it is still supported for loading old files.
</description> </description>
<tutorials> <tutorials>
<link title="KHR_materials_pbrSpecularGlossiness GLTF extension spec">https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Archived/KHR_materials_pbrSpecularGlossiness</link>
</tutorials> </tutorials>
<members> <members>
<member name="diffuse_factor" type="Color" setter="set_diffuse_factor" getter="get_diffuse_factor" default="Color(1, 1, 1, 1)"> <member name="diffuse_factor" type="Color" setter="set_diffuse_factor" getter="get_diffuse_factor" default="Color(1, 1, 1, 1)">
The reflected diffuse factor of the material.
</member> </member>
<member name="diffuse_img" type="Image" setter="set_diffuse_img" getter="get_diffuse_img"> <member name="diffuse_img" type="Image" setter="set_diffuse_img" getter="get_diffuse_img">
The diffuse texture.
</member> </member>
<member name="gloss_factor" type="float" setter="set_gloss_factor" getter="get_gloss_factor" default="1.0"> <member name="gloss_factor" type="float" setter="set_gloss_factor" getter="get_gloss_factor" default="1.0">
The glossiness or smoothness of the material.
</member> </member>
<member name="spec_gloss_img" type="Image" setter="set_spec_gloss_img" getter="get_spec_gloss_img"> <member name="spec_gloss_img" type="Image" setter="set_spec_gloss_img" getter="get_spec_gloss_img">
The specular-glossiness texture.
</member> </member>
<member name="specular_factor" type="Color" setter="set_specular_factor" getter="get_specular_factor" default="Color(1, 1, 1, 1)"> <member name="specular_factor" type="Color" setter="set_specular_factor" getter="get_specular_factor" default="Color(1, 1, 1, 1)">
The specular RGB color of the material. The alpha channel is unused.
</member> </member>
</members> </members>
</class> </class>

View file

@ -35,6 +35,8 @@
#include "core/io/resource.h" #include "core/io/resource.h"
#include "scene/3d/light_3d.h" #include "scene/3d/light_3d.h"
// https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_lights_punctual
class GLTFLight : public Resource { class GLTFLight : public Resource {
GDCLASS(GLTFLight, Resource) GDCLASS(GLTFLight, Resource)
friend class GLTFDocument; friend class GLTFDocument;

View file

@ -34,6 +34,11 @@
#include "core/io/image.h" #include "core/io/image.h"
#include "core/io/resource.h" #include "core/io/resource.h"
// KHR_materials_pbrSpecularGlossiness is an archived GLTF extension.
// This means that it is deprecated and not recommended for new files.
// However, it is still supported for loading old files.
// https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Archived/KHR_materials_pbrSpecularGlossiness
class GLTFSpecGloss : public Resource { class GLTFSpecGloss : public Resource {
GDCLASS(GLTFSpecGloss, Resource); GDCLASS(GLTFSpecGloss, Resource);
friend class GLTFDocument; friend class GLTFDocument;