Line Scan

Note:
  • The Line Scan Vision Data Access functions are only supported on the In-Sight 5604 and In-Sight 9902L line scan vision systems.
  • Unless otherwise noted, the following functions must reference an Event to force the update of the Value.

Event

Specifies the event on which to read thespecified Value. This parameter must be a reference to one of the following:

  • TheImage data structurein cell A0, containing the AcquireImagefunction.For more information, see AcquireImage.
  • Acell containing an Event function.For more information, see Event.
  • Acell containing a Button function.For more information, see Button.
  • A cell containing a numeric value (any non-zero numeric Value will force the update).
Function Description
GetImageBufferCount(Image) Returns the number of buffers currently used.
GetImageBufferOverrunCount(Image) Returns the number of acquisitions lost due to lack of image buffers.This count is reset when the visions system goes Online or Offline or after the LineScanStatReset function is executed.
GetLineScanAcqEncoderSteps(Image) Returns the number of steps (or microseconds for a software encoder) currently acquired for any partially acquired image, or if no image is in progress returns zero.This statistic is most useful during hardware encoder setup when the system is moving slowly.
GetLineScanAcqLineCount(Image) Returns the number of lines currently acquired for any partially acquired image; if no image acquisition is in progress, a zero is returned.This statistic is most useful during hardware encoder setup when the system is moving slowly.
GetLineScanAcqStepsPerSec(Image) Returns the average number of steps-per-second over the last image acquisition period.For a software encoder, returns a fixed 1000000.0.
GetLineScanAcqTime(Image) Returns the amount of time spent acquiring the last image, in milliseconds.This time is measured from the trigger signal start to the end of the last line.
GetLineScanAcqTimeoutCount(Image) Returns the number of times the encoder acquisition timeout aborted an image.This count is reset when the sensor goes Online or Offline or after the LineScanStatReset function is executed.
GetLineScanEncoderSteps(Image) Returns the number of steps (or microseconds for a software encoder) since the last Online or Offline or after the LineScanStatReset function is executed.This value resets over after about 4 billion steps.

GetLineScanExposureConflict(Image)

Returns one (1) if there is a conflict between the current Line Period and the current Exposure settings, otherwise returns zero (0).This applies to the software encoder only.For the hardware encoder this will always return zero.If this function returns one (1), line overrun is likely to occur.

GetLineScanFillLines(Image)

Returns the number of black-filled lines (lines which were clipped or lost to line overrun) in the image.

Note: GetLineScanFillLines must reference the AcquireImage function in cell A0.

GetLineScanLineCount(Image)

Returns the number of lines acquired.This count is reset when the vision system goes Online or Offline or after the LineScanStatReset function is executed.

GetLineScanLineOverrunCount(Image)

Returns the number of lines that were missed due to excessive encoder rates.This count is reset when the sensor goes Online or Offline or after the LineScanStatReset function is executed.

LineScanStatReset(Event)

Resets any cumulative line scan statistics.This is automatically executed during an Online or Offline event.