ページの比較

Let's open the AtomsRobot.ma file and duplicate the robot head, then edit the mesh to create multiple facial expressions.Then select the meshes and the original head and create a blend shape deformer.ファイルを開いてロボットのヘッドを複製した後、メッシュを編集して複数の表情を作成しましょう。
次に、メッシュと元のヘッドを選択してブレンドシェイプデフォーマを作成します。

Exporting meshes

You need to export the blend shapes target. If you use the variation builder, Atoms automatically exports the blend shapes data inside the meshes.

Meshをエクスポートする

Blend Shape Targetをエクスポートする必要があります。Variation Builderを使用すると、Atomsは、自動的にメッシュ内のブレンドシェイプデータをエクスポートします。

それらを手動でエクスポートしたい場合は、Atoms MenuからAtoms Mesh Exporterを開きます。Atoms > Export > Mesh exporter

Set the output path, then turn on the "export skin weight option". Inside the skeleton path file, pick the atomsRobot.atomsskel from the AtomsMaya/data folder. Then select the robot Hips joint and press the refresh button. Finally turn on the "export blend shapes" option, select the mesh you want to export and press the "Export" button. This tool automatically writes points, normals, id and name of each target inside the mesh file.

出力パスを設定した後、「Export Skin Weight」オプションをオンにします。
Skeleton Path File内で、AtomsMaya / dataフォルダーからatomsRobot.atomsskelを選択します。次に、ロボットのHipsジョイントを選択してRefreshボタンを押します。最後に、「Export Blend Shapes」オプションをオンにし、エクスポートしたいメッシュを選択して 「Export」ボタンを押します。このツールは、メッシュファイル内に各ターゲットのポイント、法線、ID、名前を自動的に書き込みます。

import AtomsCore
mesh_file = "robot1_head_blend.geos"
ark = AtomsCore.Archive()
if ark.readFromFile(mesh_file):
    mesh = AtomsCore.MapMetadata()
    mesh.deserialise(ark)
    for geo in mesh.keys(): #iterate over each geo
        targets_data = mesh[geo]["blendShapes"]
        for i in range(len(targets_data)):
            target = targets_data[i]
            points = target["P"].value()
            normals = target["N"].value()
            id = target["id"].value()
            name = target["name"].value()
            print id, name

Importing meshes

Meshをインポートする

新しいシーンを作成して、Robot Variation Tableをインポートします。Atoms メニューからAtoms > Variations > Import variation json. Select the robot.json file form the Variation jsonを実行します。
AtomsMaya \ data \ variations folder. This will load the robot variation table into the scene.Open the variation manager from the atoms menu: variationフォルダーからrobot.jsonファイルを選択します。これにより、ロボットのバリエーションテーブルがシーンにロードされます。

Atoms MenuからVariation Managerを開きます：

Atoms > Variations > Agents Variation Manager. Select the atomsRobot from the column on the left and then go inside the Geometry tab. Replace the robot1_head path with the mesh you just exported. Now press ctrl+s or from the widget menu execute File > Register to Atoms to save the changes.

Image Removed

Setting up variations

• Create and agent group node.
• Add a grid layout and set the grid size to 5,0,5
• Add a state machine module
• Add a variation module and set the variationName attribute to "Robot1"
• Change the display type to variations
• Rewind the scene

Image Removed

Setting targets weight

The targets weight are controlled by double metadatas. The metadata name should follow this convention:

AgentTypeName_VariationGeometryName_TargetIndex

In our case the following metadata names are valid:

左側の列から、atomsRobotを選択して、Geometryタブの中に入ります。robot1_headパスをエクスポートしたばかりのメッシュと置き換えます。
Ctrl + Sを押すか、WidgetメニューからFile > Register to Atomsを実行して変更を保存します。

Image Added

バリエーションを設定する

• Agent Groupノードを作成します。
• Grid Layoutを追加して、Grid Sizeを（5,0,5）に設定します。
• State Machineモジュールを追加します。
• Variationモジュールを追加して、VariationNameアトリビュートを "Robot1"に設定します。
• Display TypeをVariationsに変更します。
• シーンを巻き戻します。

Image Added

Targets Weightを設定する

Targets Weightは、Doubleメタデータによって制御されます。メタデータ名は次の規則に従います。AgentTypeName_VariationGeometry ame_TargetIndex

今回の場合、次のメタデータ名が有効です。

• atomsRobot_robot1_head_0
• atomsRobot_robot1_head_1
• atomsRobot_robot1_head_2
• atomsRobot_robot1_head_3

The target index is the order used by the Maya blend shape deformer, so the 0 index is the first blend shape, the 1 index is the second one and so on.

We can add and control these metadatas using the AddMetadata module

Target Indexは、Mayaブレンドシェイプデフォーマで使用される次数です。従って、0インデックスは最初のブレンドシェイプ、1インデックスは2番目のブレンドシェイプとなります。

AddMetadataモジュールを使用して、これらのメタデータを追加および制御できます。

• 「AddMetadata」Behaviourモジュールを追加します。
• nameアトリビュートをatomsRobot_robot1_head_0
• Set the type attribute to double
• Set the double value attribute to 1.0
• Rewind the scene

• 0に設定します。
• typeアトリビュートをDoubleに設定します。
• double valueアトリビュートを1.0に設定します。
• シーンを巻き戻します。

atomRobot_robot1_head_1, atomsRobot1、atomsRobot_robot1_head_2 etc.. metadatas. You can also add keyframes on the doubleValue attribute to animate the blend shapes.2などのメタデータを制御するために、同じエージェントグループに対して、さらにAddMetadataモジュールを追加してください。 doubleValueアトリビュートにキーフレームを追加して、ブレンドシェイプをアニメートすることも可能です。

Blend

Blend shapes can be handled more easily with the blend shape manager module.

Remove all your addMetadata modules and add a "blendShapeManager" module to your agent group. In blendShapeManager options click on the "Manage Blend Shapes" button, the UI on the right will be prompted.

From there you will be able to select the blend shapes you want to add to the agent group. 

You can select/deselect blend shapes by double clicking or using the button on the top of the list. 
Please be careful when clicking the "Expand" buttons as it could take some time to populate the entire tree if you have a lot of variation geos.

Click on the tick button on the bottom right corner, the blend shapes will now be visible under the blendShapeManager options where you will be able to animated them.

Image Removed

Adding animation

To add more complex animation or animation cycles to the blend shapes we can use the blendShapesAnim module. Before you can use this module, you have to export some animation curves from your setup scene. Open the atomsRobot scene where you created the blendshapes and add some keyframes on the target weights of the blend shape deformer.

Image Removed

Shape Manager

ブレンドシェイプは、Blend Shape Managerモジュールを使用してより簡易的に扱うことができます。
AddMetadataモジュールをすべて削除し、 "BlendShapeManager"モジュールをエージェントグループに追加します。
BlendShapeManagerのオプションで、「Manage Blend Shapes」ボタンをクリックすると、右側のUIが表示されます。

そこから、エージェントグループに追加したいブレンドシェイプを選択することができます。ダブルクリックするか、リスト上部のボタンを使用して、ブレンドシェイプをselect/deselectすることができます。
バリエーションジオが多数存在する場合は、ツリー全体を表示するのに時間がかかる可能性があるため、「Expand」ボタンをクリックするときは注意してください。

右下隅のチェックボタンをクリックすると、ブレンドシェイプがBlendShapeManagerオプションの下に表示され、そこでアニメーション化することができます。

Image Added

アニメーションの追加

より複雑なアニメーションまたはアニメーションサイクルをブレンドシェイプに追加するには、BlendShapesAnimモジュールを使用することができます。このモジュールを使用する前に、セットアップシーンからアニメーションカーブをいくつかエクスポートする必要があります。ブレンドシェイプを作成したatomsRobotシーンを開き、ブレンドシェイプデフォーマのTarget Weightにいくつかのキーフレームを追加します。

Image Added

次に、Atomsメニューからロボットのheadを選択し、ブレンドシェイプのアニメーションエクスポータを開きます。

Atoms> Export > Blend shapes anim exporter.

Set the output path and the frame range, select the head mesh and press the run button.

Image Removed

Go back to the atoms scene and remove the blendShapeManager module.

Add a blendShapesAnim behaviour module and click on the "Manage Animations" button under the blendShapeAnim tab.

Cilck on the "+" button for adding a new animation, select the "robot1_head" in the Geo field and set the path to the animation file we just exported. Leave the property to loop (no property will just play the blend shapes animation once).
You can of course add multiple animations, but we are going to stick with one for this example.

Click on the tick button and you will see this data being converted inside the "animData" parameter.

Press play and you will see the blendshapes being animated in a loop inside the viewport.

Click on the "Manage Animations" button again and activate the "Enable Trigger Metadata" checkbox. Type "triggerAnim" as name for your metadata.

Create an addMetadata module and place it before the blendShapesAnim module. Set the name attribute to triggerAnim. change the type to double and set the doubleValue to 1.0.

Now rewind the scene and press play, the result will be exactly as before.

Let's use an area trigger to drive the metadata.

First let's change the agent state to 1 inside the state machine to make them walk. Inside the addMetadata module change the double value to 0 (the area trigger module will drives this value). Now create an areaTrigger module and create a plane in the scene. Connect the plane to the areaTrigger module (remember to connect also the translation/rotation/scale) and set the metadata name attribute to triggerAnim, the double value to 1.0, the blend in and out to 10 and the random delay in and out to 5. Move the area trigger above the blendShapeAnim module. Rewind the scene and press play.

出力パスとフレーム範囲を設定し、ヘッドメッシュを選択して、Runボタンを押します。

Image Added

Atomsシーンに戻り、BlendShapeManagerモジュールを削除します。
BlendShapesAnim Behaviourモジュールを追加し、BlendShapeAnimタブの下にある「Manage Animations」ボタンをクリックします。

「+」ボタンをクリックして、新しいアニメーションを追加します。「Geo」フィールドで「robot1_head」を選択して、先ほど、エクスポートしたアニメーションファイルへのパスを設定します。Propertyをloopのままにします（どのプロパティもブレンドシェイプアニメーションを1度だけ再生することはありません）。
もちろん、複数のアニメーションを追加することが可能ですが、この例では1つのアニメーションを使用します。

チェックボタンをクリックすると、このデータが "animData"パラメータ内で変換されることが確認できます。

Playボタンを押すと、ビューポート内でブレンドシェイプがループでアニメートされていることが確認できます。

再度、「Manage Animations」ボタンをクリックして、「Enable Trigger Metadata」チェックボックスをオンにします。メタデータの名前として「triggerAnim」と入力します。

AddMetadataモジュールを作成して、BlendShapesAnimモジュールの前に配置します。 nameアトリビュートをTriggerAnimに設定します。タイプをDoubleに変更し、DoubleValueを1.0に設定します。
シーンを巻き戻して、Playを押すと、結果は以前と完全に一致します。

メタデータを駆動するために、Area Triggerを使用しましょう。

最初に、State Machine内でエージェントのStateを1に変更した後、それらを動作して下さい。 AddMetadataモジュール内で、Double valueを0に変更します（Area Triggerモジュールが、この値を駆動します）。

次に、AreaTriggerモジュールを作成して、シーン内に平面を作成します。

平面をAreaTriggerモジュールに接続し（Translation/Rotate/Scaleを接続するように注意してください）、Metadata nameアトリビュートをTriggerAnimにして、Double valueを1.0にします。Blend inとoutを10にして、Random delay inとoutを5に設定します。

Area TriggerをBlendShapeAnimモジュールの上に移動します。

シーンを巻き戻して、Playを押します。