Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

146 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

agrega

Crate API MSRV: 1.82.0
Code Documentation Files

A Rust port of Anti-Grain Geometry.

A High Fidelity and Quality 2D Graphics Rendering Engine

Example

Little Black Triangle

use agrega::{
  Pixfmt, RasterizerScanline, Render, RenderingBase, RenderingScanlineAASolid,
  Rgb8, Rgba8, render_scanlines
};

// Create a blank image 10x10 pixels
let pix = Pixfmt::<Rgb8>::new(100, 100);
let mut ren_base = RenderingBase::new(pix);
ren_base.clear(Rgba8::white());

// Draw a polygon from (10,10) - (50,90) - (90,10)
let mut ras = RasterizerScanline::new();
ras.move_to(10.0, 10.0);
ras.line_to(50.0, 90.0);
ras.line_to(90.0, 10.0);

// Render the line to the image
let mut ren = RenderingScanlineAASolid::with_base(&mut ren_base);
ren.color(Rgba8::black());
render_scanlines(&mut ras, &mut ren);

// Save the image to a file
ren_base.to_file("tests/std/tmp/little_black_triangle.png").unwrap();

Features

  • Anti-Aliased Drawing
  • Sub-pixel Accuracy
  • Rendering of Arbitrary Polygons
  • Text/Font Rendering (with Freetype)

Complexity

Quoting the original C++ library:

Anti-Grain Geometry is not a solid graphic library and it's not very easy to use. I consider AGG as a "tool to create other tools". It means that there's no "Graphics" object or something like that, instead, AGG consists of a number of loosely coupled algorithms that can be used together or separately. All of them have well defined interfaces and absolute minimum of implicit or explicit dependencies.

License

This project is licensed under the BSD 2-Clause License. Additionally, modifications made in this Rust port are available under your choice of Apache License, Version 2.0 or the MIT License.

License Note

This Rust project is based on the agg-2.4 (2005) C++ library, which was originally licensed under a dual-license model. The prior Rust port of agg-2.4 selected the BSD 2-Clause License as its sole license, which has been retained here, alongside the Apache-2.0 and MIT licenses which apply to the new code.

About

2D Rendering and Graphics library (port of Anti-Grain Geometry)

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages