ENVIPointCloudViewer::DisplayShapefile

The DisplayShapefile function opens a shapefile in the ENVI LiDAR application. Each time this method is called, the previous shapefile display is replaced with the current. The shapefile must be in WGS84 UTM coordinate space. This method is similar to selecting File > Import > Background Shapefile from the menu in the ENVI LiDAR application.

Note: This method is supported only on Windows.

Example

; Get the ENVIPointCloudViewer application

e = ENVI()

elv = ENVIPointCloudViewer()

; Open the las file

file = FILEPATH('DataSample.las', ROOT_DIR=e.ROOT_DIR, $

  SUBDIRECTORY = ['data','lidar'])

pointcloud = e.OpenPointCloud(file, $

  PROJECT_URI=Filepath('DataSample', /TMP))

; Display the las file

elv.Display, pointcloud

; Create buildings shapefile

task = ENVITask('PointCloudFeatureExtraction')

task.INPUT_POINT_CLOUD = pointcloud

task.BUILDINGS_GENERATE=1

task.Execute

productsInfo = task.OUTPUT_PRODUCTS_INFO

; Display the shapefile

elv.DisplayShapefile, productsInfo.BUILDINGS_URI

Syntax

ENVIPointCloudViewer.DisplayShapefile, Filename([, ERROR=variable])

Arguments

Filename

The shapefile to open.

Keywords

ERROR

Set this keyword to a named variable that will contain any error message issued during execution of this routine. If no error occurs, the ERROR variable will be set to a null string (''). If an error occurs and the routine is a function, then the function result will be undefined.

When this keyword is not set and an error occurs, ENVI returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine. See IDL Help for more information on !ERROR_STATE and CATCH.

See Manage Errors for more information on error handling in ENVI programming.

Version History

ENVI 5.3

Introduced

API Version

4.2