Вы находитесь на странице: 1из 46

Amateras Dome Player ver.3.

USER'S GUIDE
The sixth edition, March. 29th, 2019
Contents
1. Amateras Dome Player ����������������� 4 7. Quick dome projection setup ������������20
Ease of use as a specialized software for dome How to setup the dome projection���������������20
projections��������������������������������� 4 Techniques���������������������������������21
Simple high-res movie playback and frame cache ��� 4
Advanced dome preview tool������������������� 5 8. Dome experience with HMD�������������22
Virtual projection of a flat image(slide)  ����������� 5 Setup for Oculus Rift��������������������������22

Special video effects and transitions�������������� 5 Display the theater environment model�����������23

Management of visual contents in File Library������ 5 Control in Oculus Rift mode ��������������������23

Automation by Playlist ������������������������ 6 Points to notice for Oculus Rift������������������24

Projection of live streaming and desktop capture���� 6


9. Display a panorama in dome�������������25
Integrated control of dome environment���������� 6
Spherical panorama by RICOH THETA�������������25
Exporting sequential image files and video conversion 6
Further control with scripting������������������� 7 10. Amateras for content creators������������27
Simulating dome theater environment ����������� 7 Simultaneous multi-angle viewing���������������27
System Requirements������������������������� 7 Composite flat contents As Slides����������������27
Differences between versions������������������� 7 Color correction for projection environment �������28
Export images and movies ���������������������29
2. Introduction ������������������������� 8
Display an image on your dome screen ����������� 8 11. Desktop capture streaming��������������30
Movie playback control������������������������ 9 How to use desktop capture��������������������30
Supported File Formats �����������������������10 Display a PowerPoint presentation���������������31

3. View Styles ��������������������������11 12. Display a stereoscopic dome content ������32


Change view styles���������������������������11 Preparation of stereoscopic dome contents��������32
Dome Master �������������������������������11 Display in Oculus Rift �������������������������33
Stretched ����������������������������������12 Stereoscopic Projection �����������������������33
Wide View����������������������������������12 Passive Stereoscopic Projection �����������������33
Overview ����������������������������������12 Active Stereoscopic Projection������������������33
Camera������������������������������������13
Cube Map����������������������������������13 13. Theater control by Amateras�������������34
Oculus Rift ���������������������������������13 Virtual lighting ������������������������������34
Projection / Mirror Warp�����������������������14 Lighting control by DMX protocol ���������������34
Projection / OmniMap ������������������������14 Projector control by Amateras ������������������35
Projection / Projection ������������������������14
14. External control of Amateras�������������36
Reset the view ������������������������������14
Using MIDI controller device��������������������36

4. Show flat contents in the dome�����������15 Remote control of Amateras��������������������38


Layout a Slide�������������������������������15
15. Automation by Playlist �����������������39
Show a content in the slide���������������������16
Add a content to Playlist�����������������������39
Assign a Player ������������������������������16
Multiple contents and sorting�������������������40
Detail settings and Presets ���������������������16
Looping and waiting cue ����������������������41

5. Effects ������������������������������17 Save and load the playlist����������������������41


Add Effect����������������������������������17 Time scheduled show control�������������������41
Reuse of effect settings������������������������18
16. Encoding high resolution movie����������42
Source Mask and Color Correction ���������������18
17. Scripting in Amateras ������������������44
6. Transitions���������������������������19
Basics of scripting����������������������������44
Apply a transition����������������������������19
Typical script usages��������������������������45

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 3
1 Amateras Dome Player

Easy-to-use for beginners, and a lot to explore for high-end users;


Amateras Dome Player is the most powerful tool
to utilize the full potential of fulldome theaters.

Amateras Dome Player is an advanced movie player specially designed for fulldome shows, allowing you to directly play high-
resolution fulldome movies (visual data in dome master format). No more complex procedures for playing fulldome movies.
In addition to playing movies, you can also control theater instruments and simulate auto-play shows on this single software.
Amateras Dome Player is under continuing development, assuring that the fulldome theater environment is accessible for
anyone who appreciates its possibilities.

Ease of use as a specialized software for


dome projections

Amateras Dome Player (Amateras) has been developed based


on experience of various dome projection practices. Each
aspect of Amateras, such as simple drag and drop feature and
an intuitive interface with easy access to varieties of functions
for dome projections, is optimized for ease and versatility of
dome projection. Solving all the problems and difficulties,
Amateras lets you focus on the creative part of your work.

Simple high-res movie playback and frame cache

Amateras can directly handle high resolution images/videos, applying necessary adjustments for the projector or display during
playback. No time-consuming conversion or adjustment (cutting / slicing materials), which is traditionally indispensable, is
needed. Also, it guarantees smooth high resolution playback by always prefetching data. By preparing data for playback with
accompanying free encoder, you can immediately play your own video onto dome screen.

4 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Advanced dome preview tool

Amateras Dome Player


Amateras is now widely recognized as an essential preview tool for fulldome
show production. It lets you preview fulldome video in various different ways
from inside or outside of a virtual dome theater. Sequentially numbered
frames can be played as well, allowing you to preview your work from an
early stage of production. It is also compatible with the latest head-mounted
display called “Oculus Rift”; you can experience a seamless view just as you
would in an actual dome theater.

Virtual projection of a flat image(slide)

You do not need to bring another projector to add a flat


image; just add as many virtual projectors as you wish on
Amateras to display “Slide” images onto the dome screen.
Positions and sizes are adjustable through interactive drag-
and-drop operation. Select image source and layout at will,
either same or different for each slide.

Take advantage of virtual projectors to display a flat screen


contents in a big size with minimal distortion.

Special video effects and transitions

Together with the latest graphics technologies, Amateras can


apply special effects and adjustments on your visual data on
the spot. You can adjust colors to get a brighter picture, or
add visual effects on your contents for real time decoration.

There are also varieties of transition effects available, and even


more to be added in later edition.

Management of visual contents in File Library

You can manage your visual contents using File Library. The list of
your contents is shown with preview icons for easy access. Double-
click on an icon to display corresponding visual data either on the
whole dome screen or in the selected slide area. Synchronization of
files is available in a multiple PC environment.

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 5
Automation by Playlist
Amateras Dome Player

Create a visually accessible playlist for continuous playback or


other advanced automation.

Using user-friendly GUI you can set a program with


combination of operations, such as partial playback, cue
operations, lighting, projectors and other theater device
controls.

Projection of live streaming and desktop


capture

Video Capture function lets you display live captured video


through a web camera or high definition video capture card
(up to 4K@60p) with minimal distortion. You can also capture
a portion of the desktop, so that a web browser or PowerPoint
presentation, for example, can be displayed in big size onto
dome screen.

Integrated control of dome environment

In addition to dome movie playback, Amateras gives you full


control of audio, projectors, lighting, and other related devices
as well. Virtual light function makes handy theater lighting
with no additional equipment.

Such an integrated theater system with Amateras can be


remotely controlled with mobile devices such as iPhone and
Android.

Exporting sequential image files and video


conversion

Amateras supports playback of sequential image files, and


video export of various display modes. You can, for example
convert dome master to wide view, or adjust distortion and
blending, (called “Slicing”).

A handy 360-degree spherical panorama camera called


“RICOH THETA” is compatible with Amateras; panorama
photos taken with RICOH Theta can easily be displayed
on dome screen, or converted and export in dome master
format.

6 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Further control with scripting

Amateras Dome Player


All the features in Amateras can be controlled though scripting.

Using scripts, you can set up more sophisticated automation programs and
establish more complex systems. It is also possible Advanced networking with
external devices through TCP/UDP, MIDI, DMX, or serial port.

Simulating dome theater environment

Amateras flexibly supports different types of systems, from


simple system with a single projector and single PC to high-
resolution system with multiple projectors and PCs. Using
the integrated advanced simulation function, you can design
your own projection system or make on-site adjustments.
Regardless of the type of your system Amateras always
provides a platform for simple dome movie playback and
enhanced theater control.

System Requirements

Supported operating systems are:

• 64-bit version of Windows 7 and later.


• Mac OS X 10.9 or later.

A high-performance CPU and 3D graphics are required for smooth movie playback. Amateras is tested under the development
environment with:

• NVIDIA GeForce and NVIDIA Quadro graphics


• Intel Graphics HD 4000 or later

High resolution playback or some of the effects may not work properly without graphics cards/chips listed above.

Differences between versions

Amateras Dome Player is available in different editions. “Free Version” is available to anyone for download. “Product Versions"
are for professional use. Following functions are not available in Free Version. (A flying logo will be overlaid.)

• Sequential image files export


• Spherical mirror / stereoscopic projection
• Real time projection correction output
• Export of projection correction results
• Synchronization over LAN

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 7
2 Introduction

Just drag and drop your Dome Master image, movie or fish-eye picture to watch it.
You'll be in your content.

Dome Master is the world standard


image format for dome visualization
to show the image in dome
environment without distortion.

You should prepare your contents


as this Dome Master format to
display on dome screens. Basically
the Dome Master format is a circular
image like a photograph taken at
the center of a dome with a fish-
eye lens. Its bottom edge will be Dome Master format Picture taken with a fish-eye lens

displayed at front, the center will be


at the ceiling of the dome. Technically the 'distance' from its circle edge is in proportion to the 'elevation angle' from the edge of
the dome. You can find more detailed specification, production tools, available contents and other information at the following
link.

http://www.fulldome.org/

Display an image on your dome screen

Launch Amateras Dome Player application by double clicking


its icon.

It contains some dome content samples. Open "contents"


folder in your Amateras folder by Explorer (Windows) or Finder
(Macintosh). In its "Mille Fiore" folder you can find many Dome
Master images and one movie. Now select "auroraNight.jpg"
Drop a content file into Amateras

8 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
image file and drop it on the main black area of Amateras
application. You can see the image displayed on the dome

Introduction
surface.

Let's view the full dome image from inside. Select [View] tab
of the application window, click [Styles] button at left side
and select [Wide View] in its pull down menu. Now you see
the image as if you were standing at the center of the dome,
with a very wide field of view. Drag with left mouse button to
look around, and use wheel of the mouse to change the field
of view. Enjoy the feeling of being surrounded by a full dome
visual.

[Left Drag] : Look around


[Mouse Wheel] : Field of view

Wide View by [Style] button in View] tab

Access to contents by File Library

Like an image file, you can display a full dome movie by drag
and dropping the movie file on Amateras. Now try opening
in another way. File Library is a visual tool to manage many
contents. You can select a content to show from this tool.

If you don't have "File Library" panel at right side, select


[Playlist] tab and click [Library] button to show it. In this panel,
files and folders are listed with icons and names like usual file
managers. You can switch its representation between icons
and list styles by clicking button at top right corner. At
first it shows "contents" folder, so double click "Mille Fiore"
folder icon to find the Dome Master files again. In this files,
double click "feedback.mp4" icon to play this movie. You can List and Icon view in File Library

play your favorite contents easily from this File Library, so you
should keep them somewhere in "contents" folder.

Movie playback control

While showing a movie, you can control it via Play Control Bar
at the bottom of the application window. Play , Pause
and Stop buttons are found at the left side, and toggle
Looping at the right side on the bar. you can also seek the
movie by dragging a slide.

Play Control Bar

[Space] : Play and pause the current movie


[Shift]+[Space] : Seek to the beginning
Double click in File Library

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 9
Supported File Formats
Introduction

Amateras supports the following file formats:

• Image: JPEG, BMP, PNG, TIFF, TGA


• Movie: AVI, Windows Media Video (.wmv), QuickTime (.mov), MPEG (.mp4, .mpg etc.)
• Sound: WAV, MP3, AIFF, Windows Media Audio (.wma)

To play high resolution movies smoothly, you should encode (transcode) your movie or image sequences to Amateras' own file
format (.mp4) using Amateras Encoder application. Playback of up to 3K pixel 30 fps Dome Master movies is guaranteed in this
format.

Beware that Amateras doesn't play sound embedded in the movie file. By encoding with Amateras Encoder, or placing a sound
file beside the movie file (e.g. movie.mp4 and movie.wav in the same folder) to play them simultaneously.

10 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
3 View Styles

Amateras has various view styles to show the dome content.


You can check your content from inside or outside of the dome
to understand what it would look like on your dome screen.

Change view styles

You can change your View Style by clicking [Styles] button


in [View] tab to watch dome contents from inside or outside.
You can switch the View Styles anytime with this button or
shortcut keys.

Dome Master

In [Dome Master], Dome Master content is displayed as it is.


Other kinds of contents are displayed in square aspect ratio.
The Dome Master view is good for overviewing the whole
content. It's also used in single fish-eye projection at the
center of the dome.

[D]: Switch to Dome Master view

Dome Master view

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 11
Stretched
View Styles

In [Stretched] view, any contents are displayed to fill the


whole view area ignoring its aspect ratio. This Stretched view
is useful for showing a sliced content in full screen mode.

Stretched view

Wide View

In [Wide View], you can look around the dome content from
inside with very wide field of view. Drag with left mouse
button to look around, and use wheel of the mouse to change
the field of view. By dragging with right mouse button you
can adjust the height of the bottom edge line. This Wide View
is useful to watch a dome content as if you were standing
inside the dome. It's also useful for quick setup of single fish-
eye projection to fill most of the dome surface from edge of
the dome.

Wide view [W] : Switch to Wide view


[Left Drag] : Look around
[Mouse Wheel] : Field of view
[Middle Drag] : Height of the view point
[Cursor Keys] : Look around
[PageUp/[PageDown] : Field of view

Overview

In [Overview], you can see the whole dome screen from


outside. Drag with left mouse button to rotate the view, and
drag with right mouse button to adjust the distance from
center of the view. Use wheel of the mouse to chage the field
of view, and dragging with middle mouse button to move the
center of the view.

[O] : Switch to Overview


[Left Drag] : Rotate view
[Right Drag] : Distance from the center
[Mouse Wheel] : Field of view

Overview

12 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Camera

View Styles
In [Camera] view, you can watch a dome content from anyware inside the dome. Drag with left mouse button to look around,
and use wheel of the mouse to change the field of view.
You can move around with [Ctrl]+[Cursor keys], and move
up or down by [Ctrl]+[Page Up] or [Ctrl]+[Page Down] keys.
Gamepad is also useful to move around in the dome. In this
[Camera] view, the dome content is displayed as if you saw it
through a normal camera lens. Straight line looks straight as it
is, but it seems strange in very wide field of view.

[C] : Switch to Camera view


[Left Drag] : Look aound
[Mouse Wheel] : Field of view
[Cursor Keys] : Look around
[PageUp/[PageDown] : Field of view
[Ctrl]+[Cursor Keys] : Move around
[Ctrl]+[PageUp/[PageDown] : Move up or down

Camera view

Cube Map

In [Cube Map] view, a dome content is mapped onto each


face of the Cube Map. Cube Map is a technique to represent
surrounded environment with six square faces of a cube
around the view point. This is a common way of rendering
immersive contents from 3DCG software without any special
plugins. This Cube Map view is useful for rendering Dome
Master contents to Cube Map format.

Cube Map view

Oculus Rift

In [Oculus Rift] view, you can see a dome content with Oculus
Rift, a VR head mount display, as if you were inside the dome.
Drag with left mouse button to adjust the front direction. You
can move around with cursor keys, and move up or down
with [Page Up] or [Page Down] keys. Gamepad is also useful
to move around in the dome.

[U] : Switch to Oculus Rift view


[Left Drag] : Adjust front direction
[Cursor Keys] : Move around
[PageUp/[PageDown] : Move up or down
Oculus Rift view

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 13
Projection / Mirror Warp

In [Mirror Warp] view, you can project a dome content to


almost whole dome screen with a spherical mirror. This [Mirror
Warp] is compatible with Paul Bourke's mesh file format.
You have to choose a correct mesh file depends on your
View Styles

projector's aspect ratio. Choose a proper mesh file in bin/


correction/mirrorwarp folder and replace default.data with
it. For more information about the mesh file and its format,
check his website: http://paulbourke.net/dome/warpingfisheye/

* Free version displays a flying water mark in this view style.

Mirror Warp view

Projection / OmniMap

In [OmniMap] view, you can project a dome content with Eluminati's fisheye lenses. For more information about adjusting
OmniMap SDK, check his website: https://github.com/elumenati/omnimap/.

* Free version displays a flying water mark in this view style.

Projection / Projection

In [Projection] view, adjusted realtime image warp and blend correction are applyed for correct projection. To adjust the
projection correction, click [Setup] button in [Theater Control Tab]. For more information about adjusting projection correction,
check other "Image mapping setup guide" document.

* Free version displays a flying water mark in this view style.

Reset the view

You can reset the position and rotation of the view by


clicking button in [View] tab.

[R]: Reset the view point

14 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
4 Show flat contents in the dome

Amateras can display usual flat images, movies and live videos naturally on the dome screen.
You can show as many images as you want around you.

Layout a Slide

Amateras can display a usual flat content on the dome screen by projecting it using
a virtual projector. This projected flat content is called Slide, named after old slide
projectors. You can add as many slides as you want, and put them anywhere on the
dome screen interactively.

Let's add a slide. In [View] tab, click [Styles] button to select [Dome Master] to see the
whole dome screen. In [Slides] tab, click [Add] button to add a slide in the front of the
dome (bottom area of the Dome Master). Added orange line region shows where a [Add Slide] button to add a slide
slide content will be displayed.

You can move this slide region by dragging with left mouse
button, and resize it with right mouse button. You can add
more slides by clicking [Add] button, so try adding some more
slides and arrange them as you like.

Left drag to move, right drag to resize

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 15
Show a content in the slide
Show flat contents in the dome

In the Dome Master view, you can select the slide region by clicking it with left mouse button. If you click background area,
slides are deselected and dome content gets selected. This selection tells Amateras that on which target you want to do the
following operations like load and play.

Now click one slide region to turn it to orange color. Next, double click an image file in "Slides" folder of File Library panel to
display it in the selected slide region.

Assign a Player
Content files
With the slides, you can display single content in multiple
slides, or display different content in each slide and control
them independently. “Player” is available for managing each
content source. Amateras has one dome content player and
several for slides. You can assign a player to each slide to
determine which content to show.

To assign a player, select one slide and select [Player] in [Slides]


tab. If you want to display the same content in multiple slides,
assign the same player to them. If you want to control them
independently, assign different players to them. When you
load a content, it will be loaded by the player of currently
selected slide. Your operations at Play Control Bar or in [Player]
tab will be done on this player.

Slides and Players

Detail settings and Presets

You can change the layout of the slide and view settings in
detail in [Slides] tab. Once you have made a favorite slide
setting, select [Add...] menu at the end of [Preset] in [Slides]
tab to store it as a named preset. You can restore this slide
setting anytime from this [Preset] menu. Add a Slide Presets

16 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
5 Effects

Amateras adds new Effect feature to decorate dome contents in real-time.


Color correction, special effects for interactive performance and more.
Make new things happen in your dome!

Add Effect

To add an effect on the current dome or slide content, open [Effect] panel by
clicking [Effect] button in [Player] tab. In a list view of this panel, "DomePlayer"
is selected if dome content is selected (slides are deselected), or "SlidePlayer1"
is selected if a slide is selected. You can apply an effect to the selected player
independently. Now click and select "DomePlayer" in the list, and open "alt.jpg" file
in "Mille Fiore" folder of the File Library.

Click button in [Effect] panel, and select [Image]/[Billboard] menu. Image on the
dome screen is now displayed as big dots style! Change [Grid Size] slide to change Apply an Effect

the size of dots interactively. You can add more effects on this
layer, remove the current one by button or remove all by
button.

Try each effect and have fun!

Billboard Effect

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 17
Reuse of effect settings
Effects

Once you have made a favorite effect setting, select [Add...] at the bottom of [Current] in [Player] tab to store it as a named
preset. You can restore this effect setting anytime from this [Current] menu.

Effects added in [Current] tab of [Effect] panel are applied to the current content only. So if you open a next content, all the
effect settings will be removed. If you want to keep the effects, open [Common] tab and add effects in this tab.

[Common] effect tab

Add a Effect Preset

Source Mask and Color Correction

"Source Mask" and "Color Correction" effects are commonly used to improve the projection environment. So these effects are
available in [View] tab of the application. If you select [Dome Edge] from the [Source Mask] button, pixels outside of Dome
Master circle will be masked.

If you want to use more complicated mask shape, make a gray scale image file (black part becomes invisible) and load it from
[Mask File...] of [Source Mask] button.

In Color Correction dialog opened by [Color Correction] button, you can adjust the color of content in real time. Check [Enabled]
box and change the [Brightness], [Contrast] and [Saturation] in this dialog to improve your projection quality in your dome.

Apply Source Mask effect

Color Correction dialog

18 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
6 Transitions

From the current content to the next one, new Transition function repaint whole dome visual
with stunning effects. Impressive tool for presentations and scene changes.

Apply a transition

When you begin to play a new content, you can use special
Transition effects between the current content and the new
one. You can select transitions for each player independently,
for dome content and each slide content.

To select a transition, select a target player by clicking a slide


or background dome content area. From a pulldown menu
of [Transition] in [Player] tab, you can select a transition for Select a transition

the current player. Open some contents to check how the


transitions work. In [Dur.] of the [Transition] you can set the
duration of the transition in seconds.

Page Curl transition Wind transition

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 19
7 Quick dome projection setup

You can begin a dome projection with only one projector and fish-eye lens
which fill most part of the dome surface.
Amateras has a very quick setup method within ten minutes for this type of projection.

How to setup the dome projection

Single fish-eye projection is the easiest way to realize almost


full dome projection. This chapter describes how to setup this
type of dome projection with Amateras.

If you put a fish-eye lens projector at the center of the dome


toward the ceiling of the dome, you can fill the whole dome
screen surface with it. But with this setup, only around the
center of its image panel is used. So you get relatively dim
and low resolution result. Another way of the projection is
put a fish-eye lens projector at the back side of the dome and
fill the most part of (around 2/3 of) the whole dome screen.
This setup is not completely full dome projection, but you get Dome projection from center
brighter and higher resolution result.

Either way, fix the projector position tightly and adjust its
focus. Connect the projector to your computer, and switch
to dual screen mode to see both your control screen and a
screen for projection.

Launch Amateras and move it inside the control screen.

Dome projection from back side

20 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Click [Projection] button in [Window] tab to open Projection
window. Select [Dome Master] (when you put the projector at

Quick dome projection setup


the center) or [Wide View] (when you put it at the back side) in
its [View] menu. Then move this Projection window to screen
for projection, and select [Full Screen] in its [View] menu to
switch it to full screen mode. Check [Screen Grid] box of [View]
tab to display a screen grid to check how it is projected on Control screen Projection screen
the dome screen. If you put the projector at the back side,
drag with left mouse button to adjust front direction and tilt angle of the
dome interactively. If the edge of dome grid doesn't fit to the dome edge,
drag with middle button to shift the projection image, and then adjust
the tilt angle with left mouse button again. If you're accustomed to this
Show Projection window
calibration work, it takes less than one minute.

Now you are finished with the dome projection setup. Use Amateras in the control screen as usual to do your dome
presentation.

* If you want more precise calibration or multi projection setup, try [Projection Setup] and consider purchasing Full License of Amateras.

Techniques
• If you lose sight of the Projection window, check if [Projection] button in [Window] tab
is on and click [Reset] button in this tab to restore the position and size of the window.
• In some display environment such as 4K projection with multiple video cables, full
screen mode doesn't fill the whole screen area. To fix it, open Option Settings dialog
from [Settings] button in [Window] tab. Check [Custom Size] box of Full Screen group
and set the position and size of the full screen region in pixels.
• If your computer is not powerful enough, a high resolution movies may not run
smoothly in dual screen mode. To improve the performance, switch the display mode
to Clone (same image on both the monitor and the projector). Close the Projection
window, then click [Full Screen] button in [Window] tab to switch to the full screen
mode. In this setup you can control the playback of your content by small head
up display. You should load content before entering the full screen mode. You can
terminate Amateras application by [Ctrl]+[Q] shortcut. Next time you drag'n drop a
content file to Amateras' icon, Amateras will be launched in full screen mode and show
the dropped content immediately.
Full screen region

Switch to full screen mode

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 21
8 Dome experience with HMD

By using the latest VR head mount display called Oculus Rift,


you can watch your dome contents just like you watch it sitting in a virtual dome.
It's a revolutionary new way to enjoy the dome contents personally.

Setup for Oculus Rift

For watching a dome content without actual dome theater


environment, the best way is using a head mount display
with tracking sensor, such as Oculus Rift. You can sit down the
best seat in virtual dome, or any seats you want, to enjoy your
dome content and check how the content looks distorted
from each position.

Get an Oculus Rift device (currently CV1 and DK2 are available
in Windows environmet. DK2 and DK1 are available in
MacOSX environment.) and its latest runtime device driver
from Oculus' web site. Install the driver and connect its cables
to your computer. Supply power to the device and turn it on.
© KAGAYA Studio
In Windows environment, select [Oculus Rift] style in [View]
tab to display with the Rift.

In MacOSX environment, the Rift seems as an additional


monitor. Click [Projection] button in [Window] tab to open
Projection Window, and select [Oculus Rift] in its menu. Move
this window to the Rift's desktop area, then click [Full Screen] button in [Window] tab to switch the Projection Window to full
screen mode.

Play your favorite dome content by double clicking it in the File Library. Now put the Rift on, and you can look around the virtual
dome screen.

22 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Display the theater environment model

Dome experience with HMD


Let's display seats and other facility object models in the dome theater. Push [Esc] key to switch to the normal window mode.
Check [Environment] box in [View] tab is checked. Click a small [] button at the corner of [Screen] in [View] tab to open [Dome
Screen Settings] dialog. Select [Hitach Civic Center] in [Preset] of the dialog and close it. Click [Full Screen] button in [Window]
tab to switch to the full screen mode. Put the Rift on again and look around. Use cursor keys to walk around, and use [PageUp]/
[PageDown] keys to move up or down. Sit down any seats you want in the virtual dome, and enjoy your favorite contents.

Display a dome theater model

Overview of the dome theater environment

Control in Oculus Rift mode

While putting the Rift on, you can't see keyboard and other
GUIs, so you should learn important key shortcuts. [R] key
resets the view position and direction, so you can go back to
the center of the dome anytime. [Space] key to play or pause
the movie, and [Shift]+[Space] keys to seek to the beginning
of the movie. You can play the next file in the same folder by
just hitting [Enter] key. By moving the mouse cursor, a small
head up display (HUD) for playback control appears. You can
set visibility and size of this HUD in Option Settings dialog
Oculus Rift view
from [Options] button in [Window] tab.

HUD in fill screen mode

[U] : Switch to Oculus Rift view


[Left Drag] : Adjust front direction
[Cursor Keys] : Move around
[PageUp/[PageDown] : Move up or down
[R] : Reset the view point
[Space] : Play and pause the current movie
[Shift]+[Space] : Seek to the beginning
[Enter] : Display the next file in the same folder

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 23
Points to notice for Oculus Rift

Oculus Rift setting method depends on OS environment. You should also check the latest information online.

• In Windows, download and install the latest runtime driver and firmware. Get them from the Oculus website and install them
before connecting the device. or the first time you use Rift with Amateras, launch Oculus Home application by double clicking
Dome experience with HMD

Oculus icon. Select [Settings] menu from a gear icon at top-right corner. Select [Devices] and check [Unknown Sources]. After
this setting, you can use Rift with Amateras by selecting [Oculus Rift] view style in [View] tab.

• In MacOSX, currently the latest Oculus runtime is not available. Download the latest runtime in the archive and install it.
Launch OculusConfigUtil tool in Applications/Oculus/Tools folder. Select [Tools] > [Rift Display Mode] in menu, and select
[Extended Desktop to the HMD], then click [Apply] button to close the dialog. When you connect your Oculus Rift DK2 for the
first time, it may be recognized as a portrait screen. Open [Displays] in System Preferences and switch it to Proper layout. In
Amateras, open [Option Settings] dialog by clicking [Settings] button in [Window] tab, select [Maximum Frame Rate] to [60].
Enable [Status Info.] in [View] tab, and check FPS value in the Oculus Rift. FPS value should be around 75 to run the Oculus Rift
DK2 properly.

24 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
9 Display a panorama in dome

Watch a panorama scenery as it is.


Dome is the best place to enjoy panorama contents. You can see the scenery as if
you were standing there. Let's start the easiest way to create a new dome content.

Spherical panorama by RICOH THETA

RICOH THETA is very handy device to capture full spherical


panorama pictures. Once you took panorama pictures, copy
them to your computer. To copy them, connect the THETA to [Panorama Coonversion]

your computer and use Explorer or iPhoto. If you don't have a


THETA, you can find some sample panorama images taken by
THETA in "RICOH THETA" folder in the File Library. Let's display
one of the panorama images. It's not Dome Master format,
so at first it's not displayed properly. By clicking [Panorama
Conversion] button in the [View] tab to open Panorama
Conversion dialog. In the dialog, check [Enabled] check box
Panorama image
and confirm [Panorama > Dome Master] is selected in [Mode]
combo box.

Now you can convert this panorama image to Dome Master


format internally.

Converted to Dome Master

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 25
In this dialog, you can adjust horizontal direction, tilt angle

and field of view. To use a trackball device for interactive


Display a panorama in dome

operation, check [Trackball Mode] in this dialog.

Change the view style to [Wide View] or [Camera] by [Style]


Panorama Conversion dialog
button in [View] tab to watch the panorama image. You

can look around by dragging with left mouse button, and use

mouse wheel to zoom in and out. If you are using a touch

panel display, change to full screen mode by [Full Screen]

button in [Window] tab and enjoy the full screened interactive

panorama with gestures. Of course if you are doing the dome

projection, you can see the panorama image as if you were

standing at the place again where you took this picture.

Hit [Enter] key to display the next panorama image in the


Full spherical panorama image
folder ([Shift]+[Enter] to previous one). This is a quick way to

do a panorama slide show. Select a favorite transition and

enjoy your virtual panorama trip in your dome.

Interactive panorama view with a tablet

26 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
10 Amateras for content creators

Amateras becomes indispensable tool for dome content creators.


You can simulate what your content looks like in the dome environment.

Simultaneous multi-angle viewing

For previewing a dome content, the best way is using VR HMD such as Oculus Rift. Without such special devices, Amateras also
provides simultaneous multi-angle view, for example to check your dome contents in Wide View and Dome Master view at the
same time. To open an additional view, click [Sub View] button in [Window] tab. Select this new sub view and use [Style] button
in the [View] tab to change its View Style. You can arrange the layout of sub windows by clicking [Split] button in [Window] tab,
and resize views by dragging borders of them.

Add a sub window Layout sub windows

Composite flat contents As Slides

By using the Slide function, you can naturally composite your flat images and movies in Dome Master format. It simulates a
virtual projection, so you can adjust its physical parameters to minimize distortion on the curved dome screen surface.

Click [Add Slide] button in [Slide] tab to add a new slide region. Drag it with left mouse button to move it, resize with right
mouse button, and enter values in [Slide] tab to adjust its representation in detail. Using Wide View or Oculus Rift is helpful to
check what it looks like in the dome.

While this slide is selected with an orange color line(selection by clicking left mouse button), play an image or a movie by drag
and drop or from File Library. The content appears tightly inside the slide region while keeping its aspect ratio.

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 27
If you put a flat content on the dome screen in large size, you'll notice a barrel like distortion from off-center positions. To reduce
this distortion, increase [Distance] value in [Slide] tab to project the flat content from farther than the center of the dome. You
Amateras for content creators

can see this layout example by selecting [Large] from [Preset] menu in [Slide] tab.

"Large" preset

Left drag to move, right drag to resize

Color correction for projection environment

In the dome theaters, your content seems dimmer and less contrast than your monitor or
HMD. It comes from many reasons, such as lamp power of projectors, internal reflection of
the screen and the theater, and so on. To improve the projection quality, Amateras provides
a real time color correction function. While displaying your content, click [Color Correction]
button in your [View] tab to open Color Correction dialog. In this dialog, check [Enable]
box and adjust [Brightness], [Contrast], [Saturation] and so on to find the best settings
Color Correction dialog
interactively for your dome theater environment. Product versions of Amateras can export
this color corrected result as sequential image files. But the contrast and color balance of
the projection varies with lamp consumption time of the projectors, so you should do the color correction in real time with the
Amateras player.

28 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Export images and movies

Amateras for content creators


Amateras can export its displaying image as a high resolution
image file. Product version of Amateras also exports the
displayed movie as sequential image files for encoding to
any kind of movie formats. With these functions, you can use
Amateras as a converter tool for Dome Master contents. For
example, you can convert your dome master content to wide
angle preview movie. Using its slide function, you can convert
flat contents to Dome Master format for large size projection Save As Image dialog
in domes. Panorama contents can also be converted to Dome
Master format, by enabling [Panorama] button in [View] tab.

To export the displayed content as an image file, click [File]


tab and select [Save As Image File...] menu in it, then set
resolution, file name and so on. To export as sequential image
files, select [Save As Seq. Image Files...] menu in [File] tab.
Amateras logo is overlaid on the sequential image files with
Free edition. When exporting image files, rendering quality is
more important than real time playback performance.
Save As Seq. Images dialog
To improve the quality, open Option Settings dialog by
clicking [Settings] button in [[Window] tab, then increase
values in [Performance and Quality] group. Notice that if
your graphics power of your computer is not enough, higher
quality settings may cause rendering errors.

Quality settings for exporting

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 29
11 Desktop capture streaming

Amateras is not only for dome content playback.


Desktop capture streaming is a new way to bring other real-time contents to your dome.
Presentation slides, web pages, video streaming, interactive games, and much more!

How to use desktop capture

Amateras can capture a part of your desktop and project onto


the dome, as a dome master source or flat content projection
as a slide. With this desktop capture function, you can show
your PowerPoint presentation, YouTube video, Twitter
messages and so on in your dome theater with distortion
correction. It opens a new door of your dome usage. To begin
desktop capture, prepare at least two-screen mode, one for
control and one for dome projection, not in Clone mode.

Desktop capture
Click [Projection] button in [Window] tab to open a Projection
window. Select [Wide View] view style for it, move it to the
projection screen and maximize it by [Alt]+[Enter] keys. On Amateras in the control screen, add a
slide by clicking [Add Slide] in [Slide] tab and place it somewhere you like. [Large] preset in [Slide]
tab may be good for testing. Now select [Start Desktop Capture...] in [File] tab to open a Desktop
Capture dialog and a blue region frame.

The Desktop region within this blue frame will be captured as a source of the desktop capture.
Drag it to move or resize to fit the region you want to display. Near the corners of this frame, you
can see magnified pixels around the corners for guiding precise adjustment. You can also specify
the top-left position and the size of capture region in pixels in Desktop Capture dialog. After
defining the region, double click the frame or click [OK] button in the dialog to begin the desktop
Switch to Expand mode
capture. The captured image is transferred to the current player, then displayed on the dome
screen.

30 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Try moving your web browser window or something else to display it in your dome theater.

Desktop capture streaming


Projection screen

Control screen

Display a PowerPoint presentation

Showing a PowerPoint presentation as a slide is typical use of the desktop capture function. To do this, run the presentation in
your control screen and transfer this image using desktop capture. As described in the previous section, setup the projection
and define whole area of the control screen as a capture region. Open your PowerPoint presentation, and set the target in
[Slideshow] tab to [Main] monitor. If you start the presentation, the full screen image is
displayed in your control screen and also on the dome screen as the captured source.
You can use the PowerPoint as usual, and you can place this image anywhere in the
dome, or even make copies for circular seat layout domes.

Try to find your own unique and effective dome presentation styles.

Desktop capture region

Settings in PowerPoint

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 31
12 Display a stereoscopic dome content

Amateras can display stereoscopic dome images and movies


with Oculus Rift or many types of stereoscopic monitors and projectors.

Preparation of stereoscopic dome contents

To display a stereoscopic dome content with Amateras, the


most simple way is using Double Dome Master format. Put
your left and right dome master images side by side (or top by
bottom), and encode them as a single movie file. This format
goves perfect synchronization, and you can edit it easily.
Stereopscopic panorama contents are also available in same
way.
Double dome master format

You should put "@stereo" or "_LR" keyword in the file name


of your side by side stereoscopic content, like aurora2014_@
stereo.mp4. For top by bottom stereoscopic content, use "_
TB" keyword. Amateras recognize a file with this keyword as
double dome master format file, then display the content to
your each eye correctly. If you can not change the file name,
select [Stereo] Menu in [Player] tab to force Amateras to treat
this file as stereoscopic or monoscopic content.
Specify stereoscopic format

32 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Display in Oculus Rift

Once Amateras recognize your dome content as stereoscopic format, Oculus Rift can display it as it is. To set up the Oculus Rift
propertly, check "Dome experience with HMD" chapter.

Display a stereoscopic dome content


Stereoscopic Projection

There are two stereoscopic projection methods, Active and Passive. For Passive projection, you need two projectors, polarizing
filtes, glasses and a silver screen. Infitec filter is also useful for Passive projection with a normal screen. For Active projection, you
need a stereoscopic-ready projector, LCD shutter glasses and professional graphics card like NVIDIA Quadro or AMD FireGL.
Choose a proper method depends on your hardware environment. For projection
setup, check "Quick dome projection setup" chapter.

Passive Stereoscopic Projection

Amateras can display both left and right projection image from a single computer.
Set up two projectors to fill the same scfeen area, and put polarizing filters in front
of them in correct angle. Check the displayed image on the silver screen through
polarizing glasses, as your each eye saw different images in the screen. Connect these
projectors to your computer, and put them side by side on the right of your "Main"
display. Desktop region of the projectors are defined in coordinate whose origin is top-
left corner of the "Main" display. Calculate combined two projector's desktop size, like
3840x1080 (two FullHD projectors).

Launch Amateras, click [Settings] button in [Window] tab to open Option Settings
dialog. Check [Custom Size] box in [Full Screen] and input the combined projector's
desktop region like "left, top, width, height", like "1920, 0, 3840, 1080". Select
[SideBySide] in [Stereo Layout] menu and close the dialog. Click [Projection] button in
[Window] button to open Projection Window, and select [Wide View] or your favorite
view style in its [View] menu. Select [Full Screen] in [View] menu or hit [Alt]+[Enter]
keys to seitch to full screen mode. Now you can display left and right images with two Stereo Layouts

projectors properly.

Active Stereoscopic Projection

Active stereoscopic display with LCD shutter glasses requires professional graphics card like NVIDIA Quadro or AMD FireGL.
Enable [QudBuffer Stereo] in their control panel before launching Amateras. Enable the stereoscopic mode in monitors or
projectors too.

In Amateras, click [Settings] button in [Window] tab to open Option Settings dialog. Select [Frame-Sequencial] in [Stereo Layout]
menu and close the dialog. Click [Projection] button in [Window] button to open Projection Window, and select [Wide View]
or your favorite view style in its [View] menu. Select [Full Screen] in [View] menu or hit [Alt]+[Enter] keys to seitch to full screen
mode. Now you can display left and right images with stereoscopic-enabled monitors or projectors properly.

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 33
13 Theater control by Amateras

Amateras can control many theater facilities such as projectors and lighting.
It plays not only the dome contents but everything in the dome together.

Virtual lighting

The simplest way to light the dome theater is using a bright image projection. Virtual Light
function of Amateras overlays additional light pattern images on the dome content as a simple
lighting function. Click [On] button of [Lighting] in [Theater Control] tab to overlay a light image.
You can change its color with sliders beside. For setting the Virtual Light in detail, click a small
button at the corner of [Lighting] section to open Light Settings dialog. You can specify an image
file of the light in this dialog. If you have made a favorite setting, click [Add] button to store it as a
named preset. You can restore this Virtual Light setting anytime from [Theater Control] tab.

Light Settings

Lighting control by DMX protocol

DMX protocol is 512 channels array of values in 8-bit


resolution (0 to 255) values, commonly used for theater
lighting control. To access to DMX devices from computers,
you need a USB-DMX interface box. Amateras supports
Kuwatec's DoctorMX DMX device for DMX input and output.

Virtual Light You can control your Theater lighting via this device, or you
can control Amateras itself with common DMX controller
devices.

34 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
To use DMX lighting, install a DoctorMX driver and connect
the device to your computer with a USB cable. Launch

Theater control by Amateras


Amateras application, and click [Control] button of [I/O
Devices] in [Theater Control] tab to select [DMX] and open
DMX Controler window. Check [Enabled] in [File] menu to
connect to the DoctorMX device. In [Channels] menu you
can add or remove a DMX channel to control. If you connect
DoctorMX, DMX-USB interface box
your lighting devices with DMX cables, you can control the
brightness of them with sliders of their channels in this dialog.

If you connect a DMX controller device, enable [Record] of


[Log] menu and check the logged values when you use sliders
of the device. You can assign these values to some functions
of Amateras with JavaScript.
DMX control

Projector control by Amateras

Amateras can control multiple projectors via LAN or RS-232C


serial connection. Click [Control] button of [Projectors] in
[Theater Control] tab to open Projector Manager window.
Check [Edit] in its [Edit] menu, then select your projector
model or PJLINK protocol from [Add] menu to add a projector.
Set the name of projector, IP address or COM port for
control. Projector names are used to distinguish them when
controlling them independently.
DMX Controler dialog

Once you have added projectors correctly, select projectors


in the list and control their power, shutter, input selection,
and so on from this dialog. Quick control of all the projectors
is also available in [Theater Control] tab. These projector
controls can be used in Playlist, so you can make automated
daily show control with lighting and projectors together.

* PJLINK is one of the common projector control protocols over LAN. Projector control
Check if this PJLINK access is available or not in your projector. If you
use it with Amateras, disable its password authorization settings of the
projectors.

Projector Manager dialog


Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 35
14 External control of Amateras

You can add special input device to operate Amateras.


Amateras also has special remote interface for wireless devices such as smartphones.

Using MIDI controller device

MIDI controllers are popular and affordable input devices for musical instruments. A MIDI
controller device sends signals such as Note, Control Change and Pitch Bend, each of which
has 7-bit resolution (0 to 127) value. Amateras can use a MIDI controller as an external
controller and receive these signals from its buttons or sliders, and use these values for control
functions via JavaScript. Some MIDI controllers have several input channels to light its LED
lights. Amateras can send MIDI values to control them too.

As an example, let's use Steinberg's CMC-TP MIDI interface device with Amateras. Install its
device driver, then connect it to your computer via a USB cable. After the device is recognized
properly, launch Amateras application. Click [Control] button of [I/O Devices] in [Theater
Control] tab to select [MIDI] CMC-TP

and open MIDI Controller


window. Check [Enabled] of its [File] menu, and also select
[Select Devices...] menu in its [File] menu to open MIDI
Settings dialog. If the CMC-TP is recognized properly, you
can select it from [Input] and [Output] pull down menu of
this dialog. Select them and click [OK] button to connect to
it. Check [Record] of [Log] menu, and push some buttons of
CMC-TP device. You can see changes of channel values in the
MIDI Controller window. For example, when you push Loop
button of CMC-TP, the channel value of Note-86 becomes
127, and it becomes 0 again when you release the Loop
button. Let's assign this change of value to call a function of
Amateras.
MIDI controler srtup

36 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Click [Connections] button of [I/O Devices] in [Theater Control]
tab of Amateras to open I/O Device Manager window. Select

External control of Amateras


[Add]/[MIDI] in its [Edit] menu to open Select Channel dialog,
then select [Note] and [86] for the Loop button. When you
click [OK] button of this dialog, a new line will be added in I/O MIDI device selection
Device Manager. Double click its [Script] column, and replace
code as follows.

if (value>0) DomePlayer.toggleLoop()

Now when you push the Loop button, this JavaScript


command is executed with the input value. In this example,
when this value becomes positive (when pushed, not
released), execute DomePlayer.toggleLoop() command to
toggle the loop settings. The JavaScript commands in the
following screenshot define actions for the bottom buttons
of the CMC-TP. You can loop, play, pause and play the current
MIDI value changes in MIDI Controler dialog
playlist with these buttons. You can execute previous or next
item of the current playlist by [<<] and [>>] buttons.

To light the LED light of the loop button, you have to know its
input channel name. Channel name of each LED is described
in "CMC series Operation Manual" which is available at CMC-
TP's support web site. For example, open Script Output
Select a MIDI channel to connect
window by clicking [Script Output] button of [Window] tab
and enter the following command to light the loop button.

MIDI.setNote(0x56,110)

Complete implementation of this button would be like this:

if (value>120) { DomePlayer.toggleLoop(); }
else { val=DomePlayer.getLoop()?110:0; if
(val!=btn) { MIDI.setNote(0x56, val)}; }
Example JavaScript for CMC-TP device

With this JavaScript, you can toggle


the looping by the loop button and
its state is visible by its LED. Refer to
separate Amateras Script Reference
to find a JavaScript command you
need, and assign them to input
MIDI channels to make your own
MIDI controller for Amateras.

CMC series Operation Manual LED of the Loop button

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 37
Remote control of Amateras
External control of Amateras

You can control Amateras remotely over LAN or


wireless LAN by a web browser interface, so you
can do it with your smartphones and tablets such
as iPhone, iPad and Android devices. Click [Settings]
button of [Window] tab to open Option Settings
dialog. Check [Remote Controller] group and click
[Update Contents] button in it. Then access to the
address shown there with web browser in other
computers or smartphones in the same LAN. The
latest content folder is exported when clicking the
[Update Content] button, and you can play them
via remote devices. In iOS devices, you can [Add to
Home Screen] in [Sharing] to launch this remote
controller directly from your Home Screen.

Control screen on iPhone

Enable the remote control

38 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
15 Automation by Playlist

Playlist function is a simple way to automate sequence of your operations in Amateras.


By using time scheduler tool, you can run all shows of the day without operators.

Add a content to Playlist

Open a Playlist panel to edit the playlist by clicking [Playlist] button


in [Playlist] tab. You should also open File Library panel if it's not
shown, by clicking [Library] button in the same tab. Look for
"feedback.mp4" file in "Mille Fiore" folder of the File Library. Drag this
file icon with left button and drop it into the Playlist panel. It opens
Load File dialog with the dropped file name. You can configure its
target player, playback range, transition, effect presets and so on.
When you click [OK] button to close the dialog, a new item with the
content icon will be added in the Playlist panel.
Playlist panel

You are editing the playlist at this moment, so icon


at top-right corner of the Playlist panel is on. When

Load File dialog


you click this button to off, buttons at bottom of the
Playlist panels change to Playback mode and the playlist
becomes read-only mode. Click its button or double

click a file icon to start playing the playlist.

Drag'n drop file icons

Play a playlist

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 39
Multiple contents and sorting
Automation by Playlist

Let's add some contents at once. In "MilleFiore" folder of the File Library
panel, click file icons with [Ctrl] key to select multiple files. If you click
two files with [Shift] key, you can also select all the files listed between
them.

After selecting multiple files, press and hold left mouse button for a
while to grab them, then drop them on Playlist panel to open Load
Files dialog. In this dialog you can set the same settings to all of them.
Click [OK] button of this dialog to close it and add the new items to the
current playlist.
[Ctrl] + Left Click [Ctrl] + Left Click
Playlist shows contents one by one in the list. If you don't need one of
them, select its icon and hit[ Delete] key or [x] button at the bottom
of the Playlist panel. When you delete an item in the playlist, it's only
removed from the current playlist, so the original file in the File Library
still exists.
Load Files dialog

If you want to sort the items of the playlist, drag the file icon to where
you want to insert. You can start playing the playlist from anywhere
by double clicking an icon, but you can also use direct numerical key
shortcuts which is displayed at the corner of the file icons.

[1]-[9]: Play a playlist from specified item

Press and hold to sort items

40 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Looping and waiting cue

Automation by Playlist
If you want to repeat playing the playlist, click [Loop] button at the bottom of Playlist
panel in playback mode.

As a practical example, let's make a playlist which repeats a waiting movie, and start a
main content by an operator's cue. Select [New Playlist] at top-left button of the Playlist
panel to make an empty playlist. Add a waiting movie and a main content to it. Click the
icon of the waiting content with right mouse button and select [Edit Item...] to edit its
settings. Check its [Loop] box to repeat this movie, then close the dialog. When you play
this playlist, the first waiting movie repeats forever. By hitting [Enter] key in the Playlist to
move to the next item, the main content begins to play. Edit the selected playlist item

[Enter]: Execute the next item in the playlist

Repeat this content


Save and load the playlist

To save the current playlist , select Save Playlist] menu from button at top-left button
of Playlist panel. You can place it anywhere you want. If you put it somewhere in the
contents folder, you can play it by just double clicking its icon in File Library.

Save the current playlist

Time scheduled show control

In Windows platform, you can make a time scheduled show control by


using Task Scheduler with Amateras.

Launch Task Scheduler tool, click [Create Basic Task...] and set name and
time schedule of a new task. In its [Actions] tab, input the full file path of
AmaterasDomePlayer.exe followed by a space and the full path of the
playlist file in [Program/script]. Input the full path of the folder which Create Basic Task
contains AmaterasDomePlayer.exe in [Start in]. This task will launch
Amateras and play the specified playlist at scheduled time.

Launch Amateras from Task Scheduler

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 41
16 Encoding high resolution movie

There are various types of movie codecs, so it's difficult to play all of them smoothly.
Amateras provides own GUI encoder (powered by FFmpeg)
for bit rate controlled encoding to guarantee smooth playback.

There are various types of movie codecs, so it's difficult to play


all of them smoothly. Amateras provides own GUI encoder
(powered by FFmpeg) for bit rate controlled encoding to
guarantee smooth playback. If you want to play a high
resolution Dome Master movie such as 2K (2048x2048 pixels)
or 3K (3072x3072 pixels) smoothly, it is highly recommended Amateras Encoder

to use Amateras Encoder to convert it to a bit rate controlled


file. Such conversion process is called Encode (or Transcode, if
converting movie to movie).

Launch Amateras Encoder by double clicking "Amateras


Encoder" icon. Drag and drop a movie file or a folder which
contains sequential image files on this window. It opens
Encode Job Settings dialog. Check if the correct file path
and duration is recognized in this dialog. Enter an output
file path in [Output File] field, and select [Profile] for your Encode Job dialog

target. Profiles which named 2K or 3K mean that movie will


be resized to these square resolutions. If you don't need such
extra resizing or the content is not Dome Master format, select
one of No Resize profiles. Click [OK] button to close the dialog.
A new Encode Job line will be added in the list of the Encoder.
After you have added all the encoding jobs you have, click
[Start All] button to start these encoding at the same time. Added encode job

42 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
[Start Sequential Encode] button runs encoding one by
one, but usually a few encoding jobs run in parallel with no

Encoding high resolution movie


problem. After all the encoding jobs are finished, you can find
the encoded files in the output folder you specified. Amateras
requires a separate sound file if you want to play it with a
movie. Encoding contents

Put a sound file in the same folder of the movie file with the
same file name, for example movie.mp4 and movie.wav.
When you encode a movie which contains sound, it separates
the movie and sound by this rule. If you move these files, do
not forget to move them together.

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 43
17 Scripting in Amateras
Amateras has internal JavaScript engine and all the GUI
and shortcut operations are interpreted as JavaScript commands.
So you can fully automate or remote control Amateras by scripting.

Basics of scripting

The best way to learn scripting is trying it by yourself.

Click [Script Output] button to open Script Output panel. It


has an input area at its bottom, and you can try scripting here.

First, display your favorite movie on the dome screen by drag


and drop it. Then input the following script command in the
Script Output panel and press [Enter] key to execute it. Script Output panel

CurrentPlayer.fadeOut()

This script makes the displayed movie fade out, the same as clicking [Fade]
button in [Player] tab. The script you executed is displayed in upper area of the
Script Output panel as a log to check and reuse.

CurrentPlayer.fadeIn()

This scripts in the movie to display it again.

CurrentPlayer.stop()

Running a script in Script Output panel


This script pauses and seeks the movie to its beginning, and the following script
plays it again.

CurrentPlayer.play()

As described above, each GUI operation in Amateras can be represented as a


script command, and you can do the same operation by using scripts. You can
also examine the current state of Amateras like the following script. Record GUI operations as scripts

CurrentPlayer.getTime()

This script returns the current play position in seconds, and this value is also displayed in the Script Output panel. You can write
a smart script which works differently based on the current state condition.

There is a simple way to find a script command corresponding to each GUI operation. In [Window] tab, click [Script Output] to
display the script output window. Then check [Record] in [Log] menu. While this check box is on, all of your GUI operations are
recorded as script commands and displayed in Script Output panel.

44 Amateras Dome Player USER'S GUIDE Copyright © ORIHALCON Technologies, Inc. All Rights Reserved.
Typical script usages

Scripting in Amateras
There are several ways to use the scripting.

The first one is select [Insert Command]/[Run Script...] by right


click menu in Playlist panel to execute your script in a playlist.
You can execute scripts there to do any operations, which are
not in Playlist commands, or operations based on the current
state.

If you want to execute a script when you launch Amateras


application, make a application shortcut to Amateras and add
a command line options loke the following.

AmaterasDomePlayer.exe -exec "script"

or

AmaterasDomePlayer.exe -execfile "script file name"

In I/O Device Manager window by clicking [Connections]


Script in Playlist panel
button in [Theater Control] tab, you can execute a script when
an input value is changed from TCP/IP, Serial or any other
protocol. You can find this example in "External control of
Amateras" chapter.

Copyright © ORIHALCON Technologies, Inc. All Rights Reserved. Amateras Dome Player USER'S GUIDE 45
Acknowledgement
Sample Contents
• Aurora 8K: Okasan Securities Group/Satoru Itoya
• Mille Fiore: Fulldome Ambient/Fulsako Baba – http://fulldomeambient.com/
• RICOH Theta: Hideaki Fujiwara ( NAOJ), Masaaki Hiramatsu (NAOJ), Kazuhiko Kawai (RIKEN), Satoru Itoya (Scale Factory)
• Slides:SCISS Uniview

Theater Environment Model


• Hitachi Civic Center : LiVE Company ltd. – http://www.live-net.co.jp/

Special Thanks
• Japan Science Foundation / Pleiades System – http://pleiades.jsf.or.jp/
• Prism co., ltd. – http://www.eizou.com/

Amateras Dome Player ver.3.5 USER'S GUIDE


The sixth edition, March. 29th, 2019

ORIHALCON Technologies, Inc.


https://www.orihalcon.co.jp/
info@orihalcon.co.jp