The Igloo Camera Package
Small paragraph explaining what is in the camera package. And an exploded view of how it all joins together.
- Explain what the Igloo360CameraRig component does
...
Camera
Drag the Igloo360Camera actor from Content > Igloo into your scene. This is the object which renders the 360-degree output and makes it available to the Igloo Warper Application.
On the details panel of the Igloo360Camera, there is a drop down selection named "Object to Follow" which allows you to specify which actor in the scene the camera position should follow. Alternatively, if you uncheck "Follow Object" and the camera will follow the default player in the scene.
Adjusting the OSC plugin
OSC - go to Edit > Project Settings and scroll down Plugins > OSC. Set 'Receive From' to 9008, and set the Send target 0 to 127.0.0.1:9001 then select 'Set as Default'
Adjusting the Player
In your GameMode settings, set the DefaultPawnClass to be IglooFlyingPawn. You can use your own player pawn class, however the IglooFlyingPawn can be controlled using the Igloo Xbox controller which has directional tracking device.
Adjusting the Inputs
When using the Igloo pawn class you need to set up the input axis mappings. Go to Edit > Project Settings > Input and add two axis mappings named 1. "MoveRight" where 'D' key has scale value 1 and 'A' key has scale -1. 2. "MoveForward" where 'W' key has scale value 1 and 'S' key has scale -1Within the Inspector for the igloo360Camera, there is a Gamma modifier slider. Change the value to 1.8 if using Laser projectors, or 2.2 if using Blub projectors. This can be configured post build so don't worry if you are unsure!
This will stop the colour looking dark, and faded.
Player
** If you do not require the ability to manually control the movement of the camera you should skip this section **
There is a customised Igloo Pawn which can be used to control the movement of the camera. You can also use your own, however, the benefit of using the Igloo Pawn is that it supports controlling the orientation of the player using a gyroscope-enabled controller such a the Steam controller. This makes controlling the player very intuitive while standing inside an igloo as can be seen here. https://drive.google.com/open?id=0B4BAsDcbBoGhUDZielNMSFlCRTg
To use the Igloo Player Pawn: In your GameMode settings, set the DefaultPawnClass to be IglooFlyingPawn.
Preview
Included in the package is an app for previewing the output of the 360 Camera, Igloo Preview. Press play in the Unreal Editor and you will scene the 360-degree output rendered to the Igloo Preview app.
Note - The view in Igloo preview does not apply the required distortion to the Unreal output, as such you will see discontinuation in the output.