Log System

System Globals:

logsystem.quietMode SystemGlobal:quietMode default:false

Lets you get and set whether error logging quiet mode is enabled.

A Boolean value set to true when you do not want error messages from the renderer to bring up dialog boxes.

If set to false , error messages from the renderer will bring up dialog boxes.

3ds Max sets the corresponding internal variable to true during network rendering to suppress error messages such as the "Missing Maps" and "Missing Map Coordinates" dialogs.

If this variable is set to true and the renderer generates an error message, the renderer will exit.

After setting quiet mode, do not forget to clear it when you are done, since the user will not see any error messages from the renderer while quiet mode is enabled.

logsystem.longevity SystemGlobal:longevity default:#size

NEW in 3ds Max 2017: Gets/sets the log file longevity mode.

This setting corresponds to the Customize > Preferences > Files > “Log File Maintenance” radio buttons state.

Possible values are:

• #forever : Keep the log entries forever, ignore both logsystem.logSize and logsystem.logDays
• #days : Use the logsystem.logDays value
• #size (default): Use the logsystem.logSize value

logsystem.logDays SystemGlobal:logDays default:30

NEW in 3ds Max 2017: Gets/sets the number of days to keep the log file entries. Corresponds to the Customize > Preferences > Files > Log File Maintenance > “Maintain only XX Days” option.

Used when logsystem.longevity is set to #days.

logsystem.logSize SystemGlobal:logSize default:256

NEW in 3ds Max 2017: Gets/sets the maximum log file size in Kilobytes to keep. Corresponds to the Customize > Preferences > Files > Log File Maintenance > “Maintain only XX Kbytes” option.

Used when logsystem.longevity is set to #size, which is the default mode.

Methods:

logsystem.logEntry <string> [debug:<bool>] [info:<bool>] [warning:<bool>] [error:<bool>]

Outputs the string to the log file, based on the various type keyword parameters.

Default values are: debug:true, info:false, warning:false, error:false

Output to the log file is filtered by the settings in the Preference Settings dialog, Files tab.

<filename>logsystem.logName <filename>

Sets the log file to the given filename.

If the log file was created successfully, returns the new log name.

If the new file creation failed, returns the current log file name.

Available in 3ds Max 9 and higher.

logsystem.logName "c:\\extra.log"
"c:\extra.log"
logsystem.logName "z:\\extra.log" --Z: does not exist, keeps old log
"c:\extra.log"

<filename>logsystem.getNetLogFileName() 

Returns the current log filename.

logsystem.getNetLogFileName()
"C:\Users\Garfield\AppData\Local\Autodesk\3dsMax\2017 - 64bit\ENU\Network\Max.log"

<filename>logsystem.saveState() 

NEW in 3ds Max 2017: Saves the state of the log system preferences. Normally, changing the log system settings like logsystem.longevity will only affect the current 3ds Max session.

Calling this function will commit the changes to stick between 3ds Max sessions.