//
//  Unity Dome Kit version 1.1 (2015/4/15)
//
//       ORIHALCON Technologies, Inc.
//

This Unity package enables multi-projection Unity contents in a dome theater environment.
When use it in actual environment, you will need a calibrated distortion and blending data for there.
It may also require special hardware to work with. Please ask its detail to ORIHALCON Technologies, Inc. (info@orihalcon.co.jp)

This package provides following two types of dome projection systems.

1) FrustumCamera : From one computer, displays dome contents with multiple projectors with normal/wide lenses.
    You can develop your content without Unity Pro license. When you display it in actual dome environment,
    You'll need special hardware for distortion and blending.

2) WarpCamera : From one computer, displays dome contents with multiple projectors with fisheye lenses.
    You need Unity Pro license for developing. You also need ObjReader plugin ($10).
    When you display it in actual dome environment, you'll need a calibrated distortion and blending data
    made by AMATERAS Dome Player (http://www.orihalcon.co.jp/amaterasplayer/en).
    (This function was developed based on Paul Brouke's article at http://paulbourke.net/dome/unity3d/)

>> FrustumCamera

* How To Install (prepared by Dome Theater)

Edit Assets/StreamingAssets/frustumcamera.xml file. Make <channel> node for each projector.
Write its display region in the extended display area in "viewport" attribute.
Make its frustum settings as separated file and write its path to "path" attribute.
In your Unity scene, add FrustumCamera Prefab to its Main Camera (tagged as "MainCamera").

* Runtime properties for FrustumCamera.

  Show Projection Output: Display for projection. (Display usual Main Camera view when disabled.)
  Tile Angle: Horizon line angle from front dome edge.
  Show Dome Grid: Display a dome grid.
  Dome Tilt Angle: Tilt angle of the dome grid.
  Dome FOV: Field-of-view angle of the dome grid.

>> WarpCamera

* How To Install (prepared by Dome Theater)

Edit Assets/StreamingAssets/warpcamera.xml file. Copy the calibrated data into this folder.
Write a path to a distortion file (.obj file) at path "attribute" of <distortion> node.
Write a path to a blending file (.png file) at path "attribute" of <blending> node.
In your Unity scene, add FrustumCamera Prefab to its Main Camera (tagged as "MainCamera").

* Runtime properties for WarpCamera.

  Show Projection Output: Display for projection. (Display usual Main Camera view when disabled.)
  Tile Angle: Horizon line angle from front dome edge.
  Show Fish Eye: Show fish-eye (Domemaster) view at left upper corner.
  Show Dome Grid: Display a dome grid.
  Dome Tilt Angle: Tilt angle of the dome grid.
  Dome FOV: Field-of-view angle of the dome grid.
