Maps and Images

There are two options for importing images into Leapfrog Works:

• Import them into the GIS Data, Maps and Photos folder. Use this option to import maps and photos that will be useful in tying 2D surface data into the 3D modelling environment. Once imported, you can drape images onto the topography surface, alongside GIS data in the project.
• Import them into the Sections, Plans and Contours folder using the New Cross Section From Image option. Use this option to import cross section images. You can then evaluate geological models, interpolants, distance functions and surfaces on the cross section and create a section layouts.

The first part of this topic describes:

• Importing Images
• Georeferencing Images
• Exporting a Georeferenced Image
• Displaying an Image in the Scene

These four subtopics apply to both images in the GIS Data, Maps and Photos folder and the Sections, Plans and Contours folder.

The remaining subtopics apply only to images imported into the GIS Data, Maps and Photos folder. They are:

• Draping Images on the Topography
• Setting Elevation for Images
• Displaying an Image Draped on the Topography
• Displaying Images in Custom Topography Views

Importing Images

You can import images into Leapfrog Works in the following formats:

• Graphics Interchange Format Files (*.gif)
• JPEG Files (*.jpg, *.jpeg)
• PNG Image Files (*.png)
• Tag Image Files (*.tiff, *.tif)
• Windows Bitmap Files (*.bmp)

Whether you are importing maps and photos into the GIS Data, Maps and Photos folder or cross sections into the Sections, Plans and Contours folder, the image formats supported and the process are the same. To import an image, right-click on the folder in the project tree and select either Import Map or New Cross Section From Image, as required:

Navigate to the folder that contains the image file and select it. You can select multiple files using the Shift and Ctrl keys.

Click Open to import the file or files.

• If you are importing a single file that contains georeference data, it will automatically be added to the folder you are importing it into.
• If you are importing multiple files, all files will automatically be added to the folder you are importing them into, even those that do not contain georeferencing information.
• If you are importing a single file and it does not contain georeference data, an import tab will be opened in which you can add georeferencing information.

You can also drag and drop a file or multiple files from File Explorer into Leapfrog Works. Select all the files you wish to import and drop them into the GIS Data, Maps and Photos folder or the Sections, Plans and Contours folder. All images will be imported and added to the folder. If an image does not contain georeference data, you will need to open the image and add the information manually, as described in Georeferencing Images below.

Here a single non-georeferenced map image is being imported into the GIS Data, Maps and Photos folder:

The three markers (, , ) are used to display the georeference data for imported images. For images that do not contain georeference data, you need to enter coordinates for each of the markers, which is described in Georeferencing Images below.

Use the controls in the toolbar to zoom in and out of the image. The Import button () imports the image and closes the window, regardless of whether or not you have set the georeference information.

You can also use the Crop Image button () to crop the image to only the area of interest. This will reduce video RAM usage and may improve graphics performance.

To crop an image, click on the Crop Image button () and then drag around the part of the image you wish to use.

Click on the Remove Crop button () to clear the cropping.

The process for importing an image into the Sections, Plans and Contours folder is similar, except that there are additional controls for specifying the section type and once the image has been imported, a Leapfrog Works section is created in the project tree.

Here a single non-georeferenced section image is being imported into the Sections, Plans and Contours folder:

You only need to enter coordinates for the yellow and green markers for vertical sections. Enable the Vertical section option, which removes the blue marker row:

If your image is a north-south or east-west section, enable the corresponding Align section option.

Once you have imported the section image, it will appear in the project tree under a new section:

You can evaluate geological models, interpolants, distance functions and surfaces on the section and create section layouts. See Evaluations. and Section Layouts for more information on these options.

Georeferencing Images

In Leapfrog Works, three markers (, , ) are used to set the georeference data for imported images. You can see these markers when you double-click on an imported image, which opens an image tab where you can edit the image’s georeference data. In this example, the georeference data is greyed out because the image contains that data:

In the image tab, there are two sets of markers. The first set of markers is for marking a location in the image tab; the second set of markers is for copying location information from the scene into the image tab.

This is explained in more detail below.

When you switch between the image window and the scene, you can see the georeferencing markers:

To position one of the three reference markers (, , ) in the image tab, click on a marker button, then move it to the required location in the image tab using the mouse or the arrow keys. Once each marker is correctly positioned, enter the real-world X and Y coordinates for each marker:

There are two ways to do this:

• Enter the coordinates for each marker in the East (X) and North (Y) fields. As you enter the coordinates, the positions of the markers will be displayed in the scene.
• Copy coordinates from the scene using the three copy markers (, , ).

The second method is useful when you already have other objects correctly georeferenced in the project. For example, if you have another map or some polylines or points in the project and wish to import a map that aligns perfectly, you can reference the imported image directly against the existing project data.

To manually georeference the imported image using the three copy markers:

• In the image tab, position the marker (, , ) on the image being imported.
• Click the corresponding copy coordinates marker (, , ).
• Click in the scene the point corresponding to where in the image tab the marker was placed.

The coordinates in the scene will be entered into the image tab.

If the alignment is not perfect, make adjustments to improve the match. There are two ways to make these adjustments:

• In the scene window, zoom in to the point where you wish to place a copy-coordinates marker (, , ), click the marker in the image tab, then click the point in the scene zoomed in, or
• In the image tab, zoom in to the point where the reference marker has been positioned and adjust the location.

Click the Save button to preview the change before closing the image tab.

Exporting a Georeferenced Image

If you have georeferenced an image you imported into Leapfrog Works, you can export the image as a GeoTIFF. To do this, right-click on the image in the project tree and select Export. You will be prompted for a filename and location. Click Save.

Displaying an Image in the Scene

To display an image in the scene, either drag it from the project tree into the scene or right-click on it in the project tree and select View Object. This displays the image at a fixed elevation, which can be changed as described in Setting Elevation for Images above.

If nothing is displayed when you add an image to the scene, it may be that it does not contain georeference data. This could be the case if you imported multiple images and some of them did not contain georeference data. To add georeference data, double-click on the image in the project tree and add the coordinates as described in Georeferencing Images above.

Draping Images on the Topography

Images imported into the GIS Data, Maps and Photos folder can be draped on the topography. To do this, right-click on an image in the project tree and tick the On Topography box:

The draped version of the image will be added to the Draped GIS Objects folder under the Topography folder:

You can drape multiple images and/or GIS data objects on the topography in one action by using the Shift and Ctrl keys to select the objects you wish to drape, then right-clicking on them and selecting Drape On Topography:

To remove an object from the topography, right-click on either it or its draped copy in the Draped GIS Objects folder and untick the On Topography box. For multiple objects, select Remove From Topography.

Setting Elevation for Images

You can change the elevation for images imported into the GIS Data, Maps and Photos folder by right-clicking on them in the project tree and selecting Set Elevation. In the window that appears, enter the elevation value you wish to use, then click OK.

Displaying an Image Draped on the Topography

To display an image using the topography’s elevation data, first drape the image on the topography as described in Draping Images on the Topography above.

Next, add the topography to the scene and in the shape list, click on the topography’s GIS Data list. Select the image you wish to view from the Maps and Photos submenu:

Displaying Images in Custom Topography Views

With custom topography views, you can display multiple images along with GIS data objects draped on the topography. For example, here a map is displayed along with GIS data:

To find out more about creating a custom topography view, see Custom Topography Views in the Defining a Topography topic.