ENVIPointCloudViewer

ENVIPointCloudViewer starts the ENVI LiDAR application and returns an object reference to the instance of the application. Use ENVIPointCloudViewer to issue procedure and function calls at the IDL command line one-by-one to display and interact with point cloud data, versus interacting with the user interface and selecting menu options. This interactive approach is meant for users who want more control over display options or who want to run custom scripts while displaying point cloud data in the ENVI LiDAR application.

You can also use ENVIPointCloudViewer to create ENVI Toolbox extensions to process and view point cloud data.

ENVIPointCloudViewer requires a valid, non-headless instance of ENVI to be running.

Note: ENVIPointCloudViewer 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

Syntax

Result = ENVIPointCloudViewer([/CURRENT] [,ERROR=variable])

Return Value

This function returns a reference to the ENVI LiDAR application.

Arguments

None.

Methods

Keywords

CURRENT

Set this keyword to test if the ENVIPointCloudViewersoftware is currently running, and to retrieve a reference to the application. If this keyword is set and ENVIPointCloudViewer is not already running, the application will not be launched.

ERROR (Init)

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.

Properties

None.

Version History

ENVI 5.3

Introduced

API Version

4.2