typeinfo.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2014 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 * @author Tomasz Wlostowski <[email protected]>
 *
 * 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, see <https://www.gnu.org/licenses/>.
 */
 
#ifndef __KICAD_TYPEINFO_H
#define __KICAD_TYPEINFO_H
 
 
#include <type_traits>

template <class T, class I>
bool IsA( const I* aObject )
{
    return aObject && std::remove_pointer<T>::type::ClassOf( aObject );
}
 
template <class T, class I>
bool IsA( const I& aObject )
{
    return std::remove_pointer<T>::type::ClassOf( &aObject );
}

template<class Casted, class From>
Casted dyn_cast( From aObject )
{
    if( std::remove_pointer<Casted>::type::ClassOf ( aObject ) )
        return static_cast<Casted>( aObject );
 
    return nullptr;
}
 
class EDA_ITEM;
 

enum KICAD_T
{
    NOT_USED = -1, 
 
    TYPE_NOT_INIT = 0,
    PCB_T,
    SCREEN_T, 
 
    // Items in pcb
    PCB_FOOTPRINT_T,       
    PCB_PAD_T,             
    PCB_SHAPE_T,           
    PCB_REFERENCE_IMAGE_T, 
    PCB_FIELD_T,           
    PCB_GENERATOR_T,       
    PCB_TEXT_T,            
    PCB_TEXTBOX_T,         
    PCB_TABLE_T,           
    PCB_TABLECELL_T,       
    PCB_TRACE_T,           
    PCB_VIA_T,             
    PCB_ARC_T,             
    PCB_MARKER_T,          
    PCB_DIMENSION_T,       
    PCB_BARCODE_T,         
    PCB_DIM_ALIGNED_T,     
    PCB_DIM_LEADER_T,      
    PCB_DIM_CENTER_T,      
    PCB_DIM_RADIAL_T,      
    PCB_DIM_ORTHOGONAL_T,  
    PCB_TARGET_T,          
    PCB_ZONE_T,            
    PCB_ITEM_LIST_T,       
    PCB_NETINFO_T,         
    PCB_GROUP_T,           
    PCB_BOARD_OUTLINE_T,   
    PCB_POINT_T,           
 
    // Be prudent with these types:
    // they should be used only to locate a specific field type among PCB_FIELD_Ts
    // N.B. If you add a type here, be sure to add it below to the BaseType()
    PCB_FIELD_LOCATE_REFERENCE_T,
    PCB_FIELD_LOCATE_VALUE_T,
    PCB_FIELD_LOCATE_FOOTPRINT_T,
    PCB_FIELD_LOCATE_DATASHEET_T,
 
    // Be prudent with these types:
    // they should be used only to locate specific item sub-types
    // N.B. If you add a type here, be sure to add it below to the BaseType()
    PCB_LOCATE_STDVIA_T,
    PCB_LOCATE_UVIA_T,
    PCB_LOCATE_BLINDVIA_T,
    PCB_LOCATE_BURIEDVIA_T,
    PCB_LOCATE_TEXT_T,
    PCB_LOCATE_HOLE_T,
    PCB_LOCATE_PTH_T,
    PCB_LOCATE_NPTH_T,
    PCB_LOCATE_BOARD_EDGE_T,
 
    // Same for locating shapes types from PCB_SHAPE_T items
    PCB_SHAPE_LOCATE_SEGMENT_T,
    PCB_SHAPE_LOCATE_RECT_T,
    PCB_SHAPE_LOCATE_CIRCLE_T,
    PCB_SHAPE_LOCATE_ARC_T,
    PCB_SHAPE_LOCATE_POLY_T,
    PCB_SHAPE_LOCATE_BEZIER_T,
 
    /*
     * Draw items in library symbol.
     *
     * The order of these items effects the sort order for items inside the
     * "DRAW/ENDDRAW" section of the symbol definition in a library file.
     * If you add a new draw item, type, please make sure you add it so the
     * sort order is logical.
     */
    LIB_SYMBOL_T,
    SCH_SHAPE_T,
    SCH_FIELD_T,
    SCH_TEXT_T,
    SCH_TEXTBOX_T,
    SCH_PIN_T,
 
    // Schematic draw Items.  The order of these items effects the sort order.
    // It is currently ordered to mimic the old Eeschema locate behavior where
    // the smallest item is the selected item.
    SCH_MARKER_T,
    SCH_JUNCTION_T,
    SCH_NO_CONNECT_T,
    SCH_BUS_WIRE_ENTRY_T,
    SCH_BUS_BUS_ENTRY_T,
    SCH_LINE_T,
    SCH_BITMAP_T,
    SCH_TABLE_T,
    SCH_TABLECELL_T,
    SCH_LABEL_T,
    SCH_GLOBAL_LABEL_T,
    SCH_HIER_LABEL_T,
    SCH_RULE_AREA_T,
    SCH_DIRECTIVE_LABEL_T,
    SCH_SYMBOL_T,
    SCH_GROUP_T,
    SCH_SHEET_PIN_T,
    SCH_SHEET_T,
 
    // Be prudent with these types:
    // they should be used only to locate a specific field type among SCH_FIELD_Ts
    // N.B. If you add a type here, be sure to add it below to the BaseType()
    SCH_FIELD_LOCATE_REFERENCE_T,
    SCH_FIELD_LOCATE_VALUE_T,
    SCH_FIELD_LOCATE_FOOTPRINT_T,
    SCH_FIELD_LOCATE_DATASHEET_T,
 
    // Same for picking wires, buses and graphics from SCH_ITEM_T items
    SCH_ITEM_LOCATE_WIRE_T,
    SCH_ITEM_LOCATE_BUS_T,
    SCH_ITEM_LOCATE_GRAPHIC_LINE_T,
 
    // Same for picking labels, or labels attached to wires and/or buses
    SCH_LABEL_LOCATE_ANY_T,
    SCH_LABEL_LOCATE_WIRE_T,
    SCH_LABEL_LOCATE_BUS_T,
 
    // Same for picking symbols which are power symbols
    SCH_SYMBOL_LOCATE_POWER_T,
 
    // matches any type
    SCH_LOCATE_ANY_T,
 
    // General
    SCH_SCREEN_T,
 
    SCHEMATIC_T,
 
    /*
     * For GerbView: item types:
     */
    GERBER_LAYOUT_T,
    GERBER_DRAW_ITEM_T,
    GERBER_IMAGE_T,
 
    /*
     * For Pl_Editor: item types:
     */
    WSG_LINE_T,
    WSG_RECT_T,
    WSG_POLY_T,
    WSG_TEXT_T,
    WSG_BITMAP_T,
    WSG_PAGE_T,
 
    // serialized layout used in undo/redo commands
    WS_PROXY_UNDO_ITEM_T,      // serialized layout used in undo/redo commands
    WS_PROXY_UNDO_ITEM_PLUS_T, // serialized layout plus page and title block settings
 
    /*
     * FOR PROJECT::_ELEMs
     */
    SYMBOL_LIB_TABLE_T,
    FP_LIB_TABLE_T,
    DESIGN_BLOCK_LIB_TABLE_T,
    SYMBOL_LIBS_T,
    SEARCH_STACK_T,
    S3D_CACHE_T,
 
    // New types appended here to preserve historical KICAD_T ordinals
    // (IPC clients with stale protobuf-generated headers depend on stable values).
    PCB_SHAPE_LOCATE_ELLIPSE_T,
    PCB_SHAPE_LOCATE_ELLIPSE_ARC_T,
 
    // End value
    MAX_STRUCT_TYPE_ID
};
 
static_assert( S3D_CACHE_T == 104,
               "KICAD_T ordinals are exposed via IPC; new values must be appended at the end "
               "of the enum, not inserted into existing blocks." );

constexpr KICAD_T BaseType( const KICAD_T aType )
{
    switch( aType )
    {
    case SCH_FIELD_LOCATE_REFERENCE_T:
    case SCH_FIELD_LOCATE_VALUE_T:
    case SCH_FIELD_LOCATE_FOOTPRINT_T:
    case SCH_FIELD_LOCATE_DATASHEET_T:
        return SCH_FIELD_T;
 
    case SCH_ITEM_LOCATE_WIRE_T:
    case SCH_ITEM_LOCATE_BUS_T:
    case SCH_ITEM_LOCATE_GRAPHIC_LINE_T:
        return SCH_LINE_T;
 
    case SCH_LABEL_LOCATE_ANY_T:
    case SCH_LABEL_LOCATE_WIRE_T:
    case SCH_LABEL_LOCATE_BUS_T:
        return SCH_LABEL_T;
 
    case SCH_SYMBOL_LOCATE_POWER_T:
        return SCH_SYMBOL_T;
 
    case PCB_FIELD_LOCATE_REFERENCE_T:
    case PCB_FIELD_LOCATE_VALUE_T:
    case PCB_FIELD_LOCATE_FOOTPRINT_T:
    case PCB_FIELD_LOCATE_DATASHEET_T:
        return PCB_FIELD_T;
 
    case PCB_LOCATE_HOLE_T:
    case PCB_LOCATE_PTH_T:
    case PCB_LOCATE_NPTH_T:
        return PCB_LOCATE_HOLE_T;
 
    case PCB_SHAPE_LOCATE_SEGMENT_T:
    case PCB_SHAPE_LOCATE_RECT_T:
    case PCB_SHAPE_LOCATE_CIRCLE_T:
    case PCB_SHAPE_LOCATE_ARC_T:
    case PCB_SHAPE_LOCATE_POLY_T:
    case PCB_SHAPE_LOCATE_BEZIER_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_ARC_T: return PCB_SHAPE_T;
 
    case PCB_DIM_ALIGNED_T:
    case PCB_DIM_CENTER_T:
    case PCB_DIM_RADIAL_T:
    case PCB_DIM_ORTHOGONAL_T:
    case PCB_DIM_LEADER_T:
        return PCB_DIMENSION_T;
 
    default:
        return aType;
    }
}
 
constexpr bool IsNullType( const KICAD_T aType )
{
    return aType <= 0;
}
 
constexpr bool IsInstantiableType( const KICAD_T aType )
{
    if( IsNullType( aType ) )
        return false;
 
    switch( aType )
    {
    case SCH_LOCATE_ANY_T:
 
    case SCH_FIELD_LOCATE_REFERENCE_T:
    case SCH_FIELD_LOCATE_VALUE_T:
    case SCH_FIELD_LOCATE_FOOTPRINT_T:
    case SCH_FIELD_LOCATE_DATASHEET_T:
 
    case SCH_ITEM_LOCATE_WIRE_T:
    case SCH_ITEM_LOCATE_BUS_T:
    case SCH_ITEM_LOCATE_GRAPHIC_LINE_T:
 
    case SCH_LABEL_LOCATE_ANY_T:
    case SCH_LABEL_LOCATE_WIRE_T:
    case SCH_LABEL_LOCATE_BUS_T:
 
    case SCH_SYMBOL_LOCATE_POWER_T:
 
    case PCB_FIELD_LOCATE_REFERENCE_T:
    case PCB_FIELD_LOCATE_VALUE_T:
    case PCB_FIELD_LOCATE_FOOTPRINT_T:
    case PCB_FIELD_LOCATE_DATASHEET_T:
 
    case PCB_LOCATE_STDVIA_T:
    case PCB_LOCATE_UVIA_T:
    case PCB_LOCATE_BLINDVIA_T:
    case PCB_LOCATE_BURIEDVIA_T:
    case PCB_LOCATE_TEXT_T:
    case PCB_LOCATE_HOLE_T:
    case PCB_LOCATE_PTH_T:
    case PCB_LOCATE_NPTH_T:
    case PCB_LOCATE_BOARD_EDGE_T:
 
    case PCB_SHAPE_LOCATE_SEGMENT_T:
    case PCB_SHAPE_LOCATE_RECT_T:
    case PCB_SHAPE_LOCATE_CIRCLE_T:
    case PCB_SHAPE_LOCATE_ARC_T:
    case PCB_SHAPE_LOCATE_POLY_T:
    case PCB_SHAPE_LOCATE_BEZIER_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_ARC_T:
 
    case PCB_DIMENSION_T:
 
    case SCH_SCREEN_T:
    case PCB_ITEM_LIST_T:
        return false;
 
    default:
        break;
    }
 
    return true;
 
}
 
constexpr bool IsEeschemaType( const KICAD_T aType )
{
    switch( aType )
    {
    case SCH_MARKER_T:
    case SCH_JUNCTION_T:
    case SCH_NO_CONNECT_T:
    case SCH_BUS_WIRE_ENTRY_T:
    case SCH_BUS_BUS_ENTRY_T:
    case SCH_LINE_T:
    case SCH_SHAPE_T:
    case SCH_RULE_AREA_T:
    case SCH_BITMAP_T:
    case SCH_TEXT_T:
    case SCH_TEXTBOX_T:
    case SCH_TABLE_T:
    case SCH_TABLECELL_T:
    case SCH_LABEL_T:
    case SCH_DIRECTIVE_LABEL_T:
    case SCH_GLOBAL_LABEL_T:
    case SCH_HIER_LABEL_T:
    case SCH_FIELD_T:
    case SCH_SYMBOL_T:
    case SCH_SHEET_PIN_T:
    case SCH_GROUP_T:
    case SCH_SHEET_T:
    case SCH_PIN_T:
 
    case SCH_FIELD_LOCATE_REFERENCE_T:
    case SCH_FIELD_LOCATE_VALUE_T:
    case SCH_FIELD_LOCATE_FOOTPRINT_T:
    case SCH_FIELD_LOCATE_DATASHEET_T:
 
    case SCH_ITEM_LOCATE_WIRE_T:
    case SCH_ITEM_LOCATE_BUS_T:
    case SCH_ITEM_LOCATE_GRAPHIC_LINE_T:
 
    case SCH_LABEL_LOCATE_ANY_T:
    case SCH_LABEL_LOCATE_WIRE_T:
    case SCH_LABEL_LOCATE_BUS_T:
 
    case SCH_SYMBOL_LOCATE_POWER_T:
    case SCH_LOCATE_ANY_T:
 
    case SCH_SCREEN_T:
    case SCHEMATIC_T:
 
    case LIB_SYMBOL_T:
        return true;
 
    default:
        return false;
    }
}
 
constexpr bool IsPcbnewType( const KICAD_T aType )
{
    switch( aType )
    {
    case PCB_T:
 
    case PCB_FOOTPRINT_T:
    case PCB_PAD_T:
    case PCB_SHAPE_T:
    case PCB_REFERENCE_IMAGE_T:
    case PCB_FIELD_T:
    case PCB_TEXT_T:
    case PCB_TEXTBOX_T:
    case PCB_BARCODE_T:
    case PCB_TABLE_T:
    case PCB_TABLECELL_T:
    case PCB_TRACE_T:
    case PCB_VIA_T:
    case PCB_ARC_T:
    case PCB_MARKER_T:
    case PCB_DIMENSION_T:
    case PCB_DIM_ALIGNED_T:
    case PCB_DIM_LEADER_T:
    case PCB_DIM_CENTER_T:
    case PCB_DIM_RADIAL_T:
    case PCB_DIM_ORTHOGONAL_T:
    case PCB_TARGET_T:
    case PCB_POINT_T:
    case PCB_ZONE_T:
    case PCB_ITEM_LIST_T:
    case PCB_NETINFO_T:
    case PCB_GROUP_T:
    case PCB_GENERATOR_T:
 
    case PCB_FIELD_LOCATE_REFERENCE_T:
    case PCB_FIELD_LOCATE_VALUE_T:
    case PCB_FIELD_LOCATE_FOOTPRINT_T:
    case PCB_FIELD_LOCATE_DATASHEET_T:
    case PCB_LOCATE_STDVIA_T:
    case PCB_LOCATE_UVIA_T:
    case PCB_LOCATE_BLINDVIA_T:
    case PCB_LOCATE_BURIEDVIA_T:
    case PCB_LOCATE_TEXT_T:
    case PCB_LOCATE_HOLE_T:
    case PCB_LOCATE_PTH_T:
    case PCB_LOCATE_NPTH_T:
    case PCB_LOCATE_BOARD_EDGE_T:
    case PCB_SHAPE_LOCATE_SEGMENT_T:
    case PCB_SHAPE_LOCATE_RECT_T:
    case PCB_SHAPE_LOCATE_CIRCLE_T:
    case PCB_SHAPE_LOCATE_ARC_T:
    case PCB_SHAPE_LOCATE_POLY_T:
    case PCB_SHAPE_LOCATE_BEZIER_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_T:
    case PCB_SHAPE_LOCATE_ELLIPSE_ARC_T:
    case PCB_BOARD_OUTLINE_T:
        return true;
 
    default:
        return false;
    }
}
 
constexpr bool IsGerbviewType( const KICAD_T aType )
{
    switch( aType )
    {
    case GERBER_LAYOUT_T:
    case GERBER_DRAW_ITEM_T:
    case GERBER_IMAGE_T:
        return true;
 
    default:
        return false;
    }
}
 
constexpr bool IsPageLayoutEditorType( const KICAD_T aType )
{
    switch( aType )
    {
    case WSG_LINE_T:
    case WSG_RECT_T:
    case WSG_POLY_T:
    case WSG_TEXT_T:
    case WSG_BITMAP_T:
    case WSG_PAGE_T:
 
    case WS_PROXY_UNDO_ITEM_T:
    case WS_PROXY_UNDO_ITEM_PLUS_T:
        return true;
 
    default:
        return false;
    }
}
 
constexpr bool IsMiscType( const KICAD_T aType )
{
    switch( aType )
    {
    case SCREEN_T:
 
    case SYMBOL_LIB_TABLE_T:
    case FP_LIB_TABLE_T:
    case DESIGN_BLOCK_LIB_TABLE_T:
    case SYMBOL_LIBS_T:
    case SEARCH_STACK_T:
    case S3D_CACHE_T:
        return true;
 
    default:
        return false;
    }
}
 
constexpr bool IsTypeCorrect( KICAD_T aType )
{
    return IsNullType( aType )
        || IsEeschemaType( aType )
        || IsPcbnewType( aType )
        || IsGerbviewType( aType )
        || IsPageLayoutEditorType( aType )
        || IsMiscType( aType );
}
 
#endif // __KICAD_TYPEINFO_H