To be able to use the layout tool, your agent group must have a "pointsLayout" modules applied.
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 in the Atoms menu. Atoms > Tools > Agents Layout Tool
The Agents Layout Tool GUI
The agent layout tool is your best companion when populating your scene.
You have several modes for editing your agents: add, selection, move and rotate.
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.
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.
Please take some time to familiarize with all the options of the Agent 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
