use crate::font::{
FontExtents, FontFace, FontOptions, Glyph, ScaledFont, TextCluster, TextExtents,
};
use crate::matrices::Matrix;
use crate::paths::Path;
use crate::Rectangle;
use crate::{
Antialias, Content, FillRule, FontSlant, FontWeight, LineCap, LineJoin, Operator,
TextClusterFlags,
};
#[cfg(feature = "use_glib")]
use glib::translate::*;
use std::ffi::CString;
use std::fmt;
use std::mem::MaybeUninit;
use std::ops;
use std::ptr;
use std::slice;
use crate::error::Error;
use crate::ffi::{cairo_rectangle_list_t, cairo_t};
use crate::patterns::Pattern;
use crate::surface::Surface;
use crate::utils::status_to_result;
pub struct RectangleList {
ptr: *mut cairo_rectangle_list_t,
}
impl ops::Deref for RectangleList {
type Target = [Rectangle];
fn deref(&self) -> &[Rectangle] {
unsafe {
let ptr = (*self.ptr).rectangles as *mut Rectangle;
let len = (*self.ptr).num_rectangles;
if ptr.is_null() || len == 0 {
&[]
} else {
slice::from_raw_parts(ptr, len as usize)
}
}
}
}
impl Drop for RectangleList {
fn drop(&mut self) {
unsafe {
ffi::cairo_rectangle_list_destroy(self.ptr);
}
}
}
impl fmt::Debug for RectangleList {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
use std::ops::Deref;
f.debug_tuple("RectangleList").field(&self.deref()).finish()
}
}
impl fmt::Display for RectangleList {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
write!(f, "RectangleList")
}
}
#[derive(Debug)]
#[repr(transparent)]
pub struct Context(ptr::NonNull<cairo_t>);
#[cfg(feature = "use_glib")]
impl<'a> ToGlibPtr<'a, *mut ffi::cairo_t> for &'a Context {
type Storage = &'a Context;
#[inline]
fn to_glib_none(&self) -> Stash<'a, *mut ffi::cairo_t, &'a Context> {
Stash(self.0.as_ptr(), *self)
}
#[inline]
fn to_glib_full(&self) -> *mut ffi::cairo_t {
unsafe { ffi::cairo_reference(self.0.as_ptr()) }
}
}
#[cfg(feature = "use_glib")]
impl FromGlibPtrNone<*mut ffi::cairo_t> for Context {
#[inline]
unsafe fn from_glib_none(ptr: *mut ffi::cairo_t) -> Context {
Self::from_raw_none(ptr)
}
}
#[cfg(feature = "use_glib")]
impl FromGlibPtrBorrow<*mut ffi::cairo_t> for Context {
#[inline]
unsafe fn from_glib_borrow(ptr: *mut ffi::cairo_t) -> crate::Borrowed<Context> {
Self::from_raw_borrow(ptr)
}
}
#[cfg(feature = "use_glib")]
impl FromGlibPtrFull<*mut ffi::cairo_t> for Context {
#[inline]
unsafe fn from_glib_full(ptr: *mut ffi::cairo_t) -> Context {
Self::from_raw_full(ptr)
}
}
#[cfg(feature = "use_glib")]
gvalue_impl!(
Context,
cairo_t,
ffi::gobject::cairo_gobject_context_get_type
);
impl Clone for Context {
fn clone(&self) -> Context {
unsafe { Self::from_raw_none(self.to_raw_none()) }
}
}
impl Drop for Context {
fn drop(&mut self) {
unsafe {
ffi::cairo_destroy(self.0.as_ptr());
}
}
}
impl Context {
#[inline]
pub unsafe fn from_raw_none(ptr: *mut ffi::cairo_t) -> Context {
assert!(!ptr.is_null());
ffi::cairo_reference(ptr);
Context(ptr::NonNull::new_unchecked(ptr))
}
#[inline]
pub unsafe fn from_raw_borrow(ptr: *mut ffi::cairo_t) -> crate::Borrowed<Context> {
assert!(!ptr.is_null());
crate::Borrowed::new(Context(ptr::NonNull::new_unchecked(ptr)))
}
#[inline]
pub unsafe fn from_raw_full(ptr: *mut ffi::cairo_t) -> Context {
assert!(!ptr.is_null());
Context(ptr::NonNull::new_unchecked(ptr))
}
pub fn to_raw_none(&self) -> *mut ffi::cairo_t {
self.0.as_ptr()
}
#[doc(alias = "cairo_status")]
pub fn status(&self) -> Result<(), Error> {
let status = unsafe { ffi::cairo_status(self.0.as_ptr()) };
status_to_result(status)
}
pub fn new(target: impl AsRef<Surface>) -> Result<Context, Error> {
let ctx = unsafe { Self::from_raw_full(ffi::cairo_create(target.as_ref().to_raw_none())) };
ctx.status().map(|_| ctx)
}
#[doc(alias = "cairo_save")]
pub fn save(&self) -> Result<(), Error> {
unsafe { ffi::cairo_save(self.0.as_ptr()) }
self.status()
}
#[doc(alias = "cairo_restore")]
pub fn restore(&self) -> Result<(), Error> {
unsafe { ffi::cairo_restore(self.0.as_ptr()) }
self.status()
}
#[doc(alias = "get_target")]
#[doc(alias = "cairo_get_target")]
pub fn target(&self) -> Surface {
unsafe { Surface::from_raw_none(ffi::cairo_get_target(self.0.as_ptr())) }
}
#[doc(alias = "cairo_push_group")]
pub fn push_group(&self) {
unsafe { ffi::cairo_push_group(self.0.as_ptr()) }
}
#[doc(alias = "cairo_push_group_with_content")]
pub fn push_group_with_content(&self, content: Content) {
unsafe { ffi::cairo_push_group_with_content(self.0.as_ptr(), content.into()) }
}
#[doc(alias = "cairo_pop_group")]
pub fn pop_group(&self) -> Result<Pattern, Error> {
let pattern = unsafe { Pattern::from_raw_full(ffi::cairo_pop_group(self.0.as_ptr())) };
self.status().map(|_| pattern)
}
#[doc(alias = "cairo_pop_group_to_source")]
pub fn pop_group_to_source(&self) -> Result<(), Error> {
unsafe { ffi::cairo_pop_group_to_source(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "get_group_target")]
#[doc(alias = "cairo_get_group_target")]
pub fn group_target(&self) -> Surface {
unsafe { Surface::from_raw_none(ffi::cairo_get_group_target(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_source_rgb")]
pub fn set_source_rgb(&self, red: f64, green: f64, blue: f64) {
unsafe { ffi::cairo_set_source_rgb(self.0.as_ptr(), red, green, blue) }
}
#[doc(alias = "cairo_set_source_rgba")]
pub fn set_source_rgba(&self, red: f64, green: f64, blue: f64, alpha: f64) {
unsafe { ffi::cairo_set_source_rgba(self.0.as_ptr(), red, green, blue, alpha) }
}
#[doc(alias = "cairo_set_source")]
pub fn set_source(&self, source: impl AsRef<Pattern>) -> Result<(), Error> {
let source = source.as_ref();
source.status()?;
unsafe {
ffi::cairo_set_source(self.0.as_ptr(), source.to_raw_none());
}
self.status()
}
#[doc(alias = "get_source")]
#[doc(alias = "cairo_get_source")]
pub fn source(&self) -> Pattern {
unsafe { Pattern::from_raw_none(ffi::cairo_get_source(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_source_surface")]
pub fn set_source_surface(
&self,
surface: impl AsRef<Surface>,
x: f64,
y: f64,
) -> Result<(), Error> {
let surface = surface.as_ref();
surface.status()?;
unsafe {
ffi::cairo_set_source_surface(self.0.as_ptr(), surface.to_raw_none(), x, y);
}
self.status()
}
#[doc(alias = "cairo_set_antialias")]
pub fn set_antialias(&self, antialias: Antialias) {
unsafe { ffi::cairo_set_antialias(self.0.as_ptr(), antialias.into()) }
}
#[doc(alias = "get_antialias")]
#[doc(alias = "cairo_get_antialias")]
pub fn antialias(&self) -> Antialias {
unsafe { Antialias::from(ffi::cairo_get_antialias(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_dash")]
pub fn set_dash(&self, dashes: &[f64], offset: f64) {
unsafe {
ffi::cairo_set_dash(
self.0.as_ptr(),
dashes.as_ptr(),
dashes.len() as i32,
offset,
)
}
}
#[doc(alias = "get_dash_count")]
#[doc(alias = "cairo_get_dash_count")]
pub fn dash_count(&self) -> i32 {
unsafe { ffi::cairo_get_dash_count(self.0.as_ptr()) }
}
#[doc(alias = "get_dash")]
#[doc(alias = "cairo_get_dash")]
pub fn dash(&self) -> (Vec<f64>, f64) {
let dash_count = self.dash_count() as usize;
let mut dashes: Vec<f64> = Vec::with_capacity(dash_count);
let mut offset: f64 = 0.0;
unsafe {
ffi::cairo_get_dash(self.0.as_ptr(), dashes.as_mut_ptr(), &mut offset);
dashes.set_len(dash_count);
(dashes, offset)
}
}
#[doc(alias = "get_dash_dashes")]
pub fn dash_dashes(&self) -> Vec<f64> {
let (dashes, _) = self.dash();
dashes
}
#[doc(alias = "get_dash_offset")]
pub fn dash_offset(&self) -> f64 {
let (_, offset) = self.dash();
offset
}
#[doc(alias = "cairo_set_fill_rule")]
pub fn set_fill_rule(&self, fill_rule: FillRule) {
unsafe {
ffi::cairo_set_fill_rule(self.0.as_ptr(), fill_rule.into());
}
}
#[doc(alias = "get_fill_rule")]
#[doc(alias = "cairo_get_fill_rule")]
pub fn fill_rule(&self) -> FillRule {
unsafe { FillRule::from(ffi::cairo_get_fill_rule(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_line_cap")]
pub fn set_line_cap(&self, arg: LineCap) {
unsafe { ffi::cairo_set_line_cap(self.0.as_ptr(), arg.into()) }
}
#[doc(alias = "get_line_cap")]
#[doc(alias = "cairo_get_line_cap")]
pub fn line_cap(&self) -> LineCap {
unsafe { LineCap::from(ffi::cairo_get_line_cap(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_line_join")]
pub fn set_line_join(&self, arg: LineJoin) {
unsafe { ffi::cairo_set_line_join(self.0.as_ptr(), arg.into()) }
}
#[doc(alias = "get_line_join")]
#[doc(alias = "cairo_get_line_join")]
pub fn line_join(&self) -> LineJoin {
unsafe { LineJoin::from(ffi::cairo_get_line_join(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_line_width")]
pub fn set_line_width(&self, arg: f64) {
unsafe { ffi::cairo_set_line_width(self.0.as_ptr(), arg) }
}
#[doc(alias = "get_line_width")]
#[doc(alias = "cairo_get_line_width")]
pub fn line_width(&self) -> f64 {
unsafe { ffi::cairo_get_line_width(self.0.as_ptr()) }
}
#[cfg(any(feature = "v1_18", feature = "dox"))]
#[doc(alias = "cairo_set_hairline")]
pub fn set_hairline(&self, set_hairline: bool) {
unsafe { ffi::cairo_set_hairline(self.0.as_ptr(), set_hairline.into()) }
}
#[cfg(any(feature = "v1_18", feature = "dox"))]
#[doc(alias = "get_hairline")]
#[doc(alias = "cairo_get_hairline")]
pub fn hairline(&self) -> bool {
unsafe { ffi::cairo_get_hairline(self.0.as_ptr()) }.as_bool()
}
#[doc(alias = "cairo_set_miter_limit")]
pub fn set_miter_limit(&self, arg: f64) {
unsafe { ffi::cairo_set_miter_limit(self.0.as_ptr(), arg) }
}
#[doc(alias = "get_miter_limit")]
#[doc(alias = "cairo_get_miter_limit")]
pub fn miter_limit(&self) -> f64 {
unsafe { ffi::cairo_get_miter_limit(self.0.as_ptr()) }
}
#[doc(alias = "cairo_set_operator")]
pub fn set_operator(&self, op: Operator) {
unsafe {
ffi::cairo_set_operator(self.0.as_ptr(), op.into());
}
}
#[doc(alias = "get_operator")]
#[doc(alias = "cairo_get_operator")]
pub fn operator(&self) -> Operator {
unsafe { Operator::from(ffi::cairo_get_operator(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_tolerance")]
pub fn set_tolerance(&self, arg: f64) {
unsafe { ffi::cairo_set_tolerance(self.0.as_ptr(), arg) }
}
#[doc(alias = "get_tolerance")]
#[doc(alias = "cairo_get_tolerance")]
pub fn tolerance(&self) -> f64 {
unsafe { ffi::cairo_get_tolerance(self.0.as_ptr()) }
}
#[doc(alias = "cairo_clip")]
pub fn clip(&self) {
unsafe { ffi::cairo_clip(self.0.as_ptr()) }
}
#[doc(alias = "cairo_clip_preserve")]
pub fn clip_preserve(&self) {
unsafe { ffi::cairo_clip_preserve(self.0.as_ptr()) }
}
#[doc(alias = "cairo_clip_extents")]
pub fn clip_extents(&self) -> Result<(f64, f64, f64, f64), Error> {
let mut x1: f64 = 0.0;
let mut y1: f64 = 0.0;
let mut x2: f64 = 0.0;
let mut y2: f64 = 0.0;
unsafe {
ffi::cairo_clip_extents(self.0.as_ptr(), &mut x1, &mut y1, &mut x2, &mut y2);
}
self.status().map(|_| (x1, y1, x2, y2))
}
#[doc(alias = "cairo_in_clip")]
pub fn in_clip(&self, x: f64, y: f64) -> Result<bool, Error> {
let in_clip = unsafe { ffi::cairo_in_clip(self.0.as_ptr(), x, y).as_bool() };
self.status().map(|_| in_clip)
}
#[doc(alias = "cairo_reset_clip")]
pub fn reset_clip(&self) {
unsafe { ffi::cairo_reset_clip(self.0.as_ptr()) }
}
#[doc(alias = "cairo_copy_clip_rectangle_list")]
pub fn copy_clip_rectangle_list(&self) -> Result<RectangleList, Error> {
unsafe {
let rectangle_list = ffi::cairo_copy_clip_rectangle_list(self.0.as_ptr());
status_to_result((*rectangle_list).status)?;
Ok(RectangleList {
ptr: rectangle_list,
})
}
}
#[doc(alias = "cairo_fill")]
pub fn fill(&self) -> Result<(), Error> {
unsafe { ffi::cairo_fill(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_fill_preserve")]
pub fn fill_preserve(&self) -> Result<(), Error> {
unsafe { ffi::cairo_fill_preserve(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_fill_extents")]
pub fn fill_extents(&self) -> Result<(f64, f64, f64, f64), Error> {
let mut x1: f64 = 0.0;
let mut y1: f64 = 0.0;
let mut x2: f64 = 0.0;
let mut y2: f64 = 0.0;
unsafe {
ffi::cairo_fill_extents(self.0.as_ptr(), &mut x1, &mut y1, &mut x2, &mut y2);
}
self.status().map(|_| (x1, y1, x2, y2))
}
#[doc(alias = "cairo_in_fill")]
pub fn in_fill(&self, x: f64, y: f64) -> Result<bool, Error> {
let in_fill = unsafe { ffi::cairo_in_fill(self.0.as_ptr(), x, y).as_bool() };
self.status().map(|_| in_fill)
}
#[doc(alias = "cairo_mask")]
pub fn mask(&self, pattern: impl AsRef<Pattern>) -> Result<(), Error> {
let pattern = pattern.as_ref();
pattern.status()?;
unsafe { ffi::cairo_mask(self.0.as_ptr(), pattern.to_raw_none()) };
self.status()
}
#[doc(alias = "cairo_mask_surface")]
pub fn mask_surface(&self, surface: impl AsRef<Surface>, x: f64, y: f64) -> Result<(), Error> {
let surface = surface.as_ref();
surface.status()?;
unsafe {
ffi::cairo_mask_surface(self.0.as_ptr(), surface.to_raw_none(), x, y);
};
self.status()
}
#[doc(alias = "cairo_paint")]
pub fn paint(&self) -> Result<(), Error> {
unsafe { ffi::cairo_paint(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_paint_with_alpha")]
pub fn paint_with_alpha(&self, alpha: f64) -> Result<(), Error> {
unsafe { ffi::cairo_paint_with_alpha(self.0.as_ptr(), alpha) };
self.status()
}
#[doc(alias = "cairo_stroke")]
pub fn stroke(&self) -> Result<(), Error> {
unsafe { ffi::cairo_stroke(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_stroke_preserve")]
pub fn stroke_preserve(&self) -> Result<(), Error> {
unsafe { ffi::cairo_stroke_preserve(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_stroke_extents")]
pub fn stroke_extents(&self) -> Result<(f64, f64, f64, f64), Error> {
let mut x1: f64 = 0.0;
let mut y1: f64 = 0.0;
let mut x2: f64 = 0.0;
let mut y2: f64 = 0.0;
unsafe {
ffi::cairo_stroke_extents(self.0.as_ptr(), &mut x1, &mut y1, &mut x2, &mut y2);
}
self.status().map(|_| (x1, y1, x2, y2))
}
#[doc(alias = "cairo_in_stroke")]
pub fn in_stroke(&self, x: f64, y: f64) -> Result<bool, Error> {
let in_stroke = unsafe { ffi::cairo_in_stroke(self.0.as_ptr(), x, y).as_bool() };
self.status().map(|_| in_stroke)
}
#[doc(alias = "cairo_copy_page")]
pub fn copy_page(&self) -> Result<(), Error> {
unsafe { ffi::cairo_copy_page(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "cairo_show_page")]
pub fn show_page(&self) -> Result<(), Error> {
unsafe { ffi::cairo_show_page(self.0.as_ptr()) };
self.status()
}
#[doc(alias = "get_reference_count")]
pub fn reference_count(&self) -> u32 {
unsafe { ffi::cairo_get_reference_count(self.0.as_ptr()) }
}
#[doc(alias = "cairo_translate")]
pub fn translate(&self, tx: f64, ty: f64) {
unsafe { ffi::cairo_translate(self.0.as_ptr(), tx, ty) }
}
#[doc(alias = "cairo_scale")]
pub fn scale(&self, sx: f64, sy: f64) {
unsafe { ffi::cairo_scale(self.0.as_ptr(), sx, sy) }
}
#[doc(alias = "cairo_rotate")]
pub fn rotate(&self, angle: f64) {
unsafe { ffi::cairo_rotate(self.0.as_ptr(), angle) }
}
#[doc(alias = "cairo_transform")]
pub fn transform(&self, matrix: Matrix) {
unsafe {
ffi::cairo_transform(self.0.as_ptr(), matrix.ptr());
}
}
#[doc(alias = "cairo_set_matrix")]
pub fn set_matrix(&self, matrix: Matrix) {
unsafe {
ffi::cairo_set_matrix(self.0.as_ptr(), matrix.ptr());
}
}
#[doc(alias = "get_matrix")]
#[doc(alias = "cairo_get_matrix")]
pub fn matrix(&self) -> Matrix {
let mut matrix = Matrix::null();
unsafe {
ffi::cairo_get_matrix(self.0.as_ptr(), matrix.mut_ptr());
}
matrix
}
#[doc(alias = "cairo_identity_matrix")]
pub fn identity_matrix(&self) {
unsafe { ffi::cairo_identity_matrix(self.0.as_ptr()) }
}
#[doc(alias = "cairo_user_to_device")]
pub fn user_to_device(&self, mut x: f64, mut y: f64) -> (f64, f64) {
unsafe {
ffi::cairo_user_to_device(self.0.as_ptr(), &mut x, &mut y);
(x, y)
}
}
#[doc(alias = "cairo_user_to_device_distance")]
pub fn user_to_device_distance(&self, mut dx: f64, mut dy: f64) -> Result<(f64, f64), Error> {
unsafe {
ffi::cairo_user_to_device_distance(self.0.as_ptr(), &mut dx, &mut dy);
};
self.status().map(|_| (dx, dy))
}
#[doc(alias = "cairo_device_to_user")]
pub fn device_to_user(&self, mut x: f64, mut y: f64) -> Result<(f64, f64), Error> {
unsafe {
ffi::cairo_device_to_user(self.0.as_ptr(), &mut x, &mut y);
}
self.status().map(|_| (x, y))
}
#[doc(alias = "cairo_device_to_user_distance")]
pub fn device_to_user_distance(&self, mut dx: f64, mut dy: f64) -> Result<(f64, f64), Error> {
unsafe {
ffi::cairo_device_to_user_distance(self.0.as_ptr(), &mut dx, &mut dy);
}
self.status().map(|_| (dx, dy))
}
#[doc(alias = "cairo_select_font_face")]
pub fn select_font_face(&self, family: &str, slant: FontSlant, weight: FontWeight) {
unsafe {
let family = CString::new(family).unwrap();
ffi::cairo_select_font_face(
self.0.as_ptr(),
family.as_ptr(),
slant.into(),
weight.into(),
)
}
}
#[doc(alias = "cairo_set_font_size")]
pub fn set_font_size(&self, size: f64) {
unsafe { ffi::cairo_set_font_size(self.0.as_ptr(), size) }
}
#[doc(alias = "cairo_set_font_matrix")]
pub fn set_font_matrix(&self, matrix: Matrix) {
unsafe { ffi::cairo_set_font_matrix(self.0.as_ptr(), matrix.ptr()) }
}
#[doc(alias = "get_font_matrix")]
#[doc(alias = "cairo_get_font_matrix")]
pub fn font_matrix(&self) -> Matrix {
let mut matrix = Matrix::null();
unsafe {
ffi::cairo_get_font_matrix(self.0.as_ptr(), matrix.mut_ptr());
}
matrix
}
#[doc(alias = "cairo_set_font_options")]
pub fn set_font_options(&self, options: &FontOptions) {
unsafe { ffi::cairo_set_font_options(self.0.as_ptr(), options.to_raw_none()) }
}
#[doc(alias = "get_font_options")]
#[doc(alias = "cairo_get_font_options")]
pub fn font_options(&self) -> Result<FontOptions, Error> {
let out = FontOptions::new()?;
unsafe {
ffi::cairo_get_font_options(self.0.as_ptr(), out.to_raw_none());
}
Ok(out)
}
#[doc(alias = "cairo_set_font_face")]
pub fn set_font_face(&self, font_face: &FontFace) {
unsafe { ffi::cairo_set_font_face(self.0.as_ptr(), font_face.to_raw_none()) }
}
#[doc(alias = "get_font_face")]
#[doc(alias = "cairo_get_font_face")]
pub fn font_face(&self) -> FontFace {
unsafe { FontFace::from_raw_none(ffi::cairo_get_font_face(self.0.as_ptr())) }
}
#[doc(alias = "cairo_set_scaled_font")]
pub fn set_scaled_font(&self, scaled_font: &ScaledFont) {
unsafe { ffi::cairo_set_scaled_font(self.0.as_ptr(), scaled_font.to_raw_none()) }
}
#[doc(alias = "get_scaled_font")]
#[doc(alias = "cairo_get_scaled_font")]
pub fn scaled_font(&self) -> ScaledFont {
unsafe { ScaledFont::from_raw_none(ffi::cairo_get_scaled_font(self.0.as_ptr())) }
}
#[doc(alias = "cairo_show_text")]
pub fn show_text(&self, text: &str) -> Result<(), Error> {
unsafe {
let text = CString::new(text).unwrap();
ffi::cairo_show_text(self.0.as_ptr(), text.as_ptr())
};
self.status()
}
#[doc(alias = "cairo_show_glyphs")]
pub fn show_glyphs(&self, glyphs: &[Glyph]) -> Result<(), Error> {
unsafe {
ffi::cairo_show_glyphs(
self.0.as_ptr(),
glyphs.as_ptr() as *const _,
glyphs.len() as _,
)
};
self.status()
}
#[doc(alias = "cairo_show_text_glyphs")]
pub fn show_text_glyphs(
&self,
text: &str,
glyphs: &[Glyph],
clusters: &[TextCluster],
cluster_flags: TextClusterFlags,
) -> Result<(), Error> {
unsafe {
let text = CString::new(text).unwrap();
ffi::cairo_show_text_glyphs(
self.0.as_ptr(),
text.as_ptr(),
-1_i32, glyphs.as_ptr() as *const _,
glyphs.len() as _,
clusters.as_ptr() as *const _,
clusters.len() as _,
cluster_flags.into(),
)
};
self.status()
}
#[doc(alias = "cairo_font_extents")]
pub fn font_extents(&self) -> Result<FontExtents, Error> {
let mut extents = MaybeUninit::<FontExtents>::uninit();
unsafe {
ffi::cairo_font_extents(self.0.as_ptr(), extents.as_mut_ptr() as *mut _);
self.status().map(|_| extents.assume_init() as _)
}
}
#[doc(alias = "cairo_text_extents")]
pub fn text_extents(&self, text: &str) -> Result<TextExtents, Error> {
let mut extents = MaybeUninit::<TextExtents>::uninit();
unsafe {
let text = CString::new(text).unwrap();
ffi::cairo_text_extents(
self.0.as_ptr(),
text.as_ptr(),
extents.as_mut_ptr() as *mut _,
);
self.status().map(|_| extents.assume_init())
}
}
#[doc(alias = "cairo_glyph_extents")]
pub fn glyph_extents(&self, glyphs: &[Glyph]) -> Result<TextExtents, Error> {
let mut extents = MaybeUninit::<TextExtents>::uninit();
unsafe {
ffi::cairo_glyph_extents(
self.0.as_ptr(),
glyphs.as_ptr() as *const _,
glyphs.len() as _,
extents.as_mut_ptr() as *mut _,
);
self.status().map(|_| extents.assume_init())
}
}
#[doc(alias = "cairo_copy_path")]
pub fn copy_path(&self) -> Result<Path, Error> {
let path = unsafe { Path::from_raw_full(ffi::cairo_copy_path(self.0.as_ptr())) };
self.status().map(|_| path)
}
#[doc(alias = "cairo_copy_path_flat")]
pub fn copy_path_flat(&self) -> Result<Path, Error> {
let path = unsafe { Path::from_raw_full(ffi::cairo_copy_path_flat(self.0.as_ptr())) };
self.status().map(|_| path)
}
#[doc(alias = "cairo_append_path")]
pub fn append_path(&self, path: &Path) {
unsafe { ffi::cairo_append_path(self.0.as_ptr(), path.as_ptr()) }
}
#[doc(alias = "cairo_has_current_point")]
pub fn has_current_point(&self) -> Result<bool, Error> {
let has_current_point = unsafe { ffi::cairo_has_current_point(self.0.as_ptr()).as_bool() };
self.status().map(|_| has_current_point)
}
#[doc(alias = "get_current_point")]
#[doc(alias = "cairo_get_current_point")]
pub fn current_point(&self) -> Result<(f64, f64), Error> {
unsafe {
let mut x = 0.0;
let mut y = 0.0;
ffi::cairo_get_current_point(self.0.as_ptr(), &mut x, &mut y);
self.status().map(|_| (x, y))
}
}
#[doc(alias = "cairo_new_path")]
pub fn new_path(&self) {
unsafe { ffi::cairo_new_path(self.0.as_ptr()) }
}
#[doc(alias = "cairo_new_sub_path")]
pub fn new_sub_path(&self) {
unsafe { ffi::cairo_new_sub_path(self.0.as_ptr()) }
}
#[doc(alias = "cairo_close_path")]
pub fn close_path(&self) {
unsafe { ffi::cairo_close_path(self.0.as_ptr()) }
}
#[doc(alias = "cairo_arc")]
pub fn arc(&self, xc: f64, yc: f64, radius: f64, angle1: f64, angle2: f64) {
unsafe { ffi::cairo_arc(self.0.as_ptr(), xc, yc, radius, angle1, angle2) }
}
#[doc(alias = "cairo_arc_negative")]
pub fn arc_negative(&self, xc: f64, yc: f64, radius: f64, angle1: f64, angle2: f64) {
unsafe { ffi::cairo_arc_negative(self.0.as_ptr(), xc, yc, radius, angle1, angle2) }
}
#[doc(alias = "cairo_curve_to")]
pub fn curve_to(&self, x1: f64, y1: f64, x2: f64, y2: f64, x3: f64, y3: f64) {
unsafe { ffi::cairo_curve_to(self.0.as_ptr(), x1, y1, x2, y2, x3, y3) }
}
#[doc(alias = "cairo_line_to")]
pub fn line_to(&self, x: f64, y: f64) {
unsafe { ffi::cairo_line_to(self.0.as_ptr(), x, y) }
}
#[doc(alias = "cairo_move_to")]
pub fn move_to(&self, x: f64, y: f64) {
unsafe { ffi::cairo_move_to(self.0.as_ptr(), x, y) }
}
#[doc(alias = "cairo_rectangle")]
pub fn rectangle(&self, x: f64, y: f64, width: f64, height: f64) {
unsafe { ffi::cairo_rectangle(self.0.as_ptr(), x, y, width, height) }
}
#[doc(alias = "cairo_text_path")]
pub fn text_path(&self, str_: &str) {
unsafe {
let str_ = CString::new(str_).unwrap();
ffi::cairo_text_path(self.0.as_ptr(), str_.as_ptr())
}
}
#[doc(alias = "cairo_glyph_path")]
pub fn glyph_path(&self, glyphs: &[Glyph]) {
unsafe {
ffi::cairo_glyph_path(
self.0.as_ptr(),
glyphs.as_ptr() as *const _,
glyphs.len() as _,
)
}
}
#[doc(alias = "cairo_rel_curve_to")]
pub fn rel_curve_to(&self, dx1: f64, dy1: f64, dx2: f64, dy2: f64, dx3: f64, dy3: f64) {
unsafe { ffi::cairo_rel_curve_to(self.0.as_ptr(), dx1, dy1, dx2, dy2, dx3, dy3) }
}
#[doc(alias = "cairo_rel_line_to")]
pub fn rel_line_to(&self, dx: f64, dy: f64) {
unsafe { ffi::cairo_rel_line_to(self.0.as_ptr(), dx, dy) }
}
#[doc(alias = "cairo_rel_move_to")]
pub fn rel_move_to(&self, dx: f64, dy: f64) {
unsafe { ffi::cairo_rel_move_to(self.0.as_ptr(), dx, dy) }
}
#[doc(alias = "cairo_path_extents")]
pub fn path_extents(&self) -> Result<(f64, f64, f64, f64), Error> {
let mut x1: f64 = 0.0;
let mut y1: f64 = 0.0;
let mut x2: f64 = 0.0;
let mut y2: f64 = 0.0;
unsafe {
ffi::cairo_path_extents(self.0.as_ptr(), &mut x1, &mut y1, &mut x2, &mut y2);
}
self.status().map(|_| (x1, y1, x2, y2))
}
#[cfg(any(feature = "v1_16", feature = "dox"))]
#[doc(alias = "cairo_tag_begin")]
pub fn tag_begin(&self, tag_name: &str, attributes: &str) {
unsafe {
let tag_name = CString::new(tag_name).unwrap();
let attributes = CString::new(attributes).unwrap();
ffi::cairo_tag_begin(self.0.as_ptr(), tag_name.as_ptr(), attributes.as_ptr())
}
}
#[cfg(any(feature = "v1_16", feature = "dox"))]
#[doc(alias = "cairo_tag_end")]
pub fn tag_end(&self, tag_name: &str) {
unsafe {
let tag_name = CString::new(tag_name).unwrap();
ffi::cairo_tag_end(self.0.as_ptr(), tag_name.as_ptr())
}
}
}
impl fmt::Display for Context {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
write!(f, "Context")
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::enums::Format;
use crate::image_surface::ImageSurface;
use crate::patterns::LinearGradient;
use float_eq::float_eq;
fn create_ctx() -> Context {
let surface = ImageSurface::create(Format::ARgb32, 10, 10).unwrap();
Context::new(&surface).expect("Can't create a Cairo context")
}
#[test]
fn invalid_surface_cant_create_context() {
unsafe {
let image_surf =
ffi::cairo_image_surface_create(Format::ARgb32.into(), 100_000, 100_000);
let wrapped = Surface::from_raw_none(image_surf);
assert!(Context::new(&wrapped).is_err());
ffi::cairo_surface_destroy(image_surf);
}
}
#[test]
fn drop_non_reference_pattern_from_ctx() {
let ctx = create_ctx();
ctx.source();
}
#[test]
fn drop_non_reference_pattern() {
let ctx = create_ctx();
let pattern = LinearGradient::new(1.0f64, 2.0f64, 3.0f64, 4.0f64);
ctx.set_source(&pattern).expect("Invalid surface state");
}
#[test]
fn clip_rectangle() {
let ctx = create_ctx();
let rect = ctx
.copy_clip_rectangle_list()
.expect("Failed to copy rectangle list");
let first_rect = rect[0];
assert!(float_eq!(first_rect.x(), 0.0, abs <= 0.000_1));
assert!(float_eq!(first_rect.y(), 0.0, abs <= 0.000_1));
assert!(float_eq!(first_rect.width(), 10.0, abs <= 0.000_1));
assert!(float_eq!(first_rect.height(), 10.0, abs <= 0.000_1));
assert_eq!(rect.to_string(), "RectangleList");
}
}