2020-05-16 22:30:30 +00:00
|
|
|
/*
|
|
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2020 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
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <widgets/paged_dialog.h>
|
|
|
|
#include <pcb_edit_frame.h>
|
|
|
|
#include <project.h>
|
|
|
|
#include <tool/tool_manager.h>
|
|
|
|
#include <drc/drc.h>
|
|
|
|
#include <panel_setup_rules.h>
|
2020-05-25 20:44:49 +00:00
|
|
|
#include <html_messagebox.h>
|
2020-05-16 22:30:30 +00:00
|
|
|
|
|
|
|
PANEL_SETUP_RULES::PANEL_SETUP_RULES( PAGED_DIALOG* aParent, PCB_EDIT_FRAME* aFrame ) :
|
|
|
|
PANEL_SETUP_RULES_BASE( aParent->GetTreebook() ),
|
|
|
|
m_frame( aFrame ),
|
|
|
|
m_lastCaretPos( -1 )
|
|
|
|
{
|
|
|
|
m_textEditor->SetIndentationGuides( wxSTC_IV_LOOKBOTH );
|
|
|
|
|
|
|
|
wxColour highlight = wxSystemSettings::GetColour( wxSYS_COLOUR_HIGHLIGHT );
|
|
|
|
wxColour highlightText = wxSystemSettings::GetColour( wxSYS_COLOUR_WINDOWTEXT );
|
|
|
|
|
|
|
|
if( KIGFX::COLOR4D( highlightText ).GetBrightness() > 0.5 )
|
|
|
|
highlight = highlight.ChangeLightness( 75 );
|
|
|
|
else
|
|
|
|
highlight = highlight.ChangeLightness( 125 );
|
|
|
|
|
|
|
|
m_textEditor->StyleSetForeground( wxSTC_STYLE_BRACELIGHT, highlightText );
|
|
|
|
m_textEditor->StyleSetBackground( wxSTC_STYLE_BRACELIGHT, highlight );
|
|
|
|
m_textEditor->StyleSetForeground( wxSTC_STYLE_BRACEBAD, *wxRED );
|
|
|
|
|
2020-05-25 20:44:49 +00:00
|
|
|
int size = wxNORMAL_FONT->GetPointSize();
|
2020-05-26 15:17:29 +00:00
|
|
|
wxFont fixedFont( size, wxFONTFAMILY_TELETYPE, wxFONTSTYLE_NORMAL, wxFONTWEIGHT_NORMAL );
|
2020-05-25 20:44:49 +00:00
|
|
|
|
|
|
|
for( size_t i = 0; i < wxSTC_STYLE_MAX; ++i )
|
|
|
|
m_textEditor->StyleSetFont( i, fixedFont );
|
|
|
|
|
2020-05-24 23:43:19 +00:00
|
|
|
m_textEditor->Bind( wxEVT_STC_CHARADDED, &PANEL_SETUP_RULES::onScintillaCharAdded, this );
|
2020-05-16 22:30:30 +00:00
|
|
|
m_textEditor->Bind( wxEVT_STC_UPDATEUI, &PANEL_SETUP_RULES::onScintillaUpdateUI, this );
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2020-05-24 23:43:19 +00:00
|
|
|
void PANEL_SETUP_RULES::onScintillaCharAdded( wxStyledTextEvent &aEvent )
|
|
|
|
{
|
|
|
|
constexpr int flags = wxSTC_FIND_REGEXP| wxSTC_FIND_POSIX;
|
|
|
|
|
|
|
|
m_textEditor->SearchAnchor();
|
|
|
|
|
|
|
|
int i = std::max( 0, m_textEditor->SearchPrev( flags, "\( *rule " ) );
|
|
|
|
int currentPos = m_textEditor->GetCurrentPos();
|
|
|
|
|
|
|
|
enum
|
|
|
|
{
|
|
|
|
NONE,
|
|
|
|
STRING,
|
|
|
|
SEXPR_OPEN,
|
|
|
|
SEXPR_TOKEN,
|
|
|
|
};
|
|
|
|
|
|
|
|
std::stack<wxString> sexprs;
|
|
|
|
wxString partial;
|
|
|
|
int context = NONE;
|
|
|
|
|
|
|
|
for( ; i < currentPos; ++i )
|
|
|
|
{
|
|
|
|
char c = (char) m_textEditor->GetCharAt( i );
|
|
|
|
|
|
|
|
if( c == '\\' )
|
|
|
|
{
|
|
|
|
i++; // skip escaped char
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
if( context == STRING )
|
|
|
|
{
|
|
|
|
if( c == '"' )
|
|
|
|
context = NONE;
|
|
|
|
else
|
|
|
|
partial += c;
|
|
|
|
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
if( c == '"' )
|
|
|
|
{
|
|
|
|
partial = wxEmptyString;
|
|
|
|
context = STRING;
|
|
|
|
}
|
|
|
|
else if( c == '(' )
|
|
|
|
{
|
|
|
|
if( context == SEXPR_OPEN && !partial.IsEmpty() )
|
2020-05-25 20:44:49 +00:00
|
|
|
{
|
|
|
|
m_textEditor->AutoCompCancel();
|
2020-05-24 23:43:19 +00:00
|
|
|
sexprs.push( partial );
|
2020-05-25 20:44:49 +00:00
|
|
|
}
|
2020-05-24 23:43:19 +00:00
|
|
|
|
|
|
|
partial = wxEmptyString;
|
|
|
|
context = SEXPR_OPEN;
|
|
|
|
}
|
|
|
|
else if( c == ')' )
|
|
|
|
{
|
|
|
|
sexprs.pop();
|
|
|
|
context = NONE;
|
|
|
|
}
|
|
|
|
else if( c == ' ' )
|
|
|
|
{
|
|
|
|
if( context == SEXPR_OPEN && !partial.IsEmpty() )
|
|
|
|
{
|
2020-05-25 20:44:49 +00:00
|
|
|
m_textEditor->AutoCompCancel();
|
2020-05-24 23:43:19 +00:00
|
|
|
sexprs.push( partial );
|
|
|
|
|
2020-05-25 23:08:27 +00:00
|
|
|
if( sexprs.size()
|
|
|
|
&& ( sexprs.top() == "constraint" || sexprs.top() == "disallow" ) )
|
2020-05-24 23:43:19 +00:00
|
|
|
{
|
|
|
|
partial = wxEmptyString;
|
|
|
|
context = SEXPR_TOKEN;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
context = NONE;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
partial += c;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-05-25 23:08:27 +00:00
|
|
|
auto autocomplete = [this]( const wxString& aPartial, const wxString& aTokenStr )
|
2020-05-25 20:44:49 +00:00
|
|
|
{
|
2020-05-25 23:08:27 +00:00
|
|
|
wxArrayString tokens = wxSplit( aTokenStr, ' ' );
|
|
|
|
bool match = aPartial.IsEmpty();
|
2020-05-25 20:44:49 +00:00
|
|
|
|
2020-05-25 23:08:27 +00:00
|
|
|
for( size_t ii = 0; ii < tokens.size() && !match; ++ii )
|
|
|
|
match = tokens[ii].StartsWith( aPartial );
|
2020-05-25 20:44:49 +00:00
|
|
|
|
|
|
|
if( match )
|
2020-05-25 23:08:27 +00:00
|
|
|
m_textEditor->AutoCompShow( aPartial.size(), aTokenStr );
|
2020-05-25 20:44:49 +00:00
|
|
|
};
|
|
|
|
|
2020-05-24 23:43:19 +00:00
|
|
|
// NB: tokens MUST be in alphabetical order because the Scintilla engine is going
|
|
|
|
// to do a binary search on them
|
|
|
|
wxString tokens;
|
|
|
|
|
|
|
|
if( context == SEXPR_OPEN )
|
|
|
|
{
|
|
|
|
if( sexprs.empty() )
|
|
|
|
tokens = "rule version";
|
|
|
|
else if( sexprs.top() == "rule" )
|
|
|
|
tokens = "condition constraint disallow";
|
|
|
|
else if( sexprs.top() == "constraint" )
|
|
|
|
tokens = "max min opt";
|
|
|
|
|
|
|
|
if( !tokens.IsEmpty() )
|
2020-05-25 20:44:49 +00:00
|
|
|
autocomplete( partial, tokens );
|
2020-05-24 23:43:19 +00:00
|
|
|
}
|
|
|
|
else if( context == SEXPR_TOKEN )
|
|
|
|
{
|
|
|
|
if( sexprs.top() == "constraint" )
|
|
|
|
tokens = "annulus_width clearance hole track_width";
|
|
|
|
else if( sexprs.top() == "disallow" )
|
2020-05-25 17:46:06 +00:00
|
|
|
tokens = "buried_via graphic hole micro_via pad text track via zone";
|
2020-05-24 23:43:19 +00:00
|
|
|
|
|
|
|
if( !tokens.IsEmpty() )
|
2020-05-25 20:44:49 +00:00
|
|
|
autocomplete( partial, tokens );
|
2020-05-24 23:43:19 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2020-05-16 22:30:30 +00:00
|
|
|
void PANEL_SETUP_RULES::onScintillaUpdateUI( wxStyledTextEvent& aEvent )
|
|
|
|
{
|
|
|
|
auto isBrace = []( int c ) -> bool
|
|
|
|
{
|
|
|
|
return c == '(' || c == ')';
|
|
|
|
};
|
|
|
|
|
|
|
|
// Has the caret changed position?
|
|
|
|
int caretPos = m_textEditor->GetCurrentPos();
|
|
|
|
|
|
|
|
if( m_lastCaretPos != caretPos )
|
|
|
|
{
|
|
|
|
m_lastCaretPos = caretPos;
|
|
|
|
int bracePos1 = -1;
|
|
|
|
int bracePos2 = -1;
|
|
|
|
|
|
|
|
// Is there a brace to the left or right?
|
|
|
|
if( caretPos > 0 && isBrace( m_textEditor->GetCharAt( caretPos-1 ) ) )
|
|
|
|
bracePos1 = ( caretPos - 1 );
|
|
|
|
else if( isBrace( m_textEditor->GetCharAt( caretPos ) ) )
|
|
|
|
bracePos1 = caretPos;
|
|
|
|
|
|
|
|
if( bracePos1 >= 0 )
|
|
|
|
{
|
|
|
|
// Find the matching brace
|
|
|
|
bracePos2 = m_textEditor->BraceMatch( bracePos1 );
|
|
|
|
|
|
|
|
if( bracePos2 == -1 )
|
|
|
|
{
|
|
|
|
m_textEditor->BraceBadLight( bracePos1 );
|
|
|
|
m_textEditor->SetHighlightGuide( 0 );
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
m_textEditor->BraceHighlight( bracePos1, bracePos2 );
|
|
|
|
m_textEditor->SetHighlightGuide( m_textEditor->GetColumn( bracePos1 ) );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
// Turn off brace matching
|
|
|
|
m_textEditor->BraceHighlight( -1, -1 );
|
|
|
|
m_textEditor->SetHighlightGuide( 0 );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
bool PANEL_SETUP_RULES::TransferDataToWindow()
|
|
|
|
{
|
|
|
|
wxString rulesFilepath = m_frame->Prj().AbsolutePath( "drc-rules" );
|
|
|
|
wxFileName rulesFile( rulesFilepath );
|
|
|
|
|
|
|
|
if( rulesFile.FileExists() )
|
|
|
|
m_textEditor->LoadFile( rulesFile.GetFullPath() );
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
bool PANEL_SETUP_RULES::TransferDataFromWindow()
|
|
|
|
{
|
|
|
|
if( m_textEditor->SaveFile( m_frame->Prj().AbsolutePath( "drc-rules" ) ) )
|
|
|
|
{
|
|
|
|
m_frame->GetToolManager()->GetTool<DRC>()->Reset( TOOL_BASE::MODEL_RELOAD );
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2020-05-25 20:44:49 +00:00
|
|
|
void PANEL_SETUP_RULES::OnSyntaxHelp( wxHyperlinkEvent& aEvent )
|
|
|
|
{
|
2020-05-26 15:17:29 +00:00
|
|
|
// Do not make this full sentence translatable: it contains keywords
|
|
|
|
// Only a few titles can be traslated.
|
|
|
|
wxString msg =
|
2020-05-25 20:44:49 +00:00
|
|
|
"<b>Top-level Expressions</b>"
|
|
|
|
"<pre>"
|
2020-05-26 15:17:29 +00:00
|
|
|
"(version <number>)<br>"
|
|
|
|
"(rule <rule_name> <rule_expression> ...)<br>"
|
|
|
|
"<br></pre>"
|
2020-05-25 20:44:49 +00:00
|
|
|
"<b>Rule Expressions</b>"
|
|
|
|
"<pre>"
|
2020-05-26 15:17:29 +00:00
|
|
|
"(disallow <item_type>)<br>"
|
|
|
|
"(constraint <constraint_type> ...)<br>"
|
|
|
|
"(condition \"<expression>\")<br>"
|
|
|
|
"<br></pre>"
|
2020-05-25 20:44:49 +00:00
|
|
|
"<b>Item Types</b>"
|
|
|
|
"<pre>"
|
2020-05-26 15:17:29 +00:00
|
|
|
"track via zone<br>"
|
|
|
|
"pad micro_via text<br>"
|
|
|
|
"hole buried_via graphic<br>"
|
|
|
|
"<br></pre>"
|
2020-05-25 20:44:49 +00:00
|
|
|
"<b>Constraint Types</b>"
|
|
|
|
"<pre>"
|
2020-05-26 15:17:29 +00:00
|
|
|
"clearance annulus_width track_width hole<br>"
|
|
|
|
"<br></pre>"
|
2020-05-25 20:44:49 +00:00
|
|
|
"<b>Examples</b>"
|
|
|
|
"<pre>"
|
2020-05-26 15:17:29 +00:00
|
|
|
"(rule \"copper keepout\"<br>"
|
|
|
|
" (disallow track) (disallow via) (disallow zone)<br>"
|
|
|
|
" (condition \"a.name == no_copper\"))<br>"
|
|
|
|
"<br>"
|
|
|
|
"(rule neckdown<br>"
|
|
|
|
" (constraint track_width (min 0.2mm) (opt 0.25mm) (max 1.0mm)<br>"
|
|
|
|
" (condition \"a.name == BGA\"))<br>"
|
|
|
|
"<br>"
|
|
|
|
"(rule HV<br>"
|
|
|
|
" (constraint clearance (min 1.5mm)<br>"
|
|
|
|
" (condition \"a.netclass == HV\"))<br>"
|
|
|
|
"<br>"
|
|
|
|
"(rule HV-HV<br>"
|
|
|
|
" (constraint clearance (min 2.0mm)<br>"
|
|
|
|
" (condition \"a.netclass == HV && b.netclass == HV\"))<br>"
|
|
|
|
"</pre>";
|
2020-05-25 20:44:49 +00:00
|
|
|
|
|
|
|
HTML_MESSAGE_BOX dlg( m_parent, _( "Syntax Help" ) );
|
|
|
|
dlg.SetDialogSizeInDU( 320, 320 );
|
|
|
|
|
|
|
|
dlg.AddHTML_Text( msg );
|
|
|
|
dlg.ShowModal();
|
|
|
|
}
|