component_class_cache_proxy.h

Go to the documentation of this file.

/*
* This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program 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
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 
#ifndef PCBNEW_COMPONENT_CLASS_CACHE_PROXY_H
#define PCBNEW_COMPONENT_CLASS_CACHE_PROXY_H
 
#include <component_classes/component_class.h>
#include <footprint.h>
 
/*
 * A class which acts as a cache-aware proxy for a FOOTPRINT's component class.
 * Creating dynamic component classes (from component class generators) is an
 * expensive operation, so we want to cache the results. This class is a cache
 * proxy which tracks the validity of the cached component class with respect
 * to loaded static and dynamic component class rules
 */
class COMPONENT_CLASS_CACHE_PROXY
{
public:
    explicit COMPONENT_CLASS_CACHE_PROXY( FOOTPRINT* footprint ) : m_footprint( footprint ) {}

    void SetStaticComponentClass( const COMPONENT_CLASS* compClass )
    {
        m_staticComponentClass = compClass;
    }

    const COMPONENT_CLASS* GetStaticComponentClass() const { return m_staticComponentClass; }

    const COMPONENT_CLASS* GetComponentClass() const;

    void RecomputeComponentClass( COMPONENT_CLASS_MANAGER* manager = nullptr ) const;

    void InvalidateCache() { m_lastTickerValue = -1; }
 
protected:
    FOOTPRINT* m_footprint;
 
    const COMPONENT_CLASS*         m_staticComponentClass{ nullptr };
    mutable const COMPONENT_CLASS* m_dynamicComponentClass{ nullptr };
    mutable const COMPONENT_CLASS* m_finalComponentClass{ nullptr };
 
    mutable long long int m_lastTickerValue{ -1 };
};
 
#endif //PCBNEW_COMPONENT_CLASS_CACHE_PROXY_H