Struct NSEPSImageRep

Source
#[repr(C)]
pub struct NSEPSImageRep { /* private fields */ }
๐Ÿ‘ŽDeprecated: NSEPSImageRep instances cannot be created on macOS 14.0 and later
Available on crate features NSEPSImageRep and NSImageRep only.
Expand description

An object that can render an image from encapsulated PostScript (EPS) code.

See also Appleโ€™s documentation

Implementationsยง

Sourceยง

impl NSEPSImageRep

Source

pub unsafe fn imageRepWithData(eps_data: &NSData) -> Option<Retained<Self>>

Creates and returns a representation of an image initialized with the specified EPS data. Convenience of -initWithData:.

  • Note: This method always returns nil on macOS 14.0 and later.
Source

pub unsafe fn initWithData( this: Allocated<Self>, eps_data: &NSData, ) -> Option<Retained<Self>>

Returns a representation of an image initialized with the specified EPS data.

  • Note: This method always returns nil on macOS 14.0 and later.
Source

pub unsafe fn boundingBox(&self) -> NSRect

The rectangle that bounds the image representation.

Source

pub unsafe fn EPSRepresentation(&self) -> Retained<NSData>

The EPS representation of the image representation.

Source

pub unsafe fn prepareGState(&self)

๐Ÿ‘ŽDeprecated

The -[NSEPSImageRep draw] method sends this message to itself just before rendering the EPS code. The default implementation of this method does nothing. It can be overridden in a subclass to prepare the graphics state as needed.

Sourceยง

impl NSEPSImageRep

Methods declared on superclass NSImageRep.

Source

pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>

Source

pub unsafe fn initWithCoder( this: Allocated<Self>, coder: &NSCoder, ) -> Option<Retained<Self>>

Sourceยง

impl NSEPSImageRep

Methods declared on superclass NSObject.

Source

pub unsafe fn new() -> Retained<Self>

Methods from Deref<Target = NSImageRep>ยง

Source

pub unsafe fn draw(&self) -> bool

Source

pub unsafe fn drawAtPoint(&self, point: NSPoint) -> bool

Source

pub unsafe fn drawInRect(&self, rect: NSRect) -> bool

Source

pub unsafe fn drawInRect_fromRect_operation_fraction_respectFlipped_hints( &self, dst_space_portion_rect: NSRect, src_space_portion_rect: NSRect, op: NSCompositingOperation, requested_alpha: CGFloat, respect_context_is_flipped: bool, hints: Option<&NSDictionary<NSImageHintKey, AnyObject>>, ) -> bool

Available on crate features NSGraphics and objc2-core-foundation only.
Source

pub unsafe fn size(&self) -> NSSize

Source

pub unsafe fn setSize(&self, size: NSSize)

Setter for size.

Source

pub unsafe fn hasAlpha(&self) -> bool

Source

pub unsafe fn setAlpha(&self, alpha: bool)

Setter for hasAlpha.

Source

pub unsafe fn isOpaque(&self) -> bool

Source

pub unsafe fn setOpaque(&self, opaque: bool)

Setter for isOpaque.

Source

pub unsafe fn colorSpaceName(&self) -> Retained<NSColorSpaceName>

Available on crate feature NSGraphics only.
Source

pub unsafe fn setColorSpaceName(&self, color_space_name: &NSColorSpaceName)

Available on crate feature NSGraphics only.

Setter for colorSpaceName.

Source

pub unsafe fn bitsPerSample(&self) -> NSInteger

Source

pub unsafe fn setBitsPerSample(&self, bits_per_sample: NSInteger)

Setter for bitsPerSample.

Source

pub unsafe fn pixelsWide(&self) -> NSInteger

Source

pub unsafe fn setPixelsWide(&self, pixels_wide: NSInteger)

Setter for pixelsWide.

Source

pub unsafe fn pixelsHigh(&self) -> NSInteger

Source

pub unsafe fn setPixelsHigh(&self, pixels_high: NSInteger)

Setter for pixelsHigh.

Source

pub unsafe fn layoutDirection(&self) -> NSImageLayoutDirection

Source

pub unsafe fn setLayoutDirection( &self, layout_direction: NSImageLayoutDirection, )

Setter for layoutDirection.

Source

pub unsafe fn CGImageForProposedRect_context_hints( &self, proposed_dest_rect: *mut NSRect, context: Option<&NSGraphicsContext>, hints: Option<&NSDictionary<NSImageHintKey, AnyObject>>, ) -> Option<Retained<CGImage>>

Available on crate feature NSGraphicsContext and crate feature objc2-core-graphics and Apple only.

Methods from Deref<Target = NSObject>ยง

Source

pub fn doesNotRecognizeSelector(&self, sel: Sel) -> !

Handle messages the object doesnโ€™t recognize.

See Appleโ€™s documentation for details.

Methods from Deref<Target = AnyObject>ยง

Source

pub fn class(&self) -> &'static AnyClass

Available on crate feature NSAccessibilityConstants only.

Dynamically find the class of this object.

ยงPanics

May panic if the object is invalid (which may be the case for objects returned from unavailable init/new methods).

ยงExample

Check that an instance of NSObject has the precise class NSObject.

use objc2::ClassType;
use objc2::runtime::NSObject;

let obj = NSObject::new();
assert_eq!(obj.class(), NSObject::class());
Source

pub unsafe fn get_ivar<T>(&self, name: &str) -> &T
where T: Encode,

๐Ÿ‘ŽDeprecated: this is difficult to use correctly, use Ivar::load instead.
Available on crate feature NSAccessibilityConstants only.

Use Ivar::load instead.

ยงSafety

The object must have an instance variable with the given name, and it must be of type T.

See Ivar::load_ptr for details surrounding this.

Source

pub fn downcast_ref<T>(&self) -> Option<&T>
where T: DowncastTarget,

Available on crate feature NSAccessibilityConstants only.

Attempt to downcast the object to a class of type T.

This is the reference-variant. Use Retained::downcast if you want to convert a retained object to another type.

ยงMutable classes

Some classes have immutable and mutable variants, such as NSString and NSMutableString.

When some Objective-C API signature says it gives you an immutable class, it generally expects you to not mutate that, even though it may technically be mutable โ€œunder the hoodโ€.

So using this method to convert a NSString to a NSMutableString, while not unsound, is generally frowned upon unless you created the string yourself, or the API explicitly documents the string to be mutable.

See Appleโ€™s documentation on mutability and on isKindOfClass: for more details.

ยงGeneric classes

Objective-C generics are called โ€œlightweight genericsโ€, and thatโ€™s because they arenโ€™t exposed in the runtime. This makes it impossible to safely downcast to generic collections, so this is disallowed by this method.

You can, however, safely downcast to generic collections where all the type-parameters are AnyObject.

ยงPanics

This works internally by calling isKindOfClass:. That means that the object must have the instance method of that name, and an exception will be thrown (if CoreFoundation is linked) or the process will abort if that is not the case. In the vast majority of cases, you donโ€™t need to worry about this, since both root objects NSObject and NSProxy implement this method.

ยงExamples

Cast an NSString back and forth from NSObject.

use objc2::rc::Retained;
use objc2_foundation::{NSObject, NSString};

let obj: Retained<NSObject> = NSString::new().into_super();
let string = obj.downcast_ref::<NSString>().unwrap();
// Or with `downcast`, if we do not need the object afterwards
let string = obj.downcast::<NSString>().unwrap();

Try (and fail) to cast an NSObject to an NSString.

use objc2_foundation::{NSObject, NSString};

let obj = NSObject::new();
assert!(obj.downcast_ref::<NSString>().is_none());

Try to cast to an array of strings.

โ“˜
use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);
// This is invalid and doesn't type check.
let arr = arr.downcast_ref::<NSArray<NSString>>();

This fails to compile, since it would require enumerating over the array to ensure that each element is of the desired type, which is a performance pitfall.

Downcast when processing each element instead.

use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);

for elem in arr {
    if let Some(data) = elem.downcast_ref::<NSString>() {
        // handle `data`
    }
}

Trait Implementationsยง

Sourceยง

impl AsRef<AnyObject> for NSEPSImageRep

Sourceยง

fn as_ref(&self) -> &AnyObject

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

impl AsRef<NSEPSImageRep> for NSEPSImageRep

Sourceยง

fn as_ref(&self) -> &Self

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

impl AsRef<NSImageRep> for NSEPSImageRep

Sourceยง

fn as_ref(&self) -> &NSImageRep

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

impl AsRef<NSObject> for NSEPSImageRep

Sourceยง

fn as_ref(&self) -> &NSObject

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

impl Borrow<AnyObject> for NSEPSImageRep

Sourceยง

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value. Read more
Sourceยง

impl Borrow<NSImageRep> for NSEPSImageRep

Sourceยง

fn borrow(&self) -> &NSImageRep

Immutably borrows from an owned value. Read more
Sourceยง

impl Borrow<NSObject> for NSEPSImageRep

Sourceยง

fn borrow(&self) -> &NSObject

Immutably borrows from an owned value. Read more
Sourceยง

impl ClassType for NSEPSImageRep

Sourceยง

const NAME: &'static str = "NSEPSImageRep"

The name of the Objective-C class that this type represents. Read more
Sourceยง

type Super = NSImageRep

The superclass of this class. Read more
Sourceยง

type ThreadKind = <<NSEPSImageRep as ClassType>::Super as ClassType>::ThreadKind

Whether the type can be used from any thread, or from only the main thread. Read more
Sourceยง

fn class() -> &'static AnyClass

Get a reference to the Objective-C class that this type represents. Read more
Sourceยง

fn as_super(&self) -> &Self::Super

Get an immutable reference to the superclass.
Sourceยง

impl CopyingHelper for NSEPSImageRep

Sourceยง

type Result = NSEPSImageRep

The immutable counterpart of the type, or Self if the type has no immutable counterpart. Read more
Sourceยง

impl Debug for NSEPSImageRep

Sourceยง

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

Formats the value using the given formatter. Read more
Sourceยง

impl Deref for NSEPSImageRep

Sourceยง

type Target = NSImageRep

The resulting type after dereferencing.
Sourceยง

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

Dereferences the value.
Sourceยง

impl Hash for NSEPSImageRep

Sourceยง

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

Feeds this value into the given Hasher. Read more
1.3.0 ยท Sourceยง

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

Feeds a slice of this type into the given Hasher. Read more
Sourceยง

impl Message for NSEPSImageRep

Sourceยง

fn retain(&self) -> Retained<Self>
where Self: Sized,

Increment the reference count of the receiver. Read more
Sourceยง

impl NSCoding for NSEPSImageRep

Sourceยง

unsafe fn encodeWithCoder(&self, coder: &NSCoder)
where Self: Sized + Message,

Sourceยง

unsafe fn initWithCoder( this: Allocated<Self>, coder: &NSCoder, ) -> Option<Retained<Self>>
where Self: Sized + Message,

Sourceยง

impl NSCopying for NSEPSImageRep

Sourceยง

fn copy(&self) -> Retained<Self::Result>
where Self: Sized + Message + CopyingHelper,

Returns a new instance thatโ€™s a copy of the receiver. Read more
Sourceยง

unsafe fn copyWithZone(&self, zone: *mut NSZone) -> Retained<Self::Result>
where Self: Sized + Message + CopyingHelper,

Returns a new instance thatโ€™s a copy of the receiver. Read more
Sourceยง

impl NSObjectProtocol for NSEPSImageRep

Sourceยง

fn isEqual(&self, other: Option<&AnyObject>) -> bool
where Self: Sized + Message,

Check whether the object is equal to an arbitrary other object. Read more
Sourceยง

fn hash(&self) -> usize
where Self: Sized + Message,

An integer that can be used as a table address in a hash table structure. Read more
Sourceยง

fn isKindOfClass(&self, cls: &AnyClass) -> bool
where Self: Sized + Message,

Check if the object is an instance of the class, or one of its subclasses. Read more
Sourceยง

fn is_kind_of<T>(&self) -> bool
where T: ClassType, Self: Sized + Message,

๐Ÿ‘ŽDeprecated: use isKindOfClass directly, or cast your objects with AnyObject::downcast_ref
Check if the object is an instance of the class type, or one of its subclasses. Read more
Sourceยง

fn isMemberOfClass(&self, cls: &AnyClass) -> bool
where Self: Sized + Message,

Check if the object is an instance of a specific class, without checking subclasses. Read more
Sourceยง

fn respondsToSelector(&self, aSelector: Sel) -> bool
where Self: Sized + Message,

Check whether the object implements or inherits a method with the given selector. Read more
Sourceยง

fn conformsToProtocol(&self, aProtocol: &AnyProtocol) -> bool
where Self: Sized + Message,

Check whether the object conforms to a given protocol. Read more
Sourceยง

fn description(&self) -> Retained<NSObject>
where Self: Sized + Message,

A textual representation of the object. Read more
Sourceยง

fn debugDescription(&self) -> Retained<NSObject>
where Self: Sized + Message,

A textual representation of the object to use when debugging. Read more
Sourceยง

fn isProxy(&self) -> bool
where Self: Sized + Message,

Check whether the receiver is a subclass of the NSProxy root class instead of the usual NSObject. Read more
Sourceยง

fn retainCount(&self) -> usize
where Self: Sized + Message,

The reference count of the object. Read more
Sourceยง

impl PartialEq for NSEPSImageRep

Sourceยง

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 ยท Sourceยง

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

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

impl RefEncode for NSEPSImageRep

Sourceยง

const ENCODING_REF: Encoding = <NSImageRep as ::objc2::RefEncode>::ENCODING_REF

The Objective-C type-encoding for a reference of this type. Read more
Sourceยง

impl DowncastTarget for NSEPSImageRep

Sourceยง

impl Eq for NSEPSImageRep

Auto Trait Implementationsยง

Blanket Implementationsยง

Sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

Sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Sourceยง

impl<'a, T> AnyThread for T
where T: ClassType<ThreadKind = dyn AnyThread + 'a> + ?Sized,

Sourceยง

fn alloc() -> Allocated<Self>
where Self: Sized + ClassType,

Allocate a new instance of the class. Read more
Sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

Sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

Sourceยง

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Sourceยง

impl<T> From<T> for T

Sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

Sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

Sourceยง

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Sourceยง

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Sourceยง

type Target = T

๐Ÿ”ฌThis is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Sourceยง

type Error = Infallible

The type returned in the event of a conversion error.
Sourceยง

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Sourceยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Sourceยง

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Sourceยง

impl<T> AutoreleaseSafe for T
where T: ?Sized,