# Dash Bar

<figure><img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FV2aI5W8DxrKYodMK1yiq%2FUnrealEditor_nzJFNiCy3P.png?alt=media&#x26;token=7abdfc5e-d94f-46e3-8429-60adea4bc14f" alt=""><figcaption></figcaption></figure>

This widget is your main gateway to Dash, and is jampacked with features:

* <mark style="color:blue;">**Content**</mark>: Dash features an amazing content browser, with Megascans & Polyhaven support, custom assets support, an IES library, and the ability to access all your assets from other UE projects! In this category, you will also find the reference image board tool, similar to Miro and PureRef.&#x20;
* <mark style="color:blue;">**Place**</mark>: This shows you a dropdown full of tools that help you with content placement. Features range from pivot setting to physics-based asset placement, and much more.
* <mark style="color:blue;">**Scatter**</mark>: This is where all the cool scatter tools of Dash reside: You can scatter on a surface, along a spline, scatter decals, scatter in a volume, etc…
* <mark style="color:blue;">**Create**</mark>: This is an extensive list of tools that help you create objects, from geometry & curve primitives, to cameras, vines, fog cards, etc…
* <mark style="color:blue;">**Edit**</mark>: This is the main properties panel through which all your Dash tools will be edited.

You can make the dash bar smaller by going to the menu icon on the left, then selecting **Toggle Scale** to swap between full, minimal, and icon only. The shortcut for this is **CTRL+E**.

<figure><img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FztwY9XbuxPEJ7YtufFxT%2Fdash_bar_minimal.png?alt=media&#x26;token=3ddf8a55-fec5-4175-a5ff-e20b3a5a07bb" alt="" width="375"><figcaption></figcaption></figure>

The “<mark style="color:blue;">**Find tools**</mark>” text area is where you can search for tools. For example, we have a really useful tool called “draw curves” which allows you to interactively draw native UE splines. You can open it from the Create menu, or by just typing “draw curves” in the search field, then hitting Enter when you see it suggested. A lot of these tools are often in one of the menus; i.e. Draw Curves is in **Create -> Curve Tools**.\
But the search bar has a lot more tools broadly, from simple things like toggling nanite/collision on your selected objects, to more specific tools like the Channel Packer.

And finally, you have the Dash logo, which you can drag around to unsnap the Dash bar from its default position and move it around your screen, or double-click to expand/collapse the list of all tools available in Dash.

<figure><img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FqZVc2gYY5geTMUmP59nz%2Fdash_logo_double_click.gif?alt=media&#x26;token=56f6c05b-77a5-476b-ad8f-44d4459de0b2" alt=""><figcaption></figcaption></figure>

The Dash bar is responsive, meaning scaling the UE viewport will adapt its position and scale too.\
You can disable this behavior by clicking on the dots menu, then **Toggle Responsive UI**.

{% embed url="<https://streamable.com/opzg1l>" %}

### Dash AI Assistant

To help you get the most out of Dash, the product ships with an AI assistant you can speak to.\
It is trained on this documentation, and will do its best to answer your questions, such as:

> * *How do I mask objects by proximity?*
> * *Where can I find my license key?*
> * *Where do I find physics tools?*
> * *I'm unable to scatter more assets after 1.0 when using surface scatter.*
> * *etc...*

<figure><img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2F9VOJgOimDbk1uERn6I9Q%2Fimage.png?alt=media&#x26;token=c6406694-3603-4534-bd9b-80ddc8d1c0d8" alt=""><figcaption></figcaption></figure>

Like most modern AIs, this assistant is not perfect, and occasionally make mistakes. Based on our testing, it seems to be helpful at dealing with most issues users encounter, and we've made sure to include links to our discord, documentation, and support email in the assistant window, just so you know where to reach out in case it's not helpful.\
We've also exposed a *History* button that helps you see all the questions you've asked during your UE session; meaning from the moment you started it, 'till the moment you closed it.

<details>

<summary>Does Polygonflow save my questions &#x26; AI answers on their servers?</summary>

Yes we do.\
We use that data to better improve Dash, and only that. For example, we might see that a lot of users ask how to scatter moss, and we'll take it as a signal that we need to ship a moss preset for the tool Surface Scatter.\
We might also notice that the answers from the AI assistant have a pattern of being unhelpful in a certain way, and that would be a good signal for us to adjust and deploy it again.

</details>

{% embed url="<https://streamable.com/8qrl08>" %}

The assistant is limited to 25 questions per session, after which we usually recommend you to just read out to us and we'll troubleshoot the issue with you. You could of course just restart UE5 to ask more questions, but at that point, one of our developers would likely be a better assistant :smile:<br>

### Place Menu Features

This menu contains various options to move, scale, rotate, drop and adjust your object's positions.

* <mark style="color:blue;">**Select Nearby**</mark>: Given some selected objects, this option will select all objects near it. It'll ignore any object that's larger than the biggest object in your selection. Use `SHIFT+Click` on this option to only keep the nearby objects, and not the originally selected ones.\
  This action will ignore any objects bigger than the largest in your selection, and only focus on objects close enough. Think grabbing all items on a table, without picking the ceiling.
* <mark style="color:blue;">**Select Above**</mark>: Given a set of selected objects, this will select all objects that are above them. your current selected objects. Use `SHIFT+Click` on this option to only keep the nearby objects, and not the originally selected ones. \
  This action will ignore any objects bigger than the largest in your selection, and only focus on objects close enough. Think grabbing all items on a table, without picking the ceiling.
* <mark style="color:blue;">**Physics Drop**</mark>: Given some selected objects, like say some dishes or trash, this options will start a physics simulation and drop them to whatever's below them. The Dash bar will be in the physics mode, and you'll be able to adjust a few properties.
* <mark style="color:blue;">**Physics Paint**</mark>: Select some objects like debris, trash or anything you want to make a pile of, then select this tool, and you'll be able to paint instances of your selection ultra fast. The Dash bar will be in the physics mode, and you'll be able to adjust a few properties.
* <mark style="color:blue;">**Project Below**</mark>: This option will move your selected object towards whatever's below it. Useful for quickly snapping objects on a table, floor, etc...
* <mark style="color:blue;">**Random Swap**</mark>: Select a couple of objects you want to swap, and this feature will pick them at random, and switch their positions.

#### Pivot Tools

* <mark style="color:blue;">**Center Pivot**</mark>: This will center the pivot of your selected actors. Keep in mind, it won't change the pivot on the static mesh/asset of an actor, just the actor's pivot itself.
* <mark style="color:blue;">**Bottom Pivot**</mark>: This will move the pivot of your selected actors to its bottom. Keep in mind, it won't change the pivot on the static mesh/asset of an actor, just the actor's pivot itself.
* <mark style="color:blue;">**Top Pivot**</mark>: This will move the pivot of your selected actors to its top. Keep in mind, it won't change the pivot on the static mesh/asset of an actor, just the actor's pivot itself.

In case you're trying to change the pivot for scattering reasons, our scatter tools have pivot overrides and a "sink" feature to help you adjust your object's position at will.

#### Transform Tools

* <mark style="color:blue;">**Average Scale**</mark>: Takes the average scale of all your selected objects, and applies it to all of them, until they roughly have the same bounding box size.
* <mark style="color:blue;">**Minimum Scale**</mark>: Grabs the smallest object in your selection, and conforms the size of all other selected objects to this, until their bounding box is of the same size.
* <mark style="color:blue;">**Maximum Scale**</mark>: Grabs the largest object in your selection, and conforms the size of all other selected objects to this, until their bounding box is of the same size.
* <mark style="color:blue;">**Random Angles**</mark>: Randomly spins your selected objects on their Z axis.
* <mark style="color:blue;">**Reset Rotations**</mark>: This is a quick shortcut to reset the rotation of your selected objects.
* <mark style="color:blue;">**Reset Scale**</mark>: This is a quick shortcut to reset the scale of your selected objects.

That's it! If you have some feature suggestions for more quick operations along these lines, please feel free to bring it up on our Discord!

### Scatter Menu Features

This menu contains all the major scattering features in Dash. One thing to keep in mind is that these tools work with actors, not assets. If you want to scatter a rock or a decal, first put them in your scene, then scatter them. You can't scatter directly from the UE content browser, yet.\
There's a few more that you can find by right-clicking on the Dash logo to expand the tools list, but the most important ones are here:

* <mark style="color:blue;">**Surface Scatter**</mark>: Got a ground you want to scatter objects on? This is your tool. Surface Scatter is incredibly powerful, and can be used to create entire forests, or moss, or garbage near bins, or debris near destroyed building, etc... We've got plenty of video on our [YouTube channel ](https://www.youtube.com/@polygonflow)highlighting its use.
* <mark style="color:blue;">**Path Scatter**</mark>: Want to scatter some objects along the points of a curve/spline? This tool has everything you need, and then some. You can use it for wooden posts along a path, lamp posts on a road, hanging lights, etc... Its "Parallel Width" feature allows you to scatter on both sides of a curve, which is very practical for roads, paths, etc...
* <mark style="color:blue;">**Decal Scatter**</mark>: Select a few decals in your scene, pass them to this tool, give it a surface, and it'll scatter them all around. Features like scaling, depth control, random spin and surface alignment make this tool extremely useful for urban environments.
* <mark style="color:blue;">**Volume Scatter**</mark>: This tool allows you to scatter objects *inside* other objects. For example, you could fill a cube with some objects, or create a blobby mesh and scatter birds in it, then move it up in the sky and now you've got birds in the sky.
* <mark style="color:blue;">**Grid Scatter**</mark>: This is a powerful tool to quickly scatter objects in a grid pattern. Its jittering features help you break up obvious repetition fairly quickly.
* <mark style="color:blue;">**Radial Scatter**</mark>: Arguably the most powerful radial scattering tool in UE, you can use this tool to create radial object layouts, or capsule layouts, etc... With its concentric and "every nth" logic, this can help you do simple stuff to entire stadium chair/crowd setups.

### Create Menu Features

This menu is filled to the brim with some of the most useful features in Dash, from terrain creation to mesh & spline primitives, curve tools, camera, water, etc...\
For all things primitives, be it curves or meshes, they're spawned right in front of you when you click on them

#### Common Features

* <mark style="color:blue;">**Create Terrain**</mark>: Creates a mesh-based terrain with various features to deform it with noise, curve its borders, adjust its subdivision level, UV scale, etc...
* <mark style="color:blue;">**Create Water**</mark>: Create a plane with a simple water material.
* <mark style="color:blue;">**Create Advanced Water**</mark>: Create an advanced water volume
* <mark style="color:blue;">**Create Camera**</mark>: Creates a Dash camera, which is a custom UE camera built to give you a quick and easy cinematic look. With a wide range of color grading & aspect presets, lens distortion and much more, this camera is perfect for some quick shots.
* <mark style="color:blue;">**Randomize Material**</mark>: Dash ships with a bunch of color swatch materials, each having a unique color. This action will go through your selected objects, and assign one such material to each one of your objects at random. We find it very practical for quickly separating objects by color.\
  You can press `SHIFT+Click` on the option to assign one color swatch to all of them.\
  Combined with the recent <img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2F9M4m0Yt9UjyF50GVpeoU%2Ftime_color.png?alt=media&#x26;token=dcf44585-0c53-4e33-bac4-5d6b4db2c272" alt="" data-size="line"> feature, you could click on that icon multiple times with `CTRL+SHIFT+Click` on the recent icon to sift through a couple of swatches that are all applied to your selection, or just `SHIFT+Click` on the recent icon to quickly assign random swatches to each object.
* <mark style="color:blue;">**Create Fog Card**</mark>: This is a powerful fog card creation tool. It'll spawn a plane that has a fog material on it, and also the fog card tool, which allows you to adjust the density, distance fade, motion speed, etc...\
  You can at any point select one or multiple of these fog cards, then in the Tools Panel, click on the tools list icon <img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FQATok13ZYIYlvLakX96E%2Flist_color.png?alt=media&#x26;token=50affff8-5982-4378-ae61-4c764c82c2c5" alt="" data-size="line">, and select "Edit Fog Card" to batch edit all your selected fog cards at once.
* <mark style="color:blue;">**Spawn Character**</mark>: Spawns a simple 3D character, which is useful for keeping track of your environment's scale, or just as a blockout thing before you swap it with your final character.
* <mark style="color:blue;">**Spawn Dash Box**</mark>: Spawns a cute little box with the Dash logo on it :)
* <mark style="color:blue;">**Create Falling Leaves**</mark>: Create a blueprint volume of falling leaves that can be adjusted to get the perfect look.

#### Mesh Tools

* <mark style="color:blue;">**Draw Mesh**</mark>: If you need a mesh in a custom shape, our Draw Mesh tool let's you draw any shape and we create a basic mesh in this shape.
* <mark style="color:blue;">**Create Alpha Cards**</mark>: If you've got an alpha/atlas/opacity texture of assets like leaves, debris and other flat 3D objects, this tool allows you to convert that texture to actual meshes, with orientation and pivot options just a click away. A common use case is using it on leaves, then enabling Nanite on them, and scattering them.\
  Keep in mind: In case you're using Megascans' atlas textures, we've got a [quick guide](https://docs.polygonflow.io/getting-started/content-browser/megascans#using-atlases-in-dash) on that.

#### Curve Tools

* <mark style="color:blue;">**Draw Curves**</mark>: Instead of drawing curves/splines by placing points one by one, this interactive tool gives you the ability to just draw curves on your viewport.\
  \
  The Dash bar will switch to the draw curve context, from which you can adjust your curves' point density, smoothing and offsetting.\
  You can even switch the draw mode to "End Points", which allows you to draw a curve between your mouse press point, and mouse release point.\
  Switching to this mode also shows you a gravity property, which makes it quick to realistic add some sagging to your curve.
* <mark style="color:blue;">**Draw Vines**</mark>: This is a simple way of drawing curves in your scene, which then automatically spawns vines alongside them. Once you're done, the vines tool will open up, and allow you to further tweak your newly created vines.
* <mark style="color:blue;">**Create Vines**</mark>: This tools makes it easy to create vines: Give it some surfaces you want to have vines grow on, and some origins, like an empty actor or even a curve, and they'll be used as the source of the vines from which all growth happens.
* <mark style="color:blue;">**Create Roads**</mark>: This is a powerful road creation tool that can be used for much more than just roads. Besides the usual width/edge sink and whatnot, you have extensive geometry features to subdivide it, adjust the density, smooth it, add noise (which makes it useful for cave walls!) and much, much more.
* <mark style="color:blue;">**Create Cables**</mark>: Feed this tool multiple meshes, and it'll scatter cables on them. There's multiple modes that allow you to scatter cables, or just use the input object positions as your source points, etc...
* <mark style="color:blue;">**Create Pipes**</mark>: Simple, fast and powerful pipe creation tool. Like the cable and road tool, the Parallel width feature set of this tool makes it extremely useful for usages beyond basic pipes.

#### Mesh Primitives

* <mark style="color:blue;">**Create Plane**</mark>: Creates a plane with fairly high density.
* <mark style="color:blue;">**Create Box**</mark>: Creates a box/cube.
* <mark style="color:blue;">**Create Sphere**</mark>: Creates a sphere.&#x20;
* <mark style="color:blue;">**Create Cylinder**</mark>: Creates a cylinder.
* <mark style="color:blue;">**Create Disc**</mark>: Creates a disc.
* <mark style="color:blue;">**Create Rounded Cylinder**</mark>: Created a cylinder with rounded borders.

#### Curve Primitives

* <mark style="color:blue;">**Create Line**</mark>: Creates a simple spline/curve line.
* <mark style="color:blue;">**Create Square**</mark>: Creates a square curve.
* <mark style="color:blue;">**Create Rounded Square**</mark>: Create a rounded square curve with beveled corners.
* <mark style="color:blue;">**Create Circle**</mark>: Create a circle curve.

### Menu Features

Let's go through all the features available in the menu, which is a three dots icon <img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2Fyhm1Mqc9TMLslvbGvxoZ%2Fdots_color.png?alt=media&#x26;token=aaad039b-f70f-4816-9f5a-b09296fdb01f" alt="" data-size="line"> on the left corner of the Das bar:

<figure><img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FgTCSr7Lulk0MACyL54Ir%2Fimage.png?alt=media&#x26;token=48849235-9826-4a29-ad2d-fb04278fa552" alt=""><figcaption></figcaption></figure>

* <mark style="color:blue;">**Documentation**</mark>: Clicking on this will open the documentation in your default web browser.
* <mark style="color:blue;">**Discord**</mark>: This will open up your web browser, and invite you to join our Discord, which we really recommend whether you're facing an issue, wanting to share art, or just chatting with artists :)
* <mark style="color:blue;">**Tutorials**</mark>: This is a link to our YouTube channel, which features a bunch of videos covering all kinds of use cases.
* <mark style="color:blue;">**Website**</mark>: A link to the **polygonflow\.io** website.

Then we have the Layout section:

* <mark style="color:blue;">**Toggle Scale**</mark>: This will switch between the three scale modes of the Dash bar, its shortcut is **CTRL+E**.
  * Full: This is the default mode, and shows the name of all dropdown menus in the Dash bar.
  * Minimal: This mode hides all the dropdown names, and sticks to an icons only UI.
  * Icon Only: This one collapses the Dash bar into one single icon <img src="https://1971338676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYp9tAkqjcwFDufAaviIa%2Fuploads%2FiTIT6b2dVSgPB7HaJoin%2Fdash_blue.png?alt=media&#x26;token=d27eca42-859e-4250-8793-0aff2456c3db" alt="" data-size="line">. Clicking on this icon will show your favorites and recent commands.
* <mark style="color:blue;">**Toggle Responsive UI**</mark>: This will switch between the Full, Minimal and Icon only modes.
* <mark style="color:blue;">**Move to Left/Right/Center**</mark>: You can change where the Dash bar is snapped by default with these options. Those positions are at the top of the viewport, left of the viewport, and right of the viewport

And finally, the "Others" section:

* <mark style="color:blue;">**Preferences**</mark>: This opens up the Dash preferences panel.
* <mark style="color:blue;">**Check for Updates**</mark>: Quick way of seeing if there's a new Dash update.
* <mark style="color:blue;">**License Manager**</mark>: This is where you can activate/deactivate a license, start a trial, etc..
* <mark style="color:blue;">**Close Dash**</mark>: Simple action to close the Dash bar. You can also hit **Escape** twice in the Dash bar for the same effect.
