From 5043a7bd395b1f9d62173cba30f3cb832ceafa1a Mon Sep 17 00:00:00 2001 From: Jeanie Date: Wed, 18 Dec 2024 01:38:43 +0900 Subject: [PATCH 01/10] some basic documentation --- services/graphics-server/src/lib.rs | 287 +++++++++++++++++++++++++++- 1 file changed, 279 insertions(+), 8 deletions(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index bb9fc6e68..74a5fb437 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -31,6 +31,15 @@ impl Gfx { pub fn conn(&self) -> xous::CID { self.conn } + /// Draws a line on the graphics server. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, Line, LineStyle, Point}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// gfx.draw_line(line).unwrap(); + /// ``` pub fn draw_line(&self, line: Line) -> Result<(), xous::Error> { send_message( self.conn, @@ -45,6 +54,15 @@ impl Gfx { .map(|_| ()) } + /// Draws a circle on the graphics server. + /// + /// # Example + /// ``` + /// use graphics_server::{Circle, Gfx, LineStyle, Point}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let circle = Circle::new(Point::new(50, 50), 25, LineStyle::Solid); + /// gfx.draw_circle(circle).unwrap(); + /// ``` pub fn draw_circle(&self, circ: Circle) -> Result<(), xous::Error> { send_message( self.conn, @@ -59,6 +77,15 @@ impl Gfx { .map(|_| ()) } + /// Draws a rectangle on the graphics server. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, LineStyle, Point, Rectangle}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid); + /// gfx.draw_rectangle(rect).unwrap(); + /// ``` pub fn draw_rectangle(&self, rect: Rectangle) -> Result<(), xous::Error> { send_message( self.conn, @@ -73,6 +100,18 @@ impl Gfx { .map(|_| ()) } + /// Draws a rounded rectangle on the graphics server. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, LineStyle, Point, Rectangle, RoundedRectangle}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let rr = RoundedRectangle::new( + /// Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid), + /// 5, + /// ); + /// gfx.draw_rounded_rectangle(rr).unwrap(); + /// ``` pub fn draw_rounded_rectangle(&self, rr: RoundedRectangle) -> Result<(), xous::Error> { send_message( self.conn, @@ -87,21 +126,62 @@ impl Gfx { .map(|_| ()) } + /// Flushes the graphics server, ensuring all previous drawing commands are executed. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.flush().unwrap(); + /// ``` pub fn flush(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::Flush.to_usize().unwrap(), 0, 0, 0, 0)) .map(|_| ()) } + /// Draws the sleep screen on the graphics server. + /// + /// This function sends a message to the graphics server to draw the sleep screen. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_sleepscreen().unwrap(); + /// ``` pub fn draw_sleepscreen(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::DrawSleepScreen.to_usize().unwrap(), 0, 0, 0, 0)) .map(|_| ()) } + /// Draws the boot logo on the graphics server. + /// + /// This function sends a message to the graphics server to draw the boot logo. + /// The boot logo is typically displayed during the device's startup sequence. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_boot_logo().unwrap(); + /// ``` pub fn draw_boot_logo(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::DrawBootLogo.to_usize().unwrap(), 0, 0, 0, 0)) .map(|_| ()) } + /// Retrieves the screen size from the graphics server. + /// + /// This function sends a message to the graphics server to query the screen size. + /// The screen size is returned as a `Point` representing the width and height. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let screen_dimensions = gfx.screen_size().unwrap(); + /// println!("Screen size: {}x{}", screen_size.x, screen_size.y); + /// ``` pub fn screen_size(&self) -> Result { let response = send_message( self.conn, @@ -115,6 +195,18 @@ impl Gfx { } } + /// Retrieves the height hint for a specific glyph from the graphics server. + /// + /// This function sends a message to the graphics server to query the height hint of a glyph. + /// The height hint is returned as a `usize`. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, GlyphStyle}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let height_hint = gfx.glyph_height_hint(GlyphStyle::Regular).unwrap(); + /// println!("Glyph height hint: {}", height_hint); + /// ``` pub fn glyph_height_hint(&self, glyph: GlyphStyle) -> Result { let response = send_message( self.conn, @@ -134,8 +226,20 @@ impl Gfx { } } - /// This function will truncate a TextView string if it is too long to transmit in - /// a single page of memory. + /// Draws a `TextView` on the graphics server. + /// + /// This function sends a message to the graphics server to draw the specified `TextView`. + /// If the text in the `TextView` is too long to transmit in a single page of memory, it will be + /// truncated. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, TextView}; + /// let mut tv = TextView::new(); + /// tv.set_text("Hello, world!"); + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_textview(&mut tv).unwrap(); + /// ```` pub fn draw_textview(&self, tv: &mut TextView) -> Result<(), xous::Error> { if tv.text.len() > TEXTVIEW_LEN { tv.text.truncate(TEXTVIEW_LEN); @@ -152,31 +256,103 @@ impl Gfx { Ok(()) } + /// Draws a line on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified `Line` within the specified + /// `Rectangle` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, Line, LineStyle, Point, Rectangle}; + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_line_clipped(line, clip).unwrap(); + /// ``` pub fn draw_line_clipped(&self, line: Line, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Line(line) }; let buf = Buffer::into_buf(co).or(Err(xous::Error::InternalError))?; buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - // for use in the deface operation + /// Draws a line on the graphics server with XOR clipping. + /// For use in the deface operation. + /// + /// This function sends a message to the graphics server to draw the specified `Line` within the specified + /// `Rectangle` clip area using XOR mode. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, Line, LineStyle, Point, Rectangle}; + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_line_clipped_xor(line, clip).unwrap(); + /// ``` pub fn draw_line_clipped_xor(&self, line: Line, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::XorLine(line) }; let buf = Buffer::into_buf(co).or(Err(xous::Error::InternalError))?; buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } + /// Draws a circle on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified `Circle` within the + /// specified `Rectangle` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{Circle, Gfx, LineStyle, Point, Rectangle}; + /// let circ = Circle::new(Point::new(50, 50), 25, LineStyle::Solid); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_circle_clipped(circ, clip).expect("Failed to draw clipped circle"); + /// Ok(_) => println!("Circle clipped successfully"), + /// Err(e) => eprintln!("Failed to clip circle: {:?}", e), + /// } + /// ``` pub fn draw_circle_clipped(&self, circ: Circle, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Circ(circ) }; let buf = Buffer::into_buf(co).or(Err(xous::Error::InternalError))?; buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } + /// Draws a rectangle on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified `Rectangle` + /// within the specified `ClipRect` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, LineStyle, Point, Rectangle}; + /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid); + /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// match gfx.draw_rectangle_clipped(rect, clip) { + /// Ok(_) => println!("Rectangle clipped successfully"), + /// Err(e) => eprintln!("Failed to clip rectangle: {:?}", e), + /// } + /// ``` pub fn draw_rectangle_clipped(&self, rect: Rectangle, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Rect(rect) }; let buf = Buffer::into_buf(co).or(Err(xous::Error::InternalError))?; buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } + /// Draws a rounded rectangle on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified `RoundedRectangle` + /// within the specified `ClipRect` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, LineStyle, Point, Rectangle, RoundedRectangle}; + /// let rr = RoundedRectangle::new( + /// Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid), + /// 5, + /// ); + /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// gfx.draw_rounded_rectangle_clipped(rr, clip).unwrap(); + /// ``` pub fn draw_rounded_rectangle_clipped( &self, rr: RoundedRectangle, @@ -187,6 +363,18 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } + /// Draws a tile on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified `Tile` + /// within the specified `ClipRect` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{Gfx, Point, Rectangle, Tile}; + /// let tile = Tile::new(Point::new(10, 10), Point::new(50, 50)); + /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// gfx.draw_tile_clipped(tile, clip).unwrap(); + /// ``` #[cfg(feature = "ditherpunk")] pub fn draw_tile_clipped(&self, tile: Tile, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Tile(tile) }; @@ -195,25 +383,67 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } + /// Draws a list of objects on the graphics server with clipping. + /// + /// This function sends a message to the graphics server to draw the specified list of objects + /// within the specified `ClipRect` clip area. + /// + /// # Example + /// ``` + /// use graphics_server::{ClipObjectList, Gfx, Point, Rectangle}; + /// let object_list = ClipObjectList::default(); + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.draw_object_list_clipped(object_list).unwrap(); + /// ``` pub fn draw_object_list_clipped(&self, list: ClipObjectList) -> Result<(), xous::Error> { let buf = Buffer::into_buf(list).or(Err(xous::Error::InternalError))?; buf.lend(self.conn, Opcode::DrawClipObjectList.to_u32().unwrap()).map(|_| ()) } - /// this is a one-way door, once you've set it, you can't unset it. + /// Sets the developer boot mode on the graphics server. + /// + /// This function sends a message to the graphics server to enable or disable the developer boot mode. + /// Once you've set it, you can't unset it. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.set_devboot(true).unwrap(); // Enable developer boot mode + /// gfx.set_devboot(false).unwrap(); // Disable developer boot mode + /// ``` pub fn set_devboot(&self, enable: bool) -> Result<(), xous::Error> { let ena = if enable { 1 } else { 0 }; send_message(self.conn, Message::new_scalar(Opcode::Devboot.to_usize().unwrap(), ena, 0, 0, 0)) .map(|_| ()) } - /// instead of implementing the read in the library, we had the raw opcode to the caller - /// this allows the caller to re-use the bulk read data structure across multiple reads - /// instead of it being re-allocated and re-init'd every single call + /// Reads the font map in bulk from the graphics server. + /// + /// Instead of implementing the read in the library, we hand the raw opcode to the caller. + /// This allows the caller to re-use the bulk read data structure across multiple reads + /// instead of it being re-allocated and re-initialized every single call. + /// + /// # Example + /// ``` + /// use graphics_server::{ArchivedBulkRead, Gfx}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let font_map = gfx.bulk_read_fontmap_op(0).unwrap(); + /// // Process the font map as needed + /// ``` pub fn bulk_read_fontmap_op(&self) -> u32 { Opcode::BulkReadFonts.to_u32().unwrap() } - /// the bulk read auto-increments a pointer on the gfx server, so this message is necessary + /// Resets the bulk read pointer on the graphics server. + /// + /// The bulk read operation auto-increments a pointer on the graphics server, so this message is necessary /// to reset the pointer to 0. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.bulk_read_restart().unwrap(); + /// ``` pub fn bulk_read_restart(&self) { send_message( self.conn, @@ -222,6 +452,17 @@ impl Gfx { .expect("couldn't reset bulk read"); } + /// Runs a self-test pattern on the graphics server. + /// + /// This function sends a message to the graphics server to display a test pattern for a specified + /// duration. The test pattern is typically used to verify the functionality of the graphics hardware. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.selftest(1000); // Display the test pattern for 1000 milliseconds + /// ``` pub fn selftest(&self, duration_ms: usize) { send_message( self.conn, @@ -230,6 +471,19 @@ impl Gfx { .expect("couldn't self test"); } + /// Stashes the current graphics state on the graphics server. + /// + /// This function sends a message to the graphics server to stash (save) the current graphics state. + /// The stashed state can be restored later using the `pop` function. This is useful for temporarily + /// saving the current state before making changes, and then restoring it later. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.stash(true); // Stash the current state in a blocking manner + /// gfx.stash(false); // Stash the current state in a non-blocking manner + /// ``` pub fn stash(&self, blocking: bool) { if blocking { send_message( @@ -243,6 +497,23 @@ impl Gfx { } } + /// Restores the previously stashed graphics state on the graphics server. + /// + /// This function sends a message to the graphics server to restore the previously stashed graphics state. + /// The stashed state can be restored using this function after it has been saved using the `stash` + /// function. This is useful for reverting to a previous state after making temporary changes. + /// + /// # Example + /// ``` + /// use graphics_server::Gfx; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// gfx.stash(true); // Stash the current state in a blocking manner + /// // Make some changes to the graphics state + /// gfx.pop(true); // Restore the previously stashed state in a blocking manner + /// gfx.stash(false); // Stash the current state in a non-blocking manner + /// // Make some changes to the graphics state + /// gfx.pop(false); // Restore the previously stashed state in a non-blocking manner + /// ``` pub fn pop(&self, blocking: bool) { if blocking { send_message( From 61f1ffdc9d21d2f15275d4f15bfa05d0a7dfdb2a Mon Sep 17 00:00:00 2001 From: Jeanie Date: Sat, 21 Dec 2024 20:18:35 +0900 Subject: [PATCH 02/10] all examples are now tested/fixed --- services/graphics-server/src/lib.rs | 172 +++++++++++++++++----------- 1 file changed, 104 insertions(+), 68 deletions(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 74a5fb437..18bedddd1 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -35,10 +35,11 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, Line, LineStyle, Point}; + /// use graphics_server::{Gfx, Line, Point}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); // if you want to specify a style, use Line::new_with_style /// gfx.draw_line(line).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_line(&self, line: Line) -> Result<(), xous::Error> { send_message( @@ -58,10 +59,11 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Circle, Gfx, LineStyle, Point}; + /// use graphics_server::{Circle, Gfx, Point}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let circle = Circle::new(Point::new(50, 50), 25, LineStyle::Solid); + /// let circle = Circle::new(Point::new(150, 150), 25); // if you want to specify a style, use Circle::new_with_style /// gfx.draw_circle(circle).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_circle(&self, circ: Circle) -> Result<(), xous::Error> { send_message( @@ -81,10 +83,11 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, LineStyle, Point, Rectangle}; + /// use graphics_server::{Gfx, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid); + /// let rect = Rectangle::new(Point::new(100, 100), Point::new(250, 150)); // if you want to specify a style, use Rectangle::new_with_style /// gfx.draw_rectangle(rect).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_rectangle(&self, rect: Rectangle) -> Result<(), xous::Error> { send_message( @@ -104,13 +107,11 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, LineStyle, Point, Rectangle, RoundedRectangle}; + /// use graphics_server::{Gfx, Point, Rectangle, RoundedRectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let rr = RoundedRectangle::new( - /// Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid), - /// 5, - /// ); + /// let rr = RoundedRectangle::new(Rectangle::new(Point::new(100, 100), Point::new(150, 200)), 5); /// gfx.draw_rounded_rectangle(rr).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_rounded_rectangle(&self, rr: RoundedRectangle) -> Result<(), xous::Error> { send_message( @@ -130,9 +131,13 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::Gfx; + /// use graphics_server::{Circle, Gfx, Line, Point}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// gfx.flush().unwrap(); + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// let circle = Circle::new(Point::new(150, 150), 25); + /// gfx.draw_line(line).unwrap(); + /// gfx.draw_circle(circle).unwrap(); + /// gfx.flush().unwrap(); // Both the line and the circle will be drawn /// ``` pub fn flush(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::Flush.to_usize().unwrap(), 0, 0, 0, 0)) @@ -148,6 +153,7 @@ impl Gfx { /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); /// gfx.draw_sleepscreen().unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_sleepscreen(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::DrawSleepScreen.to_usize().unwrap(), 0, 0, 0, 0)) @@ -164,6 +170,7 @@ impl Gfx { /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); /// gfx.draw_boot_logo().unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_boot_logo(&self) -> Result<(), xous::Error> { send_message(self.conn, Message::new_scalar(Opcode::DrawBootLogo.to_usize().unwrap(), 0, 0, 0, 0)) @@ -179,8 +186,8 @@ impl Gfx { /// ``` /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let screen_dimensions = gfx.screen_size().unwrap(); - /// println!("Screen size: {}x{}", screen_size.x, screen_size.y); + /// let screen_dimensions = gfx.screen_size().expect("Couldn't get screen size"); + /// println!("Screen size: {}x{}", screen_dimensions.x, screen_dimensions.y); /// ``` pub fn screen_size(&self) -> Result { let response = send_message( @@ -231,14 +238,18 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `TextView`. /// If the text in the `TextView` is too long to transmit in a single page of memory, it will be /// truncated. + /// Text that overflows the bounds of the `TextView` will be clipped. /// /// # Example /// ``` /// use graphics_server::{Gfx, TextView}; - /// let mut tv = TextView::new(); - /// tv.set_text("Hello, world!"); - /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let clipping_area = Rectangle::new_coords(50, 50, 290, 450); + /// let text_bounds = Rectangle::new_coords(10, 10, 240, 400); + /// let mut tv = TextView::new(Gid::new([0, 0, 0, 0]), TextBounds::BoundingBox(text_bounds)); + /// tv.clip_rect = Some(clipping_area); + /// write!(tv, "Hello, world!").unwrap(); /// gfx.draw_textview(&mut tv).unwrap(); + /// gfx.flush().unwrap(); /// ```` pub fn draw_textview(&self, tv: &mut TextView) -> Result<(), xous::Error> { if tv.text.len() > TEXTVIEW_LEN { @@ -263,11 +274,12 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, Line, LineStyle, Point, Rectangle}; - /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); - /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// use graphics_server::{Gfx, Line, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90)); /// gfx.draw_line_clipped(line, clip).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_line_clipped(&self, line: Line, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Line(line) }; @@ -283,11 +295,12 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, Line, LineStyle, Point, Rectangle}; - /// let line = Line::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); - /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// use graphics_server::{Gfx, Line, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90)); /// gfx.draw_line_clipped_xor(line, clip).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_line_clipped_xor(&self, line: Line, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::XorLine(line) }; @@ -302,14 +315,12 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Circle, Gfx, LineStyle, Point, Rectangle}; - /// let circ = Circle::new(Point::new(50, 50), 25, LineStyle::Solid); - /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90), LineStyle::Solid); + /// use graphics_server::{Circle, Gfx, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// gfx.draw_circle_clipped(circ, clip).expect("Failed to draw clipped circle"); - /// Ok(_) => println!("Circle clipped successfully"), - /// Err(e) => eprintln!("Failed to clip circle: {:?}", e), - /// } + /// let circ = Circle::new(Point::new(50, 50), 25); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(60, 60)); + /// gfx.draw_circle_clipped(circ, clip).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_circle_clipped(&self, circ: Circle, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Circ(circ) }; @@ -324,13 +335,12 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, LineStyle, Point, Rectangle}; - /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid); - /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); - /// match gfx.draw_rectangle_clipped(rect, clip) { - /// Ok(_) => println!("Rectangle clipped successfully"), - /// Err(e) => eprintln!("Failed to clip rectangle: {:?}", e), - /// } + /// use graphics_server::{Gfx, Point, Rectangle}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50)); + /// let clip = Rectangle::new(Point::new(0, 0), Point::new(60, 60)); + /// gfx.draw_rectangle_clipped(rect, clip).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_rectangle_clipped(&self, rect: Rectangle, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Rect(rect) }; @@ -345,13 +355,12 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::{Gfx, LineStyle, Point, Rectangle, RoundedRectangle}; - /// let rr = RoundedRectangle::new( - /// Rectangle::new(Point::new(10, 10), Point::new(50, 50), LineStyle::Solid), - /// 5, - /// ); - /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); + /// use graphics_server::{Gfx, Point, Rectangle, RoundedRectangle}; + /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let rr = RoundedRectangle::new(Rectangle::new(Point::new(10, 10), Point::new(50, 50)), 5); + /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100)); /// gfx.draw_rounded_rectangle_clipped(rr, clip).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_rounded_rectangle_clipped( &self, @@ -363,18 +372,6 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a tile on the graphics server with clipping. - /// - /// This function sends a message to the graphics server to draw the specified `Tile` - /// within the specified `ClipRect` clip area. - /// - /// # Example - /// ``` - /// use graphics_server::{Gfx, Point, Rectangle, Tile}; - /// let tile = Tile::new(Point::new(10, 10), Point::new(50, 50)); - /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100), LineStyle::Solid); - /// gfx.draw_tile_clipped(tile, clip).unwrap(); - /// ``` #[cfg(feature = "ditherpunk")] pub fn draw_tile_clipped(&self, tile: Tile, clip: Rectangle) -> Result<(), xous::Error> { let co = ClipObject { clip, obj: ClipObjectType::Tile(tile) }; @@ -391,9 +388,21 @@ impl Gfx { /// # Example /// ``` /// use graphics_server::{ClipObjectList, Gfx, Point, Rectangle}; - /// let object_list = ClipObjectList::default(); /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let mut object_list = ClipObjectList::default(); + /// + /// // Create and add the first object (a line) + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// let clip = Rectangle::new(Point::new(10, 10), Point::new(90, 90)); + /// object_list.push(ClipObjectType::Line(line), clip); + /// + /// // Create and add the second object (a circle) + /// let circle = Circle::new(Point::new(150, 150), 25); + /// let clip2 = Rectangle::new(Point::new(20, 20), Point::new(400, 400)); + /// object_list.push(ClipObjectType::Circ(line2), clip2); + /// /// gfx.draw_object_list_clipped(object_list).unwrap(); + /// gfx.flush().unwrap(); /// ``` pub fn draw_object_list_clipped(&self, list: ClipObjectList) -> Result<(), xous::Error> { let buf = Buffer::into_buf(list).or(Err(xous::Error::InternalError))?; @@ -403,14 +412,13 @@ impl Gfx { /// Sets the developer boot mode on the graphics server. /// /// This function sends a message to the graphics server to enable or disable the developer boot mode. - /// Once you've set it, you can't unset it. /// /// # Example /// ``` /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// gfx.set_devboot(true).unwrap(); // Enable developer boot mode - /// gfx.set_devboot(false).unwrap(); // Disable developer boot mode + /// gfx.set_devboot(true); // Enable developer boot mode + /// gfx.set_devboot(false); // Disable developer boot mode /// ``` pub fn set_devboot(&self, enable: bool) -> Result<(), xous::Error> { let ena = if enable { 1 } else { 0 }; @@ -428,7 +436,7 @@ impl Gfx { /// ``` /// use graphics_server::{ArchivedBulkRead, Gfx}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let font_map = gfx.bulk_read_fontmap_op(0).unwrap(); + /// let font_map = gfx.bulk_read_fontmap_op(); /// // Process the font map as needed /// ``` pub fn bulk_read_fontmap_op(&self) -> u32 { Opcode::BulkReadFonts.to_u32().unwrap() } @@ -442,7 +450,7 @@ impl Gfx { /// ``` /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// gfx.bulk_read_restart().unwrap(); + /// gfx.bulk_read_restart(); /// ``` pub fn bulk_read_restart(&self) { send_message( @@ -477,11 +485,15 @@ impl Gfx { /// The stashed state can be restored later using the `pop` function. This is useful for temporarily /// saving the current state before making changes, and then restoring it later. /// + /// If `blocking` is `true`, the function will wait until the graphics server confirms that the state + /// has been stashed, otherwise it will return immediately without waiting for confirmation. + /// /// # Example /// ``` /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// gfx.stash(true); // Stash the current state in a blocking manner + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// gfx.draw_line(line).unwrap(); // Draw a line before stashing /// gfx.stash(false); // Stash the current state in a non-blocking manner /// ``` pub fn stash(&self, blocking: bool) { @@ -505,14 +517,38 @@ impl Gfx { /// /// # Example /// ``` - /// use graphics_server::Gfx; + /// use graphics_server::{DrawStyle, Gfx, Line, PixelColor, Point, Rectangle}; + /// use ticktimer_server::Ticktimer; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); + /// let ticktimer = Ticktimer::new().expect("Couldn't connect to Ticktimer"); + /// + /// // Draw a line + /// let line = Line::new(Point::new(0, 0), Point::new(100, 100)); + /// gfx.draw_line(line).unwrap(); + /// gfx.flush().unwrap(); + /// + /// // Wait for a moment + /// ticktimer.sleep_ms(1000).unwrap(); + /// + /// // Stash the current state /// gfx.stash(true); // Stash the current state in a blocking manner - /// // Make some changes to the graphics state + /// + /// // Clear the screen + /// let screensize = gfx.screen_size().expect("Couldn't get screen size"); + /// let blackout = Rectangle::new_with_style( + /// Point::new(0, 0), + /// screensize, + /// DrawStyle::new(PixelColor::Dark, PixelColor::Dark, 1), + /// ); + /// gfx.draw_rectangle(blackout).unwrap(); + /// gfx.flush().unwrap(); + /// + /// // Wait for a moment + /// ticktimer.sleep_ms(1000).unwrap(); + /// + /// // Restore the previously stashed state /// gfx.pop(true); // Restore the previously stashed state in a blocking manner - /// gfx.stash(false); // Stash the current state in a non-blocking manner - /// // Make some changes to the graphics state - /// gfx.pop(false); // Restore the previously stashed state in a non-blocking manner + /// gfx.flush().unwrap(); /// ``` pub fn pop(&self, blocking: bool) { if blocking { From 52869a21f28ceaf2bdeca2f7ac5eba7c09495c38 Mon Sep 17 00:00:00 2001 From: Jeanie Date: Sun, 22 Dec 2024 16:54:06 +0900 Subject: [PATCH 03/10] take out some repetitive wording --- services/graphics-server/src/lib.rs | 34 ++++++++++++++--------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 18bedddd1..625de568e 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -31,7 +31,7 @@ impl Gfx { pub fn conn(&self) -> xous::CID { self.conn } - /// Draws a line on the graphics server. + /// Draws a line. /// /// # Example /// ``` @@ -55,7 +55,7 @@ impl Gfx { .map(|_| ()) } - /// Draws a circle on the graphics server. + /// Draws a circle. /// /// # Example /// ``` @@ -79,7 +79,7 @@ impl Gfx { .map(|_| ()) } - /// Draws a rectangle on the graphics server. + /// Draws a rectangle. /// /// # Example /// ``` @@ -103,7 +103,7 @@ impl Gfx { .map(|_| ()) } - /// Draws a rounded rectangle on the graphics server. + /// Draws a rounded rectangle. /// /// # Example /// ``` @@ -144,7 +144,7 @@ impl Gfx { .map(|_| ()) } - /// Draws the sleep screen on the graphics server. + /// Draws the sleep screen. /// /// This function sends a message to the graphics server to draw the sleep screen. /// @@ -160,7 +160,7 @@ impl Gfx { .map(|_| ()) } - /// Draws the boot logo on the graphics server. + /// Draws the boot logo. /// /// This function sends a message to the graphics server to draw the boot logo. /// The boot logo is typically displayed during the device's startup sequence. @@ -233,7 +233,7 @@ impl Gfx { } } - /// Draws a `TextView` on the graphics server. + /// Draws a `TextView`. /// /// This function sends a message to the graphics server to draw the specified `TextView`. /// If the text in the `TextView` is too long to transmit in a single page of memory, it will be @@ -267,7 +267,7 @@ impl Gfx { Ok(()) } - /// Draws a line on the graphics server with clipping. + /// Draws a line with clipping. /// /// This function sends a message to the graphics server to draw the specified `Line` within the specified /// `Rectangle` clip area. @@ -287,7 +287,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a line on the graphics server with XOR clipping. + /// Draws a line with XOR clipping. /// For use in the deface operation. /// /// This function sends a message to the graphics server to draw the specified `Line` within the specified @@ -308,7 +308,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a circle on the graphics server with clipping. + /// Draws a circle with clipping. /// /// This function sends a message to the graphics server to draw the specified `Circle` within the /// specified `Rectangle` clip area. @@ -328,7 +328,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a rectangle on the graphics server with clipping. + /// Draws a rectangle with clipping. /// /// This function sends a message to the graphics server to draw the specified `Rectangle` /// within the specified `ClipRect` clip area. @@ -348,7 +348,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a rounded rectangle on the graphics server with clipping. + /// Draws a rounded rectangle with clipping. /// /// This function sends a message to the graphics server to draw the specified `RoundedRectangle` /// within the specified `ClipRect` clip area. @@ -380,7 +380,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObject.to_u32().unwrap()).map(|_| ()) } - /// Draws a list of objects on the graphics server with clipping. + /// Draws a list of objects with clipping. /// /// This function sends a message to the graphics server to draw the specified list of objects /// within the specified `ClipRect` clip area. @@ -409,7 +409,7 @@ impl Gfx { buf.lend(self.conn, Opcode::DrawClipObjectList.to_u32().unwrap()).map(|_| ()) } - /// Sets the developer boot mode on the graphics server. + /// Sets the developer boot mode. /// /// This function sends a message to the graphics server to enable or disable the developer boot mode. /// @@ -441,7 +441,7 @@ impl Gfx { /// ``` pub fn bulk_read_fontmap_op(&self) -> u32 { Opcode::BulkReadFonts.to_u32().unwrap() } - /// Resets the bulk read pointer on the graphics server. + /// Resets the bulk read pointer. /// /// The bulk read operation auto-increments a pointer on the graphics server, so this message is necessary /// to reset the pointer to 0. @@ -460,7 +460,7 @@ impl Gfx { .expect("couldn't reset bulk read"); } - /// Runs a self-test pattern on the graphics server. + /// Runs a self-test pattern. /// /// This function sends a message to the graphics server to display a test pattern for a specified /// duration. The test pattern is typically used to verify the functionality of the graphics hardware. @@ -479,7 +479,7 @@ impl Gfx { .expect("couldn't self test"); } - /// Stashes the current graphics state on the graphics server. + /// Stashes the current graphics state. /// /// This function sends a message to the graphics server to stash (save) the current graphics state. /// The stashed state can be restored later using the `pop` function. This is useful for temporarily From 6257fb4640155eef691cb3cd7ad56677df2fa737 Mon Sep 17 00:00:00 2001 From: Jeanie Date: Sun, 22 Dec 2024 17:12:23 +0900 Subject: [PATCH 04/10] placeholders for example images, small docs update --- services/graphics-server/src/lib.rs | 111 +++++++++++++++++++++++++++- 1 file changed, 110 insertions(+), 1 deletion(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 625de568e..73fbb5b9f 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -33,6 +33,13 @@ impl Gfx { /// Draws a line. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/line.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Line, Point}; @@ -57,6 +64,13 @@ impl Gfx { /// Draws a circle. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/circle.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Circle, Gfx, Point}; @@ -81,6 +95,13 @@ impl Gfx { /// Draws a rectangle. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rectangle.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Point, Rectangle}; @@ -105,6 +126,13 @@ impl Gfx { /// Draws a rounded rectangle. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rounded_rectangle.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Point, Rectangle, RoundedRectangle}; @@ -148,6 +176,13 @@ impl Gfx { /// /// This function sends a message to the graphics server to draw the sleep screen. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/sleepscreen.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::Gfx; @@ -165,6 +200,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the boot logo. /// The boot logo is typically displayed during the device's startup sequence. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/boot_logo.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::Gfx; @@ -240,6 +282,13 @@ impl Gfx { /// truncated. /// Text that overflows the bounds of the `TextView` will be clipped. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/textview.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, TextView}; @@ -272,6 +321,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `Line` within the specified /// `Rectangle` clip area. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/line_clipped.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Line, Point, Rectangle}; @@ -293,6 +349,12 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `Line` within the specified /// `Rectangle` clip area using XOR mode. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/line_clipped_xor.png?raw=true) /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Line, Point, Rectangle}; @@ -313,6 +375,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `Circle` within the /// specified `Rectangle` clip area. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/circle_clipped.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Circle, Gfx, Point, Rectangle}; @@ -333,6 +402,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `Rectangle` /// within the specified `ClipRect` clip area. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rectangle_clipped.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Point, Rectangle}; @@ -353,6 +429,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified `RoundedRectangle` /// within the specified `ClipRect` clip area. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rounded_rectangle_clipped.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{Gfx, Point, Rectangle, RoundedRectangle}; @@ -385,6 +468,13 @@ impl Gfx { /// This function sends a message to the graphics server to draw the specified list of objects /// within the specified `ClipRect` clip area. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/object_list_clipped.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{ClipObjectList, Gfx, Point, Rectangle}; @@ -412,6 +502,10 @@ impl Gfx { /// Sets the developer boot mode. /// /// This function sends a message to the graphics server to enable or disable the developer boot mode. + /// The purpose of this call is to let users be aware of who signed their kernel. Kernels signed with the + /// developer signature can boot, but this API call ensures that a small dashed line appears through the + /// status bar, so there is an obvious indicator that the kernel has yet to be self-signed. Self-signed + /// kernels do not have this signature. /// /// # Example /// ``` @@ -430,7 +524,8 @@ impl Gfx { /// /// Instead of implementing the read in the library, we hand the raw opcode to the caller. /// This allows the caller to re-use the bulk read data structure across multiple reads - /// instead of it being re-allocated and re-initialized every single call. + /// instead of it being re-allocated and re-initialized every single call. This is used by the security + /// system to inspect the font maps for integrity. /// /// # Example /// ``` @@ -465,6 +560,13 @@ impl Gfx { /// This function sends a message to the graphics server to display a test pattern for a specified /// duration. The test pattern is typically used to verify the functionality of the graphics hardware. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/selftest.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::Gfx; @@ -515,6 +617,13 @@ impl Gfx { /// The stashed state can be restored using this function after it has been saved using the `stash` /// function. This is useful for reverting to a previous state after making temporary changes. /// + ///
+ /// Example Image + /// + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/pop.png?raw=true) + /// + ///
+ /// /// # Example /// ``` /// use graphics_server::{DrawStyle, Gfx, Line, PixelColor, Point, Rectangle}; From 5850794fa0dc2e0be40b482e78f9c5ba9cef187d Mon Sep 17 00:00:00 2001 From: Jeanie Date: Sun, 22 Dec 2024 17:16:37 +0900 Subject: [PATCH 05/10] rearranging docs image location for better organization --- .../dynamic_notification.png} | Bin .../get_checkbox.png} | Bin .../get_radiobutton.png} | Bin .../input_bip39_1.png} | Bin .../input_bip39_2.png} | Bin .../input_bip39_3.png} | Bin .../show_bip39.png} | Bin .../show_notification.png} | Bin .../{modals_slider.png => modals/slider.png} | Bin .../start_progress.png} | Bin services/modals/src/lib.rs | 20 +++++++++--------- 11 files changed, 10 insertions(+), 10 deletions(-) rename docs/images/{modals_dynamic_notification.png => modals/dynamic_notification.png} (100%) rename docs/images/{modals_get_checkbox.png => modals/get_checkbox.png} (100%) rename docs/images/{modals_get_radiobutton.png => modals/get_radiobutton.png} (100%) rename docs/images/{modals_input_bip39_1.png => modals/input_bip39_1.png} (100%) rename docs/images/{modals_input_bip39_2.png => modals/input_bip39_2.png} (100%) rename docs/images/{modals_input_bip39_3.png => modals/input_bip39_3.png} (100%) rename docs/images/{modals_show_bip39.png => modals/show_bip39.png} (100%) rename docs/images/{modals_show_notification.png => modals/show_notification.png} (100%) rename docs/images/{modals_slider.png => modals/slider.png} (100%) rename docs/images/{modals_start_progress.png => modals/start_progress.png} (100%) diff --git a/docs/images/modals_dynamic_notification.png b/docs/images/modals/dynamic_notification.png similarity index 100% rename from docs/images/modals_dynamic_notification.png rename to docs/images/modals/dynamic_notification.png diff --git a/docs/images/modals_get_checkbox.png b/docs/images/modals/get_checkbox.png similarity index 100% rename from docs/images/modals_get_checkbox.png rename to docs/images/modals/get_checkbox.png diff --git a/docs/images/modals_get_radiobutton.png b/docs/images/modals/get_radiobutton.png similarity index 100% rename from docs/images/modals_get_radiobutton.png rename to docs/images/modals/get_radiobutton.png diff --git a/docs/images/modals_input_bip39_1.png b/docs/images/modals/input_bip39_1.png similarity index 100% rename from docs/images/modals_input_bip39_1.png rename to docs/images/modals/input_bip39_1.png diff --git a/docs/images/modals_input_bip39_2.png b/docs/images/modals/input_bip39_2.png similarity index 100% rename from docs/images/modals_input_bip39_2.png rename to docs/images/modals/input_bip39_2.png diff --git a/docs/images/modals_input_bip39_3.png b/docs/images/modals/input_bip39_3.png similarity index 100% rename from docs/images/modals_input_bip39_3.png rename to docs/images/modals/input_bip39_3.png diff --git a/docs/images/modals_show_bip39.png b/docs/images/modals/show_bip39.png similarity index 100% rename from docs/images/modals_show_bip39.png rename to docs/images/modals/show_bip39.png diff --git a/docs/images/modals_show_notification.png b/docs/images/modals/show_notification.png similarity index 100% rename from docs/images/modals_show_notification.png rename to docs/images/modals/show_notification.png diff --git a/docs/images/modals_slider.png b/docs/images/modals/slider.png similarity index 100% rename from docs/images/modals_slider.png rename to docs/images/modals/slider.png diff --git a/docs/images/modals_start_progress.png b/docs/images/modals/start_progress.png similarity index 100% rename from docs/images/modals_start_progress.png rename to docs/images/modals/start_progress.png diff --git a/services/modals/src/lib.rs b/services/modals/src/lib.rs index 12a6aec98..ca63cd53f 100644 --- a/services/modals/src/lib.rs +++ b/services/modals/src/lib.rs @@ -209,7 +209,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_show_notification.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/show_notification.png?raw=true) /// ///
/// @@ -248,7 +248,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_show_bip39.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/show_bip39.png?raw=true) /// ///
/// @@ -296,9 +296,9 @@ impl Modals { ///
/// Example Images (from example code below) /// - /// ![Example Image - Initial](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_input_bip39_1.png?raw=true) - /// ![Example Image - Input](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_input_bip39_2.png?raw=true) - /// ![Example Image - Confirmation](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_input_bip39_3.png?raw=true) + /// ![Example Image - Initial](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/input_bip39_1.png?raw=true) + /// ![Example Image - Input](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/input_bip39_2.png?raw=true) + /// ![Example Image - Confirmation](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/input_bip39_3.png?raw=true) /// ///
/// @@ -385,7 +385,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_start_progress.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/start_progress.png?raw=true) /// ///
/// @@ -424,7 +424,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_slider.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/slider.png?raw=true) /// ///
/// @@ -616,7 +616,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_get_radiobutton.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/get_radiobutton.png?raw=true) /// ///
/// @@ -691,7 +691,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_get_checkbox.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/get_checkbox.png?raw=true) /// ///
/// @@ -794,7 +794,7 @@ impl Modals { ///
/// Example Image /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals_dynamic_notification.png?raw=true) + /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/modals/dynamic_notification.png?raw=true) /// ///
/// From 16782f1f256b2da185a4c3a3d3ff83c382a87442 Mon Sep 17 00:00:00 2001 From: Jeanie Date: Sun, 22 Dec 2024 21:10:37 +0900 Subject: [PATCH 06/10] first half of images --- docs/images/graphics-server/boot_logo.png | Bin 0 -> 12248 bytes docs/images/graphics-server/circle.png | Bin 0 -> 8208 bytes docs/images/graphics-server/line.png | Bin 0 -> 6842 bytes docs/images/graphics-server/rectangle.png | Bin 0 -> 10318 bytes .../graphics-server/rounded_rectangle.png | Bin 0 -> 6181 bytes docs/images/graphics-server/sleepscreen.png | Bin 0 -> 17302 bytes docs/images/graphics-server/textview.png | Bin 0 -> 7124 bytes services/graphics-server/src/lib.rs | 6 +++--- 8 files changed, 3 insertions(+), 3 deletions(-) create mode 100644 docs/images/graphics-server/boot_logo.png create mode 100644 docs/images/graphics-server/circle.png create mode 100644 docs/images/graphics-server/line.png create mode 100644 docs/images/graphics-server/rectangle.png create mode 100644 docs/images/graphics-server/rounded_rectangle.png create mode 100644 docs/images/graphics-server/sleepscreen.png create mode 100644 docs/images/graphics-server/textview.png diff --git a/docs/images/graphics-server/boot_logo.png b/docs/images/graphics-server/boot_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..ed2afc5eb148ff107d3bc9e2dc86d611b053a57b GIT binary patch literal 12248 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 R^fbPVqn)#D&3V83{{pNny=(vg literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/circle.png b/docs/images/graphics-server/circle.png new file mode 100644 index 0000000000000000000000000000000000000000..4cc422d1ce85cb03bfb4d1aed767e5fa7cd699ee GIT binary patch literal 8208 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 Ss=)tE(1EXy>|^c;{{F9)_{Dnw literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/rectangle.png b/docs/images/graphics-server/rectangle.png new file mode 100644 index 0000000000000000000000000000000000000000..2ca6ded60be139707864a447e301944ecac3f59a GIT binary patch literal 10318 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�ZDi+^K5H2_B^7Mu%Jca{I)52;s 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 Date: Sun, 22 Dec 2024 21:56:17 +0900 Subject: [PATCH 07/10] a few more drawings --- .../images/graphics-server/circle_clipped.png | Bin 0 -> 6781 bytes docs/images/graphics-server/line_clipped.png | Bin 0 -> 6483 bytes .../graphics-server/line_clipped_xor.png | Bin 0 -> 6710 bytes .../graphics-server/object_list_clipped.png | Bin 0 -> 7361 bytes .../graphics-server/rectangle_clipped.png | Bin 0 -> 7515 bytes .../rounded_rectangle_clipped.png | Bin 0 -> 6007 bytes docs/images/graphics-server/selftest.png | Bin 0 -> 9339 bytes services/graphics-server/src/lib.rs | 31 ++++++++++-------- 8 files changed, 17 insertions(+), 14 deletions(-) create mode 100644 docs/images/graphics-server/circle_clipped.png create mode 100644 docs/images/graphics-server/line_clipped.png create mode 100644 docs/images/graphics-server/line_clipped_xor.png create mode 100644 docs/images/graphics-server/object_list_clipped.png create mode 100644 docs/images/graphics-server/rectangle_clipped.png create mode 100644 docs/images/graphics-server/rounded_rectangle_clipped.png create mode 100644 docs/images/graphics-server/selftest.png diff --git a/docs/images/graphics-server/circle_clipped.png b/docs/images/graphics-server/circle_clipped.png new file mode 100644 index 0000000000000000000000000000000000000000..b7ad2a98e2e590be86f493991f4571f55e59f996 GIT binary patch literal 6781 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 literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/line_clipped_xor.png b/docs/images/graphics-server/line_clipped_xor.png new file mode 100644 index 0000000000000000000000000000000000000000..dd3e80ed5fbf044b8fd648c7528db3a1191b23e3 GIT binary patch literal 6710 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 Q?s}jD`;hLmy#ZJM9XbiJ0RR91 literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/object_list_clipped.png b/docs/images/graphics-server/object_list_clipped.png new file mode 100644 index 0000000000000000000000000000000000000000..f93ffb4d1d1abaec00c56ccec861a4161335de7d GIT binary patch literal 7361 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 literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/rectangle_clipped.png b/docs/images/graphics-server/rectangle_clipped.png new file mode 100644 index 0000000000000000000000000000000000000000..6d364f4525b6e8b813ba785887de646d8ce20e82 GIT binary patch literal 7515 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 bWR(GSS80>gnMYYHh=RP1`Wzu14!!+f4f&mf literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/rounded_rectangle_clipped.png b/docs/images/graphics-server/rounded_rectangle_clipped.png new file mode 100644 index 0000000000000000000000000000000000000000..ce1afa5d6ee5b3531db77bbc876e66caceb04f02 GIT binary patch literal 6007 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 OffGlakCY$wzx+=vdj>rK literal 0 HcmV?d00001 diff --git a/docs/images/graphics-server/selftest.png b/docs/images/graphics-server/selftest.png new file mode 100644 index 0000000000000000000000000000000000000000..bf0308bc70145f395224d38bee390cca7b83f686 GIT binary patch literal 9339 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 literal 0 HcmV?d00001 diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 6b59f03e1..8d852f802 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -322,7 +322,7 @@ impl Gfx { /// `Rectangle` clip area. /// ///

- /// Example Image + /// Example Image - clipped line with clipping area represented by light rectangle. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/line_clipped.png?raw=true) /// @@ -350,7 +350,8 @@ impl Gfx { /// `Rectangle` clip area using XOR mode. /// ///
- /// Example Image + /// Example Image - line clipped by area represented by dark rectangle. Light inner + /// rectangle added to show XOR behavior. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/line_clipped_xor.png?raw=true) /// ///
@@ -376,7 +377,7 @@ impl Gfx { /// specified `Rectangle` clip area. /// ///
- /// Example Image + /// Example Image - circle clipped by area represented by dark rectangle. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/circle_clipped.png?raw=true) /// @@ -386,8 +387,8 @@ impl Gfx { /// ``` /// use graphics_server::{Circle, Gfx, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let circ = Circle::new(Point::new(50, 50), 25); - /// let clip = Rectangle::new(Point::new(10, 10), Point::new(60, 60)); + /// let circ = Circle::new(Point::new(130, 130), 25); + /// let clip = Rectangle::new(Point::new(110, 110), Point::new(190, 190)); /// gfx.draw_circle_clipped(circ, clip).unwrap(); /// gfx.flush().unwrap(); /// ``` @@ -403,7 +404,7 @@ impl Gfx { /// within the specified `ClipRect` clip area. /// ///
- /// Example Image + /// Example Image - rectangle clipped by area represented by light rectangle. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rectangle_clipped.png?raw=true) /// @@ -413,8 +414,8 @@ impl Gfx { /// ``` /// use graphics_server::{Gfx, Point, Rectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let rect = Rectangle::new(Point::new(10, 10), Point::new(50, 50)); - /// let clip = Rectangle::new(Point::new(0, 0), Point::new(60, 60)); + /// let rect = Rectangle::new(Point::new(100, 100), Point::new(160, 160)); + /// let clip = Rectangle::new(Point::new(110, 110), Point::new(190, 190)); /// gfx.draw_rectangle_clipped(rect, clip).unwrap(); /// gfx.flush().unwrap(); /// ``` @@ -430,7 +431,8 @@ impl Gfx { /// within the specified `ClipRect` clip area. /// ///
- /// Example Image + /// Example Image - rounded rectangle clipped by area represented by light + /// rectangle. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/rounded_rectangle_clipped.png?raw=true) /// @@ -440,7 +442,7 @@ impl Gfx { /// ``` /// use graphics_server::{Gfx, Point, Rectangle, RoundedRectangle}; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); - /// let rr = RoundedRectangle::new(Rectangle::new(Point::new(10, 10), Point::new(50, 50)), 5); + /// let rr = RoundedRectangle::new(Rectangle::new(Point::new(100, 100), Point::new(160, 160)), 8); /// let clip = Rectangle::new(Point::new(0, 0), Point::new(100, 100)); /// gfx.draw_rounded_rectangle_clipped(rr, clip).unwrap(); /// gfx.flush().unwrap(); @@ -469,7 +471,8 @@ impl Gfx { /// within the specified `ClipRect` clip area. /// ///
- /// Example Image + /// Example Image - two objects, a line and a circle, each with their own clipping areas + /// represented by light rectangles. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/object_list_clipped.png?raw=true) /// @@ -488,8 +491,8 @@ impl Gfx { /// /// // Create and add the second object (a circle) /// let circle = Circle::new(Point::new(150, 150), 25); - /// let clip2 = Rectangle::new(Point::new(20, 20), Point::new(400, 400)); - /// object_list.push(ClipObjectType::Circ(line2), clip2); + /// let clip2 = Rectangle::new(Point::new(140, 100), Point::new(190, 190)); + /// object_list.push(ClipObjectType::Circ(circle), clip2); /// /// gfx.draw_object_list_clipped(object_list).unwrap(); /// gfx.flush().unwrap(); @@ -561,7 +564,7 @@ impl Gfx { /// duration. The test pattern is typically used to verify the functionality of the graphics hardware. /// ///
- /// Example Image + /// Example Image - selftest in progress. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/selftest.png?raw=true) /// From 9e888252c164fa7b42f5089138ff888c3d687339 Mon Sep 17 00:00:00 2001 From: Jeanie Date: Tue, 24 Dec 2024 00:10:32 +0900 Subject: [PATCH 08/10] note for stash method, a few other updates --- services/graphics-server/src/lib.rs | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 8d852f802..113b42a0b 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -593,6 +593,8 @@ impl Gfx { /// If `blocking` is `true`, the function will wait until the graphics server confirms that the state /// has been stashed, otherwise it will return immediately without waiting for confirmation. /// + /// NOTE: the top 34 lines will not be stashed, as this is the area where the status bar is drawn. + /// /// # Example /// ``` /// use graphics_server::Gfx; @@ -620,13 +622,6 @@ impl Gfx { /// The stashed state can be restored using this function after it has been saved using the `stash` /// function. This is useful for reverting to a previous state after making temporary changes. /// - ///
- /// Example Image - /// - /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/pop.png?raw=true) - /// - ///
- /// /// # Example /// ``` /// use graphics_server::{DrawStyle, Gfx, Line, PixelColor, Point, Rectangle}; @@ -647,10 +642,10 @@ impl Gfx { /// /// // Clear the screen /// let screensize = gfx.screen_size().expect("Couldn't get screen size"); - /// let blackout = Rectangle::new_with_style( + /// let whiteout = Rectangle::new_with_style( /// Point::new(0, 0), /// screensize, - /// DrawStyle::new(PixelColor::Dark, PixelColor::Dark, 1), + /// DrawStyle::new(PixelColor::Light, PixelColor::Light, 1), /// ); /// gfx.draw_rectangle(blackout).unwrap(); /// gfx.flush().unwrap(); From f8bce54bd0742f11fc0aaa83b17b2a8103c995bf Mon Sep 17 00:00:00 2001 From: Jeanie Date: Tue, 24 Dec 2024 00:36:19 +0900 Subject: [PATCH 09/10] fix circle docs typo --- services/graphics-server/src/lib.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 113b42a0b..8a3002488 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -377,7 +377,7 @@ impl Gfx { /// specified `Rectangle` clip area. /// ///
- /// Example Image - circle clipped by area represented by dark rectangle. + /// Example Image - circle clipped by area represented by light rectangle. /// /// ![Example Image](https://github.com/betrusted-io/xous-core/blob/main/docs/images/graphics-server/circle_clipped.png?raw=true) /// From e1ff04b1fcda8623ed67d41d420e3cad9425f4ed Mon Sep 17 00:00:00 2001 From: Jeanie Date: Tue, 24 Dec 2024 00:39:06 +0900 Subject: [PATCH 10/10] fix set_devboot docs --- services/graphics-server/src/lib.rs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/services/graphics-server/src/lib.rs b/services/graphics-server/src/lib.rs index 8a3002488..ec7aee79e 100644 --- a/services/graphics-server/src/lib.rs +++ b/services/graphics-server/src/lib.rs @@ -510,12 +510,14 @@ impl Gfx { /// status bar, so there is an obvious indicator that the kernel has yet to be self-signed. Self-signed /// kernels do not have this signature. /// + /// NOTE: This call is a one-way operation. Once the developer boot mode is enabled, it cannot be + /// disabled. + /// /// # Example /// ``` /// use graphics_server::Gfx; /// let gfx = Gfx::new(&xous_names::XousNames::new().unwrap()).unwrap(); /// gfx.set_devboot(true); // Enable developer boot mode - /// gfx.set_devboot(false); // Disable developer boot mode /// ``` pub fn set_devboot(&self, enable: bool) -> Result<(), xous::Error> { let ena = if enable { 1 } else { 0 };