/********************************************************/ /* class_module.cpp : TEXT_MODULE class implementation. */ /********************************************************/ #include "fctsys.h" #include "gr_basic.h" #include "wxstruct.h" #include "pcbnew.h" #include "trigo.h" #include "class_drawpanel.h" #include "drawtxt.h" #include "kicad_string.h" #include "pcbcommon.h" #include "class_board_design_settings.h" #include "colors_selection.h" #include "richio.h" /*******************************************************************/ /* Class TEXTE_MODULE base class type of text elements in a module */ /*******************************************************************/ TEXTE_MODULE::TEXTE_MODULE( MODULE* parent, int text_type ) : BOARD_ITEM( parent, TYPE_TEXTE_MODULE ), EDA_TEXT() { MODULE* Module = (MODULE*) m_Parent; m_Type = text_type; /* Reference */ if( (m_Type != TEXT_is_REFERENCE) && (m_Type != TEXT_is_VALUE) ) m_Type = TEXT_is_DIVERS; m_NoShow = false; m_Size.x = m_Size.y = 400; m_Thickness = 120; /* Set default dimension to a reasonable value. */ SetLayer( SILKSCREEN_N_FRONT ); if( Module && ( Module->Type() == TYPE_MODULE ) ) { m_Pos = Module->m_Pos; int moduleLayer = Module->GetLayer(); if( moduleLayer == LAYER_N_BACK ) SetLayer( SILKSCREEN_N_BACK ); else if( moduleLayer == LAYER_N_FRONT ) SetLayer( SILKSCREEN_N_FRONT ); else SetLayer( moduleLayer ); if( moduleLayer == SILKSCREEN_N_BACK || moduleLayer == ADHESIVE_N_BACK || moduleLayer == LAYER_N_BACK ) { m_Mirror = true; } } } TEXTE_MODULE::~TEXTE_MODULE() { } /** * Function Save * writes the data structures for this object out to a FILE in "*.brd" format. * @param aFile The FILE to write to. * @return bool - true if success writing else false. */ bool TEXTE_MODULE::Save( FILE* aFile ) const { MODULE* parent = (MODULE*) GetParent(); int orient = m_Orient; // Due to the pcbnew history, m_Orient is saved in screen value // but it is handled as relative to its parent footprint if( parent ) orient += parent->m_Orient; int ret = fprintf( aFile, "T%d %d %d %d %d %d %d %c %c %d %c %s\n", m_Type, m_Pos0.x, m_Pos0.y, m_Size.y, m_Size.x, orient, m_Thickness, m_Mirror ? 'M' : 'N', m_NoShow ? 'I' : 'V', GetLayer(), m_Italic ? 'I' : 'N', EscapedUTF8( m_Text ).c_str() ); return ret > 20; } /** * Function ReadDescr * Read description from a given line in "*.brd" format. * @param aReader The line reader object which contains the first line of description. * @return int - > 0 if success reading else 0. */ int TEXTE_MODULE::ReadDescr( LINE_READER* aReader ) { int success = true; int type; char BufCar1[128], BufCar2[128], BufCar3[128]; char* line = aReader->Line(); int layer = SILKSCREEN_N_FRONT; BufCar1[0] = 0; BufCar2[0] = 0; BufCar3[0] = 0; if( sscanf( line + 1, "%d %d %d %d %d %d %d %s %s %d %s", &type, &m_Pos0.x, &m_Pos0.y, &m_Size.y, &m_Size.x, &m_Orient, &m_Thickness, BufCar1, BufCar2, &layer, BufCar3 ) >= 10 ) { success = true; } if( (type != TEXT_is_REFERENCE) && (type != TEXT_is_VALUE) ) type = TEXT_is_DIVERS; m_Type = type; // Due to the pcbnew history, .m_Orient is saved in screen value // but it is handled as relative to its parent footprint m_Orient -= ( (MODULE*) m_Parent )->m_Orient; if( BufCar1[0] == 'M' ) m_Mirror = true; else m_Mirror = false; if( BufCar2[0] == 'I' ) m_NoShow = true; else m_NoShow = false; if( BufCar3[0] == 'I' ) m_Italic = true; else m_Italic = false; // Test for a reasonable layer: if( layer < 0 ) layer = 0; if( layer > LAST_NO_COPPER_LAYER ) layer = LAST_NO_COPPER_LAYER; if( layer == LAYER_N_BACK ) layer = SILKSCREEN_N_BACK; else if( layer == LAYER_N_FRONT ) layer = SILKSCREEN_N_FRONT; SetLayer( layer ); // Calculate the actual position. SetDrawCoord(); // Search and read the "text" string (a quoted text). ReadDelimitedText( &m_Text, line ); // Test for a reasonable size: if( m_Size.x < TEXTS_MIN_SIZE ) m_Size.x = TEXTS_MIN_SIZE; if( m_Size.y < TEXTS_MIN_SIZE ) m_Size.y = TEXTS_MIN_SIZE; // Set a reasonable width: if( m_Thickness < 1 ) m_Thickness = 1; m_Thickness = Clamp_Text_PenSize( m_Thickness, m_Size ); return success; } void TEXTE_MODULE::Copy( TEXTE_MODULE* source ) { if( source == NULL ) return; m_Pos = source->m_Pos; SetLayer( source->GetLayer() ); m_Mirror = source->m_Mirror; m_NoShow = source->m_NoShow; m_Type = source->m_Type; m_Orient = source->m_Orient; m_Pos0 = source->m_Pos0; m_Size = source->m_Size; m_Thickness = source->m_Thickness; m_Italic = source->m_Italic; m_Bold = source->m_Bold; m_Text = source->m_Text; } int TEXTE_MODULE:: GetLength() const { return m_Text.Len(); } // Update draw coordinates void TEXTE_MODULE:: SetDrawCoord() { MODULE* Module = (MODULE*) m_Parent; m_Pos = m_Pos0; if( Module == NULL ) return; int angle = Module->m_Orient; NORMALIZE_ANGLE_POS( angle ); RotatePoint( &m_Pos.x, &m_Pos.y, angle ); m_Pos += Module->m_Pos; } // Update "local" coordinates (coordinates relatives to the footprint // anchor point) void TEXTE_MODULE:: SetLocalCoord() { MODULE* Module = (MODULE*) m_Parent; if( Module == NULL ) { m_Pos0 = m_Pos; return; } m_Pos0 = m_Pos - Module->m_Pos; int angle = Module->m_Orient; NORMALIZE_ANGLE_POS( angle ); RotatePoint( &m_Pos0.x, &m_Pos0.y, -angle ); } /** * Function GetTextRect * @return an EDA_RECT which gives the position and size of the text area * (for the footprint orientation) */ EDA_RECT TEXTE_MODULE::GetTextRect( void ) const { EDA_RECT area; int dx, dy; dx = ( m_Size.x * GetLength() ) / 2; dx = (dx * 10) / 9; /* letter size = 10/9 */ dx += m_Thickness / 2; dy = ( m_Size.y + m_Thickness ) / 2; wxPoint Org = m_Pos; // This is the position of the center of the area Org.x -= dx; Org.y -= dy; area.SetOrigin( Org ); area.SetHeight( 2 * dy ); area.SetWidth( 2 * dx ); area.Normalize(); return area; } /** * Function HitTest * tests if the given wxPoint is within the bounds of this object. * @param aRefPos A wxPoint to test * @return true if a hit, else false */ bool TEXTE_MODULE::HitTest( const wxPoint& aRefPos ) { wxPoint rel_pos; EDA_RECT area = GetTextRect(); /* Rotate refPos to - angle * to test if refPos is within area (which is relative to an horizontal * text) */ rel_pos = aRefPos; RotatePoint( &rel_pos, m_Pos, -GetDrawRotation() ); if( area.Contains( rel_pos ) ) return true; return false; } /** * Function GetBoundingBox * returns the bounding box of this Text (according to text and footprint * orientation) */ EDA_RECT TEXTE_MODULE::GetBoundingBox() const { // Calculate area without text fields: EDA_RECT text_area; int angle = GetDrawRotation(); wxPoint textstart, textend; text_area = GetTextRect(); textstart = text_area.GetOrigin(); textend = text_area.GetEnd(); RotatePoint( &textstart, m_Pos, angle ); RotatePoint( &textend, m_Pos, angle ); text_area.SetOrigin( textstart ); text_area.SetEnd( textend ); text_area.Normalize(); return text_area; } /** * Function Draw * Draw the text according to the footprint pos and orient * @param panel = draw panel, Used to know the clip box * @param DC = Current Device Context * @param offset = draw offset (usually wxPoint(0,0) * @param draw_mode = GR_OR, GR_XOR.. */ void TEXTE_MODULE::Draw( EDA_DRAW_PANEL* panel, wxDC* DC, int draw_mode, const wxPoint& offset ) { int width, color, orient; wxSize size; wxPoint pos; // Center of text PCB_BASE_FRAME* frame; MODULE* Module = (MODULE*) m_Parent; /* parent must *not* be null * (a module text without a footprint * parent has no sense) */ if( panel == NULL ) return; frame = (PCB_BASE_FRAME*) panel->GetParent(); pos.x = m_Pos.x - offset.x; pos.y = m_Pos.y - offset.y; size = m_Size; orient = GetDrawRotation(); width = m_Thickness; if( ( frame->m_DisplayModText == FILAIRE ) || ( DC->LogicalToDeviceXRel( width ) < L_MIN_DESSIN ) ) width = 0; else if( frame->m_DisplayModText == SKETCH ) width = -width; GRSetDrawMode( DC, draw_mode ); BOARD * brd = GetBoard( ); if( brd->IsElementVisible( ANCHOR_VISIBLE ) ) { color = brd->GetVisibleElementColor(ANCHOR_VISIBLE); int anchor_size = DC->DeviceToLogicalXRel( 2 ); GRLine( &panel->m_ClipBox, DC, pos.x - anchor_size, pos.y, pos.x + anchor_size, pos.y, 0, color ); GRLine( &panel->m_ClipBox, DC, pos.x, pos.y - anchor_size, pos.x, pos.y + anchor_size, 0, color ); } color = brd->GetLayerColor(Module->GetLayer()); if( Module->GetLayer() == LAYER_N_BACK ) { if( brd->IsElementVisible( MOD_TEXT_BK_VISIBLE ) == false ) return; color = brd->GetVisibleElementColor(MOD_TEXT_BK_VISIBLE); } else if( Module->GetLayer() == LAYER_N_FRONT ) { if( brd->IsElementVisible( MOD_TEXT_FR_VISIBLE ) == false ) return; color = brd->GetVisibleElementColor(MOD_TEXT_FR_VISIBLE); } if( m_NoShow ) { if( brd->IsElementVisible( MOD_TEXT_INVISIBLE ) == false ) return; color = brd->GetVisibleElementColor(MOD_TEXT_INVISIBLE); } /* If the text is mirrored : negate size.x (mirror / Y axis) */ if( m_Mirror ) size.x = -size.x; DrawGraphicText( panel, DC, pos, (enum EDA_Colors) color, m_Text, orient, size, m_HJustify, m_VJustify, width, m_Italic, m_Bold ); } /* Draws a line from the TEXTE_MODULE origin to parent MODULE origin. */ void TEXTE_MODULE::DrawUmbilical( EDA_DRAW_PANEL* aPanel, wxDC* aDC, int aDrawMode, const wxPoint& aOffset ) { MODULE* parent = (MODULE*) GetParent(); if( !parent ) return; GRSetDrawMode( aDC, GR_XOR ); GRLine( &aPanel->m_ClipBox, aDC, parent->GetPosition(), GetPosition() + aOffset, 0, UMBILICAL_COLOR); } /* Return text rotation for drawings and plotting */ int TEXTE_MODULE::GetDrawRotation() const { int rotation; MODULE* Module = (MODULE*) m_Parent; rotation = m_Orient; if( Module ) rotation += Module->m_Orient; NORMALIZE_ANGLE_POS( rotation ); // For angle = 0 .. 180 deg while( rotation > 900 ) rotation -= 1800; return rotation; } // see class_text_mod.h void TEXTE_MODULE::DisplayInfo( EDA_DRAW_FRAME* frame ) { MODULE* module = (MODULE*) m_Parent; if( module == NULL ) // Happens in modedit, and for new texts return; wxString msg, Line; int ii; static const wxString text_type_msg[3] = { _( "Ref." ), _( "Value" ), _( "Text" ) }; frame->ClearMsgPanel(); Line = module->m_Reference->m_Text; frame->AppendMsgPanel( _( "Module" ), Line, DARKCYAN ); Line = m_Text; frame->AppendMsgPanel( _( "Text" ), Line, BROWN ); ii = m_Type; if( ii > 2 ) ii = 2; frame->AppendMsgPanel( _( "Type" ), text_type_msg[ii], DARKGREEN ); if( m_NoShow ) msg = _( "No" ); else msg = _( "Yes" ); frame->AppendMsgPanel( _( "Display" ), msg, DARKGREEN ); // Display text layer (use layer name if possible) BOARD* board = NULL; board = (BOARD*) module->GetParent(); if( m_Layer < NB_LAYERS && board ) msg = board->GetLayerName( m_Layer ); else msg.Printf( wxT( "%d" ), m_Layer ); frame->AppendMsgPanel( _( "Layer" ), msg, DARKGREEN ); msg = _( " No" ); if( m_Mirror ) msg = _( " Yes" ); frame->AppendMsgPanel( _( "Mirror" ), msg, DARKGREEN ); msg.Printf( wxT( "%.1f" ), (float) m_Orient / 10 ); frame->AppendMsgPanel( _( "Orient" ), msg, DARKGREEN ); valeur_param( m_Thickness, msg ); frame->AppendMsgPanel( _( "Thickness" ), msg, DARKGREEN ); valeur_param( m_Size.x, msg ); frame->AppendMsgPanel( _( "H Size" ), msg, RED ); valeur_param( m_Size.y, msg ); frame->AppendMsgPanel( _( "V Size" ), msg, RED ); } // see class_text_mod.h bool TEXTE_MODULE::IsOnLayer( int aLayer ) const { if( m_Layer == aLayer ) return true; /* test the parent, which is a MODULE */ if( aLayer == GetParent()->GetLayer() ) return true; if( aLayer == LAYER_N_BACK ) { if( m_Layer==ADHESIVE_N_BACK || m_Layer==SILKSCREEN_N_BACK ) return true; } else if( aLayer == LAYER_N_FRONT ) { if( m_Layer==ADHESIVE_N_FRONT || m_Layer==SILKSCREEN_N_FRONT ) return true; } return false; } /* see class_text_mod.h * bool TEXTE_MODULE::IsOnOneOfTheseLayers( int aLayerMask ) const * { * * } */ wxString TEXTE_MODULE::GetSelectMenuText() const { wxString text; switch( m_Type ) { case TEXT_is_REFERENCE: text << _( "Reference" ) << wxT( " " ) << m_Text; break; case TEXT_is_VALUE: text << _( "Value" ) << wxT( " " ) << m_Text << _( " of " ) << ( (MODULE*) GetParent() )->GetReference(); break; default: // wrap this one in quotes: text << _( "Text" ) << wxT( " \"" ) << m_Text << wxT( "\"" ) << _( " of " ) << ( (MODULE*) GetParent() )->GetReference(); break; } return text; } #if defined(DEBUG) /** * Function Show * is used to output the object tree, currently for debugging only. * @param nestLevel An aid to prettier tree indenting, and is the level * of nesting of this object within the overall tree. * @param os The ostream& to output to. */ void TEXTE_MODULE::Show( int nestLevel, std::ostream& os ) { // for now, make it look like XML: NestedSpace( nestLevel, os ) << '<' << GetClass().Lower().mb_str() << " string=\"" << m_Text.mb_str() << "\"/>\n"; // NestedSpace( nestLevel, os ) << "\n"; } #endif