objc2_vision/generated/
VNDetectTrajectoriesRequest.rs

1//! This file has been automatically generated by `objc2`'s `header-translator`.
2//! DO NOT EDIT
3use core::ffi::*;
4use core::ptr::NonNull;
5use objc2::__framework_prelude::*;
6#[cfg(feature = "objc2-core-media")]
7use objc2_core_media::*;
8use objc2_foundation::*;
9
10use crate::*;
11
12extern_class!(
13    /// A request that detects trajectories of shapes (even small ones) that follow a parabolic path in a sequence of images.
14    ///
15    ///
16    /// This request detects objects moving and (once their path follows the constraint of a parabola), a VNTrajectoryObservation will be returned with the detected points and the equation describing the parabola.
17    ///
18    /// See also [Apple's documentation](https://developer.apple.com/documentation/vision/vndetecttrajectoriesrequest?language=objc)
19    #[unsafe(super(VNStatefulRequest, VNImageBasedRequest, VNRequest, NSObject))]
20    #[derive(Debug, PartialEq, Eq, Hash)]
21    #[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
22    pub struct VNDetectTrajectoriesRequest;
23);
24
25#[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
26unsafe impl NSCopying for VNDetectTrajectoriesRequest {}
27
28#[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
29unsafe impl CopyingHelper for VNDetectTrajectoriesRequest {
30    type Result = Self;
31}
32
33#[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
34unsafe impl NSObjectProtocol for VNDetectTrajectoriesRequest {}
35
36#[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
37impl VNDetectTrajectoriesRequest {
38    extern_methods!(
39        #[cfg(all(feature = "block2", feature = "objc2-core-media"))]
40        #[unsafe(method(initWithFrameAnalysisSpacing:completionHandler:))]
41        #[unsafe(method_family = init)]
42        pub unsafe fn initWithFrameAnalysisSpacing_completionHandler(
43            this: Allocated<Self>,
44            frame_analysis_spacing: CMTime,
45            completion_handler: VNRequestCompletionHandler,
46        ) -> Retained<Self>;
47
48        #[cfg(all(feature = "block2", feature = "objc2-core-media"))]
49        /// Create a new request that will detect the trajectory of a shape in motion.
50        ///
51        ///
52        /// Parameter `frameAnalysisSpacing`: The reciprocal of the maximum rate at which buffers will be processed. The request will not process buffers that fall within the frameAnalysisSpacing after it has performed the analysis. The analysis is not done by wall time but by analysis of the time stamps of the samplebuffers being processed. This property is for instance useful to throttle the processing on slower devices. If this is set to kCMTimeZero then no frames get skipped in the analysis.
53        ///
54        /// Parameter `trajectoryLength`: The number of points required to analyze a parabola that indicates a trajectory. Must be at least 5.
55        ///
56        /// Parameter `completionHandler`: The block to be invoked after the request has completed its processing. The completion handler gets executed on the same dispatch queue as the request being executed.
57        #[unsafe(method(initWithFrameAnalysisSpacing:trajectoryLength:completionHandler:))]
58        #[unsafe(method_family = init)]
59        pub unsafe fn initWithFrameAnalysisSpacing_trajectoryLength_completionHandler(
60            this: Allocated<Self>,
61            frame_analysis_spacing: CMTime,
62            trajectory_length: NSInteger,
63            completion_handler: VNRequestCompletionHandler,
64        ) -> Retained<Self>;
65
66        /// The number of points required to analyze a parabola that indicates a trajectory.
67        #[unsafe(method(trajectoryLength))]
68        #[unsafe(method_family = none)]
69        pub unsafe fn trajectoryLength(&self) -> NSInteger;
70
71        /// Specifies the minimum radius of the bounding circle of the object to be tracked. This can be used to filter out noise and small objects. The default is 0.0, which means no filtering is applied. Changing the property from frame to frame can produce eratic trajectories as objects will either disappear or be added to the tracking base on this filtering. The value is specified in normalized coordinates.
72        #[unsafe(method(objectMinimumNormalizedRadius))]
73        #[unsafe(method_family = none)]
74        pub unsafe fn objectMinimumNormalizedRadius(&self) -> c_float;
75
76        /// Setter for [`objectMinimumNormalizedRadius`][Self::objectMinimumNormalizedRadius].
77        #[unsafe(method(setObjectMinimumNormalizedRadius:))]
78        #[unsafe(method_family = none)]
79        pub unsafe fn setObjectMinimumNormalizedRadius(
80            &self,
81            object_minimum_normalized_radius: c_float,
82        );
83
84        #[deprecated]
85        #[unsafe(method(minimumObjectSize))]
86        #[unsafe(method_family = none)]
87        pub unsafe fn minimumObjectSize(&self) -> c_float;
88
89        /// Setter for [`minimumObjectSize`][Self::minimumObjectSize].
90        #[deprecated]
91        #[unsafe(method(setMinimumObjectSize:))]
92        #[unsafe(method_family = none)]
93        pub unsafe fn setMinimumObjectSize(&self, minimum_object_size: c_float);
94
95        /// Specifies the maximum radius of the bounding circle of the object to be tracked. This can be used to filter out unwanted trajectories from larger objects moving through the scene. The default is 1.0, which means no filtering is applied. Changing the maximum from frame to frame can produce eratic trajectories as objects will either disappear or be added to the tracking base on this filtering. The size is specified in normalized coordinates.
96        #[unsafe(method(objectMaximumNormalizedRadius))]
97        #[unsafe(method_family = none)]
98        pub unsafe fn objectMaximumNormalizedRadius(&self) -> c_float;
99
100        /// Setter for [`objectMaximumNormalizedRadius`][Self::objectMaximumNormalizedRadius].
101        #[unsafe(method(setObjectMaximumNormalizedRadius:))]
102        #[unsafe(method_family = none)]
103        pub unsafe fn setObjectMaximumNormalizedRadius(
104            &self,
105            object_maximum_normalized_radius: c_float,
106        );
107
108        #[deprecated]
109        #[unsafe(method(maximumObjectSize))]
110        #[unsafe(method_family = none)]
111        pub unsafe fn maximumObjectSize(&self) -> c_float;
112
113        /// Setter for [`maximumObjectSize`][Self::maximumObjectSize].
114        #[deprecated]
115        #[unsafe(method(setMaximumObjectSize:))]
116        #[unsafe(method_family = none)]
117        pub unsafe fn setMaximumObjectSize(&self, maximum_object_size: c_float);
118
119        #[cfg(feature = "objc2-core-media")]
120        /// Specifies the desired target frame time for processing trajectory detection. This can be used for real-time processing of frames, which requires execution with a specific amount of time. The target frame time is evaluated from frame-to-frame. If processing takes longer than this target frame time for the currect frame, it will attempt to reduce the amount of time taken by reducing the accuracy (down to a set minimum) for the next frame. If a frame takes less time than this target, then accuracy of the next frame will be increased (up to a set maximum). The default value is kCMTimeIndefinite, meaning accuracy stays at the predefined maximum.
121        #[unsafe(method(targetFrameTime))]
122        #[unsafe(method_family = none)]
123        pub unsafe fn targetFrameTime(&self) -> CMTime;
124
125        #[cfg(feature = "objc2-core-media")]
126        /// Setter for [`targetFrameTime`][Self::targetFrameTime].
127        #[unsafe(method(setTargetFrameTime:))]
128        #[unsafe(method_family = none)]
129        pub unsafe fn setTargetFrameTime(&self, target_frame_time: CMTime);
130
131        #[cfg(feature = "VNObservation")]
132        /// Provides VNTrajectoryObservation results.
133        #[unsafe(method(results))]
134        #[unsafe(method_family = none)]
135        pub unsafe fn results(&self) -> Option<Retained<NSArray<VNTrajectoryObservation>>>;
136    );
137}
138
139/// Methods declared on superclass `VNStatefulRequest`.
140#[cfg(all(feature = "VNRequest", feature = "VNStatefulRequest"))]
141impl VNDetectTrajectoriesRequest {
142    extern_methods!(
143        #[unsafe(method(new))]
144        #[unsafe(method_family = new)]
145        pub unsafe fn new() -> Retained<Self>;
146
147        #[unsafe(method(init))]
148        #[unsafe(method_family = init)]
149        pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>;
150
151        #[cfg(feature = "block2")]
152        #[unsafe(method(initWithCompletionHandler:))]
153        #[unsafe(method_family = init)]
154        pub unsafe fn initWithCompletionHandler(
155            this: Allocated<Self>,
156            completion_handler: VNRequestCompletionHandler,
157        ) -> Retained<Self>;
158    );
159}
160
161/// [Apple's documentation](https://developer.apple.com/documentation/vision/vndetecttrajectoriesrequestrevision1?language=objc)
162pub static VNDetectTrajectoriesRequestRevision1: NSUInteger = 1;
objc2_vision/generated/VNDetectTrajectoriesRequest.rs

objc2_vision/generated/
VNDetectTrajectoriesRequest.rs
