AddText [ATX, THO, TIH, TIL, TPA, TPC, TPO, TXT]

--------------------OLD_TEXT---------------------

AddText [ATX, THO, TIH, TIL, TPA, TPC, TPO, TXT]

Anlegen eines Text-Elements.

Mit AddText kann ein Text-Element universell angelegt werden. Es kann beliebig eingepaßt, platziert, ausgerichtet und/oder in seinen Einstellungen definiert werden. Der Text darf im Moment nur eine Länge von 2048 Zeichen besitzen, ansonsten unterliegt er keiner Einschränkung. Der Text kann sowohl als Parameter angegeben werden, als auch aus der Texttabelle oder dem Textpuffer entnommen werden. Es ist weiterhin möglich, den Text sowohl als Standard-Text als auch als Attribut-Text abzulegen.

Ein Teil des Dialoges wird über die Funktionsparameter gesteuert. Des weiteren können alle notwendigen Einstellungen auch über diese vordefiniert werden (alle Parameter sind nicht case-sensitiv).

Voraussetzung

Die Datenbank muß eröffnet sein

Ein Objekt muß eröffnet sein.

Parameter

\r  oder  \n

im Text bewirken einen Zeilenumbruch. Das \r ist für die Eingabe in der Kommandozeile und das  \n für die Eingabe in Batch-Dateien (Siehe  Beispiel „Zeilenumbruch“).

DKY/

Es wird der Zeichenschlüssel des Textelementes festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form DKY/n, wobei n aus den natürlichen Zahlen einschließlich der Null gewählt werden kann. Alternativ ist es möglich, den Parameter in der Form DKY/ask anzugeben, um einen Dialog für den Parameter zu erzwingen. Fehlt der Parameter, so wird entweder der vorinitialisierte Wert (siehe auch die Funktion InitializeParameter/DKY) angenommen, falls dieser definiert ist oder Null ansonsten.

DKA/

Es wird der Flächenschlüssel des Textelementes festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form DKA/n, wobei n aus den natürlichen Zahlen einschließlich der Null gewählt werden kann. Alternativ ist es möglich, den Parameter in der Form DKA/ask anzugeben, um einen Dialog für den Parameter zu erzwingen. Fehlt der Parameter, so wird entweder der vorinitialisierte Wert (siehe auch die Funktion InitializeParameter/DKA) angenommen, falls dieser definiert ist oder Null ansonsten.

TXM/

Es wird die Textart des Textelementes festgelegt. Diese können in der Textarttabelle eingesehen werden. Im Moment sind nur die neun Textarten 0, ..., 8 definiert.

Die Angabe des Parameters ist optional und erfolgt in der Form TXM/n, wobei n aus den natürlichen Zahlen einschließlich der Null gewählt werden kann (Beachte, welche Textarten definiert sind!). Alternativ ist es möglich, den Parameter in der Form TXM/ask anzugeben, um einen Dialog für den Parameter zu erzwingen. Fehlt der Parameter, so wird entweder der vorinitialisierte Wert (siehe auch die Funktion InitializeParameter /TXM) angenommen, falls dieser definiert ist oder Null ansonsten.

POS/

Es wird die Ausrichtung des Textelementes bezüglich des Bezugspunkts festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form POS/s, wobei s einem der folgenden Buchstaben entsprechen muß, die nicht case-sensitiv angegebe werden können:

Fehlt der Parameter, so kann dieser entweder bei der Definition des Bezugspunkts festgelegt werden oder er wird standardmäßig als linksbündig angenommen.

TXI/

Es wird die Texthöhe des Textelementes festgelegt (Die Angabe erfolgt in 1/100 mm).

Die Angabe des Parameters ist optional und erfolgt in der Form TXI/n, wobei n aus den natürlichen Zahlen einschließlich der Null gewählt werden kann. Alternativ ist es möglich, den Parameter in der Form TXI/ask anzugeben, um einen Dialog für den Parameter zu erzwingen. Fehlt der Parameter, so wird er zu Null angenommen.

TEX/

Es wird die Referenznummer zur Übernahme eines Textes aus der Texttabelle oder aus dem Textpuffer (-1 als Referenznummer) festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form TEX/n, wobei n aus den natürlichen Zahlen einschließlich der -1 gewählt werden kann. Dabei bedeutet die -1 eine Übernahme des Textes aus dem Textpuffer. Fehlt der Parameter oder entspricht er keiner gültigen Referenznummer, so wird er ignoriert.

Wurde schon in der Kommandozeile ein Text übergeben (siehe auch den freien Parameter TEXT), so findet ein eigens dafür vorgesehener Dialog statt, welcher Text benutzt werden soll.

ALPHA/

Es wird der Winkel in der x-y-Ebene festgelegt, um den das Textelement im Bezugspunkt relativ zur positiven x-Achse gedreht wird.

Die Angabe des Parameters ist optional und erfolgt in der Form ALPHA/x, wobei x aus den reellen Zahlen gewählt werden kann. Durch Voranstellen eines Buchstaben kann das Winkelmaß bestimmt werden, dabei sind folgende Werte zulässig:

R        Winkel wird in Radiant eingegeben

D        Winkel wird in Grad (DEGREE) eingegeben

G        Winkel wird in Neugrad (GON) eingegeben

Ohne Buchstaben erfolgt die Angabe im in Moskito eingestellten Winkelmaß (Variable WGR ).

Hat der Schalter ALPHA keinen (zulässigen) Wert wird die Funktion beendet.

BETA/

Es wird der Winkel in der x-z-Ebene festgelegt, um den das Textelement im Bezugspunkt relativ zur x-Achse gedreht wird.

Die Angabe des Parameters ist optional und erfolgt in der Form BETA/x, wobei x aus den reellen Zahlen gewählt werden kann. Die Angabe erfolgt in Grad (0° – 360°). Fehlt der Parameter, so wird standardmäßig von einem Winkel von 0° ausgegangen. Das Gradzeichen muß dabei nicht mitangegeben werden.

Z/

Es wird die z-Koordinate für den Bezugspunkt des Textelementes festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form Z/x, wobei x aus den reellen Zahlen gewählt werden kann. Fehlt die Angabe, so ist sie standardmäßig mit Null vorbelegt.

ABS/

Es wird der Abstand des Textes zu seiner definierten Basislinie festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form ABS/x, wobei x aus den reellen Zahlen gewählt werden kann. Alternativ ist es möglich, den Parameter in der Form ABS/ask anzugeben, um einen Dialog für den Parameter zu erzwingen. Fehlt der Parameter, so ist er standardmäßig mit Null vorbelegt.

TXL/

Es wird die Standlinienlänge, d.h. die Gesamtlänge des Textelementes festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form TXL/x, wobei x aus den reellen Zahlen gewählt werden kann. Fehlt der Parameter oder wird er durch den aktiven Parameter /FITIN überlagert, so wird er ignoriert.

BUFFER/

Es wird festgelegt, in welcher Form der definierte Text oder das Textelement angelegt werden.

Die Angabe des Parameters ist optional und erfolgt in der Form BUFFER/n, wobei n einem der folgenden Werte entsprechen muß:

-1 : Text wird nur im Textpuffer abgelegt;

0 : Textelement wird in die Datenbank übernommen und zusätzlich der Text im Textpuffer abgelegt;

+1 : Textelement wird nur in die Datenbank übernommen.

Fehlt der Parameter, so kann wird standardmäßig nur eine Übernahme des Textelementes in die Datenbank vorgenommen.

/EXPAND

Es wird veranlasst, dass das durch den Parameter <Text> definierte Textelement als Attributtext gesetzt wird.

Die Angabe des Parameters ist optional und erfolgt in der Form /EXPAND.

/ATX

Es wird ein Flag gesetzt, das bewirkt, dass der Parameter <Text> die Form eines Attributtextes erhält, d.h. es werden die %% um den Textstring gesetzt, die dafür sorgen, dass der Inhalt des Attributes und des gleichnamigen Attributtextes übereinstimmen.

/FITIN

Es wird veranlasst, dass der definierte Text zwischen zwei Punkten eingepasst wird. Ist zusätzlich der Parameter IDENTIFY aktiv, so findet eine Einpassung auf ein beliebiges String-Element statt. Die Einpassung erfolgt über eine Streckung des Textes (Vergrößerung der Zeichenzwischenräume), falls der Parameter HIGH aktiv ist. Die Einpassung erfolgt über eine Größenanpassung (Anpassung der Texthöhe), falls der Parameter HIGH inaktiv ist.

Die Angabe des Parameters ist optional und erfolgt in der Form /FITIN.

/HORIZONT

Es wird veranlasst, dass der vordefinierte Horizont als Basislinie dient, entlang derer der Text parallel platziert wird. Ist kein Horizont definiert, so wird die Horizontrichtung standardmäßig als Richtung der x-Achse im globalen Koordinatensystems angenommen.

Die Angabe des Parameters ist optional und erfolgt in der Form /HORIZONT.

REFPOINT

Als Position des Textes wird der aktuell geöffnete Punkt verwendet.

OFFSETX/nnn

OFFSETY/nnn

Abstand des Textes vom Referenzpunkt. Diese Parameter werden nur ausgewertet, wenn /REFPOINT ebenfalls angegeben wurde. Der Offset wird in 1/100 mm angegeben.

OFFSETALPHA

/1POINT

Es wird veranlasst, dass nur ein Richtungspunkt abgefragt wird und der Bezugspunkt gleichzeitig als erster Richtungspunkt gilt. Dies führt zu einer Vereinfachung des Dialoges.

Die Angabe des Parameters ist optional und erfolgt in der Form /1POINT.

SWAPTEXT/

Es wird veranlasst, dass eine ganze Swaptextgruppe angelegt wird. Die Texte gruppieren sich dabei unter oder über dem zentralen Text, der sich am Textbezugspunkt festmacht.

Die Angabe des Parameters ist optional und erfolgt in der Form SWAPTEXT/n, wobei n aus dem Bereich der ganzen Zahlen gewählt werden kann. Dabei gilt:

n > 0 : Swaptexte werden übereinander angeordnet,

n < 0 : Swaptexte werden untereinander angeordnet.

SWAPABS/

Es wird der Abstand der Zeilen innerhalb der Swaptexte bei der Angabe einer Swaptextgruppe festgelegt. Die Angabe erfolgt in 1/100 mm. Der Parameter wird nur bei der Eingabe einer Swaptextgruppe berücksichtigt.

Die Angabe des Parameters ist optional und erfolgt in der Form SWAPABS/n, wobei n aus dem Bereich der natürlichen Zahlen gewählt werden kann.

<TEXT>

Jede Zeichenfolge, die keinem der vorangehenden Parameter entspricht wird automatisch als Text interpretiert. Soll die Zeichenfolge ein oder mehrere Leerzeichen enthalten, muß sie entsprechend durch Hochkommata eingeschlossen werden.

Beginnt die Zeichenfolge mit dem Zeichen &, so werden die folgenden Zeichen als Angabe für eine Swaptextgruppe interpretiert (entsprechend dem Parameter SWAPTEXT/n)

/RUBBERBAND

zeigt beim Positionieren den Umriss an.

/H

Es wird eine Hilfe für die Funktion AddText gegeben. Der Hilfstext enthält eine kurze Beschreibung der Funktion sowie eine Aufrufanleitung.

Die Angabe des Parameters ist optional und erfolgt in der Form -H oder /H (äquivalente Eingaben).

Rückgabewert

Dialog

Eingabe des Zeichenschlüssels: (n)

(Falls der Parameter DKY/ask aktiv ist)

Eingabe des Flächenschlüssels: (n)

(Falls der Parameter DKA/ask aktiv ist)

Eingabe der Textart: (n)

(Falls der Parameter TXM/ask aktiv ist)

Eingabe der Texthöhe: (n)

(Falls die Parameter /FITIN und BUFFER/-1 nicht aktiviert wurden und die Texthöhe nicht schon über den Parameter TXI/n vordefiniert wurde)

Eingabe des Textabstands zur Basislinie: (x)

(Falls der Parameter ABS/ask aktiv ist)

Wurde noch kein Text vordefiniert, so findet einer der beiden folgenden Dialoge statt:

Eingabe eines Textes: (s)

(Falls einer der Parameter /FITIN, /IDENTIFY, BUFFER/-1 oder BUFFER/0 aktiv ist)

Eingabe eines Textes oder eines Textbezugspunktes:

(Falls die unter a) angegebenen Bedingungen nicht zutreffen) <t,CLS/t,CON> (s, &x)

In Abhängigkeit der Wahl der Steuerparameter /IDENTIFY, /FITIN und /HORIZONT findet einer der folgenden unterschiedlichen Dialoge statt:

a)       Texteinpassung bestimmen:

         (Falls der Parameter /FITIN aktiv ist)

Ersten Einpaßpunkt bestimmen: <P,CLS/P,CON>

Zweiten Einpaßpunkt bestimmen: <P,CLS/P,CON>

b)       Text entlang eines String-Elements plazieren:

         (Falls der Parameter /IDENTIFY aktiv ist)

String-Element identifizieren: <P,L,CON>

Soll das String-Element anschließend gelöscht werden (J/N)

c)       Es ist weder /FITIN noch /IDENTIFY aktiv.

Textbezugspunkt digitalisieren: <t,CLS/t,CON>

(Falls dieser noch nicht unter Dialogpunkt 6.b) bestimmt wurde)

Textrichtung bestimmen:

(Falls der Parameter /HORIZONT nicht aktiv ist)

Ersten Richtungspunkt digitalisieren: <P,CLS/t,CON>

Zweiten Richtungspunkt digitalisieren: <t,CLS/t,CON>

(Falls /1POINT nicht aktiv ist und der erste Richtungspunkt angegeben wurde)

Der im Dialog verwendete Platzhalter t kann durch die Parameter P, L, C oder R ersetzt werden, die – falls nicht anders angegeben – eine selektive Identifizierung ermöglichen.

Der Dialog kann jederzeit über die Eingabe von #CON verlassen werden, falls nichts anderes erwähnt wurde. Es findet dann keine Textplatzierung statt.

Wird eine unerlaubte Eingabe gemacht so wird eine Fehlermeldung veranlasst und der Dialog wird entweder wiederholt oder ganz verlassen.

Beispiel

Kommandozeileneingabe:

AddText DKY/4 DKA/0 TXM/ask POS/r TXI/500 TEX/-1 ALPHA/90 BETA/0 Z/0 ABS/1 TXL/0 BUFFER/1 /1POINT

AddText DKY/3 DKA/1 „Dies ist ein Text“ BUFFER/-1 /FITIN

AddText TXI/ask /HORIZONT /EXPAND

AddText /FITIN /IDENTIFY

AddText SWAPTEXT/-8 SWAPABS/250

AddText /H

AddText

Attributtext anlegen

AddText /EXPAND ...

Einfachen linksbündigen Text definieren

AddText

Texthöhe eingeben: (n)

500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s)

Hello

Bezugspunkt bestimmen: <t,CLS/t,CON>

#P 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P 10 0

Einfachen rechtsbündigen Text definieren mit Vordefinitionen

AddText DKY/ask DKA/ask TXM/ask

Zeichenschlüssel eingeben: (n)

3

Schraffurschlüssel eingeben: (n)

0

Textart eingeben: (n)

4

Texthöhe eingeben: (n)

500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s)

Hello

Bezugspunkt bestimmen: <t,CLS/t,CON>

#R 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P 10 0

Einfachen zentrierten Text mit Abstand zur Bezugslinie definieren

AddText ABS/ask

Textabstand eingeben: (x)

5.5

Texthöhe eingeben: (n)

500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s)

Hello

Bezugspunkt bestimmen: <t,CLS/t,CON>

#C 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P 10 0

Text aus dem Textpuffer anlegen

AddText TEX/-1

Texthöhe eingeben: (n)

500

Bezugspunkt bestimmen: <t,CLS/t,CON>

#P 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON>

#P 10 0

Text entlang dem Horizont plazieren

AddText /HORIZONT ...

AddText ...

Texthöhe eingeben: (n) 500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s) Hello

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON> #CON

Text orthogonal zur Basislinie plazieren

AddText ...

Texthöhe eingeben: (n) 500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s) Hello

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON> #P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON> #R 10 0

Text mit einem freien Winkel zur Basislinie plazieren

AddText ...

Texthöhe eingeben: (n) 500

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s) Hello

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

1. Richtungspunkt bestimmen: <t,CLS/t,CON> #P -10 0

2. Richtungspunkt bestimmen: <t,CLS/t,CON> #C 10 0

Winkel eingeben: (a) 45

Text entlang eines String-Elements plazieren

AddText /IDENTIFY

String-Element identifizieren: <t,CLS/t,CON> #P 50 -34

Texthöhe eingeben: (n) 500

Text eingeben: (s) Hello

Soll das String-Element gelöscht werden? (J/N) N

Text zwischen zwei Punkten einpassen (Texthöhe wird angepasst)

AddText /FITIN

Text eingeben: (s) Hello

1. Einpaßpunkt bestimmen: <P,CLS/P,CON> #P 0 0

2. Einpaßpunkt bestimmen: <P,CLS/P,CON> #P 10 10

Text zwischen zwei Punkten mit fester Texthöhe einpassen

AddText /FITIN TXI/ask

Texthöhe eingeben: (n) 500

Text eingeben: (s) Hello

1. Einpaßpunkt bestimmen: <P,CLS/P,CON> #P 0 0

2. Einpaßpunkt bestimmen: <P,CLS/P,CON> #P 10 10

Text auf ein String-Element einpassen

AddText /FITIN /IDENTIFY

Texthöhe wird angepaßt

AddText /FITIN /IDENTIFY TXI/ask    

Texthöhe bleibt fest

(Die Dialoge zum Einpassen eines Elements und zum Plazieren entlang eines Elements werden hier nur verknüpft)

Swaptextgruppe anlegen

AddText SWAPTEXT/-5 SWAPABS/500

(Fünf Swaptexte untereinander im Abstand der halben Texthöhe)

Texthöhe eingeben: (n) 1000

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

Richtungspunkt bestimmen: <t,CLS/t,CON> #P -10 0

Richtungspunkt bestimmen: <t,CLS/t,CON> #P 10 0

AddText SWAPTEXT/5

(Fünf Swaptexte übereinander ohne einen Zwischenraum)

Texthöhe eingeben: (n) 1000

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

Richtungspunkt bestimmen: <t,CLS/t,CON> #P -10 0

Richtungspunkt bestimmen: <t,CLS/t,CON> #P 10 0

AddText

(Zwei Swaptexte übereinander ohne einen Zwischenraum)

Texthöhe eingeben: (n) 1000

Text eingeben oder Bezugspunkt bestimmen: <t,CLS/t,CON> (s) &+2

Bezugspunkt bestimmen: <t,CLS/t,CON> #P 10 15

Richtungspunkt bestimmen: <t,CLS/t,CON> #P -10 0

Richtungspunkt bestimmen: <t,CLS/t,CON> #P 10 0

Beispiel Zeilenumbruch  durch  \r  oder  \n

In Batch-Dateien muß für den Zeilenumbruch \n und in der Kommandozeile \r verwendete werden !

AddText /HORIZONT

Texthöhe eingeben:

800

Text-String eingeben:

SUPER \r GEIL

Bezugspunkt digitalisieren: <P,L,C,R,CLS/x,CON>

#P -10 0

Bemerkung

Performance:

Ist der Parameter /IDENTIFY oder /FITIN aktiv, dann bleibt der Parameter /HORIZONT ohne Wirkung.

Ist im Dialogpunkt 7b) zusätzlich der Parameter TXI sinnvoll (d.h. echt positiv) belegt, so findet eine automatische Längenstreckung des Textes statt, ansonsten erfolgt eine automatische Anpassung der Texthöhe.

Alle für Texte möglichen Einstellungsparameter sind beliebig über Kommandozeileneingabe vordefinierbar.

Aufgrund der Kompatibilität zu den alten GRADIS-Funktionen (siehe auch die Entsprech-ungen), sind einige Funktionalitäten redundant zu erreichen (Beispiel: Plazierung eines Textes parallel zum Horizont kann sowohl über die Angabe des Funktionsparameters /HORIZONT, als auch über die Angabe von #CON bei der Eingabe des ersten Richtungspunkts – siehe auch Dialogpunkt 7.c) – erzwungen werden.

Die Text unterliegen zur Zeit einer Einschränkung von maximal 2048 Zeichen.

Entsprechungen:

Erläuterung zu Swaptexten:

Wird im Dialog kein Text definiert, so wird automatisch ein Swaptext generiert – ein Platzhalter für einen Text, der zu einem späteren Zeitpunkt durch die Funktion SwapText/SWT belegt werden kann. Ein Swaptext besitzt die Textkennung „SWT“ gefolgt von einer fortlaufenden Nummer (SWT1, SWT2, SWT3, ...), welche automatisch vergeben wird.

Es ist zu beachten, das die Nummern zur Kennzeichnung der Swaptexte bei jeder Sitzung neu initialisiert werden. Es ist daher ratsam Swaptexte innerhalb einer Sitzung durch den richtigen Text zu ersetzen.

Swaptexte sind nicht möglich, wenn einer der beiden Parameter /IDENTIFY oder /FITIN aktiv ist, da mit Swaptexten keine Einpassung vorgenommen werden kann.

Erläuterung zu Swaptextgruppen:

Wird der Funktionsparameter SWAPTEXT/n mit n ungleich Null gewählt oder ist der angegebene Textstring von der Form &n mit n ungleich Null, so wird eine Swaptextgruppe angelegt. D.h. es werden n Swaptexte übereinander (n > 0) bzw. untereinander (n < 0) angelegt.

Über den Parameter SWAPABS/n kann ein einzuhaltender Abstand zwichen den Swaptexten definiert werden. Fehlt der Parameter, so folgen die Swaptexte in Texthöhenabstand ohne Freiraum direkt über- oder unterinander.

Die einzelnen Swaptexte sind nach dem Anlegen unabhängig voneinander und es gilt für sie das oben erwähnte für Swaptexte.

Siehe auch

ExplodeMultilineText

--------------------OLD_TEXT---------------------

Put in of a text element.

With AddText if a text element can be put on universally. It can be placed arbitrarily fitted, be aimed and/or be defined in his settings. The text may own at the moment only in length of 2048 signs, otherwise he is defeated by no restriction. The text can be given as a parametre, as well as be inferred from the text table or the text buffer. It is possible furthermore to file the text as a standard text as well as as an attribute text.

A part of the dialogue is steered about the functional parametres. Furthermore all necessary settings can be also predefined over this (all parametres do not case sensitively).

Condition

The data bank must be opened

An object must be opened.

Parametre

\r or \n

in the text cause a word wrap. \r is for the input in the command line and \n for the input in Batch files (see example "word wrap").

DKY/

The sign key of the text element is fixed.

The information of the parametre is optional and occurs in the form DKY/N, and n from the natural figures can be chosen including the zero. Alternatively it is possible, the parametre in the form DKY/ask to brag to force a dialogue for the parametre. If the parametre is absent, so becomes either the preinitialized value (see the also function InitializeParameter/DKY) accepted, if this is defined or zero otherwise.

DKA/

The surface key of the text element is fixed.

The information of the parametre is optional and occurs in the form DKA/N, and n from the natural figures can be chosen including the zero. Alternatively it is possible, the parametre in the form DKA/ask to brag to force a dialogue for the parametre. If the parametre is absent, so becomes either the preinitialized value (see the also function InitializeParameter/DKA) accepted, if this is defined or zero otherwise.

TXM/

The text kind of the text element is fixed. These can be seen in the text kind table. At the moment are only nine text kinds 0..., 8 defines.

The information of the parametre is optional and occurs in the form TXM/N, and n from the natural figures can be chosen including the zero (Follows which text kinds are defined!). Alternatively it is possible, the parametre in the form TXM/ask to brag to force a dialogue for the parametre. If the parametre is absent, so becomes either the preinitialized value (see the also function InitializeParameter /TXM) accepted, if this is defined or zero otherwise.

BOTTOMS

The adjustment of the text element is fixed with regard to the reference point.

The information of the parametre is optional and occurs in the form Of bottom / p., and see to one of the following letters must correspond which cannot become case sensitively angegebe:

If the parametre is absent, this can be fixed either with the definition of the reference point, or he is accepted normally as flush left.

TXI/

The text height of the text element is fixed (The information occurs in 1/100 mm).

The information of the parametre is optional and occurs in the form TXI/N, and n from the natural figures can be chosen including the zero. Alternatively it is possible, the parametre in the form TXI/ask to brag to force a dialogue for the parametre. If the parametre is absent, he is accepted to zero.

TEX/

It becomes the authoritative number the takeover of a text from the text table or from the text buffer (-1 as an authoritative number) agreed.

The information of the parametre is optional and occurs in the form TEX/N, and n from the natural figures including her -1 it can be chosen. Besides, it means -1 a takeover of the text from the text buffer. If the parametre is absent or he corresponds to no valid authoritative number, he is ignored.

If a text was already handed over in the command line (see the also free parametre TEXT), thus a dialogue specially intended for it takes place which text should be used.

ALPHA

The corner is fixed in the x Y level around which the text element is turned in the reference point relatively to the positive x axis.

The information of the parametre is optional and occurs in the form Alpha / x, and x from the honest figures can be chosen. The square can be determined by predoing a letter, besides, the following values are allowed:

R corner is given in Radiant

D corner is given in degree (DEGREE)

G Corner is given in new degree (GON)

Without letter the information occurs in the square opposed in Moskito (variable WGR).

If the counter ALPHA has no (allowed) value the function is finished.

BETA

The corner is fixed in the x z level around which the text element is turned in the reference point relatively to the x axis.

The information of the parametre is optional and occurs in the form Beta / x, and x from the honest figures can be chosen. The information occurs in degree (0 ° – 360 °). If the parametre is absent, becomes normal from a corner from 0 ° gone out. Besides, the degree sign must not be cogiven.

Z/

The z co-ordinate is fixed for the reference point of the text element.

The information of the parametre is optional and occurs in the form Z/x, and x from the honest figures can be chosen. If the information is absent, it is prebooked normally with zero.

PARAGRAPH

The distance of the text is fixed to his defined base line.

The information of the parametre is optional and occurs in the form Paragraph / x, and x from the honest figures can be chosen. Alternatively it is possible, the parametre in the form Paragraph / ask to brag to force a dialogue for the parametre. If the parametre is absent, he is prebooked normally with zero.

TXL/

It becomes the state line length, i.e. the total length of the text element agreed.

The information of the parametre is optional and occurs in the form TXL/x, and x from the honest figures can be chosen. If the parametre is absent or becomes he by the active parametre /FITIN overlays, he is ignored.

BUFFER

It is fixed in which form the defined text or the text element are put on.

The information of the parametre is optional and occurs in the form Buffer / N, and n to one of the following values must correspond:

-1: Text is filed only in the text buffer;

0: Text element is taken over in the data bank and, in addition, the text is filed in the text buffer;

+1: Text element is taken over only in the data bank.

If the parametre is absent, is able only one takeover of the text element is carried out normally in the data bank.

/EXPAND

It is arranged that by the parametre <Text> defined text element is put as an attribute text.

The information of the parametre is optional and occurs in the form /EXPAND.

/ATX

A Flag is put which causes that the parametre <Text> receives the form of an attribute text, i.e. it are put %% around the text string which provide for the fact that the contents of the attribute and the attribute text of the same name agree.

/FITIN

It is arranged that the defined text is fitted between two points. If the parametre IDENTIFY is active, in addition, an integration takes place on any string element. The integration occurs about a stretching of the text (enlargement of the sign space), if the parametre is high active. The integration occurs about a dimensions adaptation (adaptation of the text height), if the parametre is high inactive.

The information of the parametre is optional and occurs in the form /FITIN.

/ HORIZON

It is arranged that the predefined horizon serves as a base line along which the text is placed in parallel. If no horizon is defined, the horizon direction is accepted normally as in the direction of x axis in the global co-ordinate system.

The information of the parametre is optional and occurs in the form / HORIZON.

REFPOINT

As a position of the text the topically open point is used.

OFFSETX/nnn

OFFSETY/nnn

Distance of the text of the authoritative point. These parametres are only evaluated if/REFPOINT was also given. The offset is given in 1/100 mm.

OFFSET'S ALPHA

/1POINT

It is arranged that only one direction point is questioned and the reference point is valid at the same time as the first direction point. This leads to a simplification of the dialogue.

The information of the parametre is optional and occurs in the form /1POINT.

SWAPTEXT/

It is arranged that a whole Swaptextgruppe is put on. Besides, the texts form a group under or about the central text which fixes itself in the text reference point.

The information of the parametre is optional and occurs in the form SWAPTEXT/N, and n from the area of the integers can be chosen. Besides, is valid:

n> 0: Swaptexte are arranged about one another,

n< 0: Swaptexte are arranged together.

SWAPABS/

The distance of the lines within the Swaptexte is fixed with the information of a Swaptextgruppe. The information occurs in 1/100 mm. The parametre is considered only with the input of a Swaptextgruppe.

The information of the parametre is optional and occurs in the form SWAPABS/N, and n from the area of the natural figures can be chosen.

<TEXT>

Every sign result which corresponds to none of the preliminary parametres is automatically interpreted as a text. Should the sign result contain one or several blanks, it must be enclosed accordingly by single quotation marks.

If the sign result begins with the sign &, thus the following signs are interpreted as an information for a Swaptextgruppe (according to the parametre SWAPTEXT/n)

/H

It becomes a help to the function AddText given. The auxiliary text contains a short description of the function as well as call instructions.

The information of the parametre is optional and occurs in the form -H or /H (equivalent inputs).

Return value

Dialogue

Input of the sign key: (n)

(If the parametre DKY/ask it is active)

Input of the surface key: (n)

(If the parametre DKA/ask it is active)

Input of the text kind: (n)

(If the parametre TXM/ask it is active)

Input of the text height: (n)

(If the parametres/FITIN and BUFFERS-1 were not activated and the text height not already about the parametre TXI/n it was predefined)

Input of the text distance to the base line: (x)

(If the parametre ABS/ask it is active)

If no text was still predefined, one of both following dialogues takes place:

Input of a text: (s)

(If one of the parametres/FITIN,/IDENTIFY, BUFFERS-1 or BUFFER0 it is active)

Input of a text or a text reference point:

(If under a) to given conditions do not apply) <t, CLS/t, CON> (see, &x)

In dependence of the choice of the tax parametres /IDENTIFY, /FITIN and / HORIZON if one of the following different dialogues takes place:

a) Determine text integration:

(If the parametre/FITIN is active)

The first Einpaßpunkt determine: <P, CLS/P, CON>

The second Einpaßpunkt determine: <P, CLS/P, CON>

b) Place text along a string element:

(If the parametre/IDENTIFY is active)

String element identify: <P, L, CON>

Should the string element be extinguished afterwards (J/N)

c) It is active neither/FITIN nor/IDENTIFY.

Text reference point digitize: <t, CLS/t, CON>

(If this was not determined yet under dialogue point 6.b))

Text direction determine:

(If the parametre / HORIZON is not active)

The first direction point digitize: <P, CLS/t, CON>

The second direction point digitize: <t, CLS/t, CON>

(If/1POINT is not active and the first direction point was given)

The place holder used in the dialogue t can be substituted with the parametres P, L, C or R, – if do not allow differently given – a selective identification.

The dialogue is able any time about the input of #CON are left, if nothing else was mentioned. Then no text order takes place.

If an unauthorised input becomes made so an error message is arranged and the dialogue is either repeated or is completely left.

Example

Command line input:

AddText DKY / 4 DKA / 0 bottoms / r TXM/ask TXI / 500 TEX/-1 ALPHA / 90 BETAS / 0 Z/0 ABS / 1 TXL / 0 BUFFERS / 1/1POINT

AddText DKY / 3 DKA / 1 „This is a text“ BUFFER/-1/FITIN

AddText TXI/ask / HORIZON/EXPAND

AddText/FITIN/IDENTIFY

AddText SWAPTEXT/-8 SWAPABS / 250

AddText/H

AddText

Attribute text put on

AddText/EXPAND...

An easy flush left text define

AddText

Text height give: (n)

500

Text give or determine reference point: <t, CLS/T, CON> (s)

Hello

Reference point determine: <t, CLS/T, CON>

#P 10 15

1. Determine direction point: <t, CLS/T, CON>

#P-10 0

2. Determine direction point: <t, CLS/T, CON>

#P 10 0

An easy flush right text define with predefinitions

AddText DKY/ask DKA/ask TXM/ask

Sign keys give: (n)

3

Shading keys give: (n)

0

Text kind give: (n)

4

Text height give: (n)

500

Text give or determine reference point: <t, CLS/T, CON> (s)

Hello

Reference point determine: <t, CLS/T, CON>

#R 10 15

1. Determine direction point: <t, CLS/T, CON>

#P-10 0

2. Determine direction point: <t, CLS/T, CON>

#P 10 0

An easy centred text by far to the relation line define

AddText paragraph / ask

Text distance give: (x)

5.5

Text height give: (n)

500

Text give or determine reference point: <t, CLS/T, CON> (s)

Hello

Reference point determine: <t, CLS/T, CON>

#C 10 15

1. Determine direction point: <t, CLS/T, CON>

#P-10 0

2. Determine direction point: <t, CLS/T, CON>

#P 10 0

Text from the text buffer put on

AddText TEX/-1

Text height give: (n)

500

Reference point determine: <t, CLS/T, CON>

#P 10 15

1. Determine direction point: <t, CLS/T, CON>

#P-10 0

2. Determine direction point: <t, CLS/T, CON>

#P 10 0

Text along the horizon place

AddText / HORIZON...

AddText...

Text height give: (n) 500

Text give or determine reference point: <t, CLS/T, CON> (s) Hello

Reference point determine: <t, CLS/T, CON >#P 10 15

1. Determine direction point: <t, CLS/T, CON >#CON

Text orthogonal to the base line place

AddText...

Text height give: (n) 500

Text give or determine reference point: <t, CLS/T, CON> (s) Hello

Reference point determine: <t, CLS/T, CON >#P 10 15

1. Determine direction point: <t, CLS/T, CON >#P-10 0

2. Determine direction point: <t, CLS/T, CON >#R 10 0

Text with a free corner to the base line place

AddText...

Text height give: (n) 500

Text give or determine reference point: <t, CLS/T, CON> (s) Hello

Reference point determine: <t, CLS/T, CON >#P 10 15

1. Determine direction point: <t, CLS/T, CON >#P-10 0

2. Determine direction point: <t, CLS/T, CON >#C 10 0

Corners give: (a) 45

Text along a string element place

AddText/IDENTIFY

String element identify: <t, CLS/T, CON >#P 50-34

Text height give: (n) 500

Text give: (s) Hello

Should the string element be extinguished? (J/N) N

Text between two points fit (text height it is adapted)

AddText/FITIN

Text give: (s) Hello

1. Einpaßpunkt determine: <P, CLS/P, CON >#P 0 0

2. Einpaßpunkt determine: <P, CLS/P, CON >#P 10 10

Text between two points with firm text height fit

AddText/FITIN TXI/ask

Text height give: (n) 500

Text give: (s) Hello

1. Einpaßpunkt determine: <P, CLS/P, CON >#P 0 0

2. Einpaßpunkt determine: <P, CLS/P, CON >#P 10 10

Text on a string element fit

AddText/FITIN/IDENTIFY

Text height is adapted

AddText/FITIN/IDENTIFY TXI/ask

Text height remains firm

(The dialogues for fitting of an element and to the placing along an element are only tied together here)

Swaptextgruppe put in

AddText SWAPTEXT/-5 SWAPABS / 500

(Five Swaptexte together in the distance of half a text height)

Text height give: (n) IN 1000

Reference point determine: <t, CLS/T, CON >#P 10 15

Direction point determine: <t, CLS/T, CON >#P-10 0

Direction point determine: <t, CLS/T, CON >#P 10 0

AddText SWAPTEXT / 5

(Five Swaptexte about one another without space)

Text height give: (n) in 1000

Reference point determine: <t, CLS/T, CON >#P 10 15

Direction point determine: <t, CLS/T, CON >#P-10 0

Direction point determine: <t, CLS/T, CON >#P 10 0

AddText

(Two Swaptexte about one another without space)

Text height give: (n) IN 1000

Text give or determine reference point: <t, CLS/T, CON> (s) &+2

Reference point determine: <t, CLS/T, CON >#P 10 15

Direction point determine: <t, CLS/T, CON >#P-10 0

Direction point determine: <t, CLS/T, CON >#P 10 0

Example word wrap by \r or \n

In Batch files has to go for the word wrap \n and in the command line \r used become!

AddText / HORIZON

Text height give:

800

Text string give:

REALLY \r COOL

Reference point digitize: <P, L, C, R, CLS/x, CON>

#P-10 0

Remark

Performance:

If is the parametre /IDENTIFY or /FITIN actively, then the parametre remains / HORIZON without effect.

If is in the dialogue point 7b), in addition, the parametre TXI sensibly (i.e. really positively) books, an automatic length stretching of the text takes place, otherwise an automatic adaptation of the text height occurs.

All setting parametres possible for texts are predeterminable arbitrarily about command line input.

On account of the compatibility to the old GRADIS functions (see the also Entsprech-ungen), some functionalities are to be reached redundant (example: Placing of a text in parallel with the horizon can be forced about the information of the functional parametre / HORIZON, as well as about the information by #CON with the input of the first direction point – see also dialogue point 7.c)–.

The text are defeated at the moment by a restriction of maximum 2048 signs.

Correspondences:

Explanation to Swaptexten:

If no text is defined in the dialogue, a Swaptext is automatically generated – a place holder for a text, at a later time by the function SwapText/SWT it can be booked. A Swaptext owns the text call sign "SWT" followed from a sequential number (SWT1, SWT2, SWT3...) which will automatically award.

It is to be followed that the numbers are anew initialized to the marking of the Swaptexte with every meeting. Hence, it is to be substituted advisable Swaptexte within a meeting with the right text.

Swaptexte are not possible if one of both parametres/IDENTIFY or/FITIN is active, because with Swaptexten no integration can be carried out.

Explanation to Swaptextgruppen:

If becomes the functional parametre SWAPTEXT/n with n incomparably zero electively or is the given text string of the form &n with n incomparably zero, so a Swaptextgruppe is put on. I.e. these become n Swaptexte about one another (n> 0) or together (n< 0) invested.

About the parametre SWAPABS/n if a distance to be kept zwichen the Swaptexten can be defined. If the parametre is absent, the Swaptexte follow in text vertical spacing without clearance directly about or unterinander.

The single Swaptexte are on putting on independently of each other and it is worth for them on top mentioned for Swaptexte.

See also

ExplodeMultilineText