/** * @file * @brief Source file for Cache class * @author Jonathan Thomas * * @section LICENSE * * Copyright (c) 2008-2014 OpenShot Studios, LLC * . This file is part of * OpenShot Library (libopenshot), an open-source project dedicated to * delivering high quality video editing and animation solutions to the * world. For more information visit . * * OpenShot Library (libopenshot) is free software: you can redistribute it * and/or modify it under the terms of the GNU Lesser General Public License * as published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * OpenShot Library (libopenshot) is distributed in the hope that it will be * useful, but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with OpenShot Library. If not, see . */ #include "../include/CacheMemory.h" using namespace std; using namespace openshot; // Default constructor, no max bytes CacheMemory::CacheMemory() : CacheBase(0) { }; // Constructor that sets the max bytes to cache CacheMemory::CacheMemory(int64 max_bytes) : CacheBase(max_bytes) { }; // Default destructor CacheMemory::~CacheMemory() { frames.clear(); frame_numbers.clear(); // remove critical section delete cacheCriticalSection; cacheCriticalSection = NULL; } // Add a Frame to the cache void CacheMemory::Add(tr1::shared_ptr frame) { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); long int frame_number = frame->number; // Freshen frame if it already exists if (frames.count(frame_number)) // Move frame to front of queue MoveToFront(frame_number); else { // Add frame to queue and map frames[frame_number] = frame; frame_numbers.push_front(frame_number); // Clean up old frames CleanUp(); } } // Get a frame from the cache (or NULL shared_ptr if no frame is found) tr1::shared_ptr CacheMemory::GetFrame(long int frame_number) { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); // Does frame exists in cache? if (frames.count(frame_number)) // return the Frame object return frames[frame_number]; else // no Frame found return tr1::shared_ptr(); } // Get the smallest frame number (or NULL shared_ptr if no frame is found) tr1::shared_ptr CacheMemory::GetSmallestFrame() { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); tr1::shared_ptr f; // Loop through frame numbers deque::iterator itr; long int smallest_frame = -1; for(itr = frame_numbers.begin(); itr != frame_numbers.end(); ++itr) { if (*itr < smallest_frame || smallest_frame == -1) smallest_frame = *itr; } // Return frame f = GetFrame(smallest_frame); return f; } // Gets the maximum bytes value int64 CacheMemory::GetBytes() { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); int64 total_bytes = 0; // Loop through frames, and calculate total bytes deque::reverse_iterator itr; for(itr = frame_numbers.rbegin(); itr != frame_numbers.rend(); ++itr) { total_bytes += frames[*itr]->GetBytes(); } return total_bytes; } // Remove a specific frame void CacheMemory::Remove(long int frame_number) { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); // Loop through frame numbers deque::iterator itr; for(itr = frame_numbers.begin(); itr != frame_numbers.end(); ++itr) { if (*itr == frame_number) { // erase frame number frame_numbers.erase(itr); break; } } // Remove frame from map. If frame_number doesn't exist, frames.erase returns zero. frames.erase(frame_number); } // Move frame to front of queue (so it lasts longer) void CacheMemory::MoveToFront(long int frame_number) { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); // Does frame exists in cache? /* FIXME if the frame number isn't present, the loop will do nothing, so why protect it? * Is it to save time by avoiding a loop? * Do we really need to optmize the case where we've been given a nonexisting frame_number? */ if (frames.count(frame_number)) { // Loop through frame numbers deque::iterator itr; for(itr = frame_numbers.begin(); itr != frame_numbers.end(); ++itr) { if (*itr == frame_number) { // erase frame number frame_numbers.erase(itr); // add frame number to 'front' of queue frame_numbers.push_front(frame_number); break; } } } } // Clear the cache of all frames void CacheMemory::Clear() { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); frames.clear(); frame_numbers.clear(); } // Count the frames in the queue long int CacheMemory::Count() { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); // Return the number of frames in the cache return frames.size(); } // Clean up cached frames that exceed the number in our max_bytes variable void CacheMemory::CleanUp() { // Create a scoped lock, to protect the cache from multiple threads const GenericScopedLock lock(*cacheCriticalSection); // Do we auto clean up? if (max_bytes > 0) { while (GetBytes() > max_bytes && frame_numbers.size() > 20) { // Get the oldest frame number. long int frame_to_remove = frame_numbers.back(); // Remove frame_number and frame Remove(frame_to_remove); } } }