Please note that this is a BETA version of the document. All information presented is correct but we are working on improving the details. |
Introduction
In this document, we will describe the connections you have to create in Aximmetry DE.
Basic connections
Aximmetry DE can connect to Unreal Engine in two different ways, each one is useful in a different scenario
Cooked mode
This is the default connection mode in Aximmetry DE.
Aximmetry directly loads the content generated by Unreal, so running a separate Unreal Editor is not needed. This mode should be used in production because it provides the highest performance. This is what you have used so far.
In Cooked mode, Aximmetry uses the cooked version of the project which is generated when you press Aximmetry / Cook Content for Aximmetry DE in Unreal.
This means that if you edit the scene in Unreal, you have to cook the project again. You can leave Aximmetry running with the Unreal Project module in Cooked mode - it will pick up the changes when cooking is finished and reload the project automatically. If you added/removed/changed any Aximmetry nodes in the Unreal blueprint as described in section 4.1, after cooking the project, Aximmetry will detect the change and a red chain-link button will show up in the upper right corner of the module. Click on this button to update the pin list.
Live Sync
Aximmetry connects to a standalone Unreal Editor instance. This is useful while you are building your scene in Unreal, because it lets you interactively edit and test the scene, without having to cook it after every change.
In Live Sync mode, Aximmetry connects to the running Unreal Editor when you press the Play button. This is when the Unreal Project module will pick up the changes in the pin list as described above. Click on the red chain-link button to update the pin list.
By default, the Unreal Editor runs in a reduced performance mode when it is not the active application which causes a significant decrease in framerate in Live Sync mode. To disable this behavior, untick the "Use Less CPU when in Background" option in Edit / Editor Preferences / Performance / Editor Performance. If you run the scene in a separate editor window (as described below), it will still run in a reduced performance mode when it is minimized, so do not minimize this window.
To use Live Sync:
- Press Play in Unreal Editor for Aximmetry.
- In Aximmetry DE select the unreal project file in the Flow editor.
- Set the Connection pin to Live Sync.
- Now you should see the same image both in Aximmetry and in the Unreal Editor
You can stop and start both the Unreal scene and the Aximmetry compound or even the Unreal Editor and Aximmetry itself, and the connection will be re-established automatically.
The resolution of the viewport is set automatically based on the value of the Out Size pin just like in Cooked mode. If the scene is running in a separate window, the window is also resized.
Workflows
For each workflow, you have to place the proper Aximmetry camera in the unreal scene. This is described in the Preparing Your Unreal Project To Be Used With Aximmetry DE document.
Drag-and-drop the camera compound into the Aximmetry DE Flow editor and connect the pins which you can see on the images.
Virtual Camera
For virtual cameras you can use the following compounds:
[Common_Studio]:Compounds\VirtualCam_Unreal\VirtualCam_Unreal_A-B_Preview_3-Cam.xcomp
[Common_Studio]:Compounds\VirtualCam_Unreal\VirtualCam_Unreal_A-B_Preview_8-Cam.xcomp
[Common_Studio]:Compounds\VirtualCam_Unreal\VirtualCam_Unreal_A-B-C_Preview_3-Cam.xcomp
[Common_Studio]:Compounds\VirtualCam_Unreal\VirtualCam_Unreal_A-B-C_Preview_8-Cam.xcomp
In the example below we are using the VirtualCam_Unreal_A-B_Preview_3-Cam.xcomp compound.
You can see the connections here:
Pins
The pins starting with Cam * are sending data in connection with the virtual camera. (For example, the Cam Transform pin sends the position and rotation of the camera)
The pins starting with B* are sending data about the Billboards. (For example, B1 Data sends the position of Billboard 1)
The B1 *, B2 *, B3 * pins correspond to Billboard 1, Billboard 2, and Billboard 3.
Please note that on the screenshot we have only connected the B1 * pins corresponding to Billboard 1. If you want to use more Billboards, you have to connect them as well (B2 *, B3 *).
Tracked Camera
For tracked cameras you can use the following compounds:
[Common_Studio]:Compounds\TrackedCam_Unreal\TrackedCam_Unreal_Prev_3-Cam_3-Billboard.xcomp
[Common_Studio]:Compounds\TrackedCam_Unreal\TrackedCam_Unreal_Prev_8-Cam_3-Billboard.xcomp
In the example below we are using the TrackedCam_Unreal_Prev_3-Cam_3-Billboard.xcomp compound.
You can see the connections here:
Pins
Out Size
Control Data
Mixed Camera
For mixed cameras you can use the following compounds:
[Common_Studio]:Compounds\TrackedCam_Unreal\MixedCam_Unreal_A-B_Preview_3+3-Cam.xcomp
[Common_Studio]:Compounds\TrackedCam_Unreal\MixedCam_Unreal_A-B_Preview_8+8-Cam.xcomp
In the example below we are using the MixedCam_Unreal_A-B_Preview_3+3-Cam.xcomp compound.
You can see the connections here:
Since Mixed cams are simply a mix of tracked and virtual cameras, the connections will also be a mix of them. This is why (just like before in the Virtual Camera workflow part) we have only connected Billboard 1. If you want to use more billboards, connect the rest of the B* pins as well.
AR with Tracked Camera
For AR with tracked cameras you can use the following compound:
[Common_Studio]:Compounds\TrackedCam_Unreal\TrackedCam_AR_Unreal_Prev_3-Cam.xcomp
You can see the connections here:
Pins
Reflection * are only necessary if you have added reflection catchers to your scene. (More on this in the Preparing Your Unreal Project To Be Used With Aximmetry DE article)
The same applies to Shadow and Shadow Clean Plate.
LED-wall Camera
For LED-wall cameras you can use the following compound:
[Common_Studio]:Compounds\LEDWallCam\LEDWallCam_Prev_3-Cam_4-Wall.xcomp
You can see the connections here:
Pins
F1, F2, F3 & F4 Rendered are the frustum for each LED wall.
LED Wall 1, 2, 3, and 4 are the outputs for the LED walls.
For all of the above, connect as many as you would like to use.
Passing data between Aximmetry DE and Unreal Engine
We have separate documents for