From 05af8d00d4c0f7b8e0ece85224fd90a92da86da8 Mon Sep 17 00:00:00 2001
From: Héctor Ramón Jiménez <hector0193@gmail.com>
Date: Tue, 19 May 2020 17:15:44 +0200
Subject: Draft new `iced_graphics` crate :tada:

---
 graphics/src/backend.rs | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 graphics/src/backend.rs

(limited to 'graphics/src/backend.rs')

diff --git a/graphics/src/backend.rs b/graphics/src/backend.rs
new file mode 100644
index 00000000..3fcb42f7
--- /dev/null
+++ b/graphics/src/backend.rs
@@ -0,0 +1,30 @@
+use iced_native::image;
+use iced_native::svg;
+use iced_native::{Font, Size};
+
+pub trait Backend {
+    fn trim_measurements(&mut self) {}
+}
+
+pub trait Text {
+    const ICON_FONT: Font;
+    const CHECKMARK_ICON: char;
+
+    fn measure(
+        &self,
+        contents: &str,
+        size: f32,
+        font: Font,
+        bounds: Size,
+    ) -> (f32, f32);
+
+    fn space_width(&self, size: f32) -> f32;
+}
+
+pub trait Image {
+    fn dimensions(&self, handle: &image::Handle) -> (u32, u32);
+}
+
+pub trait Svg {
+    fn viewport_dimensions(&self, handle: &svg::Handle) -> (u32, u32);
+}
-- 
cgit 


From 823ea1573245b849a0696543838a7ad1d0f914d8 Mon Sep 17 00:00:00 2001
From: Héctor Ramón Jiménez <hector0193@gmail.com>
Date: Wed, 27 May 2020 23:09:27 +0200
Subject: Update `glyph_brush` and `glow_glyph`

---
 graphics/src/backend.rs | 2 --
 1 file changed, 2 deletions(-)

(limited to 'graphics/src/backend.rs')

diff --git a/graphics/src/backend.rs b/graphics/src/backend.rs
index 3fcb42f7..ee4eca0a 100644
--- a/graphics/src/backend.rs
+++ b/graphics/src/backend.rs
@@ -17,8 +17,6 @@ pub trait Text {
         font: Font,
         bounds: Size,
     ) -> (f32, f32);
-
-    fn space_width(&self, size: f32) -> f32;
 }
 
 pub trait Image {
-- 
cgit 


From 2ca7e3c4b0cb293adebf9a9bf9a26191069d495d Mon Sep 17 00:00:00 2001
From: Héctor Ramón Jiménez <hector0193@gmail.com>
Date: Thu, 28 May 2020 01:37:59 +0200
Subject: Write documentation for `iced_graphics`

---
 graphics/src/backend.rs | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

(limited to 'graphics/src/backend.rs')

diff --git a/graphics/src/backend.rs b/graphics/src/backend.rs
index ee4eca0a..83510311 100644
--- a/graphics/src/backend.rs
+++ b/graphics/src/backend.rs
@@ -1,15 +1,33 @@
+//! Write a graphics backend.
 use iced_native::image;
 use iced_native::svg;
 use iced_native::{Font, Size};
 
+/// The graphics backend of a [`Renderer`].
+///
+/// [`Renderer`]: ../struct.Renderer.html
 pub trait Backend {
+    /// Trims the measurements cache.
+    ///
+    /// This method is currently necessary to properly trim the text cache in
+    /// `iced_wgpu` and `iced_glow` because of limitations in the text rendering
+    /// pipeline. It will be removed in the future.
     fn trim_measurements(&mut self) {}
 }
 
+/// A graphics backend that supports text rendering.
 pub trait Text {
+    /// The icon font of the backend.
     const ICON_FONT: Font;
+
+    /// The `char` representing a ✔ icon in the [`ICON_FONT`].
+    ///
+    /// [`ICON_FONT`]: #associatedconst.ICON_FONt
     const CHECKMARK_ICON: char;
 
+    /// Measures the text contents with the given size and font,
+    /// returning the size of a laid out paragraph that fits in the provided
+    /// bounds.
     fn measure(
         &self,
         contents: &str,
@@ -19,10 +37,14 @@ pub trait Text {
     ) -> (f32, f32);
 }
 
+/// A graphics backend that supports image rendering.
 pub trait Image {
+    /// Returns the dimensions of the provided image.
     fn dimensions(&self, handle: &image::Handle) -> (u32, u32);
 }
 
+/// A graphics backend that supports SVG rendering.
 pub trait Svg {
+    /// Returns the viewport dimensions of the provided SVG.
     fn viewport_dimensions(&self, handle: &svg::Handle) -> (u32, u32);
 }
-- 
cgit