1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
// Take a look at the license at the top of the repository in the LICENSE file.

use cairo::{Context, Region};
use gdk_pixbuf::Pixbuf;
use glib::translate::*;

use crate::{Rectangle, Surface, RGBA};

// rustdoc-stripper-ignore-next
/// Trait containing integration methods with [`cairo::Surface`].
pub trait GdkCairoSurfaceExt {
    /// Creates region that covers the area where the given
    /// @surface is more than 50% opaque.
    ///
    /// This function takes into account device offsets that might be
    /// set with cairo_surface_set_device_offset().
    /// ## `surface`
    /// a cairo surface
    ///
    /// # Returns
    ///
    /// A [`cairo::Region`][crate::cairo::Region]
    #[doc(alias = "gdk_cairo_region_create_from_surface")]
    fn create_region(&self) -> Region;
}

impl GdkCairoSurfaceExt for cairo::Surface {
    fn create_region(&self) -> Region {
        unsafe {
            from_glib_full(ffi::gdk_cairo_region_create_from_surface(
                self.to_glib_none().0,
            ))
        }
    }
}

// rustdoc-stripper-ignore-next
/// Trait containing integration methods with [`cairo::Context`].
pub trait GdkCairoContextExt: sealed::Sealed {
    // rustdoc-stripper-ignore-next
    /// # Safety
    ///
    /// It's the responsibility of the caller to ensure that source
    /// is a valid GL resource.
    // rustdoc-stripper-ignore-next-stop
    /// The main way to not draw GL content in GTK.
    ///
    /// It takes a render buffer ID (@source_type == GL_RENDERBUFFER) or a texture
    /// id (@source_type == GL_TEXTURE) and draws it onto @cr with an OVER operation,
    /// respecting the current clip. The top left corner of the rectangle specified
    /// by @x, @y, @width and @height will be drawn at the current (0,0) position of
    /// the [`cairo::Context`][crate::cairo::Context].
    ///
    /// This will work for *all* [`cairo::Context`][crate::cairo::Context], as long as @surface is realized, but the
    /// fallback implementation that reads back the pixels from the buffer may be
    /// used in the general case. In the case of direct drawing to a surface with
    /// no special effects applied to @cr it will however use a more efficient
    /// approach.
    ///
    /// For GL_RENDERBUFFER the code will always fall back to software for buffers
    /// with alpha components, so make sure you use GL_TEXTURE if using alpha.
    ///
    /// Calling this may change the current GL context.
    ///
    /// # Deprecated since 4.6
    ///
    /// The function is overly complex and produces broken output
    ///   in various combinations of arguments. If you want to draw with GL textures
    ///   in GTK, use [`GLTexture::new()`][crate::GLTexture::new()]; if you want to use that texture in
    ///   Cairo, use [`TextureExtManual::download()`][crate::prelude::TextureExtManual::download()] to download the data into a Cairo
    ///   image surface.
    /// ## `cr`
    /// a cairo context
    /// ## `surface`
    /// The surface we're rendering for (not necessarily into)
    /// ## `source`
    /// The GL ID of the source buffer
    /// ## `source_type`
    /// The type of the @source
    /// ## `buffer_scale`
    /// The scale-factor that the @source buffer is allocated for
    /// ## `x`
    /// The source x position in @source to start copying from in GL coordinates
    /// ## `y`
    /// The source y position in @source to start copying from in GL coordinates
    /// ## `width`
    /// The width of the region to draw
    /// ## `height`
    /// The height of the region to draw
    #[doc(alias = "gdk_cairo_draw_from_gl")]
    #[allow(clippy::too_many_arguments)]
    unsafe fn draw_from_gl(
        &self,
        surface: &Surface,
        source: i32,
        source_type: i32,
        buffer_scale: i32,
        x: i32,
        y: i32,
        width: i32,
        height: i32,
    ) {
        skip_assert_initialized!();
        ffi::gdk_cairo_draw_from_gl(
            self.to_raw(),
            surface.to_glib_none().0,
            source,
            source_type,
            buffer_scale,
            x,
            y,
            width,
            height,
        );
    }

    #[doc(alias = "gdk_cairo_set_source_rgba")]
    #[doc(alias = "set_source_rgba")]
    fn set_source_color(&self, rgba: &RGBA) {
        unsafe {
            ffi::gdk_cairo_set_source_rgba(self.to_raw(), rgba.to_glib_none().0);
        }
    }

    /// Sets the given pixbuf as the source pattern for @cr.
    ///
    /// The pattern has an extend mode of `CAIRO_EXTEND_NONE` and is aligned
    /// so that the origin of @pixbuf is @pixbuf_x, @pixbuf_y.
    /// ## `cr`
    /// a cairo context
    /// ## `pixbuf`
    /// a [`gdk_pixbuf::Pixbuf`][crate::gdk_pixbuf::Pixbuf]
    /// ## `pixbuf_x`
    /// X coordinate of location to place upper left corner of @pixbuf
    /// ## `pixbuf_y`
    /// Y coordinate of location to place upper left corner of @pixbuf
    #[doc(alias = "gdk_cairo_set_source_pixbuf")]
    fn set_source_pixbuf(&self, pixbuf: &Pixbuf, x: f64, y: f64) {
        unsafe {
            ffi::gdk_cairo_set_source_pixbuf(self.to_raw(), pixbuf.to_glib_none().0, x, y);
        }
    }

    /// Adds the given rectangle to the current path of @cr.
    /// ## `cr`
    /// a cairo context
    /// ## `rectangle`
    /// a [`Rectangle`][crate::Rectangle]
    #[doc(alias = "gdk_cairo_rectangle")]
    fn add_rectangle(&self, rectangle: &Rectangle) {
        unsafe {
            ffi::gdk_cairo_rectangle(self.to_raw(), rectangle.to_glib_none().0);
        }
    }

    /// Adds the given region to the current path of @cr.
    /// ## `cr`
    /// a cairo context
    /// ## `region`
    /// a [`cairo::Region`][crate::cairo::Region]
    #[doc(alias = "gdk_cairo_region")]
    fn add_region(&self, region: &Region) {
        unsafe {
            ffi::gdk_cairo_region(self.to_raw(), region.to_glib_none().0);
        }
    }
}

impl GdkCairoContextExt for Context {}

mod sealed {
    use cairo::{ffi::cairo_t, Context};

    pub trait Sealed {
        fn to_raw(&self) -> *mut cairo_t;
    }

    impl Sealed for Context {
        fn to_raw(&self) -> *mut cairo_t {
            self.to_raw_none()
        }
    }
}