Operator Reference

get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time (Operator)

get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time — Request time at which the image was created.

Signature

get_image_time(Image : : : MSecond, Second, Minute, Hour, Day, YDay, Month, Year)

Herror get_image_time(const Hobject Image, Hlong* MSecond, Hlong* Second, Hlong* Minute, Hlong* Hour, Hlong* Day, Hlong* YDay, Hlong* Month, Hlong* Year)

Herror T_get_image_time(const Hobject Image, Htuple* MSecond, Htuple* Second, Htuple* Minute, Htuple* Hour, Htuple* Day, Htuple* YDay, Htuple* Month, Htuple* Year)

void GetImageTime(const HObject& Image, HTuple* MSecond, HTuple* Second, HTuple* Minute, HTuple* Hour, HTuple* Day, HTuple* YDay, HTuple* Month, HTuple* Year)

Hlong HImage::GetImageTime(Hlong* Second, Hlong* Minute, Hlong* Hour, Hlong* Day, Hlong* YDay, Hlong* Month, Hlong* Year) const

static void HOperatorSet.GetImageTime(HObject image, out HTuple MSecond, out HTuple second, out HTuple minute, out HTuple hour, out HTuple day, out HTuple YDay, out HTuple month, out HTuple year)

int HImage.GetImageTime(out int second, out int minute, out int hour, out int day, out int YDay, out int month, out int year)

def get_image_time(image: HObject) -> Tuple[int, int, int, int, int, int, int, int]

Description

The operator get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time returns the time at which the image was created internally in HALCON. This time doesn't necessarily correlate with the time the image was acquired.

For some image acquisition interfaces, the time of the acquisition can be queried with get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param.

Execution Information

  • Supports objects on compute devices.
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Input image.

MSecondMSecondMSecondMSecondmsecond (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Milliseconds (0..999).

SecondSecondSecondsecondsecond (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Seconds (0..59).

MinuteMinuteMinuteminuteminute (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Minutes (0..59).

HourHourHourhourhour (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Hours (0..23).

DayDayDaydayday (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Day of the month (1..31).

YDayYDayYDayYDayyday (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Day of the year (1..366).

MonthMonthMonthmonthmonth (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Month (1..12).

YearYearYearyearyear (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Year (xxxx).

Result

The operator get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time returns the value 2 ( H_MSG_TRUE) if exactly one image was passed. The behavior in case of empty input (no input images available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageread_image, grab_imagegrab_imageGrabImageGrabImagegrab_image

See also

count_secondscount_secondsCountSecondsCountSecondscount_seconds

Module

Foundation