Referenz Handbuch

Dieses Dokument ist geschützt © 2010-2015 durch deren Beitragende welche nachfolgend aufgeführt sind. Sie können es nach den Bedingungen der GNU General Public License (http://www.gnu.org/licenses/gpl.html), Version 3 oder später, oder der Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), Version 3.0 oder später verteilen oder verändern .

Beitragende

Jean-Pierre Charras.

Übersetzung

Carsten Schönert <[email protected]>, 2016

Feedback

Bitte alle Bug Reports, Vorschläge oder neue Versionen an folgende Adressen richten:

Datum der Veröffentlichung und Softwareversion

23.05.2015

Einführung in den Pl_Editor

Der Pl_Editor ist ein Editor für Seitenlayouts um angepasste Titelblöcke und Referenzrahmen zu erstellen.

Der Titelblock, verbunden mit dem Bezugsrahmen, und andere grafische Elemente (z.B. Logos) werden hier Seitenlayout genannt.

Basiselemente für das Seitenlayout sind:

  • Linien

  • Rechtecke

  • Texte in Eeschema oder Pcbnew (mit Formatierungssymbolen, welche durch aktuellen Text, wie Datum, Seitennummerierung, …​ ersetzt werden)

  • Multi-Polygone (hauptsächlich um Logos und spezielle Grafikformen platzieren zu können)

  • Bitmap Grafiken.

Bitmap Grafiken können nur von wenigen Plottern gezeichnet werden (nur PDF und PS), auf anderen Plottern wird nur eine Rahmen gezeichnet.
  • Objekte können wiederholt werden, Texte und Multi-Polygone können gedreht werden.

Pl_Editor Dateien

Eingabedatei und Standard Titleblock

Der Pl_Editor liest oder schreibt Seitenbeschreibungsdateien *.kicad_wks (KiCad Worksheet).

Eine interne Standard Seitenlayout Konfiguration wird zur Anzeige des KiCad Titelblock benutzt bis spezielle Informationen aus einer Datei gelesen wurden.

Ausgabedatei

Die aktuelle Konfiguration der Seitenlayout Beschreibung kann in eine Datei *.kicad_wks geschrieben werden, dies geschieht unter Verwendung des S-Expressions Format, welches sehr oft in KiCad verwendet wird.

Diese Datei kann benutzt werden um in Eeschema und/oder Pcbnew ein benutzterspezifisches Seitenlayout zu benutzen.

Theorie über die Vorgänge

Basiselemente für das Seitenlayout:

Basiselemente für das Seitenlayout sind:

  • Linien

  • Rechtecke

  • Texte in Eeschema oder Pcbnew (mit Formatierungssymbolen, welche durch aktuellen Text, wie Datum, Seitennummerierung, …​ ersetzt werden)

  • Multi-Polygone (hauptsächlich um Logos und spezielle Grafikformen platzieren zu können). Diese Mehrfach Polygone werden durch Bitmap2component erstellt und können nicht innerhalb des Pl_Editors erzeugt werden, es ist nicht möglich solche Formen manuell zu erstellen.

  • Bitmap Grafiken um Logos zu platzieren.

Bitmap Grafiken können nur von einigen Plottern gezeichnet werden: nur PDF und PS

Zusammengefasst:

  • Texte, Multi-Polygone und Bitmap Grafiken werden durch eine Position definiert und können gedreht werden.

  • Linien (eigentlich sind dies Segmente) und Rechtecke sind durch zwei Punkte definiert: dem Start- und dem Endpunkt. Diese Elemente können nicht gedreht werden (dies ist nutzlos für Segmente).

Diese Basis Elemente können wiederholt werden.

Texte, die wiederholt werden, dürfen auch einen Inkrement für eine Beschriftung enthalten (macht nur Sinn, wenn der Text aus einem einzelnen Buchstaben oder mindestens aus einer Zahl besteht).

Definition der Koordinaten

Jede Positionangabe, also die Start- und Endpunkte der Elemente, ist immer relativ zur einer Ecke der Seite.

Durch diese Eigenschaft wird sichergestellt, dass Sie ein Seitenlayout definieren können, welches nicht abhängig ist von der tatsächlichen Papiergröße.

Bezugspunkte und Koordinaten:

page property 1

  • Wird die Papiergröße verändert so bleibt die relative Position der Elemente zu den Bezugspunkten gleich.

  • Für gewöhnlich wird der Titelblock in der rechten unteren Ecke angebracht, daher ist diese Ecke der Vorgabeplatz für den Titelblock wenn ein Elelement erstellt wird.

Bei Rechtecken und Segmenten, welche zwei definierte Punkte besitzen, hat jeder Punkt eine Bezugsecke.

Drehungen

Elemente deren Position durch einen einzelnen Punkt definiert wird (Texte und Multi-Polygone) können gedreht werden:

Normal: Drehung = 0

text noriented

Gedreht: Rotation = 20 und 10 Grad.

text rotated

Wiederholungsfunktion

Elemente können wiederholt werden:

Dies ist hilfreich um ein Raster und Rasterbeschriftungen anzulegen.

page property 2

Texte und Formatierungen

Umwandlungselemente:

Texte können einfache Zeichenketten sein oder zusätzlich Umwandlungselemente enthalten.

Umwandlungselemente werden durch aktuelle Werte aus Eeschema oder Pcbnew ersetzt.

Diese sind wie Umwandlungselemente in der 'printf' Funktion.

Ein Umwandlungselement besteht aus dem Prozentzeichen % und einem Buchstaben.

Das %C Format hat eine nachfolgende Zahl (zur Identifizierung des Kommentars).

Umwandlungselemente sind:

%% = wird ersetzt durch %

%K = KiCad Version

%Z = Typ des Papierformats (A4, USLetter …​)

%Y = Name der Firma

%D = Datum

%R = Revision

%S = aktuelles Blatt

%N = Gesamtanzahl Blätter

%Cx = Kommentar (x = 0 bis 9 zur Identifikation des Kommentars)

%F = Name der Datei

%P = Zeichnungspfad (voller Zeichnungsname, für Eeschema)

%T = Title

Beispiel:

"Größe: %Z" zeigt "Größe: A4" oder "Größe: USLetter"

Benutzer Ansichtsmodus: Button pagelayout normal view mode aktiviert. Der Titelblock wird so angezeigt wie dieser später in Eeschema und Pcbnew aussehen wird.

show fields data

"Nativer" Ansichtsmodus: Button pagelayout special view mode aktiviert. Es wird der native Text angezeigt der im Pl_Editor eingegeben wird, inklusive der Umwandlungselemente.

show fields codes

Mehrzeilige Texte:

Texte können mehrzeilig sein.

Es gibt zwei Möglichkeiten neue Zeilen in Texte einzufügen:

  1. Fügen Sie mit der Steuersequenz "\n" eine zweite Zeile hinzu (hauptsächlich im Menü 'Seite einrichten' von KiCad).

  2. Fügen Sie eine neue Zeile im Design Fenster vom Pl_Editor hinzu.

Hierzu ein Beispiel:

Einstellung

options multi line

Ausgabe

multi line

Mehrzeiliger Text im Dialog 'Seite einrichten':

Im Dialog für die Seiteneinrichtung können keine mehrzeiligen Texte eingegeben werden.

Eine zweite Zeile kann jedoch erzwungen werden indem die Steuersequenz \n benutzt wird.

Hier wird ein zweizeiliger Text im Feld Kommentar 2 verwendet:

insert newline code

Hier die entsprechende spätere Anzeige:

multi line 2

Wenn Sie wirklich \n innerhalb des Textes benutzen wollen benutzen Sie "\\n".

insert slashnewline code

Dies erzeugt folgende Anzeige:

multi line 3

Beschränkungen

Beschränkung auf Seite 1

In Eeschema besteht der komplette Schaltplan sehr oft aus mehr wie einer Seite.

Üblicher Weise ist das Seitenlayout und dessen Elemente für alle Seiten gleich.

Wenn ein Benutzer jedoch Elemente nur auf der Seite 1, oder nur auf den Folgeseiten angezeigt bekommen soll dann ist dies durch die "Option Seite 1" möglich:

display options

Option Seite 1

  • Keine: keine Beschränkungen

  • Nur Seite 1: Das Element ist nur auf Seit 1 sichtbar.

  • Nicht auf Seite 1: Das Element ist auf allen anderen Seiten außer Seite 1 sichtbar.

Beschränkung der Textgröße

constraint options

Exklusiv für Texte können zwei folgende Parameter gesetzt werden:

  • die maximale X-Größe

  • die maximale Y-Größe

Welche eine Begrenzungsbox bilden.

Sind diese Parameter nicht auf 0 gesetzt wird die benutzte Texthöhe und -breite dynamisch angepasst wenn der Text größer ist als die maximale X-Größe und/oder die maximale Y-Größe damit der resultierende Text in die Begrenzungsbox passt.

Ist die aktuelle Textgröße kleiner als die Angaben für X-Größe und/oder die Y-Größe dann wird die Textbreite und die Texthöhe nicht verändert.

Der Text ohne Begrenzungsbox. Maximale X-Größe = 0,0, maximale Y-Größe = 0,0

constraints none

Der gleiche Text mit einer Beschränkung der Textlaufweite. Maximale X-Größe = 40,0, maximale Y-Größe = 0,0

constraints defined

Ein mehrzeiliger Text, mit Beschränkungen:

Einstellung

constraint options

Ausgabe

block constraints

Aufruf des Pl_Editors

Der Pl_Editor wird typischer Weise von der Kommandozeile aus aufgerufen, oder alternativ über den KiCad Manager.

Auf der Kommandozeile ist der Aufruf in der Regel pl_editor <*.kicad_wks Datei>.

Pl_Editor Kommandos

Hauptfenster

Die nachfolgende Grafik zeigt das Hauptfenster vom Pl_Editor.

main window

Die linke Seite des Fensters enthält die Liste der Basis Elemente.

Auf der rechten Seite ist der Editor für die Element Eigenschaften zu sehen.

Hauptfenster Toolbar

main toolbar

Die obere Toolbar erlaubt einen einfachen Zugriff auf die folgenden Kommandos:

new page layout

Select the net list file to be processed.

open page layout

Load a page layout description file.

save

Save the current page layout description in a .kicad_wks file.

sheetset

Display the page size selector and the title block user data editor.

print button

Prints the current page.

delete

Delete the currently selected item.

undo redo

Undo/redo tools.

zoom in zoom out zoom redraw zoom fit in page

Zoom in, out, redraw and auto, respectively.

pagelayout normal view mode

Show the page layout in user mode: texts are shown like in Eeschema or Pcbnew: text format symbols are replaced by the user texts.

pagelayout special view mode

Show the page layout in native mode: texts are displayed "as is", with the contained formats, without any replacement.

set base corner

Reference corner selection, for coordinates displayed to the status bar.

set current page

Selection of the page number (page & or other pages).

This selection has meaning only if some items than have a page option, are not shown on all pages (in a schematic for instance, which contains more than one page).

Kommandos im Zeichnungsbereich

Tastatur-Befehle

F1

Hineinzoomen

F2

Herauszoomen

F3

Anzeige erneuern

F4

Curser in die Mitte des Anzeigefensters bewegen

Pos 1

Footprint ins Anzeigefenster einpassen

Leerzeichen

Setze relative Koordinaten zur aktuellen Cursor-Position

Rechter Pfeil

Cursor eine Rasterposition nach rechts bewegen

Linker Pfeil

Cursor eine Rasterposition nach links bewegen

Pfeil hoch

Cursor eine Rasterposition nach oben bewegen

Pfeil runter

Cursor eine Rasterposition nach unten bewegen

Kommandos durch die Maus

Scrollrad

Hinein und Heraus zoomen an der aktuellen Cursor Position

Strg + Scrollrad

Nach Rechts und Links bewegen

Umsch + Scrollrad

Nach Oben und Unten bewegen

Rechter Mausklick

Kontextmenü öffnen

Kontextmenü

Auswahlmöglichkeiten nach einem Rechtsklick auf der Maus:

  • Linie hinzufügen

  • Rechteck hinzufügen

  • Text hinzufügen

  • Seitenlayoutbeschreibung aus Datei hinzufügen

Diese (obigen vier) Kommandos benutzt man um Basiselemente zum Seitenlayout hinzuzufügen. Ebenso werden folgende Einträge angezeigt.

  • Zoomauswahl: Direkte Auswahl des Zoom Faktors.

  • Rasterauswahl: Direkte Wahlmöglichkeit des Anzeigerasters.

Seitenlayoutbeschreibung aus Datei hinzufügen sollte benutzt werden wenn Multi-Polygone hinzugefügt werden müssen, zum Beispiel ist dies nötig um Logos einzufügen.

In der Regel besteht ein Logo aus hunderten Eckpunkten, Sie können ein solches Polygon nicht von Hand erstellen. Aber Sie können eine Layoutbeschreibungsdatei benutzen um solche Polygone hinzuzufügen die zum Beispiel mit Bitmap2Component erstellt worden ist.

Informationen in der Statusbar

Die Statusbar ist im Fenster vom Pl_Editor das unterste Element und bietet hilfreiche Informationen für den Benutzer.

pl status bar

Die angezeigten Koordinaten sind immer relativ zur Bezugsecke welche als Referenzbezug gewählt worden ist.

Linkes Fenster

Das Fenster ganz links zeigt ein Liste der Elemente des Layouts.

Man kann einen Eintrag wählen indem man diesen in dieser Liste anwählt, oder im Layout Fenster die Linie oder den Text durch Linksklick auswählt. Mit einem Rechtsklick öffnet sich ein Popup Menü.

Dieses Popup Menü erlaubt Basis Operationen, das Hinzufügen neuen Elementes oder Löschen des gewählten Elementes.

→ Ein angewähltes Element wird zur visuellen Unterstützung im Editorfenster in einer anderen Farbe dargestellt.

Baum der Elemente: Das Element 19 ist ausgewählt, im Editorfenster wird das Element hervorgehoben.

project tree

Rechtes Fenster

Das Fenster auf der rechten Seite dient zum Editieren der Elementeigenschaften.

property none

property main

In diesem Dialog können Sie die Gültigkeit für die Seiten festlegen und auch die spezifischen Element Eigenschaften verändern.

Die angezeigten Einstellungen sind vom gewählten Element abhängig:

Settings for lines and rectangles

Settings for texts

property line

property text

Settings for poly-polygons

Setting for bitmaps

property polyline

property bitmap

Interaktives Editieren

Auswahl eines Elements

Ein Element kann folgendermaßen ausgewählt werden:

  • Durch Anklicken im Baum der Elemente.

  • Durch Linksklick auf das Element im Editorfenster.

  • Durch Rechtsklick auf das Element im Editorfenster (ein PopUp Menü wird angezeigt).

Wenn das Element angewählt ist wird es in einer anderen Farbe dargestellt (in Gelb wenn man einen schwarzen Hintegrund gewählt hat).

edit line

Der Startpunkt (edit line start) und und er Endpunkt (edit line end) werden hervorgehoben.

Wenn auf einem Element ein Rechtsklick ausgeführt wird erscheint ein PopUp Menü.

Die Optionen des PopUp Menüs sind abhängig von der Auswahl:

context line move start

context line move end

context line move

Wenn mehr wie ein Element gefunden wurden ist wird ein Menü zur Klarstellung angezeigt, um das richtige Element auszuwählen.

dialog select element

drag element

Wenn das Element ausgewählt worden ist, oder einer deren Endpunkte, kann es durch Mausbewegungen verschoben und durch einen Linksklick platziert werden.

Erstellen von Elementen

Um eine neues Element hinzuzufügen benutzen Sie die rechte Maustaste wenn der Maus Cursor sich entweder in der Baumansicht der Elemente (linkes Fenster) oder im Layout Editorfenster (mittleres Fenster) befindet.

Ein PopUp Menü öffnet sich daraufhin:

Das PopUp Menü im linken Fenster.

context createnew

Das PopUp Menü im Fenster des Seitenlayouteditors.

context createnew2

Linien, Rechtecke und Texte können hinzugefügt werden indem der zugehörige Menüeintrag ausgewählt wird.

Logos die hinzugefügt werden sollen müssen zuerst mit Hilfe von Bitmap2Component in eine Seitenbeschreibungslayoutdatei (*.kicad_wks) umgewandelt werden, diese Datei kann dann benutzt werden um das Logo einzubinden.

Die Option Seitenlayoutbeschreibung aus Datei hinzufügen kann dazu genutzt werden.

Hinzufügen von Linien, Rechtecken und Texten

Wenn diese Option angewählt wird öffnet sich ein Dialog:

Linie hinzufügen oder Rechteck hinzufügen

dialog newline

Text hinzufügen

dialog newtext

Die Position und die Endpunkte als auch die Referenzbezüge können hier festgelegt werden.

Diese Werte können aber auch später nach Auswahl des Elements im Fenster der Eigenschaften definiert werden. Oder durch Bewegen des Elements oder eines der Endpunkte.

In den meisten Fällen sind die Referenzbezüge für beide Punkte gleich.

Wenn dies nicht der Fall ist dann ist die Festlegung der Refrenzbezüge während der Erstellung besser da beim späteren ändern Ändern die Geometrie teilweise fehlerhaft ist.

Der praktikabelste Weg zum Einfügen von Linien und Rechtecke ist diese nach der Erstellung an die richtige Stelle zu verschieben bzw. deren Größe zu verändern.

Logos hinzufügen

Um ein Logo hinzuzufügen muss zunächst eine Multi Polygon (ein vektorisiertes Image eines Logos) durch Bitmap2component erstellt werden.

Bitmap2component erstellt eine Seitenlayoutbeschreibungdatei welche dem aktuellen Design hinzugefügt werden kann, unter Verwendung der Option Seitenlayoutbeschreibung aus Datei hinzufügen.

Die von Bitmap2component erstellte Datei enthält nur ein Element: ein Multi Polygon.

Unabhängig davon, dieses Kommando kann benutzt werden um eine Seitenlayoutbeschreibungsdatei einzufügen welche dann mit dem aktuellen Design verschmolzen wird.

Ist das Multi Polygon einmal eingefügt kann es bewegt und dessen Parameter editiert werden.

Hinzufügen von Bitmap Grafiken

Sie können eine Bitmap Grafik hinzufügen durch Benutzen eines der zahlreichen Bitmap Formate (PNG, JPEG, BMP …​).

  • Wenn eine Bitmap Grafik importiert wird so wird die Auflösung auf 300PPI (Pixel Pro Inch) gesetzt.

  • Dieser Wert kann im Fenster der Eigenschaften (rechtes Fenster) geändert werden.

  • Die aktuelle Größe hängt von diesem Parameter ab.

  • Bedenken Sie das höhere Werte größere Dateien bedingen und ebenfalls die Druckzeit oder den Plotvorgang verlängern.

Eine Bitmap Grafik kann mehrfach eingefügt werden, kann aber nicht gedreht werden.