Struct PackerConfig 

pub struct PackerConfig {

    pub max_width: u32,
    pub max_height: u32,
    pub allow_rotation: bool,
    pub force_max_dimensions: bool,
    pub border_padding: u32,
    pub texture_padding: u32,
    pub texture_extrusion: u32,
    pub trim: bool,
    pub trim_threshold: u8,
    pub texture_outlines: bool,
    pub power_of_two: bool,
    pub square: bool,
    pub use_waste_map: bool,
    pub family: AlgorithmFamily,
    pub mr_heuristic: MaxRectsHeuristic,
    pub skyline_heuristic: SkylineHeuristic,
    pub g_choice: GuillotineChoice,
    pub g_split: GuillotineSplit,
    pub auto_mode: AutoMode,
    pub sort_order: SortOrder,
    pub time_budget_ms: Option<u64>,
    pub parallel: bool,
    pub mr_reference: bool,
    pub auto_mr_ref_time_ms_threshold: Option<u64>,
    pub auto_mr_ref_input_threshold: Option<usize>,
    pub transparent_policy: TransparentPolicy,
}

Fields

max_width: u32

Maximum page width in pixels.

max_height: u32

Maximum page height in pixels.

allow_rotation: bool

Allow 90° rotations for placements where beneficial.

force_max_dimensions: bool

Force final page dimensions to be exactly max_width/max_height.

border_padding: u32

Pixels around entire page border.

texture_padding: u32

Pixels between frames.

texture_extrusion: u32

Extrude edge pixels of each frame (for sampling safety).

trim: bool

Trim transparent borders (alpha <= trim_threshold).

trim_threshold: u8

texture_outlines: bool

Draw red outlines on output pages (debug).

power_of_two: bool

Resize output page to power-of-two.

square: bool

Force output page to be square (max(width,height)).

use_waste_map: bool

Use waste map in Skyline to recover gaps

family: AlgorithmFamily

mr_heuristic: MaxRectsHeuristic

skyline_heuristic: SkylineHeuristic

g_choice: GuillotineChoice

g_split: GuillotineSplit

auto_mode: AutoMode

sort_order: SortOrder

time_budget_ms: Option<u64>

Optional time budget for auto portfolio (milliseconds). None or 0 disables.

parallel: bool

Enable parallel candidate evaluation when feature “parallel” is on.

mr_reference: bool

Use reference-accurate MaxRects split/prune (SplitFreeNode + staged prune). When false, uses a simpler but correct split/prune that may create more intermediate free rects.

auto_mr_ref_time_ms_threshold: Option<u64>

Auto-mode: enable mr_reference when time budget >= this (ms). None => use default heuristic.

auto_mr_ref_input_threshold: Option<usize>

Auto-mode: enable mr_reference when inputs >= this count. None => use default heuristic.

transparent_policy: TransparentPolicy

Policy for fully transparent images (effective when trim=true).

Implementations

impl PackerConfig

pub fn validate(&self) -> Result<()>

Validates the configuration parameters.

Returns an error if:

• Dimensions are zero or invalid
• Padding configuration would leave no usable space
• Other configuration constraints are violated

impl PackerConfig

pub fn builder() -> PackerConfigBuilder

Create a fluent builder for PackerConfig.

Trait Implementations

impl Clone for PackerConfig

fn clone(&self) -> PackerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackerConfig

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

Formats the value using the given formatter.

impl Default for PackerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PackerConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PackerConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.