donmccurdy / glTF-Transform

glTF 2.0 SDK for JavaScript and TypeScript, on Web and Node.js.
https://gltf-transform.dev
MIT License
1.36k stars 147 forks source link

Ideas for new tutorials #984

Open donmccurdy opened 1 year ago

donmccurdy commented 1 year ago

This thread is meant to gather and organize ideas about new examples and tutorials to be added to the glTF Transform documentation (https://gltf-transform.donmccurdy.com/). Suggests, comments, questions, and upvotes are welcome. Requests for new feature development should probably be made in a new issue, instead.

Ideas:

dasmehdix commented 1 year ago

I have generally use gltf-transform/CLI tool. I am not much familiar with Javascript. When I want to use gltf-transform inspect, I would need to get a Json file that contains properties of glb/gltf model. Reading console output can be a bit tough. So, can you provide an argument that save inspect output as Json or Csv?

donmccurdy commented 1 year ago

Hi @dasmehdix – Do you mind filing a new issue for the feature request? I'm hoping to keep this thread focused on adding tutorials to the site documentation. What you can also do now would be...

gltf-transform inspect input.glb --format csv

... which prints CSV-formatted content to the CLI, and you can paste that into Excel or Google Sheets. Or --format md will get you markdown tables. It isn't possible to write the entire report to a single CSV, as the different tables have different structures, and I didn't feel great about writing CSVs in bulk for this command.

jo-chemla commented 1 year ago

Hi there, interested to know what tutorial you would like to write regarding Processing 3d-tiles - from my understanding the glTF-Transform utility was focused on IO/transforms/optimization tooling on glTF rather than a hierarchy of glTF tiles. Do you plan to describe how to merge glb/glTF tiles from a single 3D-tiles tileset? And a warm thanks for your great tool!

donmccurdy commented 1 year ago

@jo-chemla totally undecided at this point! I am hoping for feedback, and may not write anything at all without it. While I don't anticipate the glTF Transform library adding new features specifically for the 3D Tiles format, glTF Transform is an I/O library and could be used to write converters to/from other formats. Combined with another library or custom code that reads/writes 3D tiles, for example, you could presumably convert between the two. An in-depth tutorial explaining how such a pipeline would be built is what I'm mulling over here.

jo-chemla commented 1 year ago

Thanks for clarifying! Understood that glTF-transform could be used to write converters to/from other formats.

From my understanding, this conversion from a tiled 3D-tiles tileset to a standard mesh format (like glTF or other) would fit nicely within the CesiumGS/3d-tiles-tools suite. Anyway, I would very much learn from such an in-depth tutorial to perform this merge operation - if you need sample data, sharing thoughts, or beta-testing, I'd love to help!

javagl commented 1 year ago

The first point, "Building custom extensions", is certainly related to https://github.com/donmccurdy/glTF-Transform/issues/958