Medialon MxMs' Help 
  
Name : Sony Camera VISCA
Version : 1.0.0
Available for : Manager V5 (All versions)
Limitation In :
Device Brand : Sony
Positrack Compatible : Yes
Resources type : Serial
 
Compatible hardware interfaces - available resource modules (MRC) :
 

 

> Overview | > Installation (MXM) | > Creation (Device) | > Commands (List Of) | > Variables (List Of) | > Support


Overview :

VISCA is the protocol used by Sony to remote control BRC-300 color video camera series.This MxM allows the control of video camera as a simple remote control unit, but also as a powerfull sequence editor.

Note that this MxM supports only "standard" Pan and Tilt direction (not reverse)

> Top


Installation (MXM) :

This MxM doesn't require any specific installation.

> Top


Creation (Device) :

Device Creation Window :

 


Output Serial Port :
Serial port number used to communicate with the Camera.

Output Baud Rate :
The Baud Rate at which the port must run.

Use Sony Remote :
If checked, a VISCA compatible hardware remote control unit (as Sony RM-BR300) can control video camera through the MXM.

Sony Remote Input Serial Port :
Com port number used to communicate with the Remote unit.

Remote Baud Rate :
The Baud Rate at which the port must run.

Camera ID :
Up to seven Camera can be operate remotely from the same COM Port (daisy chain).
Each camera is addressed by its ID.

> Top


Graphical User Interface:

Device Control Panel

This MxM provides a Device Control Panel which can be displayed either as a stand alone window or inside a User Screen Contenair object with the "Device Control" Manager command. Note: See the Manager Help menu for details about using this command.

The MXM Control Panel provides a cue sequence editor allowing to create sequences of camera moves. Once created, these sequences can be recalled and played via commands of the MxM like "Load Sequence" and "Sequence Control".

The bottom left part of the control panel is a drawing surface, with grey line axes that represent camera Pan and Tilt ranges. The "Home position" is viewed as the intersection of the horizontal and vertical gray lines.

Right-Click on that surface and choose "New Point" in order to create a point. Select this new point and drag it to define a position. The camera will follow your movements as the point is moved with the mouse.

Alternatively, an optional Sony Remote Control Unit can be used to define the point position. To use a Remote Control Unit for positioning, select a previously created point, check "Use Sony Remote" and use the hardware remote unit to position the camera. Then click "Capture Values" to set up the selected point.

To delete a point, just right click on it and choose "Delete Point" (you cannot delete a point which has an associated cue in the timeline above. You must delete the cue before).

To create a sequence, select a point, right click on the timeline and choose "New Cue". A cue is created showing the name of its associated point, its time position and its zoom and focus setting (if they are included in the cue). You can move a cue anywhere on the timeline. To include zoom or focus setting in a selected cue, check the zoom or focus "In Cue" option and set the slider to desired value.

The sequence length can be modified by clicking on the time display at the lower right of the sequence timeline.

Use the "Sequence" button to manage the creation, loading and saving of your sequence.
Test the sequence with the play, pause, stop transport commands buttons on the upper left of the control panel.

> Top


Commands (List Of) :

 

Power :

      Description : Turn on or off the camera.
      Parameters :
      Mode : [Type : Enum] : "On" or "Off".
Pan/Tilt :
      Description : Control camera positioning.
      Parameters :
      Mode : [Type : Enum] : Pan/Tilt Mode.

        Available Values:
        "Up" : Move Up.
        "Down" : Move Down.
        "Left" : Move Left.
        "Right" : Move Right.
        "UpLeft" : Move Up and Left.
        "UpRight" : Move Up and Right.
        "DownLeft" : Move Down and Left.
        "DownRight" : Move Down and Right.
        "Stop" : Stop moving.
        "Home" : Face camera back to the front.
        "Reset" : Calibration sequence.
        "Absolute Smooth Position" : Move camera at the specified position smoothly (final position may be a little bit "off" but camera move is smooth).
        "Relative Position" : Move camera from the current position.
        "Absolute Accurate Position" : Move camera at the specified position accurately (final position is accurate but a slight jerkiness may occur at the end of the move).

      Pan Speed : [Type : Integer] : Speed move for horizontal axis. This value is ignored for "Absolute" or "Relative" position modes.
      Tilt Speed : [Type : Integer] : Speed move for vertical axis. This value is ignored for "Absolute" or "Relative" position modes.
      Pan Position : [Type : Integer] : Horizontal distance in 1/100 degrees from front position. Negative value moves camera clockwise
      , positive moves counterclockwise.
      Tilt Position : [Type : Integer] : Vertical distance in 1/100 degrees from front position. Negative value moves camera down
      , positive moves up.
      Move Duration : [Type : Time] : Total duration of the move for "Absolute Smooth Position", "Relative Position" and "Absolute Accurate Position" mode.

Zoom :
      Description : Control camera zooming.
      Parameters :
      Mode : [Type : Enum] : Zoom Mode.

        Available Values:
        "Stop" : Stop zooming.
        "Tele Standard" : Zoom in at default speed.
        "Wide Standard" : Zoom out at default speed.
        "Tele Variable" : Zoom in at user defined speed.
        "Wide Variable" : Zoom out at user defined speed.
        "Direct" : Set zoom to direct value specified furthe
        r.

      Speed : [Type : Integer] : Speed of zooming (user defined) for "Tele Variable" and "Wide Variable" modes.
      Direct Ratio : [Type : Integer] : Zoom ratio if Direct Mode is selected.

      Zoom Duration : [Type : Time] : Total duration for Zooming for "Direct" mode.

Digital Zoom :
      Description : Control camera digital zooming.
      Parameters :
      Mode : [Type : Enum] : Zoom Mode.

        Available Values:
        "On" : Digital zoom enable.
        "Off" : Digital zoom disable.
        "Combine Mode" : Optical and digital zoom are working together.
        "Stop" : Stop zooming.
        "Tele Variable" : Digital zoom in at user defined speed.
        "Wide Variable" : Digital zoom out at user defined speed.
        "Direct" : Set digital zoom to direct value specified furthe
        r.

      Direct Ratio : [Type : Integer] : Zoom ratio if Direct Mode is selected.
Focus :
      Description : Control camera focus.
      Parameters :
      Mode : [Type : Enum] : Focus Mode.

        Available Values:
        "Stop" : Stop focus move.
        "Far Standard" : Move far at default speed.
        "Near Standard" : Move near at default speed.
        "Far Variable" : Move far at user defined speed.
        "Near Variable" : Move near at user defined speed.
        "Direct" : Set focus to direct value specified furthe
        r.
        "Autofocus" : Automatic focus activated.
        "Manual Focus" : Automatic focus disabled..
        "Infinity" : Forced infinity focus setting.

      Speed : [Type : Integer] : Focus speed (user defined).
      Value : [Type : Integer] : Focus value (in centimeters) when Direct Mode is selected.

      Auto Focus Mode : [Type : Enum] : If Auto Focus Mode selected.

        Available Values:
        "Normal Auto Focus" : The automatic focus adjustement is always activated.
        "Interval Auto Focus" : The automatic focus adjustement is activated only during the selected "activate time" with the selected "interval time".
        "Zoom Trigger Auto Focus" : The automatic focus adjustement is activated after zooming operation is finished, only during the selected "activate time".
        "Active/Interval Time" : Set auto focus to time value specified furthe
        r.

      Active Time : [Type : Time] : Period of time for wich the automatic focus adjustement is activated.
      Interval Time : [Type : Time] : Interval with wich automatic focus adjustement is activated.

White Balance :
      Description : Control camera white balance.
      Parameters :
      Mode : [Type : Enum] : White balance Mode.

        Available Values:
        "Auto" : White balance sets automatically.
        "Indoor" : Default setting for indoor lighting.
        "Outdoor" : Default setting for outdoor lighting.
        "One Push White Balance" : Active the One Push mode.
        "Manual" : Manual mode (active RGain and BGain).
        "One Push Trigger" : Trigg the One Push mode
        .

RGain :
      Description : Control camera Red Gain (white balance must be in manual mode).
      Parameters :
      Mode : [Type : Enum] : Red Gain Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment gain.
        "Down" : Decrement gain.
        "Direct" : Set gain to direct value specified further
        .

      Direct Value : [Type : Integer] : Gain value (0-255) when Direct Mode is selected.
BGain :
      Description : Control camera Blue Gain (white balance must be in manual mode).
      Parameters :
      Mode : [Type : Enum] : Blue Gain Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment gain.
        "Down" : Decrement gain.
        "Direct" : Set gain to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Gain value (0-255) when Direct Mode is selected.
Gain :
      Description : Control camera Gain.
      Parameters :
      Mode : [Type : Enum] : Gain Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment gain.
        "Down" : Decrement gain.
        "Direct" : Set gain to direct value specified further
        .

      Direct Value : [Type : Integer] : Gain value (0-7) when Direct Mode is selected.
Bright :
      Description : Control camera brightness.
      Parameters :
      Mode : [Type : Enum] : Brightness Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment brightness.
        "Down" : Decrement brightness.
        "Direct" : Set brightness to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Brightness value (0-23) when Direct Mode is selected.
Shutter :
      Description : Control camera shutter.
      Parameters :
      Mode : [Type : Enum] : Shutter Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment shutter speed.
        "Down" : Decrement shutter speed.
        "Direct" : Set shutter speed to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Shutter value when Direct Mode is selected.
      Slow Shutter Mode : [Type : Enum] : Slow shutter setting.

        Available Values:
        "Auto" : Slow shutter automatic setting.
        "Manual" :
        Slow shutter manual setting.

Iris :
      Description : Control camera iris.
      Parameters :
      Mode : [Type : Enum] : Iris Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment iris opening.
        "Down" : Decrement iris opening.
        "Direct" : Set iris opening to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Iris opening value (0-17) when Direct Mode is selected.
Automatic Exposure :
      Description : Set the automatic exposure mode.
      Parameters :
      Mode : [Type : Enum] : Automatic exposure Mode.

        Available Values:
        "Full Auto" : The exposure is adjusted automatically using the sensivity, electronic shutter speed and iris.
        "Manual" : Adjust the gain, electronic shutter and iris manually.
        "Shutter Priority" : The exposure is adjusted automatically using the sensivity and iris. Electronic shutter speed must be adjusted manually.
        "Iris Priority" : The exposure is adjusted automatically using the sensivity and electronic shutter speed. Iris must be adjusted manually.
        "Bright" : Adjust the brightness level manually
        .

Aperture :
      Description : Control camera aperture.
      Parameters :
      Mode : [Type : Enum] : Aperture Mode.

        Available Values:
        "Reset" : Set value to 0.
        "Up" : Increment aperture.
        "Down" : Decrement aperture.
        "Direct" : Set aperture to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Aperture value when Direct Mode is selected.
Wide Mode :
      Description : Set wide mode.
      Parameters :
      Mode : [Type : Enum] : Wide Mode.

        Available Values:
        "Off" : 4:3 aspect ratio is selected.
        "16/9" : 16:9 aspect ratio is selected.
        "Reset" : Reset aspect ratio.

Memory :
      Description : Memory preset management.
      Parameters :
      Command : [Type : Enum] : Memory management.

        Available Values:
        "Reset" : Erase the setting of the specified memorized position.
        "Set" : Memorize current camera position.
        "Recall" : Move camera to a memorized position.

      Memory : [Type : Integer] : Memory number of a memorized position.
      Speed
      : [Type : Integer] : Speed to reach new position.

Image Flip :

      Description : Image Rotation.
      Parameters :
      Mode : [Type : Enum] : "On" or "Off".
      Usage : Use Image Flip to rotate the camera image supplied from the video connector upside down and to reverse the direction of the camera movement by pan/tilt operation.
      Note : When setting Image Flip to on, turn off the camera and turn it on again.

Menu Off :

      Description : Make all displayed informations disappear.
      Parameters : No parameter.

IR Receive :

      Description : Set infrared signal reception.
      Parameters :
      Mode : [Type : Enum] : "On" or "Off".
      Usage : When it is set Off, the camera does not receive the signal from the Infrared Remote Commander.

Picture Effect :
      Description : Set picture effect.
      Parameters :
      Mode : [Type : Enum] : Picture effect.

        Available Values:
        "Off" : No picture effect.
        "Neg Art" : The image of the camera is reversed to negative.
        "Black/White" : The image of the camera becomes monochrome.

Exposure Compensation :
      Description : Set exposure compensation.
      Parameters :
      Mode : [Type : Enum] : Compensation Mode.

        Available Values:
        "On" : Compensation is active (except if Automatic Exposure Mode is set to Manual).
        "Off" : Compensation is inactive.
        "Reset" : Set value to 0.
        "Up" : Increment compensation level.
        "Down" : Decrement compensation level.
        "Direct" : Set compensation level to direct value specified furthe
        r.

      Direct Value : [Type : Integer] : Compensation level value when Direct Mode is selected.
Use Sony Remote :

      Description : Sony remote control unit setting.
      Parameters :
      Mode : [Type : Enum] : "On" or "Off".
      Usage : When it is set to On, a remote control unit can be plugged into the computer and then, control the camera through the MXM ("Sony remote input" section of the MXM setup must be filled).

Load Sequence :

      Description : Load a sequence file.
      Parameters :
      File Name : [Type : String] : Name of the sequence to be loaded
      .

Sequence Control :
      Description : Transport sequence commands.
      Parameters :
      Command : [Type : Enum] : Sequence command.

        Available Values:
        "Play" : Read the sequence.
        "Pause" : Pause the sequence.
        "Stop" : Stop the sequence.

Set Sequence Directory :

      Description : Set default folder path to store sequence files.
      Parameters :
      Directory : [Type : String] : Directory path
      .

Recall Sequence Point :

      Description : Recall a point from a a sequence.
      Parameters :
      Sequence : [Type : String] : Name of the sequence
      Point : [Type : String] : Name of the point
      Usage :
      When a point is recalled, pan and tilt position
      are always sent to the camera. Zoom and Focus are sent only if they are included in the point definition.

    > Top


    Variables (List Of) :

    Status :

        Type : Enum.
        Description : Current status of the device.
        Available Values :

          "Not Online" : No camera detected.
          "Ready" : Camera is ready to receive commands.
          "Executing" : Camera is performing commands that cannot be interrupted.

    Last Error :

        Type : Enum.
        Description : Last error message received.
        Available Values :

          "Not Error" : No reported error.
          "Time Out" : No response.
          "Format Error" : Format command unknown.
          "Command Buffer Full" : The last command could not be completed because commands pending list is full.
          "Command Not Executable" : The last command could not be completed because it was not supported in current state.
          "Cannot Open COM Port" : COM Port isn't available.

    Power :

        Type : Enum.
        Description : Power status of the device.
        Available Values :

          "Off" : Camera is off.
          "On" : Camera is on.

    Pan, Tilt, Zoom, Digital Zoom, Focus :

        Type : Integer.
        Description : Current value.

    Use Sony Remote :

        Type : Enum.
        Description : Remote controler availability.
        Available Values :

          "Off" : Remote control isn't available.
          "On" : Remote controle unit can be used through the MXM.

    Sequence File Name:

        Type : String.
        Description : Name of the currently loaded sequence.
    Sequence Status :

        Type : Enum.
        Description : Status of the currently loaded sequence.
        Available Values :

          "Iddle" : There is no sequence loaded.
          "Stop" : Sequence is stopped.
          "Playing" : Sequence is currently playing.
          "Pause" : Sequence is paused.

    Sequence Timecode :

        Type : Time.
        Description : Current playing position in the sequence.
    Sequence Directory:
        Type : String.
        Description : Sequences saving folder path.

      > Top


      Support (Difference with previous versions) :

      > Top