Kanzi 3.5 移行ガイド¶
このマイグレーションガイドを使用して、Kanzi アプリケーションを Kanzi 3.4 から Kanzi 3.5 に更新してください。
デフォルトの3Dテキストマテリアル¶
デフォルトの3Dテキストマテリアルは、Blend Intensity プロパティを考慮するようになりました。デフォルトの3Dテキストマテリアルを使用している Text Block 3D ノードを確認し、目的のレンダリング結果を得るためにコンテンツを適宜修正してください。
プロパティの優先順位¶
クラス優先度を持つプロパティ値は、もはや継承されません。
アニメーション (Animation)¶
Kanzi 3.5は、アニメーションシステムに変更を導入しており、キーフレームアニメーションを使用しているプロジェクトを更新する必要があります。
プロパティ駆動アニメーション¶
Kanzi の以前のバージョンで作成されたプロジェクトのプロパティ駆動アニメーションを Property Driven Animation Player に置き換えます。プロパティ駆動のアニメーションを作成する を参照してください。
Background Animation 機能の置き換え¶
Background Animation プロパティは使用できなくなりました。以前 Background Animation プロパティを使用して再生していたキーフレームアニメーションを再生するには、Animation Player を使用してください。キーフレームアニメーションの使用 を参照してください。
Play Animation アクションの置き換え¶
Play Animation アクションは非推奨であり、次のバージョンの Kanzi で削除されます。Kanzi Studio プロジェクトを変更して、Animation Player とアニメーション再生アクションを使用してアニメーションを制御してください。キーフレームアニメーションの使用 を参照してください。
ターゲットキーフレーム¶
ターゲットキーフレームは利用できなくなりました。オブジェクトを動的なターゲット値に向かってアニメーションさせるには、Property Target Interpolator を使用してください。プロパティ値の補間 を参照してください。
キーフレームクラス¶
キーフレームクラスは shared_ptr の代わりに unique_ptr を使用します。
リソースプロパティ (Resource properties)¶
以前の Kanzi バージョンでは、ノードはすべてのリソースをリソースIDプロパティを通じて参照していました。リソースIDは、ノードによって実際のリソースにマッピングされた文字列です。リソースIDには、URL文字列またはリソース辞書を通じてURLにマッピングされたID文字列を含めることができました。Kanzi 3.5では、ノードは直接ポインタを含むプロパティを通じてリソースを参照します。この変更により:
リソースのプロパティタイプを宣言する方法。
プロパティ値の読み取りと書き込みの方法は、読み取りおよび書き込みが行われます。
IDをURLにマッピングする使用。
プロパティタイプを宣言する¶
Kanzi 3.4では、プロパティがリソースを参照するようにしたい場合、プロパティタイプを宣言するためにリソースIDデータ型を使用しました。例えば、
PropertyType<ReseourceID>
Kanzi 3.5 を使用
PropertyType<ResourceSharedPtr>
これらのプロパティは、リソースポインタを直接受け取り、返します。例えば、Image ノードにテクスチャを設定するには、次のようにします。
Image::setProperty(Image::TextureProperty, textureResource).
プロパティ値の読み取りと書き込み¶
リソースマネージャーからリソースを取得し、それをプロパティ値として設定します。
間接リソース参照の設定¶
リソースディクショナリ内でリソースIDを値にマッピングする方法を変更しました。
例えば、Kanzi の以前のバージョンでは、Image プロパティの値をリソースIDに設定するために、次のように使用しました。
imageNode->setProperty(Image2D::ImageProperty, resourceId);
Kanzi 3.5 で、Image プロパティの値をリソースIDに設定するには、使用します。
BindingSharedPtr binding = Binding::create(domain);
binding->setSourceResource(resourceId);
binding->setTargetDynamicObjectProperty(".", Image2D::ImageProperty, PropertyFieldWhole);
imageNode->addBinding(binding);
Scroll View 座標¶
Scroll View 2D ノードと Scroll View 3D ノードの座標が変更されました。
ジェネラル (General)¶
プロパティタイプには、名前に
kzMakeFixedStringが必要です。ResourceDictionary::acquireResource()は、正しくフォーマットされたURLが必要です。Node::acquireResource()は現在、ResourceID を必要とします。kzuMatrix4x4はMatrix4x4に変更されました。