Professional Documents
Culture Documents
3.9
1
SHIRA UNIVERSE USER GUIDE 2021
CONTENTS
Chapter 1 ................................................................................................................ 5
Introduction ...................................................................................................................... 5
Chapter 2 ................................................................................................................ 6
Installation........................................................................................................................ 6
2.1 System Requırements.................................................................................... 6
2.2 Download ..................................................................................................... 6
2.4 Install .......................................................................................................... 6
2.5 License and Terms of Use .............................................................................. 7
Chapter 3 ................................................................................................................ 8
General Display Settings ..................................................................................................... 8
3.1 Display Views ............................................................................................... 8
3.2 Projector Display Settings .............................................................................. 9
3.2.1 Fisheye Lens Projector settings .............................................................................. 9
3.2.2 SpherıcalMirror .................................................................................................. 10
3.2.3 Flat Screen ........................................................................................................ 11
3.2.4 Multiple Projector Warp And Blend Systems .......................................................... 11
Chapter 4 .............................................................................................................. 18
Basic Settings.................................................................................................................. 18
4.1 Control Window Buttons............................................................................... 18
4.1.1 Projector Fader .................................................................................................. 18
4.1.2 Illumination ....................................................................................................... 18
4.1.3 Reset All ........................................................................................................... 19
4.1.4 Screen to Dome ................................................................................................. 19
4.1.5 Settings ............................................................................................................ 19
4.1.5 Projector Controls............................................................................................... 22
4.1.6 Dome Pointer ..................................................................................................... 22
4.1.6 Dark Style ......................................................................................................... 23
4.1.7 Unlock Windows ................................................................................................. 23
4.1.8 Exit .................................................................................................................. 23
4.2 Preview Wındow.......................................................................................... 23
Chapter 5 .............................................................................................................. 24
Manager Window ............................................................................................................. 24
5.1 Sky Manager .............................................................................................. 24
5.1.1 Display Settings ................................................................................................. 24
5.1.2 DateTime & Location Settings .............................................................................. 38
2
SHIRA UNIVERSE USER GUIDE 2021
5.1.3 Target & Scale ................................................................................................... 41
5.2 Media Manager ........................................................................................... 46
5.2.1 Fulldome/ Domemaster Video Player..................................................................... 46
5.2.2 Fulldome Background.......................................................................................... 49
5.2.3 Flat Image Manager ............................................................................................ 50
5.2.4 Flat Video Manager ............................................................................................. 51
5.2.5 Audio Manager ................................................................................................... 52
5.3 Constellation Manager ................................................................................. 53
5.3.1 Constellation Art Options ..................................................................................... 54
5.3.2 Constellation Window Designer ............................................................................ 55
5.5 Messier Catalog .......................................................................................... 55
5.4 Presentation Builder .................................................................................... 56
5.4.1 Presentation Buttons .......................................................................................... 57
5.4.2 Presentation Builder Window ................................................................................ 57
5.4.3 Run Prepared Presentation .................................................................................. 59
5.5 Script Manager ........................................................................................... 60
5.5.1 Scrıpt Fıle Options .............................................................................................. 63
5.5.2 Script Play Options ............................................................................................. 63
5.5.3 Script Recorder .................................................................................................. 64
5.5.4 Fulldome Producer Feature .................................................................................. 64
5.6 Data2Dome Feature .................................................................................... 66
5.6.1 Data2Dome Content List ..................................................................................... 67
5.6.2 Data Page ......................................................................................................... 67
5.6.3 Download Options .............................................................................................. 68
5.6.4 Media Properties ................................................................................................ 68
5.6.5 Play Options ...................................................................................................... 69
5.6.6 Data2Dome Settings ........................................................................................... 69
5.7 Shader Dome ............................................................................................. 70
5.8 Screen To Dome ......................................................................................... 71
Chapter 6 .............................................................................................................. 73
Remote Control Module .................................................................................................... 73
Web Based Remote Control................................................................................ 73
Chapter 7 .............................................................................................................. 75
Shira Movie Encoder ......................................................................................................... 75
Encoding high resolution movie .......................................................................... 75
Appendix (FAQ) ..................................................................................................... 77
3
SHIRA UNIVERSE USER GUIDE 2021
Where does the name Shira Universe come from? ................................................................ 77
How do I ‘extend’ the desktop in Win7/10? ......................................................................... 77
How are the screen resolutions changed in Win7? ................................................................ 79
Some possible setups: ...................................................................................................... 80
How do I enter the registration details in Shira Universe? ..................................................... 80
4
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 1
INTRODUCTION
Shira Universe is a derivative of the Mitaka astronomy space simulator for the use of planetarium.
Mitaka includes the observations and theoretical data related to the so far known. Mitaka was
originally developed for 3D imaging operations in space theaters as part of the "Four Dimensional
Digital Universe" (4d2U) project within the Japan Space Agency (NAOJ) in the direction of this data.
(See http://4d2u.nao.ac.jp/html/program/mitaka/index_E.html)
Sureyyasoft has made many improvements to make Mitaka more effective in planetarium, and
published its first version under the name of Shira Universe in late 2015.
The Shira Universe user interface is similar to the other planetarium presentation program
ShiraPlayer. The most important development in Shira programs; the projection screen to be used
for the theater image and the control console screen have been separated from each other.
The Shira Universe supports projection, mirrored systems and multiple projector systems, as well
as flat screen support for use in classroom presentations.
In this user's manual, unlike the Mitaka, the extra features of the Shira Universe will be explained.
The above link to the basic features of Mitaka can be used.
Reference http://www.sureyyasoft.com/
Note: The "SU" abbreviation will be used instead of the Shira Universe on the following pages of
the manual.
5
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 2
INSTALLATION
2.1 SYSTEM REQUIREMENTS
Operating System: Windows XP / 7 / 8.1 / 10 /11 64 bit *
Display Card: Recommended for best performance min. 1GB ram NVIDIA / Quadro or GeoForce
series. There have been experiences on the ATI Radeon / FireGL series. However, the results on ATI
may not be known in advance, as NVIDIA-compatible commands are used as shader language.
2.2 DOWNLOAD
In general, all Shira products must be registered at Sureyyasoft site, download the related program
from the Downloads menu by following the activation mail. ("ShiraUniverse.rar" for SU)
2.4 INSTALL
At the request of the Mitaka managers, the original Mitaka files are downloaded from the link
(http://4d2u.nao.ac.jp/html/program/mitaka/software/mitaka_132.zip) to upload the SU. The zip
file is opened in a folder that does not have access problems under the drive. The downloaded
"ShiraUniverse.rar" compressed file is pasted in the same folder on the original files. Opened files
are available in the following files:
ShiraUniverse.exe is created on the shortcut table of the file. It can be selected by double clicking
or by keyboard.
6
SHIRA UNIVERSE USER GUIDE 2021
2.5 LICENSE AND TERMS OF USE
Copyright (c) 2015-2017 SureyyaSoft Planetarium Technology, Tsunehiko Kato and 4D2U Project,
National Astronomical Observatory of Japan. Originally developed by Mitaka Tsunehiko Kato
(4D2U Project / Osaka Univ.). Mitaka: Copyright (c) 2007 Tsunehiko Kato and 4D2U Project
In order to use SU in public areas, it is first necessary to have permission to use the contents of
Mitaka. For this (http://4d2u.nao.ac.jp/english/files/4d2u_apply_form_msword_en.doc) it will
suffice to fill in the Word document on the link and send it to the relevant address. For further
information on this subject (http://4d2u.nao.ac.jp/english/index.html#notice) .
When the SU is running, the SureyyaSoft logo is displayed as a semi-circle on the projector screen.
SU has two types of licensing features: single and multiple projector licenses. This logo displayed in
the background indicates that the product is not yet licensed by SureyyaSoft.
7
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 3
The Shira Universe has two screen outputs. Control and Projector Screen.
8
SHIRA UNIVERSE USER GUIDE 2021
3.2 PROJECTOR DISPLAY SETTINGS
SU supports the following projection types.
- Fisheye Lens (Fisheye) projector
- Spherical Mirror system
- Flat Screen (Normal Flat screen)
- Multiple projectors Warp and Blend systems
- Hakoniwa CALIBRATION (JAPANESE LIBRACO.) http://www.libra-co.com/hako/
- Vioso Calibration (German Vioso GmBH) http://vioso.com/
3.2.1 F ISHEYE L ENS P ROJECTOR SETTINGS
The SU basically produces a projection image of the fish eye. Other types of projections are obtained
from the fish eye view. The following operations are applied for projection of the fish eye.
- Click the Settings button in the button group on the top panel of the Console Screen.
- The "Projector Settings" tool box is selected in the "Shira Universe Settings" window.
- "Fisheye Lens" is selected in the Projector System combo box.
- The Show Projector Windows selection box is selected.
- "Frameless Projector Windows" is selected.
- For the projector, L: Left T: Top W: Width and H: Height are entered.
- The resolution of the projector output that can be obtained with Overall Res can be changed.
- Auto Fit button allows automatic placement of the projector window when a second screen or
projector is connected during the setting process on the computer.
Save All button to complete the recording. The program is restarted.
9
SHIRA UNIVERSE USER GUIDE 2021
3.2.2 S PHERICAL M IRROR
SU forms the projection required for spherical mirrored systems. For this, the warp correction data
files obtained from Paul Bourke's website (http://paulbourke.net/dome/warpingfisheye/) are used.
First of all, "Spherical Mirror" option is selected in the Projection system combo box. The
corresponding data file is marked in the Correction Data combo menu. Other settings are the same
as the fisheye projection settings.
Horizontal Mirror: The image is mirrored in the horizontal axis.
Vertical Mirror: The image is mirrored in the vertical axis.
10
SHIRA UNIVERSE USER GUIDE 2021
3.2.3 F LAT S CREEN
In some cases the SU program may be required to be used in classroom presentations. In this case,
flat projection screens will be used.
The "Flat Screen" option is selected in the projection system combo box. Other settings are like fish-
eye system settings.
SU supports multiple projector systems on a single computer. This process is called single-channel
multi-projection system in practice. The SU is supported by external calibration systems for perfect
warp and blend operations. For now, two separate company's calibration system can be used.
11
SHIRA UNIVERSE USER GUIDE 2021
The SU Hakoniwa system uses warp - obj extension files- and blend - png extension files- to perform
image splitting and merging on the dome. There are files of the Hakoniwa 3 projector system, which
is placed as an example in the SU installation package. These files can be understood from the multi-
projector logic of SU using for testing purpose. The sample data is in the "projset" folder.
12
SHIRA UNIVERSE USER GUIDE 2021
Each projector output is added to the "Added Channels" list box, setting left, top, width and height.
Warp and blend files are selected. Save All button saves all the settings and restarts the program.
Please contact Sureyysoft for detailed usage information.
The Vioso calibration system supports up to 16 projectors. It is a calibration system used in many
parts of the world. An IP camera is placed in the center of the dome to perform auto calibration. A
perfect calibration is obtained within minutes. For detailed information
(http://vioso.com/products_fulldome.php)
It is possible to use SU in two different ways with the Vioso calibration system.
13
SHIRA UNIVERSE USER GUIDE 2021
14
SHIRA UNIVERSE USER GUIDE 2021
After this stage, the second screen acts as a single projector screen, allowing the standard use of the
SU.
This solution does not require any another calibration software and only require basic hardware
specifications.
Windows 10 , screen and projector Settings. Two projector location image at the dome
edges.
4K result image (Image
courtesy "Lochness
productions")
15
SHIRA UNIVERSE USER GUIDE 2021
Select “Prepared Two Projector” as Projection System. Front and Back projector channels are
created, automatically. Users can set two projector output warp and blend options as precision.
16
SHIRA UNIVERSE USER GUIDE 2021
Also, when Shira Universe is run with the option to integrate into Shira Presenter, Shira Presenter
will run automatically. The spout feed opens. Shira Presenter is placed in the Main menu tab.
17
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 4
BASIC SETTINGS
The buttons at the top of the console display contain the general functions of the program.
This button works bidirectionally. It is used only when the image is to be dimmed
on the projector screen. The projector screen goes dark in 2 seconds. With a second click, the
display is animated again within 2 seconds.
4.1.2 I LLUMINATION
It can be said that the projector has a similar function to dimming. The
vertical box on the left side of the button is the color selection button, which allows you to open the
color selection window in the other menus of the program. The entire projector image is equipped
with the color selected from the color selection window.
18
SHIRA UNIVERSE USER GUIDE 2021
4.1.3 R ESET A LL
Any features modified from any menu or script are brought to the position of the
program's initial settings. Screen attenuation is also applied to ensure a smooth transition while this
operation is being performed.
4.1.5 S ETTINGS
The settings window is opened. The window has the following setting groups.
19
SHIRA UNIVERSE USER GUIDE 2021
- Program Language: Shira Universe 2.1 version supports the following languages
- English
- German
- French
- Italian
- Indonesian
- Japanese, Japanese Kana
- Korean
- Polish
- Portuguese
- Russian
- Spanish
- Thai
- Turkish
- Emphasis rate of points and lines: Increases the pixel appearance value of all lines and
points.
- Classic Grid Lines: It can be choose between the classic line look of Mitaka and the shaded
line.
- General Speed Factor: Changes the speed of all programs in the software.
- Elevation Angle Space Flight: Determines the angle of inclination of the camera in space
flight mode.
- Elevation Angle Planetarium: Determines the slope angle of the camera in landing mode
- Object Info Size on Dome: When the object is placed on the mouse in space flight mode,
the object's information is displayed at the bottom of the Preview screen or in the Dome.
This setting determines the amount of information displayed in the dome.
- Show Sun Glares: Shine around the sun.
- Return to home location when switching to “Landing mode”: When switching from
Take Off mode to landing mode again, the landing coordinate will be different according to
the planetarium location coordinate. In these turns, this option must be selected to return to
the starting coordinate.
- All Label Font Size: Set Font Size for all label on the dome.
- All Label Font Alfa Size: Used to set fixed alpha values for all displayed fonts.
- Enable High Resolution Planetary Texture: With this selection, it is possible to use 8k
resolution textures of planets and moons. (requires good pc specs)
- Enable Planetary Topology: After version 3.9, some planet and moon topology files were
added to the installation package. With this selection, the request to use these topology files
is opened. (requires good pc specs)
20
SHIRA UNIVERSE USER GUIDE 2021
After 3.2 version camed Artificial Satellites show. (See Chapter 5.1.1.3) Artificial Satellite Feature
show realtime position of the Satellites by human mades. For updating positions to click “Update
Now” button. Updating starts, immeadiately. When finished a message box alerted “completed and
restart SU”. Users can add internet service source address to click “+” button. Also it can remove
click “-“ button.
The settings made are saved by clicking on the "Save All" button. The "ShiraUniverse.ini" file is
included with the program executable file. There is also some setting information from the file in the
file. This setting information can be viewed in the Mitaka help file. The file can also be changed
manually if desired.
21
SHIRA UNIVERSE USER GUIDE 2021
4.1.5 P ROJECTOR C ONTROLS
It shows of the window, which enables the control of the projector's on / off,
dimming or other features. Controllable projectors are limited. The PJLINK method can be used, as
well as direct control of the JVCX30 and JVCX500 series projectors. For further information, please
contact Sureyyasoft.
Normally real mouse image not shown on the projector screen. It requires some
time to point sky objects on the dome. To do this click “Dome Pointer” button and show mouse on
the dome movement from preview screen.
22
SHIRA UNIVERSE USER GUIDE 2021
4.1.6 D ARK S TYLE
This button, which works like the others, opens the locked status of the "Preview"
and "Management" windows. The new dimensions are set as desired and the button is clicked again
to allow the windows to remain set.
4.1.8 E XIT
The intent of the preview window is to allow the mouse and keyboard movements to be applied, as
well as the entire view of the dome being viewed in a single window.
The panel below the preview window contains the "Mouse Tracker for Space Flight" window. If this
window's checkbox is ticked, brief information about the object on the mouse pointer moved in the
"Preview" screen while in Space flight mode is displayed in this panel. At the same time, the object
displayed under the cursor can be set as a target by double clicking.
23
SHIRA UNIVERSE USER GUIDE 2021
Show on Dome: When this selection box is checked, the same information displayed on the panel is
displayed on the dome in a blue window. Note: The size of the information panel displayed on the
dome can be changed from the Settings screen.
CHAPTER 5
MANAGER WINDOW
It is the window where all astronomical settings are made. Contains three child windows.
- Display Settiings
24
SHIRA UNIVERSE USER GUIDE 2021
The selection and color settings of the astronomical objects are made from this window. It contains
close to 100 controls in 16 separate panels. All button controls work bidirectionally.
Take off/Landing: Space flight mode is a form of imaging that allows you to look at
the target objects from a distance. The landing mode is a display mode that enables the observation
point to land on the target objects and make the sky over the target point.
Activate Performance Mode : This button is used when there is not enough
FPS speed in some computer configurations. Rather than redrawing celestial objects, performance
enhancement is achieved with fixed texture representation. Especially in the space flight mode, this
button is used when the target objects will not be stars.
All Labels & Names : Activate by default. All labels and names displayed on the
screen can be closed with one button. Important Note : When this button is not selected, there is
no effect of other label display buttons.
Place Names: With this feature, it is possible to show some earth positions on Earth,
Moon, Mars and Venus in Space flight mode.
Show Date Label : It allows you to display the date and time information on the
screen. You can select the label color with the button on the left
25
SHIRA UNIVERSE USER GUIDE 2021
Surfcace Pointer : In the space flight mode, the latitude and longitude of the
camera's point of view of the target object are displayed on a cursor.
5.1.1.2 C ONSTELLATIONS
Arts : It allows the artistic pictures of constellations to be shown. can select the
art color (if the line art style selected) with the button on the left
Lines : It allows the constellations to be displayed in a line. You can select the
lines color with the button on the left.
Labels : The constellation allows the names to be shown. You can select the art
label colors with the button on the left.
26
SHIRA UNIVERSE USER GUIDE 2021
5.1.1.3 A RTIFICIAL S ATELLITES
Show : Articifial satellites are hidden as default. This button allows to show
them.
Names: It allows artificial satellites labels on the dome if “All Labels & Names”
checked first.
Orbits: It allows show orbits. You can select the color with the button on the
left.
Selected Only: Only the "./data/selection.dat" file shows the Artificial Satellites
with the name. After 3.2 version you can all selected objects from “Target&Scale” window (see
Chapter 5.1.3)
27
SHIRA UNIVERSE USER GUIDE 2021
5.1.1.4 G RID /S CALE
Equatorial Grid : In the sky the lines of the equatorial coordinate plane are
shown. You can select the color with the button on the left.
Galctic Coordinates: The lines of the Milky Way centered spherical coordinate
system are shown. You can select the color with the button on the left.
Ecliptic Plane : The sun-centered plane is shown. You can select the line and
plane color with the button on the left.
28
SHIRA UNIVERSE USER GUIDE 2021
Circles Scales: The camera shows the distance of the viewpoint from the
circular position to the Sun. You can select the lines color with the button on the left
Square Scales: Shows the distance from the target object to the camera to
square boundaries. You can select the lines color with the button on the left.
Compass : Show all compass labels on where it should be. You can select the
label color with the button on the left
5.1.1.5 P LANETS
Show or hide planet names. If the planet itself is secret, the name does not
appear.
It shows or hides the planets' orbits. The ability to show orbits of planets in
Inis mode is supported after version 2.1. You can select the color with the button on the left.
29
SHIRA UNIVERSE USER GUIDE 2021
It shows the line that shows the axis of rotation of the planets. You can
select the axis color with the button on the left.
It hides or shows clouds. After version 2.1, cloud display is supported only if it
appears in the world. See cloud types: Date and Location Settings.
30
SHIRA UNIVERSE USER GUIDE 2021
In Spaceflight mode, only city lights that are valid for Earth are shown or
hidden.
It allows the Earth Landscape to be seen and hidden. See Changing date and
location settings for changing existing scenes.
31
SHIRA UNIVERSE USER GUIDE 2021
New style atmosphere feature camed with 3.2 version. the “New Style Atm” is selected as default.
This mode provides more realistic atmosphere. You can change it to old style with click another
buttons.
The settings related to the Moon's shadow during the lunar eclipse in
the space flight mode.
5.1.1.6 S ATELLITES
Shows or hides the orbits of the satellites. You can select the orbits color with
the button on the left.
Only files named "./data/selection.dat" with a name are displayed. After 3.2
version you can all selected objects from “Target&Scale” window (see Chapter 5.1.3)
32
SHIRA UNIVERSE USER GUIDE 2021
5.1.1.7 A STEROIDS
Only the "./data/selection.dat" file shows the Asteroids with the name. After 3.2
version you can all selected objects from “Target&Scale” window (see Chapter 5.1.3)
Only the "./data/selection.dat" file shows the TNO objects whose names are found.
After 3.2 version you can all selected objects from “Target&Scale” window (see Chapter 5.1.3)
33
SHIRA UNIVERSE USER GUIDE 2021
With a minimum of 10 thousand light spots, it allows the Milkyway galaxy to be seen
or hidden within the group of galaxies.
Show or hide the Sagittarius * straw in the center of the Milky Way.
Show or hide the galaxy in the Sloan Digital Sky Survey (SDSS) database. (100 million
light years away)
Show or hide the Sloan Digital Sky Survey Quasar Catalog (SDSS QSOs). (1 billion light
years away)
Show the Cosmic Microwave texture. (10 billion light years away)
34
SHIRA UNIVERSE USER GUIDE 2021
5.1.1.11 M ILKYWAY
These are the settings that change the look of the Milky Way while the camera is in the Milky Way.
It does not affect the appearance of the Milky Way created when you go out of the Milky Way.
Milky way density adjustment (decrease towards the left, increase to the right)
35
SHIRA UNIVERSE USER GUIDE 2021
5.1.1.12 S TARS
Start or stop the "Star Trail" animation. NOTE: This function works in Landing Mode..
36
SHIRA UNIVERSE USER GUIDE 2021
Binary (binary star systems rotating around a common center) mark the stars with a
green framed square.
5.1.1.13 S PACECRAFTS
37
SHIRA UNIVERSE USER GUIDE 2021
Left Button : Select color if trajectory information is available for the current datetime.
Right Button : Select color if trajectory information is NOT available for the current datetime.
With this window, settings such as Date and time settings, time rate, position selection and sky
cloud selection are made.
The program will set the date and time to go. The direction of movement and flow rate are
determined at the same time.
38
SHIRA UNIVERSE USER GUIDE 2021
DateTime sets the location information from the system clock to the current local time.
5.1.2.2 L OCATION
In the Landing Mode, this window is used to determine the coordinates of the observation point on
the target object. Latitude and Longitude dropdown controls can be selected either manually or by
searching for the desired location in the search text box. You can also select latitude / longitude by
clicking the mouse on the map.
The map of the earth varies according to the target. Target object When the planets or moon is
displayed, the object map is displayed. In other cases, an empty map screen appears.
39
SHIRA UNIVERSE USER GUIDE 2021
5.1.2.3 L OCATION
This window allows selection of the panoramic
image selection to be displayed as a landscape
while in Landing Mode in the target object.
According to the target object, the panoramic image
landscape image list changes. For example, the
screen image on the left is the list of panoramic
position scenes with the target object being the
Earth..
40
SHIRA UNIVERSE USER GUIDE 2021
Note: Some of the landscapes can have separate night and day views.
The article about creating a panoramic image by the user for SU can be found on the link below.
(Japanese)
http://planetarium.to/shiraseries/?page_id=80
This window has functions to select the target object, to scale the camera viewpoint in the
Spaceflight mode, and to specify three target objects in the downscale mode.
This feature places you at a fixed location in space, relative to the Sun. Stationary locations can be
entered as heliocentric ecliptic Cartesian co-ordinates or heliocentric ecliptic spherical co-ordinates.
When you click “Move To” while on Earth, the initial co-ordinates set the current heliocentric co-
ordinates of your current Earth location. If you advance time forward, you’ll quickly be left behind
as Earth continues on in its orbit, while you remain at the same position in space.
41
SHIRA UNIVERSE USER GUIDE 2021
For Cartesian co-ordinates, the position on the ecliptic plane is given by X and Y coordinates. The Z
coordinate takes the location out of the plane of the ecliptic. For spherical co-ordinates, “radius” is
the distance from the Sun’s centre, “theta” is the position angle from the ecliptic plane, and “phi” is
the position angle along the ecliptic plane. Heliocentric means that the Sun is the centre of the
coordinate system, so the point (0,0,0) is at the centre of the Sun, using either Cartesian or
spherical co-ordinates.
When the target object is selected in the glare mode, this object is fixed at the center of the sky,
and all movements occur around this object. With the button, the selected object is centered.
42
SHIRA UNIVERSE USER GUIDE 2021
5.1.3.3 T ARGET B ROWSER
The target object can be found by typing in the search box with the keyboard or by searching the
list with the mouse. The object found is selected by pressing the Target button and set as the new
target.
Move to the new target object selected by clicking the Move button. With the mouse cursor, you can
double click on the object on the list view and the "Target" and "Move" buttons can be operated
together.
After version 3.0 users can change all selected from “Target Browser”. Selected column shows that
enables space objects when clicked “Show Only Selected” buttons.
43
SHIRA UNIVERSE USER GUIDE 2021
The lines under the "Others" group in the list control include ready program commands. It allows
multiple operations to be done with one selection. For example, "New Horizons" Closest Approach to
Pluto "and the simulation of the New Horizon spacecraft's position close to Pluto can be obtained by
one click.
44
SHIRA UNIVERSE USER GUIDE 2021
Before you had this feature, when watching from outside to the planets the camera image was
taken from a fixed point far from the center of the planet.
With the Anchor to Planet surface feature, any latitude and longitude point on the planet is
referenced for camera placement.
Thus, when the time flow is accelerated, the seasonal effect of the sun on the planet can be
observed.
5.1.3.5 S CALE
With these buttons, the camera distance to the target object in the
Space Flight Mode can be adjusted quickly. From this standard distance,
the appearance of the universe can be examined quickly.
45
SHIRA UNIVERSE USER GUIDE 2021
5.2 MEDIA MANAGER
Within this section all video, picture and audio playback operations are performed.
Common to all media operations is a file search window. The media to be played or displayed is
selected here.
The Player can play fulldome videos, fulldome image sequences and VR equirectangular videos
(version > 3.5). The VR videos aspect ratio must be 2:1.
The FFMPEG 56.58.100.0 version codecs library is used as the video playback dub. More information
( www.ffmpeg.org )
Supported video formats : avi, mpeg, mpg, mp4, wmv, mov, and flv.
It is recommended to decompress audio and video files with "Shira Encoder" for smooth
synchronization and to apply mp4 format encoding with "ShiraEncoder" program for high resolution
video at 4K resolution after version 3.1 . (See Chapter 6: Shira Movie Encoder)
The video or audio files to be played must not contain "Unicode" and space characters.
46
SHIRA UNIVERSE USER GUIDE 2021
The Start button allows the video to be played with the fade effect.
With the Pause button, the video is played back at a desired time.
The Stop button stops the video altogether and displays the sky before
the video is launched on the dome with the fade effect.
This window shows the total duration of the video and its current
position.
After Shira Universe 3.1 version, it has new technique for 4K playing.
In this technique 4K fulldome image sequence files are encoded two part of video file by using new
Shira Encoder 1.0.1 version. Each part of video file has 4096x2048 resolution. (See Chapter 6: Shira
Movie Encoder)
The Shira Universe plays them at the same time as syncronized and show on projector screens with
appropriate warping.
47
SHIRA UNIVERSE USER GUIDE 2021
To play 4K video splitted by Shira Encoder, check the “Two-part player (Front&Back)” option.
Opened second progress bar about cached frames. Two progress bar show each channel buffer
frames count. Now select any of two parted file and click play.
As the status bar shows the current position of the video, you can perform forward or reverse video
by dragging and dropping the tracking bar cursor.
With this slider controls in the window, the color settings of the video can be changed.
The Reset button is used to restore the original colors.
48
SHIRA UNIVERSE USER GUIDE 2021
Fisheye and panoramic (equirectangular) images can be shown on the dome. Panoramic pictures
can be navigated with the mouse. Fisheye images can be rotated with the "Z-axis rotation" sliding
bar.
49
SHIRA UNIVERSE USER GUIDE 2021
The plain image to be displayed on the dome is selected via the file manager. The image file is
dragged and dropped onto the "Active Images" window.
50
SHIRA UNIVERSE USER GUIDE 2021
Click the button to remove the image from the dome. The picture has been removed with a
darkening effect, but continues to appear in the "active pictures window". Click the button to
remove the picture from the "Active images" window.
51
SHIRA UNIVERSE USER GUIDE 2021
The coordinates of the flat video on the dome can be adjusted with the sliding bar controls as in
"Flat Image Manager". Loop option allows video to be played continuously.
52
SHIRA UNIVERSE USER GUIDE 2021
5.3 CONSTELLATION MANAGER
It is a window designed to make constellations easier to manage. It consists of three panels. The
leftmost and middle panel has buttons for managing the most known constellations. The two
constellation buttons on the panel can be customized. The third panel contains seasonal groupings
of stars. Seasonal constellations can also be customized if desired.
The functions of the other buttons except the single and seasonal constellation buttons are as follows.
All of these buttons are bi-directional.
53
SHIRA UNIVERSE USER GUIDE 2021
1- Line Style: This style consists of lines for every constellation. Users cn change this line color.
Also with “Color Animated” check box, lines color has changes effect in Landing mode, only.
2- Textured Style: This style has five texture constellation arts. These includes texture images
for every constellation. User can change art brightness of the textures.
54
SHIRA UNIVERSE USER GUIDE 2021
When the button on the lower right corner of the constellation window is clicked, the
"Constellation Design Window" opens.
The changes are stored in the "constWindowSettings.xml" file in the SU folder. If necessary, delete this
file or click on the "Restore Defaults" button in the design window to return to the default constellation
buttons.
Note: The default seasonal constellations are designated as those seen in the North-hemisphere.
SU can present 110 Messier high resolution photos objects photo taken by Hubble. Every images
comes from to screen with animation effect. (http://hubblesite.org/). Three images can show at the
same time.
55
SHIRA UNIVERSE USER GUIDE 2021
Creating a Planetarium presentation program with the presentation creation tool is as easy as the
Microsoft ® Power Point presentation tool. Each presentation file may contain one or more slide
pages. Each slide can accommodate many presentation objects. Presentation objects may include
plain image, flat video, background image, sound file, fulldome clip, or script files. At the same time
each can be converted to a script file before running the slide file.
56
SHIRA UNIVERSE USER GUIDE 2021
5.4.1 P RESENTATION B UTTONS
This button is clicked to create a new presentation file. The "Presentation Creation
Tool" window opens. The generated presentations are stored under the "\ presentations" folder with
the extension ".sup".
When the new button is pressed, the "Presentation Creation Tool" opens. The name to be given to
the presentation is entered in the "Name" text box.
57
SHIRA UNIVERSE USER GUIDE 2021
- Objects that can be added to each slide are displayed in the "Items and Action List" list box.
For example, when the "Background object image" is added, the drop down box is as shown below.
The "File Lines" and "Z-Rotate" scroll bar for the added image and the "Persistent" property
selection box. Related features are selected. Switch to the other slide object or save the
presentation with the Save button. Note: If "Persistent" is selected, this background object can be
displayed throughout the entire presentation.
58
SHIRA UNIVERSE USER GUIDE 2021
5.4.3 R UN P REPARED P RESENTATION
- Double click on the relevant presentation from the list of presentations. The "Selected Slides" area
is filled with slide pictures.
- The first slide was automatically selected. If you want to start from a slideshow, double click on
the slide object.
Click "Run & Next" button. The functions on the slide work and focus on the other
slide.
The selected slide transfers to the "Script Manager" with script commands.
59
SHIRA UNIVERSE USER GUIDE 2021
You can find a sample video of preparing a presentation on the link below.
https://vimeo.com/162333393
A "Script" coding library was created to allow the user to access all functions in the SU. SU script
syntax rules are "Javascript".
60
SHIRA UNIVERSE USER GUIDE 2021
Command Function description
Planets.showLandscape(false); // Hide landscape
Camera.forceModeTo('PLANETARIUM'); // Turn on landing mode
core.wait(0.5); // Wait 0.5 s
core.PerformanceMode(false); // Turn off performance mode
Camera.setPosition(115.84,-31.96); // Set the camera's position in the
// landing mode
Camera.showSurfacePointer(0); // Turn off surface cursor display
Time.setNow(); // Set time to local time
All script commands are available in the "ShiraUniverse_Script_EN.chm" file in the ShiraUniverse
installation package.
61
SHIRA UNIVERSE USER GUIDE 2021
Generel view of the Script Manager
- The list of available scripts in the "\scripts" folder listed in the left hand side is listed. The script
file extension is ".sus".
- Using user script commands, they can create user defined buttons and assign events within
"Script Form Window".
62
SHIRA UNIVERSE USER GUIDE 2021
The file is used to open a script file from the browser. Directly double click on the list to open
the files in the list.
Used to create a new script file. When it is clicked, the script editor is emptied.
63
SHIRA UNIVERSE USER GUIDE 2021
The purpose of the script recorder is to see the script counter of an action executed on any screen,
restart it if desired or to save the executed operations as a script command in a file.
Record is paused.
The record process is completely stopped and the script commands saved in the editor are
displayed.
If "Add Wait Times" is selected, "core.wait (duration)" command will be added after
every action, so that the delay time between actions is in seconds.
The Shira Universe users can produce fulldome content for use as footages or for save&show again
their presentations. The recording format is image sequence Jpeg or Png format. ( version > 3.7)
In addition If you wish, you can save your script presentations as an image sequence. You can
convert the image sequence to video using "Shira Encoder" or a third party tool (etc. Adobe After
Effect).
Warning: Those who have already bought and demonstrated "Shira Universe" must complete apply
form and send it to NAOJ.
However, if the licensed users produced videos for commerical, they should obtain permission for
each video from NAOJ by completing below link form.
https://4d2u.nao.ac.jp/english/index.html#notice
64
SHIRA UNIVERSE USER GUIDE 2021
65
SHIRA UNIVERSE USER GUIDE 2021
Data2Dome service is a data standard for dome display developed by the European Southern
Observatory (ESO). ( https://www.eso.org/public/outreach/data2dome/ ).
The Data2Dome feature is a content delivery and publishing standard aimed at bringing astronomy
data to real-time trouble-free systems. Detailed information can be accessed on the website of the
International Planetariums Association (IPS) website.
( http://www.ips-planetarium.org/?page=data2dome )
Sureyyasoft has become a developer supporting Data2Dome work by integrating Data2Dome (D2D)
into ShiraUniverse.
What the D2D supports
66
SHIRA UNIVERSE USER GUIDE 2021
5.6.1 D ATA 2D OME C ONTENT L IST
SU is in the D2D contents list tree view and is taken online from the
service address in the web file specified in the file "d2dFeeds.txt" in the
"Data2Dome" folder. Web services that will provide other Data2Dome
services in the future can be added to this list. The separation bar to
the right of the list can be pulled to the left to increase the area of use.
: If it is available, it will
allow you to scroll through the pages.
67
SHIRA UNIVERSE USER GUIDE 2021
: It's for retrieving the data again. Click this button to get daily data.
Select the data line to be downloaded and proceed to the "Download options" section.
: Source type the combo control allows you to select the source of the
source for the format size. The size information by selection is shown on the right side.
: Downloading is started with the "Download" button. The download time may vary
depending on the size of the file. The download value in the transaction bar is shown as percent
(%).
68
SHIRA UNIVERSE USER GUIDE 2021
If there is already downloaded or previously downloaded content, the "Download" button becomes
inactive. However, the "Playback Options" panel is activated. By clicking on the "Show
/ Play" button, the downloaded content will be displayed in the management window, which is first
opened according to the content property, and then played back with the default settings in the
dome.
The previously downloaded content can be completely deleted with the button.
Enable Nasa APOD Resources : This selection box is selected to enable the Data2Dome service to
retrieve data from Nasa's daily image archive (APOD).
Last day data count : Used today to determine the number of day data to be pulled backwards.
Personal Nas Api Key : You need to get a key to get free service from the site where Nasa's open
source code data is located Simply enter the site below and the required key can be obtained free of
charge.
"https://api.nasa.gov/index.html#apply-for-an-api-key"
69
SHIRA UNIVERSE USER GUIDE 2021
GLSL stands for openGL Shading Language, which is the specific standard of shader programs. Now
Shira Universe can interpreter shader codes, fastly. About 130 shader in different catageries codes are
added to the "ShaderDome" feature. Users can add own shader code or change existings in this
directory and watch them on the dome. These shader codes were converted for dome projection from
"https://www.shadertoy.com/" site which includes many shader codes have "Creative Commons
Attribution-NonCommercial" licensees.
Warning: The shader dome feature requires 3.0 and over OpenGL support so display cards have to be
high level.
70
SHIRA UNIVERSE USER GUIDE 2021
Any office document; ppt, pps, doc, xls etc. are running
71
SHIRA UNIVERSE USER GUIDE 2021
How to work:
Click the associated button at the top of the main screen to open the "Screen to dome" feature. In
the window that will open, determine where the image will be located in the dome.
Press the Play button. You will receive the following warning message at the first start-up. And the
process won't start.
This process requires the DirectShow filter required for "Screen Capture" to be registered on your
computer. To do this, run the "installScreenCapture.bat" file in the main folder of Shira Universe with
admin permission.
After click "Play" button again, you will see primary screen desktop of the workstation on the dome.
Minimize the window so that only the desired image is in the dome. At the time you want to enter the
"Shift + Alt + S" keyboard combination, you can re-open the control screen.
72
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 6
Version 3.7 and over has web based remote control feature. With this module user may control all
features of the Shira Universe using Android Tablet, OSX IPAD device or Microsoft Surface Pro.
73
SHIRA UNIVERSE USER GUIDE 2021
2. Run Shira Universe
Open settings dialog. Click "General Settings" tab
Find "Web Remote Control" and click enable checkbox, you can see below it "Listening on" label
with ip addresses that you can access web remote control pages.
Warning: Only one remote access can control to SU. So if you opened another access on pc or
tablet please close it before.
74
SHIRA UNIVERSE USER GUIDE 2021
CHAPTER 7
There are various types of movie codecs, so it's difficult to play all of them smoothly. Shira Universe
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 1K (1024x1024
pixels) or 3K (3072x3072 pixels) smoothly, it is highly recommended to use Shira Movie Encoder to
convert it to a bit rate controlled file. Such conversion process is called Encode (or Transcode, if
converting movie to movie).
Launch Shira Movie Encoder by double clicking "Shira Movie 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 target. Profiles which named 1K 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.
75
SHIRA UNIVERSE USER GUIDE 2021
[Start Encode Job] button runs encoding one by one, but usually a few encoding jobs run in parallel
with no problem. After all the encoding jobs are finished, you can find the encoded files in the
output folder you specified. Shira Universe requires a separate sound file if you want to play it with
a movie.
Put a sound file in the fulldome 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.
- 4K High Quality that produces single 4Kx4K dome master movie file like old profiles
- 4K 2-pieces High Quality produces two 4K HD movie files.
76
SHIRA UNIVERSE USER GUIDE 2021
APPENDIX (FAQ)
Where does the name Shira Universe come from?
Shira is the name of the star Sirius in Islam’s holy book the Koran. Shira Universe is part of the Shira
Project developed by Asaf Yurdakul
asafyurdakul@gmail.com
http://www.sureyyasoft.com
Hold the ‘windows’ key on the keyboard and tap the P key. This will open the
following window:
For Windows 7
77
SHIRA UNIVERSE USER GUIDE 2021
For Windows 10
You should also set the desktop to black. In Win7 right-click the desktop and select Personalize. At
the bottom there's an option to change the Desktop Background. In the Picture location dropdown
box select Solid Colors, etc. Also set Sounds to none.
78
SHIRA UNIVERSE USER GUIDE 2021
Right-click a blank area on the desktop and select Screen Resolution. This will allow you to set the
laptop/computer (1) and projector (2) resolutions separately (they don’t have to be the same).
Display 1 is the Control Screen (computer or laptop screen) where Shira Universe’s menus will
be located. To allow room to hold the menus try to make this display as large as possible.
Display 2 is the fulldome projector so set it to the required resolution for either a mirror dome or
truncated fulldome system.
79
SHIRA UNIVERSE USER GUIDE 2021
Some possible setups:
Each window in the un-registered version of Shira Universe has a Register button. Press this
button and enter the information into the dialogue box and press the Register button. Quit and
then re- run Shira Universe.
80