## Connection Management

| The connections window allows you to control two or more mrViewers from a single interface, which can be useful for reviewing dailies.

To use it, you first need to create a server at an empty port. The default of 4333 should be fine most of the time. Once a server is created, the clients can connect to it at that machine name and port. The machine name defaults to localhost which is a local connection to the local machine (two viewers running on the same machine). If accessing two viewers from different locations you need to specify the name of the remote machine as well as the port number. You can also connect the server or the client command-line, by using:

> mrViewer -p [port number] # to create a server.

> mrViewer -t [hostname] -p [port number] # to create a client.
If all goes well, once created you will see in the server:

{conn} [server] Created server at port 4333

And the client will connect with:

{conn} [main] Start client at mymachine, port 4333

{conn} [client] Trying 128.92.30.1:4333...

{conn} [client] Connected to 128.92.30.1:4333

The client will check all images and reels from the server and mimic it as best as it can, assuming all paths are visible from both machines. From then on, you will see different {conn} messages every time the two instances of mrViewer acknoledge each other about a change.
You can also use a telnet connection to control the viewer, like:

telnet localhost 4333

## Commands

Command | Example(s) | Effect
CurrentImage index "imgname" first_frame last_frame | CurrentImage 2 "/media/images/test.%02d.pic" 1 30 | Changes the image on the current reel based on image name and start and end frames. If the image does not exist, it will load it.
FPS double | FPS 23.976 | Change frame rate to all images currently shown.
EDL bool | EDL 1 | Change EDL to reel currently shown.
Looping int | Looping 1 ( 1 = loop, 2 = swing, 0 = no loop ) | Change looping mode in timeline.
Selection x y w h | Selection 20 30 120 240 | Change selection area in image.
| Zoom double | Zoom 1.5 | Zooms the view the percentage specified.
Offset double double | Offset -320 240 | Offsets the view when not in VR mode.
Rotation double double | Rotation 20 50 | Rotates the view when in VR mode.
Spin double double | Spin 10 20 | Spins the view when in VR mode.
MovePicture double double | MovePicture -10.6 20.5 | Moves the picture an offset.
ScalePicture double double | ScalePicture 0.5 0.25 | Scales the picture a percentage.
UpdateLayers | UpdateLayers | Updates the layers and color channels
Channel int | Channel 0 Color | Changes color channel to a new one.
FieldDisplay int | FieldDisplay 0 ( 0 = Both, 1 = Top, 2 = Bottom ) | Changes field display shown.
Normalize bool | Normalize 0 | Normalizes colors to a gray range (useful for shadow maps).
WipeVertical double | WipeVertical 0.2 | Wipes the front image with the background image vertically.
WipeHorizontal double | WipeHorizontal 0.2 | Wipes the front image with the background image horizontally.
NoWipe | NoWipe | Turns off wiping.
OCIO bool | OCIO 1 | Turns on/off OCIO color correction.
OCIOConfig "config.ocio" | OCIOConfig "nuke-default/config.ocio" | Selects an ocio configuration file.
OCIOView "Display" "View" | OCIOView "default" "sRGB" | Selects a display and a corresponding view.
ICS inputcolorspace | ICS sRGB | Selects an input color space for the foreground image.
Gain double | Gain 1.0 | Sets the gain for the foreground image.
Gamma double | Gamma 2.2 | Sets the gamma for the foreground image.
Mask double | Mask 0.2 | Sets the mask for the images.
SafeAreas bool | SafeAreas 1 | Toggles safe areas display on and off.
DisplayWindow bool | DisplayWindow 1 | Toggles image display window on and off.
DataWindow bool | DataWindow 1 | Toggles image data window on and off.
Volume double | Voulume 0.75 | Sets the audio volume between 0 (no volume) and 1.0 (full volume).
UseLUT bool | UseLUT 1 | Toggles 3D Lut on and off.
ShowBG bool | ShowBG 1 | Toggles background image on and off.
ShowPixelRatio bool | ShowPixelRatio 1 | Toggles pixel ratio for the image on and off.
TimelineMax int | TimelineMax 2232 | Sets the timeline maximum frame.
TimelineMaxDisplay int | TimelineMaxDisplay 2232 | Sets the timeline maximum display frame, which should be smaller than timeline maximum frame.
TimelineMin int | TimelineMin 1 | Sets the timeline minimum frame.
TimelineMinDisplay int | TimelineMinDisplay 32 | Sets the timeline minimum display frame, which should be bigger than timeline minimum frame.
VRCubic bool | VRCubic 1 | Toggles VR Cubic display on and off.
VRSpherical bool | VRSpherical 1 | Toggles VR spherical display on and off.
VRangle double | VRangle 30.0 | Sets the view angle in VR mode.
FullScreen | FullScreen | Toggle FullScreen mode.
PresentationMode | PresentationMode | Toggle Presentation mode.
ShiftAudio "reel" "imagename" offset | ShiftAudio "reel #2" "/media/gga/movies/avatar.mp4" 30 | Shifts audio of a movie file.
ShiftMediaStart "reel" "imagename" offset | ShiftMediaStart "reel #2" "/media/gga/movies/avatar.mp4" 30 | Shifts start of a movie file.
ShiftMediaEnd "reel" "imagename" offset | ShiftMediaEnd "reel #2" "/media/gga/movies/avatar.mp4" 30 | Shifts end of a movie file.
CurrentReel "reel" | CurrentReel "reel #2" | Sets the current reel or creates a new one if the name does not exist.
ReplaceImage index "imagename" | ReplaceImage 2 "/media/gga/Datos/pics/file.%04d.exr" | Replaces an image at a certain index with a new image name.
RemoveImage index | RemoveImage 2 | Removes an image at the index from the current reel.
ClomeImage "imgname" | CloneImage "D:/images/imgseq.%04d.exr" | Clones an image frame from the image from the current reel.
InsertImage index "imgname" | InsertImage 1 "D:/images/imgseq.%04d.exr" | Inserts an image at a certain index in the current reel.
ChangeImage index | ChangeImage 3 | Changes the image on the current reel starting at 0. In the example, it would display image 4 on the reel.
ExchangeImage old_index new_index | ExchangeImage 2 0 | Exchanges the image on the old index with the image in the new index.
FGReel index | FGReel 2 | Sets the reel index for the foreground image.
BGReel index | BGReel 2 | Sets the reel index for the background image.
CurrentBGImage "imgname" first_frame last_frame | CurrentBGImage "/media/images/test.%02d.pic" 1 30 | Changes the BG image on the current reel based on image name and start and end frames.
sync_image | sync_image | Forces a syncing of all images and reels.
stop | stop | Stops playback.
playfwd | playfwd | Plays forward.
playback | playback | Plays backward.
seek int | seek 112 | Seeks to a certain frame.
StereoInput int | StereoInput 0 | Sets stereo input. ( 0: no input, 1 = separate layers/images, 2 = top/bottom image, 4 = left/right image )
StereoOutput int | StereoOutput 5 | Sets stereo output. ( 0: no stereo, 1 = stereo left, 2 = stereo right, 4 = stereo OpenGL, 8 = stereo bottom/top, 10 = stereo top/bottom, 16 = stereo side by side, 18 = stereo crossed, 32 = stereo interlaced, 96 = stereo interlaced columns, 160 = stereo checkerboard, 256 = stereo anaglyph, 258 = stereo right anaglyph )
Windows
MediaInfoWindow bool | MediaInfoWindow 1 | Toggles Media Information Window.
ColorInfoWindow bool | ColorInfoWindow 1 | Toggles Color Area Information Window.
GL3dView bool | GL3dView 1 | Toggles 3D View window for deep images.
StereoOptions bool | StereoOptions 1 | Toggles 3D Stereo Options Window.
PaintTools bool | PaintTools 1 | Toggles Paint/Action Tools Window.
HistogramWindow bool | HistogramWindow 1 | Toggles Histogram Window.
VectorscopeWindow bool | VectorscopeWindow 1 | Toggles Vectorscope Window.
WaveformWindow bool | WaveformWindow 1 | Toggles Waveform Window.