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:

TabMeaning
Single fileImports exactly one GIS file, specified under File name: (GIS Files (*.shp *.gpkg *.geojson *.gml)).
DirectoryImports 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:

TabMeaning
Tab Single fileImports exactly one GIS file (GIS Files (*.shp *.gpkg *.geojson *.gml)).
Tab DirectoryImports all GIS files in a folder including subdirectories - practical for cadastral deliveries consisting of many individual files.
Import options > Text attributesList of all attributes found; checked attributes are displayed as labels (e.g. parcel numbers, street names).
Import options > Layers with filled polygonsChecked 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.

ElementMeaning
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 distanceScale 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 sizeAlternatively, 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.

Stay up to date

New features, tutorials and updates delivered to your inbox.