Skip to content
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

Fix errors in the PNTS Draco decoding docs #845

Merged
merged 3 commits into from
Nov 22, 2024

Conversation

jsulli
Copy link
Contributor

@jsulli jsulli commented Nov 20, 2024

The PNTS decoding docs reference the wrong decoder as well as the wrong loader. Spent a bit of time hair pulling and hunting down confusing errors till I realized this.

Copy link
Contributor

@gkjohnson gkjohnson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Looks like primarily a typo in the PNTS example snippet.

README.md Outdated
@@ -170,7 +170,7 @@ scene.add( tilesRenderer2.group );

## Adding DRACO Decompression Support

Adding support for DRACO decompression within the GLTF files that are transported in B3DM and I3DM formats. The same approach can be used to add support for KTX2 and DDS textures.
Adding support for DRACO decompression within the GLTF files that are transported in B3DM and I3DM formats. The same approach can be used to add support for KTX2 and DDS textures. Note that GLTF decoding and PNTS decoding require separate decoders.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure what this added line means. Can it be removed or clarified?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the current docs, the selected draco decoder from unpkg uses the GLTF branch, which does not work for compressed PNTS files. This is a really easy detail to miss IMO, I added this line to clarify that. I'll reword things

https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/draco
vs
https://github.com/mrdoob/three.js/tree/dev/examples/jsm/libs/draco/gltf

Copy link
Contributor

@gkjohnson gkjohnson Nov 22, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I see now... how annoying. New wording looks better - thanks!

@jsulli
Copy link
Contributor Author

jsulli commented Nov 21, 2024

Hopefully this language is clearer

@gkjohnson gkjohnson merged commit 600b68e into NASA-AMMOS:master Nov 22, 2024
2 checks passed
@jsulli jsulli deleted the pnts-doc-fix branch November 22, 2024 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants