General, Input-Output, System

Loader is an easy to use dynamic loading system for Quest3D. It can scan a whole directorytree including subdirectories and load all found files into a Quest3D project. The whole loadingprogress is tracked and can be retrieved for each directory or as an overall loading progress for all directories.

Use Loader to setup your whole application-loading or use it to load objectlibraries, characters, or anything else you wish to be organised in folders and subfolders on your harddisk and in your Quest3D project.

Note:
There is also an non-OO-version of Loader for Quest3D version 3.6.6 available.
Loader does not work in an online project, since it performs a directoryscan, which is not possible on a webserver with Quest3D.

IMPORTANT:
There is a Quest3D 4.1.2 Bug in the Project Tree! If you remove groups from your project, they sometimes remain in the Project Tree tab. If you try to click on such a (already removed) channelgroup, Quest3D crashes. This bug appears not in the Group Tree tab.

Use the following commands to control Loader:

# getProgress
This function returns the overallprogress of the loadingqueue.
If you want to get the progress of a certain label read the array.

# addDirectory
Trigger this command to add a directory (or a whole directorytree) to the loadingqueue.
Parameter:
--Directory:
If absolutePath is set to 0 use only directoryname (for example \\\\\\\\\\\\\\\"mydirectory\\\\\\\\\\\\\\\")
--> has to be a subdirectory of the directory which contains Loader_Add.cgr
If absolutePath is set to 1 then use an absolute path (for example \\\\\\\\\\\\\\\"c:\\\\\\\\\\\\\\\\mypath\\\\\\\\\\\\\\\\mydirectory\\\\\\\\\\\\\\\")
--Label:
Each loading-job has to get an unique label. If the given label already exists in the loadingqueue,
the loading-job is ignored. Use the label to identify your directories.
--includeSubdirectories:
If set to 1, all subdirectories of the given directory are included.
--absolutePath:
see Directory

# reloadDirectory
All files loaded with ?Add? can be reloaded again. This is usefull, if you want to reset your application while debugging your project. Use the label (defined with \\\\\\\\\\\\\\\"addDirectory\\\\\\\\\\\\\\\") to reload a certain directory.

# removeDirectory
This command removes a given directory from your project. Use the label (defined with \\\\\\\\\\\\\\\"addDirectory\\\\\\\\\\\\\\\") to remove a certain directory.

# reloadAll
This command reloads all files from all directories.

# removeAll
This command removes all files from all directories.

comments:

Comment on this template