Main Content

executeCommand

Execute command on GigE Vision or GenICam compliant camera

collapse all in page

Syntax

executeCommand(vobj,commandname)

Description

executeCommand(vobj,commandname) executes the specified command on the camera represented by vobj, which can be either a gigecam object or videosource object.

Use the commands function to get the list of available commands for your camera.

example

Examples

collapse all

Use executeCommand to execute any of the commands found by the commands function, which tells you what commands are available for your camera to use.

Use the gigecamlist function to ensure that MATLAB® is discovering your camera.

gigecamlist
ans = 

	Model              Manufacturer           IPAddress       SerialNumber
  ____________________   ___________________   _______________    ______________

  'MV1-D1312-80-G2-12'   'Photonofocus AG'     '169.254.192.165'  '022600017445'

Use the gigecam function to create an object and connect to the camera.

vobj = gigecam
vobj = 

   Display Summary for gigecam:

          DeviceModelName: 'MV1-D1312-80-G2-12'
             SerialNumber: '022600017445'
                IPAddress: '169.254.192.165'
              PixelFormat: 'Mono8'
    AvailablePixelFormats: {'Mono8'  'Mono10Packed'  'Mono12Packed'  'Mono10'  'Mono12'}
                   Height: 1082
                    Width: 1312

   Show Beginner, Expert, Guru properties.
   Show Commands.

Get the list of supported commands from the camera. You can click Show Commands in the property list that is displayed when you create the object, or you can use the function.

commands(vobj)
  Available commands:

    ADCBoardDeviceTemperature_Update
    Average_Update
    CameraHeadFactoryReset
    CameraHeadReset  
    Correction_BusyUpdate
    Correction_CalibrateBlack
    Correction_CalibrateGrey
    Correction_SaveToFlash
    Counter_ImageReset
    Counter_ImageUpdate
    Counter_MissedBurstTriggerReset
    Counter_MissedBurstTriggerUpdate
    Counter_MissedTriggerReset
    Counter_MissedTriggerUpdate
    PLC_ts_trig_Arm
    PLC_ts_trig_FIFOClear
    SensorBoardDeviceTemperature_Update
    SensorDeviceTemperature_Update

Execute a command, such as setting a calibration correction.

executeCommand(vobj,"Correction_CalibrateGrey");

Create a connection to a GenICam™ GenTL camera using the videoinput function, and create an object for its video source.

vid = videoinput("gentl");
vobj = getselectedsource(vid);

Get the list of supported commands from the camera. You can click Show Commands in the property list that is displayed when you create the object, or you can use the function.

commands(vobj)
ans = 

  18×1 string array

    "ADCBoardDeviceTemperature_Update"
    "Average_Update"
    "CameraHeadFactoryReset"
    "CameraHeadReset"
    "Correction_BusyUpdate"
    "Correction_CalibrateBlack"
    "Correction_CalibrateGrey"
    "Correction_SaveToFlash"
    "Counter_ImageReset"
    "Counter_ImageUpdate"
    "Counter_MissedBurstTriggerReset"
    "Counter_MissedBurstTriggerUpdate"
    "Counter_MissedTriggerReset"
    "Counter_MissedTriggerUpdate"
    "PLC_ts_trig_Arm"
    "PLC_ts_trig_FIFOClear"
    "SensorBoardDeviceTemperature_Update"
    "SensorDeviceTemperature_Update"

Use executeCommand to execute the Correction_CalibrateGrey command.

executeCommand(vobj,"Correction_CalibrateGrey");

Input Arguments

collapse all

Camera or video source, specified as:

  • A gigecam object representing a GigE Vision® camera.

  • A videosource object, derived from a videoinput object created for a GenICam compliant camera using the 'gige' or 'gentl' adaptor.

Data Types: gigecam | videosource

Name of command you want to execute on your camera, specified as a character vector or string. Use the commands function to get the list of available commands for your camera. Then use executeCommand to execute any of the available commands.

Example: executeCommand(vobj,"AutoFocus")

Data Types: char | string

Version History

Introduced in R2014b

See Also

| | | |