get_image_timeGetImageTimeGetImageTimeget_image_timeget_image_time
Short description
get_image_timeGetImageTimeGetImageTimeget_image_timeget_image_time — Request time at which the image was created.
Signature
get_image_time( image Image, out integer MSecond, out integer Second, out integer Minute, out integer Hour, out integer Day, out integer YDay, out integer Month, out integer Year )void GetImageTime( const HObject& Image, HTuple* MSecond, HTuple* Second, HTuple* Minute, HTuple* Hour, HTuple* Day, HTuple* YDay, HTuple* Month, HTuple* Year )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 )def get_image_time( image: HObject ) -> Tuple[int, int, int, int, int, int, int, int]
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 )
Hlong HImage::GetImageTime( Hlong* Second, Hlong* Minute, Hlong* Hour, Hlong* Day, Hlong* YDay, Hlong* Month, Hlong* Year ) const
int HImage.GetImageTime( out int second, out int minute, out int hour, out int day, out int YDay, out int month, out int year )
Description
The operator get_image_timeGetImageTime 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_paramGetFramegrabberParam.
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
Imageimageimage (input_object) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HImage (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)Hobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Input image.
MSecondMSecondmsecond (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Milliseconds (0..999).
Secondsecondsecond (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Seconds (0..59).
Minuteminuteminute (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Minutes (0..59).
Hourhourhour (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Hours (0..23).
Daydayday (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Day of the month (1..31).
YDayYDayyday (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Day of the year (1..366).
Monthmonthmonth (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Month (1..12).
Yearyearyear (output_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)
Year (xxxx).
Result
The operator get_image_timeGetImageTime 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>).
If necessary an exception is raised.
Combinations with other operators
Combinations
Possible predecessors
read_imageReadImage, grab_imageGrabImage
See also
count_secondsCountSeconds
Module
Foundation