リスナーでの作業中、リスナーのログ機能を使って入力したテキストや出力された結果をすべてテキスト ファイルに取り込むことができます。
いずれかのペインに入力されたテキストと出力ペインに出力された内容だけがキャプチャされます。
ここで、 <filename_string> は、文字列として評価される文字列リテラルや式であり、作成されるログ ファイル名を指定します。
既定のモード( mode:"w" )では、新規ファイルを作成するか、既存ファイルを上書きします。
既存のファイルにログの結果を追加するには、 mode:"a" を指定します。
指定されたファイルが存在しない場合は、エラー メッセージが生成されます。
既定では、入出力の両方がログされます。MAXScript 出力だけをログ処理するには、 outputOnly:true を指定します。
これは、MAXScript 出力だけをファイル my_log.txt に追加します。
ログ ファイルが既に開いている場合は、 openlog() メソッドでそのログ ファイルを閉じます。
MAXScript は、ログ処理が停止されるまで、リスナー アクティビティが発生するたびにログ ファイルへの書き込みを続けます。
ログ ファイル データは、連続してファイルに書き込まれるのではなく、メモリ内のバッファにログ データが書き込まれ、そのバッファがデータで満たされるとファイルに書き込まれます。
ログのバッファをフラッシュして、すべての出力がファイルに書き込まれるようにするには、 flushLog() メソッドを使用します。
ログ処理を停止してログのバッファをフラッシュし、ログ ファイルを閉じるには、 closeLog() メソッドを使用します。
開いているログ ファイルがないときに flushLog() または closeLog() メソッドが呼び出されても、エラー メッセージは生成されません。