2009.02.02　作成





--------------------------------------------------------------------------

　シャドウコピーエクスプレッションから、色々なプロパティにアクセスする手順

--------------------------------------------------------------------------





int i;

StringProperty dbg = new StringProperty("デバッグ用","");

MonitorProperty.Add(dbg);



// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

//　とりあえずPropertyの中身を確認してみる

// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■



StringProperty pval = new StringProperty("Propertyの中身","");

MonitorProperty.Add(pval);

pval.TypeSafeValue +=

"["+ Property.ThisName +"]"+　             // ← "ShadowCopyMaterial"

"["+ Property.ThisCode +"]"+               // ← アイテムコード

"["+ Property.Index +"]"+                  // ←フレーム番号-1

"["+ Property.TimelineTracks.Length +"]"+  // ← 0

"["+ Property.ThisProperty.Length +"]"    // ← プロパティ数 1

;



// プロパティの名前や型などはプロパティモニタで調べることができる

for(i=0; i<Property.ThisProperty.Length; i++){

    MonitorProperty.Add(Property.ThisProperty[i]);

}





// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

//　（シャドウコピーエクスプレッションから）

//　テキストマテリアルのプロパティにアクセスする手順

// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■



//　シャドウコピーエクスプレッションから、テキストマテリアルのプロパティの

//　取得・設定を行うことはできない。

//　詳細はNiVE本体に付属している「エクスプレッションについて.txt」を参照。





// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

//　（シャドウコピーエクスプレッションから）

//　テキストアニメータのプロパティにアクセスする手順

// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■



//　シャドウコピーエクスプレッションから、テキストアニメータのプロパティの

//　取得・設定を行うことはできない。

//　詳細はNiVE本体に付属している「エクスプレッションについて.txt」を参照。







// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

//　（シャドウコピーエクスプレッションから）

//　自分のプロパティにアクセスする手順

// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■



// 普通に「エクスプレッションにコピー」で得たものをキャストして使えばＯＫ。



// 「コピー元」プロパティの取得

TimelineProperty copy_src = (TimelineProperty)ExpressionUtils.GetProperty(Property.ThisProperty, "コピー元");



dbg.TypeSafeValue += "「コピー元」のTimelineCode = " + copy_src.TypeSafeValue + "\n";

dbg.TypeSafeValue += "「コピー元」のIndex = " + copy_src.Index + "\n";

dbg.TypeSafeValue += "「コピー元」のTimeline = " + copy_src.Timeline + "\n";



// ただし、エクスプレッションから「コピー元」に正しい設定を行うことはできないと思う。

// TimelinePropertyへの設定は、TimelineProperty.TypeSafeValueにタイムラインコードを

// 設定するだけでは駄目で、TimelineProperty.Timelineに有効なITimelineを

// 設定してやる必要があるが、シャドウコピーエクスプレッションで

// ITimelineを取得する方法は、IExpressionComposition.ExecuteExpression()を

// 実行するという方法のみ。「エクスプレッションについて.txt」にあるように、

// この方法で取得されるITimelineはダミー的なものになるので、

// これをそのままTimelineProperty.Timelineに入れても有効にはならない。

//

// まあでも、そもそもここのエクスプレッションから「コピー元」を

// 設定したいケースって無いですよね、たぶん。





// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

//　（シャドウコピーエクスプレッションから）

//　マテリアルやエフェクトのプロパティにアクセスする手順

// ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■



// 「エクスプレッションについて.txt」を見ればわかるとおり、

// シャドウコピーのエクスプレッションは特殊な扱いとなっており、

// 「クリップボードで厳密にコピー」でマテリアルやエフェクトの

// プロパティを直接取ろうとしてもエラーが発生するし、

// Property.TimelineTracksからトラックを取得することもできない。

// （Property.TimelineTracks.Length がゼロ）

//

// したがって、下記の手順でアクセスする必要がある。



// とりあえず「エクスプレッション.txt」の説明にあるように、

// IExpressionHost.GetComposition()を使って

// プロジェクト内のコンポジション一覧を取得する

IExpressionComposition[] comps = Property.Host.GetComposition();



// コンポジションコードを指定して自コンポジションを取得する。

IExpressionComposition comp = ExpressionUtils.GetComposition(comps,633690811924107684);



// コンポジション名とコンポジションコードを確認

dbg.TypeSafeValue += "[" + comp.CompositionName + "]" + "[" + comp.CompositionCode + "]";



// よくわからないけど、IExpressionCompositionから

// タイムラインを取るにはExecuteExpression()を使えばよさそうなので、

// それで取得してみる。

ITimeline[] timelines = comp.ExecuteExpression(Property.Index);



// IExpressionItemの配列に変換

IExpressionItem[] tracks = ExpressionUtils.CastToExpressionItem(timelines);



// 目的のトラックをアイテムコードを明示指定して取得

// （ここでは下のトラックを指定している）

IExpressionItem tgt_track = ExpressionUtils.GetItem(tracks,1450954774);



// トラック名を確認

dbg.TypeSafeValue += "[" + tgt_track.ItemName + "]";



// 目的のトラックのマテリアルから「位置」を取得してみる

PointFProperty pos = (PointFProperty)ExpressionUtils.GetProperty(tgt_track.Properties,"位置");



// プロパティ名を確認

dbg.TypeSafeValue += "[" + pos.PropertyName + "]";



// 無事に位置の値の取得に成功。

dbg.TypeSafeValue += "[" + pos.TypeSafeValue + "]";



// シャドウコピーエクスプレッションからは、

// マテリアルのプロパティの取得はできるが、設定はできない。

// 試しに値を設定してみてもエラーは出ず、

// プロパティモニタで見るとしっかり設定されているように見えるが、

// 実際にその値が使われることはない。

//

//pos.X = 512 + Property.Index*5;

//MonitorProperty.Add(pos);



// 目的のトラックのエフェクト一覧を取得

IExpressionItem[] effects = ((IExpressionTrack)tgt_track).GetEffect();



// エフェクト一覧から「トランスフォーム」エフェクトを

// アイテムコードを明示指定して取得してみる

IExpressionItem tform = ExpressionUtils.GetItem(effects,373667484);



// エフェクト名を確認

dbg.TypeSafeValue += "[" + tform.ItemName + "]";



// 「不透明度」プロパティを取得

SingleProperty tform_toumei = (SingleProperty)ExpressionUtils.GetProperty(tform.Properties,"不透明度");



// プロパティ名を確認

dbg.TypeSafeValue += "[" + tform_toumei.PropertyName + "]";



// 「不透明度」プロパティの値の取得

dbg.TypeSafeValue += "[" + tform_toumei.TypeSafeValue + "]";



// シャドウコピーエクスプレッションからは、

// エフェクトのプロパティの取得はできるが、設定はできない。

// 試しに値を設定してみてもエラーは出ず、

// プロパティモニタで見るとしっかり設定されているように見えるが、

// 実際にその値が使われることはない。

//

//tform_toumei.TypeSafeValue = 100 - Property.Index*5;

//MonitorProperty.Add(tform_toumei);