createPreview メソッド

プレビュー アニメーションを作成し、必要に応じて[プレビューを作成](Make Preview)ダイアログで使用できるオプションにアクセスできるようにします。

createPreview filename:<string> outputAVI:<boolean> percentSize:<int> \
start:<int> end:<int> skip:<int> fps:<int> \
dspGeometry:<boolean> dspShapes:<boolean> dspLights:<boolean> \
dspCameras:<boolean> dspHelpers:<boolean> dspSpaceWarps:<boolean> dspParticles:<boolean> \
dspBones:<boolean> dspGrid:<boolean> dspSafeFrame:<boolean> dspFrameNums:<boolean> \ 
dspBkg:<boolean> rndLevel:<#smoothhighlights | #smooth | #facethighlights \ 
| #facet | #flat | #hiddenline | #litwireframe | #wireframe | #box> \
useMPCamEffect:<boolean> snippet:<string> \
dspCamViewName:<boolean> autoPlay:<boolean> \
vpPreset:<#highquality | #standard | #performance | #dxmode | #userdefined> \
vpStyle:<#defaultshading | #facets | #flatcolor | #hiddenline | #wireframe | #boundingbox | #ink | #colorink | #acrylic | #tech | #graphite | #colorpencil | #pastel | #clay | #modelassist> 
vpEdgedFaces:<boolean> vpTextures:<boolean>

[プレビューを作成](Make Preview)ダイアログ ボックスでの最後の設定、または指定されている場合にはオプションの引数を使用して、プレビュー アニメーション シーケンスを作成します。

• filename: 指定した場合、出力はこのパスと名前が付いたファイルに保存されます。指定しない場合は、既定の「_preview」名と #preview システム ディレクトリのパスが使用されます。
• outputAvi: true の場合は、最後に選択した CODEC により AVI ファイルに出力します。false の場合は、カスタム ファイル シーケンスに出力します。
• percentSize: 現在の renderWidth および renderHeight 値のパーセンテージでプレビュー出力サイズを定義します。
• start: プレビュー アニメーションの最初のフレームを定義します。
• end: プレビュー アニメーションの最後のフレームを定義します。
• skip: プレビュー アニメーションの N 番目ごとのフレーム ステップを定義します。[プレビューを作成](Make Preview)ダイアログ ボックスの[フレーム間隔](Every Nth Frame)に対応します。
• fps: プレビュー アニメーションのフレーム レートを定義します。
• dspGeometry: プレビュー アニメーションでのジオメトリ オブジェクトの表示をコントロールします(パーティクルやボーンのような他のフラグによって処理されるオブジェクトを除く)。
• dspShapes: プレビュー アニメーションでのシェイプ オブジェクトの表示をコントロールします。
• dspLights: プレビュー アニメーションでのライト オブジェクトの表示をコントロールします。これは、ライト オブジェクトのイルミネーションではなく、ビューポート可視性に適用されます - ライトは、非表示の場合でもシーンを照明で照らします。
• dspCameras: プレビュー アニメーションでのカメラ オブジェクトの表示をコントロールします。
• dspHelpers: プレビュー アニメーションでのヘルパー オブジェクトの表示をコントロールします。
• dspParticles: プレビュー アニメーションでのパーティクル オブジェクトの表示をコントロールします。
• dspBones: プレビュー アニメーションでのボーン オブジェクトの表示をコントロールします。
• dspGrid: プレビュー アニメーションでのカスタム グリッドのホームの表示をコントロールします。
• dspSafeFrame: プレビュー アニメーションでのセーフ フレームの表示をコントロールします。
• dspFrameNums: プレビュー アニメーションでのフレーム数カウンターの表示をコントロールします。
• dspBkg: プレビュー アニメーションでのビューポート バックグラウンドの表示をコントロールします。
• rndLevel: Direct3D ドライバを使用しているときのレンダリング レベルをコントロールします。Nitrous を使用している場合は、指定した vpPreset および vpStyle オプションが使用されます(以下を参照)。
• useMPCamEffect: プレビュー アニメーションでマルチパス カメラ効果を実行するかどうかをコントロールします。true に設定されていて、マルチパス カメラ効果が定義されたカメラ ビューが現在のビューポートになっている場合は、その効果が評価されます。3ds Max 2021.1 Update 以降で使用可能です。
• dspSpaceWarps: プレビュー アニメーションでのスペース ワープ ヘルパー オブジェクトの表示をコントロールします。
• snippet 各フレームで実行する MAXScript コードのスニペットを指定します。スニペットによって返される文字列がレンダリング出力に表示されます。

次に示すオプションは、3ds Max 2024 の新機能です。

• dspCamViewName プレビュー アニメーションでのカメラまたはビューポート名の表示をコントロールします。既定値は true です。
• autoPlay:プレビューの作成が完了したときに、アニメーションを自動的に再生するかどうかをコントロールします。既定値は true です。
• vpPreset:アクティブなビューポートに適用されるビューごとのプリセットをコントロールします。既定値は、現在アクティブなビューポート プリセットです。
• vpStyle: アクティブなビューポートに適用されるビューポート スタイルをコントロールします。既定値は、アクティブなビューポートの現在のスタイルです。
• vpEdgedFaces: プレビュー アニメーションでのエッジ面の表示をコントロールします。既定値は true です。
• vpTextures: プレビュー アニメーションでのテクスチャの表示をコントロールします。既定値は false です。