collectors.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2007-2008 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
 * Copyright (C) 2004-2021 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 2
 * 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, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */

#ifndef COLLECTORS_H
#define COLLECTORS_H


/*
 *  This module contains a number of COLLECTOR implementations which are used
 *  to augment the functionality of class PCB_EDIT_FRAME.
 */


#include <collector.h>
#include <layers_id_colors_and_visibility.h>              // LAYER_COUNT, layer defs
#include <view/view.h>
#include <board_item.h>



class COLLECTORS_GUIDE
{
public:
    virtual     ~COLLECTORS_GUIDE() {}

    virtual     bool IsLayerLocked( PCB_LAYER_ID layer ) const = 0;

    virtual     bool IsLayerVisible( PCB_LAYER_ID layer ) const = 0;

    virtual     bool IgnoreLockedLayers() const = 0;

    virtual     bool IgnoreNonVisibleLayers() const = 0;

    virtual     PCB_LAYER_ID GetPreferredLayer() const = 0;

    virtual     bool IgnorePreferredLayer() const = 0;

    virtual     bool IgnoreLockedItems() const = 0;

    virtual     bool IncludeSecondary() const = 0;

    virtual     bool IgnoreHiddenFPText() const = 0;

    virtual     bool IgnoreFPTextOnBack() const = 0;

    virtual     bool IgnoreFPTextOnFront() const = 0;

    virtual     bool IgnoreFootprintsOnBack() const = 0;

    virtual     bool IgnoreFootprintsOnFront() const = 0;

    virtual     bool IgnorePadsOnBack() const = 0;

    virtual     bool IgnorePadsOnFront() const = 0;

    virtual     bool IgnoreThroughHolePads() const = 0;

    virtual     bool IgnorePads() const
    {
        return IgnorePadsOnFront() && IgnorePadsOnBack() && IgnoreThroughHolePads();
    }

    virtual     bool IgnoreFPValues() const = 0;

    virtual     bool IgnoreFPReferences() const = 0;

    virtual     bool IgnoreThroughVias() const = 0;

    virtual     bool IgnoreBlindBuriedVias() const = 0;

    virtual     bool IgnoreMicroVias() const = 0;

    virtual     bool IgnoreTracks() const = 0;

    virtual     bool IgnoreZoneFills() const = 0;

    virtual     double OnePixelInIU() const = 0;

};



class PCB_COLLECTOR : public COLLECTOR
{
public:
    BOARD_ITEM* operator[]( int ndx ) const override
    {
        if( (unsigned)ndx < (unsigned)GetCount() )
            return (BOARD_ITEM*) m_list[ ndx ];

        return nullptr;
    }
};


class GENERAL_COLLECTOR : public PCB_COLLECTOR
{
protected:
    std::vector<BOARD_ITEM*>    m_List2nd;

    const COLLECTORS_GUIDE*     m_Guide;

    int                         m_PrimaryLength;

public:

    static const KICAD_T AllBoardItems[];

    static const KICAD_T Zones[];

    static const KICAD_T BoardLevelItems[];

    static const KICAD_T Footprints[];

    static const KICAD_T PadsOrTracks[];

    static const KICAD_T FootprintItems[];

    static const KICAD_T Tracks[];

    static const KICAD_T LockableItems[];

    static const KICAD_T Dimensions[];

    static const KICAD_T DraggableItems[];

    GENERAL_COLLECTOR()
    {
        m_Guide = nullptr;
        m_PrimaryLength = 0;
        SetScanTypes( AllBoardItems );
    }

    void Empty2nd()
    {
        m_List2nd.clear();
    }

    void Append2nd( BOARD_ITEM* item )
    {
        m_List2nd.push_back( item );
    }

    void SetGuide( const COLLECTORS_GUIDE* aGuide ) { m_Guide = aGuide; }

    const COLLECTORS_GUIDE* GetGuide() const { return m_Guide; }

    int GetPrimaryCount() { return m_PrimaryLength; }

    SEARCH_RESULT Inspect( EDA_ITEM* testItem, void* testData )  override;

    void Collect( BOARD_ITEM* aItem, const KICAD_T aScanList[],
                  const wxPoint& aRefPos, const COLLECTORS_GUIDE& aGuide );
};


class GENERAL_COLLECTORS_GUIDE : public COLLECTORS_GUIDE
{
public:

    GENERAL_COLLECTORS_GUIDE( LSET aVisibleLayerMask, PCB_LAYER_ID aPreferredLayer,
                              KIGFX::VIEW* aView )
    {
        VECTOR2I one( 1, 1 );

        m_preferredLayer            = aPreferredLayer;
        m_ignorePreferredLayer      = false;
        m_visibleLayers             = aVisibleLayerMask;
        m_ignoreLockedLayers        = true;
        m_ignoreNonVisibleLayers    = true;
        m_ignoreLockedItems         = false;

#if defined(USE_MATCH_LAYER)
        m_includeSecondary          = false;
#else
        m_includeSecondary          = true;
#endif

        m_ignoreHiddenFPText        = true; // g_ModuleTextNOVColor;
        m_ignoreFPTextOnBack        = true;
        m_ignoreFPTextOnFront       = false;
        m_ignoreFootprintsOnBack    = true; // !Show_footprints_Cmp;
        m_ignoreFootprintsOnFront   = false;

        m_ignorePadsOnFront         = false;
        m_ignorePadsOnBack          = false;
        m_ignoreThroughHolePads     = false;

        m_ignoreFPValues            = false;
        m_ignoreFPReferences        = false;

        m_ignoreThroughVias         = false;
        m_ignoreBlindBuriedVias     = false;
        m_ignoreMicroVias           = false;
        m_ignoreTracks              = false;
        m_ignoreZoneFills           = true;

        m_onePixelInIU              = abs( aView->ToWorld( one, false ).x );
    }

    bool IsLayerLocked( PCB_LAYER_ID aLayerId ) const override
    {
        return m_lockedLayers[aLayerId];
    }

    void SetLayerLocked( PCB_LAYER_ID aLayerId, bool isLocked )
    {
        m_lockedLayers.set( aLayerId, isLocked );
    }

    bool IsLayerVisible( PCB_LAYER_ID aLayerId ) const override
    {
        return m_visibleLayers[aLayerId];
    }
    void SetLayerVisible( PCB_LAYER_ID aLayerId, bool isVisible )
    {
        m_visibleLayers.set( aLayerId, isVisible );
    }
    void SetLayerVisibleBits( LSET aLayerBits ) { m_visibleLayers = aLayerBits; }

    bool IgnoreLockedLayers() const override        { return m_ignoreLockedLayers; }
    void SetIgnoreLockedLayers( bool ignore )       { m_ignoreLockedLayers = ignore; }

    bool IgnoreNonVisibleLayers() const override    { return m_ignoreNonVisibleLayers; }
    void SetIgnoreNonVisibleLayers( bool ignore )   { m_ignoreLockedLayers = ignore; }

    PCB_LAYER_ID GetPreferredLayer() const override    { return m_preferredLayer; }
    void SetPreferredLayer( PCB_LAYER_ID aLayer )      { m_preferredLayer = aLayer; }

    bool IgnorePreferredLayer() const override      { return  m_ignorePreferredLayer; }
    void SetIgnorePreferredLayer( bool ignore )     { m_ignorePreferredLayer = ignore; }

    bool IgnoreLockedItems() const override         { return m_ignoreLockedItems; }
    void SetIgnoreLockedItems( bool ignore )        { m_ignoreLockedItems = ignore; }

    bool IncludeSecondary() const override { return m_includeSecondary; }
    void SetIncludeSecondary( bool include ) { m_includeSecondary = include; }

    bool IgnoreHiddenFPText() const override { return m_ignoreHiddenFPText; }
    void SetIgnoreMTextsMarkedNoShow( bool ignore ) { m_ignoreHiddenFPText = ignore; }

    bool IgnoreFPTextOnBack() const override { return m_ignoreFPTextOnBack; }
    void SetIgnoreMTextsOnBack( bool ignore ) { m_ignoreFPTextOnBack = ignore; }

    bool IgnoreFPTextOnFront() const override { return m_ignoreFPTextOnFront; }
    void SetIgnoreMTextsOnFront( bool ignore ) { m_ignoreFPTextOnFront = ignore; }

    bool IgnoreFootprintsOnBack() const override { return m_ignoreFootprintsOnBack; }
    void SetIgnoreModulesOnBack( bool ignore ) { m_ignoreFootprintsOnBack = ignore; }

    bool IgnoreFootprintsOnFront() const override { return m_ignoreFootprintsOnFront; }
    void SetIgnoreModulesOnFront( bool ignore ) { m_ignoreFootprintsOnFront = ignore; }

    bool IgnorePadsOnBack() const override { return m_ignorePadsOnBack; }
    void SetIgnorePadsOnBack(bool ignore) { m_ignorePadsOnBack = ignore; }

    bool IgnorePadsOnFront() const override { return m_ignorePadsOnFront; }
    void SetIgnorePadsOnFront(bool ignore) { m_ignorePadsOnFront = ignore; }

    bool IgnoreThroughHolePads() const override { return m_ignoreThroughHolePads; }
    void SetIgnoreThroughHolePads(bool ignore) { m_ignoreThroughHolePads = ignore; }

    bool IgnoreFPValues() const override { return m_ignoreFPValues; }
    void SetIgnoreModulesVals(bool ignore) { m_ignoreFPValues = ignore; }

    bool IgnoreFPReferences() const override { return m_ignoreFPReferences; }
    void SetIgnoreModulesRefs(bool ignore) { m_ignoreFPReferences = ignore; }

    bool IgnoreThroughVias() const override { return m_ignoreThroughVias; }
    void SetIgnoreThroughVias( bool ignore ) { m_ignoreThroughVias = ignore; }

    bool IgnoreBlindBuriedVias() const override { return m_ignoreBlindBuriedVias; }
    void SetIgnoreBlindBuriedVias( bool ignore ) { m_ignoreBlindBuriedVias = ignore; }

    bool IgnoreMicroVias() const override { return m_ignoreMicroVias; }
    void SetIgnoreMicroVias( bool ignore ) { m_ignoreMicroVias = ignore; }

    bool IgnoreTracks() const override { return m_ignoreTracks; }
    void SetIgnoreTracks( bool ignore ) { m_ignoreTracks = ignore; }

    bool IgnoreZoneFills() const override { return m_ignoreZoneFills; }
    void SetIgnoreZoneFills( bool ignore ) { m_ignoreZoneFills = ignore; }

    double OnePixelInIU() const override { return m_onePixelInIU; }
    void SetOnePixelInIU( double aValue ) { m_onePixelInIU = aValue; }

private:
    // the storage architecture here is not important, since this is only
    // a carrier object and its functions are what is used, and data only indirectly.

    PCB_LAYER_ID m_preferredLayer;
    bool    m_ignorePreferredLayer;

    LSET    m_lockedLayers;                  
    bool    m_ignoreLockedLayers;

    LSET    m_visibleLayers;                 
    bool    m_ignoreNonVisibleLayers;

    bool    m_ignoreLockedItems;
    bool    m_includeSecondary;

    bool    m_ignoreHiddenFPText;
    bool    m_ignoreFPTextOnBack;
    bool    m_ignoreFPTextOnFront;
    bool    m_ignoreFootprintsOnBack;
    bool    m_ignoreFootprintsOnFront;
    bool    m_ignorePadsOnFront;
    bool    m_ignorePadsOnBack;
    bool    m_ignoreThroughHolePads;
    bool    m_ignoreFPValues;
    bool    m_ignoreFPReferences;
    bool    m_ignoreThroughVias;
    bool    m_ignoreBlindBuriedVias;
    bool    m_ignoreMicroVias;
    bool    m_ignoreTracks;
    bool    m_ignoreZoneFills;

    double  m_onePixelInIU;
};


class PCB_TYPE_COLLECTOR : public PCB_COLLECTOR
{
public:

    SEARCH_RESULT Inspect( EDA_ITEM* testItem, void* testData ) override;

    void Collect( BOARD_ITEM* aBoard, const KICAD_T aScanList[] );
};


class PCB_LAYER_COLLECTOR : public PCB_COLLECTOR
{
public:
    PCB_LAYER_COLLECTOR( PCB_LAYER_ID aLayerId = UNDEFINED_LAYER ) :
        m_layer_id( aLayerId )
    {
    }

    void SetLayerId( PCB_LAYER_ID aLayerId ) { m_layer_id = aLayerId; }

    SEARCH_RESULT Inspect( EDA_ITEM* testItem, void* testData ) override;

    void Collect( BOARD_ITEM* aBoard, const KICAD_T aScanList[] );

private:
    PCB_LAYER_ID m_layer_id;
};

#endif // COLLECTORS_H