The asset types are being redesigned a bit to clone less and provide better APIs. As a result, there will be more types that store a single LdtkJson, and it would be convenient to have them implement the level borrowing/lookup/iteration methods that have already been provided for LdtkJson and LdtkProject. This PR adds RawLevelAccessor which provides these convenience methods with only a couple small required methods.
Finding a level by level selection is not included in this trait. For this to be efficient, we require a little more metadata that will be available on some of these types but not all. So, a LevelMetadataAccessor will be added in a future PR for this purpose.
The "raw levels" terminology here is intended to oppose "loaded levels". Raw levels are just that - the exact level data from the type with no type guarantee on top of it. Some existing methods that have been moved to this trait are now named more verbosely to make this extra clear.
BREAKING-CHANGE: move iter_levels, iter_levels_with_indices, and get_level_at_indices to RawLevelAccessor trait. Rename them iter_raw_levels, iter_raw_levels_with_indices, and get_raw_level_at_indices respectively.
The asset types are being redesigned a bit to clone less and provide better APIs. As a result, there will be more types that store a single
LdtkJson, and it would be convenient to have them implement the level borrowing/lookup/iteration methods that have already been provided forLdtkJsonandLdtkProject. This PR addsRawLevelAccessorwhich provides these convenience methods with only a couple small required methods.Finding a level by level selection is not included in this trait. For this to be efficient, we require a little more metadata that will be available on some of these types but not all. So, a
LevelMetadataAccessorwill be added in a future PR for this purpose.The "raw levels" terminology here is intended to oppose "loaded levels". Raw levels are just that - the exact level data from the type with no type guarantee on top of it. Some existing methods that have been moved to this trait are now named more verbosely to make this extra clear.
BREAKING-CHANGE: move
iter_levels,iter_levels_with_indices, andget_level_at_indicestoRawLevelAccessortrait. Rename themiter_raw_levels,iter_raw_levels_with_indices, andget_raw_level_at_indicesrespectively.