Asset placement

This tutorial takes you through the process of adding your first procedure, referencing an unreal asset, and placing it in the scene.

Primary Goals

  • Working with the Apparance Editor
    • Creating a procedure
    • Naming and categorising a procedure
  • Building Procedures
    • Finding operators
    • Adding operators
    • Connecting operators together
    • Creating procedure inputs and outputs
  • Placing and adjusting procedural actors in Unreal

Secondary Goals

Instructions

  1. In a new or existing project, create a new default level (or open an existing one), that has some lights and maybe a floor in it.
  2. Open the Apparance Editor (Apparance → Open Editor)
  3. Right click in the empty Procedures panel and select "Add new procedure"
  4. Select "new procedure" to edit it's name and category in the property panel on the right
    1. Click the Category property and change the name to "Test"
    2. Use the Tab key to accept edits and move to the next property
    3. Change the Name property to "My First Procedure"
    4. Add a description if you fancy
  5. Double-click the procedure in the Procedure panel to open it
  6. You can use Right to pan the main view and Wheel to zoom in and out.
  7. In the Operators panel type "Resource" into the search filter
  8. Drag instances of the "Resolve" and "Place" operators listed out into the procedure outline
  9. Hook up the procedure:
    1. Select the Resolve operator and set the Descriptor to "Apparance.Test.Mesh"
    2. Drag a wire from the ID output of the Resolve to the ID input of the Place
    3. Drag a wire from the Where? input of the Place operator just outside the left of the procedure outline (to create an input)
    4. Drag a wire from the Object output of the Place operator to just outside the right of the procedure outline (to create an output)
  10. Press the Save button at the top-left of the Apparance Editor window or Ctrl+S
  11. Back in the Unreal Editor, place and play with the new procedure:
    1. Drag an Apparance Entity from the Place Actor panel into your scene
    2. Locate the "Apparance" properties category in the Details Window
    3. Select your "First Procedure" in the Procedure drop-down (currently None)
    4. Adjust the Size fields of the "Where?" property that appears to rebuild the object at difference sizes

Results

Your procedure should look something like this:

Next Steps

Note
This tutorial has set the groundwork for the Custom Asset tutorial that you may want to follow next.
Note
You could also try the First Geometry tutorial if you are interested in trying out the experimental geometry generation features of Apparance