Purpose

The module LoadAny is a multi purpose loader which automatically tries to use an appropriate loader for a selected file.

It has different options and strategies to analyze file headers or to select or check loaders.

Usage

Select a file name in the field Name and LoadAny will try to open the file automatically.

If this does not succeed, check the flags and options Allow BioFormatsLoad, Use header analysis, Try Typical Loaders, and Try All Loaders to open the file or to find appropriate loaders.

Windows

Default Panel

../../../Modules/Macros/FileHandling/mhelp/Images/Screenshots/LoadAny._default.png

Output Fields

outImage

name: outImage, type: Image

outBase

name: outBase, type: MLBase

outInventor

name: outInventor, type: SoNode

Parameter Fields

Field Index

Allow BioFormatsLoad: Bool Loader: String Try Typical Loaders: Trigger
Clear Console: Trigger Name: String Use header analysis: Bool
Close: Trigger Short Header: String Verbose: Bool
File Header: String Show Advanced Controls: Bool Writers: String
Format Info: String Status: String  
formatGuess: String Text Out: String  
Load: Trigger True Name: String  
Load With First Working Loader: Trigger Try All Loaders: Trigger  

Visible Fields

Name

name: name, type: String

Sets the file name to be loaded, perhaps with variables which still have to be resolved.

True Name

name: trueName, type: String, persistent: no

Shows the internally used path to the loaded file.

Clear Console

name: clearConsole, type: Trigger

If pressed, the current status output is cleared.

Load With First Working Loader

name: loadWithFirstWorkingLoader, type: Trigger

Try Load, then Try Typical Loaders and lastly Try All Loaders unless any of the previous action yielded a success. Use this trigger if you want to make sure a file is loaded if possible (usually preferable to Try All Loaders since the latter might ignore the obvious choices).

Load

name: load, type: Trigger

Load, reload or retry to load the specified file.

Try Typical Loaders

name: tryTypicalLoaders, type: Trigger

Try to open the file with the most common loaders while passing - but not analyzing - the file extension.

Warning: This option is can be time consuming and instable because the file will be inappropriate for most loaders.

Try All Loaders

name: tryAllLoaders, type: Trigger

Try to open the file with all loaders while passing - but not analyzing - the file extension.

Warning: This option is can be time consuming and instable because the file will be inappropriate for most loaders.

Verbose

name: verbose, type: Bool, default: FALSE

Much more information is listed in the console if this check box is enabled.

Use header analysis

name: analyzeHeader, type: Bool, default: TRUE

Enables a heuristic to identify file formats correctly, e.g. if no or only a number is available as file extensions.

Allow BioFormatsLoad

name: allowBioFormats, type: Bool, default: FALSE

If this flag is on and the module exists then the BioFormatsLoad module is also used for data loading.

Close

name: close, type: Trigger

Closes a currently open file.

Text Out

name: textOut, type: String, persistent: no

Output field for loaders which do not load files but single information such as strings.

Loader

name: loaderName, type: String, persistent: no

Module used to open the file.

Writers

name: writerNames, type: String, persistent: no

Module(s) which could be used to save the file.

Format Info

name: formatInfo, type: String, persistent: no

Shows information about the format of the opened file.

Short Header

name: shortFileHeader, type: String, persistent: no

First 48 (or less if null-chars are found) characters from the file.

File Header

name: fileHeader, type: String, persistent: no

First 1K characters of the file.

Status

name: status, type: String, persistent: no

Shows general information, notes, errors, etc. about the load process.

Show Advanced Controls

name: showAdvancedControls, type: Bool, persistent: no

Hidden Fields

formatGuess

name: formatGuess, type: String, persistent: no