Up | Sony ZCL Driver | Unibrain 1394a and b drivers | Sony GigE Cameras | Pylon AreaScan | Matrox MIL9 Area Scan | AVT Prosilica GigE | AVT Firewire Cameras | PtGrey Flea2 Camera | GigeVision Camera support | SVS-VISTEK

Release Notes
 

  

 
PtGrey Flea2 Camera

Scorpion Vision Software supports firewire Flea2 cameras from Point Grey Research Inc. using the

  • PtGreyCamera.dll - Scorpion Camera Driver

Prerequisites

  • Scorpion Vision Software version 7 or higher
  • FlyCapture driver package installed. Supported version 2.0.1.6
  • Cameras are configured and detected by FlyCap2
  • Important: Image format must be set to Format7

Installation

  • If Unibrain driver installed, uninstall it:
    1. Go in to "Control Panel"
    2. Double-click "Add or Remove Programs"
    3. Select "ubCorePro" and then click "Change/Remove"
  • Install FlyCapture 2.0:
    1. Start FlyCapture2 install
    2. In Welcome screen click "Next"
    3. In "FlyCapture Software License Agreement" screen click "Next"
    4. In "Release Notes" screen click "Next"
    5. Fill in User Information and click "Next"
    6. In "Destination Folder" screen click "Next"
    7. In "Select Installation Type" screen select "Complete" and click "Next"
    8. In "IEEE-1394 OHCI driver selection" screen select 1), 2), 3) checkboxes and click "Next"
      Driver Selection
    9. In "Enhanced Halt State Disable" screen click "Next"
    10. In "Ready to Install the Application" screen click "Next"
    11. IIn "View PGR FlyCapture Documents" screen click "Next"
    12. Click "Finish"
  • Add FlyCapture 2.0 to the "Path" environment variable:
    1. Go in to "Control Panel"
    2. Double-click "System"
    3. Choose "Advanced" tab
    4. Click "Environment Variables"
    5. In "System variables" select "Path" and then click "Edit"
    6. Append path ";C:\Program Files\Point Grey Research\FlyCapture2\bin"/li>
    7. CClick "OK" three times
  • Check that Bus Speed is S800:
    1. Start FlyCap2 utility
    2. Select camera
    3. Check that displayed Bus Speed is S800. If not, consult PtGrey Knowledge Base Article 171
      FlyCap2.exe
    4. Check that image format set to Format7
  • Copy PtGreyCamera.dll to the Scorpion installation folder.
  • Set up "continuous" mode:
    1. In Central add script:
      def SetContinuous(on):
        cameras = GetCameras()
        for i in range(cameras.count):
          cam = cameras.getCamera(i)
          cam.setProperty('continuous', on)
    2. In Actions to the "BeforeStart" event add script command "SetContinuous(1)"
    3. In Actions to the "AfterStop" event add script command "SetContinuous(0)"

Note: Performance of 1394 devices may decrease after installing Windows XP SP2 or SP3. See PtGrey Knowledge Base Article 171.

Property page

  • General
    • Log level
      • Level 0 suppresses all messages.
      • Level 1 issues error and warning messages.
      • Levels 2,3,4 issue diagnostic messages.
      • Beware that level 4 produces a lot of messages therefore should be used only on small size images for diagnostic purposes only.
    • Also log into file
      • Write camera related messages into log file.
      • Normally messages are written only on Scorpion console, provided console is enabled for camera messages.
  • Camera Settings
    • Continuous
      Open camera in continuous mode. Image grabbing will be started after Scorpion start-up and camera reset.
    • Brightness
      Sets the level of black in an image.
    • AutoExposureOn
      Auto exposure (AE) allows the camera to automatically control shutter and/or gain in order to achieve a specific average image intensity.
      • False - control of the exposure is achieved via setting shutter and/or gain.
      • True - the camera automatically modifies shutter and/or gain to try and match the average image intensity to one-quarter of the specified AE value. If only one of shutter and gain is in auto mode, the auto exposure controller attempts to control the image intensity using that one parameter. If both of these parameters are in auto mode, the auto exposure controller uses a shutter-before-gain heuristic to try and maximize the signal-to- noise ratio by favoring a longer shutter time over a larger gain value.
    • AutoExposure
      Sets the AE value.
    • AutorExposureAuto
      The camera modifies the AE value in order to produce an image that is visually pleasing.
    • Sharpness
      For sharpness values greater than 1000, the pixel is sharpened; for values less than 1000 it is blurred.
    • SharpnessAuto
      When sharpness is in auto mode, if gain is low, then a small amount of sharpening is applied, which increases as gain decreases. If the gain is high, a small amount of blur is applied, increasing as gain increases.
    • Hue
      Control the Hue component of the images.
    • Saturation
      Control the Saturation component of the images.
    • Gamma
      This value provides a mechanism to control the function used to non-linearly map a higher bit depth image produced by the sensor to the requested number of bits.
    • Shutter
      Control of the CCD shutter time.
    • ShutterAuto
      The shutter value is set by the auto exposure controller.
    • ShutterOnePush
      The shutter value controlled automatically by the camera only once.
    • Gain
      Controls the gain of the A/D converter.
    • GainAuto
      The gain value is set by the auto exposure controller.
    • GainOnePush
      The gain controlled automatically by the camera only once.
  • DCAM Formats
    • DCAMVideoMode
      Video mode.
    • DCAMFRameRate
      Frame rate value.
  • Format7
    • Fmt7Mode
      Mode_0, Mode_1, Mode_2 and Mode_3 are region of interest (sub-window) modes that allow the user to only transmit a selected area of the image. Mode_1 and Mode_2 are also pixel binning (subsampling) modes.
    • offsetX
      This value sets the X offset (left offset) for the area of interest in pixels.
    • offsetY
      This value sets the Y offset (top offset) for the area of interest in pixels.
    • width
      This value sets the width of the area of interest in pixels.
    • height
      This value sets the height of the area of interest in pixels.
    • Fmt7PacketSize
      This value determines the real packet size.
    • Fmt7PixelFormat
      The encoding scheme by which color or grayscale images are produced from raw image data.
  • Storbe/Trigger
    • StrobeOnX
      If enabled, the pin X will output a pulse each time the camera begins integration of an image.
    • StrobeDelayX
      This value sets strobe delay.
    • StrobeDurationX
      This value sets strobe duration. Setting a strobe duration value of zero will produce a strobe pulse indicating the exposure (shutter) time.
    • GPIODirectionX
      Configures pin X to be either input or output.
    • TriggerOn
      Enable external trigger.
    • TriggerSource
      Selects source for the trigger.
    • TriggerMode
      • 0 - the camera starts integration of the incoming light from external trigger input falling/rising edge.
      • 1 - the camera starts integration of the incoming light from external trigger input falling edge.
      • 3 - allows the user to put the camera into a mode where the camera only transmits one out of N specified images.
      • 4 - allows the user to set the number of triggered images to be exposed before the image readout starts.
      • 5 - allows the user to set the number of triggered images to be exposed before the image readout starts.
      • 14 - is a vendor-unique trigger mode that is very similar to Trigger_Mode_0, but allows for triggering at faster frame rates. This mode works well for users who want to drive exposure start with an external event. However, users who need a precise exposure start should use Trigger_Mode_0.
      • 15 - is a vendor-unique trigger mode that allows the user to fire a single hardware or software trigger and have the camera acquire and stream a predetermined number of images at the current frame rate.
    • TriggerParameter
      Specifies the value N when required by trigger mode. See above.
    • TriggerDelay
      Controls the delay between the trigger event and the start of integration.

Properties available from Python

The following named properties can be dynamically accessed with the 'SetProperty' and 'GetProperty' commands:

  • 'continuous'
    • Enter or leave continuous grabbing mode. 
    • The continuous mode is normally set when using the command in hw-trigger. Setting continuous modes removes the need for arming the camera with a Grab command.
  • 'AutoExposure'
  • 'Shutter'
  • 'Reset'
    • Close and ReOpen the camera.

Example 1: Start Continuous grabbing

  SetProperty('continuous', 1)

Example 2: Stop Continuous grabbing

   SetProperty('continuous', 0)

Example 3: Reset camera

   SetProperty('Reset', 1)

Example 4: Set Shutter

   SetProperty('Shutter',66)

 

Scorpion Vision Version XII : Build 646 - Date: 20170225
Scorpion Vision Software® is a registered trademark of Tordivel AS.
Copyright © 2000 - 2017 Tordivel AS.