New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Documentation #97
Comments
This week focus is on mainly fixing bugs and gets things stable for Blender 2.8. |
Thanks! |
Draft documentation: https://gltf-blender-io-docs-gbueavkvns.now.sh/addons/io_gltf2.html A few TODOs:
|
Updated documentation: https://gltf-blender-io-docs-fuznnktuig.now.sh/addons/io_gltf2 @julienduroure thanks for adding the importer option descriptions! @julienduroure @UX3D-nopper Could you take a look at this and suggest any changes you'd prefer? The draft is pushed to https://github.com/KhronosGroup/glTF-Blender-IO/blob/master/docs/io_gltf2.rst. I've omitted the Unlit workflow, since that is still in progress. Once everything looks good I'll try merging the docs into the Blender repo. |
/cc @emackey |
Currently, only KHR_materials_pbrSpecularGlossiness is supported by importer. I saw that Norbert added details about importer/exporter support, but removed them later. |
@julienduroure Not sure I understand, do you mean that spec/gloss is supported by the importer and not the exporter? Or that the importer supports spec/gloss, but not metal/rough and unlit? |
@donmccurdy I was talking about extension supported by importer. That means that importer supports metal/rough (core glTF) & spec/gloss (KHR_materials_pbrSpecularGlossiness extension), but not unlit, not ponctual lights, not texture transfom. Hope I will have time in January to add these supports |
I see, thanks! I'll update the docs. EDIT: done --> 8cde7bf |
For info, I just get commit rights on Blender documentation. |
Note that I still don't have wiki account, so change logs are still linking to wrong url, but I will ask someone to change it, or to create me a wiki account |
Documentation is now committed into Blender doc \o/ Next steps:
|
Awesome, thank you! :) I'm not sure what to write for Unlit documentation at the moment; I think we'll want the exporter to treat an Emissive node – in a material without a Principled node – as unlit. Once that change is in the importer and exporter should be roundtrip compatible and we can document it. |
@julienduroure do you think it's worthwhile to keep the documentation in GitHub (https://github.com/KhronosGroup/glTF-Blender-IO/blob/master/docs/blender_docs/io_gltf2.rst), in addition to the Blender repository? The RST formatting doesn't look quite right on GitHub, and the images aren't visible, so I'm wondering if having docs only in the Blender repository might be easier. |
Docs are live! 🎊 |
The Blender release notes currently link to the documentation from glTF-Blender-Exporter, which focus on the (no longer necessary) custom Cycles nodes. We should create new documentation within this project, covering at least:
The text was updated successfully, but these errors were encountered: