Clarification for content availability of implicit tileset roots
javagl opened this issue · 4 comments
(Edited for more clarity...)
The specification text at https://github.com/CesiumGS/3d-tiles/tree/main/specification/ImplicitTiling#availability-1 says
If the implicit root tile does not have content then
contentAvailabilityshall be omitted.
I was a bit surprised by that statement: It is phrased as a requirement to omit this property, but it only refers to the root tile. But the information cannot be omitted when there is content available in other cells of the subtree.
It could be clarified that when the contentAvailability is omitted, it just means availableCount:0/constant:0. But requiring to omit it depending on the presence of content only in the root tile does not seem to make sense.
(This came up in the forum at https://community.cesium.com/t/omitting-content-availability-when-using-implicit-tiling/32238 )
I think this is referring to a tile without a content property, e.g.
{
"root": {
"boundingVolume": {
"region": [-1.318, 0.697, -1.319, 0.698, 0, 20]
},
"refine": "REPLACE",
"geometricError": 5000,
"implicitTiling": {
"subdivisionScheme": "QUADTREE",
"availableLevels": 21,
"subtreeLevels": 7,
"subtrees": {
"uri": "subtrees/{level}/{x}/{y}.json"
}
}
}
}contentAvailability would be omitted since this implicit tileset contains all empty tiles.
I think the line should be reworded to
If the implicit root tile does not have a
contentproperty thencontentAvailabilityshall be omitted.
Now this makes sense, on the level of the specification. It may raise questions about use-cases for an implicit tileset that does not have content at all. But one could make a case for such a tileset serving only as a purely spatial datastructure that stores metadata, for example.
To avoid similar confusion, one could probably consider to elaborate that further, with something like
If the implicit root tile does not have a
contentorcontentsproperty, and therefore does not define a content template URI, then this means that none of the implicit tiles has any content, and thecontentAvailabilityin the subtrees shall be omitted.