get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time (Operator)
get_image_timeget_image_timeGetImageTimeGetImageTimeget_image_time
— Request time at which the image was created.
Signature
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