CesiumGS / cesium-native

Apache License 2.0
402 stars 205 forks source link

Need reference implementations for cesium-native users #855

Open csciguy8 opened 4 months ago

csciguy8 commented 4 months ago

It could be useful to have a set of "how to get started examples" for anyone wanting to integrate cesium-native into their project for the first time.

This would be a little different from just referencing Cesium for Unreal or Cesium for Unity in that these examples would be as simple as possible to help guide the user through integration.

There could be multiple reference examples:

Ideally, these examples would also be built by CI, to make sure any supported use cases are always working.

Feel free to chime in with other ideas as well.

javagl commented 3 months ago

This is certainly not a "reference implementation". But have created (and occasionally updated) https://github.com/javagl/cesium-cpp . This is a pure command-line application that uses cesium-native, and offers some "dummy" implementations for the TilesetExternals.

It allows things like reading all glTF sample assets with cesium-native, or loading a tileset and performing some view updates programmatically - basically "emulating" what a real runtime/renderer/application would be calling.

This is not intended to offer any form of stability. There are no maintenance guarantees. Until now, I only used it for very basic debugging and testing. But maybe someone else also finds something useful in there.

timoore commented 3 months ago

I've pointed people to vsgCs and received some positive feedback about it. Some of the things going for it:

vsgCs is not particularly well documented, but I think the code is generally pretty clear.