Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  Programming and Control  >  IDL_IDLBridge::SetVar

IDL_IDLBridge::SetVar

IDL_IDLBridge::SetVar

The IDL_IDLBridge::SetVar function copies the value of a variable from the parent IDL process to the $MAIN$ level of the child process under the given name. IDL_IDLBridge::SetVar is subject to the following limitations:

  • Only scalar or array variables of numeric or string type can be transferred. Structures, pointers, and object references cannot be transferred between processes using the IDL_IDLBridge object.
  • IDL_IDLBridge::SetVar makes a copy of the data in the child process, which may affect the performance of your application if the amount of data involved is large. In such cases, the use of shared data files or shared memory (SHMMAP and SHMVAR) may offer a more efficient way to share data.

Note: It is not possible to call GetVar or SetVar when a child process is actively executing a command (when IDL_IDLBridge::Status equals 1).

Syntax


Obj->[IDL_IDLBridge::]SetVar, Name, Value

Arguments


Name

A string containing the name of the variable to be set in the child process.

Value

A scalar or array variable of string or numeric type containing the data to be copied to the child process.

Keywords


None

Examples


The following example accesses image data from a JPEG file and passes it to a child process using SetVar.

mriFile= FILEPATH('pdthorax124.jpg', $
   SUBDIRECTORY = ['examples', 'data'])
READ_JPEG, mriFile, mriImg
 
; Create an IDL_IDLBridge object. Pass the image data (mriImg) to
; the child process in a variable named "image." Display the 
; image data in a child process.
oBridge = OBJ_NEW("IDL_IDLBridge")
oBridge->SetVar, "image", mriImg
oBridge->Execute, "TVSCL, image"

Note: See Examples for additional examples.

Version History


6.3

Introduced



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us