/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2017 * * * * Permission is hereby granted, free of charge, to any person obtaining a copy of this * * software and associated documentation files (the "Software"), to deal in the Software * * without restriction, including without limitation the rights to use, copy, modify, * * merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * * permit persons to whom the Software is furnished to do so, subject to the following * * conditions: * * * * The above copyright notice and this permission notice shall be included in all copies * * or substantial portions of the Software. * * * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, * * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A * * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF * * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE * * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * ****************************************************************************************/ #ifndef __OPENSPACE_MODULE_GLOBEBROWSING___MEMORY_AWARE_TILE_CACHE___H__ #define __OPENSPACE_MODULE_GLOBEBROWSING___MEMORY_AWARE_TILE_CACHE___H__ #include #include #include #include #include #include #include #include #include #include #include #include #include namespace openspace { namespace globebrowsing { namespace cache { struct ProviderTileKey { TileIndex tileIndex; unsigned int providerID; bool operator==(const ProviderTileKey& r) const { return (providerID == r.providerID) && (tileIndex == r.tileIndex); } }; struct ProviderTileHasher { /** Creates a hash which can be used as key in hash maps. First set the bits to be unique for all tiles. +-------+------------+-------+------------+ | USAGE | BIT RANGE | #BITS | MAX VALUE | +-------+------------+-------+------------+ | level | 0 - 5 | 5 | 31 | | x | 5 - 35 | 30 | 1073741824 | | y | 35 - 64 | 29 | 536870912 | +-------+------------+-------+------------+ Bits are then shifted depending on the tile provider used. */ unsigned long long operator()(const ProviderTileKey& t) const { unsigned long long key = 0; key |= static_cast(t.tileIndex.level); key |= static_cast(t.tileIndex.x) << 5ULL; key |= static_cast(t.tileIndex.y) << 35ULL; // Now the key is unique for all tiles, however not for all tile providers. // Add to the key depending on the tile provider to avoid some hash collisions. // (All hash collisions can not be avoided due to the limit in 64 bit for the // hash key) // Idea: make some offset in the place of the bits for the x value. Lesser chance // of having different x-value than having different tile provider ids. key += static_cast(t.providerID) << 25ULL; return key; } }; class MemoryAwareTileCache : public properties::PropertyOwner { public: MemoryAwareTileCache(); ~MemoryAwareTileCache(); void clear(); void setSizeEstimated(size_t estimatedSize); bool exist(ProviderTileKey key) const; Tile get(ProviderTileKey key); ghoul::opengl::Texture* getTexture(const TileTextureInitData& initData); void createTileAndPut(ProviderTileKey key, std::shared_ptr rawTile); void put(const ProviderTileKey& key, const TileTextureInitData::HashKey& initDataKey, Tile tile); void update(); size_t getGPUAllocatedDataSize() const; size_t getCPUAllocatedDataSize() const; bool shouldUsePbo() const; private: void createDefaultTextureContainers(); void assureTextureContainerExists(const TileTextureInitData& initData); void resetTextureContainerSize(size_t numTexturesPerTextureType); using TileCache = LRUCache; using TextureContainerTileCache = std::pair, std::unique_ptr>; using TextureContainerMap = std::unordered_map; TextureContainerMap _textureContainerMap; size_t _numTextureBytesAllocatedOnCPU; // Properties properties::IntProperty _cpuAllocatedTileData; properties::IntProperty _gpuAllocatedTileData; properties::IntProperty _tileCacheSize; properties::TriggerProperty _applyTileCacheSize; properties::TriggerProperty _clearTileCache; /// Whether or not pixel buffer objects should be used when uploading tile data properties::BoolProperty _usePbo; }; } // namespace cache } // namespace globebrowsing } // namespace openspace #endif // __OPENSPACE_MODULE_GLOBEBROWSING___MEMORY_AWARE_TILE_CACHE___H__