The agent layout tool is your best companion when populating your scene. Your agent group must have one of the following modules applied to use this tool: pointLayout, cacheRead or any other layout + agentFilter (for deleting agents) + offset (for offsetting agents).
This feature is for Maya only.
When the tool is active you can access the tool attributes from the "Agent Layout Tool" widget or pressing the right mouse button inside the viewport.
Layout tool and Points layout module
Create a new scene and a new agent group. Add a "pointsLayout" and a "stateMachine" module to your agent group.
To activate the layout tool you have two options:
- Select the "pointsLayout" module in the module list, then click on the "Agents Layout Tool" button in the module options.
- With your agent group selected, activate the tool from the Atoms menu: Atoms > Tools > Agents Layout Tool
Click in the viewport to start placing agents.
| 注意 |
|---|
Please make sure to be on the first frame of your simulation when adding or editing agents. |
You can set their parameters through the GUI or via the menu (right click on the viewport).
Add mode
Left Click to add agents in the viewport.
Ctrl+Left click and drag to edit the direction for the agents.
Shift+Left click and drag to rotate the layout (grid and poisson)
There are different layout type for placing your agents: point, grid and poisson.
Both grid and poisson have some options you can tweak through the GUI.
In the ground mesh list, you can add reference meshes that the tool will use when placing your agents.
Make sure add the same ground mesh as an height field to your agent group, otherwise your agents will intersect with the ground.
In the Agent Types list, you can select the agent types you will be adding to your agent group. If the "Random" checkbox is ticked, Atoms will pick an agent from list randomly.
Selection mode
Left click and drag to select agents.
Shift+Left click and drag to add agents to the selection.
Ctrl+Left click and drag to toggle agents.
You can erase agents by pressing the "delete selected agents" button in the GUI or via menu.
You can also change their agent types by pressing the "Cachen Agent Type" button.
Used with a cacheReader module you can duplicate agents by pressing the "Duplicate Agents" button.
Move mode
Use the manipulator to move the selected agents.
Rotate mode
Click and drag to rotate the selected agents on the up vector.
Shift+Left Click and drag to rotate the selected agents around their average point.
Layout tool and other layouts
You can still use the layout tool with other layouts (gridLayout, meshScatterLayout, etc):
- If you care about moving and rotating your agents, please add an "offset" module to your agent group.
- If you care about deleting agents, please add an "agentFilter" module to your agent group.
- BUT you cannot add new agents.
Then with your agent group selected, activate the tool from the Atoms menu: Atoms > Tools > Agents Layout Tool
Layout tool and cacheReader module
You can use the layout with the cache reader module:
- you can offset and rotate agents
- you can delete agents
- you can duplicate agents (you will find this option in select mode)
- BUT you cannot create new agents
You can activate the tool from the Atoms menu: Atoms > Tools > Agents Layout Tool
Agent Layout Toolは、シーンを作成するための最も適した機能です。このツールを使用する場合は、エージェントグループに次のモジュールのいずれかが適用されている必要があります。pointsLayout、cacheReader、またはany other Layout + agentFilter（エージェントの削除用）+ offset（エージェントのオフセット用）。
ツールがアクティブになっている場合は、「Agent Layout Tool」ウィジェットから、またはビューポート内でマウスの右ボタンを押してツールのアトリビュートにアクセスすることができます。
Layout ToolとPoints Layout モジュール
| 注意 |
|---|
エージェントを追加、または編集する際は、必ずシミュレーションの最初のフレームで実施するように注意してください。 |
エージェントを編集するためのモードはいくつかあります。add、selection、move、rotateです。
ユーザーは、GUIまたはメニュー（ビューポート上で右クリック）を通してそれらのパラメータを設定することができます。
Add モード
左クリックして、ビューポートにエージェントを追加します。
Ctrl +左クリックでドラッグして、エージェントの方向を編集します。
Shiftキーを押しながら左クリックでドラッグを実行すると、レイアウトが回転します（gridとpoisson）。
エージェントを配置するための様々なレイアウトタイプがあります。point、grid、poissonです。
gridとpoissonのどちらにも、GUIを通じて調整できるオプションがいくつかあります。
Ground Meshリストに、エージェントを配置する時にツールが使用するReference Meshを追加できます。エージェントグループにHeightフィールドとして同じGround Meshを追加してください。実行しない場合、エージェントはグラウンドと交差します。
「Agent Types」リストで、エージェントグループに追加するエージェントの種類を選択できます。 「Random」チェックボックスがチェックされていると、Atomsは、リストからエージェントをランダムに選びます。 Houdiniでは、Agent Typeフィールドからエージェントタイプを1つ自動的にランダムに選択します。
Mayaでは、特定のスライダーを使用して、エージェントタイプのパーセンテージの分布を指定することも可能です。割合は、Randomオプションがオンの場合にのみ機能します。
エリアの配置（Mayaのみ）。マウスの左ボタンを使用して、ビューポート内に多角形のポイントを描画し、多角形を閉じる場合は、最初のポイントと同じ位置にポイントを追加します。多角形のポイントを移動する場合は、マウスの中央ボタンを使用します。Layout ToolのUIから、すべてのパラメータを制御することができます。サンプルを作成した後、「Create Agents」ボタンをクリックしてエージェントを作成します。
Selection モード
左クリックでドラッグを実行して、Marquee Toolでエージェントを選択するか、中クリックでLasso Toolを使用します。
Shift +左クリックでドラッグを実行して、選択にエージェントを追加します。 Ctrl +左クリックでドラッグより、エージェントを切り替えます。
GUIまたはメニューから「Delete selected agents」ボタンを押すと、エージェントを削除できます。
また、「Change Agent Type」ボタンをクリックして、それらのエージェントタイプを変更することもできます。
cacheReaderモジュールと共に使用すると、「Duplicate Agents」ボタンを押してエージェントを複製できます。
Move モード 585px400px
マニピュレータを使用して、選択したエージェントを移動します。
Rotate モード
クリック、ドラッグして、選択したエージェントを上方向に回転させます。
Shift +左クリックしてドラッグすると、選択したエージェントの平均点を中心に回転させることができます。
Layout Toolとその他のレイアウト
他のレイアウト（gridLayout、meshScatterLayoutなど）でもLayout Toolを使用することができます。
- エージェントを動かし、回転させることに関心がある場合は、エージェントグループに "offset"モジュールを追加してください。
- エージェントを削除したい場合は、エージェントグループに "agentFilter"モジュールを追加してください。
- 新しいエージェントを追加することはできません。
次に、エージェントグループを選択した状態で、Atomsメニューからツールをアクティブにします。Atoms> Tools> Agents Layout Tool
Layout ToolとcacheReaderモジュール
Cache Readerモジュールでレイアウトを使用することができます。
- エージェントをオフセットして、回転させることができます。
- エージェントを削除できます。
- ユーザーは、エージェントを複製することができます（ユーザーは、Selectモードでこちらのオプションを見つける可能性があります）。
- 新しいエージェントを作成することはできません。
Atomsメニューからツールをアクティブにすることができます。
Atoms> Tools> Agents Layout Tool
