trace_helpers.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018 Wayne Stambaugh <[email protected]>
 * Copyright (C) 2018-2024 KiCad Developers, see change_log.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
 */
 
#include <trace_helpers.h>
 
#include <wx/tokenzr.h>
 
const wxChar* const traceFindReplace = wxT( "KICAD_FIND_REPLACE" );
const wxChar* const kicadTraceCoords = wxT( "KICAD_COORDS" );
const wxChar* const kicadTraceKeyEvent = wxT( "KICAD_KEY_EVENTS" );
const wxChar* const kicadTraceToolStack = wxT( "KICAD_TOOL_STACK" );
const wxChar* const kicadTraceCoroutineStack = wxT( "KICAD_COROUTINE_STACK" );
const wxChar* const traceSchLibMem = wxT( "KICAD_SCH_LIB_MEM" );
const wxChar* const traceFindItem = wxT( "KICAD_FIND_ITEM" );
const wxChar* const traceSchLegacyPlugin = wxT( "KICAD_SCH_LEGACY_PLUGIN" );
const wxChar* const traceSchPlugin = wxT( "KICAD_SCH_PLUGIN" );
const wxChar* const traceGedaPcbPlugin = wxT( "KICAD_GEDA_PLUGIN" );
const wxChar* const traceKicadPcbPlugin = wxT( "KICAD_PCB_PLUGIN" );
const wxChar* const tracePrinting = wxT( "KICAD_PRINT" );
const wxChar* const traceAutoSave = wxT( "KICAD_AUTOSAVE" );
const wxChar* const tracePathsAndFiles = wxT( "KICAD_PATHS_AND_FILES" );
const wxChar* const traceLocale = wxT( "KICAD_LOCALE" );
const wxChar* const traceFonts = wxT( "KICAD_FONTS" );
const wxChar* const traceScreen = wxT( "KICAD_SCREEN" );
const wxChar* const traceZoomScroll = wxT( "KICAD_ZOOM_SCROLL" );
const wxChar* const traceSymbolResolver = wxT( "KICAD_SYM_RESOLVE" );
const wxChar* const traceDisplayLocation = wxT( "KICAD_DISPLAY_LOCATION" );
const wxChar* const traceSchSheetPaths = wxT( "KICAD_SCH_SHEET_PATHS" );
const wxChar* const traceEnvVars = wxT( "KICAD_ENV_VARS" );
const wxChar* const traceGalProfile = wxT( "KICAD_GAL_PROFILE" );
const wxChar* const traceKiCad2Step = wxT( "KICAD2STEP" );
const wxChar* const traceUiProfile = wxT( "KICAD_UI_PROFILE" );
 
 
wxString dump( const wxArrayString& aArray )
{
 wxString tmp;
 
 for( unsigned i = 0; i < aArray.GetCount(); i++ )
 {
 if( aArray[i].IsEmpty() )
 tmp << wxT( "\"\" " );
 else
 tmp << aArray[i] << wxT( " " );
 }
 
 return tmp;
}
 
 
// The following code was shamelessly copied from the wxWidgets keyboard sample
// at https://github.com/wxWidgets/wxWidgets/blob/master/samples/keyboard/keyboard.cpp.
 
// Author: Vadim Zeitlin
// Modified by: Marcin Wojdyr
// Created: 07.04.02
// Copyright: (c) 2002 Vadim Zeitlin
// Licence: wxWindows licence
 
// helper function that returns textual description of wx virtual keycode
const char* GetVirtualKeyCodeName(int keycode)
{
 switch ( keycode )
 {
#define WXK_(x) \
 case WXK_##x: return #x;
 
 WXK_(BACK)
 WXK_(TAB)
 WXK_(RETURN)
 WXK_(ESCAPE)
 WXK_(SPACE)
 WXK_(DELETE)
 WXK_(START)
 WXK_(LBUTTON)
 WXK_(RBUTTON)
 WXK_(CANCEL)
 WXK_(MBUTTON)
 WXK_(CLEAR)
 WXK_(SHIFT)
 WXK_(ALT)
 WXK_(CONTROL)
 WXK_(MENU)
 WXK_(PAUSE)
 WXK_(CAPITAL)
 WXK_(END)
 WXK_(HOME)
 WXK_(LEFT)
 WXK_(UP)
 WXK_(RIGHT)
 WXK_(DOWN)
 WXK_(SELECT)
 WXK_(PRINT)
 WXK_(EXECUTE)
 WXK_(SNAPSHOT)
 WXK_(INSERT)
 WXK_(HELP)
 WXK_(NUMPAD0)
 WXK_(NUMPAD1)
 WXK_(NUMPAD2)
 WXK_(NUMPAD3)
 WXK_(NUMPAD4)
 WXK_(NUMPAD5)
 WXK_(NUMPAD6)
 WXK_(NUMPAD7)
 WXK_(NUMPAD8)
 WXK_(NUMPAD9)
 WXK_(MULTIPLY)
 WXK_(ADD)
 WXK_(SEPARATOR)
 WXK_(SUBTRACT)
 WXK_(DECIMAL)
 WXK_(DIVIDE)
 WXK_(F1)
 WXK_(F2)
 WXK_(F3)
 WXK_(F4)
 WXK_(F5)
 WXK_(F6)
 WXK_(F7)
 WXK_(F8)
 WXK_(F9)
 WXK_(F10)
 WXK_(F11)
 WXK_(F12)
 WXK_(F13)
 WXK_(F14)
 WXK_(F15)
 WXK_(F16)
 WXK_(F17)
 WXK_(F18)
 WXK_(F19)
 WXK_(F20)
 WXK_(F21)
 WXK_(F22)
 WXK_(F23)
 WXK_(F24)
 WXK_(NUMLOCK)
 WXK_(SCROLL)
 WXK_(PAGEUP)
 WXK_(PAGEDOWN)
 WXK_(NUMPAD_SPACE)
 WXK_(NUMPAD_TAB)
 WXK_(NUMPAD_ENTER)
 WXK_(NUMPAD_F1)
 WXK_(NUMPAD_F2)
 WXK_(NUMPAD_F3)
 WXK_(NUMPAD_F4)
 WXK_(NUMPAD_HOME)
 WXK_(NUMPAD_LEFT)
 WXK_(NUMPAD_UP)
 WXK_(NUMPAD_RIGHT)
 WXK_(NUMPAD_DOWN)
 WXK_(NUMPAD_PAGEUP)
 WXK_(NUMPAD_PAGEDOWN)
 WXK_(NUMPAD_END)
 WXK_(NUMPAD_BEGIN)
 WXK_(NUMPAD_INSERT)
 WXK_(NUMPAD_DELETE)
 WXK_(NUMPAD_EQUAL)
 WXK_(NUMPAD_MULTIPLY)
 WXK_(NUMPAD_ADD)
 WXK_(NUMPAD_SEPARATOR)
 WXK_(NUMPAD_SUBTRACT)
 WXK_(NUMPAD_DECIMAL)
 WXK_(NUMPAD_DIVIDE)
 
 WXK_(WINDOWS_LEFT)
 WXK_(WINDOWS_RIGHT)
#ifdef __WXOSX__
 WXK_(RAW_CONTROL)
#endif
#undef WXK_
 
 default:
 return nullptr;
 }
}
 
 
// helper function that returns textual description of key in the event
wxString GetKeyName( const wxKeyEvent &aEvent )
{
 int keycode = aEvent.GetKeyCode();
 const char* virt = GetVirtualKeyCodeName( keycode );
 
 if( virt )
 return virt;
 
 if( keycode > 0 && keycode < 32 )
 return wxString::Format( "Ctrl-%c", (unsigned char)('A' + keycode - 1) );
 
 if( keycode >= 32 && keycode < 128 )
 return wxString::Format( "'%c'", (unsigned char)keycode );
 
#if wxUSE_UNICODE
 int uc = aEvent.GetUnicodeKey();
 
 if( uc != WXK_NONE )
 return wxString::Format( "'%c'", uc );
#endif
 
 return "unknown";
}
 
 
wxString dump( const wxKeyEvent& aEvent )
{
 wxString msg;
 wxString eventType = wxS( "unknown" );
 
 if( aEvent.GetEventType() == wxEVT_KEY_DOWN )
 eventType = wxS( "KeyDown" );
 else if( aEvent.GetEventType() == wxEVT_KEY_UP )
 eventType = wxS( "KeyUp" );
 else if( aEvent.GetEventType() == wxEVT_CHAR )
 eventType = wxS( "Char" );
 else if( aEvent.GetEventType() == wxEVT_CHAR_HOOK )
 eventType = wxS( "Hook" );
 
 // event key_name KeyCode modifiers Unicode raw_code raw_flags pos
 msg.Printf( "%7s %15s %5d %c%c%c%c"
#if wxUSE_UNICODE
 "%5d (U+%04x)"
#else
 " none "
#endif
#ifdef wxHAS_RAW_KEY_CODES
 " %7lu 0x%08lx"
#else
 " not-set not-set"
#endif
 " (%5d,%5d)",
 eventType,
 GetKeyName( aEvent ),
 aEvent.GetKeyCode(),
 aEvent.ControlDown() ? 'C' : '-',
 aEvent.AltDown() ? 'A' : '-',
 aEvent.ShiftDown() ? 'S' : '-',
 aEvent.MetaDown() ? 'M' : '-'
#if wxUSE_UNICODE
 , aEvent.GetUnicodeKey()
 , aEvent.GetUnicodeKey()
#endif
#ifdef wxHAS_RAW_KEY_CODES
 , (unsigned long) aEvent.GetRawKeyCode()
 , (unsigned long) aEvent.GetRawKeyFlags()
#endif
 , aEvent.GetX()
 , aEvent.GetY()
 );
 
 return msg;
}
 
 
TRACE_MANAGER& TRACE_MANAGER::Instance()
{
 static TRACE_MANAGER* self = nullptr;
 
 if( !self )
 {
 self = new TRACE_MANAGER;
 self->init();
 }
 
 return *self;
}
 
 
bool TRACE_MANAGER::IsTraceEnabled( const wxString& aWhat )
{
 if( !m_printAllTraces )
 {
 if( !m_globalTraceEnabled )
 return false;
 
 if( m_enabledTraces.find( aWhat ) == m_enabledTraces.end() )
 return false;
 }
 
 return true;
}
 
 
void TRACE_MANAGER::traceV( const wxString& aWhat, const wxString& aFmt, va_list vargs )
{
 if( !IsTraceEnabled( aWhat ) )
 return;
 
 wxString str;
 str.PrintfV( aFmt, vargs );
 
#if defined( __UNIX__ ) || defined( _WIN32 )
 fprintf( stderr, " %-30s | %s", aWhat.c_str().AsChar(), str.c_str().AsChar() );
#endif
}
 
 
void TRACE_MANAGER::init()
{
 wxString traceVars;
 m_globalTraceEnabled = wxGetEnv( wxT( "KICAD_TRACE" ), &traceVars );
 m_printAllTraces = false;
 
 if( !m_globalTraceEnabled )
 return;
 
 wxStringTokenizer tokenizer( traceVars, wxT( "," ) );
 
 while( tokenizer.HasMoreTokens() )
 {
 wxString token = tokenizer.GetNextToken();
 m_enabledTraces[token] = true;
 
 if( token.Lower() == wxT( "all" ) )
 m_printAllTraces = true;
 }
}