MaterialLibrary 値

値 > コレクション > コレクションのタイプ > MaterialLibrary 値

値とコレクション - クイックナビゲーション

MaterialLibrary は、マテリアルの表を配列として含みます。

3ds Max のシステムグローバル変数 currentMaterialLibrary および sceneMaterials には、MaterialLibrary インスタンスがあります。

システムグローバル変数 meditMaterials は、MaterialLibrary 値ではなく、マテリアルエディタ内のサンプルスロットにおけるマテリアルの仮想配列です。

ほとんどの場合、 meditMaterials は MaterialLibrary 値となりますが、例外として meditMaterials 要素へ、マテリアルや textureMap 値を割り当てることができます。

MaterialLibrary 値はマップ可能です。

コンストラクタ:

currentMaterialLibrary

現在のマテリアルライブラリが含まれたシステムグローバル変数です。

sceneMaterials

シーン内のすべてのマテリアルが含まれたシステムグローバル変数です。

meditMaterials

[マテリアルエディタ](Material Editor)の 24 個のサンプルスロットマテリアルが含まれたシステムグローバル変数です。

materialLibrary { <material> }

一時的なマテリアルライブラリを作成します。 append 関数を使用してこのライブラリにマテリアルを追加したり、このトピックで説明されている saveTempMaterialLibrary 関数および loadTempMaterialLibrary 関数を使用してディスクへの保存およびディスクからのロードを行うことができます。

プロパティ

<mat_lib>.count : Integer, read-only

ライブラリ内のマテリアルの数を返します。

演算子

<mat_lib>[ <integer> | <name> | <string> ]

マテリアルライブラリからマテリアルを取得します。マテリアルライブラリは配列と同様に、整数のインデックス、またはマテリアル名を名前または文字列としてインデックスに使用できます。

<mat_lib>[ <integer> | <name> | <string> ] = ( <material> | <textureMap> )

指定されたマテリアルまたはテクスチャマップをマテリアルライブラリに割り当てます。

マテリアルライブラリは配列と同様に、整数のインデックス、またはマテリアル名を名前または文字列としてインデックスに使用できます。

マテリアルライブラリがインデックス値で指定されていて、そのインデックス値がマテリアルライブラリのサイズより大きい場合、ランタイムエラーが発生します。

マテリアルライブラリがマテリアル名で指定されていて、そのマテリアル名がマテリアルライブラリに存在しない場合、マテリアルまたはテクスチャマップがマテリアルライブラリに追加されます

meditMaterials[<slot_index_integer>]

インデックスで指定されたマテリアルエディタスロットにあるマテリアルまたはテクスチャマップを返します。

<slot_index_integer> の有効な値は 1 ～ 24 です。

meditMaterials[<slot_index_integer>] = ( <material> | <textureMap> )

指定したマテリアルまたはテクスチャマップをインデックス付きマテリアルエディタスロットに割り当てます。

<slot_index_integer> の有効な値は 1 ～ 24 です。

例:

meditMaterials[3]= standard()
--sets the third slot of the Material Editor
--to a new standard material.

メソッド

append <mat_lib> <material>

指定したマテリアルをマテリアルライブラリに追加します。このメソッドは、 meditMaterials マテリアルライブラリには適用されません。

deleteItem <mat_lib> ( <integer> | <name> | <string> )

指定したマテリアルをマテリアルライブラリから削除します。マテリアルは、マテリアルライブラリ内のインデックスされたマテリアル、文字列、または名前として指定できます。このメソッドは、 meditMaterials マテリアルライブラリには適用されません。

findItem <mat_lib> <material>

マテリアルライブラリでのマテリアルのインデックスを返します。マテリアルがマテリアルライブラリにない場合は、ゼロを返します。

関連するメソッド

getMeditMaterial <slot_index_integer>

指定したマテリアルエディタ内のトップレベルのマテリアルまたはテクスチャマップを返します。 <slot_index_integer> の有効な値は 1 ～ 24 です。

例:

theMat = getMeditMaterial 3
--gets the material from the third slot of the Material Editor.

setMeditMaterial <slot_index> ( <material> | <textureMap> )

getMeditMaterial 関数を補完して、番号の付いたマテリアルエディタスロットにマテリアルおよびテクスチャマップを配置できるようにします。

loadDefaultMatLib()

既存の 3ds Max マテリアルライブラリファイルをロードします。

loadMaterialLibrary <filename_string>

名前の付いた 3ds Max マテリアルライブラリファイルをロードして、現在のマテリアルライブラリにします。ファイル名が完全な特定のディレクトリパスを持たない場合は、この関数は現在設定されているビットマップパスすべてを検索します。正常にロードされた場合は true が、失敗した場合は false が返されます。

saveMaterialLibrary <filename_string>

現在のマテリアルライブラリを名前付きファイルに保存します。正常に保存された場合は true が、失敗した場合は false が返されます。

fileOpenMatLib()

このメソッドでは[ファイルを開く](File Open)ダイアログボックスが表示され、ユーザがロードするマテリアルライブラリを選択することができます。

注:マテリアル/マップブラウザが開いている場合に fileOpenMatLib() を呼び出すと、マテリアル/マップブラウザの表示は更新されません。

fileSaveAsMatLib()

標準の[名前を付けて保存](Save File As)ダイアログボックスが表示され、ユーザが現在のマテリアルを保存できます。

fileSaveMatLib [quiet:<bool>]

現在のマテリアルライブラリが以前保存された(名前が付いている)場合、このメソッドによりマテリアルライブラリは同じファイルに保存されます。以前に保存していない場合は、標準の[名前を付けて保存](Save File As)ダイアログボックスが表示され、現在のマテリアルライブラリを保存できます。

3ds Max 8 以降 で使用可能な quiet: オプションの詳細については、「抑制モード」を参照してください。

getMatLibFileName()

現在のマテリアルライブラリファイルの名前を文字列値として返します。

例:

標準の配列インデックス付きアクセサを使用して、ライブラリ内のマテリアルの取得や設定ができます。MaterialLibrary では、インデックスとして名前と文字列リテラルを使用して、名前別にライブラリ内のマテリアルを取得できます。

$foo.material = currentMaterialLibrary["Rough Gold"]

for m in sceneMaterials do print m.name

append currentMaterialLibrary $baz.material

<MAXMaterialLibrary>loadTempMaterialLibrary <mtllib_file_name>

指定された 3ds Max マテリアルライブラリファイルをロードします。 loadMaterialLibrary() とは異なり、マテリアルライブラリを現在のマテリアルライブラリにはしません。ファイル名が完全な特定のディレクトリパスを持たない場合は、この関数はマテリアルライブラリのパスを検索し、現在設定されているビットマップパスすべてを検索します。正常にロードされた場合は MAXMaterialLibrary 値が返され、失敗した場合には未定義になります。

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

<boolean>saveTempMaterialLibrary <MAXMaterialLibrary> <mtllib_file_name>

指定されたMAXMaterialLibraryの値を名前付きファイルに保存します。正常に保存された場合は true が、失敗した場合は false が返されます。

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

例:

a = loadTempMaterialLibrary "mrArch_DesignTemplates.mat"
--> #materialLibrary()
a[1]
--> brushed metal:Arch___Design__mi
saveTempMaterialLibrary a "$matlibs/test.mat"
--> true