User Interface#

On this page, you will find a description of all aspects of our user interface.

Viewport#

This is where you can view your simulations, shapes, forces or anything that’s in the scene.

viewport
  1. move section icon Using left mouse button dragging, you can use this icon to rearrange the UI layout by moving the 4 main sections.

  2. Scene is the default tab where you can view and manipulate everything.

  1. home icon Dropdown menu of the available cameras. Here you can select which camera you want to look through.

viewport
  1. view icon Dropdown menu of all the things that can be hidden or viewed in the Scene tab.

    • Simulation M (15)

    • Bounding Box B (14)

    • Unlit Mode U Minimizes the shading complexity. This will significantly speed up the render speed and can be useful when you want better performance when working on your simulation and don’t need to see the final shading.

    • Shapes H (16)

    • Backplates Shift+B This will toggle the backplate visibility. Backplates can be added in the Camera node.

    • Masking This visualizes all the voxels containing something.

    • Manipulators Shift+Q (17) This toggles the visibility for the transform, rotate, or scale manipulators.

    • Manipulator Switcher This shows the Move move icon (8), Rotate rotate icon (9), and Scale scale icon (10) buttons.

    • Entity Icons (18) show the node icons on the node position. In this case, the Line Force node. Clicking on an entity icon will select the corresponding node.

    • Render Quality will open a menu to its right where you can pick either Low Ctrl + 1, Medium Ctrl + 2, or High Ctrl + 3

      In certain cases, like when using Flames translucency, you can get a lot of banding when you look up close at your sim. Setting a higher render quality will help to deal with this.

      You can also lower the render quality to gain performance.

      Low, Medium, and High are presets that can be edited in Settings>Preferences>Viewport Quality

    • Stats (22)
      • Resolution: The resolution of the viewport in pixels.

      • Simulate: The time it takes in milliseconds to do a single simulation step.

      • Render: The time it takes in milliseconds to render the simulation.

      • UI Framerate: How many times per second the UI is updated

      • VRAM: The amount currently used GPU memory vs total available memory.

      • Particle Count The amount of present particles created by Particles nodes.

  2. fullscreen Icon Toggle panel fullscreen

  1. Viewport orientation gizmo. You can left mouse button click on the dots to orient the view to that axis. Or left mouse button click and drag the sphere to rotate the view.

  2. Sky: These settings are controlled in the Skybox node.

  3. Ground: These settings are controlled in the Ground node.

  1. Force Gizmo Most foces have a gizmo using light blue arrows showing the direction of the velocity injected by the force.

  2. Inner Bound of the selected force. The transparent area of the inner bound shows the area where the force is at 100%.

  3. Outer Bound of the selected force. The darkened area shows the transition area where the force goes from 100% on the inside to 100% minus the Falloff percent (so by default 0%) on the outside.

render tab
  1. Render is the tab where you can preview what will be exported.

    1. view icon View Dropdown where you can toggle the visibility of the stats.

    2. Render nodes dropdown menu. Here, you can select which Render node you want to preview.

    3. Capture Types dropdown menu. Here, you can select which Capture Type you want to preview.

    4. attention icon No Capture Type mapping warning. Seeing this icon means that there is no Capture Type mapping setup in the Render node. You can click on this icon to automatically set one up.

    5. settings icon Toggle render settings. This will show or hide the render settings (13,14) Render Settings

    6. Zoom in or out.

    7. Zoom to fit the whole tab. Checking this will disable 6

    8. zoom Default Icon Set the zoom (6) back to 100%

    9. Toggle the crop gizmo.

    10. Crop in the horizontal and vertical axis.

    11. Crop vertical.

    12. Crop horizontal.

    13. General render settings

    14. Capture Type specific render settings.

export tab
  1. Export is the tab Here you can View your exported flipbook or the last frame of your exported sequence.

    1. Channels. left mouse button click on any of these buttons to view the Red, Green, Blue, or Alpha channels individually, click on the channel again to go back to viewing Red, Green, and Blue together. Ctrl + left mouse button click on a channel to add or subtract it from the channel selection.

    2. Capture Type. A dropdown menu of the mapped capture types where you can select which capture type you want to view the export of.

    3. Flipbook. Format used for games where all the frames are stored in one image. You will only see this if the Export Mode in the Export tab of the Render node was set to Flipbook.

    4. Export viewer. Shows the exported files.

    5. Current Flipbook Frame, indicated with a thin light border. You can left mouse button click on any frame to set it to the current frame.

    6. icon_back Go To Start. Set the playhead to the beginning of the timeline. (the timeline in the Export tab)

    7. icon_prev_frame Go to the previous frame.

    8. icon_play Play or pause the export.

    9. next_frame Go to the next frame.

    10. icon_forward Go To End. Set the playhead to the end of the timeline.

    11. icon_loop Loop. This will toggle if the export will restart playing from the beginning or stop when it reaches the last frame.

    12. icon_skip_frame Skip Frame. This will toggle of the player will skip frames when necessary to keep up with the selected framerate or not.

    13. Current Frame. Displays the current playback frame. You can also left mouse button click within this box to set the current frame manually.

    14. Timeline. Horizontal representation of all the exported frame numbers.

    15. icon_scrubber_small Playhead. Sits at the current frame on the timeline. You can left mouse button click and drag the playhead to move through the timeline viewing different frames.

    16. Frames Per Second. Fps at which the export is played back. The higher this number the more “sped up” the playback seems. Try setting this to your target framerate, 24 fps for when you are working on a movie for example. This way you can see what the speed in the final result will look like.

Node Graph#

This is where the building blocks to create the simulation are managed. You can think of it as if the wires represent data connecting one piece of the setup to the other.

node graph
  1. move section icon Using left mouse button dragging, you can use this icon to rearrange the UI layout by moving the 4 main sections.

  2. search icon Open search box. left mouse button Clicking on this will open a search box where you can type a node name or a part of the name to quickly select that node.

  3. list view icon Toggle graph tree. (9)

  4. icon_randomize_seeds Randomizes all seed parameters of all nodes containing them. This can be a quick way to get a variation on an effect. For example, if you use noise forces or shapes when making an explosion, you will get a unique explosion every time you click this icon!

  5. fit To View Icon Move view to center of nodes.

  6. focus node icon Move view to center of selected nodes.

  7. zoom Default Icon Reset zoom to default.

  8. fullscreen Icon Toggle panel fullscreen

  9. Graph Tree Here you’ll find all the nodes represented in a list. You can use the unfold icon icon to get a dropdown menu of nodes that are connected to an input pin of the node.

  10. Node

  11. Input pins

  12. Connection wires

  13. Output pin

  14. node toggle icon Toggles whether a node is enabled. Shift + left mouse button to toggle for all selected nodes.

Timeline Editor#

This is where time is visualized from left to right.

For a description of how to use this editor check out our Timeline Editor section.

timeline editor
  1. move section icon Using left mouse button dragging, you can use this icon to rearrange the UI layout by moving the 4 main sections.

  2. fit To View Icon Fit view to all keys

  3. fit To View Icon Fit view to selected keys

  4. zoom Default Icon Reset the vertical zoom to default in the Curve Editor.

  5. fullscreen Icon Toggle panel fullscreen

  6. reset Icon Reset R Reset the simulation to the beginning of the timeline.

  7. previous key icon Move the playhead to the previous keyframe Left

  8. play Icon Play or pause the simulation Space

  9. next key icon Move playhead to the next keyframe Right

  10. next frame Move to the next frame/simulation step Z

  11. icon loop Toggle Loop L When looping is on you’ll see the looping area represented in blue in the timeline editor. This blue bar can be moved around by left mouse button clicking and dragging the middle or scaled by left mouse button clicking and dragging the edges.

  12. Toggle between displaying the timeline in seconds or frames. Shift + F

  13. Scrollbar for the timeline.

  14. search icon Here you can search for a specific parameter in the list of animated parameters.

  15. curve mode icon Toggle Curve Editor ` For a description of how to use this editor check out our Curve Editor section.

  16. autokey icon Toggle Timeline Autokey A With this on a keyframe will be added at the playhead when changing the value of a parameter with keyframe animation enabled.

  17. curve mode icon Toggle Timeline Sync D With this one the playhead is always at the same position as the stimulation time. So the blue line and the pink line can’t be split up when playing.

  18. curve mode icon Toggle Follow Playhead F With this on, the timeline will be panned to always keep the playhead in the middle of the editor.

  19. icon_scrubber_big Playhead Indicates the current time on the timeline.

  20. This indicates the current time the simulation is at.

  21. Frame number.

  22. Node with a parameter that has keyframe animation on it. You can use the unfold icon icon to hide or show the animated parameters.

  23. play icon timeline Enable or disable the keyframe animation for the node. When disabling this the parameters of the node won’t change over time anymore but will keep the values they had when toggling this button off.

  24. eye icon Hide or Show the curves for all parameters of this node in the Curve Editor.

  25. play once icon Specify the curve continuation. Set the keyframe animation for this parameter to either play once icon Play Once, loop icon Loop (restart the animation at the end), or ping pong icon Ping Pong (plays the animation forwards then backwards then forwards, and so on.)

curve continuation
  1. Parameter Here you can set the parameter value for the current frame.

  2. play icon timeline Enable or disable the keyframe animation for the parameter. When disabling this the parameter won’t change over time anymore but will keep the value it had when toggling this button off.

  3. eye icon Hide or Show the curves for this parameter in the Curve Editor.

  4. Keyframe

export image curve
  1. This button can be found on an Export or Import node.

    For an export node, this will toggle a different view where you can see and edit how the frames will be exported.

  1. Shows the duration of the sequence that will be exported.

  2. This indicates what part of the timeline will be exported. This bar can be moved around.

  3. Information on the controls of the editor. These will change to showing keyframe controls when hovering over a keyframe.

Properties Panel#

properties panel
  1. move section icon Using left mouse button dragging, you can use this icon to rearrange the UI layout by moving the 4 main sections.

  2. Node Details: This tab shows all the parameters for the selected node.

favorites tab
  1. Favorites This tab shows all the parameters that are marked as favorites.

    You can do this with any parameter from the Node Details tab by checking the star icon favorite right next to it.

    Clear All will remove all the items from the favorites list. All the star icons will be unchecked.

timeline tab
  1. Timeline: This tab shows all the parameters with keyframe animation enabled.

    Clear All will remove all the items from the list. Note that this will remove all animation!

  2. search icon This will open a search box to find the parameter you are looking for regardless of the tab you are in.

  3. key filter icon Only show the parameters with keyframe animation regardless of the tab you are in. This is different from the timeline tab since this only shows animated parameters of the selected node instead of all nodes.

  4. move icon This will open a dropdown menu with the options to reset or randomize all parameters of the selected node or tab.

  5. fullscreen Icon Toggle panel fullscreen

  6. Parameter tab: All nodes have their own collection of parameter tabs.

override states
  1. Cycle Override State: Clicking on this will cycle through the different override states for the parameter.

  2. Parameter name: Hovering over this will show a description of what the parameter does.

  3. Checkbox: This can set a parameter on or off.

  4. Value Slider: You can left mouse button within this box to type in the value you want. Or left mouse button and drag to change the value.

  5. reset Icon Reset to the default value.

  6. favorite Mark as favorite: This will make the parameter appear in the favorites tab.

  7. Current software version.

To quickly jump to a parameter you can use Ctrl + P.

Project Manager#

project manager
  1. Return to the normal user interface with the project you’re currently in.

  2. Minimize the Embergen window.

  3. Maximize the Embergen window.

  4. Close Embergen.

  5. Projects/Presets list

  6. Specify if you want to sort by date or by name.

  7. Search for a project. This is especially useful when looking through our long list of presets.

  8. Project/Preset: This represents a .ember file that was either recently worked on by you or provided as a preset with Embergen. left mouse button on a project to open it.

  9. Set the list to show the projects you recently worked on.

  10. Set the list to show the Embergen presets.

  11. Set the list to show tutorials on how to use Embergen.

  12. Link to our discord server where you can get help, give feedback on the software, or show off things you made.

  13. Link to our forums.

  14. Open the default preset.

  15. This opens a file browser where you can look for a .ember file to open.

  16. Links to the JangaFX social media pages.