EllipsoidTerrainProvider does not conform to the TerrainProvider interface

[angrycat9000]

What happened?

TerrainProvider has availablity defined as TileAvailablity.

cesium/packages/engine/Source/Core/TerrainProvider.js

Line 84 in 82e59ed

* @type {TileAvailability}

However EllipsoidTerrainProvider returns undefined for availabilty. This does not satisfy TileAvailabity

cesium/packages/engine/Source/Core/EllipsoidTerrainProvider.js

Line 123 in 82e59ed

return undefined;

Found this because sampleHeightsMostDetailed takes a TerrainProvider but throws an error if EllipsoidTerrainProvider is passed.

In the app I was working with the terrain provider may change based on user input. So there isn't a good way to have a single code path that gets the most detailed height. Had to put in a check to to see if the current terrain provider was in instance of EllipsoidTerrainProvider before calling sampleHeightsMostDetailed

Reproduction steps

No response

Sandcastle example

No response

Environment

No response

[ggetz]

@angrycat9000 I think this is expected, as sampleTerrainMostDetailed does explicitly check for this condition.

If we can agree on that, then the fix here is that @type {TileAvailability} should be @type {TileAvailability|undefined} .

[angrycat9000]

@angrycat9000 I think this is expected, as sampleTerrainMostDetailed does explicitly check for this condition.

For consumers who know the implementation details. For a consumer just reading the documentation, passing EllipsoidTerrainProvider to sampleTerrainMostDetailed appears perfectly valid.

If we can agree on that, then the fix here is that type {TileAvailability} should be type {TileAvailability|undefined} .

That still leaves the case where sampleTerrainMostDetailed takes a TerrainProvider but only some implementations of that interface.

I would like to see the type interfaces / documentation to accurately reflect the implementation logic so there are fewer special situations where the consumer has to read the implementation to use the function. That makes it easier for consumers.

There could be a number of ways to acheive this. Haven't dug that deep into the code to know which is the best effort to value ratio.

• EllipsoidTerrainProvider has an availabilty that always returns true for isTileAvailable
• sampleTerrainHeightMostDetailed has a special case that for EllipsoidTerrainProvider that just returns height = 0
  • Does it even need that if it just provides an availabilty?
• Have a class hiearchy ofTerrainProvider -> TileBasedTerrainProvider and sampleTerrainMostDetailed only takes a TileBasedTerrainProvider to eliminate the possibilty of EllipsoidTerrainProvider not being passed to sampleTerrainMostDetailed
• Update the documentation to indicate that sampleTerrainMostDetailed will throw for EllipsoidTerrainProvider

[ggetz]

@angrycat9000 To confirm, we are talking about sampleTerrainMostDetailed here, not Scene.sampleHeightMostDetailed correct?

Scene.sampleHeightMostDetailed does not take any TerrainProvider arguments, nor would it need to based on how its implemented.

[angrycat9000]

@angrycat9000 To confirm, we are talking about sampleTerrainMostDetailed here, not Scene.sampleHeightMostDetailed correct?

Yes, sorry for the confusion. Edited to clarify