Ayuda de MicroStation CONNECT Edition

Palabras clave de asignación

Las siguientes descripciones de palabras clave incluyen una breve descripción de la función de palabra clave, los tipos de elementos que afecta la palabra clave (si corresponde), los tipos de datos válidos (si corresponde) y un ejemplo de cómo utilizar la palabra clave. La sección posterior a las palabras claves de asignación describe cómo especificar el color en una sentencia de asignación.

area_fill

Para los trazadores que admiten relleno de un polígono, la palabra clave area_fill (relleno de área) traza elementos cerrados como rellenos cuando está definido como verdadero. Definir las palabras claves de asignación fill_color o pattern implica definir area_fill como verdadero. La palabra clave area_fill puede utilizarse para trazar elementos que, de otra forma, se trazarían como contornos. Los elementos cerrados (excepto el texto) se pueden controlar con esta palabra clave, incluso curvas cerradas b-spline, formas complejas, elipses y formas.

Sintaxis:

area_fill = true 
area_fill = false

Ejemplo:

!
! El área rellena todas las formas.
!
if (type == shape) then
  area_fill = true
endif

boundary_color

La palabra clave boundary_color (color de límite) se utiliza para especificar el color del límite de un área o de un polígono relleno con patrón. Boundary_color afecta únicamente a los elementos rellenos con boundary_display definido como verdadero. Para obtener una descripción detallada al especificar el color, consulte "Especificar el color en las Sentencias de asignación" al final de esta sección.

Sintaxis:

boundary_color = integer

(donde integer es un índice de color del rango de 0 a 255)

boundary_color = "string"

(donde string es el nombre de una biblioteca de color)

boundary_color = (R,G,B)

(donde RGB se encuentra en el rango de 0 a 255)

Ejemplo:

!
! !  ! Definir boundary_color y boundary_display para 
 ! formas en el nivel 7. 
 ! 
 if ((type == shape) and (level == 7)) then        
 area_fill = true        
 color = 'blue'        
 boundary_display = true        
	 boundary_color = 'red' 
 endif

boundary_display

Para los elementos que se rellenan en el archivo de diseño o con la palabra clave area_fill en el guion de diseño, la palabra clave boundary_display especifica si el límite de un polígono relleno está trazado. La palabra clave boundary_display no tiene efecto sobre los elementos que no se rellenan.

Nota: Definir boundary_display como verdadero para texto relleno puede provocar resultados no deseados.

Sintaxis:

boundary_display = true
boundary_display = false

Ejemplo:

!
! !  ! Definir boundary_color y boundary_display para 
 ! formas en el nivel 7. 
 ! 
 if ((type == shape) and (level == 7)) then        
	 area_fill = true        
	 color = 'blue'        
	 boundary_display = true        
	 boundary_color = 'red' 
 endif

case_sensitive

La palabra clave case_sensitive determina si la distinción entre mayúsculas y minúsculas es importante en las comparaciones de cadenas realizadas que utilizan la palabra clave de comparación characters. El valor por defecto es falso.

Sintaxis:

case_sensitive = true
case_sensitive = false

Ejemplo:

!
!Reemplaza los elementos de texto con 
! caracteres "TITLE" en mayúsculas, y
!reemplaza "Title" con título con mayúscula inicial.
!
case_sensitive = true
if (characters == "TITLE") then
	 characters = "FIRST FLOOR DESIGN"
else if (characters == "Title") then
	 characters = "First Floor Design"
endif

characters

La palabra clave characters (caracteres) le permite sustituir una cadena en un elemento de texto con una nueva cadena. Al introducir elementos de texto en el archivo de diseño para actuar como marcadores de posición, luego puede sustituir estas cadenas con información útil, como la fecha en que el archivo se trazó o el nombre de archivo de diseño. Si la nueva cadena es más corta que la cadena original, se rellena con espacios en blanco. Si la nueva cadena es más larga, la cadena original se expande para acomodar más caracteres.

El texto de sustitución puede responder al valor de diversos conceptos:

  • Una cadena de texto literal
  • Las palabras clave de definición de impresión que se muestran en la siguiente tabla
  • El valor de una o más variables de entorno junto con texto literal
  • El token <expr?name=...> hace referencia a una expresión nombrada
  • La palabra clave envr_value

Las siguientes palabras clave representan los valores de definición de impresión que puede utilizar para etiquetar un trazado.

Palabra clave

Valor

am_pm

Hora: am o pm. (Ejemplo: AM)

date

Fecha en el proceso de impresión para una presentación preliminar o una impresión. (Ejemplo: 05-APR-1996)

day_abbreviation

Abreviatura de tres caracteres del día. (Ejemplo: Vie)

day_name

Nombre completo del día. (Ejemplo: Viernes)

day_number

Día en formato numérico. Ejemplo 5

dgnspec

Especificación del archivo de diseño principal. (Ejemplo: C:\MYPROJ\E1.DGN)

hour

Hora en que se produce el proceso de impresión para una presentación preliminar o una impresión. Ejemplo 11

hour_12

Número de hora basado en un ciclo de 12 horas. Ejemplo 5

hour_24

Número de hora basado en un ciclo de 24 horas. Ejemplo 17

ip_color_table

La cadena de la tabla de colores guardada en el archivo de diseño. (Ejemplo: C:\MISC\COLOR.CTB)

ip_design

Nombre de archivo de diseño. (Ejemplo: C:\MYPROJ\PLAN.DGN)

ip_design_script

El nombre del guion de diseño asociado al trabajo de trazado. Devuelve un valor vacío si el archivo es una tabla de características.

ip_feature_table

El nombre de la tabla de características asociado al trabajo de trazado. Devuelve un valor vacío si el archivo es un guion de diseño.

ip_logical_name

El nombre lógico de referencia para el elemento actual. (Ejemplo: C:\PROJ\BORDER.DGN)

ip_mirror

Ajustes de simetría almacenados en la definición de impresión. Los valores válidos son: X, Y, BOTH o NONE.

ip_model

El modelo especificado en la definición de impresión. (Ejemplo: sheetone)

ip_origin

Origen X e Y en unidades especificadas por la palabra clave ip_units. (Ejemplo: 1.500000,2.000000)

ip_origin_x

Origen X en unidades especificadas por ip_units. (Ejemplo: 1.500000

ip_origin_y

Origen Y en unidades especificadas por ip_units. (Ejemplo: 5.000000

ip_pen_table

El nombre del guion de diseño asociado al trabajo de trazado.

ip_plot_rescale

Los valores de nueva escala de trazado en X e Y de la definición de impresión. (Ejemplo: 3.000000,2.000000)

ip_plot_rescale_x

El valor de nueva escala de trazado en X de la definición de impresión. (Ejemplo: 3.000000

ip_plot_rescale_y

El valor de nueva escala de trazado en Y de la definición de impresión. (Ejemplo: 2.000000

ip_project

El proyecto especificado en la definición de impresión. (Ejemplo: Baldwinsville)

ip_queue

Muestra el nombre de la impresora del sistema Windows, si está definido; de lo contrario, devuelve una cadena vacía.

ip_ref_filename

Especificación de archivo de referencia completa del elemento actual. (Ejemplo: C:\PROJ\FLOOR.DGN)

ip_rotation

La rotación del trazado especificado como ángulo en grados en el rango de 0 a 360. (Ejemplo: 45.000000

ip_scale

Escala de trazado en el formato especificado para MS_PLT_SCALE_METHOD. También devuelve el mismo valor que la variable de registro MS_PLTSCALE_SHORT. (Ejemplo: 4.000000:1.000000)

ip_short_color_table

Nombre de la tabla de colores sin el directorio. (Ejemplo: COLORS.TBL)

ip_short_design

Nombre de archivo principal sin el nombre del directorio. (Ejemplo: FLOOR27.DGN)

ip_short_design_script

Nombre de guion de diseño sin el directorio. (Ejemplo: STANDARD.PEN)

ip_short_pen_table

Nombre de guion de diseño sin el directorio. (Ejemplo: STANDARD.PEN)

ip_short_feature_table

Nombre de la tabla de entidad sin el directorio. (Ejemplo: DECATUR.FTB)

ip_short_ref_filename

Nombre de archivo de referencia sin la carpeta para el elemento actual. (Ejemplo: FLOOR.DGN)

ip_short_scale

Devuelve el mismo valor que ip_scale.

ip_units

Unidades especificadas por valores como tamaño y origen. (Ejemplo: pulgadas)

ip_view

El nombre o número de la vista. Ejemplo 2

ip_viewgroup

El grupo de vista actual. (Ejemplo: Vistas sheetone)

ip_workspace

El nombre del espacio de trabajo activo, por ejemplo, Example.

ip_workset

El nombre del plan de trabajo activo, por ejemplo, Civil.

ip_xsize

Tamaño X del trazado en unidades especificadas por ip_units. (Ejemplo: 34.000000

ip_xysize

Tamaño X e Y del trazado en unidades especificadas por ip_units. (Ejemplo: {34.000000} {44.000000}

ip_ysize

Tamaño Y del trazado en unidades especificadas por ip_units. (Ejemplo: 75.000000

long_date

Fecha en formato largo de caracteres. (Ejemplo: viernes 5 de abril de 1996)

long_time

Hora en que se produce la impresión para una presentación preliminar o una impresión en formato de tiempo largo. (Ejemplo: 11:59:17 PM)

minute

Minuto en que se produce la impresión para una presentación preliminar o una impresión. Ejemplo 59

month_abbreviation

Abreviatura de tres caracteres del mes. (Ejemplo: Abr)

month_name

Nombre completo del mes. (Ejemplo: Abril)

month_number

Número de mes. Ejemplo 4

ms_pen_table

El nombre de la tabla de plumas asociada al trabajo de trazado. Si no se definió ninguna tabla de plumas, se crea una cadena vacía. (Ejemplo: C:\PROJ\E5.TBL)

ms_pltcfg_file

La especificación de archivo para el archivo Configuración de controlador de impresión. (Ejemplo:..\Default\pltcfg\pdf.pltcfg).

ms_short_pltcfg_file

Archivo Configuración de controlador de impresión sin el directorio. (Ejemplo: PDF.PLTCFG)

ms_short_pen_table

Nombre de la tabla de plumas sin el directorio. (Ejemplo: DECATUR.TBL)

page_number

Número de secuencia de definición de impresión en el conjunto de impresión en el Organizador de impresión. (Ejemplo: 1) Si utiliza las definiciones de impresión de variables, consulte Guías para utilizar indicadores de numeración de página y de total de páginas con Definiciones de impresión de variables. Número de secuencia del trazado en el documento.

plan_set_name

La especificación de archivo para el nombre del conjunto de impresión. (Ejemplo: C:\plans\myplan.pset)

plan_set_short_name

El nombre del conjunto de impresión sin el nombre de la carpeta. (Ejemplo: myplan.pset)

plot_name

El nombre de definición de impresión dentro del diálogo Imprimir o del Organizador de impresión. (Ejemplo: border) El nombre del nombre de trazado.

second

Segundo número. Ejemplo 17

short_date

Fecha en formato numérico. (Ejemplo: 04/05/96)

short_time

Hora en formato breve. (Ejemplo: 11:59)

short_year

Año en formato de dos dígitos. Ejemplo 96

sytime

Fecha y hora del sistema en que se produce el proceso de impresión para una presentación preliminar o una impresión. (Ejemplo: 5-APR-1996 09:47)

time

Hora en que se produce el proceso de impresión para una presentación preliminar o una impresión. (Ejemplo: 09:47)

total_pages

Número total de definiciones de impresión en el conjunto de impresión. (Ejemplo: 5) Si utiliza las definiciones de impresión de variables, consulte Guías para utilizar indicadores de numeración de página y de total de páginas con Definiciones de impresión de variables. Número total de trazados en el documento.

username

Nombre de usuario del usuario que envió la presentación preliminar o la impresión. (Ejemplo: jdoe)

year

Año, en formato de cuatro dígitos, en que se produce el proceso de impresión para una presentación preliminar o una impresión. Ejemplo 1996

Sintaxis:

characters = "string"  

(donde string es cualquier cadena válida o una palabra descrita en la tabla anterior)

Ejemplo 1:

!
! Cambia "preliminary" por "final" del texto en
! nivel 10.
!
if (characters eq "preliminary" and type==text and level==10) then
	 characters = "final"
endif

Ejemplo 2:

! Reemplaza la cadena de texto "PAGE" por
! una nueva cadena que contenga el
! número de página real y el total de hojas en el conjunto.
if (characters == "PAGE") then
	 characters = PAGE_NUMBER + "of" + TOTAL_PAGES
endif

Ejemplo 3:

!
! Reemplaza la cadena "Project Number" por
! el número de proyecto real guardado en 
! la variable de entorno PROJECT_NUM.
!
if (characters == "Project Number") then
	 envr_variable = "PROJECT_NUM"
	 characters = envr_value
endif

Ejemplo 4:

! Reemplaza el nombre de cola desde la definición de impresión para
! la cadena de texto "$$queue$$."
!
if ((type == text) and (characters == '$$queue$$')) then
	characters = ip_queue
endif

Ejemplo 5:

! ! Reemplazar el nombre de usuario Windows por la 
 ! cadena de texto "$USER$" e incluir una 
 ! cadena de texto literal en la cadena de reemplazo.
 if ((type == text) and (characters == "$USER$")) then
	 characters = "User:$(USERNAME)"
 endif 

Ejemplo 6:

! Reemplaza el valor de la expresión nombrada
! _Author de la cadena de texto $AUTHOR$.
if ((type == text) and (characters == "$AUTHOR$")) then
	 characters = "<expr?name=_Author>"
endif

class

La palabra clave class (clase) cambia la clase de un elemento. El elemento no se trazará si la nueva clase ha sido desactivada en la definición de impresión o por el equivalente indicador de visualización de MicroStation.

Sintaxis:

class = integer 

(donde integer se encuentra en el rango de 0 a 6)

class = constant

donde constant es una de las siguientes:

0 primary

1 pattern_component

2 construction

3 dimension

4 primary_rule

5 linear_pattern

6 construction_rule

Ejemplo:

!
! Cambia los elementos de clase de construcción del nivel 5
! a elementos de clase primaria.
if ((class == construction) and (level == 5)) then
	 class = primary
endif

cls_end_width

La palabra clave cls_end_width define el ancho final, en unidades principales del archivo de diseño, del estilo de línea personalizado asociado al elemento actual. Cuando se especifica el mismo valor para cls_origin_width y cls_end_width, el ancho del estilo de línea "dash strokes" (trazos de guion) se angosta o se ensancha uniformemente. Cuando se especifican valores distintos para estas dos palabras clave, los trazos de guion convergen desde el inicio hasta el final del elemento.

Width (ancho) es una propiedad de opcional de cada trazo de guion en un estilo de línea personalizado. Esta palabra clave no tiene efecto en los trazos de guion de estilo de línea que no tienen width (ancho) como propiedad.

Sintaxis:

cls_end_width = real number

Ejemplo:

!
! Cambia la anchura de los trazos de guion en
! el estilo de línea "{ Wide Dash }" de 2 unidades principales de diseño
!.
!
if (cls_name == '{ Wide Dash }') then
	 cls_origin_width = 2.0
	 cls_end_width = 2.0
endif

cls_name

La palabra clave cls_name asigna un estilo de línea personalizado al elemento actual. El archivo de recursos de estilo de línea utilizado en el servidor de trazado debe contener el estilo de línea.

Sintaxis:

cls_name = string

Ejemplo:

!
! !  ! Asignar el estilo de línea personalizado "{ Diamond }"   
 ! a todos los elementos que utilizan el código de línea 3. 
 ! 
  if (style == 3) then     
	 cls_name = '{ Diamond }' 
 endif

cls_origin_width

La palabra clave cls_origin_width define el ancho inicial, en unidades principales del archivo de diseño, del estilo de línea personalizado asociado al elemento actual. Cuando se especifica el mismo valor para cls_origin_width y cls_end_width, el ancho del estilo de línea "dash strokes" (trazos de guion) se angosta o se ensancha uniformemente. Cuando se especifican valores distintos para estas dos palabras clave, los trazos de guion convergen desde el inicio hasta el final del elemento.

Width (ancho) es una propiedad de opcional de cada trazo de guion en un estilo de línea personalizado. Esta palabra clave no tiene efecto en los trazos de guion de estilo de línea que no tienen width (ancho) como propiedad.

Sintaxis:

cls_origin_width = real number

Ejemplo:

!
! Cambia la anchura de los trazos de guion
! en el estilo de línea "{ Wide Dash }" de 2 unidades principales de diseño
!.
!
if (cls_name == '{ Wide Dash }') then
	 cls_origin_width = 2.0
	 cls_end_width = 2.0
endif

cls_scale

La palabra clave cls_scale escala el estilo de línea personalizado asociado al elemento actual.

Sintaxis:

cls_scale = real number

Ejemplo:

!
! Escala todos los estilos de línea por 1/2.
!
if (cls_name .ne. 'none') then
	 cls_scale = 0.5
endif

cls_shift_distance

La palabra clave cls_shift_distance cambia el estilo de línea personalizado asociado al elemento actual. La distancia de cambio se especifica en unidades principales del archivo de diseño.

Sintaxis:

cls_shift_distance = real number

Ejemplo:

!
! Cambia el estilo de línea de origen por 1 unidad de diseño principal
!.
!
if (cls_name == '{Batten}') then
	 cls_shift_distance = 1.0
endif

cls_shift_fraction

La palabra clave cls_shift_fraction cambia el estilo de línea personalizado asociado al elemento actual.

Sintaxis:

cls_shift_fraction = real number

Ejemplo:

!
! Cambia el estilo de línea personalizado por 1/2 de la
! longitud de patrón.
!
if (cls_name .ne. 'none') then
	 cls_shift_fraction = 0.5
endif

color

La palabra clave color cambia el color del elemento actual para los elementos sin relleno. Asignar un valor a color también cambia el color de límites, el color de relleno y el color de primer plano del patrón para polígonos cerrados, si estos valores no se han definido específicamente con las palabras clave boundary_color, fill_color y pattern_color. Para obtener una descripción detallada al especificar el color, consulte “Especificar el color en las Sentencias de asignación” al final de esta sección.

Nota: Si se utiliza un color nombrado o un color RGB, el color que se utiliza para la palabra clave de comparación color no se cambiará.

Sintaxis:

color = integer 

(donde integer es un índice de color del rango de 0 a 255)

color = "string" 

(donde string es un nombre de color de una biblioteca de color)

color = (R,G,B)

(donde RGB se encuentra en el rango de 0 a 255)

Ejemplo:

!
! Cambia el color de líneas, cadenas y curvas que utilizan
! los distintos métodos para definir color.
!
if (type eq line) then
	color = 1     ! Definir el color como valor de índice 1. 
 else if (type == line_string) then      
	 color = 'blue'   ! Define el color en azul.
else if (type == curve) then
	color = (0,0,255) ! Define el color en valor RGB 0,0,255.
endif

endcap

La palabra clave endcap controla la visualización de los extremos de elementos no cerrados. Endcap tiene las siguientes opciones de visualización:

  • butt (tope): un rectángulo sin extensión (por defecto).
  • extend (extender): también rectangular, pero se extiende la mitad de la anchura de línea más allá del final de la línea o curva.
  • circle (círculo): un semicírculo con un radio de la mitad de la anchura de línea.

Sintaxis:

endcap = endcap_type

(donde endcap_type es butt, extend, circle)

Ejemplo:

!
! Especifica el tipo de tapa final en función del tipo de elemento
!.
!
if (type == line) then
	 endcap = butt
else if (type == line_string) then
	 endcap = extend
else if (type == arc) then
	 endcap = circle
endif

envr_value

La palabra clave de asignación envr_value define la envr_variable actual a la cadena especificada. Este par envr_variable = value luego se escribe en el archivo de registro y también puede utilizarse como datos de atributos en un archivo digital.

Sintaxis:

envr_value=string

Ejemplo 1:

! 
 !Este guion de diseño define un atributo de hoja de trazado 
 !basado en los caracteres guardados en los elementos de texto  
! en el archivo de diseño. El criterio para determinar qué
!texto contiene el carácter apropiado se
!basa en etiquetas de MicroSation.
tag_set='dpr'
tag_name='sheet'
if ((type eq text) and (tag_character eq 'drawingno'))then
	 envr_variable = "Drawingno"
	 envr_value = characters
else if ((type eq text) and (tag_character eq 'title')) then 
	 envr_variable = "Title"
	 envr_value = characters
else if ((type eq text) and (tag_character eq 'sheetno')) then
	 envr_variable = "Sheetno" 
	 envr_value = characters
endif

Ejemplo 2:

! 
 !Este guion de diseño define un atributo de hoja de trazado 
 !basado en los caracteres guardados en los elementos de texto  
! en el archivo de diseño. El criterio para determinar qué 
 !texto contiene el carácter apropiado 
 !se basa en el nivel.  
 if ((type eq text) and (level eq 2)) then      
	 envr_variable = "Account"      
	 envr_value = characters 
 else if ((type eq text) and (level eq 4)) then
	 envr_variable = "Project"      
	 envr_value = characters 
 else if ((type eq text) and (level eq 6)) then      
	 envr_variable = "Revision"      
	 envr_value = characters 
 endif

envr_value_num

Puede definir el valor envr_variable con un número real que utilizan la palabra clave envr_value_num. Envr_value y envr_value_num son intercambiables dentro del mismo guion de diseño. Por ejemplo, si define envr_value como valor de cadena de "4", envr_value_num se define automáticamente con el número real 4. Esto le permite extraer una cadena de un archivo de diseño (por ejemplo, un número de página), convertirlo en un número real para que pueda incrementar el valor en 1, y luego mostrarlo como una cadena. El siguiente ejemplo de guion de diseño demuestra este procedimiento.

El par envr_variable = value también se escribe en el archivo de registro y también puede utilizarse como datos de atributos en un archivo digital.

Sintaxis:

envr_value_num = real

(donde real es cualquier número real)

Ejemplo:

! El siguiente guion de diseño aumenta el número de página 
! en el bloque de título en 1. El número de página 
! es una cadena de texto en el nivel 5.
!
envr_variable = "pagenum"
if ((type eq text) and (level eq 5)) then
	 envr_value = characters
	 envr_value_num = envr_value_num + 1
	 characters = envr_value
endif

envr_variable

La palabra clave de asignación envr_variable selecciona la variable de entorno de definición de impresión que desea utilizar en el guion de diseño. Las palabras clave de comparación envr_value y envr_value_num se pueden utilizar para comprobar el valor de la variable.

Nota: Los nombres de variables de entorno deben empezar con una letra, pueden contener letras, números y guiones bajos, y no pueden contener espacios en blanco.

Sintaxis:

envr_variable = string

Ejemplo:

!
!Si SKIP_TEXT se define (como por ejemplo:
!"iplot mod MY_IPARM -environment = [SKIP_TEXT=1]")
!en el entorno IPARM environment, ignora el texto y
!los elementos de text_node.
!
envr_variable = "SKIP_TEXT"
if (envr_value <> "") then
	if (type .IN. text, text_node) then
		ignore = true
	endif
endif

fill_color

La palabra clave fill_color (color de relleno) define el color de relleno para áreas de polígonos rellenos. También especifica el color de fondo para los elementos de patrón. Con esta palabra clave se activa automáticamente area_fill. El color por defecto de relleno para un elemento es el color de elemento. El fondo de patrones por defecto es transparente. Para obtener una descripción detallada al especificar el color, consulte “Especificar el color en las Sentencias de asignación” al final de esta sección.

Sintaxis:

fill_color = integer 

(donde integer es un índice de color del rango de 0 a 255)

fill_color = "string"

(donde string es un nombre de color de una biblioteca de color)

fill_color = (R,G,B)

(donde RGB se encuentra en el rango de 0 a 255)

Ejemplo:

!
! Define el color de relleno para formas, formas complejas
! y elipses.
!
if (type == shape) then
  fill_color = 5
else if (type == complex_shape) then
	 fill_color = 'blue'
else if (type == ellipse) then
	 fill_color = (0,0,255)
endif

font

La palabra clave font (fuente) define el número de fuente de los elementos de texto.

Sintaxis:

font = integer

(donde integer se encuentra en el rango de 0 a 255)

Ejemplo:

!
! Cambia la fuente para determinadas cadenas de texto.
!
if ((type == text) and (font == 1)) then
	 font = 2
else if ((type == text) and (font == 3)) then
	 font = 7
endif

font_name

La palabra clave font_name (nombre de fuente) define el nombre de fuente de los elementos de texto.

Sintaxis:

font_name = string 

(donde string es el nombre de fuente del archivo de recursos de simbología).

Ejemplo:

!
! Cambia el nombre para determinadas cadenas de texto.
!
if ((type == text) and (font == 1)) then
	 font_name = "Architectural"
else if ((type == text) and (font == 3)) then
	 font_name = "FONT060"
endif

ignore_element

La palabra clave ignore_element (ignorar elemento) determina si se traza el elemento. Si esta palabra clave se define como verdadera, el elemento actual no se traza.

Sintaxis:

ignore_element = true
ignore_element = false

Ejemplo:

!
! !  ! No trazar elementos de texto en el nivel 63. 
 ! 
 if ((type == text) and (level == 63)) then        
	 ignore_element = true 
 endif

midline_joint

La palabra clave midline_joint controla la visualización de las juntas para los elementos sin relleno y rellenos. Si boundary_display está desactivado para un elemento relleno, definir la palabra clave midline_joint no tiene ningún efecto. La siguiente lista describe las opciones para esta palabra clave:

miter (biselar)

los bordes correspondientes de dos segmentos se extienden hasta su punto de intersección (valor por defecto).

bevel (bisel)

similar a miter (biselar), pero los segmentos se terminen con las tapas finales de tope.

butt (tope)

el extremo de cada segmento se muestra con una junta rectangular

extend (extender)

similar a butt (tope), pero cada segmento se amplía por la mitad del ancho.

círculo

muestra un semicírculo al final de cada segmento.

Sintaxis:

midline_joint = midline_joint_type

(donde midline_joint_type es butt, bevel, extend, circle, o miter)

Ejemplo:

!
! Define midline_joint en función del número
! de archivo de referencia.
!
if (file == 0) then   ! Prueba de elementos en el archivo principal.     
	 midline_joint = butt   
 else if (file == 1) then ! Prueba de elementos en el primer archivo de referencia.  
	 midline_joint = extend 
 else if(file == 2)then   ! Prueba de elementos en el segundo archivo de referencia.
	 midline_joint = circle 
 else if(file == 3)then  ! Prueba de elementos en el tercer archivo de referencia. 
	 midline_joint = miter  
 endif

pen

La palabra clave pen (pluma) selecciona la pluma en un plotter de plumas. Definir esta palabra clave equivale a definir el color del elemento actual, salvo que el número de pluma sea igual al número de color más 1.

Sintaxis:

pen = integer

(donde integer se encuentra en el rango de 1 a 256)

Ejemplo:

!
! !  ! Definir número de pluma en función del nivel de elemento. 
 if (level == 1 ) then         
	 pen = 1 else if (level == 2 ) then        
	 pen = 2 else if (level == 3 ) then        
	 pen = 3 
 endif

pen_width_nn

(Donde n es un valor del 0 al 31)

La palabra clave pen_width_nn asigna anchuras de línea de impresión (espesor físico) en unidades del guion de diseño a los 32 grosores estándares del producto. Esta palabra clave de asignación del guion de diseño sustituye las asignaciones de grosor a anchura definidas en el archivo de configuración del controlador de la impresora (.pltcfg), y equivale a las asignaciones de grosor a anchura que se pueden definir en una tabla de plumas. Esta palabra clave se comporta de la misma manera que las palabras claves weight_base / weight_delta, a diferencia de que la palabra clave pen_width_nn permite que cada grosor se asigne independientemente.

Nota: Las asignaciones de pen_width_nn no se pueden realizar por elementos. Los valores se leen en el guion de diseño al principio del proceso de impresión. Cualquier tentativa de modificar los valores de la anchura de la pluma a posteriori será ignorada. Por este motivo y para un mejor rendimiento, es una buena práctica incluir las asignaciones de pen_width_nn dentro de la condición del guion de diseño (first_time).
!
! Especifica las asignaciones de grosor a anchura según el tamaño del papel.
!
units = mm
if (first_time) then
  if (ip_xsize_num > 17) then
    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
  else
    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

priority

La palabra clave priority (prioridad) modifica el orden en el que se trazan elementos. Por defecto, los elementos se trazan en el orden que aparecen en el archivo de diseño. Utilizando la palabra clave priority, los elementos de baja prioridad se trazan antes que los elementos de mayor prioridad de modo que los elementos de mayor prioridad se trazan sobre los elementos de menor prioridad. Esto puede ser útil al trazar áreas rellenas de elementos. Por ejemplo, si desea que una cadena de texto se trace en el interior un polígono relleno, el texto debe tener mayor prioridad que el polígono para que no se cubra el texto. La prioridad por defecto para un elemento es 0.

Es importante tener en cuenta que los elementos sin prioridad se imprimen primero, y luego se imprimen los elementos con prioridad, en función de su prioridad; por lo tanto, las tablas de plumas con prioridad negativa que "empujan los elementos debajo" pueden requerir una alteración.

Nota: La palabra clave priority no es válida para elementos rellenos que se trazan en un dispositivo vectorial. La palabra clave priority omite el orden implicado por secuencias de actualización de visualización.

Sintaxis:

priority = integer

(donde integer se encuentra en el rango de -1 000 000 a 1 000 000)

Ejemplo:

!
! Definir prioridad de elementos en función de su color.
if (type == shape) then
	 area_fill = true
 	 if (color == 1) then
		   priority = 10
	  else if (type == text) then
		 !Plot text on top of the shapes.
		   priority = 20
	  endif
endif

scale

La palabra clave scale (escala) especifica el factor de escala que se aplica a elementos que tienen un origen local, como células (normales y compartidas), arcos, elipses, texto y nodos de texto. El texto y los nodos de texto se escalarán sobre el punto de justificación. La escala por defecto es 1,0.

Sintaxis:

scale = real

(donde real es cualquier número real positivo)

Ejemplo:

!
! Escala texto por un factor de 1.5.
!
 if (type == text) then
	scale = 1.5
endif

screen_relative

La palabra clave screen_relative se utiliza para modificar el screen_relative bit en la palabra properties del elemento actual MicroStation se refiere a screen relative como "independiente de vista".

Sintaxis:

screen_relative = true
screen_relative = false

Ejemplo:

!
! Si un elemento es una célula llamada 'LOGO', defina screen
! relative bit en la palabra properties.
!
if ((type == cell) and (cellname == 'LOGO')) then
	 screen_relative = true
endif

screening

El screening (filtrado) permite especificar si un color aparece "aclarado" con tendencia al blanco en la salida de impresión. Mientras que un 100% de screening significa imprimir el color tal cual, un valor del 50%, por ejemplo, transforma un color hasta que quede casi blanco. Esta palabra clave se puede utilizar para ahorrar tinta o para reducir el énfasis de los elementos impresos por plotter en ese color.

Sintaxis:

screening = integer

(donde integer se encuentra en el rango de 1 a 99)

Ejemplo:

!
! Si el elemento es una elipse, define el filtrado en 50%.
if (type == ellipse) then
	 screening = 50
endif

size

La palabra clave size (tamaño) se utiliza para modificar el tamaño del texto y de los elementos de nodo de texto.

Sintaxis:

size = working units

Ejemplo:

!
! !  ! Definir el tamaño de texto para los elementos de texto de nivel 1. 
 ! 
 if ((type == text) and (level == 1)) then        
	 size = 0:0:250 
 endif

style

La palabra clave style (estilo) contiene el valor del estilo de línea del elemento actual. Especifique un nuevo estilo asignando al elemento un índice en el rango de 0 a 7, que corresponde a uno de los tipos de estilo predefinidos de MicroStation. Puede utilizarse un estilo de línea definido por el usuario, especificando el nombre de un estilo de línea de una biblioteca de estilos de línea o especificando una serie de transiciones on/off (activación/desactivación). Definir el estilo no tiene efecto sobre los elementos rellenos de área o de patrón si la visualización del límite no se activa. Por defecto, se desactiva la visualización de límites.

Nota: Si utiliza un estilo nombrado o una definición de estilo, el estilo de línea utilizado con la palabra clave de comparación de estilo no cambia.

Sintaxis:

style = integer

(donde integer es un índice de estilo de línea del rango de 0 a 7)

style = "string" 

(donde string es un nombre de estilo de línea en una biblioteca de estilo de línea llamada "DesignScriptStyles.slb" suministrada con la carpeta definida por MS_DATA)

style = line style definition 

(on, off, on, off...)

Ejemplo:

!
! Define el estilo del elemento en función de su color utilizando
! los diversos métodos para definir un estilo de línea.
!
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

(Siendo: n es un valor numérico del 1 al 7)

La palabra clave style_n modifica las definiciones de patrón pluma hacia arriba / pluma hacia abajo de los siete estilos de línea estándares. Esta palabra clave de asignación del guion de diseño sustituye los patrones de estilo de línea definidos en el archivo de configuración del controlador de la impresora (.pltcfg). Puede especificarse un patrón mediante el nombre de un estilo de línea definido en la biblioteca de estilos de línea o especificando una serie de transiciones on/off (activación/desactivación). Esta sintaxis es lo mismo que la palabra clave de asignación style .

Sintaxis:

style_<número> = "cadena"

(donde n es un valor del 1 al 7, y la cadena es un nombre de estilo de línea en la biblioteca de estilos de línea DesignScriptStyles.slb suministrada con la carpeta definida por MS_DATA)

style_<número> = definición de estilo de línea

(donde n es un valor del 1 al 7, y la definición de estilo de línea es un patrón activado, desactivado, activado, desactivado, etc. que usa unidades del guion de diseño)

Nota: Las asignaciones de style_n no se pueden realizar por elementos. Los valores se leen en el guion de diseño al principio del proceso de impresión. Cualquier tentativa de modificar las definiciones de estilo de línea estándares a posteriori será ignorada. Por este motivo y para un mejor rendimiento, es una buena práctica incluir las asignaciones de style_n dentro de la condición del guion de diseño (first_time).

Para los elementos simples como líneas y formas, las palabras claves style y style_n producen los mismos resultados. La palabra clave style se puede utilizar para asignar un patrón diferente por elementos. Sin embargo, cuando se aplica a un elemento compuesto con estilos de línea múltiples, como una cota o un elemento multilínea, la asignación de style cambia el estilo de cada línea dentro del elemento. Las asignaciones de style_n se pueden utilizar para especificar al patrón de los siete estilos de línea estándares sin modificar los números de estilo de los elementos compuestos.

Ejemplo:

!
! Especifica el patrón de los siete estilos de línea estándares en función del tamaño de papel.
!
units = inches
if (first_time) then
  if (ip_xsize_num > 17) then
    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)
  else
    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

Las palabras clave de asignación TAG_SET y TAG_NAME se utilizan para especificar el conjunto de etiquetas y el nombre de etiqueta para su uso por una de las palabras clave de comparación.

Tipos de datos:

tag_set

string

tag_name

string

Ejemplo:

!
! !  ! Suponiendo que el archivo de diseño utilice dos conjuntos de etiquetas,  
 ! "Home address" y "Work address," cada una
 ! con una etiqueta de carácter llamada "City,"  
 ! cambiar el color de todos los elementos cuyas etiquetas 
 ! especifiquen una dirección de hogar de "Huntsville" o una  
 ! dirección laboral de "Madison."
!
! Comienza buscando las etiquetas "City" del
! grupo de etiquetas "Home address".
!
tag_set = 'Home address'
tag_name = 'City'
if (tag_char == 'Huntsville') then
	 color = 4
endif
! Luego busque etiquetas en el conjunto de etiquetas "Work address"
!.  Observe que el nombre de etiqueta sigue siendo "City". 
 tag_set = 'Work address' 
 if (tag_char == 'Madison') then     
	 color = 4 
 endif

thickness

La palabra clave thickness (espesor) permite especificar el ancho de línea en unidades físicas en lugar de un grosor de línea. El valor de las unidades almacenado en la definición de impresión es el valor por defecto para la palabra clave thickness, pero puede modificarse en el guion de diseño con la palabra clave units. Especificar un espesor no cambia el grosor utilizado por la palabra clave de comparación weight.

Nota: Debe especificar el valor de la palabra clave thickness exactamente.

Sintaxis:

thickness = positive real number

Ejemplo:

!
! Define el espesor de línea en función del color del elemento.
!
units = inches
switch (color)
	case 1 - 5 ?
		thickness = 0.125
	case 6 - 10 ?
		thickness = 0.075
	default ?
		thickness = 0.05
endswitch

translucent

Si la palabra clave translucent (translucido) se define como verdadera, el elemento actual no se traza, de forma tal que cualquier elemento debajo de este no se esconda completamente. El valor por defecto de esta palabra clave es falso. La palabra clave translucent afecta únicamente a elementos sin relleno y límites de elementos rellenos, si los límites están activados. La palabra clave translucent no es válida para dispositivos de vector o dispositivos manejados por los controladores de impresión de Microsoft.

Nota: La palabra clave translucent funciona como la nueva palabra transparency con un valor de 50. La palabra clave translucent afecta elementos rellenos y no rellenos y límites de elementos rellenos si los límites están activados. Para obtener más información, consulte la palabra clave transparencia.

Sintaxis:

translucent = true
translucent = false

Ejemplo:

!
! Traza elementos en el nivel 10 con líneas rojas de gran grosor
! y permite que los elementos debajo
! se muestren.
!
if (level == 10) then
	 color = "red"
	 weight = 10
	 translucent = true
endif

translucent_fill

Si está definida como verdadera, la palabra clave translucent_fill especifica que el color de relleno de los elementos de área y de patrón rellenos sea traslúcido. El color de primer plano y el de fondo para los elementos pattern_filled son ambos translúcidos. Los elementos debajo de un elemento translucent_filled aún son visibles. El valor por defecto de esta palabra clave es falso. La palabra clave translucent_fill no es válida para dispositivos de vector o dispositivos manejados por los controladores de impresión de Microsoft.

Nota: La palabra clave translucent_fill funciona como la nueva palabra transparency con un valor de 50. La palabra clave translucent_fill afecta elementos no rellenos, rellenos de área y rellenos de patrón si los límites están activados. Para obtener más información, consulte la palabra clave transparencia.

Sintaxis:

translucent_fill = true
translucent_fill = false

Ejemplo:

!
! Define color de relleno para que sea traslúcido.
!
area_fill = true
translucent_fill = true
fill_color = (255,0,0)

transparency

La palabra clave de asignación transparency (transparencia) permite definir la transparencia del elemento actual. Puede definir el valor de transparencia de 1 a 100. Cuanto mayor sea el valor, más transparente será el elemento.

Sintaxis:

transparency = value

(donde value es 1–100)

Ejemplo:

!
! Define transparencia de las líneas del nivel 2.
!
if ((level eq 2) and (type eq line)) then
	 transparency = 50
endif

units

La palabra clave units (unidades) se utiliza para especificar la cota para las palabras clave thickness y line styles. Siempre defina la palabra clave units al principio del guion de diseño y defínala solo una vez dentro de un guion de diseño. El valor por defecto de la palabra clave es el valor de las unidades de definición de impresión.

Sintaxis:

units = units_constant

(donde units_constant es una de las siguientes:

centímetros (cm)

milímetros (mm)

metros

pulgadas

pies (ft)

Ejemplo:

!
! Define el espesor de línea en 0.5 milímetros.
!
units = mm
thickness = 0.5

weight

La palabra clave weight (grosor) modifica el grosor de línea del elemento actual. Para los elementos rellenos, boundary_display debe estar activado para que esta palabra clave afecte el límite del elemento.

Sintaxis:

weight = integer	

(donde integer se encuentra en el rango de 0 a 31)

Ejemplo:

!
! Define el grosor de línea en función del color del elemento.
!
switch (color)
	case 1-10 ?
		 weight = 2
	case 11-20 ?
		 weight = 1
	default ?
		 weight = 0
endswitch

weight_base/weight_delta

Las palabras clave weight_base y weight_delta asignan grosores de línea a espesores físicos en el trazado. Con estas palabras clave, puede obtener los espesores de línea coherentes en varios trazadores. La palabra clave weight_base especifica el espesor de línea de un elemento de grosor 0. La palabra clave weight_delta especifica un incremento adicional de espesor de línea para añadir a cada grosor de línea superior a 0. Utilice la siguiente fórmula para calcular el espesor de línea que utilizan las palabras clave weight_base y weight_delta:

plot thickness = weight_base + (element weight * weight_delta)

Por ejemplo, si weight_base es 0,1 cm y weight_delta es 0,05 cm, se utilizan los siguientes valores.

Grosor Espesor de trazado

0

0.10 cm

1

0.15 cm

2

0.20 cm

.

.

.

.

.

.

31

1.65 cm

Nota: Debe definir las palabras clave weight_base y weight_delta al principio de guion de diseño.

Sintaxis:

weight_base = positive_real
weight_delta = positive_real

Ejemplo:

!
! Asigna el grosor de línea de un elemento a un espesor
! en el trazado.
!      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