Struct Pixfmt 

pub struct Pixfmt<T> { /* private fields */ }

Pixel Format Wrapper around raw pixel component data

Implementations

impl<T> Pixfmt<T>

where Pixfmt<T>: PixelDraw,

pub fn new(width: usize, height: usize) -> Self

Create new Pixel Format of width * height * bpp

Allocates memory of width * height * bpp

pub fn size(&self) -> usize

Size of Rendering Buffer in bytes; width * height * bpp

pub fn clear(&mut self)

Clear the Image

All color components are set to 255, including alpha if present

use agg::{Source,Pixfmt,Rgb8,Rgba8};

// Pixfmt with Rgb8, not Alpha Component
let mut pix = Pixfmt::<Rgb8>::new(2,2);
pix.clear();
let empty = Rgba8 { r:255, g:255, b:255, a:255};
assert_eq!(pix.get((0,0)), empty);
assert_eq!(pix.get((0,1)), empty);
assert_eq!(pix.get((1,0)), empty);
assert_eq!(pix.get((1,1)), empty);

// Pixfmt with Rgba8, including Alpha Component
let mut pix = Pixfmt::<Rgb8>::new(2,2);
pix.clear();
let empty = Rgba8 { r:255, g:255, b:255, a:255};
assert_eq!(pix.get((0,0)), empty);
assert_eq!(pix.get((0,1)), empty);
assert_eq!(pix.get((1,0)), empty);
assert_eq!(pix.get((1,1)), empty);

pub fn copy_pixel<C: Color>(&mut self, x: usize, y: usize, c: C)

Copies the Color c to pixel at (x,y)

Locations outside of the region are igorned

use agg::{Source,Pixfmt,Rgba8};

let mut pix = Pixfmt::<Rgba8>::new(1,2);
let black = Rgba8::black();
pix.copy_pixel(0,1, black);
assert_eq!(pix.get((0,0)), Rgba8{r:0, g:0, b:0, a:0});
assert_eq!(pix.get((0,1)), black);

pix.copy_pixel(10,10, black); // Ignored, outside of range

pub fn copy_hline<C: Color>(&mut self, x: usize, y: usize, n: usize, c: C)

Copies the Color c to pixels from (x,y) to (x+n-1,y)

Locations outside of the region are ignored

use agg::{Source,Pixfmt,Rgb8,Rgba8};

let mut pix = Pixfmt::<Rgb8>::new(10,1);
let black = Rgba8::black();
pix.copy_hline(0,0,10, black);
assert_eq!(pix.get((0,0)), black);
assert_eq!(pix.get((1,0)), black);
assert_eq!(pix.get((9,0)), black);

pix.copy_hline(1,1,10, black); // Ignored, outside of range

pub fn copy_vline<C: Color>(&mut self, x: usize, y: usize, n: usize, c: C)

Copies the Color c to pixels from (x,y) to (x,y+n-1)

Locations outside of the region are ignored

use agg::{Source,Pixfmt,Rgba8,Rgba32};

let mut pix = Pixfmt::<Rgba32>::new(1,10);
let black  = Rgba32::new(0.,0.,0.,1.);
pix.copy_vline(0,0,10, black);

let black8 = Rgba8::from_trait(black); // pix.get() returns Rgba8
assert_eq!(pix.get((0,0)), black8);
assert_eq!(pix.get((0,1)), black8);
assert_eq!(pix.get((0,9)), black8);

pix.copy_vline(1,1,10, black); // Ignored, outside of range

pub fn line_sp_aa(&mut self, x1: f64, y1: f64, x2: f64, y2: f64, c: Rgb8)

👎Deprecated since 0.1.0:

please use path_storage and friends instead

Draw a line from (x1,y1) to (x2,y2) of color c

Uses Xiaolin Wu’s line drawing algorithm which include Anti-Aliasing

pub fn line_sp(&mut self, x1: f64, y1: f64, x2: f64, y2: f64, c: Rgb8)

👎Deprecated since 0.1.0:

please use path_storage and friends instead

Draw a line from (x1,y1) to (x2,y2) of color c using a subpixel algorithm

Line is Aliased (not-anti-aliased)

pub fn line(&mut self, x1: f64, y1: f64, x2: f64, y2: f64, c: Rgb8)

👎Deprecated since 0.1.0:

please use path_storage and friends instead

Draw a line from (x1,y1) to (x2,y2) of color c

Uses Bresenham’s line drawing algorithm

impl Pixfmt<Gray8>

pub fn raw(&self, id: (usize, usize)) -> Gray8

impl Pixfmt<Rgb8>

pub fn raw(&self, id: (usize, usize)) -> Rgb8

Trait Implementations

impl<T: Debug> Debug for Pixfmt<T>

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

Formats the value using the given formatter.

impl Pixel for Pixfmt<Gray8>

fn height(&self) -> usize

Height of rendering buffer in pixels

fn width(&self) -> usize

Width of rendering buffer in pixels

fn set<C: Color>(&mut self, id: (usize, usize), c: C)

fn cover_mask() -> u64

fn bpp() -> usize

fn blend_pix<C: Color>(&mut self, id: (usize, usize), c: C, cover: u64)

impl Pixel for Pixfmt<Rgb8>

fn height(&self) -> usize

Height of rendering buffer in pixels

fn width(&self) -> usize

Width of rendering buffer in pixels

fn set<C: Color>(&mut self, id: (usize, usize), c: C)

fn bpp() -> usize

fn cover_mask() -> u64

fn blend_pix<C: Color>(&mut self, id: (usize, usize), c: C, cover: u64)

impl Pixel for Pixfmt<Rgba32>

fn height(&self) -> usize

Height of rendering buffer in pixels

fn width(&self) -> usize

Width of rendering buffer in pixels

fn set<C: Color>(&mut self, id: (usize, usize), c: C)

fn bpp() -> usize

fn cover_mask() -> u64

fn blend_pix<C: Color>(&mut self, _id: (usize, usize), _c: C, _cover: u64)

impl Pixel for Pixfmt<Rgba8>

fn height(&self) -> usize

Height of rendering buffer in pixels

fn width(&self) -> usize

Width of rendering buffer in pixels

fn bpp() -> usize

fn cover_mask() -> u64

fn set<C: Color>(&mut self, id: (usize, usize), c: C)

fn blend_pix<C: Color>(&mut self, id: (usize, usize), c: C, cover: u64)

impl Pixel for Pixfmt<Rgba8pre>

fn height(&self) -> usize

Height of rendering buffer in pixels

fn width(&self) -> usize

Width of rendering buffer in pixels

fn set<C: Color>(&mut self, id: (usize, usize), c: C)

fn bpp() -> usize

fn cover_mask() -> u64

fn blend_pix<C: Color>(&mut self, id: (usize, usize), c: C, cover: u64)

impl<T> PixelData for Pixfmt<T>

Access Pixeldata from a Pixfmt

fn pixeldata(&self) -> &[u8]

impl<T> PixelDraw for Pixfmt<T>

where Pixfmt<T>: Pixel,

fn fill<C: Color>(&mut self, color: C)

Fill the data with the specified color

fn copy_or_blend_pix<C: Color>(&mut self, id: (usize, usize), color: C)

Copy or blend a pixel at id with color

fn copy_or_blend_pix_with_cover<C: Color>( &mut self, id: (usize, usize), color: C, cover: u64, )

Copy or blend a pixel at id with color and a cover

fn blend_hline<C: Color>( &mut self, x: i64, y: i64, len: i64, color: C, cover: u64, )

Copy or Blend a single color from (x,y) to (x+len-1,y) with cover

fn blend_solid_hspan<C: Color>( &mut self, x: i64, y: i64, len: i64, color: C, covers: &[u64], )

Blend a single color from (x,y) to (x+len-1,y) with collection of covers

fn blend_vline<C: Color>(&mut self, x: i64, y: i64, len: i64, c: C, cover: u64)

Copy or Blend a single color from (x,y) to (x,y+len-1) with cover

fn blend_solid_vspan<C: Color>( &mut self, x: i64, y: i64, len: i64, c: C, covers: &[u64], )

Blend a single color from (x,y) to (x,y+len-1) with collection of covers

fn blend_color_hspan<C: Color>( &mut self, x: i64, y: i64, len: i64, colors: &[C], covers: &[u64], cover: u64, )

Blend a collection of colors from (x,y) to (x+len-1,y) with either a collection of covers or a single cover

fn blend_color_vspan<C: Color>( &mut self, x: i64, y: i64, len: i64, colors: &[C], covers: &[u64], cover: u64, )

Blend a collection of colors from (x,y) to (x,y+len-1) with either a collection of covers or a single cover

impl Source for Pixfmt<Rgb8>

fn get(&self, id: (usize, usize)) -> Rgba8

impl Source for Pixfmt<Rgba32>

fn get(&self, id: (usize, usize)) -> Rgba8

impl Source for Pixfmt<Rgba8>

fn get(&self, id: (usize, usize)) -> Rgba8

impl Source for Pixfmt<Rgba8pre>

fn get(&self, id: (usize, usize)) -> Rgba8