Struct VTPixelRotationSession 

pub struct VTPixelRotationSession { /* private fields */ }

Available on crate feature VTPixelRotationSession only.

A reference to a Video Toolbox Pixel Rotation Session.

A pixel rotation session supports the rotating of images from source CVPixelBuffers to destination CVPixelBuffers. The session reference is a reference-counted CF object. To create an image rotation session, call VTPixelRotationSessionCreate; then you can optionally configure the session using VTSessionSetProperty; then to transfer pixels, call VTPixelRotationSessionRotateImage. When you are done with the session, you should call CFRelease to tear it down and release your object reference.

See also Apple’s documentation

Implementations

impl VTPixelRotationSession

pub unsafe fn create( allocator: Option<&CFAllocator>, pixel_rotation_session_out: NonNull<*mut VTPixelRotationSession>, ) -> i32

Creates a session for rotating images between CVPixelBuffers.

Parameter allocator: An allocator for the session. Pass NULL to use the default allocator.

Parameter pixelRotationSessionOut: Points to a variable to receive the new pixel rotation session.

Safety

pixel_rotation_session_out must be a valid pointer.

pub unsafe fn invalidate(&self)

Tears down a pixel rotation session.

When you are done with an image rotation session you created, call VTPixelRotationSessionInvalidate to tear it down and then CFRelease to release your object reference. When an pixel rotation session’s retain count reaches zero, it is automatically invalidated, but since sessions may be retained by multiple parties, it can be hard to predict when this will happen. Calling VTPixelRotationSessionInvalidate ensures a deterministic, orderly teardown.

impl VTPixelRotationSession

pub unsafe fn rotate_image( &self, source_buffer: &CVPixelBuffer, destination_buffer: &CVPixelBuffer, ) -> i32

Available on crate feature objc2-core-video only.

Rotates a pixel buffer.

Rotates sourceBuffer and places the output in destinationBuffer. For 90 and 270 degree rotations, the width and height of destinationBuffer must be the inverse of sourceBuffer. For 180 degree rotations, the width and height of destinationBuffer and sourceBuffer must match. By default, all existing attachments on destinationBuffer are removed and new attachments are set describing the transferred image. Unrecognised attachments on sourceBuffer will be propagated to destinationBuffer. Some properties may modify this behaviour; see VTPixelRotationProperties.h for more details.

Parameter session: The pixel rotation session.

Parameter sourceBuffer: The source buffer.

Parameter destinationBuffer: The destination buffer.

Returns: If the transfer was successful, noErr; otherwise an error code, such as kVTPixelRotationNotSupportedErr.

Methods from Deref<Target = CFType>

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: ConcreteType,

Available on crate feature VTSession only.

Attempt to downcast the type to that of type T.

This is the reference-variant. Use CFRetained::downcast if you want to convert a retained type. See also ConcreteType for more details on which types support being converted to.

pub fn retain_count(&self) -> usize

Available on crate feature VTSession only.

Get the reference count of the object.

This function may be useful for debugging. You normally do not use this function otherwise.

Beware that some things (like CFNumbers, small CFStrings etc.) may not have a normal retain count for optimization purposes, and can return usize::MAX in that case.

Trait Implementations

impl AsRef<AnyObject> for VTPixelRotationSession

fn as_ref(&self) -> &AnyObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<CFType> for VTPixelRotationSession

fn as_ref(&self) -> &CFType

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<VTPixelRotationSession> for VTPixelRotationSession

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<AnyObject> for VTPixelRotationSession

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<CFType> for VTPixelRotationSession

fn borrow(&self) -> &CFType

Immutably borrows from an owned value.

impl ConcreteType for VTPixelRotationSession

fn type_id() -> CFTypeID

Returns the CFTypeID for pixel rotation sessions.

impl Debug for VTPixelRotationSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for VTPixelRotationSession

type Target = CFType

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Hash for VTPixelRotationSession

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for VTPixelRotationSession

fn retain(&self) -> Retained<Self>

where Self: Sized,

Increment the reference count of the receiver.

impl PartialEq for VTPixelRotationSession

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RefEncode for VTPixelRotationSession

const ENCODING_REF: Encoding

The Objective-C type-encoding for a reference of this type.

impl Type for VTPixelRotationSession

fn retain(&self) -> CFRetained<Self>

where Self: Sized,

Increment the reference count of the receiver.

fn as_concrete_TypeRef(&self) -> &Self

👎Deprecated: this is redundant

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_get_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::retain

Helper for easier transition from the core-foundation crate.

fn as_CFTypeRef(&self) -> &CFType

where Self: AsRef<CFType>,

👎Deprecated: this is redundant (CF types deref to CFType)

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_create_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::from_raw

Helper for easier transition from the core-foundation crate.

impl Eq for VTPixelRotationSession