Import GIS drawing and PDF/image
Import cadastral maps and land registry data as a GIS drawing, and PDF plans and images as a scaled background graphic in VICUS Buildings
VICUS Buildings Page 5 of 6 in this chapter
Overview
In addition to DXF and the area data (OpenStreetMap, ALKIS), VICUS Buildings supports two further types of reference documents (underlays):
- GIS drawings from Shapefile (
.shp), GeoPackage (.gpkg), GeoJSON (.geojson) or GML (.gml) - e.g. cadastral maps, land registry (ALKIS exports) or development plans. - PDF plans and images (PDF, PNG, JPEG, etc.) - e.g. scanned floor plans or site plans.
Both serve as a visual planning basis; they are not simulated.
Import GIS drawing
Access
- Menu Import › GIS data as background drawing …
- alternatively the button
File in the Import area of the Add geometry panel (tooltip Import GIS data as drawing)
“Import GIS Drawing” dialog
You choose the source via two tabs:
| Tab | Meaning |
|---|---|
| Single file | Imports exactly one GIS file, specified under File name: (GIS Files (*.shp *.gpkg *.geojson *.gml)). |
| Directory | Imports all GIS files of the folder specified under Directory: including subdirectories - practical for cadastral deliveries consisting of many individual files. |
Below, two further tabs define the appearance:
| Tab | Meaning |
|---|---|
| Tab Single file | Imports exactly one GIS file (GIS Files (*.shp *.gpkg *.geojson *.gml)). |
| Tab Directory | Imports all GIS files in a folder including subdirectories - practical for cadastral deliveries consisting of many individual files. |
| Import options > Text attributes | List of all attributes found; checked attributes are displayed as labels (e.g. parcel numbers, street names). |
| Import options > Layers with filled polygons | Checked layers are displayed as filled surfaces, all others as outlines. |
The Import options section is collapsed initially.
The import log reports the detected coordinate reference system (CRS) and the UTM zone - geographic coordinates (latitude/longitude) are automatically transformed into UTM coordinates - as well as an import summary (drawing, layers, points, texts, polylines).
World coordinate origin
If the project does not yet have a world coordinate origin (origin 0/0/0), it is set from the data during the GIS import (with UTM zone and hemisphere). This keeps large state coordinates outside the 3D scene, and the drawing appears near the scene origin. The import and the origin form one common undo step (Imported GIS drawing); the main grid is hidden.
Further GIS imports are merged into the existing GIS drawing: new layers and geometries are appended, existing layers are not created twice. Layers from files receive a uniform default color, layers from official survey data fixed grey levels; the color of each layer can then be changed via the color box in the object tree.
Result
The GIS drawing appears in the navigation tree with one layer per source file or source layer; visibility and color can be controlled per layer, and the appearance (text size, line width) adjusted by double-clicking the drawing. Texts are shown with filled letters, filled areas lie behind the lines; imported images are drawn on top of the GIS drawing. Unlike DXF drawings, GIS drawings provide no snap points when drawing - they are a pure background reference.
Import PDF or image
Access
- Menu Import › PDF / Picture …
- alternatively the button
PDF in the Import area of the Add geometry panel
The project must have been saved beforehand: “The project must be saved before a PDF plan can be imported (the imported images are stored next to the project file).” The image files end up in the folder <ProjectName>_images next to the project file and are referenced relatively in the project.
Large image files are read in the background; meanwhile a progress dialog shows “Reading image ’…’…”. Very large images are scaled down automatically on import.
Dialog
In the preview, you zoom with the mouse wheel and move the image while holding down the left mouse button.
| Element | Meaning |
|---|---|
| Name: | Display name of the plan in the navigation tree. |
| Re-import with changed resolution / DPI: | Visible for PDF files and image formats that cannot be read directly: the file is rasterized into an image via ImageMagick (DPI range 50-2000). If the display is blurry, increase the DPI and convert again. Under Linux, the package ImageMagick must be installed. |
| Define distance | Scale via a reference distance: “Select two points and enter the length!” - click two points in the image and enter the real length in m under Distance:. |
| Define document size | Alternatively, enter the real Width: or Height: of the entire plan in m; the other value is calculated from the aspect ratio. |
With OK, the plan is inserted as a flat rectangle in the floor plan plane (z = 0) at the scene origin.
Important in practice
The reference distance determines the scale of the entire plan - an error here carries through the complete traced building. Choose the longest possible, clearly known distance (e.g. a whole building edge from the existing plan instead of a door width): the longer the reference distance, the less the click imprecision affects the scale.
Positioning the plan
The imported plan is selected like other objects and moved and rotated via the transformation tools. It then serves - viewed from above in 2D mode - as a template for tracing the rooms; a raster image does not provide snap points here.