Struct AvatarBuilder 

pub struct AvatarBuilder<'a, T> { /* private fields */ }

Fluent high-level API for common avatar rendering paths.

The builder is additive over the lower-level free functions. It stores validation failures and returns them from render/encode methods, so invalid size or namespace input remains non-panicking.

Implementations

impl<T> AvatarBuilder<'static, T>

pub fn for_id(id: T) -> Self

Starts a builder for an identity input.

impl<'a, T> AvatarBuilder<'a, T>

pub fn spec(self, spec: AvatarSpec) -> Self

Uses an already validated avatar specification.

pub fn size(self, width: u32, height: u32) -> Self

Sets the avatar dimensions while preserving the current style variant seed when possible.

pub fn style_variant(self, seed: u64) -> Self

Sets the caller-controlled style variant seed.

The seed is mixed into the identity-derived renderer RNG. It is useful when an application wants a second deterministic variant for the same identity without changing tenant or namespace style-version values.

pub fn seed(self, seed: u64) -> Self

Alias for AvatarBuilder::style_variant.

pub fn namespace<'b>( self, tenant: &'b str, style_version: &'b str, ) -> AvatarBuilder<'b, T>

Sets the identity namespace used for tenant isolation and visual rollout control.

pub fn automatic_style(self) -> Self

Uses automatic style derivation from distinct identity digest bytes.

pub fn style(self, style: AvatarStyleOptions) -> Self

pub fn options(self, options: AvatarOptions) -> Self

pub fn kind(self, kind: AvatarKind) -> Self

pub fn background(self, background: AvatarBackground) -> Self

pub fn accessory(self, accessory: AvatarAccessory) -> Self

pub fn color(self, color: AvatarColor) -> Self

pub fn expression(self, expression: AvatarExpression) -> Self

pub fn shape(self, shape: AvatarShape) -> Self

impl<'a, T: AsRef<[u8]>> AvatarBuilder<'a, T>

pub fn identity(&self) -> Result<AvatarIdentity, AvatarError>

pub fn cache_key(&self) -> Result<String, AvatarError>

pub fn render(self) -> Result<RgbaImage, AvatarError>

pub fn render_svg(self) -> Result<String, AvatarError>

pub fn encode(self, format: AvatarOutputFormat) -> Result<Vec<u8>, AvatarError>

Trait Implementations

impl<'a, T: Clone> Clone for AvatarBuilder<'a, T>

fn clone(&self) -> AvatarBuilder<'a, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for AvatarBuilder<'_, T>

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

Formats the value using the given formatter.