Struct cairo::Surface

pub struct Surface(_, _);

Methods

impl Surface

pub unsafe fn from_raw_none(ptr: *mut cairo_surface_t) -> Surface

pub unsafe fn from_raw_borrow(ptr: *mut cairo_surface_t) -> Surface

pub unsafe fn from_raw_full(
    ptr: *mut cairo_surface_t
) -> Result<Surface, Status>

pub fn to_raw_none(&self) -> *mut cairo_surface_t

pub fn create_similar(
    &self,
    content: Content,
    width: i32,
    height: i32
) -> Result<Surface, Status>

pub fn get_mime_data(&self, mime_type: &str) -> Option<Vec<u8>>

pub unsafe fn get_mime_data_raw(&self, mime_type: &str) -> Option<&[u8]>

pub fn set_mime_data<T: AsRef<[u8]> + 'static>(
    &self,
    mime_type: &str,
    slice: T
) -> Result<(), Status>

pub fn supports_mime_type(&self, mime_type: &str) -> bool

pub fn set_device_offset(&self, x_offset: f64, y_offset: f64)

pub fn get_device_offset(&self) -> (f64, f64)

pub fn set_device_scale(&self, x_scale: f64, y_scale: f64)

pub fn get_device_scale(&self) -> (f64, f64)

pub fn set_fallback_resolution(
    &self,
    x_pixels_per_inch: f64,
    y_pixels_per_inch: f64
)

pub fn get_fallback_resolution(&self) -> (f64, f64)

pub fn create_similar_image(
    &self,
    format: Format,
    width: i32,
    height: i32
) -> Result<Surface, Status>

pub fn map_to_image(
    &self,
    extents: Option<RectangleInt>
) -> Result<MappedImageSurface, Status>

pub fn set_user_data<T: 'static>(
    &self,
    key: &'static UserDataKey<T>,
    value: Rc<T>
)

Attach user data to self for the given key.

pub fn get_user_data<T: 'static>(
    &self,
    key: &'static UserDataKey<T>
) -> Option<Rc<T>>

Return the user data previously attached to self with the given key, if any.

pub fn get_user_data_ptr<T: 'static>(
    &self,
    key: &'static UserDataKey<T>
) -> Option<NonNull<T>>

Return the user data previously attached to self with the given key, if any, without incrementing the reference count.

The pointer is valid when it is returned from this method, until the cairo object that self represents is destroyed or remove_user_data or set_user_data is called with the same key.

pub fn remove_user_data<T: 'static>(&self, key: &'static UserDataKey<T>)

Unattach from self the user data associated with key, if any. If there is no other Rc strong reference, the data is destroyed.

impl Surface

pub fn flush(&self)

pub fn finish(&self)

pub fn get_type(&self) -> SurfaceType

pub fn status(&self) -> Status

impl Surface

pub fn finish_output_stream(&self) -> Result<Box<dyn Any>, StreamWithError>

Finish the surface, then remove and return the output stream if any.

This calls Surface::finish, to make sure pending writes are done.

This is relevant for surfaces created for example with [PdfSurface::for_stream].

Use Box::downcast to recover the concrete stream type.

Panics

This method panics if:

• This method was already called for this surface, or
• This surface was not created with an output stream in the first place, or
• A previous write to this surface panicked, or
• A previous write happened while another write was ongoing, or
• A write is ongoing now.

The latter two cases can only occur with a pathological output stream type that accesses the same surface again from Write::write_all.

Trait Implementations

impl Clone for Surface

fn clone(&self) -> Surface

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Surface

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

Formats the value using the given formatter.

impl Display for Surface

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

Formats the value using the given formatter.

impl Drop for Surface

fn drop(&mut self)

Executes the destructor for this type.

impl FromGlibPtrBorrow<*mut cairo_surface_t> for Surface

unsafe fn from_glib_borrow(ptr: *mut cairo_surface_t) -> Surface

impl FromGlibPtrFull<*mut cairo_surface_t> for Surface

unsafe fn from_glib_full(ptr: *mut cairo_surface_t) -> Surface

impl FromGlibPtrNone<*mut cairo_surface_t> for Surface

unsafe fn from_glib_none(ptr: *mut cairo_surface_t) -> Surface

impl<'a> FromValueOptional<'a> for Surface

unsafe fn from_value_optional(v: &'a Value) -> Option<Self>

impl SetValue for Surface

unsafe fn set_value(v: &mut Value, s: &Self)

impl SetValueOptional for Surface

unsafe fn set_value_optional(v: &mut Value, s: Option<&Self>)

impl StaticType for Surface

fn static_type() -> Type

Returns the type identifier of Self.

impl<'a> ToGlibPtr<'a, *mut cairo_surface_t> for Surface

type Storage = &'a Surface

fn to_glib_none(&'a self) -> Stash<'a, *mut cairo_surface_t, Self>

Transfer: none.

fn to_glib_full(&self) -> *mut cairo_surface_t

Transfer: full.

fn to_glib_container(&'a self) -> Stash<'a, P, Self>

Transfer: container.

impl TryFrom<Surface> for ImageSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<ImageSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for RecordingSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<RecordingSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for XCBSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<XCBSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for PdfSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<PdfSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for PsSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<PsSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for SvgSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<SvgSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for QuartzSurface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<QuartzSurface, Surface>

Performs the conversion.

impl TryFrom<Surface> for Win32Surface

type Error = Surface

The type returned in the event of a conversion error.

fn try_from(surface: Surface) -> Result<Win32Surface, Surface>

Performs the conversion.