kicad/include/common.h

386 lines
12 KiB
C
Raw Normal View History

/**
* The common library
* @file common.h
*/
2007-05-06 16:03:28 +00:00
#ifndef __INCLUDE__COMMON_H__
#define __INCLUDE__COMMON_H__ 1
2007-05-06 16:03:28 +00:00
#include "wx/confbase.h"
#include "wx/fileconf.h"
class wxAboutDialogInfo;
class BASE_SCREEN;
class WinEDA_DrawFrame;
class WinEDAListBox;
class WinEDA_DrawPanel;
2007-05-06 16:03:28 +00:00
/* Flag for special keys */
2009-11-23 20:18:47 +00:00
#define GR_KB_RIGHTSHIFT 0x10000000 /* Keybd states: right
* shift key depressed */
#define GR_KB_LEFTSHIFT 0x20000000 /* left shift key depressed
*/
#define GR_KB_CTRL 0x40000000 /* CTRL depressed */
#define GR_KB_ALT 0x80000000 /* ALT depressed */
#define GR_KB_SHIFT (GR_KB_LEFTSHIFT | GR_KB_RIGHTSHIFT)
#define GR_KB_SHIFTCTRL (GR_KB_SHIFT | GR_KB_CTRL)
#define MOUSE_MIDDLE 0x08000000 /* Middle button mouse
* flag for block commands
*/
#define NB_ITEMS 11
/* Pseudo key codes for command panning */
2007-05-06 16:03:28 +00:00
enum pseudokeys {
EDA_PANNING_UP_KEY = 1,
EDA_PANNING_DOWN_KEY,
EDA_PANNING_LEFT_KEY,
EDA_PANNING_RIGHT_KEY,
EDA_ZOOM_IN_FROM_MOUSE,
EDA_ZOOM_OUT_FROM_MOUSE,
EDA_ZOOM_CENTER_FROM_MOUSE
2007-05-06 16:03:28 +00:00
};
#define ESC 27
/* TODO Executable names TODO*/
2007-05-06 16:03:28 +00:00
#ifdef __WINDOWS__
# define CVPCB_EXE wxT( "cvpcb.exe" )
# define PCBNEW_EXE wxT( "pcbnew.exe" )
# define EESCHEMA_EXE wxT( "eeschema.exe" )
# define GERBVIEW_EXE wxT( "gerbview.exe" )
2007-05-06 16:03:28 +00:00
#else
# ifndef __WXMAC__
# define CVPCB_EXE wxT( "cvpcb" )
# define PCBNEW_EXE wxT( "pcbnew" )
# define EESCHEMA_EXE wxT( "eeschema" )
# define GERBVIEW_EXE wxT( "gerbview" )
#else
# define CVPCB_EXE wxT( "cvpcb.app/Contents/MacOS/cvpcb" )
# define PCBNEW_EXE wxT( "pcbnew.app/Contents/MacOS/pcbnew" )
# define EESCHEMA_EXE wxT( "eeschema.app/Contents/MacOS/eeschema" )
# define GERBVIEW_EXE wxT( "gerbview.app/Contents/MacOS/gerbview" )
# endif
#endif
2007-05-06 16:03:28 +00:00
/* Graphic Texts Orientation in 0.1 degree*/
2009-11-23 20:18:47 +00:00
#define TEXT_ORIENT_HORIZ 0
#define TEXT_ORIENT_VERT 900
2007-05-06 16:03:28 +00:00
#define ON 1
#define OFF 0
2007-05-06 16:03:28 +00:00
#define INCHES 0
2007-05-06 16:03:28 +00:00
#define MILLIMETRE 1
#define CENTIMETRE 2
#if defined(KICAD_GOST)
2009-11-23 20:18:47 +00:00
#define LEFTMARGIN 800 /* 20mm */
#define RIGHTMARGIN 200 /* 5mm */
#define TOPMARGIN 200 /* 5mm */
#define BOTTOMMARGIN 200 /* 5mm */
#endif
2007-05-06 16:03:28 +00:00
/* forward declarations: */
class LibNameList;
/***********************************/
/* Class to display text */
/***********************************/
class WinEDA_TextFrame : public wxDialog
2007-05-06 16:03:28 +00:00
{
private:
wxWindow* m_Parent;
wxListBox* m_List;
2007-05-06 16:03:28 +00:00
public:
WinEDA_TextFrame( wxWindow* parent, const wxString& title );
2009-11-23 20:18:47 +00:00
void Append( const wxString& text );
2007-05-06 16:03:28 +00:00
private:
2009-11-23 20:18:47 +00:00
void D_ClickOnList( wxCommandEvent& event );
void OnClose( wxCloseEvent& event );
2007-05-06 16:03:28 +00:00
DECLARE_EVENT_TABLE()
2007-05-06 16:03:28 +00:00
};
2009-11-23 20:18:47 +00:00
/* Class to handle pages sizes:
*/
2007-05-06 16:03:28 +00:00
class Ki_PageDescr
{
2007-05-06 16:03:28 +00:00
// All sizes are in 1/1000 inch
public:
wxSize m_Size; /* page size in 1/1000 inch */
wxPoint m_Offset; /* plot offset in 1/1000 inch */
wxString m_Name;
int m_LeftMargin;
int m_RightMargin;
int m_TopMargin;
int m_BottomMargin;
2007-05-06 16:03:28 +00:00
public:
Ki_PageDescr( const wxSize& size, const wxPoint& offset,
const wxString& name );
2007-05-06 16:03:28 +00:00
};
2009-11-23 20:18:47 +00:00
extern Ki_PageDescr g_Sheet_A4;
extern Ki_PageDescr g_Sheet_A3;
extern Ki_PageDescr g_Sheet_A2;
extern Ki_PageDescr g_Sheet_A1;
extern Ki_PageDescr g_Sheet_A0;
extern Ki_PageDescr g_Sheet_A;
extern Ki_PageDescr g_Sheet_B;
extern Ki_PageDescr g_Sheet_C;
extern Ki_PageDescr g_Sheet_D;
extern Ki_PageDescr g_Sheet_E;
extern Ki_PageDescr g_Sheet_GERBER;
extern Ki_PageDescr g_Sheet_user;
extern Ki_PageDescr* g_SheetSizeList[];
2007-05-06 16:03:28 +00:00
2009-11-23 20:18:47 +00:00
extern wxString g_ProductName;
2007-05-06 16:03:28 +00:00
/* Default user lib path can be left void, if the standard lib path is used */
2009-11-23 20:18:47 +00:00
extern wxString g_UserLibDirBuffer;
2007-05-06 16:03:28 +00:00
2009-11-23 20:18:47 +00:00
extern int g_DebugLevel;
extern int g_MouseOldButtons;
extern int g_KeyPressed;
2009-11-23 20:18:47 +00:00
extern bool g_ShowPageLimits; // TRUE to display the page limits
/* File name extension definitions. */
extern const wxString ProjectFileExtension;
extern const wxString SchematicFileExtension;
extern const wxString BoardFileExtension;
extern const wxString NetlistFileExtension;
extern const wxString GerberFileExtension;
extern const wxString PdfFileExtension;
2007-05-06 16:03:28 +00:00
extern const wxString ProjectFileWildcard;
extern const wxString SchematicFileWildcard;
extern const wxString BoardFileWildcard;
extern const wxString NetlistFileWildcard;
extern const wxString GerberFileWildcard;
extern const wxString PdfFileWildcard;
extern const wxString AllFilesWildcard;
// Name of default configuration file. (kicad.pro)
2009-11-23 20:18:47 +00:00
extern wxString g_Prj_Default_Config_FullFilename;
// Name of local configuration file. (<curr projet>.pro)
2009-11-23 20:18:47 +00:00
extern wxString g_Prj_Config_LocalFilename;
2007-05-06 16:03:28 +00:00
2009-11-23 20:18:47 +00:00
extern int g_UnitMetric; // display units mm = 1, inches = 0, cm = 2
2007-05-06 16:03:28 +00:00
/* Draw color for moving objects: */
2009-11-23 20:18:47 +00:00
extern int g_GhostColor;
2007-05-06 16:03:28 +00:00
/* Draw color for grid: */
2009-11-23 20:18:47 +00:00
extern int g_GridColor;
2007-05-06 16:03:28 +00:00
/* Current used screen: (not used in eeshema)*/
extern BASE_SCREEN* ActiveScreen;
2007-05-06 16:03:28 +00:00
/* COMMON.CPP */
2008-04-24 16:55:35 +00:00
2008-06-06 16:39:45 +00:00
/** function SetLocaleTo_C_standard
2009-11-23 20:18:47 +00:00
* because kicad is internationalized, switch internalization to "C" standard
* i.e. uses the . (dot) as separator in print/read float numbers
* (some countries (France, Germany ..) use , (comma) as separator)
* This function must be called before read or write ascii files using float
* numbers in data the SetLocaleTo_C_standard function must be called after
* reading or writing the file
*
* This is wrapper to the C setlocale( LC_NUMERIC, "C" ) function,
* but could make more easier an optional use of locale in kicad
*/
void SetLocaleTo_C_standard( void );
2008-06-06 16:39:45 +00:00
/** function SetLocaleTo_Default
2009-11-23 20:18:47 +00:00
* because kicad is internationalized, switch internalization to default
* to use the default separator in print/read float numbers
* (. (dot) but some countries (France, Germany ..) use , (comma) as
* separator)
* This function must be called after a call to SetLocaleTo_C_standard
*
* This is wrapper to the C setlocale( LC_NUMERIC, "" ) function,
* but could make more easier an optional use of locale in kicad
*/
void SetLocaleTo_Default( void );
2008-04-24 16:55:35 +00:00
/**
* Function EnsureTextCtrlWidth
2009-11-23 20:18:47 +00:00
* sets the minimum pixel width on a text control in order to make a text
* string be fully visible within it. The current font within the text
* control is considered.
* The text can come either from the control or be given as an argument.
* If the text control is larger than needed, then nothing is done.
* @param aCtrl the text control to potentially make wider.
2009-11-23 20:18:47 +00:00
* @param aString the text that is used in sizing the control's pixel width.
* If NULL, then
* the text already within the control is used.
* @return bool - true if the \a aCtrl had its size changed, else false.
*/
2009-11-23 20:18:47 +00:00
bool EnsureTextCtrlWidth( wxTextCtrl* aCtrl,
const wxString* aString = NULL );
2008-05-05 19:47:58 +00:00
/**
* Operator << overload
* outputs a point to the argument string in a format resembling
* "@ (x,y)
* @param aString Where to put the text describing the point value
* @param aPoint The point to output.
* @return wxString& - the input string
*/
2009-11-23 20:18:47 +00:00
wxString& operator <<( wxString& aString, const wxPoint& aPoint );
2008-05-05 19:47:58 +00:00
2008-04-24 16:55:35 +00:00
/**
* Function ProcessExecute
* runs a child process.
2009-11-23 20:18:47 +00:00
* @param aCommandLine The process and any arguments to it all in a single
* string.
2008-04-24 16:55:35 +00:00
* @param aFlags The same args as allowed for wxExecute()
* @return bool - true if success, else false
*/
2009-11-23 20:18:47 +00:00
bool ProcessExecute( const wxString& aCommandLine,
int aFlags = wxEXEC_ASYNC );
2008-04-24 16:55:35 +00:00
/**
* Function ReturnPcbLayerName
* @return a wxString containing the name of the layer number "layer_number".
* @param layer_number the layer number of the layer
* @param is_filename if TRUE, the name can be used for a file name (not
2009-11-23 20:18:47 +00:00
* internationalized, no space)
*/
2009-11-23 20:18:47 +00:00
wxString ReturnPcbLayerName( int layer_number,
bool is_filename = FALSE );
2007-05-06 16:03:28 +00:00
2008-08-15 16:38:05 +00:00
/*******************/
/* about_kicad.cpp */
/*******************/
2009-11-23 20:18:47 +00:00
void InitKiCadAbout( wxAboutDialogInfo& info );
2008-08-15 16:38:05 +00:00
2007-05-06 16:03:28 +00:00
/**************/
/* common.cpp */
/**************/
2009-11-23 20:18:47 +00:00
wxString GetBuildVersion(); /* Return the build date */
wxString GetAboutBuildVersion(); /* Return custom build date for about
* dialog */
2009-06-13 17:06:07 +00:00
/**
* function Affiche_1_Parametre
* Routine to display a parameter.
* = POS_X horizontal framing
* If POS_X <0: horizontal position is the last
* Required value> = 0
* Texte_H = text to be displayed in top line.
* If "by posting on this line
* Texte_L = text to be displayed in bottom line.
* If "by posting on this line
* Color = color display
*/
2009-11-23 20:18:47 +00:00
void Affiche_1_Parametre( WinEDA_DrawFrame* frame,
int pos_X,
const wxString& texte_H,
const wxString& texte_L,
int color );
2009-11-23 20:18:47 +00:00
int GetTimeStamp();
2009-11-23 20:18:47 +00:00
int DisplayColorFrame( wxWindow* parent, int OldColor );
int GetCommandOptions( const int argc, const char** argv,
const char* stringtst, const char** optarg,
int* optind );
/* Returns to display the value of a parameter, by type of units selected
* Input: value in mils, buffer text
* Returns to buffer: text: value expressed in inches or millimeters
* Followed by " or mm
*/
const wxString& valeur_param( int valeur, wxString& buf_texte );
2009-11-23 20:18:47 +00:00
wxString ReturnUnitSymbol( int Units = g_UnitMetric );
/**
* Get a human readable units string.
*
* The strings returned are full text name and not abbreviations or symbolic
* representations of units. Set ReturnUnitSymbol() for that.
*
* @param units - The units text to return.
* @return The human readable units string.
*/
2009-11-23 20:18:47 +00:00
wxString GetUnitsLabel( int units );
2009-11-23 20:18:47 +00:00
int ReturnValueFromString( int Units, const wxString& TextValue,
int Internal_Unit );
2008-09-09 11:32:21 +00:00
/** Function ReturnStringFromValue
* Return the string from Value, according to units (inch, mm ...) for display,
* and the initial unit for value
* @param aUnit = display units (INCHES, MILLIMETRE ..)
* @param aValue = value in Internal_Unit
* @param aInternal_Unit = units per inch for Value
* @param aAdd_unit_symbol = true to add symbol unit to the string value
2009-11-23 20:18:47 +00:00
* @return a wxString what contains value and optionally the symbol unit (like
* 2.000 mm)
2008-09-09 11:32:21 +00:00
*/
2009-11-23 20:18:47 +00:00
wxString ReturnStringFromValue( int aUnits,
int aValue,
int aInternal_Unit,
bool aAdd_unit_symbol = false );
2009-11-23 20:18:47 +00:00
void AddUnitSymbol( wxStaticText& Stext, int Units = g_UnitMetric );
2008-09-09 11:32:21 +00:00
/* Add string " (mm):" or " ("):" to the static text Stext.
* Used in dialog boxes for entering values depending on selected units */
2009-11-23 20:18:47 +00:00
void PutValueInLocalUnits( wxTextCtrl& TextCtr, int Value,
int Internal_Unit );
/* Convert the number Value in a string according to the internal units
2009-11-23 20:18:47 +00:00
* and the selected unit (g_UnitMetric) and put it in the wxTextCtrl TextCtrl
**/
int ReturnValueFromTextCtrl( const wxTextCtrl& TextCtr,
int Internal_Unit );
2009-11-23 20:18:47 +00:00
/* return a String List from a string, with a specific splitter*/
wxArrayString* wxStringSplit( wxString txt, wxChar splitter );
/**
* Function To_User_Unit
* Convert in inch or mm the variable "val" (double)given in internal units
* @return the converted value, in double
2009-11-23 20:18:47 +00:00
* @param is_metric : true if the result must be returned in mm , false if
* inches
* @param val : double : the given value
* @param internal_unit_value = internal units per inch
*/
2009-11-23 20:18:47 +00:00
double To_User_Unit( bool is_metric,
double val,
int internal_unit_value );
int From_User_Unit( bool is_metric,
double val,
int internal_unit_value );
wxString GenDate();
void MyFree( void* pt_mem );
void* MyZMalloc( size_t nb_octets );
void* MyMalloc( size_t nb_octets );
2007-05-06 16:03:28 +00:00
#endif /* __INCLUDE__COMMON_H__ */