Ref/Property

Ref

プロパティー(Property)について

CueMolに登場するオブジェクトのうちいくつかには， プロパティーという概念があります． プロパティーは特にレンダラーにおいて重要です．

プロパティーは，文字通りそれを所有するオブジェクトの性質を決めるものです．
例えば，レンダラーはそのプロパティーにより表示色などが決まります．プロパティーはプロパティー名（文字列）とプロパティー値からなっており，プロパティー値は任意の型を取ることができます．

プロパティーの取得と設定

QScriptで，あるレンダラー$rendの，"foo"というプロパティーを取得する場合は，

 $value = $rend.getProp("foo");

と記述します．

逆に，あるレンダラー$rendの，"foo"というプロパティーを整数値'1'に設定する場合は，

 $rend.setProp("foo", 1);

と記述します．

ただし，以下に該当する場合は例外が発生します．

• プロパティー"foo"が$rend存在しない場合
• プロパティー"foo"がQScriptがサポートする型のいずれにも変換できない場合．
• setProp()において，"foo"プロパティーの型と与えられた値の型が一致しない場合．

ただし，整数・実数間では自動型変換が起こるので，実数プロパティーに整数値を設定しても問題ありません．

サブプロパティー (Sub property)

プロパティーの中には，さらにその内部にサブプロパティーをもつものがあります． 例えば，tubeレンダラーはsectionというプロパティーを持っていますが，sectionはその内部にwidth, tuberなど， 断面の形状に関するさまざまなプロパティーを持っています．

サブプロパティーを設定・取得するには，ドット表記を用います．

 $value = $rend.getProp("section.width");

上記の例では，"section"のサブプロパティーである"width"を取得しています．

ところで，"section"プロパティー自体はTubeSectionという型を持っていますが，この型はQScriptでは扱えません．このように，QScriptでは扱えない型を持つプロパティーでも，そのサブプロパティーは設定・取得できるわけです．