Struct ShapeBuilder

pub struct ShapeBuilder { /* private fields */ }

A builder for creating complex shapes using a fluent interface.

The ShapeBuilder allows you to define the fill color, stroke, and path of a shape using method chaining. You also can get it from the Shape::builder method.

Examples

use grafo::Color;
use grafo::Stroke;
use grafo::ShapeBuilder;

let custom_shape = ShapeBuilder::new()
    .fill(Color::rgb(0, 0, 255)) // Blue fill
    .stroke(Stroke::new(3.0, Color::BLACK)) // Black stroke with width 3.0
    .begin((0.0, 0.0))
    .line_to((50.0, 10.0))
    .line_to((50.0, 50.0))
    .close()
    .build();

Implementations

impl ShapeBuilder

pub fn new() -> Self

Creates a new ShapeBuilder with default fill color (black) and stroke.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new();

pub fn fill(self, color: Color) -> Self

Sets the fill color of the shape.

Parameters

• color: The desired fill color.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::Color;
use grafo::ShapeBuilder;

let builder = ShapeBuilder::new().fill(Color::rgb(255, 0, 0)); // Red fill

pub fn stroke(self, stroke: Stroke) -> Self

Sets the stroke properties of the shape.

Parameters

• stroke: The desired stroke properties.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::Stroke;
use grafo::Color;
use grafo::ShapeBuilder;

let builder = ShapeBuilder::new().stroke(Stroke::new(2.0, Color::BLACK)); // Black stroke with width 2.0

pub fn begin(self, point: (f32, f32)) -> Self

Begin path at point

Parameters

• point: The start point of the shape.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new().begin((0.0, 0.0));

pub fn line_to(self, point: (f32, f32)) -> Self

Draws a line from the current point to the specified point.

Parameters

• point: The end point of the line.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new().begin((0.0, 0.0)).line_to((50.0, 10.0));

pub fn cubic_bezier_to( self, ctrl: (f32, f32), ctrl2: (f32, f32), to: (f32, f32), ) -> Self

Draws a cubic Bézier curve from the current point to the specified end point.

Parameters

• ctrl: The first control point.
• ctrl2: The second control point.
• to: The end point of the curve.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new()
    .begin((0.0, 0.0))
    .cubic_bezier_to((20.0, 30.0), (40.0, 30.0), (50.0, 10.0));

pub fn quadratic_bezier_to(self, ctrl: (f32, f32), to: (f32, f32)) -> Self

Draws a quadratic Bézier curve from the current point to the specified end point.

Parameters

• ctrl: The control point.
• to: The end point of the curve.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new()
    .begin((0.0, 0.0))
    .quadratic_bezier_to((25.0, 40.0), (50.0, 10.0));

pub fn close(self) -> Self

Closes the current sub-path by drawing a line back to the starting point.

Returns

The updated ShapeBuilder instance.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::new().begin((0.0, 0.0)).close();

pub fn build(self) -> Shape

Builds the Shape from the accumulated path, fill color, and stroke.

Returns

A Shape instance representing the constructed shape.

Examples

use grafo::ShapeBuilder;

let shape = ShapeBuilder::new()
    .begin((0.0, 0.0))
    .line_to((50.0, 10.0))
    .line_to((50.0, 50.0))
    .close()
    .build();

Trait Implementations

impl Clone for ShapeBuilder

fn clone(&self) -> ShapeBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for ShapeBuilder

fn default() -> Self

Creates a default ShapeBuilder with black fill and stroke.

Examples

use grafo::ShapeBuilder;

let builder = ShapeBuilder::default();

impl From<ShapeBuilder> for Shape

fn from(value: ShapeBuilder) -> Self

Converts to this type from the input type.