Struct AvatarRequestBuilder 

pub struct AvatarRequestBuilder { /* private fields */ }

Builder for AvatarRequest.

Explicit styles are validated strictly by default. Use AvatarRequestBuilder::legacy_v1_compatibility only when reproducing the 1.x skip-on-unsupported behavior is required during migration.

Cloning the builder clones its derived identity. Each clone is independently sanitized on drop.

Implementations

impl AvatarRequestBuilder

pub fn new(identity: AvatarIdentity) -> Self

Starts a strict request builder from an already-derived identity.

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

Replaces the request’s validated image specification.

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

Sets image dimensions while retaining the current seed.

Complete dimension validation is deferred until Self::build or Self::prepare.

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

Sets the caller-controlled deterministic style-variant seed.

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

Alias for AvatarRequestBuilder::style_variant.

pub fn automatic_style(self) -> Self

Derives the complete style from the identity during preparation.

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

Uses one complete explicit style.

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

Uses legacy kind/background options with neutral extra layers.

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

Sets the explicit avatar family.

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

Sets the explicit background.

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

Sets the explicit accessory.

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

Sets the explicit accent palette.

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

Sets the explicit expression.

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

Sets the explicit frame shape.

pub fn strict_style_validation(self) -> Self

Rejects explicit layers unsupported by the selected family.

pub fn legacy_v1_compatibility(self) -> Self

Reproduces the 1.x skip-on-unsupported style behavior.

pub fn build(self) -> Result<AvatarRequest, AvatarRequestError>

Builds the immutable request, returning any deferred spec error.

pub fn prepare(self) -> Result<PreparedAvatar, AvatarRequestError>

Builds, validates, resolves, and freezes the request.

Trait Implementations

impl Clone for AvatarRequestBuilder

fn clone(&self) -> AvatarRequestBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AvatarRequestBuilder

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

Formats the value using the given formatter.