benilla-octo/crates/benilla-world/src/lib.rs

//! benilla-world: the world renderer, with no game attached. It puts things into a world and
//! answers questions about it, and knows nothing of a session, the wire, an avatar or a UI. The
//! dependency edge holds that line: this crate does not depend on `benilla-app`, and
//! `benilla-worldview` links only this crate. Above it are `benilla-app` and the two binaries;
//! below it, `benilla-assets` and `benilla-formats`.

/// Re-exported so a shim binary needs no `bevy` dependency of its own.
pub use bevy::app::AppExit;

/// Test fixtures shared with dependent crates: ordinary public code, since `#[cfg(test)]` code is
/// not compiled for a downstream crate.
pub mod testing {
    use benilla_formats::{
        CellRamp, EmitParams, EmitTiming, OverLife, ParamsNow, ParticleBlend, ParticleEmitterDef,
        ParticleShape,
    };

    /// The sampled parameters of [`particle_def`], constant so a sim test is deterministic.
    pub fn particle_params_now() -> ParamsNow {
        ParamsNow {
            emission_speed: 1.0,
            speed_variation: 0.0,
            vertical_range: 0.5,
            horizontal_range: std::f32::consts::PI,
            gravity: 0.0,
            lifespan: 1.0,
            area_length: 2.0,
            area_width: 4.0,
            z_source: 0.0,
        }
    }

    /// A minimal emitter def for kernel tests; only the fields the emit kernel reads matter.
    pub fn particle_def(shape: ParticleShape) -> ParticleEmitterDef {
        ParticleEmitterDef {
            flags: 0,
            position: [1.0, 2.0, 3.0],
            bone: 0,
            shape,
            blend: ParticleBlend::Add,
            lit: false,
            texture: None,
            tile_rows: 1,
            tile_cols: 1,
            head_tail: 0,
            timing: EmitTiming::constant(10.0),
            params: EmitParams::constant(particle_params_now()),
            drag: 0.0,
            tail_time: 0.0,
            spline: None,
            geometry_model: None,
            recursion_model: None,
            angular_velocity_min: [0.0; 3],
            angular_velocity_max: [0.0; 3],
            inherit_scale: 0.0,
            follow_speed1: 0.0,
            follow_scale1: 0.0,
            follow_speed2: 0.0,
            follow_scale2: 0.0,
            twinkle_speed: 0.0,
            twinkle_percent: 1.0,
            twinkle_min: 0.0,
            twinkle_max: 0.0,
            spin: 0.0,
            over_life: OverLife {
                mid: 0.5,
                color: [[1.0; 4]; 3],
                scale: [1.0; 3],
                head_cells: [CellRamp::new(0, 0); 2],
                tail_cells: [CellRamp::new(0, 0); 2],
                repeat: [1.0; 2],
            },
        }
    }

    /// The plain planar def most emitter tests want.
    pub fn plain_particle_def() -> ParticleEmitterDef {
        particle_def(ParticleShape::Plane)
    }

    /// A bind-pose [`crate::rig_anim::RigPose`] with one root-parented joint per entry, for tests
    /// that resolve anchors (they spawn on demand through `RigPose::anchor_for`).
    pub fn test_rig_pose(
        root: bevy::ecs::entity::Entity,
        joints: &[bevy::math::Vec3],
    ) -> crate::rig_anim::RigPose {
        let skeleton = benilla_assets::ModelSkeleton {
            joints: joints
                .iter()
                .map(|&t| benilla_assets::ModelJoint {
                    parent: -1,
                    local_translation: t,
                    billboard: None,
                    parent_arm: None,
                })
                .collect(),
            spine_bone: None,
            head_bone: None,
        };
        crate::rig_anim::RigPose::new(root, &skeleton)
    }
}

pub mod art_scope;
pub mod assets;
pub mod bgwin;
pub mod billboard;
pub mod boot;
pub mod build_id;
pub mod clouds;
pub mod clutter;
pub mod collision;
pub mod decal;
pub mod dev_state;
pub mod doodad_anim;
pub mod entity_shade;
pub mod exterior_cull;
pub mod ffx_glow;
pub mod final_pass;
pub mod frame_pace;
pub mod ground_fx;
pub mod instance_tint;
pub mod interact;
pub mod interior;
pub mod lighting;
pub mod liquid;
pub mod log_ring;

/// macOS `Cmd+Q`, re-pointed at the window close so the shutdown systems run.
pub mod mac_quit;
pub mod map_proj;
pub mod mat_anim_table;
pub mod mesh_tag;
pub mod model_fade;
pub mod model_forms;
pub mod model_render;
pub mod modkeys;
pub mod particles;
pub mod ribbons;
pub mod ride_frame;
pub mod rig_anim;
pub mod rig_palette;
pub mod rig_rider;
pub mod schedule;
mod shaders;
pub mod sky;
// MONKEY (sky): the sky quality tier and the Enhanced/High inputs.
pub mod sky_fx;
pub mod sky_order;
pub mod skybox;
// MONKEY (skybox): the skybox rig and material loops.
mod skybox_anim;
pub mod static_gx;
pub mod static_merge;
pub mod straddle;
pub mod sun;
pub mod surface;
pub mod sys_timing;
pub mod terrain_stream;
pub mod tex_filter_live;
pub mod thread_qos;
pub mod view;
pub mod vis_chain;
pub mod water_fx;
pub mod wdl;
pub mod weather;
pub mod wind; // MONKEY (wind): shared stateless gust/veer field and foliage quality gate
pub mod wmo_portal;
pub mod world_census;
pub mod world_map;
pub mod world_plugins;
pub mod world_point;
pub mod world_unit;
pub mod worldview;
pub mod zfill;