12DXML Import

12DXML is an XML-based data exchange format used by 12d Model civil engineering software. udStream can import 12DXML files directly into the scene, loading models and their super strings as scene explorer items.

udStream has limited support for the 12DXML specification. Only the features listed below are supported. More features may be added in future releases — contact us at support@nuclideon.com for specific requests.

File Encodings

udStream supports UTF-8 encoded text files only. If your file uses a different encoding, you can convert it in Notepad on Windows: open the file, choose File > Save As..., set the encoding to UTF-8, and save. Alternatively, re-export the file from 12d Model as UTF-8.

The import modal will automatically detect the encoding of the selected file. If the encoding is shown as Unknown, the file cannot be imported and will need to be re-encoded.

To import a 12DXML file, use Tools > Import 12DXML from the menu bar or drag and drop a .12dxml file into udStream.

The following options are available:

Field	Description
12DXML File	Path to the `.12dxml` file to import. Use the `...` button to browse.
Encoding	The detected file encoding. Shown once a valid file is selected. The import button is disabled if the encoding is Unknown.
Geozone	The current scene geozone that the file will be imported into. Verify this matches the coordinate system of your data.
Default Colour	The colour applied to super strings that do not specify a colour. Defaults to red, matching the 12DXML specification default.
Default Width	The line width (0.1–10.0) applied to super strings that do not specify a width. Defaults to 1.0.

Click Import 12DXML to load the file. The modal will close and the data will appear in the Scene Explorer.

Supported Features

The table below lists the 12DXML elements and super string properties that udStream currently supports.

Structure

Element	Support	Notes
Models	Supported	Each model is loaded as a folder in the Scene Explorer
Super strings (`string_super`)	Supported	Loaded within their parent model folder
Full TIN (`full_tin`)	Not supported
Super TIN (`super_tin`)	Not supported

Super String Properties

Property	Support	Notes
Name	Supported	Used as the scene item label
Colour	Supported	Falls back to the configured default colour if not specified
3D point data (`data_3d`)	Supported	Single points load as Annotations; multiple points load as Lines of Interest
2D point data (`data_2d`)	Supported	Single points load as Annotations; multiple points load as Lines of Interest
`null` command	Supported	Can be set once per string
`colour` command	Supported	Can be set once per string

Unsupported String Types

The following 12DXML string types are recognised by the parser but are not currently loaded into the scene: