Struct FusionOptions 

pub struct FusionOptions {
    pub skip_fusion: bool,
    pub unfuse_elementwise_regions: bool,
    pub keep_elementwise_regions: bool,
    pub decompose_fusion_regions: bool,
    pub fk_fusion: bool,
    pub fuse_region_prologue: bool,
    pub fuse_batch_preprocess: bool,
    pub native_fk_regions: bool,
    pub fusion_limits: FusionLimits,
}

Per-target fusion toggles (env-driven on Metal today).

Fields

skip_fusion: bool

Skip all pattern fusions (Metal: RLX_METAL_NO_FUSION).

unfuse_elementwise_regions: bool

Break ElementwiseRegion back into primitives after marking.

keep_elementwise_regions: bool

Keep fused ElementwiseRegion through lowering (env: RLX_KEEP_ELEMENTWISE_REGIONS).

decompose_fusion_regions: bool

Decompose FKL-style transform / batch regions before backend lowering.

fk_fusion: bool

Run FKL passes (MarkTransformRegions, prologue, batch). Env: RLX_NO_FK_FUSION=1 disables.

fuse_region_prologue: bool

Fold ResizeNearest2x into ElementwiseRegion prologue. Env: RLX_FUSE_REGION_PROLOGUE=0 disables.

fuse_batch_preprocess: bool

Merge parallel region slices into BatchElementwiseRegion. Env: RLX_FUSE_BATCH_PREPROCESS=0 disables.

native_fk_regions: bool

Keep TransformRegion / BatchElementwiseRegion in MIR for native lowering. Env: RLX_NATIVE_FK_REGIONS=1.

fusion_limits: FusionLimits

Caps for fused elementwise chains (encoder / scratch limits).

Implementations

impl FusionOptions

pub fn from_metal_env() -> FusionOptions

Read Metal-specific env overrides.

pub fn merge_env(self) -> FusionOptions

Merge session options with compile-time env overrides.

pub fn apply_native_fk_defaults(self, target: FusionTarget) -> FusionOptions

GPU-class targets keep native FKL regions unless opted out.

pub fn for_cpu() -> FusionOptions

CPU executes element-wise chains as per-op thunks — mark then unfuse.

pub fn for_metal() -> FusionOptions

Metal keeps RMSNorm / matmul fusions but unfuses ElementwiseRegion (fused MSL mis-lowers long chains on deep transformer graphs).

pub fn for_wgpu() -> FusionOptions

wgpu region kernel only supports trailing/scalar broadcast via modulus — unfuse so LegalizeBroadcast Expand + Binary run separately.

Trait Implementations

impl Clone for FusionOptions

fn clone(&self) -> FusionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FusionOptions

impl Debug for FusionOptions

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

Formats the value using the given formatter.

impl Default for FusionOptions

fn default() -> FusionOptions

Returns the “default value” for a type.

impl Eq for FusionOptions

impl PartialEq for FusionOptions

fn eq(&self, other: &FusionOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FusionOptions