dgn
The dgn subcommand specifies that the drawing file to open in the drawing window is a MicroStation DGNv8 file (with the .dgn extension).
Required positional options
| Name | Description |
|---|---|
| path | Path of the drawing file (.dgn) to load. |
With the Spanish interface, this positional option is called ruta.
Like the bind, bin and shp subcommands, the dgn subcommand requires this positional option. With the .dgn file path, Digi3D.AI determines the format of the drawing file and opens the drawing window; without the file path, the command line produces an error and Digi3D.AI does not open the drawing window.
Options
The names of the options in the table and of their values are fixed literals, in Spanish: they do not change with the interface language. Only the name of the positional option (path or ruta) depends on the language. The values of the options that accept a list of values are not case sensitive.
If you specify one of the non-required options, the value you give replaces the default value of that option. Each option you do not specify takes the default value in this table, not the value saved in the user configuration.
| Option | Required | Description | Accepted values |
|---|---|---|---|
| --criterio_nivel | No | DGN element attributes that Digi3D.AI uses to look up the element's code in the code table. | Values: nivel, nivel_celula, nivel_color_estilo_grosor, nivel_color_estilo_grosor_celula, nivel_color, nivel_estilo, nivel_grosor, grupo_grafico, geographics, ngix, numero_nivel, numero_nivel_celula, numero_nivel_color_estilo_grosor, numero_nivel_color_estilo_grosor_celula, numero_nivel_color, numero_nivel_estilo, numero_nivel_grosor, nivel_color_celula, nivel_color_y_celula.The values that start with numero_nivel identify the level by its number and not by its name.The default value is nivel. |
| --plantilla | No | Path of the template .dgn file. If the drawing file does not exist, Digi3D.AI creates it as a copy of the template. | Path of a file. By default, there is no template. |
| --extraer_celulas_de | No | Source of the shape of the cells. | archivo_celulas_microstation = MicroStation cell file given in --archivo_celulas.carpeta_de_simbolos_digi = Digi symbols folder.The default value is carpeta_de_simbolos_digi. |
| --archivo_celulas | No | Path of the cell file (.cel) that Digi3D.AI loads when --extraer_celulas_de is archivo_celulas_microstation. |
Path of a file. It is empty by default. |
| --transformar_el_nivel_de_las_entidades_de_las_celulas | No | If you specify this option, when exporting, Digi3D.AI assigns the level, color, style and thickness of the code to each element of the cell. | |
| --importar_paleta | No | If you specify this option, when opening an existing file, Digi3D.AI imports the file's color palette, if it has one. | |
| --extraer_colores_de | Yes | Source of the color and thickness of the entities when the file is read. | archivo_dgn = colors of the DGN file.tabla_de_codigos = colors of the active code table. |
| --importar_celulas_como | Yes | Entity type into which Digi3D.AI converts each cell when the file is read. | punto = point.complejo_virtual = point-type complex element. |
| --incremento_registro_splines | No | Distance between vertices when splines are converted to polylines as the file is read. | Real number. A value less than 1 is taken as 1. The default value is 1. |
| --formato_desconocidos | No | Format of the name of the code that Digi3D.AI creates for elements that have no translation in the code table. | Text with the substitutors $(Nivel), $(Color), $(Estilo), $(Grosor) and $(GrupoGrafico). Digi3D.AI also accepts $(Level), $(Style), $(Thickness) and $(GraphicGroup) with any interface language.If it is empty, Digi3D.AI uses $(Nivel) with the Spanish interface and $(Level) with the English interface.It is empty by default. |
| --archivo_recursos_simbologia | No | Paths of the MicroStation resource files that Digi3D.AI loads when it opens the file. | Paths separated by semicolons. It is empty by default. |
The --extraer_colores_de and --importar_celulas_como options are required: if you do not specify one of them, the command line produces an error.
The --transformar_el_nivel_de_las_entidades_de_las_celulas and --importar_paleta options take no value. If you do not specify them, their value is false. The options in the table correspond to the properties of the Import/Export engine category described in DGNv8 files.
Example
Command that opens the drawing file c:\trabajo\plano.dgn with the code table c:\trabajo\tabla.tab.xml and the two required options (colors of the DGN file and cells as points):
digi3d.exe dibujo --tabla c:\trabajo\tabla.tab.xml dgn c:\trabajo\plano.dgn --extraer_colores_de archivo_dgn --importar_celulas_como punto
Command that also assigns the codes according to the level and the color, and loads the cells of the file c:\trabajo\celulas.cel:
digi3d.exe dibujo --tabla c:\trabajo\tabla.tab.xml dgn c:\trabajo\plano.dgn --criterio_nivel nivel_color --extraer_celulas_de archivo_celulas_microstation --archivo_celulas c:\trabajo\celulas.cel --extraer_colores_de archivo_dgn --importar_celulas_como punto