Time/Timer

All returned values are from a referenced function or cell.

Function Description

GetAllTime(Image)

Returns the time, in milliseconds, for the image to be acquired and the job to execute, or #ERR if the input value is invalid.

Note:
  • This argument must reference cell A0, the cell containing the Image data structure returned by the AcquireImage function. For more information, see AcquireImage.
  • The returned GetAllTime value does not include the sensor filmstrip execution time. For more information, see Sensor Filmstrip: EasyBuilder View.
  • The GetAllTime function and the status bar calculate time differently than the Profile Job dialog. The Profile Job dialog also accounts for the construction of result graphics.For more information, see Profile Job Dialog.
  • If this function is used in a formula, different value is returned depending on the cell location. For example, when GetAllTime(A0) is 80, 1*GetAllTime(A0) should also be 80. However, if 1*GetAllTime(A0) is on the top of the job, it returns almost the same value as GetTime(A0), which does not include other tool's execution time. If 1*GetAllTime(A0) is at the end of the job, it will include all job execution time. To return the correct value, create a separate cell just for GetAllTime(A0), and use a cell reference for it in the formula. For example, if you create a GetAllTime(A0) in cell B2, 1*B2 will return the correct value regardless of the cell location.
  • When the HMI Settings dialog's Maximum View Connections setting is set to 2 or more, the GetAllTime value returned by vision systems using In-Sight firmware 5.x.x will be longer than vision systems using In-Sight firmware 4.x.x. In addition to image acquisition and job execution time, the GetAllTime value returned by vision systems running In-Sight firmware 5.x.x adds multiple view update time to the final value, while on vision systems running In-Sight firmware 4.x.x this value is not included. For more information, see HMI Settings Dialog.

GetElapsedTime(Image)

Returns the time, in milliseconds, between two consecutive image acquisitions or #ERR if the input value is invalid.

Note: This argument must reference cell A0, the cell containing the Image data structure returned by the AcquireImage function. For more information, see AcquireImage.

GetExposureTimestamp(Image)

Returns a Time data structure, which can be used to send the exposure timestamp (a record of when an In-Sight vision system begins its exposure when triggered to acquire an image).

Note:
  • This argument must reference cell A0, the cell containing the Image data structure returned by the AcquireImage function. For more information, see AcquireImage.
  • The timestamp value is accurate to 200 microseconds of the actual exposure time on all supported In-Sight vision systems.

GetSystemTimeOffset(Time)

Returns the extracted system time offset value from a Time data structure.

Note: The system time offset is only valid when PTP is enabled. For more information about setting up and configuring In-Sight vision systems for use with PTP, see Configure Time Synchronization.
GetTime(Cell1, [Cell2, ...])

Returns the time, in milliseconds, for a variable-length list of cells to execute or #ERR if the input value is invalid. If multiple cells are selected, the sum of all execution times is returned.

GetTimeValue(Time)

Converts a Time data structure into a time value. The function is used to write a 64-bit representation of the time, in microseconds, to a PLC via the FormatOutputBuffer function. For more information, see FormatOutputBuffer.

Note: This function is only valid when PTP is enabled. For more information about setting up and configuring In-Sight vision systems for use with PTP, see Configure Time Synchronization.