CMGUI environment variables

While we used to use a Cmgui file for configuring CMGUI in the past, this X mechanism was only supported by Motif versions. We have not implemented anything new for cross platform configuration and are relying on a few environment variables where options are available but not normally used by users.

Examples:

CMISS_EXAMPLES Specify where the top level of your cmiss examples are found. If this correctly points to a cmiss example tree then you will be able to run cmgui examples with the cmgui -example a/a1 notation.

For the perl interpreter:

CMISS_PERL Specify the perl executable that you want to use the library installation from. CMISS (both cm and CMGUI) try to allow you to use already installed libraries from this executable.

CMISS_PERLLIB Specifies a colon separated list of paths which will be prepended to the list of directories in which to search for Perl library files. This is commonly used to include some standard perl modules related to cmiss and consequently if none of these variables are set and CMISS_ROOT is set then the directory ${CMISS_ROOT}/cmiss_perl/lib is added automatically.

For textures

CMISS_MAX_TEXTURE_SIZE Override the max texture size as specified by OpenGL. This enables you to work around a faulty OpenGL driver, either when the max texture size is smaller or larger that what actually works by you specifying a different value.

CMISS_MAX_3D_TEXTURE_SIZE Override the max 3D texture size as specified by OpenGL. This enables you to work around a faulty OpenGL driver, either when the max texture size is smaller or larger that what actually works by you specifying a different value.