immersive player pro user guide - fly elise-ngimmersive player pro user guideimmersive player pro...
TRANSCRIPT
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
1111
Fly EliseFly EliseFly EliseFly Elise----ngngngng
Waterstad 31Waterstad 31Waterstad 31Waterstad 31
5658565856585658RERERERE EindhovenEindhovenEindhovenEindhoven
The NetherlandsThe NetherlandsThe NetherlandsThe Netherlands
Web: httpw://fly.eliseWeb: httpw://fly.eliseWeb: httpw://fly.eliseWeb: httpw://fly.elise----ng.netng.netng.netng.net
Email: info@eliseEmail: info@eliseEmail: info@eliseEmail: [email protected]
Tel: +31 (0)40 7114293Tel: +31 (0)40 7114293Tel: +31 (0)40 7114293Tel: +31 (0)40 7114293
Copyright © 2012/2020 Fly Elise-ng, All Rights Reserved
Fly EliseFly EliseFly EliseFly Elise----ngngngng
Immersive Immersive Immersive Immersive Player PROPlayer PROPlayer PROPlayer PRO vvvv2222....4444
User Guide
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
2222
1 Introduction .................................................................................................. 4
2 System requirements ..................................................................................... 6
3 Quick Setup Guide ........................................................................................ 7
4 User interface ............................................................................................. 13
4.1 Playlist page ......................................................................................... 13
4.2 Actions page ........................................................................................ 16
4.2.1 UPD Action .................................................................................... 17
4.2.2 Serial Port Action ........................................................................... 17
4.2.3 PJLink Action ................................................................................. 18
4.2.4 DMX Action ................................................................................... 19
4.3 Timeline .............................................................................................. 19
4.4 Displays page ....................................................................................... 23
4.4.1 Geometrical corrections and soft-edge blending window ................. 24
4.4.2 Keyboard and mouse control .......................................................... 28
4.4.3 Advanced configuration dialog ....................................................... 29
4.4.4 Button bar ..................................................................................... 40
4.4.5 Config sets .................................................................................... 41
4.4.6 External camera assisted calibration ............................................... 41
4.5 Settings page ....................................................................................... 43
4.5.1 General ......................................................................................... 43
4.5.2 Video ............................................................................................ 44
4.5.3 Audio ............................................................................................ 45
4.5.4 HW Dec ......................................................................................... 46
4.5.5 Remote ......................................................................................... 46
4.5.6 ArtNet DMX ................................................................................... 47
5 Master/Slave playback mode ....................................................................... 49
6 Lossless encoding and playback .................................................................. 60
7 HTTP interface ............................................................................................ 60
7.1 playlists ............................................................................................... 61
7.2 playitem............................................................................................... 61
7.3 player .................................................................................................. 61
7.4 control ................................................................................................. 62
8 CMDNET Interface ....................................................................................... 63
8.1 HELP .................................................................................................... 64
8.2 PAUSE .................................................................................................. 64
8.3 UNPAUSE .............................................................................................. 64
8.4 SELECTPLAYLIST ................................................................................... 65
8.5 SELECTPLAYITEM .................................................................................. 65
8.6 LOADM3U ............................................................................................ 65
8.7 STOP .................................................................................................... 65
8.8 PLAYSELECTED ..................................................................................... 65
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
3333
8.9 PLAYNEXT ............................................................................................ 66
8.10 PLAYPREVIOUS .................................................................................. 66
8.11 PLAY................................................................................................. 66
8.12 MUTE................................................................................................ 66
8.13 UNMUTE ........................................................................................... 67
8.14 VOLUMEUP ........................................................................................ 67
8.15 VOLUMEDOWN .................................................................................. 67
8.16 SETVOLUME ...................................................................................... 67
8.17 FULLSCREEN ...................................................................................... 67
8.18 INFO ................................................................................................. 68
8.19 INFO notifications ............................................................................. 68
8.20 QUIT ................................................................................................. 69
8.21 SHUTDOWN ...................................................................................... 69
8.22 RESTART ........................................................................................... 69
9 License options ........................................................................................... 69
9.1 PC Locked and USB Dongle Licenses ...................................................... 69
9.2 Commercial and Home-User Licenses.................................................... 70
9.3 License validity ..................................................................................... 70
9.4 Register the software with PC Locked License ........................................ 71
10 License agreement ...................................................................................... 74
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
4444
1111 IntroductionIntroductionIntroductionIntroduction
Immersive Player PRO is the ultimate medial player which includes geometric
correction and soft-edge blending software package.
It is the only software that seamlessly integrates into the Windows 7/8/10
desktop and provides media playback with image geometric correction and
soft-edge blending using the PC GPU. No additional hardware is needed for
projection on regular and irregular projection screens (cylindrical screens, full
and partial domes and any other shaped projection surface).
Immersive Player PRO utilizes Fly Elise-ng Immersive Display core components
for image geometric correction and soft-edge blending configuration and
presentation. With a simple user interface and using the system mouse and
keyboard the projected output image can be mapped on any kind of projection
screen. Overlaps and soft edge blending between projected images can be
adjusted using the fine-grained controls and gamma functions. A color
correction per projector can be applied to match the color profiles among
different projectors.
Immersive Player PRO supports camera calibration files. A camera can be used
to automatically calculate the geometrical correction and soft-edge blending.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
5555
Using a standard HD webcam, users can create perfect and seamless multi
projector setups.
Immersive Player PRO supports up to 16 projectors per PC, which can be
configured in different horizontal and vertical stacking.
Immersive Player PRO is designed for home and professional environments.
Applications include:
• Home Entertainment System
• Conference rooms
• Video Playback
• Live Digital Motion Graphics
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
6666
2222 System requirementsSystem requirementsSystem requirementsSystem requirements
The following is the required minimal configuration:
• PC with 2.0 Ghz or higher processor (32bit or 64 bit)
• 2 Gb or more RAM
• A moderate graphics card (NVIDIA or AMD/ATI)
• For creating a wide multi projector display in windows 7, Windows 8 or
Windows 10 desktops, the following products are required:
o NVIDIA surround 2D support for NVIDIA graphical cards
o ATI Eyefinity support for ATI graphical card
o Or Matrox DialHead2GO or TrippleHead2GO external hardware box
o Or Nvidia Quadro graphics card with mosaic mode
• A common HD webcam (Ex: Logitech Webcam PRO 9000, Logitech HD Pro
Webcam C920, etc.)
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
7777
3333 Quick Setup GuideQuick Setup GuideQuick Setup GuideQuick Setup Guide
Start Immersive Player PRO and select the click the Playlists button
Drag a number of video files into the playlist window. This will create and
populate the currently selected playlist.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
8888
Click on the Displays button and select the desired projector configuration
per detected display.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
9999
Press the Configure button to edit the geometrical correction and soft-edge
blending. A configuration screen will be opened where the user can user the
control points to map the projected output on the projection screen, define
the overlap and configure the soft edge blending depending on the
configuration mode.
In the geometrical correction mode, user can use the mouse of keyboard to
move the green control points on the screen until the projected image is
mapped on the projection screen.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
10101010
After the image is mapped to the screen the overlapped regions can be defined
and the soft-edge blending can be configured. Using the “F10” keyboard key,
user can switch between geometrical correction and soft-edge blending mode.
The default soft-edge blending mode is the “simple” mode where the edge-
blending region follows the contour of the edge of the screen. In most cased
this mode is enough to configure the soft-edge blending.
In the “simple” edge blending mode user can drag the red control points for
every edge to adjust the soft-edge blending region. Using the mouse scroll
button the gamma values for all tree components(R/G/B) can be adjusted per
region).
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
11111111
4 - For more complex setup with irregular projection screens user can switch
to advanced blending mode using the advanced configuration dialogadvanced configuration dialogadvanced configuration dialogadvanced configuration dialog. In the
“advanced” blending mode user can define more control points per edge and
move the blue control points independently to match the contour of the
projection screen and the overlap region. Using the “F12” user can switch
between the blending regions. Using the mouse scroll button the gamma
values for all tree components(R/G/B) can be adjusted per region).
Finally, by pressing the “D” key, the advanced configuration dialog can be show
or hidden. From the advanced configuration dialog user can fine-tune the
gamma values independently for all tree components(R/G/B).
After the configuration is finished, user can press the “Esc” key to exit the
configuration screen. The configuration can be saved using the “Save/Save
As” button on the control and configuration dialog. This configuration will be
used the next time when Immersive Player PRO is started again.
Press Play to start the selected play item.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
12121212
Pressing the “Full Screen” button, Immersive Player PRO will be minimized on
the system tray and the video will be shown on the configured display.
Use the F key to toggle the full screen mode.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
13131313
4444 User interfaceUser interfaceUser interfaceUser interface
The graphical user interface is composed of several pages. Each page can be
selected using the toolbar buttons
4.14.14.14.1 Playlist pagePlaylist pagePlaylist pagePlaylist page
In the Playlists page users can define one or more playlists and add and
manipulate the play items of the playlist. In this page additional Playlist button
is visible with a menu to manipulate the playlists.
Play items can be added to the playlist by dragging and dropping video or
images files from the PC to the playlist window. Also media files can be added
using the Add file to playlist menu.
Each play item can be enabled or disabled. Disabled play items will not be
played back.
Play items can be deleted using the play item sub menu button.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
14141414
Depending on the play item type, the meta-data and the thumbnail for the
play item can be updated using the play item submenu.
Drag and drop a play item in the playlist to re-arrange the play items.
Next to the standard video or images play items, the software supports 2
additional control play items: PausePausePausePause and GotoGotoGotoGoto.
The PausePausePausePause play item will make sure that when the playback reaches this play
item, the playback will be paused and user action is required to continue the
playback, using either Unpause or PlayNext button.
The GotoGotoGotoGoto play item can be configured with the index of another play item, or
a random play item. When the playback reaches this play item, the playback
jump to the configured play item and will continue from that play item.
Using the Pause and Goto play items, users can create complex playlist
scenarios in combination with the “Enable/Disable option per play item.
The playlist can be configured for a random playback and/or loop playback.
In the random playback, the next play item will be selected randomly. In the
loop playback, the playlist will continue with the first play item when the last
playlist item is selected.
Each play item can be configured to play a number of times, before the control
goes to another play item. Press the play item properties button to change the
play item repeat count.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
15151515
The software supports multiple playlist. Users can define more than one
playlist and dynamically switch from one to another play list when needed.
All play lists and play items are saved automatically when the software exits.
The bottom part of the Playlist page can show either the Player Control with
the information of the currently played item and the next queued play item,
or a timeline of the selected play list.
Users can toggle the visibility of the timeline using the timeline button.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
16161616
In the Player Control view, use the controls to Pause/Play/Stop the playback
as well as to jump to the previous or next play item.
Timeline mode shows the complete timeline of the selected playlist.
See the timeline section later in this document.
4.24.24.24.2 Actions pageActions pageActions pageActions page
Note: Note: Note: Note: The use of actions requires the Ultimate License.The use of actions requires the Ultimate License.The use of actions requires the Ultimate License.The use of actions requires the Ultimate License.
The actions page allows definition of show control actions that can be put on
the timeline.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
17171717
The software supports the following types of show control actions: UDP, Serial
Port, PJLink and DMX actions.
The buttons on the left side can be used to add and remove/delete actions.
4.2.14.2.14.2.14.2.1 UPD ActionUPD ActionUPD ActionUPD Action
The UDP actions are action that send a data to a specified IP address and UDP
port. The data to be sent can be specified as a text data or as a binary or text
file content.
When a test command is specified, the user can enter the any text. Any non-
printable characters can be added to the end of the data if the receiving part
requires terminating characters. A list of all non-printable characters are
available in the combo box. The list of the non-printable characters and be
cleared using the delete button.
4.2.24.2.24.2.24.2.2 Serial Port ActionSerial Port ActionSerial Port ActionSerial Port Action
The Serial port actions are similar to the UDP actions.
The specified data or the content of the file is send to a serial port.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
18181818
User can select a COM port specify the parameters of the COM port for the
data sending.
4.2.34.2.34.2.34.2.3 PJLink ActionPJLink ActionPJLink ActionPJLink Action
PJLink is a standard interface implemented by the major projector
manufacturers to control the projectors remotely.
User can specify the IP address and the port of the projector. The standard
PJLink port is 4352.
Additionally, if the projector is setup with the password, the PJLink password
can be specified.
The software supports the following PJLink commands:
PowerOn, PowerOff, MuteAudio, MuteVideo, MuteAudioVideo, UnMuteAudio,
UnMuteVideo, UnMuteAudioVideo, InputRGB, InputVideo, InputDigital,
InputStorage and InputNetwork.
Some of the commands require an additional parameter that can be specified
when the command is selected.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
19191919
4.2.44.2.44.2.44.2.4 DMX ActionDMX ActionDMX ActionDMX Action
The DMX action is an action on one of the specified DMX devices. Depending
on the number of channels specified by a DMX device, the user can enter the
values for the specified channels. The values are in the range of 0-255. Check
the specific DMX device specification for the allowed channel values.
The channel values are applied instantaneously when the action is executed.
4.34.34.34.3 TimelineTimelineTimelineTimeline
The timeline is additional view of the selected playlist which shows all
playtimes on the time axis. User can switch between the timeline view and
the info view using the timeline button next to the play button.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
20202020
The playlist items are shown on the first track. The optional control play items
(Goto and Pause) are shown on the second track. The first and the second
tracks are locked and the items cannot be moved on those tracks.
The last track is the action track. On this track user can put one or more list
of actions to be executed when the playback time reaches the action.
Double clicking on any item on the timeline opens the item editing dialog.
The timeline offers the following additional features:
Markers – users can add markers on the timeline to mark a scene of a time
code on the timeline. Markers are only for visualization and purposes. Users
can move markets freely on the timeline.
Double clicking on the marker opens the marker properties dialog where the
name and the color of the marker can be specified.
Use the mouse to drag the marker flag on the timeline.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
21212121
Actions:
Note: The use of actions requires the Ultimate License.Note: The use of actions requires the Ultimate License.Note: The use of actions requires the Ultimate License.Note: The use of actions requires the Ultimate License.
An actions list can be added to the timeline by pressing the “Add action button
on the top of the timeline. This will put an actions flag on the actions track.
Double click the flag to open the actions list dialog to add the actions to be
executed.
The right list contains all the actions defined in the action screen. Actions can
be added to the actions list on the left.
The order of the actions can be changed as well.
When the playback time reaches the time specified in the action list, all the
actions in the list will be executed sequentially.
Use the mouse to drag the action flag on the timeline:
- Mouse Left: Set the timeline time position
- Mouse Wheel: Scroll the timeline
- CTRL + Mouse Wheel: ZoomIn/ZoomOut timeline
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
22222222
- CTRL + Mouse Left: Drag Timeline or drag item
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
23232323
4.44.44.44.4 Displays Displays Displays Displays pagepagepagepage
The displays page shows the detected displays on the system. Every time
Immersive Player PRO is started, it detects all displays present on the system.
Every display is presented with a button containing information about the
display system name (known to Windows OS), the resolution and the number
of projectors connected to this display. Initially there are no projectors
configured to the displays.
By clicking on the display button a popup menu will be presented with all
supported projector configurations.
The following projector configurations (horizontal x vertical) can be selected
from the drop-down menu:
• None (No projectors connected)
• External calibration (Load .procalib files from Immersive Calibration
PRO)
• All possible (horizontal x vertical) projector configuration with up to 16
projectors
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
24242424
Displays changesDisplays changesDisplays changesDisplays changes
When multiple windows displays are used (or multiple graphical cards)
Windows sometimes enumerates and names the displays in an arbitrary order.
Because Immersive Player PRO stores the warping and blending configuration
per display, when Windows enumerates displays differently, the previously
configured display can be renamed differently or can swap position with
another display.
When the option “Check for display change” is selected, Immersive Player PRO
will detect any changes in the displays configuration since the last time the
settings have been saved. If changes are detected, the displays tab will be
cored red. Pressing the Left or Right mouse button on the display will open
the context menu. The first item in the context many will open the previously
saved displays configuration and the users can select (take over) the previously
saved configuration.
After selecting the projector configuration, click the “Configure” button to
open the warping and blending configuration screen.
4.4.14.4.14.4.14.4.1 Geometrical corrections Geometrical corrections Geometrical corrections Geometrical corrections and softand softand softand soft----edge blending windowedge blending windowedge blending windowedge blending window
Geometrical corrections and soft-edge blending window provides a warping
mesh of control points. By adjusting the position of the control points, the
projected display can be mapped on any kind of planar or curved surface.
Depending on the projector configuration, a number of independent meshes
are available (one per projector). The control points can be moved by mouse
or by using keyboard shortcuts.
The number of horizontal and vertical control points can be selected from the
advanced setup dialog or using keyboard shortcuts. Up to 50 control points
can be selected.
Three editing modes are available:
• Geometrical correction
• Simple edge blending
• Advanced edge blending
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
25252525
In geometrical correction mode the image can be mapped on any projection
surface by dragging the green control points with the mouse or using
keyboard shortcuts.
User can switch between geometrical correction and edge-blending mode
using the “F10” key.
In simple edge blending mode, one control point is available per edge. User
can drag the red control points to adjust the blending regions for each edge.
Using the mouse scroll button the gamma value can be adjusted per control
point.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
26262626
Using the advanced configuration dialog user can enable the advanced
blending mode.
In advanced blending mode one or more control points can be defined per
edge. The blue control points can me moved independently to realize the most
complex edge-blending configurations.
Using the mouse scroll button the gamma value can be adjusted per control
point.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
27272727
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
28282828
4.4.24.4.24.4.24.4.2 Keyboard and mouse controlKeyboard and mouse controlKeyboard and mouse controlKeyboard and mouse control
Keyboard shortcutsKeyboard shortcutsKeyboard shortcutsKeyboard shortcuts
Modifiers Key Action
D Show/Hide advanced configuration dialog
C Center the configuration dialog on the projector
I Show Hide information window
Esc Close configuration dialog and window
F5 Increase the number of horizontal control points
F6 Decrease the number of horizontal control points
F7 Increase the number of vertical control points
F8 Decrease the number of vertical control points
N Select next geometrical correction grid
Left Select left control point
Right Select right control point
Up Select up control point
Down Select down control point
Ctrl Left Move control point left by 1 pixel
Ctrl Right Move control point right by 1 pixel
Ctrl Up Move control point up by 1 pixel
Ctrl Down Move control point down by 1 pixel
Ctrl Shift Left Move control point left by 10 pixels
Ctrl Shift Right Move control point right by 10 pixels
Ctrl Shift Up Move control point up by 10 pixels
Ctrl Shift Down Move control point down by 10 pixels
F10 Toggle between geometrical correction and soft
edge blending editing
F11 Toggle between simple and advanced soft edge
blending grid
F12 Select next soft edge blending grid
Ctrl Shift Q Reset all geometrical correction and soft edge
blending grids
Ctrl Q Reset all geometrical correction and soft edge
blending grids to the whole display area
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
29292929
Mouse operationsMouse operationsMouse operationsMouse operations
In geometrical correction mode:In geometrical correction mode:In geometrical correction mode:In geometrical correction mode:
• Drag control point with LEFT mouse button normal drag
• Drag control point with RIGHT mouse button fine grained drag
• Key combinations: “H” - drag all points in the same horizontal line
• Key combinations: “V” - drag all points in the same vertical line
• Key combinations: “A” - drag all points in the grid
• CTRL + S + MIDDLE mouse – Select a region to select all control points in
the region
• CTRL + D + MIDDLE mouse – Select a region to de-select all control points
in the region
• RIGHT mouse double-click – Select and De-select a control point
In soft edge blending correction mode:In soft edge blending correction mode:In soft edge blending correction mode:In soft edge blending correction mode:
• Drag control point with LEFT mouse button normal drag
• Drag control point with RIGHT mouse button fine grained drag
• Mouse wheel: Increase/Decrease the Red, Green and Blue gamma value of
the soft edge blending point
• Mouse wheel + Key R - Increase/Decrease the Red gamma value of the soft
edge blending point
• Mouse wheel + Key G - Increase/Decrease the Green gamma value of the
soft edge blending point
• Mouse wheel + Key B - Increase/Decrease the Blue gamma value of the soft
edge blending point
The list of all keyboard and mouse shortcuts keys can be shown in the
calibration screen using the “Help” button. A new window will be shown next
to the calibration configuration dialog.
4.4.34.4.34.4.34.4.3 Advanced configuration dialogAdvanced configuration dialogAdvanced configuration dialogAdvanced configuration dialog
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
30303030
Pressing the “D” key can toggle the visibility of the advanced configuration
dialog.
Geometrical correction tabGeometrical correction tabGeometrical correction tabGeometrical correction tab
In the geometrical correction tab, the user can:
• Select the projector to be edited
• Enable/disable the projector output
• Show/hide the control points
• Show/hide the lines between the control points
• Select the number of horizontal and vertical control points
• Double or halve the number of horizontal and vertical control points
• Select the curved or linear geometrical correction
• Select to move single control point, all control points in the horizontal or
vertical line, selected points or all control points on the grid
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
31313131
• Select to lock the movement in X, Y or XY directions
• Select to move only the edges control points and let the program
interpolate the other control points
• Enable or disable the horizontal, vertical or diagonal animation lines for
perfect geometrical correction
• Add additional checker grid overlay on top of the background image.
Configure the number of horizontal and vertical checker boxes.
• Control for image mirroring, flipping and rotation
• Select the background image from the list of the built-in image of customer
provided images in the images folder
• Load a background image from any location form the hard disk.
• Create a perspective images as background
• Adjust the image mapping on the screen for perfect aspect ratio.
SoftSoftSoftSoft----edge blending tabedge blending tabedge blending tabedge blending tab
In the soft-edge blending tab user can:
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
32323232
• Select to edit Left, Right, Top or Bottom edge of the projector to edit the
overlap or the fade (blend) area.
• Select between pan or stretch overlap mode
• Adjust the overlap region per edge
• Toggle between simple and advanced soft edge blending mode
• Adjust the fade region per edge (available only in simple edge-blending
mode)
• Adjust the fade ramp per component R/G/B or for all components
simultaneously.
• Use a parametric formula to configure the fade ramp based on 3
parameters (gain, slope, gamma).
• Manually fine-tune the fade ramp using the advanced fade controls.
• Select the masking bitmap that can be applied to the projectors.
Note: When putting the cursor on top of an adjustable field, a small window
will be opened with one or two horizontal sliders. The first slider is for normal
change of the value. The bottom slider is for very fine change of the value.
This is a very convenient input method that allows the users quick and fine
adjustment of the blending parameters.
The overlap can be configured either as a projector overlap or as an image
overlap. When the check box next to projector overlap is checked, the user
can enter the projector overlap in percentages. This value should match the
actual overlap of the projected images on the projection screen. When overlap
is configured for that edge, the projected image will contain also part of the
image projected from the adjacent projector. Both images must be matched
on the projected screen. When using projector overlap, the overlap of the
adjacent projector is automatically updated and the image overlap is
automatically calculated.
Using the projector overlap is the preferred way of calibrating the overlap and
produces the best results for manual calibration.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
33333333
Note that, due to the limitations of the graphical system, the overlap region
should be set only to projectors connected to the same display. For projectors
connected to other display, the output of the displays has to be configured in
such a way that both displays show an overlapping image.
Fade is configured as percentage of the total projector image. This is a region
whiting which the color intensity of the individual Red, Green and Blue
components will fade to black for achieving seamless soft edge blending.
The width of the fade region is very important for achieving good soft edge
blending results. Before setting the fade ramp of the fade regions per projector
users can select the red color of the of the fade region of the left part of the
overlapped edge and select green color on the neighboring projector on the
same overlap edge. A combination of green and red color will produce yellow
color on the screen. Using the fade regions control points users should adjust
the fade region per projector so that no red of green areas are visible outside
of the yellow regions.
Fade regions wider than the actual projector overlap.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
34343434
Once this alignment is completed, the fade regions color should be turned off
and users can proceed to configure the fade out parameters.
This region can be configured using a parametric formula or manually. In
manual mode this region is divided in 10 segments. The intensity of the color
components and the beginning of the segments can be adjusted with the
vertical sliders. The values inside the segments are interpolated.
In parametric formula mode the three parameters (gain, slope and gamma)
can be used to create the desired fade function profile. The gain and the slope
parameters determine the shape of the fade curve while gamma determines
how fast the color will fade to black. The parametric formula can be adjusted
per Red, Green and Blue color components or for all components together
(Luma).
The following figure shows three gamma functions depending on the gamma
value.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
35353535
Color balancing tabColor balancing tabColor balancing tabColor balancing tab
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
36363636
In the color-balancing tab the user can adjust the color profile per projector
in order to achieve color uniformity among projected images.
Masking tabMasking tabMasking tabMasking tab
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
37373737
In the masking tab the user can select different masking options per projector
or for the whole display.
When a part of the projected image has to be masked for whatever reasons
the users can use the masking controls. Masking can be defined in two ways:
An interactive masking grid per projector or a masking bitmap per display.
In the masking grid mode, user can use the grid control points in the similar
way as with geometrical correction grids. The shape of the grid will determine
which part of the image will be visible and which parts will become invisible
and will be masked.
User can select the number of the horizontal and vertical grid control points
as well as the mode of the grid: curved edges or linear edges.
In the masking bitmap mode, the user can select an existing black & white
.bmp or .png file. The file can be prepared offline using a paint program.
The black parts of the image will determine which part of the projected image
will be masked and will not be displayed.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
38383838
Only one masking control can be selected at a time. When no masking control
is selected the masking will not be applied.
Align tabAlign tabAlign tabAlign tab
Using the Align tab user can use the align grid to indicate the position of the
projected image on the screen as well as indicate the overlap regions on the
screen with other projectors. By pressing the “Automap” button, Immersive
Player PRO will calculate the geometrical correction, the overlap region and
the edge blend region to produce the combined mapped image on the screen.
This function is a utility function to map the projected image on the screen as
accurate as possible using the align grid before the user can continue with the
fine-tuning of the geometrical correction and the soft-edge blending.
The users have to position the grid points on the projector so that the points
will be shown on the edges of the screen and the edges of the overlapping
regions with other projector.
If the projector has one overlapping edge the grid contains only point for the
screen edges and the one overlapping edge region. For projectors that have
overlapping edges with more projectors (horizontally or vertically) the grid will
contain points for all the overlapping regions.
The “colors” background image can be selected during mapping of the align
grid for the best identification of the overlap regions.
Left projector align points
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
39393939
Left projector align points on the screen
A left projector in 3x1 projector configuration the first column of align grid
points should be mapped to the left edge of the screen. The second column
of the align grid should be mapped in the middle of the projected image on
the screen for this projector. The third column should be mapped on the left
edge of the overlap between the left and the center projector. The forth
column should be mapped on the right edge of the overlap between the left
and the center projector.
Center projector align points
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
40404040
Center projector align points on the screen
Similar to the left projector the center projector has align grid points for the
both overlaps with the left and the right projector. The most left columns of
the align grid should be aligned with the overlap region with the left projector.
The rightest columns of the align grid should be aligned with the overlap
region with the right projector.
The align grid mapping for the right projector is similar to the left projector.
After pressing the “Automap” button the warping approximation will be
calculated and applied.
Only small adjustments of the geometrical correction and the edge blending
are needed to get the perfect multi projector projection.
4.4.44.4.44.4.44.4.4 Button barButton barButton barButton bar
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
41414141
The button bar contains the following buttons:
• Configure: Starts the geometrical correction and soft-edge blending
configuration window if one or more displays are configured with
projectors configuration.
• Configs: Opens a sub menu to select one of the 8 available configurations.
Users can setup and configure each configuration separately. The warping
and blending configurations will be saved per configuration set. The default
keyboard shortcuts CTRL+SHIFT+1/2/3/4/…/8 can be used to
immediately switch between different configuration sets.
• Load: Opens a load dialog to load another configuration file
• Save: Saves the current configuration.
• Save As: Opens a save dialog to save the configuration file with a different
file name.
4.4.54.4.54.4.54.4.5 Config setsConfig setsConfig setsConfig sets
Immersive Player PRO allows the user to configure multiple configurations
that can be loaded at once and can be switched instantaneously. This can be
used to have different warping and blending settings for brighter scenes and
another blending configurations wit darker scene. Also the user can create
one config set with _multi.procalib and another config with _single.procalib
for warping multi-view and single view scenes respectively.
The users can switch between one of the 8 possible configurations sets
using the default keyboard shortcuts (CTRL+SHIFT+1/2/3/4/…/8). If the
game of the screen is warped, the warping will change instantaneously
according to the selected configuration.
4.4.64.4.64.4.64.4.6 External camera assisted calibrationExternal camera assisted calibrationExternal camera assisted calibrationExternal camera assisted calibration
The manual geometric correction and soft-edge blending can be completely
automated by using a standard off-the-shelves webcam. A HD webcam is
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
42424242
recommended for the best results (Ex: Logitech Webcam PRO 9000, Logitech
HD Pro Webcam C920, etc.)
The external program Immersive Calibration PROImmersive Calibration PROImmersive Calibration PROImmersive Calibration PRO should be used to perform
the automatic calculation of the geometric correction and soft-edge blending.
After Immersive Calibration PROImmersive Calibration PROImmersive Calibration PROImmersive Calibration PRO has finished, the calculation results should
be saved to a file “*.camcalib”.
Immersive Player PRO can import this file by selecting “External calibration”
menu from the projectors calibration drop-down menu of the display.
After the external calibration file is loaded, users cannot perform further
manual geometrical correction. Users can still manually adjust (fine-tune) the
soft-edge blending parameters and the black offset parameters.
Note: “Ultimate” licensing option is required to be able to use Immersive
Calibration PRO files in Immersive Player PRO
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
43434343
4.54.54.54.5 Settings Settings Settings Settings pagepagepagepage
The settings page contains Tabs for configuring Immersive Player PRO.
The settings including the warping and blending configuration can be
backed up and restored using the corresponding Backup/Restore buttons.
4.5.14.5.14.5.14.5.1 GeneralGeneralGeneralGeneral
In this tab user can define if the software should be started automatically when
the PC starts and if the show (full screen playback) should start automatically.
Also users can specify if the screen saver should be disabled during playback.
When using still images, users can specify the duration of the still image on
the screen. When duration is infinite, the user needs to press PlayNext to
continue with the next image in the slideshow.
The warping can be configured in “Multi-projector warping & edge-blending”
or “Projector mapping” mode.
The player can be configured as a standalone player (on a single PC) or as a
master/slave synchronized player running on multiple PCs.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
44444444
Check the master/slave chapter for setting up the master/slave mode.
The low level logging produced by the vide player and decoders can be
enabled by using one of the Logging option. Depending on the logging level,
this can produce a log of log entries in the log file. This options should be
enabled only when requested by the support team to collect some more
logging info.
4.5.24.5.24.5.24.5.2 VideoVideoVideoVideo
In the Video Tab use can define how the input video is mapped to the
projection screen.
If Keep video aspect ratio is disabled, the complete video content will be
mapped to the screen independent of the video aspect ratio. This can cause
video stretching if the screen aspect ratio is not the same as the video aspect
ratio.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
45454545
When Keep video aspect ratio is enabled, users can specify the screen aspect
ratio. In that case the software will add black bands (if necessary) to the
video content to make sure that the vide aspect ratio is preserved.
The best practice is to author the video to be the same aspect ratio as the
projection screen aspect ratio.
For dome projection and dome master content, the screen aspect ratio can
be set to 1, because the dome master content has aspect ratio of 1.
For side-by side stereo playback on systems with QuadBuffer support, the
OpenGL QuadBuffer stereo mode must be enabled. Then for each play item
users can select the side by side mode from the play item properties.
4.5.34.5.34.5.34.5.3 AudioAudioAudioAudio
In the Audio Tab users can select which Audio device will be used for audio
rendering, as well as which channel output. Configuration.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
46464646
4.5.44.5.44.5.44.5.4 HW DecHW DecHW DecHW Dec
The software has built in support for different Hardware decoding acceleration
interfaces. Depending of the used GPU one or more acceleration interfaces can
be available. Jot all interfaces support all codecs for decoding.
Select the desired hardware acceleration and enable the codes to be used for
that acceleration.
The selected hardware decoder will be shown in the currently selected play
item.
When the hardware acceleration is not available or not supported, the software
will degrade to software decoding.
4.5.54.5.54.5.54.5.5 RemoteRemoteRemoteRemote
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
47474747
In this Tab users can enable or disable one of the Remote control interfaces:
HTTP or TCP/CMD interface. For each interface a port can be defined to which
the interface is available.
Note: Depending on the licenses, one or more interfaces can be enabled. See
the licensing options and the licensing types.
4.5.64.5.64.5.64.5.6 ArtArtArtArtNNNNet DMXet DMXet DMXet DMX
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
48484848
In this tab the user can enable/disable the ArtNet DXM show control
functionality. When enabled, user can configure the network interface to be
used to send ArtNet commands as well as the Subnet and Universe of the
target DXM devices.
DMX devices include DMX controlled lamps, smoke machines and variety of
other show devices that have a DMX interface.
Devices can be added to the list of known DMX devices. Each device can be
configured to use one or more channel. The start channel and the number of
channels determine the range of channels used by the device.
Devices with maximum of 12 channels are supported.
The DXM devices specified here can be used on the Actions editor to define
the actions that can be put on the timeline.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
49494949
5555 Master/Slave playback modeMaster/Slave playback modeMaster/Slave playback modeMaster/Slave playback mode
One of the most important feature is the possibility for real-time,
synchronized, frame accurate distributed playback of media over multiple
decoding and rendering PCs.
It is not uncommon now days that the media content with size of 8K, 16K and
larger are used to create large high definition displays using multiple
projectors.
Decoding such a large encoded media on a single PC is usually not possible
due to the hardware limitations. The CPU based decoding of content of 8K or
larger cannot be done with real-time requirements, especially when using
frame rates of 60 fps or more.
The available HW decoders available in the graphics cards hardware lack the
support for high resolution content and cannot provide decoding for such
content.
As a result, the obvious option is to split (crop) the media content in smaller
sizes and to play each part on a separate PC and synchronize the playback
over all the PCs involved into playback of the complete media content. Small
and less powerful “off-the- shelves” PCs can be used to distribute the
decoding and playback of the large media. For example, several networked
Intel NUC PCs (or similar) can be used to decode and playback part of the
content (pieces of 2K or 4) on each PC.
Here it comes Immersive Player PRO Master/Slave mode.
Each instance of Immersive Player PRO can be configured as a Master or Slave
in a clustered synchronized media decoding and playback.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
50505050
The Master instance is responsible for distributing the media playback state
as well and distribute and synchronize the time codes among the connected
Slave instances.
The Master instance contains and manages the playlists and play items of the
media show to be played.
The Slave instances are locked to the Master. One or more Slave instances can
be locked to the same Master. The Slave instanced do not contain and manage
playlist and play items. They are just following the Master instance playback
state.
PCs running Immersive Player PRO Master and Slave instances are connected
in a local network. A separate wired 100Mb/s or 1Gb/s network is preferred
to ensure quick and accurate synchronization of the playback state and the
playback time codes. The software uses UDP multicast mode to send and
distribute the synchronization from the master to the slave instances. The UDP
ports can be configured in the Settings page.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
51515151
Make sure no firewall on the Master and Slave PCs is blocking the configured
port for UDP multicast traffic.
The Master instance maintains the accurate playback time clock and
distributes the clock to all Slave instances. The Slave instances use the same
clock to follow the playback state of the Master instance. This allow frame
accurate synchronization of the Master and Slaves playback state and the
playback time. Even with 60 Hz and 120 Hz playback, the timelines of the
Master and Slave are accurately synchronized.
This synchronized distributed playback can be used in huge video wall setups
like this one. The large video media can be split in multiple sections and each
smaller section can be played back on one PC connected to one or more
displays.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
52525252
Similar distributed media playback can be used in a multi-projection setup.
For the purpose of this document, we will use a 4 projection setup on a curved
projection screen. The projectors are 4K projectors and the content we will
prepare and play is 8K.
The content will be split and played back on 4 PCs, each running Immersive
Player PRO.
Each PC is connected to one 4K projector.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
53535353
On order to auto-align this projector setup we will use Immersive Calibration
PRO with a single web cam to auto align the projection and export the
alignment data.
Immersive Calibration PRO exports one _single.procalib file for each PC, as
well as one MediaSplit.split for splitting the single media file. This split file
describes how the media should be split in 4 pieces, each piece to be played
back on each PC.
Each of the 4 PCs runs Immersive Player PRO. One of the PC is configured as a
Master player and the rest of the 3 PC are configured as Slave Player.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
54545454
Now copy the corresponding exported _single.procalib file on each PC and
load it into Immersive Player PRO display.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
55555555
Now it is the time to split the media into 4 parts and distribute and playback
those parts on the 4 PCs.
For the purpose of this blog we will use this 8K demo video from youtube
https://www.youtube.com/watch?v=hVvEISFw9w0
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
56565656
Immersive Player PRO includes tools to load a single media file and split the
file in multiple files based on the exported MediaSplit file during the
calibration. Based on the MediaSplit.split file, the software will produce 4
media files that are cropped exactly to match the projector coverage on the
projection screen and match the needed geometrical correction and blending.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
57575757
Each split media file will be placed in a separate folder with the same name as
the name of the remote PC display. Copy the split media files to the
corresponding Master and Slave PCs. Use the same folder name (Ex:
C:\Media\) on the Master and Slave PC.
Open the Master Immersive Player PRO and create a playlist by adding a
plyitem from the split media.
Start the Slave Immersive Player PRO. No additional action is required on the
Slaves. They will connect and lock/sync with the master.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
58585858
Press Play and the Master and the Slave instances of Immersive Player PRO will
start playing back their part of the large 8K media.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
59595959
The final image on the projection screen is perfectly aligned and edge blended
8K video.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
60606060
6666 LLLLossless ossless ossless ossless eeeencoding and ncoding and ncoding and ncoding and playbackplaybackplaybackplayback
I lot of high quality content is delivered as a set of lossless encoded or raw
format images. Playback of such a content requires encoding of the list of
images in a lossless encoded stream with the correct framerate and the
image pixel type.
Immersive Player PRO provides a tool for lossless encoding of raw images.
The Menu/Tools/Lossless media screen can be used to select the raw
images, select the framerate and pixel format and star the lossless encoding.
After the lossless encoding is completed, the resulting media file can be
imported in one of the Immersive Player PRO playlists.
7777 HTTP interfaceHTTP interfaceHTTP interfaceHTTP interface
The HTTP interface is a simple control and info interface for controlling the
playlist and the play items, as well as the playback state.
All requests are based on the HTTP GET request and are divided in the
following entry points: /playlists, /playitem, /player, /control
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
61616161
7.17.17.17.1 playlistsplaylistsplaylistsplaylists
CommandCommandCommandCommand http://<ipaddress:port>/playlists?select=index
DescriptionDescriptionDescriptionDescription Make the playlist with index active. Index is from 1 to the
max number of playlists
7.27.27.27.2 playitemplayitemplayitemplayitem
CommandCommandCommandCommand http://<ipaddress:port>/playitem?play=index
DescriptionDescriptionDescriptionDescription Starts to play the play item with index. Index is from 1 to
the max number of play items in the currently selected
playlist
CommandCommandCommandCommand http://<ipaddress:port>/playitem?select=index
DescriptionDescriptionDescriptionDescription Selects the play item with index, to be the currently
selected play item. Index is from 1 to the max number of
play items in the currently selected playlist
CommandCommandCommandCommand http://<ipaddress:port>/playitem?enable=index&enabled=
[true|false]
DescriptionDescriptionDescriptionDescription Enables or disables the play item with index. Index is from
1 to the max number of play items in the currently selected
playlist
7.37.37.37.3 playerplayerplayerplayer
CommandCommandCommandCommand http://<ipaddress:port>/player?play
DescriptionDescriptionDescriptionDescription Start the playback from the selected play item
CommandCommandCommandCommand http://<ipaddress:port>/player?stop
DescriptionDescriptionDescriptionDescription Stops the playback
CommandCommandCommandCommand http://<ipaddress:port>/player?pause
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
62626262
DescriptionDescriptionDescriptionDescription Pauses the active playback
CommandCommandCommandCommand http://<ipaddress:port>/player?previous
DescriptionDescriptionDescriptionDescription Jumps to the previous play item
CommandCommandCommandCommand http://<ipaddress:port>/player?next
DescriptionDescriptionDescriptionDescription Jumps to the next play item
CommandCommandCommandCommand http://<ipaddress:port>/player?goto=position
DescriptionDescriptionDescriptionDescription Seeks the currently played item to a position. Position is a
relative position between 0 and 1. 0.5 seeks to the middle
of the play item.
CommandCommandCommandCommand http://<ipaddress:port>/player?volume=value
DescriptionDescriptionDescriptionDescription Sets the player volume to value. Value is a relative volume
between 0 and 1. 0.5 means 50% volume.
CommandCommandCommandCommand http://<ipaddress:port>/player?mute=[true|false]
DescriptionDescriptionDescriptionDescription Mutes or unmutes the player audio.
CommandCommandCommandCommand http://<ipaddress:port>/player?fullScreen=[true|false]
DescriptionDescriptionDescriptionDescription Enables and disables the full screen playback.
7.47.47.47.4 controlcontrolcontrolcontrol
CommandCommandCommandCommand http://<ipaddress:port>/control?quit
DescriptionDescriptionDescriptionDescription Quits Immersive Player PRO software.
CommandCommandCommandCommand http://<ipaddress:port>/control?restart
DescriptionDescriptionDescriptionDescription Initiates a PC restart
CommandCommandCommandCommand http://<ipaddress:port>/control?swutdown
DescriptionDescriptionDescriptionDescription Initiates a PC shutdown
When the HTTP interfaces is enabled, a browser can be pointed to the PC IP
address and the selected port.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
63636363
A responsive web interface will be shown to control the playlist and the
playback.
8888 CMDNET InterfaceCMDNET InterfaceCMDNET InterfaceCMDNET Interface
CMDNET is a TCP based interface with clear - text commands and responses.
This interface allows simple integration of the software with any (show)
control software that supports text based TCP control interface.
The CMDNET server waits for requests and then services them as it receives
them, in the order they are received. It responds to each request indicating
whether the request was carried out, and sometimes to provide requested
information. The CMDNET server will only send a message to the client in
response to a request. Exactly one message is sent by the CMDNET server to
the client in response to each request.
All commands and responses are sent in plain ASCII-encoded text. No data
is sent in binary form.
Each command has the following structure:
<COMMAND_NAME> <PAREMETER>;
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
64646464
The command name comes first, followed by an optional command
parameter (zero or one). The command and the parameter are separated by
a “space” character. A semicolon always ends the command.
Each command is processed by the CMDNET server and response is
produced.
The response has the following structure:
<RESULT_CODE>:<RESULT_INFO>;
The result code comes first, followed by result information. The result code
and the result info are separated by a “:” character. A semicolon always ends
the response.
The result code is one of OK or ERR. OK indicates successful command
execution. ERR indicates failure to execute the command.
The following is a list of the supported commands:
8.18.18.18.1 HELPHELPHELPHELP
DescriptionDescriptionDescriptionDescription Lists all available CMDNET commands
CommandCommandCommandCommand HELP;
ResponseResponseResponseResponse OK:HELP,PAUSE,UNPAUSE,STOP,PLAYSELECTED,
PLAYNEXT,PLAYPREVIOUS,PLAY,QUIT;
8.28.28.28.2 PAUSEPAUSEPAUSEPAUSE
DescriptionDescriptionDescriptionDescription Pauses the current playback.
CommandCommandCommandCommand PAUSE;
ResponseResponseResponseResponse OK:PAUSE;
8.38.38.38.3 UNPAUSEUNPAUSEUNPAUSEUNPAUSE
DescriptionDescriptionDescriptionDescription Un pauses the current playback.
CommandCommandCommandCommand UNPAUSE;
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
65656565
ResponseResponseResponseResponse OK:UNPAUSE;
8.48.48.48.4 SELECTPLAYLISTSELECTPLAYLISTSELECTPLAYLISTSELECTPLAYLIST
DescriptionDescriptionDescriptionDescription Selects a specific playlist. The play list index is provided as
an argument. Index is 1 based index of the available
playlists
CommandCommandCommandCommand SELECTPLAYLIST <playlistindex>;
ResponseResponseResponseResponse OK:SELECTPLAYLIST <playlistindex>;
8.58.58.58.5 SELECTPLAYSELECTPLAYSELECTPLAYSELECTPLAYITEMITEMITEMITEM
DescriptionDescriptionDescriptionDescription Selects a specific play item in the current playlist. The play
item index is provided as an argument. Index is 1 based
index of the available play items.
CommandCommandCommandCommand SELECTPLAYITEM <playitemindex>;
ResponseResponseResponseResponse OK:SELECTPLAYITEM <playitemindex>;
8.68.68.68.6 LOADM3ULOADM3ULOADM3ULOADM3U
DescriptionDescriptionDescriptionDescription Loads a .m3u playlist file and replaces the content of the
current playlist with the content of the .m3u fule.
CommandCommandCommandCommand LOADM3U <filename>;
ResponseResponseResponseResponse OK:LOADM3U;
8.78.78.78.7 STOPSTOPSTOPSTOP
DescriptionDescriptionDescriptionDescription Stops the current playback.
CommandCommandCommandCommand STOP;
ResponseResponseResponseResponse OK:STOP;
8.88.88.88.8 PLAYSELECTEDPLAYSELECTEDPLAYSELECTEDPLAYSELECTED
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
66666666
DescriptionDescriptionDescriptionDescription Starts the playback from the currently selected
playlist/playitem
CommandCommandCommandCommand PLAYSELECTED;
ResponseResponseResponseResponse OK:PLAYSELECTED;
8.98.98.98.9 PLAYNEXTPLAYNEXTPLAYNEXTPLAYNEXT
DescriptionDescriptionDescriptionDescription Starts the playback from the next play item in the selected
playlist
CommandCommandCommandCommand PLAYNEXT;
ResponseResponseResponseResponse OK:PLAYNEXT;
8.108.108.108.10 PLAYPREVIOUSPLAYPREVIOUSPLAYPREVIOUSPLAYPREVIOUS
DescriptionDescriptionDescriptionDescription Starts the playback from the previous play item in the
selected playlist
CommandCommandCommandCommand PLAYPREVIOUS;
ResponseResponseResponseResponse OK:PLAYPREVIOUS;
8.118.118.118.11 PLAYPLAYPLAYPLAY
DescriptionDescriptionDescriptionDescription Starts the playback from a specific play item. The play item
index is provided as an argument. Index is 1 based index
of the play item in the currently selected playlist
CommandCommandCommandCommand PLAY <playitemindex>;
ResponseResponseResponseResponse OK:PLAY <playitemindex>;
ERR:INVALID PARAMETER
8.128.128.128.12 MUTEMUTEMUTEMUTE
DescriptionDescriptionDescriptionDescription Mute the Audio.
CommandCommandCommandCommand MUTE;
ResponseResponseResponseResponse OK:MUTE;
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
67676767
8.138.138.138.13 UNMUTEUNMUTEUNMUTEUNMUTE
DescriptionDescriptionDescriptionDescription Unmute the Audio.
CommandCommandCommandCommand UNMUTE;
ResponseResponseResponseResponse OK:UNMUTE;
8.148.148.148.14 VOLUMEUPVOLUMEUPVOLUMEUPVOLUMEUP
DescriptionDescriptionDescriptionDescription Increase the audio volume.
CommandCommandCommandCommand VOLUMEUP;
ResponseResponseResponseResponse OK:VOLUMEUP;
8.158.158.158.15 VOLUMEDOWNVOLUMEDOWNVOLUMEDOWNVOLUMEDOWN
DescriptionDescriptionDescriptionDescription Decrease the audio volume.
CommandCommandCommandCommand VOLUMEDOWN;
ResponseResponseResponseResponse OK:VOLUMEDOWN;
8.168.168.168.16 SETVOLUMESETVOLUMESETVOLUMESETVOLUME
DescriptionDescriptionDescriptionDescription Sets the audio volume. Values between 0 and 130
CommandCommandCommandCommand SETVOLUME <volume>;
ResponseResponseResponseResponse OK:SETVOLUME <volume>;
ERR:INVALID PARAMETER
8.178.178.178.17 FULLSCREENFULLSCREENFULLSCREENFULLSCREEN
DescriptionDescriptionDescriptionDescription Enable/Disable full screen playback.
CommandCommandCommandCommand FULLSCREEN on; enable full screen playback
FULLSCREEN off; disable full screen playback
ResponseResponseResponseResponse OK:FULLSCREEN;
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
68686868
8.188.188.188.18 INFOINFOINFOINFO
DescriptionDescriptionDescriptionDescription Enable/Disable playback info notifications.
CommandCommandCommandCommand INFO on; enable playback info
INFO off; disable playback info
ResponseResponseResponseResponse OK:INFO;
8.198.198.198.19 INFOINFOINFOINFO notificationsnotificationsnotificationsnotifications
When the playback info notification is enabled, the software sends the
following playback notification messages:
DescriptionDescriptionDescriptionDescription When the playback state changes to stopped.
CommandCommandCommandCommand INFO:STOPPED:<playlistindex>;
DescriptionDescriptionDescriptionDescription When the playback state changes to paused.
CommandCommandCommandCommand INFO:PAUSED:<playlistindex>:<playitemindex>;
DescriptionDescriptionDescriptionDescription When the playback state changes to playing.
CommandCommandCommandCommand INFO:PLAYING:<playlistindex>:<playitemindex>;
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
69696969
8.208.208.208.20 QUITQUITQUITQUIT
DescriptionDescriptionDescriptionDescription Quits and closes the warping software.
CommandCommandCommandCommand QUIT;
ResponseResponseResponseResponse OK:QUIT;
8.218.218.218.21 SHUTDOWNSHUTDOWNSHUTDOWNSHUTDOWN
DescriptionDescriptionDescriptionDescription Shuts down the PC.
CommandCommandCommandCommand SHUTDOWN;
ResponseResponseResponseResponse OK:SHUTDOWN;
8.228.228.228.22 RESTARTRESTARTRESTARTRESTART
DescriptionDescriptionDescriptionDescription Restarts the PC.
CommandCommandCommandCommand RESTART;
ResponseResponseResponseResponse OK: RESTART;
9999 License optionsLicense optionsLicense optionsLicense options
The software can be licensed with different license modes. For more
information about the available license modes please visit:
https://dev.elise-ng.net/index.php/products
9.19.19.19.1 PCPCPCPC Locked and USB Dongle LicensesLocked and USB Dongle LicensesLocked and USB Dongle LicensesLocked and USB Dongle Licenses
The PC Locked LicensePC Locked LicensePC Locked LicensePC Locked License is "locked" to the PC Hardware components. The
software will generate a "HardwareIDHardwareIDHardwareIDHardwareID", and based on this HardwareIDHardwareIDHardwareIDHardwareID, a
"License Code" will be generated and emailed. The software can run only on
that PC as long as the hardware components do not change. When a hardware
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
70707070
component changes, the software will generate another HardwareIDHardwareIDHardwareIDHardwareID. Based on
the changed HardwareIDHardwareIDHardwareIDHardwareID, it can be determined which component has been
changed. If only one hardware component has been changed, we can generate
a new PC Locked License. If the PC hardware is changed completely or a new
PC is used, PC Locked License can NOT be re-generated.
If the software will be used on a changing PC Hardware configurations, or if
the software will be used on more than one PC, a USB Dongle LicenseUSB Dongle LicenseUSB Dongle LicenseUSB Dongle License needs
to be ordered.
The USB Dongle LicenseUSB Dongle LicenseUSB Dongle LicenseUSB Dongle License is stored and delivered on a secure "USB DongleUSB DongleUSB DongleUSB Dongle". The
USB Dongle LicenseUSB Dongle LicenseUSB Dongle LicenseUSB Dongle License is independent of the PC Hardware. The software can be
used on any PC as long as the USB Dongle is inserted. USB dongles are
delivered by post. Shipping costs are included in the price.
9.29.29.29.2 Commercial and HomeCommercial and HomeCommercial and HomeCommercial and Home----User LicensesUser LicensesUser LicensesUser Licenses
A Commercial LicenseCommercial LicenseCommercial LicenseCommercial License is for customers who are using the software for
commercial applications and receive financial compensation from using the
software. Re-sellers and system integrators who use the software in their
solutions are considered commercial parties. Commercial license can NOT be
ordered as PC Locked License. For commercial use only USB Dongle License
must be ordered. If a PC Locked License is ordered and if the PC Hardware
components change, PC License will not be re-generated.
A HomeHomeHomeHome----User LicenseUser LicenseUser LicenseUser License (non-commercial) is for individual home-use only. It can
only be purchased if no financial compensation is received whatsoever from
using the software. A Home-user License can be ordered as both PC Locked
License and USB Dongle License.
9.39.39.39.3 License validityLicense validityLicense validityLicense validity
Both PC Locked and USB Dongle licenses are perpetualperpetualperpetualperpetual. A perpetual license will
allow the customer to use the licensed software indefinitelyindefinitelyindefinitelyindefinitely. For the first 2 2 2 2
yearsyearsyearsyears, the perpetual license also entitles the customer to download all updatesupdatesupdatesupdates
to the software and to receive technical supporttechnical supporttechnical supporttechnical support.
After the 2 - year period ends, the customer can choose to remain with the
last version downloaded or to purchase a 2 - year Updates & SupportUpdates & SupportUpdates & SupportUpdates & Support package,
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
71717171
for 40% of the license price. There are no penalties for letting Updates &
Support lapse for a while before purchasing a new 2 – year Updates & Support
package. The new 2 - year Updates & Support period will be extended from
the expiry date of the last 2-year period.
9.49.49.49.4 Register the software with PC Locked LicenseRegister the software with PC Locked LicenseRegister the software with PC Locked LicenseRegister the software with PC Locked License
After you send us the HardwareID, we will generate the PC Locked License
Code.
PC Locked License can be entered using the Software License Window and
pressing the Enter PC Locked LicenseEnter PC Locked LicenseEnter PC Locked LicenseEnter PC Locked License button.
A new window will open to enter the license code.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
72727272
Paste the license code that you received from us in the window and press
Apply. The software needs to be restarted to apply the license.
If you have an “old” license with UserName and LicenseKey, select the “Old”
tab.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
73737373
Enter the UserName and LicenseKey. Press Apply and restart the software to
apply the license.
Immersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User GuideImmersive Player PRO User Guide
74747474
10101010 License agreementLicense agreementLicense agreementLicense agreement
Copyright (c) 2009-2020 by Fly Elise-ng.
License for use and distribution of this software:
Immersive Immersive Immersive Immersive Player PROPlayer PROPlayer PROPlayer PRO is "try-before-you-buy" software. This means:
• Fly Elise-ng exclusively owns all copyrights to Immersive Player PRO.
• You may use this software for evaluation purposes without charge for 30
days. The evaluation version displays an 'Unregistered Version' text on the
screen. To remove the text, you need to buy a registration key and register
it with the software. You can purchase the key from our website at
http://fly.elise-ng.net
• Once purchased, the user is granted a non-exclusive license to use
Immersive Player PRO on one computer (i.e. a single CPU), for any legal
purpose, at a time. The licensed Immersive Player PRO software may not be
rented or leased, nor may be transferred to another person.
• You may not redistribute Immersive Player PRO in any manner other than
by linking to the Web page listed below without prior written permission.
• You may not redistribute your registration key in any manner.
• Immersive Player PRO IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND
IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK. THE AUTHOR WILL
NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY
OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.
• You may not use, copy, emulate, clone, rent, lease, sell, modify, decompile,
disassemble, otherwise reverse engineer, or transfer the licensed program,
or any subset of the licensed program, except as provided for in this
agreement. Any such unauthorized use shall result in immediate and
automatic termination of this license and may result in criminal and/or civil
prosecution.
• The Author reserves all rights not expressly granted here.
• Installing and using Immersive Player PRO signifies acceptance of these
terms and conditions of the license.
• If you do not agree with the terms of this license you must remove
Immersive Player PRO files from your storage devices and cease to use the
product.
Thank you for using the original Immersive Player PRO.
Web: https://fly.elise-ng.net
Email: [email protected]