Working with Text Objects

Ein Textobjekt platziert eine einzeilige Zeichenfolge oder einen mehrzeiligen Textrahmen auf der ausgewählten Lage in verschiedenen Anzeigestilen und Formaten, einschließlich gängiger Barcode-Standards und QR-Codes. Es kann sich dabei um benutzerdefinierten Text oder um einen besonderen Typ von Zeichenfolge handeln, der als Special String bezeichnet wird und zur Anzeige von Platinen- oder Systeminformationen oder des Werts von Benutzerparametern auf der Platine verwendet werden kann. Der Textrahmen ist ein in der Größe veränderbarer rechteckiger Bereich, der mehrere Textzeilen enthalten kann und Text automatisch umbrechen und abschneiden kann, damit er innerhalb der Grenzen des Rahmens bleibt.

Platzierte Textobjekte
Platzierte Textobjekte

Textobjekte können sowohl im PCB- als auch im PCB-Footprint-Editor platziert werden, indem Sie den Befehl Place » String oder Place » Text Frame aus den Hauptmenüs wählen. Nach dem Starten des Befehls zum Platzieren einer Zeichenfolge verwandelt sich der Cursor in ein Fadenkreuz, und Sie wechseln in den Platzierungsmodus für Text. Ein Textobjekt erscheint schwebend am Cursor:

  1. Positionieren Sie den Cursor und klicken Sie dann oder drücken Sie Enter, um ein Textobjekt zu platzieren.
  2. Platzieren Sie weitere Textobjekte oder klicken Sie mit der rechten Maustaste bzw. drücken Sie Esc, um den Platzierungsmodus zu verlassen.
Abhängig vom gewählten Platzierungsbefehl (Place » String oder Place » Text Frame) befindet sich das zu platzierende Textobjekt im Modus String oder Frame, der während oder nach der Platzierung im Properties panel geändert werden kann.

Zusätzliche Aktionen, die während der Platzierung ausgeführt werden können:

  • Drücken Sie Spacebar, um das Textobjekt gegen den Uhrzeigersinn zu drehen, oder Shift+Spacebar für eine Drehung im Uhrzeigersinn. Die Drehung erfolgt entsprechend dem Wert für Rotation Step, der auf der Seite PCB Editor – General page im Dialog Preferences definiert ist.
  • Drücken Sie die Tasten X oder Y, um das Textobjekt entlang der X- bzw. Y-Achse zu spiegeln.
  • Drücken Sie die Taste L, um das Textobjekt auf die andere Seite der Platine zu spiegeln.
  • Drücken Sie die Tasten + und - (auf dem Ziffernblock), um vorwärts bzw. rückwärts durch alle sichtbaren Lagen im Design zu schalten und so die Platzierungslage schnell zu ändern.

Die grafische Bearbeitungsmethode ermöglicht es Ihnen, ein platziertes Textobjekt direkt im Arbeitsbereich auszuwählen und seine Position, Drehung, Ausrichtung und Größe zu ändern.

Wenn ein Textobjekt ausgewählt ist, stehen die folgenden Bearbeitungsgriffe zur Verfügung:

Ein ausgewählter Text
Ein ausgewählter Text

  • Klicken und ziehen Sie B, um das Textobjekt um seinen Referenzpunkt A (gekennzeichnet durch das kleine x) zu drehen.
  • Klicken und ziehen Sie C, um den Begrenzungsrahmen des Textobjekts gleichzeitig in vertikaler und horizontaler Richtung zu skalieren.
  • Klicken und ziehen Sie D, um den Begrenzungsrahmen des Textobjekts getrennt in vertikaler und horizontaler Richtung zu skalieren.
  • Klicken Sie irgendwo auf das Textobjekt, entfernt von den Bearbeitungsgriffen, und ziehen Sie es, um es neu zu positionieren. Während des Ziehens kann der Kommentar gedreht oder gespiegelt werden:
    • Drücken Sie Spacebar, um das Textobjekt gegen den Uhrzeigersinn zu drehen, oder Shift+Spacebar für eine Drehung im Uhrzeigersinn. Die Drehung erfolgt entsprechend dem Wert für Rotation Step, der auf der Seite PCB Editor – General page im Dialog Preferences definiert ist.
    • Drücken Sie die Tasten X oder Y, um das Textobjekt entlang der X- bzw. Y-Achse zu spiegeln.
  • Der Standardtext für ein neu platziertes Zeichenfolgenobjekt ist String. Nach dem Platzieren (sofern er nicht vor oder während der Platzierung geändert wurde) ändern Sie diesen Text nach Bedarf über das Texteingabefenster, wenn Sie die Eigenschaften der Zeichenfolge im Properties panel anzeigen.
  • Die Software bietet die Möglichkeit, Textobjekte als Barcode-Symbole direkt auf einer PCB auf jeder Lage zu platzieren, sodass Barcodes im Rahmen des Fertigungsprozesses einfach auf eine PCB aufgebracht werden können. Weitere Informationen zur Verwendung eines Textobjekts als Barcode finden Sie im Abschnitt Adding a Barcode auf der Seite Including Barcodes & Logos.
  • Die Software bietet die Möglichkeit, Textobjekte als QR-Codes direkt auf einer PCB auf jeder Lage zu platzieren, sodass QR-Codes im Rahmen des Fertigungsprozesses einfach auf eine PCB gedruckt werden können. Weitere Informationen zur Verwendung eines Textobjekts als QR-Code finden Sie im Abschnitt Adding a QR Code auf der Seite Including Barcodes & Logos.

Special Strings

Während Textobjekte verwendet werden können, um benutzerdefinierten Text auf der aktuellen PCB-Lage zu platzieren, kann nicht nur only benutzerdefinierter Text platziert werden. Zur Unterstützung bei der Erstellung von Dokumentation wird das Konzept der special strings verwendet. Diese dienen als Platzhalter für Design-, System- oder Projektinformationen, die zum Zeitpunkt der Ausgabegenerierung auf der PCB angezeigt werden sollen.

Beispiele für Design-, System- und Designparameter-Special-Strings, angezeigt als Quellzeichenfolgen (erstes Bild) und konvertiert (zweites Bild). 
Beispiele für Design-, System- und Designparameter-Special-Strings, angezeigt als Quellzeichenfolgen (erstes Bild) und konvertiert (zweites Bild).

Die in einem PCB-Dokument verfügbaren Special Strings stammen aus mehreren Quellen:

  • Ein Standardsatz von vordefinierten Special Strings wird zur Verwendung mit neuen PCB-Dokumenten bereitgestellt.
  • Benutzerdefinierte Special Strings können durch Definieren zusätzlicher Parameter auf Projektebene (diese Parameter werden auf der Registerkarte Parameters tab des Dialogs Project Options definiert) und auf Variantenebene hinzugefügt werden (diese Parameter werden im Dialog Edit Project Variant dialog oder im Properties panel in its Variant mode in the Variant Manager definiert).
  • Benutzerparameter, die Komponenten im Schaltplanbereich hinzugefügt werden, werden über ein ECO übertragen und stehen dann PCB-Komponenten zur Verfügung. Wenn ein Special String, der sich auf einen Komponentenparameter bezieht, auf Bibliotheksebene der Quelle zu einem PCB-Footprint hinzugefügt wird, wird diese Zeichenfolge auf der mechanischen Ziellage oder dem Overlay interpretiert, wenn die PCB-Komponente platziert wird.

Hinweise zur Verwendung von Special Strings

  • Ein Special String wird durch eine Zeichenfolge gekennzeichnet, die mit einem .-Zeichen (Punkt) beginnt (z. B. .Layer_Name.Net_Count usw.).  Wenn eine Zeichenfolge mit "." beginnt, wird die gesamte Zeichenfolge als „besondere“ Zeichenfolge behandelt. Diese Syntax wird auch verwendet, wenn auf einen Benutzerparameter verwiesen wird; dem Parameternamen wird das "."-Zeichen (Punkt) vorangestellt.
  • Um mehr als einen Special String innerhalb eines PCB-Texts einzuschließen, setzen Sie jeden Special String in Apostroph-Zeichen ( ' ); zum Beispiel: '.Pcb_File_Name_No_Path' '.Print_Date'.
  • Sie können zwischen verketteten Special Strings auch Text, Leerzeichen und Sonderzeichen verwenden, zum Beispiel: FileName= '.Pcb_File_Name_No_Path' : PrintDate = '.Print_Date'.
  • Leerzeichen und Sonderzeichen können auch innerhalb von Projekt- und Variantenparameternamen verwendet werden.
  • Die Werte einiger Special Strings können nur angezeigt werden, wenn die entsprechende Ausgabe erzeugt wird, darunter .Legend, .Plot_File_Name und .Printout_Name. Die meisten Special Strings können auf dem Bildschirm angezeigt werden.

    Beim Erzeugen von Dokumentation für ein PCB-Projekt und beim Freigeben in einen Workspace muss es eine Möglichkeit geben anzuzeigen, auf welches Item und welche Revision sich die Dokumentation bezieht, ebenso wie auf die Konfiguration des im Release verwendeten Designprojekts und jede zutreffende steuernde Variante. Hierfür steht ein Satz von Special Strings zur Verfügung, darunter .PCBConfigurationName, .ItemAndRevision und .VariantName. Diese Special Strings werden erst zum Zeitpunkt der Ausgabegenerierung interpretiert (außer bei der Anzeige der PCB in 3D, was selbst als Ausgabe betrachtet wird). Die durch Verwendung dieser Zeichenfolgen bereitgestellten Informationen sind in erzeugten Ausgaben sichtbar, einschließlich Gerber-/ODB++-Dateien, Final-Artwork-Ausdrucken, PCB-Ausdrucken, PCB-3D-Ausdrucken, PCB-3D-Video und Bestückungszeichnungen.
  • Special Strings werden für die Anzeige auf dem Bildschirm automatisch konvertiert. Wenn die Zeichenfolge nicht konvertiert werden kann, wird entweder der Wert der eingegebenen Zeichenfolge oder eine Meldung angezeigt. Wenn das Projekt beispielsweise nicht unter Versionskontrolle steht und der Special String .VersionControl_RevNumber auf der PCB platziert wird, wird die Meldung Not in Version Control angezeigt.
  • Zur leichteren Identifizierung von Special Strings enthält das View Configuration panel die Option Special Strings. Wenn diese Option aktiviert ist, werden platzierte Textobjekte, die aus konvertierten Special Strings bestehen, mit dem nicht konvertierten Namen des Special Strings überlagert (beschriftet).

Platzieren eines Special Strings

Um einen Special String auf einer PCB zu verwenden, platzieren Sie ein Textobjekt und wählen Sie dann einen der Namen der Special Strings aus der Dropdown-Liste des Textfelds (Modus String) oder der Dropdown-Liste (Modus Frame) im Properties panel aus.

Zugriff auf Special Strings für ein platziertes Zeichenfolgenobjekt.
Zugriff auf Special Strings für ein platziertes Zeichenfolgenobjekt.

Im Folgenden sind die vordefinierten, systembasierten Special Strings aufgeführt, die in einem PCB-Dokument verwendet werden können:

  • .Application_BuildNumber – die Version der Software, in der die PCB derzeit geladen ist. Verwenden Sie diese Zeichenfolge beim Erzeugen von Gerber-Ausgaben, um den Software-Build zu dokumentieren, mit dem das Design erstellt wurde.
  • .Arc_Count – die Anzahl der Bögen auf der PCB.
  • .BlindVia_Count – die Anzahl der Blind Vias auf der PCB.
  • .Board_Height – die vertikale Größe der PCB-Platine.
  • .Board_Width – die horizontale Größe der PCB-Platine. 
  • .BuriedVia_Count – die Anzahl der Buried Vias auf der PCB.
  • .Comment – die Kommentarzeichenfolge für eine Komponente (auf einer beliebigen Lage im Bibliothekseditor als Teil des Komponenten-Footprints platziert).
  • .Component_Count – die Anzahl der Komponenten auf der PCB.
  • .ComponentMixed_Count – die Anzahl der Komponenten mit gemischten Pads auf der PCB.
  • .ComponentSMD_Count – die Anzahl der Komponenten mit SMD-Pads auf der PCB.
  • .ComponentThru_Count – die Anzahl der Komponenten mit Durchsteck-Pads auf der PCB.
  • .ComputerName – der Name des Computers, auf dem die Software installiert ist und ausgeführt wird.
  • .CopperInner_Weight_Max – das maximale Kupfergewicht auf Innenlagen.
  • .CopperOuter_Weight_Max – das maximale Kupfergewicht auf Außenlagen.
  • .Designator – die Bezeichnerzeichenfolge für eine Komponente (in der Bibliotheksbearbeitung auf einer beliebigen Lage als Teil des Komponenten-Footprints platziert).
  • .Fill_Count – die Anzahl der Füllungen auf der Leiterplatte.
  • .Hole_Count – die Anzahl der Bohrlöcher auf der Leiterplatte.
  • .Hole_Size_Min – der minimale Lochdurchmesser auf der Leiterplatte.
  • .Hole_Size_Num – die Anzahl eindeutiger Lochdurchmesser auf der Leiterplatte.
  • .Item – das Item, auf das sich die generierten Daten beziehen (z. B. D-810-2000). Die Daten werden zum Erstellen dieses Items verwendet.
  • .ItemAndRevision – das Item und die spezifische Revision dieses Items, auf die sich die generierten Daten beziehen, im Format <Item ID>-<Revision ID> (z. B. D-810-2000-01.A.1). Die Daten werden zum Erstellen genau dieser Revision dieses bestimmten Items verwendet.
  • .ItemRevision – die spezifische Revision des Items, auf die sich die generierten Daten beziehen (z. B. 01.A.1). Die Daten werden in dieser Item-Revision auf dem Zielserver gespeichert.
  • .ItemRevisionBase – der Base-Level-Teil des Benennungsschemas einer Item-Revision (z. B. 1).
  • .ItemRevisionLevel1 – der Level-1-Teil des Benennungsschemas einer Item-Revision (z. B. A).
  • .ItemRevisionLevel1AndBase – die Level-1- und Base-Level-Teile des Benennungsschemas einer Item-Revision (z. B. A.1).
  • .ItemRevisionLevel2 – der Level-2-Teil des Benennungsschemas einer Item-Revision (z. B. 01).
  • .ItemRevisionLevel2AndLevel1 – die Level-2- und Level-1-Teile des Benennungsschemas einer Item-Revision (z. B. 01.A).
  • .Layer_Count – die Anzahl der Kupferlagen auf der Leiterplatte.
  • .Layer_Name – der Name der Lage, auf der die Zeichenfolge platziert ist.
  • .Legend – eine Symbollegende für mechanische Bohrplots. Diese Zeichenfolge ist nur gültig, wenn sie auf der Lage Drill Drawing platziert wird. Hinweis: Dies ist eine Legacy-Funktion; platzieren Sie ein Drill-Table-Objekt für detailliertere Bohrinformationen.
  • .MicroVia_Count – die Anzahl der Microvias auf der Leiterplatte.
  • .ModifiedDate – der Änderungsdatumsstempel der Leiterplatte; er wird automatisch ausgefüllt. Beispiel: 23/09/2015.
  • .ModifiedTime – der Änderungszeitstempel der Leiterplatte; er wird automatisch ausgefüllt.
  • .Net_Count – die Gesamtzahl der verschiedenen Netze auf der Leiterplatte.
  • .Net_Names_On_Layer – die Namen aller Netze auf der spezifischen Lage. Diese Zeichenfolge ist nur gültig, wenn sie auf einer internen Plane-Lage platziert wird.
  • .Pad_Count – die Anzahl der Pads auf der Leiterplatte.
  • .PadSMD_Count – die Anzahl der SMD-Pads auf der Leiterplatte.
  • .PadThru_Count – die Anzahl der Through-Hole-Pads auf der Leiterplatte.
  • .Pattern – die Namen der auf der Leiterplatte verwendeten Komponenten-Footprints.
  • .Pcb_File_Name – der Pfad und Dateiname des PCB-Dokuments.
  • .Pcb_File_Name_No_Path – der Dateiname des PCB-Dokuments.
  • .PCBConfigurationName – zeigt den Namen des Datensatzes an, aus dem die Ausgabe erzeugt wurde, wie im Project Releaser definiert. Beachten Sie, dass die Namen der Standardkonfigurationen Source, Fabrication und Assembly nicht bearbeitet werden können (zum Beispiel zeigt die Fabrication-Ausgabe für .PCBConfigurationName Fabrication an). Benutzerdefinierte Custom-Konfigurationen zeigen den benutzerdefinierten Namen an, wenn diese spezielle Zeichenfolge verwendet wird (show image).
  • .Plot_File_Name – bei generierter Gerber-Ausgabe kennzeichnet diese Zeichenfolge den Dateinamen der Gerber-Plotdatei. Bei gedruckter Ausgabe kennzeichnet sie die in der Ausgabe dargestellte Lage. Bei ODB++-Ausgabe kennzeichnet sie den Namen des übergeordneten Ordners, in dem die Dateien gespeichert sind.
  • .Poly_Count – die Anzahl der Polygone auf der Leiterplatte (bestehend aus Polygon Pours, internen Planes und Split Planes).
  • .Print_Date – das Druck-/Plotdatum.
  • .Print_Scale – der Druck-/Plotmaßstabsfaktor.
  • .Print_Time – die Druck-/Plotzeit.
  • .Printout_Name – der Name des Ausdrucks.
  • .SlotHole_Count – die Anzahl der Langlöcher auf der Leiterplatte.
  • .SolderMask_Bottom – Verfügbarkeit der unteren Lötstoppmaske. Wenn keine untere Lötstoppmaskenlage vorhanden ist, hat der Parameter den Wert No mask. Wenn eine untere Lötstoppmaskenlage vorhanden ist, ihre Farbe jedoch nicht definiert ist, hat der Parameter den Wert No color. Wenn eine untere Lötstoppmaskenlage mit definierter Farbe vorhanden ist, zeigt der Parameter die Farbe an, entweder ihren Namen (Green, Black, Blue, Red usw.) oder ihren RGBA-Code (z. B. #FF0065FF).
  • .SolderMask_Top – Verfügbarkeit der oberen Lötstoppmaske. Wenn keine obere Lötstoppmaskenlage vorhanden ist, hat der Parameter den Wert No mask. Wenn eine obere Lötstoppmaskenlage vorhanden ist, ihre Farbe jedoch nicht definiert ist, hat der Parameter den Wert No color. Wenn eine obere Lötstoppmaskenlage mit definierter Farbe vorhanden ist, zeigt der Parameter die Farbe an, entweder ihren Namen (Green, Black, Blue, Red usw.) oder ihren RGBA-Code (z. B. #FF0065FF).
  • .SquareHole_Count – die Anzahl der quadratischen Löcher auf der Leiterplatte.
  • .StackedVia_Count – die Anzahl der gestapelten Vias auf der Leiterplatte.
  • .String_Count – die Anzahl der Zeichenfolgen auf der Leiterplatte.
  • .Thru_Via_Count – die Anzahl der Through-Hole-Vias auf der Leiterplatte.
  • .Total_Thickness – die Dicke der Leiterplatte.
  • .Total_Thickness(Board Layer Stack) – die Dicke des Lagenaufbaus der Leiterplatte.
  • .Track_Count – die Anzahl der Leiterbahnen auf der Leiterplatte.
  • .VariantName – die Variante des Designs, aus der die Ausgabe erstellt wurde.
  • .VersionControl_PrjFolderRevNumber – die aktuelle Revisionsnummer des Projekts, die bei jedem vollständigen Commit des Projekts (d. h. einschließlich der Projektdatei) erhöht wird. Versionskontrolle muss verwendet werden, damit diese Zeichenfolge Informationen enthält.
  • .VersionControl_ProjFolderRevNumber – die aktuelle Revisionsnummer des Projekts, die bei jedem vollständigen Commit des Projekts (d. h. einschließlich der Projektdatei) erhöht wird. Versionskontrolle muss verwendet werden, damit diese Zeichenfolge Informationen enthält.
  • .VersionControl_ProjFolderRevNumberShort – ein kurzes Git-Hash-Format (die ersten acht Zeichen) des Projekts. Versionskontrolle muss verwendet werden, damit diese Zeichenfolge Informationen enthält.
  • .VersionControl_RevNumber – die aktuelle Revisionsnummer des Dokuments. Versionskontrolle muss verwendet werden, damit diese Zeichenfolge Informationen enthält.
  • .VersionControl_RevNumberShort – ein kurzes Git-Hash-Format (die ersten acht Zeichen) der aktuellen Revisionsnummer des Dokuments. Versionskontrolle muss verwendet werden, damit diese Zeichenfolge Informationen enthält.
  • .Via_Count – die Anzahl der Vias auf der Leiterplatte.
Die vollständige Liste der verfügbaren speziellen Zeichenfolgen enthält auch alle, die aus benutzerdefinierten Parametern auf Projektebene abgeleitet sind.
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Inhalt