Environment Variables: Aliasstudio 2008
Environment Variables: Aliasstudio 2008
AliasStudio 2008
Contents
Environment variables 1
About environment variables 2
Index 15
ENVIRONMENT
VARIABLES
Describes environment variables that affect the startup and operation of AliasStudio.
Environment variables
ABOUT
ENVIRONMENT VARIABLES
Before using AliasStudio, you may want to set environment variables to specify directories in which AliasStudio searches for data files or to set specific AliasStudio behavior.
Environment variables
Where variables have been tested on Windows, compatibility is indicated. Other environment variables may or may not work on Windows.
Environment variables
VARIABLE
DESCRIPTIONS
Environment variables
Exit AliasStudio if it is currently running. Set the ALIAS_ALT_HELP environment variable to the location that you copied the online documentation to.
If ALIAS_ALT_HELP is not set, AliasStudio uses the registry value created when documentation was installed from CD. Platform Windows Procedure
1
In the Start > Settings > Control Panel > System window, select the Environment tab. In the Variable field, type:
ALIAS_ALT_HELP
2 3
In the Value field, type the directory path to the online documentation, (for example, D:\OnlineDocs). Click OK.
4 5
Restart AliasStudio.
ALIAS_APP_PROJECT Overrides the CURRENT_PROJECT defined in the .AliasBrowserPrefs and defines the project that AliasStudio will start-up in. Parameters: a valid project file name, which is a directory name in user_data (not including dumpster) containing all needed subdirectories. Default: none Windows compatibility: Yes
Environment variables
ALIAS_BITMAP_LOCATION The location where more icon images can be found. Parameters: a valid path to a directory Default: .Alias/bitmaps Windows compatibility: Yes Default for Windows: %ALIAS_LOCATION%\bitmaps ALIAS_FORCE_DEFAULT_ENVIRON Sets a default environment in AliasStudio upon start-up. AliasStudio loads files from the distribution area. ALIAS_HPGL_CFG The location of the plotter configuration file hp_gl.cfg. Parameters: a valid path to a file Default: $ALIAS_LOCATION/sys/install/hp_gl.cfg Windows compatibility: Yes ALIAS_LICENSE Sets your system to automatically invoke a particular AliasStudio product. Use this variable only if you understand licensing and are sure you dont want access to any other products. Parameters: st (Studio), as (AutoStudio), ss (SurfaceStudio), ds (DesignStudio) To disable this variable for Windows:
From Start > Settings > Control Panel > System, click on the Environment tab. Look for the ALIAS_LICENSE variable. If you see that it is set, delete it by highlighting it and clicking the Delete button.
ALIAS_LOCATION The path that AliasStudio will use to resolve references to resource files required by the AliasStudio executable, such as DSO library files and scheme files. Parameters: a valid path to a directory Default: $AW_LOCATION/alias Windows compatibility: In Windows, the environment variable is automatically set by AliasStudio while it is being executed, and it points to the directory one level above the bin directory where the AliasStudio executables and .dll files are found. Even if you explicitly set this environment variable, it is ignored. ALIAS_LOGO Overrides the Standard AliasStudio Splash screen with an alternate image (specified by the absolute path to the image). Parameters: a valid path to a file Default: none
Environment variables
Windows compatibility: Yes ALIAS_PREFS_LOCATION Location of Alias Preference files. Parameters: a valid path Default: C:Documents and Settings\[userid]\Application Data\Autodesk\AliasStudio\UserPrefs [version no.] The preferences files can be set to something other than the default, which is useful if:
a user wants common preferences across several machines all user preferences for a design work group are stored in a common location a user stores preferences on a USB flash (keychain) drive.
ALIAS_WORKENV The location that becomes the current working directory on execution of AliasStudio (that is, the directory above the user_data directory that the user wishes to use with AliasStudio). Parameters: a valid path to a directory Default: C:\Documents and Settings\[userid]\My Documents
Environment variables
Environment variables
Windows default: .\ ALIAS_REFLECTION_ONLY Sets all reflection-only objects visible for reflection rays only. Used for raytracer/powertracer only, when the reflection-only tag is set on (under render stats). Parameters: none Default: OFF (all reflection-only objects are visible for reflection and refraction rays) Windows compatibility: Yes ALIAS_REMOTE_LOCATION When rendering remotely from AliasStudio (i.e. launching the renderer on a different machine), AliasStudio assumes that the renderer will be found in the default installation directory on that machine. If it has been installed elsewhere, set the ALIAS_REMOTE_LOCATION variable on the local machine to the same value as the ALIAS_LOCATION variable on the remote machine. Parameters: a valid path to a directory For example: ALIAS_REMOTE_LOCATION Default: none
/my/custom/install/directory
ALIAS_RENDER_LOAD_TIMEOUT The ALIAS_RENDER_LOAD_TIMEOUT environment variable can be used to increase the amount of time that Studio will wait to communicate with the Studio renderers. Under normal circumstances the renderer will load within the default timeout period and this environment variable is not necessary. In cases where the renderer takes more than 20 seconds to load it is recommended that this variable be set to a larger value. If the Studio renderer is unable to load within the timeout period, the following error will be written to the Studio errlog:
"Timed out waiting for renderer to connect with Studio."
This behavior is rare and is usually caused by one of the following: Slow CPU Slow hard drive or controller Heavily fragmented hard drive The value for ALIAS_RENDER_LOAD_TIMEOUT is measured in seconds. Example:ALIAS_RENDER_LOAD_TIMEOUT=120 will cause Studio to wait two minutes before giving up on an attempt to communicate with the renderer.
Environment variables
ALIAS_RT_BACKGROUND_ON Sets reflection and refraction rays which do not hit anything to return either the background color or black (during ray tracing only). Parameters: 1 0 reflection and refraction rays which hit nothing return the background color reflection and refraction rays which hit nothing return black Default: refraction rays return the background color; reflection rays return black Windows compatibility: Yes ALIAS_RT_SHADOW_OFFSET Sets the shadow offset to be used during ray tracing (to avoid selfshadowing). Parameters: a floating point value Default: 0.0 Windows compatibility: Yes ALIAS_SDL_LONGFORM Allows many more comments to be included in the SDL file. The quantity of comments was reduced to make SDL files smaller as of V7.0. Parameters: none Default: OFF when undefined Windows compatibility: Yes ALIAS_SHADOW_FARCLIP Sets the far clipping plane of the shadow map. Use only when light fog (and resulting shadows) is shone into the distance. Parameters: a floating point value Default: OFF Windows compatibility: Yes ALIAS_SWITCH_SCANLINES_ EVEN_ODD_SENSE Causes field rendered images to be constructed in the format that Composer expects, versus the (now obsolete) format that the old Alias video output facility expected (the default). Parameters: none Default: OFF Windows compatibility: Yes
10
Environment variables
ALIAS_V90_REFRACTION Makes refractions appear as they did in AliasStudio 9.0. This can sometimes result in rays prematurely exiting a chunky refractive object (for example, a diamond) and the incorrect appearance of refractions. Parameters: none Default: OFF Windows compatibility: Yes ALIAS_V5_USE_BACKGROUND Adds lighting on top of a use-background colored surface. Parameters: none Default: OFF Windows compatibility: Yes FIXED_DISPLACEMENT Sets displacement mapping to ignore the magnitude of the tangents, and displace the geometry a fixed distance from the original surface regardless of deformation or parameterization of the original surface. Parameters: none Default: OFF Windows compatibility: Yes SEPARATE_GLOW_FILES Writes an image <pixfilename>.glow that contains only the glow aspects. Parameters: none Default: OFF Windows compatibility: Yes
Environment variables
11
ALIAS_PLOTTER_LIST The list of plotters/printers to be listed in the Plot SetUp window. If you have many plotters/printers on your network, you may want to limit the number of plotters/printers listed in the Plot SetUp window. Example: setenv ALIAS_PLOTTER_LIST plotter1:plotter2 ALIAS_PLOT_INIT The plotters initialization string, placed at the beginning of the HPGL2 files if wanted. Parameters: the plotters initialization string Default: <ESC %-1BBPIN (<ESC is the escape key for HPGL2; its hex value is 0x1b) ALIAS_PSPLOT_INIT Inserts Postscript commands just after the Postscript initialization in the Postscript file generated by the plot command. A knowledge of Postscript commands is necessary to use this variable. See also ALIAS_PLOT_INIT. Parameters: strings of Postscript commands Default: no Postscript commands are inserted
12
Environment variables
ALIAS_PSPLOT_INIT2 Inserts Postscript commands just after the viewport commands in the Postscript file generated by the plot command. A knowledge of Postscript commands is necessary to use this variable. Parameters: strings of Postscript commands Default: no Postscript commands are inserted XAPPLRESDIR (X Windows) The location used by X (the window system) to search for resource files set by a user to override the defaults. Parameters: a valid path to a directory Example of a valid path: ~bob/lib/X11/app-defaults Default: none
Environment variables
13
14
Environment variables
Index
A
adding environment variables Windows 3 ALIAS_ALT_FONTDIR environment variable 5 ALIAS_APP_PROJECT environment variable 5 ALIAS_BITMAP_LOCATION environment variable 6 ALIAS_FORCE_DEFAULT_E NVIRON environment variable 6 ALIAS_HIDDEN_CASTS_SH ADOWS environment variable 8 ALIAS_HPGL_CFG environment variable 6 ALIAS_ILLUMINATED_SHA DOWS_ONLY environment variable 8 ALIAS_INPUT_RGB_PROFIL E environment variable 12 ALIAS_LICENSE environment variable 6 ALIAS_LOCATION environment variable 6 ALIAS_LOGO (UNIX only) environment variable 6 ALIAS_MAX_TS_PROCESSO RS environment variable 8 ALIAS_MULTI_JITTER environment variable 8 ALIAS_OCRPATH environment variable 8 ALIAS_OUTPUT_CMYK_PRO FILE environment variable 12 ALIAS_PLOT_INIT environment variable 12 ALIAS_PLOTTER_LIST (all platforms) environment variable 12 ALIAS_PSPLOT_INIT environment variable 12 ALIAS_PSPLOT_INIT2 environmental variable 13 ALIAS_REFLECTION_ONLY environment variable 9 ALIAS_RT_SHADOW_OFFSE T environment variable 10 ALIAS_SDL_LONGFORM environment variable 10 ALIAS_SHADOW_FARCLIP environment variable 10 ALIAS_SWITCH_SCANLINE S_ EVEN_ODD_SENSE environment variable 10 ALIAS_V5_USE_BACKGROU ND environment variable 11 ALIAS_V90_REFRACTION environment variables 11 ALIAS_WORKENV environment variable 7
R
removing environment variables Windows 3 rendering ALIAS_HIDDEN_CASTS_SH ADOWS 8 ALIAS_ILLUMINATED_SH ADOWS_ONLY 8 ALIAS_MAX_TS_PROCESSO RS 8 ALIAS_MULTI_JITTER 8 ALIAS_OCRPATH 8 ALIAS_REFLECTION_ONLY 9 ALIAS_RT_SHADOW_OFFS ET 10 ALIAS_SDL_LONGFORM 1 0 ALIAS_SHADOW_FARCLIP 10 ALIAS_SWITCH_SCANLINE S_ EVEN_ODD_SENSE 10 ALIAS_V5_USE_BACKGRO UND 11 ALIAS_V90_REFRACTION 1 1 FIXED_DISPLACEMENT 11 SEPARATE_GLOW_FILES 1 1
F
FIXED_DISPLACEMENT environment variable 11
S
SEPARATE_GLOW_FILES environment variable 11
P
plotting ALIAS_PLOT_INIT 12 ALIAS_PLOTTER_LIST (all platforms) 12 ALIAS_PSPLOT_INIT 12 ALIAS_PSPLOT_INIT2 13
X
XAPPLRESDIR (X Windows, UNIX only) environment variable 13