The following methods allow you to access the 3ds Max system directories:
GetDir <filetype_name>
Returns as a string the directory specified in the Customize > Configure Paths dialog for the specified file type.
The valid <filetype_name>
values are:
Value | Available in 3ds Max Versions | US English Defaults And Notes |
---|---|---|
#systemImage |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\sceneassets\images |
#systemPhotometric |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\sceneassets\photometric |
#systemSound |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\sceneassets\sounds |
#macroScripts |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\macroScripts |
#web |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\web |
#maxSysIcons |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\ui_ln\icons |
#pageFile |
3ds Max 2017 | C:\Users<UserName>\AppData\Local\Autodesk\3dsMax<ReleaseNumber> - 64bit\ENU\temp` |
#hardwareShadersCache |
3ds Max 2017 | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\en-US\plugcfg |
#plugcfg_ln |
3ds Max 2017 | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\plugcfg_ln |
#ui_ln |
3ds Max 2017 | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\ui_ln |
#autodeskcloud |
3ds Max 2017 | C:\Users<UserName>\AppData\Local\Autodesk\Autodesk Sync\Cloud<a360 UserName> |
#privateExchangeStoreInstallPath |
3ds Max 2017 | C:\Users\<UserName>\AppData\Roaming\Autodesk\ApplicationPlugins\ |
#publicExchangeStoreInstallPath |
3ds Max 2017 | C:\ProgramData\Autodesk\ApplicationPlugins\ |
#userStartupTemplates |
3ds Max 2017 | C:\Users\<UserName>\Documents\3dsMax\startuptemplates |
#animations |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\sceneassets\animations |
#archives |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\archives |
#autoback |
All versions | C:\Users\<UserName>\Documents\3dsMax\autoback |
#autodeskCloud |
3ds Max 2014 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\Autodesk Sync\Cloud\<LoginName> Returns empty string `` if the user is not logged in Autodesk 360. |
#defaults |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\en-US\defaults\MAX |
#downloads |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\downloads |
#drivers |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\drivers |
#export |
All versions | C:\Users\<UserName>\Documents\3dsMax\export |
#font |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\fonts |
#help |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\help |
#image |
All versions | C:\Users\<UserName>\Documents\3dsMax\sceneassets\images |
#import |
All versions | C:\Users\<UserName>\Documents\3dsMax\import |
#matlib |
All versions | C:\Users\<UserName>\Documents\3dsMax\materiallibraries |
#maxData |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\ |
#maxroot |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\ |
#maxstart |
All versions | C:\Users\<UserName>\Documents\3dsMax\scenes |
#pageFile |
3ds Max 2010 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\temp |
#photometric |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\sceneassets\photometric |
#plugcfg |
All versions | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\en-US\plugcfg |
#preview |
All versions | C:\Users\<UserName>\Documents\3dsMax\previews |
#presets |
3ds Max 2022 and higher | Default system particle flow presets. For internal use only. |
#proxies |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\proxies |
#renderassets |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\sceneassets\renderassets |
#renderPresets |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\renderpresets |
#renderoutput |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\renderoutput |
#scene |
All versions | C:\Users\<UserName>\Documents\3dsMax\scenes |
#scripts |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\scripts |
#sound |
All versions | C:\Users\<UserName>\Documents\3dsMax\sceneassets\sounds |
#startupScripts |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\scripts\startup |
#temp |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\temp |
#ui |
All versions | C:\Program Files\Autodesk\3ds Max <ReleaseNumber>\en-US\UI\ |
#userMacros |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\usermacros |
#userScripts |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\scripts |
#userStartupScripts |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\scripts\startup |
#userIcons |
3ds Max 9 and higher | C:\Users\<UserName>\AppData\Local\Autodesk\3dsMax\<ReleaseNumber> - 64bit\ENU\usericons |
#vpost |
3ds Max 9 and higher | C:\Users\<UserName>\Documents\3dsMax\vpost |
SetDir <filetype_name> <string>
Sets the directory specified in string. Replicated in the Customize > Configure Paths dialog for the specified file type.
The valid <filetype_name>
values are the same as for GetDir
.
Returns true
if successful, false
if not. Does not check to see if <string>
is a valid path. Any change made through this function is immediately reflected in the 3dsmax.ini file and so is persistent. Use with caution.
ConvertDirIDToInt <filetype_name>
Returns an Integer corresponding to the given system directory name.
Available in 3ds Max 9 and higher.
ConvertIntToDirID <integer>
Returns the system directory name that corresponds to the given integer.
Int | Name | Int | Name | Int | Name |
---|---|---|---|---|---|
0 | #font |
19 | #ui |
39 | #ui_ln |
1 | #Scene |
20 | #maxroot |
40 | #autodeskcloud |
2 | #import |
21 | #renderoutput |
41 | #privateExchangeStoreInstallPath |
3 | #Export |
22 | #animations |
42 | #publicExchangeStoreInstallPath |
4 | #help |
23 | #archives |
41 | #privatePluginPackageInstallPath |
5 | #expression |
24 | #Photometric |
42 | #publicPluginPackageInstallPath |
6 | #preview |
25 | #renderassets |
43 | #userStartupTemplates |
7 | #image |
26 | #userScripts |
44 | #systemImage |
8 | #Sound |
27 | #userMacros |
45 | #systemPhotometric |
9 | #plugcfg |
28 | #userStartupScripts |
46 | #systemSound |
10 | #maxstart |
29 | #temp |
47 | #fluidSimulations |
11 | #vpost |
30 | #userIcons |
48 | #userSettings |
12 | #drivers |
31 | #maxData |
49 | #userTools |
13 | #autoback |
33 | #downloads |
50 | #plugindata |
14 | #matlib |
34 | #proxies |
51 | #presets |
15 | #scripts |
35 | #assemblies |
100 | #macroScripts |
16 | #startupScripts |
36 | #pageFile |
101 | #web |
17 | #defaults |
37 | #hardwareShadersCache |
102 | #maxSysIcons |
18 | #renderPresets |
38 | #plugcfg_ln |
The following methods let you get, add or delete Bitmap and XRef paths, corresponding to the Bitmaps and XRefs tabs in the Configure Paths dialog in 3ds Max. Any changes made through these functions are immediately reflected in the 3dsmax.ini file and so are persistent.
mapPaths.add <path_string>
Appends the specified path to the list of Bitmap search paths.
mapPaths.count()
Returns the number of Bitmap search paths defined.
mapPaths.get <index>
Returns the indexed Bitmap search path as a string. The index is 1-based.
mapPaths.delete <index>
Deletes the indexed Bitmap search path. The index is 1-based.
mapPaths.getFullFilePath <filename>
Resolves the filename using map paths, returns fully qualified filename if the file is found. Available in 3ds Max 9 and higher.
FOR EXAMPLE:
mapPaths.getFullFilePath "fir.tga"
xrefPaths.add <path_string>
Appends the specified path to the list of XRef search paths.
xrefPaths.count()
Returns the number of XRef search paths defined.
xrefPaths.get <index>
Returns the indexed XRef search path as a string. The index is 1-based.
xrefPaths.delete <index>
Deletes the indexed XRef search path. The index is 1-based.
xrefPaths.getFullFilePath <filename>
Resolves the filename using xref paths, returns fully qualified filename if the file is found.
Available in 3ds Max 9 and higher.
FOR EXAMPLE:
xrefPaths.getFullFilePath "delme.max"
> ```