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: Spreadsheet 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 values are returned depending on the cell location. For example, when GetAllTime(A0) is 80, 1*GetAllTime(A0) should also be 80. However, if the cell containing 1*GetAllTime(A0) is at the beginning 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.

GetPostInspectionTime(Image)

Returns the post-inspection time, in milliseconds, for the previous inspection. This function returns #ERR for the first inspection and if the vision system is Offline.

Tip: You can combine the time returned by the GetAllTime(Image) and GetPostInspectionTime(Image) functions to determine the Total execution time, which is the amount of time it takes for a vision system to complete all work for a single acquisition before moving onto the next acquisition. The Total time is the amount of time you can safely set your vision system trigger rate without missing acquisitions. For more information about what contributes to the total execution time and how to reduce it, see Status Bar: Spreadsheet View.

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.