Appendix A: SOS Stream Control Configuration File
If you’re on SOS version 5.5 or above, please visit Appendix B: SOS Configuration Manager.
Each site’s configuration for projector height, distance and resolution are stored in /home/sos/sos_stream_control.config. The parameters in this file are set during installation and normally should only be changed if the exhibit is reconfigured.
The first part of the file may be edited while the last part should not be changed. The dividing line between these two parts is clearly demarcated. The editable part is shown here, divided into separate blocks to provide more explanation. To change the default value for a given setting, uncomment the line in a text editor and use or change the value there. In older systems, some of these settings may be missing, in which case you can add them and set the value you need.
Autorun Timer
Permalink to Autorun TimerThe length in seconds for playing a dataset in autorun mode. The default value of 180.
# Default amount of time (in seconds) a clip will play in autorun mode, if not
# set specifically in the playlist.
#set defaultTimer 10
Default Volume
Permalink to Default VolumeThe default volume level to use as a percentage of the system equipment volume. The valid range is 0 to 100.
# Default mplayer volume level for each clip that does not explicitly specify a
# level using the 'volume' keyword. Note that mplayer volume can only be a
# fraction of what the system volume is. So, if the system volume is set to 50%
# and the defaultVolume is set to 50%, the output volume will be 25%.
#set defaultVolume 75
Maximum Frame Width in SOS
Permalink to Maximum Frame Width in SOSThe maximum frame width supported in SOS. The default value of 4096 is normally used, but may be increased for 4K systems.
# Max texture size for SOS data. The default is 4096.
#set env(SOS_MAX_TEXTURE_SIZE) 8192
Default Playlist
Permalink to Default PlaylistPath to a playlist that is automatically loaded each time the SOS system first starts up. The default is the nomal-demo.sos playlist in either /home/sos/sosrc or /home/sosdemo/sosrc, depending on which user starts SOS.
# Default playlist that opens with the SOS GUI.
set auto_open_sos_file $env(HOME)/sosrc/normal-demo.sos
Projector Settings
Permalink to Projector SettingsThese properties are typically set when first installing the SOS equipment. They will not require editing afterward unless the number or type of projectors are changed.
# Default gamma setting for projectors to facilitate edge blending.
set gamma 0.8
set fullScreen "-fullScreen"
set projectorInfo(viewport) { 0,0,0.5,0.5 0.5,0,0.5,0.5 0,0.5,0.5,0.5 0.5,0.5,0.5,0.5 }
set projectorInfo(hostname) { localhost localhost localhost localhost }
set numberOfProjectors 4
set env(SOS_DISPLAY) :1
set bottommask 60,70
Text PIP
Permalink to Text PIPNew for SOS v5.2. These properties are typically set when first installing the SOS equipment, and are used to achieve optimal text resolution on the sphere. They will not require editing afterward unless the number or type of projectors are changed.
## Text PIP Configuration: ##
# Native resolution for a single projector in the SOS display.
set env(SOS_PROJECTOR_WIDTH) 1920
set env(SOS_PROJECTOR_HEIGHT) 1200
# Number of projectors.
set env(SOS_NUM_PROJECTORS) 4
# Total degrees longitude of display. Typically, 90 degrees per projector.
set env(SOS_DISPLAY_DEGREES_WIDTH) 360
# Total degrees latitude of display. Typically, total is 180 degrees.
set env(SOS_DISPLAY_DEGREES_HEIGHT) 180
## End Text PIP Config ##
Magnify Graphics
Permalink to Magnify GraphicsNew for SOS v5.3. This property determines whether to show graphics elements (text and image PIPS, labels, icons, and annotation lines) inside the zoom magnifier window. By default, they are shown. Valid values are 1 (on) or 0 (off).
set env(SOS_MAGNIFY_GRAPHICS) 1
Display Performance
New for SOS v5.3. These properties determine system settings related to image display. They may be modified to tune SOS performance but generally won’t need to be changed once set.
# Set thread count. Default is 4
set env(SOS_THREAD_COUNT) 6
# Set stream size (number of frames SOS keeps in memory at a time).
# Default is 20.
set env(SOS_STREAM_SIZE) 30
Auto Alignment (Experimental Feature)
Permalink to Auto Alignment (Experimental Feature)These properties are typically set when first installing the experimental auto alignment camera equipment. They with probably will not require editing unless the type of camera is changed.
## Auto-Alignment Configuration: ##
# Set the cameras we want to use. Options are: V4L2 or POINTGREY.
# Unless you are a legacy installation, you will want to use POINTGREY.
set env(SOS_CAMERA_LIBRARY) POINTGREY
# (default) Point Grey - BlackFly resolution is 1280x960
# V4L2 - Full resolution web cam is 2304x1536.
# V4L2 - Low resolution is typically set at 640x480
set env(SOS_MAX_CAMERA_WIDTH) 1280
set env(SOS_MAX_CAMERA_HEIGHT) 960
## End Auto-Alignment Config ##
Exhibit Distances
Permalink to Exhibit DistancesThese properties are typically set when first installing the SOS equipment. The “projectoyInfo” property changes where latitude 0 degrees will be located relative to the projectors.
The other properties are measurements that must be as accurate as possible to get a good alignment of the projectors. They will not require editing afterward unless the position of the sphere or any of the projectors are changed.
# Default orientation of all datasets around the z-axis, in degrees, when they
# are first loaded on the sphere.
#set projectorInfo(projectorRotation) 0
# Measured height, in inches, of the equator.
set Sphere_Height_At_Equator_Inches 84.0
# Measured height, in inches, of each projector lens.
# By experience, 1 inch lower than real height makes better alignment.
set P1_Height_Inches 92.0
set P2_Height_Inches 92.0
set P3_Height_Inches 92.0
set P4_Height_Inches 92.0
# Horizontal distance, in inches, of each of the four projectors from sphere
# center.
set P1_DIST_INCHES 211.0
set P2_DIST_INCHES 211.0
set P3_DIST_INCHES 211.0
set P4_DIST_INCHES 211.0