Zuweisungsschlüsselwörter
Die folgenden Schlüsselwortbeschreibungen umfassen eine Kurzbeschreibung der Schlüsselwortfunktion, die Typen der Elemente, auf die das Schlüsselwort zutrifft (falls zutreffend), die gültigen Datentypen (falls zutreffend) und ein Beispiel für die Schlüsselwortverwendung. Im Abschnitt nach den Zuweisungsschlüsselwörtern wird beschrieben, wie Color in einer Zuweisungsanweisung angegeben wird.
area_fill
Für Plotter, die Polygonfülle unterstützen, plottet das Schlüsselwort area_fill geschlossene Elemente als ausgefüllt, wenn sie auf true gesetzt werden. Beim Einstellen der Zuweisungsschlüsselwörter fill_color oder pattern wird area_fill auf true gesetzt. Das Schlüsselwort area_fill kann verwendet werden, um Elemente zu plotten, die andernfalls ausgefüllt als Entwurf plotten würden. Jedes geschlossene Element (außer Text) kann mit diesem Schlüsselwort gesteuert werden, einschließlich geschlossene B-Spline-Kurven, komplexe Polygonflächen, Ellipsen und Flächen.
Syntax:
area_fill = true area_fill = false
Beispiel:
! ! Füllen Sie den Bereich für alle Formen. ! if (type == shape) then area_fill = true endif
boundary_color
Das Schlüsselwort boundary_color wird verwendet, um die Begrenzungsfarbe eines Bereichs oder eines mustergefüllten Polygons festzulegen. Boundary_color beeinflusst nur gefüllte Elemente mit boundary_display, die auf true gesetzt wurden. Für eine detaillierte Beschreibung zum Festlegen der Color siehe "Farben in Zuweisungsanweisungen festlegen" am Ende dieses Abschnitts.
Syntax:
boundary_color = integer
(wobei integer ein Farbindex im Bereich zwischen 0 und 255 ist)
boundary_color = "string"
(wobei string ein Name aus einer Colornbibliothek ist)
boundary_color = (R,G,B)
(wobei RGB im Bereich zwischen 0 und 255 liegt)
Beispiel:
! ! Set boundary_color and boundary_display for ! shapes on level 7. ! if ((type == shape) and (level == 7)) then area_fill = true color = 'blue' boundary_display = true boundary_color = 'red' endif
boundary_display
Für Elemente, die in die Zeichnungsdatei oder mit dem Schlüsselwort area_fill in das Designskript gefüllt werden, legt das Schlüsselwort boundary_display fest, ob die Begrenzung eines gefüllten Polygons geplottet wird. Das Schlüsselwort boundary_display hat keine Auswirkung auf Elemente, die nicht gefüllt sind.
Bemerkung: Wird boundary_display für den ausgefüllten Text auf true gesetzt, kann dies unter Umständen unerwünschte Auswirkungen haben.
Syntax:
boundary_display = true boundary_display = false
Beispiel:
! ! Set boundary_color and boundary_display for ! shapes on level 7. ! if ((type == shape) and (level == 7)) then area_fill = true color = 'blue' boundary_display = true boundary_color = 'red' endif
case_sensitive
Das Schlüsselwort case_sensitive legt fest, ob die Groß- und Kleinschreibung von Buchstaben beim Vergleichen von Zeichenfolgen unter Verwendung des Vergleichs-Schlüsselwortes von Bedeutung ist. Der Standardwert ist false.
Syntax:
case_sensitive = true case_sensitive = false
Beispiel:
! !Replace text elements having !characters "TITLE" with all-caps, and !replace "Title" with first letter caps title. ! case_sensitive = true if (characters == "TITLE") then characters = "FIRST FLOOR DESIGN" else if (characters == "Title") then characters = "First Floor Design" endif
characters
Mit dem Schlüsselwort characters können Sie eine Zeichenfolge in einem Textelement durch eine neue Zeichenfolge ersetzen. Indem Sie Textelemente als Platzhalter in Ihre Zeichnungsdatei einfügen, können Sie diese Zeichenfolgen später durch hilfreiche Informationen wie das Datum, an dem die Datei geplottet wurde, oder den Namen der Zeichnungsdatei ersetzen. Wenn die neue Zeichenfolge kürzer ist als die ursprüngliche, wird sie mit leeren Zeichen aufgefüllt. Wenn die neue Zeichenfolge länger ist, wird die ursprüngliche Zeichenfolge erweitert, um Platz für die zusätzlichen Zeichen zu schaffen.
Der Ersatztext kann den Wert verschiedener Token haben:
- Eine literale Zeichenfolge
- In der untenstehenden Tabelle angezeigte Definitionsschlüsselwörter drucken
- Der Wert einer oder mehrerer Umgebungsvariablen in Verbindung mit literalem Text
- Das Token <expr?name=...> zur Referenzierung eines benannten Ausdrucks
- Das Schlüsselwort envr_value
Die folgenden Schlüsselwörter stellen Werte aus der Druckdefinition dar, die zur Beschriftung eines Plots verwendet werden können.
Schlüsselwort |
Wert |
---|---|
am_pm |
Uhrzeit: 12- oder 24-Stunden-System. (Beispiel: AM) |
Datum |
Datieren Sie die Druckverarbeitungs-Occurs für eine Vorschau oder einen Druck. (Beispiel: Freitag, den 05.04.96) |
day_abbreviation |
Abkürzung des Wochentages bestehend aus drei Zeichen. (Beispiel: Fri) |
day_name |
Vollständiger Name des Wochentages. (Beispiel: Freitag) |
day_number |
Tag im numerischen Format. (Beispiel: 05) |
dgnspec |
Dateispezifikation der Vorlagenzeichnungsdatei. (Beispiel: C:\MYPROJ\E1.DGN) |
Stunde |
Zeitpunkt, an dem die Druckverarbeitung für eine Vorschau oder einen Druck durchgeführt wird. (Beispiel: 11) |
hour_12 |
Die Stundenzahl basierend auf einem 12-Stunden-Zyklus. (Beispiel: 05) |
hour_24 |
Die Stundenzahl basierend auf einem 24-Stunden-Zyklus. (Beispiel: 17) |
ip_color_table |
Die in der Zeichnungsdatei gespeicherte Zeichenfolge der Farbtabelle. (Beispiel: C:\MISC\COLOR.CTB) |
ip_design |
Name der Zeichnungsdatei. (Beispiel: C:\MYPROJ\PLAN.DGN) |
ip_design_script |
Der Name des mit dem Plotauftrag verbundenen Designskripts. Wird leer zurückgegeben, wenn die Datei eine Funktionstabelle ist. |
ip_feature_table |
Der Name der mit dem Plotauftrag verbundenen Funktionstabelle. Wird leer zurückgegeben, wenn die Datei ein Designskript ist. |
ip_logical_name |
Der logische Name als Referenz für das aktuelle Element. (Beispiel: C:\PROJ\BORDER.DGN) |
ip_mirror |
In der Druckdefinition gespeicherte Spiegeleinstellungen. Gültige Werte sind X, Y, BOTH oder NONE. |
ip_model |
Das in der Druckdefinition festgelegte Modell. (Beispiel: Blatt 1) |
ip_origin |
X und Y-Ursprung in den vom Schlüsselwort ip_units angegebenen Einheiten. (Beispiel: 1.500000,2.000000) |
ip_origin_x |
X-Ursprung in den von ip_units festgelegten Einheiten. (Beispiel: 1.500000) |
ip_origin_y |
Y-Ursprung in den von ip_units festgelegten Einheiten. (Beispiel: 5.000000) |
ip_pen_table |
Name des dem Plotauftrag zugeordneten Designskripts. |
ip_plot_rescale |
Skalierungswerte der X- und Y-Plots aus der Druckdefinition. (Beispiel: 3.000000,2.000000) |
ip_plot_rescale_x |
Skalierungswert des X-Plots aus der Druckdefinition. (Beispiel: 3.000000) |
ip_plot_rescale_y |
Skalierungswert des Y-Plots aus der Druckdefinition. (Beispiel: 2.000000) |
ip_project |
Das in der Druckdefinition festgelegte Projekt. (Beispiel: Baldwinsville) |
ip_queue |
Gibt den Namen des Windows-Systemdruckers zurück, sofern ein solcher definiert wurde. Andernfalls gibt er eine leere Zeichenfolge zurück. |
ip_ref_filename |
Vollständige Referenzdateispezifikation für das aktuelle Element. (Beispiel: C:\PROJ\FLOOR.DGN) |
ip_rotation |
Die Drehung des Plots, die als Winkel im Bereich zwischen 0 und 360 Grad angegeben wird. (Beispiel: 45.000000) |
ip_scale |
Die Plotskalierung im von MS_PLT_SCALE_METHOD festgelegten Format. Gibt auch den gleichen Wert wie die berechnende Variable MS_PLTSCALE_SHORT zurück. (Beispiel: 4.000000:1.000000) |
ip_short_color_table |
Name der Farbtabelle ohne den Verzeichnisnamen. (Beispiel: COLORS.TBL) |
ip_short_design |
Name der Hauptdatei ohne den Verzeichnisnamen. (Beispiel: FLOOR27.DGN) |
ip_short_design_script |
Name des Designskripts ohne den Verzeichnisnamen. (Beispiel: STANDARD.PEN) |
ip_short_pen_table |
Name des Designskripts ohne den Verzeichnisnamen. (Beispiel: STANDARD.PEN) |
ip_short_feature_table |
Name der Funktionstabelle ohne den Verzeichnisnamen. (Beispiel: DECATUR.FTB) |
ip_short_ref_filename |
Name der Referenzdatei ohne den Ordner für das aktuelle Element. (Beispiel: FLOOR.DGN) |
ip_short_scale |
Gibt den gleichen Wert wie ip_scale zurück. |
ip_units |
Einheiten, die für Werte wie Größe und Ursprung festgelegt wurden. (Beispiel: Zoll) |
ip_view |
Entweder der Ansichtsname oder die Ansichtsnummer. (Beispiel: 2) |
ip_viewgroup |
Die aktuelle Ansichtsgruppe. (Beispiel: Ansichten Blatt 1) |
ip_workspace |
Der Name des aktiven WorkSpace, d. h. Beispiel. |
ip_workset |
Der Name des aktiven WorkSet, d. h. Tiefbau. |
ip_xsize |
X-Größe des Plots in den von ip_units festgelegten Einheiten. (Beispiel: 34.000000) |
ip_xysize |
X- und Y-Größe des Plots in den von ip_units festgelegten Einheiten. (Beispiel: 34.000000, 44.000000) |
ip_ysize |
Y-Größe des Plots in den von ip_units festgelegten Einheiten. (Beispiel: 75.000000) |
long_date |
Datum im Langformat. (Beispiel: Freitag, den 5. April 1996) |
long_time |
Zeitpunkt für die Druckverarbeitung für eine Vorschau oder einen Druck im Langformat. (Beispiel: 11:59:17 PM) |
Minute |
Minute, in der die Druckverarbeitung für eine Vorschau oder einen Druck durchgeführt wurde. (Beispiel: 59) |
month_abbreviation |
Abkürzung des Monats bestehend aus drei Zeichen. (Beispiel: Apr) |
month_name |
Vollständiger Name des Monats. (Beispiel: April) |
month_number |
Nummer des Monats. (Beispiel: 04) |
ms_pen_table |
Name der mit dem Plotauftrag verbundenen Pen-Table. Wenn keine Pen-Table definiert wurde, wird eine leere Zeichenfolge zurückgegeben. (Beispiel: C:\PROJ\E5.TBL) |
ms_pltcfg_file |
Die Dateispezifikation für die Druckertreiber-Konfigurationsdatei. (Beispiel: ..\Default\pltcfg\pdf.pltcfg). |
ms_short_pltcfg_file |
Druckertreiberkonfigurationsdatei ohne das Verzeichnis. (Beispiel: PDF.PLTCFG) |
ms_short_pen_table |
Name der Pen-Table ohne den Verzeichnisnamen. (Beispiel: DECATUR.TBL) |
page_number |
Im Druck-Organizer festgelegte laufende Nummer der Druckdefinition im Druck. (Beispiel: 1) Wenn Sie variable Druckdefinitionen verwenden, lesen Sie bitte die Richtlinien zur Verwendung der Seitennummerierungs- und Ganzseiten-Token mit variablen Druckdefinitionen. Laufende Nummer des Plots im Dokument. |
plan_set_name |
Die Dateispezifikation für den Drucksetnamen. (Beispiel: C:\plans\myplan.pset) |
plan_set_short_name |
Der Drucksetname ohne den Ordnernamen. (Beispiel: myplan.pset) |
plot_name |
Der Druckdefinitionsname im Druckdialog oder Druck-Organizer. (Beispiel: Rand) Der Name des Plotnamens. |
Sekunde |
Sekundenzahl. (Beispiel: 17) |
short_date |
Datum im numerischen Format. (Beispiel: 04/05/96) |
short_time |
Uhrzeit im Kurzformat. (Beispiel: 11:59) |
short_year |
Jahr im zweistelligen Format. (Beispiel: 96) |
sytime |
Systemdatum und -uhrzeit, zu denen die Druckverarbeitung für eine Vorschau oder einen Druck durchgeführt wird. (Beispiel: 5-APR-1996 09:47) |
time |
Zeitpunkt, zu dem die Druckverarbeitung für eine Vorschau oder einen Druck durchgeführt wird. (Beispiel: 09:47) |
total_pages |
Gesamtanzahl der Druckdefinitionen im Drucksatz. (Beispiel: 5) Wenn Sie variable Druckdefinitionen verwenden, lesen Sie bitte die Richtlinien zur Verwendung der Seitennummerierungs- und Ganzseiten-Token mit variablen Druckdefinitionen. Gesamtanzahl von Plots im Dokument. |
username |
Benutzername des Benutzers, der die Vorschau oder den Druck abgesendet hat. (Beispiel: jdoe) |
year |
Jahr, in dem die Druckverarbeitung für eine Vorschau oder einen Druck durchgeführt wird, im vierstelligen Format. (Beispiel: 1996) |
Syntax:
characters = "string"
(wobei die Zeichenfolge eine gültige Zeichenfolge oder ein Schlüsselwort ist, das in der vorhergehenden Tabelle beschrieben wird)
Beispiel 1:
! ! Change "preliminary" to "final" for text on ! level 10. ! if (characters eq "preliminary" and type==text and level==10) then characters = "final" endif
Beispiel 2:
! Replace the text string "PAGE" with ! a new string that contains the actual ! page number and total sheets in the set. if (characters == "PAGE") then characters = PAGE_NUMBER + "of" + TOTAL_PAGES endif
Beispiel 3:
! ! Ersetzen Sie die Zeichenfolge Projektnummer durch die tatsächliche Projektnummer, die gespeichert ist in der PROJECT_NUM-Umgebungsvariablen. ! if (characters == "Project Number") then envr_variable = "PROJECT_NUM" characters = envr_value endif
Beispiel 4:
! Ersetzen Sie den Druckernamen aus der Druckdefinition für die Textzeichenfolge $$queue$$. ! if ((type == text) and (characters == '$$queue$$')) then characters = ip_queue endif
Beispiel 5:
! Ersetzen Sie den Windows-Benutzernamen für ! Textzeichenfolge "$USER$" und fügen Sie eine literale ! Textzeichenfolge in der Ersatzzeichenfolge bei. wenn ((type == text) und (characters == "$USER$")), dann characters = "User:$(USERNAME)" endif
Beispiel 6:
! Ersetzen Sie den Wert des benannten Ausdrucks ! _Author for the text string $AUTHOR$. if ((type == text) and (characters == "$AUTHOR$")) then characters = "<expr?name=_Author>" endif
Klasse
Das Schlüsselwort class ändert die Klasse eines Elements. Das Element wird nicht geplottet, wenn die neue Klasse in der Druckdefinition oder durch das gleichwertige MicroStation-Darstellungsflag deaktiviert wurde.
Syntax:
class = integer
(wobei integer im Bereich zwischen 0 und 6 liegt)
class = constant
wobei constant eines der Folgenden ist:
0 primary |
1 pattern_component |
2 construction |
3 dimension |
4 primary_rule |
5 linear_pattern |
6 construction_rule |
Beispiel:
! ! Ändern Ändern Sie die Konstruktions-Klassenelemente auf Ebene 5 in primäre Klassenelemente. wenn ((class == construction) und (level == 5)), dannclass = primary endif
cls_end_width
Das Schlüsselwort cls_end_width legt in den Vorlagenzeichnungsdateieinheiten die Endbreite der benutzerdefinierten Strichart fest, die dem aktuellen Element zugeordnet wird. Wenn der gleiche Wert für cls_origin_width und cls_end_width festgelegt wurde, verengen oder verbreitern sich die "Dash Strokes" der Strichart einheitlich. Wenn verschiedene Werte für diese zwei Schlüsselwörter festgelegt wurden, werden die Dash Strokes-Striche vom Anfang zum Ende des Elements schmaler.
Die Breite ist eine optionale Eigenschaft jedes Strichs in einer benutzerdefinierten Strichart. Dieses Schlüsselwort hat keine Auswirkung auf Strichartstriche, die Breite nicht als Eigenschaft haben.
Syntax:
cls_end_width = real number
Beispiel:
! ! Ändern Sie die Breite der breiten Striche in der "{ Wide Dash }" Strichart in 2 Zeichnungseinheiten. ! if (cls_name == '{ Wide Dash }') then cls_origin_width = 2.0 cls_end_width = 2.0 endif
cls_name
Das Schlüsselwort cls_name weist dem aktuellen Element eine benutzerdefinierte Strichart zu. Die Ressourcendatei der Strichart, die auf dem Plotserver verwendet wird, muss die Strichart enthalten.
Syntax:
cls_name = string
Beispiel:
! ! Weisen Sie die "{ Diamond }" benutzerdefinierte Strichart ! allen Elementen mithilfe des Strichcodes 3 zu. ! wenn (style == 3), dann cls_name = '{ Diamond }' endif
cls_origin_width
Das Schlüsselwort cls_origin_width legt die Anfangsbreite der benutzerdefinierten Strichart, die mit dem aktuellen Element verbunden ist, in den Standardeinheiten der Zeichnungsdatei fest. Wenn der gleiche Wert für cls_origin_width und cls_end_width festgelegt wurde, verengen oder verbreitern sich die "Dash Strokes" der Strichart einheitlich. Wenn verschiedene Werte für diese zwei Schlüsselwörter festgelegt wurden, werden die Dash Strokes-Striche vom Anfang zum Ende des Elements schmaler.
Die Breite ist eine optionale Eigenschaft jedes Strichs in einer benutzerdefinierten Strichart. Dieses Schlüsselwort hat keine Auswirkung auf Strichartstriche, die Breite nicht als Eigenschaft haben.
Syntax:
cls_origin_width = real number
Beispiel:
! ! Ändern Sie die Breite der breiten Striche in der "{ Wide Dash }" Strichart in 2 Zeichnungseinheiten. ! !!wenn (cls_name == '{ Wide Dash }') dann cls_origin_width = 2,0 cls_end_width = 2,0 endif
cls_scale
Das Schlüsselwort cls_scale skaliert die benutzerdefinierte Strichart, die mit dem aktuellen Element verbunden ist.
Syntax:
cls_scale = real number
Beispiel:
! ! Skalieren Sie alle Stricharten um 1/2. wenn (cls_name .ne. 'none'), dann cls_scale = 0,5 endif
cls_shift_distance
Das Schlüsselwort cls_shift_distance verschiebt die benutzerdefinierte Strichart, die mit dem aktuellen Element verbunden ist. Der Verschiebungsabstand ist in den Standardeinheiten der Zeichnungsdatei festgelegt.
Syntax:
cls_shift_distance = real number
Beispiel:
! ! Verschieben Sie den Ursprung der Strichart um 1 Standard-Zeichnungseinheit. ! if (cls_name == '{Batten}') then cls_shift_distance = 1.0 endif
cls_shift_fraction
Das Schlüsselwort cls_shift_fraction verschiebt die benutzerdefinierte Strichart, die mit dem aktuellen Element verbunden ist.
Syntax:
cls_shift_fraction = real number
Beispiel:
! ! Verschieben Sie die benutzerdefinierte Strichart um 1/2 der Bemusterungslänge. ! if (cls_name .ne. 'none') then cls_shift_fraction = 0.5 endif
Farbe
Das Schlüsselwort color ändert die Color des aktuellen Elements für nicht ausgefüllte Elemente. Wird color ein Wert zugeordnet, ändern sich auch die Begrenzungsfarbe, die Füllfarbe und die Color des Bemusterungs-Vordergrundes für geschlossene Polygone, wenn diese Werte nicht speziell mit den Schlüsselwörtern boundary_color, fill_color und pattern_color festgelegt wurden. Für eine detaillierte Beschreibung zum Festlegen der Color siehe Colorn in Zuweisungsanweisungen festlegen am Ende dieses Abschnitts.
Bemerkung: Wenn eine benannte Color oder eine RGB-Color verwendet wird, wird die Color, die für das Farbvergleichs-Schlüsselwort verwendet wird, nicht geändert.
Syntax:
color = integer
(wobei integer ein Farbindex im Bereich zwischen 0 und 255 ist)
color = "string"
(wobei string ein Colornname aus einer Farbbibliothek ist)
color= (R,G,B)
(wobei RGB im Bereich zwischen 0 und 255 liegt)
Beispiel:
! ! Ändern Sie die Color von Linien, Linienzügen und Kurven mithilfe der verschiedenen Methoden zur Farbdefinierung. ! if (type eq line) then color = 1 ! Setzen Sie color auf den Indexwert 1. sonst wenn (type == line_string), dann color = 'blue' ! Setzen Sie color auf 'blue.' sonst wenn (type == curve), danncolor = (0,0,255) ! Setzen Sie color auf den RGB-Wert 0,0,255. endif
endcap
Das Schlüsselwort endcap steuert die Darstellung der Endpunkte nicht geschlossener Elemente. Endcap hat die folgenden Darstellungsoptionen:
- extend—ebenfalls rechteckig, aber erweitert um die Hälfte der Linienbreite hinter dem Ende der Linie oder Kurve.
Syntax:
endcap = endcap_type
(wobei endcap_type butt, extend oder circle ist)
Beispiel:
! ! Legen Sie den endcap-Typ je nach Element fest. ! wenn (type == line), dann endcap = butt sonst wenn (type == line_string), dann endcap = extend sonst wenn (type == arc), dann endcap = circle endif
envr_value
Das Zuweisungsschlüsselwort envr_value ordnet die aktuelle envr_variable der festgelegten Zeichenfolge zu. Dieses Paar envr_variable = value wird dann in die Abrechnungsdatei geschrieben und kann auch als Attributdaten in einem digitalen Archiv verwendet werden.
Syntax:
envr_value=string
Beispiel 1:
! Dieses Designskript legt ein Plotblattattribut je nach den in den Textelementen in der Zeichnungsdatei gespeicherten Zeichen fest. Die Kriterien, mit denen festgelegt wird, welcher Text die passenden Zeichen enthält, basieren auf MicroSations-Sachdaten. tag_set='dpr' tag_name='sheet' wenn ((type eq text) und (tag_character eq 'drawingno‘)), dann envr_variable = 'Drawingno'envr_value = characters sonst wenn ((type eq text) und (tag_character eq 'title‘)), dann envr_variable = "Title" envr_value = characters oder wenn ((type eq text) und (tag_character eq ‚sheetno‘)), dann envr_variable = "Sheetno" envr_value = characters endif
Beispiel 2:
! Dieses Designskript legt ein Plotblattattribut je nach den in den Textelementen in der Zeichnungsdatei gespeicherten Zeichen fest. Die Kriterien, mit denen festgelegt wird, !welcher Text die passenden Zeichen enthält, !basieren auf dem level. wenn ((type eq text) und (level eq 2)), dann envr_variable = "Account" envr_value = characters sonst wenn ((type eq text) und (level eq 4)), dann envr_variable = "Project" envr_value = characters sonst wenn ((type eq text) und (level eq 6)), dann envr_variable = "Revision" envr_value = characters endif
envr_value_num
Sie können den Wert von envr_variable mithilfe des Schlüsselworts envr_value_num auf eine reelle Zahl setzen. Envr_value und envr_value_num sind innerhalb desselben Designskripts austauschbar. Wenn Sie envr_value beispielsweise den Zeichenfolgenwert "4" zuweisen, wird envr_value_num automatisch auf die reelle Zahl 4 gesetzt. Damit können Sie eine Zeichenfolge aus einer Zeichnungsdatei (zum Beispiel eine Seitenzahl) extrahieren, sie in eine reelle Zahl konvertieren, um den Wert um 1 zu erhöhen, und sie dann wieder als Zeichenfolge anzeigen. Das folgende Beispiel-Designskript veranschaulicht diesen Vorgang.
Das Paar envr_variable = value wird auch in die Abrechnungsdatei geschrieben und kann ebenfalls als Attributdatensatz in einem digitalen Archiv verwendet werden.
Syntax:
envr_value_num = real
(wobei real eine beliebige reelle Zahl ist)
Beispiel:
! Das folgende Designskript erhöht die Seitenzahl im Titelblock um 1. Die Seitenzahl ist eine Textzeichenfolge auf Ebene 5. envr_variable = "pagenum" wenn ((type eq text) und (level eq 5)), dann envr_value = characters envr_value_num = envr_value_num + 1 characters = envr_value endif
envr_variable
Das Zuweisungsschlüsselwort envr_variable wählt die Umgebungsvariable der Druckdefinition aus, die Sie im Designskript verwenden möchten. Die Vergleichsschlüsselwörter envr_value und envr_value_num können verwendet werden, um den Wert der Variable zu überprüfen.
Bemerkung: Die Namen von Umgebungsvariablen müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Zahlen und Unterstriche, jedoch keine Leerzeichen enthalten.
Syntax:
envr_variable = string
Beispiel:
! Wenn SKIP_TEXT definiert ist (als etwas Beliebiges, z. B. "iplot mod MY_IPARM -environment = [SKIP_TEXT=1]) in der IPARM-Umgebung, ignorieren Sie Text- und text_node-Elemente. ! envr_variable = "SKIP_TEXT" wenn (envr_value <> ""), dann wenn (type .IN. text, text_node), dann ignore = true endif endif
fill_color
Das Schlüsselwort fill_color legt die Füllfarbe für bereichsgefüllte Polygone fest. Es legt außerdem die Hintergrundfarbe für gemusterte Elemente fest. Bei Verwendung dieses Schlüsselwortes wird area_fill automatisch aktiviert. Die Standardfüllfarbe für ein Element ist seine Elementfarbe. Der Hintergrund des Musters ist standardmäßig transparent. Für eine detaillierte Beschreibung zum Festlegen der Color siehe Colorn in Zuweisungsanweisungen festlegen am Ende dieses Abschnitts.
Syntax:
fill_color = integer
(wobei integer ein Farbindex im Bereich zwischen 0 und 255 ist)
fill_color = "string"
(wobei string ein Colornname aus einer Farbbibliothek ist)
fill_color = (R,G,B)
(wobei RGB im Bereich zwischen 0 und 255 liegt)
Beispiel:
! ! Definieren Sie die Füllfarbe für Flächen, komplexe Polygonflächen und Ellipsen. ! wenn (type == shape), dann fill_color = 5 sonst wenn (type == complex_shape), dann fill_color = 'blue' sonst wenn (type == ellipse), dann fill_color = (0,0,255) endif
Schriftart
Das Schlüsselwort font legt die Schriftartzahl für Textelemente fest.
Syntax:
font = integer
(wobei integer im Bereich zwischen 0 und 255 liegt)
Beispiel:
! ! Ändern Sie die Schriftart für bestimmte Textzeichenfolgen. ! wenn ((type == text) und (font == 1)), dann font = 2 sonst wenn ((type == text) und (font == 3)), dann font = 7 endif
font_name
Das Schlüsselwort font_name legt den Schriftartnamen für Textelemente fest.
Syntax:
font_name = string
(wobei string der Name der Schriftart in der Symbolikressourcendatei ist)
Beispiel:
! ! Ändern Sie den Namen der Schriftart für bestimmte Textzeichenfolgen. ! wenn ((type == text) und (font == 1)), dann font_name = "Architectural" sonst wenn ((type == text) und (font == 3)), dann font_name = "FONT060" endif
ignore_element
Das Schlüsselwort ignore_element bestimmt, ob das Element geplottet wird. Wenn dieses Schlüsselwort auf true gesetzt wird, wird das aktuelle Element nicht geplottet.
Syntax:
ignore_element = true ignore_element = false
Beispiel:
! ! Plotten Sie keine Textelemente auf Ebene 63. ! wenn ((type == text) und (level == 63)), dann ignore_element = true endif
midline_joint
Das Schlüsselwort midline_joint steuert die Darstellung von Verbindungen für ungefüllte und gefüllte Elemente. Wenn boundary_display für ein gefülltes Element deaktiviert wird, hat das Festlegen des midline_joint Schlüsselworts keine Auswirkung. Die folgende Liste beschreibt die Optionen für dieses Schlüsselwort:
miter |
die entsprechenden Kanten zweier Segmente reichen bis zu ihrem Schnittpunkt (Standard). |
bevel |
Ähnlich wie miter, jedoch schließen die Segmente mit einem stumpfen Ende ab. |
butt |
Das Ende eines jeden Segments wird mit einer rechteckigen Verbindung angezeigt. |
extend |
Ähnlich wie butt, jedoch wird jedes Segment um die Hälfte seiner Breite verlängert. |
Kreis |
Zeigt einen Halbkreis am Ende jedes Segments an. |
Syntax:
midline_joint = midline_joint_type
(wobei midline_joint_type butt, bevel, extend, circle oder miter ist)
Beispiel:
! ! Legen Sie das midline_joint je nach Nummer des ! Referenzdateianhangs fest. ! if (file == 0) then ! Test für Elemente in der Hauptdatei. midline_joint = butt sonst wenn (file == 1) dann ! Test für Elemente in der ersten Referenzdatei. midline_joint = extend else if(file == 2)then ! Test für Elemente in der zweiten Referenzdatei. midline_joint = circle else if(file == 3)then ! Test für Elemente in der dritten Referenzdatei. midline_joint = miter endif
pen
Das Schlüsselwort pen wählt den Stift auf einem Zeichenstift-Plotter aus. Die Festlegung dieses Schlüsselworts ist das Gleiche wie die Festlegung der Color des aktuellen Elements, außer dass die Stiftnummer der Farbnummer plus 1 entspricht.
Syntax:
pen = integer
(wobei integer im Bereich zwischen 1 und 256 liegt)
Beispiel:
! ! Festgelegte Stiftnummer je nach Ebene des Elements. wenn (level == 1 ), dann pen = 1 sonst wenn (level == 2 ), dann pen = 2 sonst wenn (level == 3 ), dann pen = 3 endif
pen_width_nn
(Wobei n ein Wert von 0 bis 31 ist)
Die Schlüsselwörter pen_width_nn weisen Drucklinienbreiten (physische Stärke) in Zeichnungsskript-Einheiten den 32 Standard-Strichstärken des Produkts zu. Diese Zeichnungsskript-Zuweisungsschlüsselwörter sind vorrangig vor Stärke-zu-Breite-Zuordnungen, wie sie in der Druckertreiberkonfigurationsdatei (.pltcfg) festgelegt sind und entsprechen den Zuordnungen, wie sie einer Pen-Table festgelegt würden. Diese Schlüsselwörter funktionieren in gleicher Weise wie die weight_base-/weight_delta-Schlüsselwörter, doch die Schlüsselwörter pen_width_nn ermöglichen die je unabhängige Zuweisung von einzelnen Strichstärken.
! ! Legen Sie die Stärke-zu-Breite-Zuordnungen nach Papierformat fest. ! units = mm if (first_time), und wenn (ip_xsize_num > 17), dann pen_width_00 = 0.169 pen_width_01 = 0.375 pen_width_02 = 0.5 pen_width_03 = 0.625 pen_width_04 = 0.75 pen_width_05 = 0.875 pen_width_06 = 1 pen_width_07 = 1.125 pen_width_08 = 1.25 pen_width_09 = 1.375 pen_width_10 = 1.5 pen_width_11 = 1.625 pen_width_12 = 1.75 pen_width_13 = 1.875 pen_width_14 = 2 pen_width_15 = 2.125 pen_width_16 = 2.25 pen_width_17 = 2.375 pen_width_18 = 2.5 pen_width_19 = 2.625 pen_width_20 = 2.75 pen_width_21 = 2.875 pen_width_22 = 3 pen_width_23 = 3.125 pen_width_24 = 3.25 pen_width_25 = 3.375 pen_width_26 = 3.5 pen_width_27 = 3.625 pen_width_28 = 3.75 pen_width_29 = 3.875 pen_width_30 = 4 pen_width_31 = 4.125, sonst pen_width_00 = 0.12675 pen_width_01 = 0.28125 pen_width_02 = 0.375 pen_width_03 = 0.46875 pen_width_04 = 0.5625 pen_width_05 = 0.65625 pen_width_06 = 0.75 pen_width_07 = 0.84375 pen_width_08 = 0.9375 pen_width_09 = 1.03125 pen_width_10 = 1.125 pen_width_11 = 1.21875 pen_width_12 = 1.3125 pen_width_13 = 1.40625 pen_width_14 = 1.5 pen_width_15 = 1.59375 pen_width_16 = 1.6875 pen_width_17 = 1.78125 pen_width_18 = 1.875 pen_width_19 = 1.96875 pen_width_20 = 2.0625 pen_width_21 = 2.15625 pen_width_22 = 2.25 pen_width_23 = 2.34375 pen_width_24 = 2.4375 pen_width_25 = 2.53125 pen_width_26 = 2.625 pen_width_27 = 2.71875 pen_width_28 = 2.8125 pen_width_29 = 2.90625 pen_width_30 = 3 pen_width_31 = 3.09375 endif endif
Priorität
Das Schlüsselwort priority ändert die Reihenfolge, in der Elemente geplottet werden. Standardmäßig werden Elemente in der Reihenfolge geplottet, in der sie in der Zeichnungsdatei erscheinen. Mithilfe des Schlüsselworts priority werden Elemente mit niedriger Priorität vor Elementen mit höherer Priorität geplottet, so das Elemente mit höherer Priorität im Vordergrund geplottet werden. Dies kann beim Plotten bereichsgefüllter Elemente hilfreich sein. Wenn beispielsweise eine Textzeichenfolge in einem gefüllten Polygon plotten soll, muss der Text eine höhere Priorität haben als das Polygon, damit der Text nicht abgedeckt wird. Die Standardpriorität eines Elements ist 0.
Bitte beachten Sie, dass zuerst Elemente ohne Priorität und anschließend Elemente mit Priorität entsprechend ihrer Priorität gedruckt werden. Deshalb müssen Plotkonventionen mit "negativer Priorität" möglicherweise geändert werden.
Bemerkung: Das Schlüsselwort priority ist für gefüllte Elemente ungültig, die zu einem Vektorgerät plotten. Das Schlüsselwort priority hebt die Reihenfolge auf, die durch Darstellungsaktualisierungssequenzen impliziert wird.
Syntax:
priority = integer
(wobei integer im Bereich zwischen -1.000.000 und 1.000.000 liegt)
Beispiel:
! ! Legen Sie die Priorität von Elementen je nach deren Farbe fest. wenn (type == shape), dann area_fill = true wenn (color == 1), dann priority = 10 sonst wenn (type == text), dann Plotten Sie Text auf den Flächen. priority = 20 endif endif
Skalieren
Das Schlüsselwort scale legt einen Skalierungsfaktor fest, der auf Elemente mit lokalem Ursprung angewandt wird, z. B. Zellen (normale und gemeinsam genutzte), Bogen, Ellipsen, Text und Textknoten. Text und Textknoten werden über ihrem Ausrichtungspunkt skaliert. Die Standardskalierung ist 1,0.
Syntax:
scale = real
(wobei real eine beliebige positive reale Zahl ist)
Beispiel:
! ! Skalieren Sie Text um einen Faktor von 1,5. ! wenn (type == text), dann scale = 1,5 endif
screen_relative
Das Schlüsselwort screen_relative wird verwendet, um das Bit screen_relative im Eigenschaftswort des aktuellen Elements zu ändern. MicroStation bezeichnet bildschirmbezogen als "ansichtsunabhängig."
Syntax:
screen_relative = true screen_relative = false
Beispiel:
! ! Wenn ein Element eine Zelle mit dem Namen 'LOGO' ist, legen Sie das bildschirmbezogene Bit im Eigenschaftswort fest. ! wenn ((type == cell) und (cellname == 'LOGO')), dann screen_relative = true endif
screening
Mit Screening können Sie festlegen, dass eine Farbe auf dem Ausdruck Weiß "ausgewaschen" wird. Ein Screening von 100 % bewirkt, dass die Color so ausgedruckt wird, wie sie ist. Ein Screening von beispielsweise 50 % verändert die Color halb zu Weiß. Dieses Schlüsselwort kann verwendet werden, um Tinte zu sparen oder Elemente einer bestimmten Color in den Hintergrund treten zu lassen.
Syntax:
screening = integer
(wobei integer im Bereich zwischen 1 und 99 liegt)
Beispiel:
! ! Wenn das Element eine Ellipse ist, legen Sie das Screening auf 50 % fest. wenn (type == ellipse), dann screening = 50 endif
size
Das Schlüsselwort size wird verwendet, um die Größe von Text- und Textknotenelementen zu ändern.
Syntax:
size = working units
Beispiel:
! ! Legen Sie die Größe der Textelemente auf Ebene 1 fest. ! wenn ((type == text) und (level == 1)), dannsize = 0:0:250endif
Strichart
Das Schlüsselwort style ändert die Strichart des aktuellen Elements. Legen Sie eine neue Strichart fest, indem Sie dem Element einen Index im Bereich zwischen 0 und 7 zuweisen, der einem der vordefinierten MicroStation-Stiltypen entspricht. Eine benutzerdefinierte Strichart kann verwendet werden, indem man den Namen einer Strichart aus einer Strichartbibliothek oder eine Reihe von On- und Off-Übergängen festlegt. Das Festlegen des Stils hat keine Auswirkung auf die bereichs- oder mustergefüllten Elemente, wenn die Begrenzungsdarstellung nicht aktiviert ist. Standardmäßig ist die Begrenzungsdarstellung deaktiviert.
Bemerkung: Wenn Sie einen benannten Stil oder eine Stildefinition verwenden, ändert sich die Strichart, die mit dem Stilvergleichsschlüsselwort verwendet wird, nicht.
Syntax:
style = integer
(wobei integer ein Strichartindex im Bereich zwischen 0 und 7 ist)
style = "string"
(wobei string ein Strichartname in einer Strichartbibliothek mit dem Namen "DesignScriptStyles.slb" ist, der im von MS_DATA definierten Ordner geliefert wird)
style = line style definition
(on, off, on, off ...)
Beispiel:
! ! Legen Sie den Stil des Elements je nach dessen Color mithilfe der ! verschiedenen Methoden zum Definieren einer Strichart fest. ! units = mm switch (color) case 1 ? style = 3 case 2 ? style = ‚dash-dot' case 3 ? style = (0.5, 0.3, 0.75, 0.3) endswitch
style_n
(Wobei n ein Wert von 1 bis 7 ist.)
Die Schlüsselwörter style_n ändern die Stift-Oben- und Stift-Unten-Musterdefinitionen für die sieben Standard-Linienstile. Diese Zeichnungsskript-Zuweisungsschlüsselwörter sind vorrangig vor Stärke-zu-Breite-Zuordnungen, wie sie in der Druckertreiberkonfigurationsdatei (.pltcfg) festgelegt sind. Das Muster kann festgelegt werden über den Namen einer Strichart aus einer Strichartbibliothek oder durch die Festlegung einer Reihe von On- und Off-Übergängen. Diese Syntax entspricht dem Schlüsselwort für die Stil-Zuordnung.
Syntax:
style_<number> = "string"
(wobei string ein Strichartname in einer Strichartbibliothek mit dem Namen DesignScriptStyles.slb ist, der im von MS_DATA definierten Ordner geliefert wird)
style_<number> = line style definition
(wobei number ein Wert von 1 bis 7 ist und die Strichartdefinition ein Muster ein, aus, ein, aus usw. mit Zeichnungsskripteinheiten ist)
Für einfache Elemente wie Linien und Formen ergeben doe Schlüsselwörter style und style_n die gleichen Ergebnisse. Das Schlüsselwort style kann verwendet werden, um ein anderes Muster je Element zuzuweisen. Wenn es jedoch auf ein zusammengesetztes Element mit mehreren Stricharten wie ein Dimension- oder Mehrfachlinien-Element angewendet wird, veränder die Zuweisung style den Stil jeder Strichart im Element. Die style_n-Zuweisungen können verwendet werden, um das Muster der sieben Standard-Stricharten anzugeben, ohne die Stilnummern innerhalb von zusammengesetzten Elementen zu stören.
Beispiel:
! ! Geben Sie das Muster für die sieben Standardstricharten basierend auf dem Papierformat an. ! units = inches if (first_time), und wenn (ip_xsize_num > 17), dann style_1 = (0.03, 0.03) style_2 = (0.062, 0.062) style_3 = (0.125, 0.062) style_4 = (0.125, 0.062, 0.03, 0.062) style_5 = (0.045, 0.045) style_6 = (0.125, 0.062, 0.03, 0.062, 0.03, 0.062) style_7 = (0.0125, 0.045, 0.062, 0.045), sonst style_1 = (0.0225, 0.0225) style_2 = (0.0465, 0.0465) style_3 = (0.09375, 0.0465) style_4 = (0.09375, 0.0465, 0.0225, 0.0465) style_5 = (0.03375, 0.03375) style_6 = (0.09375, 0.0465, 0.0225, 0.03375, 0.0225, 0.03375) style_7 = (0.009375, 0.03375, 0.0465, 0.03375) endif endif
tags
Die Zuweisungsschlüsselwörter TAG_SET und TAG_NAME werden verwendet, um Sachdatensätze und -namen zur späteren Verwendung durch eines der Vergleichsschlüsselwörter festzulegen.
Datentypen:
Beispiel:
! ! Angenommen, die Zeichnungsdatei verwendet zwei Sachdatensätze, ! "Home address" und "Work address", wobei jeder! Datensatz einen Zeichensachdatensatz mit dem Namen "City" enthält – ! ändern Sie die Color aller Elemente, deren Sachdaten! die Privatanschrift "Huntsville" oder die ! Arbeitsanschrift "Madison" festlegen. ! ! Beginnen Sie, indem Sie nach "City"-Sachdaten suchen, die ! zum Sachdatensatz "Home address" gehören. ! tag_set = 'Home address' tag_name = 'City' if (tag_char == 'Huntsville') then color = 4 endif ! Suchen Sie jetzt nach Sachdaten im Sachdatensatz ! "Work address". Beachten Sie, dass der Name des Sachdatenwerts weiterhin "City" lautet. tag_set = 'Work address‘,wenn (tag_char == 'Madison'), dann color = 4 endif
Stärke
Mit dem Schlüsselwort thickness können Sie in physischen Einheiten die Linienbreite anstelle der Strichstärke angeben. Der Einheitenwert, der in der Druckdefinition gespeichert ist, ist der Standard für das Schlüsselwort thickness. Er kann jedoch innerhalb des Designskripts mithilfe des Schlüsselworts units geändert werden. Das Angeben einer Stärke ändert nicht die Strichstärke, die durch das Vergleichsschlüsselwort weight verwendet wird.
Syntax:
thickness = positive real number
Beispiel:
! ! Legen Sie die Strichstärke je nach Farbe des Elements fest. ! units = inches switch (color) case 1 - 5 ? thickness = 0,125 case 6 - 10 ? thickness = 0,075 default ? thickness = 0,05 endswitch
translucent
Wenn das Schlüsselwort translucent auf true gesetzt wird, wird das aktuelle Element so geplottet, dass darunter liegende Elemente nicht vollständig verdeckt werden. Der Standardwert für dieses Schlüsselwort ist false. Das Schlüsselwort translucent wirkt sich nur auf nicht-gefüllte Elemente und Begrenzungen von gefüllten Elementen aus, wenn die Begrenzungen aktiviert sind. Das Schlüsselwort translucent ist für Vektorgeräte oder Geräte, die von Microsoft-Druckertreiberdateien angetrieben werden, nicht gültig.
Bemerkung: Das Schlüsselwort translucent arbeitet ebenso wie das Schlüsselwort new transparency mit einem Wert von 50. Das Schlüsselwort translucent wirkt sich sowohl auf gefüllte als auch auf nicht-gefüllte Elemente und Begrenzungen von gefüllten Elementen aus, wenn die Begrenzungen aktiviert sind. Weitere Informationen finden Sie unter dem Schlüsselwort Transparenz.
Syntax:
translucent = true translucent = false
Beispiel:
! ! Plotten Sie Elemente auf Ebene 10 mit starken roten Linien und lassen Sie darunterliegende Elemente durchscheinen. ! wenn (level == 10), dann color = "red" weight = 10 translucent = true endif
translucent_fill
Wenn das Schlüsselwort translucent_fill auf true gesetzt wird, bewirkt dies, dass die Füllfarbe für bereichs- und mustergefüllte Elemente lichtdurchlässig ist. Sowohl die Vordergrund- als auch die Hintergrundfarben für pattern_filled-Elemente sind lichtdurchlässig. Elemente unter einem translucent_filled-Element sind noch sichtbar. Der Standardwert für dieses Schlüsselwort ist false. Das Schlüsselwort translucent_fill ist für Vektorgeräte oder Geräte, die von Microsoft-Druckertreiberdateien angetrieben werden, ungültig.
Bemerkung: Das Schlüsselwort translucent_fill arbeitet ebenso wie das Schlüsselwort new transparency mit einem Wert von 50. Das Schlüsselwort translucent_fill wirkt sich auf nicht-gefüllte sowie auf bereichs- und mustergefüllte Elemente und auf Begrenzungen von gefüllten Elementen aus, wenn die Begrenzungen aktiviert sind. Weitere Informationen finden Sie unter dem Schlüsselwort Transparenz.
Syntax:
translucent_fill = true translucent_fill = false
Beispiel:
! ! Setzen Sie die Füllfarbe auf translucent. ! area_fill = true translucent_fill = true fill_color = (255,0,0)
Transparenz
Mit dem Zuweisungsschlüsselwort transparency können Sie die Transparenz des aktuellen Elements festlegen. Sie können den Wert für transparency auf 1 bis 100 setzen. Je höher der Wert, desto transparenter das Element.
Syntax:
transparency = value
(wobei der Wert 1-100 ist)
Beispiel:
! ! Legen Sie die Transparenz für Linien auf Ebene 2 fest. wenn ((level eq 2) und (type eq line)), dann transparency = 50 endif
Einheiten
Das Schlüsselwort units wird verwendet, um die Einheiten für Schlüsselwörter wie thickness und line styles festzulegen. Legen Sie das Schlüsselwort units immer zu Beginn des Designskripts und nur einmal innerhalb eines Designskripts fest. Der Standardwert für das Schlüsselwort ist der Einheitenwert der Druckdefinition.
Syntax:
units = units_constant
(wobei units_constant eines der Folgenden ist:
Beispiel:
! ! Setzen Sie die Strichstärke auf 0,5 Millimeter. ! units = mm thickness = 0,5
Strichstärke
Mit dem Schlüsselwort weight kann die Strichstärke des aktuellen Elements geändert werden. Bei gefüllten Elementen muss boundary_display aktiviert werden, damit sich dieses Schlüsselwort auf die Elementbegrenzung auswirkt.
Syntax:
weight = integer
(wobei integer im Bereich zwischen 0 und 31 liegt)
Beispiel:
! ! Legen Sie die Strichstärke je nach Farbe des Elements fest. ! switch (color) case 1-10 ? weight = 2 case 11-20 ? weight = 1 default ? weight = 0 endswitch
weight_base/weight_delta
Die Schlüsselwörter weight_base und weight_delta ordnen Strichstärken den physischen Stärken auf dem Plot zu. Mit diesen Schlüsselwörtern können Sie die Strichstärken über verschiedene Plotter hinweg vereinheitlichen. Das Schlüsselwort weight_base legt die Strichstärke für ein Element auf Strichstärke 0 fest. Das Schlüsselwort weight_delta legt für jede Strichstärke über 0 ein zusätzliches Strichstärkeninkrement fest. Verwenden Sie die folgende Formel, um die Strichstärke mithilfe der Schlüsselwörter weight_base und weight_delta zu berechnen:
plot thickness = weight_base + (element weight * weight_delta)
Wenn weight_base beispielsweise bei 0,1 cm und weight_delta bei 0,05 cm liegt, werden die folgenden Werte verwendet.
Bemerkung: Sie müssen die Schlüsselwörter weight_base und weight_delta zu Beginn des Designskripts definieren.
Syntax:
weight_base = positive_real weight_delta = positive_real
Beispiel:
! ! Ordnen Sie die Strichstärke des Elements einer Stärke am Plot zu. ! weight 0 = 0.10 mm ! weight 1 = 0.15 mm ! weight 2 = 0.20 mm ! weight 3 = 0.25 mm ! . ! . ! . ! weight 31 = 1,65 mm units = mm weight_base = 0,1 weight_delta = 0,05