Normally, IDL system routines that reside in dynamically loadable modules (DLMs) are automatically loaded on demand when a routine from a DLM is called. The DLM_LOAD procedure can be used to explicitly cause the code within the .dll or .so file to be loaded.

Examples

---

Force the JPEG DLM to be loaded:

DLM_LOAD, 'jpeg'

IDL prints:

% Loaded DLM: JPEG.

Manually load a DLM file that is not on !DLM_PATH:

DLM_LOAD, '/users/myname/mycode.dlm'

IDL prints:

% Loaded DLM: MYCODE.

Syntax

---

DLM_LOAD, Name₁ [, Name₂,..., Name_n]

Arguments

---

Name_n

A string giving the DLM module name or the full filepath to a .dlm file.

Note: In order to use the DLM module name, the DLM must exist within one of the directories on !DLM_PATH (or you can use DLM_REGISTER to manually register a DLM).

Keywords

---

None

Version History

---

5.1	Introduced
8.3	Allow a full filepath to the DLM file

See Also

---

DLM_REGISTER, !DLM_PATH environment variable, IDL_DLM_PATH preference, Dynamically Loadable Modules