ログシステム

システムグローバル:

<filename>logsystem.getNetLogFileName()

現在のログファイル名を返します。

例:

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

logsystem.longevity SystemGlobal:longevity default:#size

ログファイルの寿命モードを取得/設定します。3ds Max 2017 以降で使用可能です。

この設定は、[カスタマイズ] (Customize) > [基本設定] (Preferences) > [ファイル] (File) > [ログファイルメンテナンス](Log File Maintenance)ラジオボタンの状態に対応しています。

有効な値は次のとおりです。

#forever : ログエントリを永久に保持して、logsystem.logSize と logsystem.logDays を両方無視します。
#days : logsystem.logDays 値を使用します。
#size (既定値): logsystem.logSize 値を使用します。

logsystem.logDays SystemGlobal:logDays default:30

ログファイルのエントリを保持する日数を取得/設定します。[カスタマイズ] (Customize) > [基本設定] (Preferences) > [ファイル] (Files) > [ログファイルメンテナンス](Log File Maintenance) > [日数によって管理](Maintain only XX Days)オプションに対応しています。3ds Max 2017 以降で使用可能です。

logsystem.longevity が #days に設定されている場合に使用します。

logsystem.logSize SystemGlobal:logSize default:256

保持するログファイルの最大サイズをキロバイトで取得/設定します。[カスタマイズ] (Customize) > [基本設定] (Preferences) > [ファイル] (Files) > [ログファイルメンテナンス](Log File Maintenance) > [サイズによって管理](Maintain only XX Kbytes)オプションに対応しています。3ds Max 2017 以降で使用可能です。

logsystem.longevity が既定値モードの #size に設定されている場合に使用します。

メソッド:

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

さまざまなタイプのキーワードパラメータ、または列挙値に応じて、文字列をログファイルに出力します。

使用可能な列挙値は #error、#warning、#info、#debug です。3ds Max 2017.1 Update 以降で使用可能です。

既定値は debug:true、info:false、warning:false、error:false です。

このログファイルの出力は[基本設定](Preference Settings)ダイアログ内、[ファイル] (Files)タブの設定によってフィルタされます。

例:

    logsystem.logEntry "My Warning Message" warning:true
    logsystem.logEntry "My Warning Message" #warning

<filename>logsystem.logName <filename>

追加ログファイルを指定されたファイル名に設定します。このログファイルは永続しません。このログファイルは、logsystem.getNetLogFileName() (以下)を通してアクセスできる標準ログファイルに追加されます。

ログファイルが正常に作成された場合、新しいログ名が返されます。

新しいファイルの作成に失敗した場合、現在のログファイル名が返されます。

指定したファイル名が既に存在する場合は、内容が上書きされます。

3ds Max 9 以降で使用可能です。

例:

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

logsystem.setLogLevel debug:<boolean> info:<boolean> warning:<boolean> error:<boolean>
logsystem.setLogLevel <#error | #warning | #info | #debug> <boolean>

指定したロギングレベルをオンまたはオフに設定します。ログレベルを指定しない場合は、既存の設定が維持されます。 3ds Max 2017.1 Update 以降で使用可能です。

例:

    logsystem.setLogLevel error:true warning:true info:false debug:false
    logsystem.setLogLevel #debug false

<filename>logsystem.getLogLevel <#error | #warning | #info | #debug>

指定したロギングレベルのステータス(オンまたはオフ)を取得します。3ds Max 2017.1 Update 以降で使用可能です。

例:

    errorLoggingEnabled = logsystem.getLogLevel #error

<filename>logsystem.saveState()

ログシステムの基本設定の状態を保存します。通常、logsystem.longevity などのログシステムの設定を変更すると、現在の 3ds Max セッションのみが影響を受けます。 3ds Max 2017 以降で使用可能です。

この関数を呼び出すと、変更がコミットされて 3ds Max セッション間で固定されます。

logsystem.loadState()

以前に保存したログシステムの基本設定を読み込みます。

3ds Max 2020 以降で使用可能です。

logsystem.enabled default:true

このプロパティは、ログシステムが有効かどうかを取得または設定します。false の場合、ログシステムからログファイルに保存される出力はありません。

3ds Max 2020 以降で使用可能です。

logsystem.quietMode default:false

エラーログ抑制モードが有効であるかどうかを取得/設定します。

この変数はブール値で、true に設定すると、レンダラーからのメッセージを表示するダイアログボックスが開きません。

false に設定すると、レンダラーからのエラーメッセージを表示するダイアログボックスが開きます。

ネットワークレンダリングの実行中は、対応する内部変数が 3ds Max によって true に設定され、「マップがありません」や「マップ座標がありません」というエラーメッセージが表示されません。

この変数を true に設定すると、レンダラーはエラーメッセージを生成して終了します。

抑制モードが有効に設定されていると、ユーザはレンダラーからのエラーメッセージを確認できません。抑制モードを終了したら、必ず抑制モードを無効にしてください。

ログ システム

ログシステム