MAXWrapper の共通プロパティ、演算子、メソッド

次のプロパティとメソッドは、MAXWrapper から派生するすべての値に適用できます。

プロパティ

次の MAXWrapper 値とクラス プロパティによって、標準プリミティブ、拡張プリミティブ、またはパーティクル システムなどのプラグイン カテゴリにアクセスできます。

<MAXWrapperobject>.category Name, read-only 
<maxclass>.category Name, read-only 
<maxsuperclass>.categories Array, read-only 	 

category プロパティは、カテゴリを含めた Name 値を返します。このプロパティは、Line、Box、Fog などの 3ds Max オブジェクト クラス、またはすべての 3ds Max オブジェクト クラスのインスタンスに使用できます。シーン ノードでは、プロパティは通常、[作成](Create)パネルのドロップ ダウン リスト内の名前の 1 つに対応します。これらのカテゴリは、 #Standard_Primitives 、 #Compound_Objects 、および #Particles_Only などです。

モディファイヤでは、カテゴリによってモディファイヤが[ボタン セットを設定](Configure Button Sets)/[モディファイヤ](Modifiers)リストのどの領域に表示されるかが決まります。これらのカテゴリは、 #MAX_STANDARD 、 #MAX_EDIT 、および #MAX_SURFACE などです。

テクスチャでは、カテゴリによってテクスチャが[マテリアル](Material)/[マップ ブラウザ](Map Browser)リストのどの領域に表示されるかが決まります。これらのカテゴリは、 #2D (2D マップ)、 #3D (3D マップ)、および #COMP (コンポジタ)などです。

categories プロパティは、シェイプ、GeometryClass、ヘルパー、SpacewarpObject、TextureMap、またはモディファイヤなどの 3ds Max オブジェクト スーパークラスに使用して、そのスーパークラスに使用可能なカテゴリのリストを取得することができます。これは Name の配列として返されます。

$line01.category --returns #Splines
Gengon.category --returns #Extended_Primitives
Shape.categories --returns #(#Shape, #Splines, #NURBS_Curves)

<maxsuperclass>.classes Array, read-only   

MAXSuperClass に属す MAXClass 値の配列を返します。この MAXClass 値を使用すると、クラスのインスタンスを作成できます。

--create an instance of each light class:
for aLight in light.classes do aLight()

<MAXWrapperobject>.classID 
<maxclass>.classID 

classID プロパティは、MAXWrapper クラスとオブジェクトの内部 3ds Max クラス ID を検索します。

返される値は、3ds Max 内部クラス ID PartA と PartB の 2 つの数値を含む配列です。

MAXWrapper オブジェクトでは、返される値はそのオブジェクトがインスタンスであるクラスの Class ID です。

PartA と PartB の数値の組み合わせは、常に各クラスに固有になります。

Box.classID --returns #(16, 0)
b=box()
b.classID --returns #(16, 0)

<MAXWrapperObject>.superClassID 
<maxclass>.superClassID 

MAXWrapper クラスとオブジェクトの 3ds Max スーパークラス ID を取得します。

<maxclass>.creatable Boolean, read-only

クラスが作成可能にフラグ設定されている場合、 true を返します。

このプロパティで true が返されても、クラスが本当に作成可能であるという保証はありません。

<maxclass>.ispb2based Boolean, read-only

元になるクラス定義が ClassDesc2 の場合は true を返し、ClassDesc の場合は false を返します。

ClassDesc2 クラスでは ParamBlock2 が使用され、ClassDesc クラスでは ParamBlock (3ds Max 3 より前のバージョンの場合)が使用されます。

<maxclass>.localizedName 

読み取り専用のプロパティであり、クラスのローカライズされた名前を返します。

<maxclass>.dllName String, read-only 

読み取り専用プロパティであり、クラスがプラグイン DLL で定義された場合、クラスを実装する DLL ファイル名を返し、それ以外の場合は undefined を返します。

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

<maxclass>.dllIsLoaded Boolean, read-only

読み取り専用のブール演算プロパティであり、クラスを実装している DLL が既にロードされている場合は true、DLL が遅延している場合は false を返します。クラスがプラグイン DLL で定義されていない場合は undefined を返します。

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

for sc in superclasses do
(
format "%\n" sc
for c in sc.classes do
format "\t% : % : %\n" c c.dllName c.dllIsLoaded
)

メソッド

copy <MAXWrapper_object> 

copy() 関数は、MAXScript で使用できるすべての 3ds Max オブジェクト(シーン オブジェクト、コントローラ、モディファイヤ、マテリアルなど)で実装されています。この関数はソース オブジェクトのクローンの作成に使用できます。たとえば、個々のコピーが必要な場合や、共有オブジェクトを固有にしたい場合などです。

addModifier $foo $baz.bend

addModifier $foo (copy $baz.bend)

次の例では、単一の回転コントローラを共有するいくつかのオブジェクトをすべて設定します。

c = bezier_rotation()
$foo.rotation.controller = c
$baz.rotation.controller = c
$bar.rotation.controller = c

$baz.rotation.controller = copy $baz.rotation.controller

MAXWrapper オブジェクトがシーン ノードではない場合、コピーは MAXScript のメモリ内のみに作成されます。MAXWrapper オブジェクトがシーン ノードの場合、新規のシーン ノードが作成され、ユーザは 3ds Max ビューポートで確認し、アクセスできます。

exprForMAXObject <MAXWrapper_object> [explicitNames: <boolean>] 

プロパティ アクセスとインデックス(必要に応じて)を使用して指定した MAXWrapper オブジェクトに名前を指定する、MAXScript 式を含む文字列を返します。

exprForMAXObject m

"$foo.bend"

explicitNames: オプションを true に設定すると、明示的なノード名が返されます。false に設定すると、選択に関連する名前が返されます。指定しない場合、[カスタマイズ](Customize) > [基本設定](Preferences) > [MAXScript タブ](MAXScript tab) > [コードの生成](Code Generation)下の現在のマクロ レコーダ設定が使用されます。

このメソッドは、マクロ レコーダによって使用される内部メソッドを公開したものです。 explicitNames: オプションを指定しない場合、出力はマクロ レコーダ オプションによって変化します。

b=box()
-->$Box:Box002 @ [0.000000,0.000000,0.000000]
c=b.pos.controller
-->Controller:Bezier_Position
exprformaxobject c
-->"$Box002.pos.controller"
bm=bend()
-->Bend:Bend
addmodifier b bm
-->OK
exprformaxobject bm
-->"$Box002.modifiers[#Bend]"

exprformaxobject bm
-->"$.modifiers[#Bend]"

exprForMaxObject ambientColorController
-->"Scene[#Environment].Ambient_Light.controller"

(getclassinstances scene)[1].Environment.Background_Color.controller 

(getclassinstances RenderEnvironment)[1].Background_Color.controller

createInstance <maxclass> [ keyarg1:v] [ keyarg2:v] ... 

このメソッドは、ノード(またはその他のオブジェクト)内に表示される「基本オブジェクト」を直接作成するために使用します。これは主に、一時的なジオメトリ基本オブジェクトを作成するために使用されます。作成されたオブジェクトから抽出されたメッシュは、スクリプト化されたジオメトリ プリミティブ プラグインのメッシュを作成する際に役立ちます。オプションの <keyargs> は、クラス コンストラクタに提供できるのと同じ基本オブジェクトのキーワード引数です。これらは一般に基本オブジェクトのパラメータです。

b = createInstance Box length:10 height:40 width:20

replaceInstances <old_MAXWrapper> <new_MAXWrapper> transferCAs: <bool> 

古い MAXWrapper のすべてのインスタンスを新しい MAXWrapper に置き換えます。古い MAXWrapper と新しい MAXWrapper には、同じスーパークラスが必要です。

transferCAs が true である場合は、参照を転送するオカレンスが 1 つ以上存在すれば、old_MAXWrapper のカスタム アトリビュートは new_MAXWrapper に転送されます。

参照は MAXWrapper 値に転送されません。

3ds Max 2008 以降 で使用可能です。従来、Avguard 機能拡張として提供されていた機能です。

isValidObj <value> 

値が MAX オブジェクト(MAXWrapper)を示す場合は true を返します。MAX オブジェクトは削除されていません。

getClassName <MAXWrapper> 

MAXWrapper のクラス名を文字列として返します。

refs.dependents&<MAXWrapper_object>[ immediateOnly:&<boolean>] 

refs.dependents $foo.material.diffuseMap

#(Material_#3, Material_#2, Map_#2:Noise, Material_#1)

theSphere=sphere ()-- create a sphere
theCone=cone radius1:0 radius2:20-- create a cone
theHelix=helix height:100 pos:[100,100,0]-- create a helix
theCone.target=theSphere-- assign theSphere as target of theCone
--  a look at controller is automatically
--  assigned to theCone
--  assign path controller to theSphere, path to follow is the helix
theSphere.position.controller=path path:theHelix
refs.dependents theSphere-- show dependents of the sphere
refs.dependents theCone-- show dependents of the cone
refs.dependents theHelix-- show dependents of the helix

$Sphere:Sphere002 @ [0.000000,0.000000,0.000000]-- result line 1
$Cone:Cone002 @ [0.000000,0.000000,0.000000]-- result line 2
$Helix:Helix002 @ [100.000000,100.000000,0.000000]-- result line 3
$Sphere:Sphere002 @ [0.000000,0.000000,0.000000]-- result line 4
Controller:Path_Constraint-- result line 8
#(Controller:Look_At, $Cone:Cone002 @ [0.000000,0.000000,0.000000])-- result line 9
#()-- result line 10
--  following is output of line 11
#(ReferenceTarget:ParamBlock2, Controller:Path_Constraint, Controller:Position_Rotation_Scale, $Sphere:Sphere002 @ [135.000000,100.000000,0.000000], Controller:Look_At, $Cone:Cone002 @ [0.000000,0.000000,0.000000])

refs.dependsOn <MAXWrapper_object> 

b = box()
refs.dependsOn b

#(Controller::Position_Rotation_Scale, Box)

refs.dependencyLoopTest <MAXWrapper_object> <MAXWrapper_object> 

a = box pos:[-100,0,0]
--> $Box:Box001 @ [-100.000000,0.000000,0.000000]
b = box pos:[100,0,0]
--> $Box:Box002 @ [100.000000,0.000000,0.000000]
a.material = standardMaterial()
--> Standardmaterial:Standard
refs.dependencyLoopTest a b
--> false
refs.dependencyLoopTest a a.material
--> true

refs.dependentNodes <MAXObject> firstOnly: <bool> baseObjectOnly: <bool> 

notifyDependents <MAXObject> partIDmsg: <name>: <int> propogate: <bool> 

globalmySphereRadius = 10
s=sphere()
s.radius.controller = float_script()
s.radius.controller.script ="mySphereRadius"

mySphereRadius = 50

notifydependents s.radius.controller

disableRefMsgs() 
enableRefMsgs() 

 特に明記されている場合以外は、この作業は、Creative Commons 表示 - 非営利 - 継承 3.0 非移植ライセンス のもと認可を受けています。 Autodesk Creative Commons FAQ (英語版) を参照してください。