AddArc [ARC]

AddArc  [ARC]

Anlegen eines Kreiselementes.

AddArc erzeugt im geöffneten Objekt einen Vollkreis, bestehend aus zwei halbkreisförmigen Kreisbögen, oder einen Kreisbogen. Das neue Element wird geöffnet. Für ihre Definition stehen mehrere alternative Eingabekombinationen zur Verfügung.

Einige der Funktionsparameter können in der Kommandozeile übergeben werden (alle Parameter sind nicht case-sensitiv).

Voraussetzung

Eine Datenbank muß eröffnet sein.

Ein Objekt muss eröffnet sein.

Parameter

DKY/n

Es wird der Zeichenschlüssel des anzulegenden Kreises festgelegt. Der Parameter bestimmt das Aussehen und die Funktion der Kreislinie.

Die Angabe des Parameters ist optional und erfolgt in der Form DKY/n, wobei n aus dem ganzen natürlichen Zahlenbereich gewählt werden kann. Fehlt der Parameter wird entweder der vorinitialisierte Wert (siehe auch die Funktion InitializeParameter /DKY) angenommen, falls dieser definiert ist oder Null ansonsten.

DKA/n

Es wird der Flächenschlüssel für den anzulegenden Kreis festgelegt. Der Parameter bestimmt das innere Füllmuster und die Art der Füllung der Kreisfläche.

Die Angabe des Parameters ist optional und erfolgt in der Form DKA/n, wobei für n jeder positive numerische Wert angegeben werden kann, der einem Tabelleneintrag (Schraffur) entspricht. Einen Sonderfall stellt der Wert Null dar. Er gibt an, dass es sich um keine Fläche sondern einen einfachen Linienzug handelt. Fehlt der Parameter wird entweder der vorinitialisierte Wert (siehe auch die Funktion InitializeParameter /DKA) angenommen, falls dieser definiert ist oder Null ansonsten.

DIM/n

Es wird die Dimension der Koordinaten festgelegt, mit der der Kreis erfasst werden soll.

Die Angabe des Parameters ist optional und erfolgt in der Form DIM/n, wobei für n nur die Werte Zwei (Planart – Default) bzw. Drei (Räumlich) sinnvoll sind.

PCL/n

Es wird die Punktklasse für den Anfangs- und Endpunkt des anzulegenden Kreises festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form PCL/n, wobei n aus dem ganzen natürlichen Zahlenbereich gewählt werden kann (Defaultwert ist Null).

PSY/n

Es wird das Punktsymbol für den Anfangs- und Endpunkt des anzulegenden Kreises festgelegt.

Die Angabe des Parameters ist optional und erfolgt in der Form PSY/n, wobei n aus dem ganzen natürlichen Zahlenbereich gewählt werden kann (Defaultwert ist Null). Dabei ist das jeweilige Punktsymbol in der Symboltabelle definiert.

RADIUS/n

Es wird für die Eingabekombination (C, R1, R2, Radius) der Radius festgelegt.

/H

Es wird eine Hilfe für die Funktion AddArc gegeben. Der Hilfetext 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

Definition eines Kreises durch eine der folgenden erlaubten Eingabekombinationen:

a) (C, Radius)

Zuerst wird der Kreismittelpunkt C digitalisiert, dann der Radius über die Tastatur eingegeben. Das Ergebnis ist ein Vollkreis, der bei positiven Radius gegen und bei negativem Radius im Uhrzeigersinn orientiert ist. Definitionsbereich für C ist der gesamte Arbeitsbereich, für Radius alle Werte, deren Absolutwert nicht kleiner als die vorgegebene Genauigkeit des Plans ist.

b) (C, P, CON)

Zuerst wird zuerst der Kreismittelpunkt C digitalisiert, dann ein beliebiger Kreispunkt P und schließlich die Eingabe mit CON abgeschlossen. Das Ergebnis ist ein Vollkreis durch den Punkt P mit dem Mittelpunkt C. Der Kreis ist gegen den Uhrzeigersinn orientiert. Definitionsbereich für C und P ist der gesamte Arbeitsbereich, jedoch dürfen sie nicht identisch sein.

c) (C, P1, P2)

Zuerst wird der Kreismittelpunkt C digitalisiert, dann ein beliebiger Kreispunkt P1 und schließlich ein weiterer Punkt P2. Das Ergebnis ist ein Kreisbogen mit dem Mittelpunkt C, dem Startpunkt P1 und dem Endpunkt auf der Verbindungsgeraden zwischen C und P2. Der Kreisbogen ist im Uhrzeigersinn vom Start- zum Endpunkt orientiert. Definitionsbereich für die Punkte ist der gesamte Arbeitsbereich, jedoch dürfen sie paarweise nicht identisch sein.

d) (C, R1, R2, Radius)

Zuerst wird der Kreismittelpunkt C digitalisiert, dann ein beliebiger Punkt R1 auf dem Strahl vom Mittelpunkt zum Kreisbogenanfang, dann ein beliebiger Punkt R2 auf dem Strahl vom Mittelpunkt zum Kreisbogenende und schließlich der Radius über die Tastatur eingegeben, wenn er nicht als RADIUS Parameter übergeben wurde. Dabei wird für einen positiven Radius das kleinere (<180°) Bogenstück gewählt, ansonsten das größere Bogenstück. R1 und R2 dürfen nicht mit dem Mittelpunkt identisch sein. Liegen R1 und R2 auf dem gleichen Strahl, dann muss der Radius negativ sein, und es wird ein gegen den Uhrzeigersinn orientierter Vollkreis erzeugt.

e) (P1, P2, Radius)

Zuerst werden zwei beliebige Kreispunkte P1 und P2 digitalisiert, und dann der Radius über die Tastatur eingegeben. Das Ergebnis ist ein Kreisbogen mit dem Startpunkt P1 und dem Endpunkt P2. Bei positivem Radius wird das kleinere (< 180°) Bogenstück gewählt, sonst das größere. Der Definitionsbereich für die beiden Kreispunkte ist der gesamte Arbeitsbereich, jedoch dürfen sie nicht identisch sein. Der Absolutwert des Radius darf nicht kleiner sein als die vorgegebene Genauigkeit des Plans.

f) (P1, R, P2)

Es werden drei beliebige Kreispunkte P1, R, P2 digitalisiert. Das Ergebnis ist ein Kreisbogen mit Startpunkt P1 und Endpunkt P2. Dabei ist der Kreisbogen so orientiert, dass er den zusätzlichen Kreispunkt R mit einschließt. Definitionsbereich für die Punkte ist der gesamte Arbeitsbereich, jedoch dürfen sie paarweise nicht identisch sein.

g) (P, R1, R2)

Es werden drei beliebige Kreispunkte P, R1, R2 digitalisiert. Das Ergebnis ist ein Vollkreis durch die drei Kreispunkte mit der gleichen Orientierung wie der Kreisbogen von P über R1 nach R2. Definitionsbereich der Punkte ist der gesamte Arbeitsbereich, jedoch dürfen sie paarweise nicht identisch sein.

Der Dialog kann jederzeit über die Eingabe von CON verlassen werden. Es findet dann keine Kreisdefinition statt.

Ein im Dialog erwarteter Punkt (C, P oder R) kann jederzeit über die Eingabe von CLS aus der Datenbank identifiziert werden. Hierfür steht ein eigener Dialog zur Verfügung.

Eine unerlaubte Eingabe während des Dialogs erzeugt immer eine Fehlermeldung. Abhängig vom jeweiligen Dialog wird dieser wiederholt, abgebrochen oder die Funktion ganz verlassen.

Beispiel

Kommandozeileneingabe:

AddArc DKY/5 DKA/64 DIM/3 PCL/9 PSY/12

AddArc /H

AddArc

Kreisdefinition a) (C, Radius)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#C 10 15

Kreisbogenpunkt digitalisieren oder Radius eingeben: <P,CLS/P,CON> (Radius)

30.0

Kreisdefinition b) (C, P, CON)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#C 10 15

Kreisbogenpunkt digitalisieren oder Radius eingeben: <P,CLS/P,CON> (Radius)

#P 20 10

Bogenendpunkt digitalisieren oder Vollkreis definieren: <P,CLS/P,CON>

#CON

Kreisdefinition c) (C, P1, P2)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#C 10 15

Kreisbogenpunkt digitalisieren oder Radius eingeben: <P,CLS/P,CON> (Radius)

#P 20 10

Bogenendpunkt digitalisieren oder Vollkreis definieren: <P,CLS/P,CON>

#P -5 12

Kreisdefinition d) (C, R1, R2, Radius)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#P 10 10

Bogenend- oder Bogenzwischenpunkt digitalisieren: <P,R,CLS/P,CLS/R,CON>

#P 0 25

Radius eingeben:(Radius)

30.0

Kreisdefinition e) (P1, P2, Radius)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#P 10 10

Bogenend- oder Bogenzwischenpunkt digitalisieren: <P,R,CLS/P,CLS/R,CON>

#R 0 25

Bogenend- oder Bogenzwischenpunkt digitalisieren: <P,R,CLS/P,CLS/R,CON>

#P 12 40

Kreisdefinition f) (P1, R, P2)

Mittelpunkt oder Kreisbogenpunkt digitalisieren: <P,C,CLS/C,CLS/P,CON>

#P 10 10

Bogenend- oder Bogenzwischenpunkt digitalisieren: <P,R,CLS/P,CLS/R,CON>

#R 0 25

Bogenend- oder Bogenzwischenpunkt digitalisieren: <P,R,CLS/P,CLS/R,CON>

#R 12 40

Kreisdefinition g) (P, R1, R2)

Mittelpunkt (C) oder Bogenanfang (P) digitalisieren: <C,P,CLS/C,CLS/P,CON>

#P 10 10

Bogenende (P) oder Bogenzwischenpunkt (R) digitalisieren: <P,R,CLS/P,CLS/R,CON>

#R 0 25

Bogenzwischenpunkt für den Vollkreis (R) oder Bogenendpunkt (P) digitalisieren: <P,R,CLS/P,CLS/R,CON>

#R 12 40

Bemerkung

Das angelegte Kreiselement wird automatisch zum aktuellen selektierten Element des Plans.

Punktklasse und Punktsymbol können nur für den Anfangs- und Endpunkt bei Kreissegmenten definiert werden, nicht für die Kreiszwischenpunkte. Diese sind jeweils mit Null vorgegeben.