@woosh/meep-engine 3.52.0 → 3.53.0

package/src/generation/foliage/presets/make_tree_species_preset.js

@@ -0,0 +1,837 @@
+import { AnimationCurve } from "../../../engine/animation/curve/AnimationCurve.js";
+import { CrownEnvelopeType } from "../config/CrownEnvelopeType.js";
+import { FoliageCardType } from "../config/FoliageCardType.js";
+import { PhyllotaxisMode } from "../config/PhyllotaxisMode.js";
+import { TreePreset } from "../config/TreePreset.js";
+import { TreeSpeciesConfig } from "../config/TreeSpeciesConfig.js";
+
+/**
+ * Returns a rich, botanically tuned `TreeSpeciesConfig` for one of the 9 built-in
+ * `TreePreset` archetypes (`Oak`, `Pine`, `Birch`, `Willow`, `Maple`, `Spruce`, `Palm`, `Shrub`, `Fern`),
+ * with optional deep parameter overrides.
+ *
+ * @param {TreePreset|string} [preset=TreePreset.Oak]
+ * @param {Object} [overrides]
+ * @returns {TreeSpeciesConfig}
+ */
+export function make_tree_species_preset(preset = TreePreset.Oak, overrides = {}) {
+    const config = new TreeSpeciesConfig();
+    const key = typeof preset === "string" ? preset.toLowerCase() : TreePreset.Oak;
+
+    switch (key) {
+        case TreePreset.Pine: {
+            config.name = "pine";
+            config.preset = TreePreset.Pine;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Conical,
+                height: 10.5,
+                radius: 4.4,
+                base_height: 2.2,
+                prune_ratio: 0.25,
+                space_colonization_weight: 0.08,
+                pipe_model_exponent: 2.4,
+                pipe_model_weight: 0.55,
+                sky_phototropism_mix: 0.35
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 12,
+                    radial_segments_max: 14,
+                    radial_segments_min: 8,
+                    length: 11.2,
+                    length_variance: 0.05,
+                    radius_ratio: 0.038,
+                    taper: 0.88,
+                    bare_length_ratio: 0.24,
+                    child_count: 26,
+                    phyllotaxis_mode: PhyllotaxisMode.Whorled,
+                    whorl_count: 4,
+                    azimuth_jitter: 0.16,
+                    insertion_angle: 1.34,
+                    insertion_angle_variation: 0.10,
+                    insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.68),
+                    curvature: 0.16,
+                    curve_back: -0.10,
+                    spiral_twist: 0.22,
+                    gravitropism: -0.06,
+                    phototropism: 0.10,
+                    gnarl_strength: 0.09,
+                    gnarl_frequency: 0.32,
+                    basal_lean: 0.015,
+                    nodal_kink_strength: 0.18,
+                    internode_zigzag: 0.04,
+                    kink_sharpness: 0.48,
+                    bark_displacement: 0.08,
+                    parent_collar_bulge: 0.26,
+                    knot_count: 6,
+                    knot_strength: 0.16,
+                    split_probability: 0.0,
+                    flare_amplitude: 0.28,
+                    flare_height_ratio: 0.15,
+                    flare_lobes: 4,
+                    flare_sharpness: 3.0,
+                    flute_amplitude: 0.015,
+                    flute_frequency: 3,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 7,
+                    radial_segments_max: 7,
+                    radial_segments_min: 4,
+                    length: 4.2,
+                    length_variance: 0.12,
+                    length_profile: AnimationCurve.linear(0, 1.0, 1, 0.28),
+                    radius_ratio: 0.035,
+                    taper: 0.85,
+                    bare_length_ratio: 0.12,
+                    child_count: 7,
+                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+                    azimuth_jitter: 0.16,
+                    insertion_angle: 0.88,
+                    insertion_angle_variation: 0.12,
+                    curvature: 0.22,
+                    curve_back: -0.16,
+                    gravitropism: 0.22,
+                    phototropism: 0.18,
+                    gnarl_strength: 0.16,
+                    nodal_kink_strength: 0.55,
+                    internode_zigzag: 0.11,
+                    kink_sharpness: 0.55,
+                    tip_upcurl: 0.36,
+                    oval_eccentricity: 0.16,
+                    bark_displacement: 0.06,
+                    knot_count: 2,
+                    knot_strength: 0.12,
+                    collar_weld_rings: 2
+                },
+                {
+                    level: 2,
+                    segments: 5,
+                    radial_segments_max: 5,
+                    radial_segments_min: 3,
+                    length: 1.5,
+                    length_variance: 0.15,
+                    length_profile: AnimationCurve.linear(0, 0.95, 1, 0.45),
+                    radius_ratio: 0.032,
+                    taper: 0.85,
+                    bare_length_ratio: 0.08,
+                    child_count: 0,
+                    insertion_angle: 0.78,
+                    curvature: 0.16,
+                    gravitropism: 0.08,
+                    phototropism: 0.24,
+                    gnarl_strength: 0.14,
+                    internode_zigzag: 0.14,
+                    tip_upcurl: 0.32,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.TriStarCluster,
+                attach_min_level: 1,
+                cards_per_branch: 8,
+                terminal_rosette_count: 3,
+                bare_ratio: 0.18,
+                phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+                card_width: 0.82,
+                card_length: 0.88,
+                phototropism: 0.45,
+                gravitropism: 0.12
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "plated",
+                primary_color: [0.39, 0.28, 0.21],
+                secondary_color: [0.14, 0.11, 0.09],
+                inner_bark_color: [0.46, 0.31, 0.21],
+                fissure_frequency: 6,
+                fissure_depth: 0.76,
+                plate_terrace: 0.52,
+                knot_amount: 0.45,
+                roughness: 0.90
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.13, 0.32, 0.14],
+                secondary_color: [0.08, 0.22, 0.09],
+                leaf_shape: "needle",
+                leaflets_per_cluster: 9,
+                roughness: 0.55
+            });
+            break;
+        }
+
+        case TreePreset.Birch: {
+            config.name = "birch";
+            config.preset = TreePreset.Birch;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Flame,
+                height: 12.5,
+                radius: 3.4,
+                base_height: 2.5,
+                prune_ratio: 0.3,
+                space_colonization_weight: 0.25,
+                pipe_model_exponent: 2.15,
+                pipe_model_weight: 0.6
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 12,
+                    radial_segments_max: 14,
+                    radial_segments_min: 8,
+                    length: 11.5,
+                    length_variance: 0.08,
+                    radius_ratio: 0.032,
+                    taper: 0.86,
+                    bare_length_ratio: 0.24,
+                    child_count: 12,
+                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+                    insertion_angle: 0.58,
+                    insertion_angle_variation: 0.14,
+                    curvature: 0.32,
+                    curve_back: -0.22,
+                    spiral_twist: 0.28,
+                    gravitropism: -0.06,
+                    phototropism: 0.20,
+                    gnarl_strength: 0.15,
+                    gnarl_frequency: 0.36,
+                    basal_lean: 0.04,
+                    nodal_kink_strength: 0.48,
+                    internode_zigzag: 0.07,
+                    kink_sharpness: 0.62,
+                    bark_displacement: 0.075,
+                    parent_collar_bulge: 0.30,
+                    knot_count: 6,
+                    knot_strength: 0.16,
+                    split_probability: 0.28,
+                    split_count: 2,
+                    split_angle: 0.38,
+                    flare_amplitude: 0.24,
+                    flare_height_ratio: 0.15,
+                    flare_lobes: 4,
+                    flute_amplitude: 0.010,
+                    flute_frequency: 3,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 8,
+                    radial_segments_max: 7,
+                    radial_segments_min: 4,
+                    length: 3.6,
+                    length_variance: 0.15,
+                    length_profile: AnimationCurve.linear(0, 0.85, 1, 0.45),
+                    radius_ratio: 0.034,
+                    taper: 0.86,
+                    bare_length_ratio: 0.15,
+                    child_count: 6,
+                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+                    insertion_angle: 0.58,
+                    curvature: 0.28,
+                    curve_back: -0.18,
+                    gravitropism: 0.22,
+                    phototropism: 0.24,
+                    gnarl_strength: 0.20,
+                    nodal_kink_strength: 0.72,
+                    internode_zigzag: 0.15,
+                    kink_sharpness: 0.65,
+                    tip_upcurl: 0.20,
+                    oval_eccentricity: 0.15,
+                    bark_displacement: 0.06,
+                    knot_count: 3,
+                    knot_strength: 0.14,
+                    collar_weld_rings: 2
+                },
+                {
+                    level: 2,
+                    segments: 6,
+                    radial_segments_max: 5,
+                    radial_segments_min: 3,
+                    length: 1.7,
+                    length_variance: 0.18,
+                    radius_ratio: 0.028,
+                    taper: 0.9,
+                    bare_length_ratio: 0.1,
+                    child_count: 0,
+                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+                    insertion_angle: 0.52,
+                    curvature: 0.32,
+                    gravitropism: 0.42,
+                    phototropism: 0.12,
+                    gnarl_strength: 0.18,
+                    internode_zigzag: 0.18,
+                    kink_sharpness: 0.58,
+                    tip_upcurl: 0.06,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.FoldedVCard,
+                attach_min_level: 1,
+                cards_per_branch: 8,
+                terminal_rosette_count: 3,
+                card_width: 0.75,
+                card_length: 0.85,
+                fold_angle: 0.24,
+                gravitropism: 0.35,
+                phototropism: 0.55
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "birch",
+                primary_color: [0.85, 0.83, 0.80],
+                secondary_color: [0.17, 0.16, 0.15],
+                inner_bark_color: [0.52, 0.35, 0.23],
+                moss_color: [0.24, 0.30, 0.19],
+                moss_amount: 0.04,
+                fissure_frequency: 4,
+                fissure_depth: 0.62,
+                lenticel_amount: 0.78,
+                peel_amount: 0.35,
+                knot_amount: 0.58,
+                roughness: 0.88
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.32, 0.52, 0.18],
+                secondary_color: [0.22, 0.40, 0.12],
+                leaf_shape: "serrated",
+                leaflets_per_cluster: 5,
+                roughness: 0.52
+            });
+            break;
+        }
+
+        case TreePreset.Willow: {
+            config.name = "willow";
+            config.preset = TreePreset.Willow;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Weeping,
+                height: 11.0,
+                radius: 5.5,
+                base_height: 1.6,
+                prune_ratio: 0.2,
+                space_colonization_weight: 0.2,
+                pipe_model_exponent: 2.25,
+                pipe_model_weight: 0.65
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 11,
+                    radial_segments_max: 13,
+                    radial_segments_min: 7,
+                    length: 7.5,
+                    radius_ratio: 0.065,
+                    taper: 0.75,
+                    bare_length_ratio: 0.25,
+                    child_count: 9,
+                    insertion_angle: 0.68,
+                    curvature: 0.32,
+                    curve_back: -0.18,
+                    spiral_twist: 0.38,
+                    gravitropism: -0.05,
+                    phototropism: 0.15,
+                    gnarl_strength: 0.18,
+                    basal_lean: 0.05,
+                    nodal_kink_strength: 0.55,
+                    internode_zigzag: 0.08,
+                    kink_sharpness: 0.65,
+                    bark_displacement: 0.11,
+                    parent_collar_bulge: 0.35,
+                    knot_count: 6,
+                    knot_strength: 0.20,
+                    split_probability: 0.35,
+                    split_count: 2,
+                    split_angle: 0.52,
+                    flare_amplitude: 0.38,
+                    flare_lobes: 5,
+                    flute_amplitude: 0.055,
+                    flute_frequency: 5,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 8,
+                    radial_segments_max: 8,
+                    radial_segments_min: 4,
+                    length: 4.8,
+                    radius_ratio: 0.042,
+                    taper: 0.84,
+                    bare_length_ratio: 0.15,
+                    child_count: 9,
+                    insertion_angle: 0.65,
+                    curvature: 0.38,
+                    curve_back: -0.15,
+                    gravitropism: 0.32,
+                    phototropism: 0.22,
+                    gnarl_strength: 0.22,
+                    nodal_kink_strength: 0.72,
+                    internode_zigzag: 0.14,
+                    kink_sharpness: 0.60,
+                    tip_upcurl: 0.10,
+                    oval_eccentricity: 0.18,
+                    bark_displacement: 0.08,
+                    knot_count: 3,
+                    knot_strength: 0.15,
+                    collar_weld_rings: 2
+                },
+                {
+                    level: 2,
+                    segments: 8,
+                    radial_segments_max: 4,
+                    radial_segments_min: 3,
+                    length: 3.4,
+                    radius_ratio: 0.02,
+                    taper: 0.92,
+                    bare_length_ratio: 0.08,
+                    child_count: 0,
+                    insertion_angle: 0.55,
+                    curvature: 0.45,
+                    gravitropism: 0.88,
+                    phototropism: 0.04,
+                    gnarl_strength: 0.12,
+                    internode_zigzag: 0.09,
+                    kink_sharpness: 0.25,
+                    tip_upcurl: 0.0,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.RibbedFrond,
+                attach_min_level: 2,
+                cards_per_branch: 9,
+                terminal_rosette_count: 2,
+                card_width: 0.55,
+                card_length: 1.35,
+                arch_height: 0.12,
+                camber_droop: 0.28,
+                frond_segments: 5,
+                gravitropism: 0.72,
+                phototropism: 0.25
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "fissured",
+                primary_color: [0.35, 0.32, 0.27],
+                secondary_color: [0.15, 0.13, 0.11],
+                inner_bark_color: [0.39, 0.32, 0.25],
+                fissure_frequency: 8,
+                fissure_depth: 0.76,
+                roughness: 0.91
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.34, 0.50, 0.20],
+                secondary_color: [0.24, 0.38, 0.14],
+                leaf_shape: "frond",
+                leaflets_per_cluster: 9
+            });
+            break;
+        }
+
+        case TreePreset.Maple: {
+            config.name = "maple";
+            config.preset = TreePreset.Maple;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Spherical,
+                height: 11.5,
+                radius: 4.8,
+                base_height: 2.2,
+                prune_ratio: 0.35,
+                space_colonization_weight: 0.3,
+                pipe_model_exponent: 2.25,
+                pipe_model_weight: 0.65
+            });
+            config.levels[0].applyOverrides({
+                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+                child_count: 10,
+                flare_amplitude: 0.3,
+                flare_lobes: 5
+            });
+            config.levels[1].applyOverrides({
+                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+                child_count: 8,
+                insertion_angle: 0.68
+            });
+            config.levels[2].applyOverrides({
+                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate
+            });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.OctagonalCutoutHull,
+                attach_min_level: 1,
+                cards_per_branch: 8,
+                terminal_rosette_count: 3,
+                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+                card_width: 0.9,
+                card_length: 0.95,
+                fold_angle: 0.25
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "fissured",
+                primary_color: [0.36, 0.34, 0.31],
+                secondary_color: [0.16, 0.15, 0.14],
+                inner_bark_color: [0.38, 0.32, 0.27],
+                fissure_frequency: 7,
+                fissure_depth: 0.66,
+                roughness: 0.90
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.24, 0.45, 0.15],
+                secondary_color: [0.42, 0.28, 0.12],
+                autumn_tint: 0.22,
+                leaf_shape: "palmate",
+                leaflets_per_cluster: 5
+            });
+            break;
+        }
+
+        case TreePreset.Spruce: {
+            config.name = "spruce";
+            config.preset = TreePreset.Spruce;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Conical,
+                height: 11.5,
+                radius: 3.8,
+                base_height: 1.4,
+                prune_ratio: 0.3,
+                space_colonization_weight: 0.08,
+                pipe_model_exponent: 2.45,
+                pipe_model_weight: 0.55,
+                sky_phototropism_mix: 0.3
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 10,
+                    radial_segments_max: 10,
+                    radial_segments_min: 4,
+                    length: 11.8,
+                    radius_ratio: 0.036,
+                    taper: 0.92,
+                    bare_length_ratio: 0.12,
+                    child_count: 35,
+                    phyllotaxis_mode: PhyllotaxisMode.Whorled,
+                    whorl_count: 5,
+                    insertion_angle: 1.38,
+                    insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.72),
+                    curvature: 0.02,
+                    gravitropism: -0.08,
+                    phototropism: 0.06,
+                    gnarl_strength: 0.02,
+                    flare_amplitude: 0.2,
+                    flare_lobes: 4,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 5,
+                    radial_segments_max: 6,
+                    radial_segments_min: 3,
+                    length: 3.8,
+                    length_profile: AnimationCurve.linear(0, 1.0, 1, 0.22),
+                    radius_ratio: 0.032,
+                    taper: 0.86,
+                    bare_length_ratio: 0.1,
+                    child_count: 6,
+                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+                    insertion_angle: 0.9,
+                    curvature: 0.22,
+                    curve_back: -0.10,
+                    gravitropism: 0.16,
+                    phototropism: 0.12,
+                    collar_weld_rings: 2
+                },
+                {
+                    level: 2,
+                    segments: 3,
+                    radial_segments_max: 4,
+                    radial_segments_min: 3,
+                    length: 1.1,
+                    radius_ratio: 0.03,
+                    taper: 0.85,
+                    bare_length_ratio: 0.08,
+                    child_count: 0,
+                    insertion_angle: 0.8,
+                    curvature: 0.15,
+                    gravitropism: 0.18,
+                    phototropism: 0.2,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.CrossCard,
+                attach_min_level: 1,
+                cards_per_branch: 7,
+                terminal_rosette_count: 2,
+                card_width: 0.68,
+                card_length: 0.75
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "plated",
+                primary_color: [0.36, 0.29, 0.24],
+                secondary_color: [0.15, 0.12, 0.10],
+                inner_bark_color: [0.42, 0.30, 0.22],
+                fissure_frequency: 8,
+                fissure_depth: 0.72,
+                roughness: 0.91
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.11, 0.27, 0.15],
+                secondary_color: [0.07, 0.18, 0.10],
+                leaf_shape: "needle",
+                leaflets_per_cluster: 9
+            });
+            break;
+        }
+
+        case TreePreset.Palm: {
+            config.name = "palm";
+            config.preset = TreePreset.Palm;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Hemispherical,
+                height: 11.0,
+                radius: 4.2,
+                base_height: 7.5,
+                prune_ratio: 0.1,
+                space_colonization_weight: 0.0,
+                pipe_model_weight: 0.15
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 10,
+                    radial_segments_max: 10,
+                    radial_segments_min: 7,
+                    length: 9.5,
+                    radius_ratio: 0.038,
+                    taper: 0.35,
+                    bare_length_ratio: 0.92,
+                    child_count: 12,
+                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+                    insertion_angle: 0.95,
+                    insertion_angle_variation: 0.25,
+                    curvature: 0.28,
+                    curve_back: -0.12,
+                    gravitropism: -0.08,
+                    phototropism: 0.22,
+                    gnarl_strength: 0.04,
+                    flare_amplitude: 0.25,
+                    flare_height_ratio: 0.12,
+                    flare_lobes: 6,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 5,
+                    radial_segments_max: 5,
+                    radial_segments_min: 3,
+                    length: 2.8,
+                    radius_ratio: 0.025,
+                    taper: 0.9,
+                    bare_length_ratio: 0.05,
+                    child_count: 0,
+                    insertion_angle: 0.85,
+                    curvature: 0.55,
+                    gravitropism: 0.48,
+                    phototropism: 0.15,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.RibbedFrond,
+                attach_min_level: 1,
+                cards_per_branch: 4,
+                terminal_rosette_count: 3,
+                bare_ratio: 0.05,
+                card_width: 0.95,
+                card_length: 1.85,
+                fold_angle: 0.32,
+                arch_height: 0.22,
+                camber_droop: 0.32,
+                frond_segments: 6,
+                gravitropism: 0.45,
+                phototropism: 0.4
+            });
+            config.bark_material.applyOverrides({
+                bark_type: "ringed",
+                primary_color: [0.54, 0.46, 0.36],
+                secondary_color: [0.26, 0.21, 0.15],
+                fissure_frequency: 5,
+                fissure_depth: 0.62,
+                lenticel_amount: 0.45
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.22, 0.46, 0.14],
+                secondary_color: [0.15, 0.34, 0.09],
+                leaf_shape: "frond",
+                leaflets_per_cluster: 11
+            });
+            break;
+        }
+
+        case TreePreset.Shrub: {
+            config.name = "shrub";
+            config.preset = TreePreset.Shrub;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.Hemispherical,
+                height: 2.8,
+                radius: 2.2,
+                base_height: 0.15,
+                prune_ratio: 0.25,
+                space_colonization_weight: 0.3,
+                pipe_model_exponent: 2.1,
+                pipe_model_weight: 0.55
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 5,
+                    radial_segments_max: 7,
+                    radial_segments_min: 4,
+                    length: 1.8,
+                    radius_ratio: 0.055,
+                    taper: 0.8,
+                    bare_length_ratio: 0.08,
+                    child_count: 8,
+                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+                    insertion_angle: 0.82,
+                    curvature: 0.25,
+                    gravitropism: -0.05,
+                    phototropism: 0.28,
+                    gnarl_strength: 0.12,
+                    split_probability: 0.45,
+                    split_count: 3,
+                    split_angle: 0.52,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 4,
+                    radial_segments_max: 5,
+                    radial_segments_min: 3,
+                    length: 1.2,
+                    radius_ratio: 0.04,
+                    taper: 0.85,
+                    bare_length_ratio: 0.1,
+                    child_count: 0,
+                    insertion_angle: 0.72,
+                    curvature: 0.2,
+                    gravitropism: 0.06,
+                    phototropism: 0.35,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.FoldedVCard,
+                attach_min_level: 1,
+                cards_per_branch: 9,
+                terminal_rosette_count: 4,
+                card_width: 0.55,
+                card_length: 0.62,
+                phototropism: 0.7
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.22, 0.44, 0.16],
+                secondary_color: [0.14, 0.30, 0.10],
+                leaf_shape: "ovate",
+                leaflets_per_cluster: 7
+            });
+            break;
+        }
+
+        case TreePreset.Fern: {
+            config.name = "fern";
+            config.preset = TreePreset.Fern;
+            config.crown.applyOverrides({
+                envelope_type: CrownEnvelopeType.InverseConical,
+                height: 1.6,
+                radius: 1.5,
+                base_height: 0.05,
+                prune_ratio: 0.05,
+                space_colonization_weight: 0.0,
+                pipe_model_weight: 0.2
+            });
+            config.levels = [
+                {
+                    level: 0,
+                    segments: 3,
+                    radial_segments_max: 6,
+                    radial_segments_min: 4,
+                    length: 0.35,
+                    radius_ratio: 0.18,
+                    taper: 0.6,
+                    bare_length_ratio: 0.1,
+                    child_count: 9,
+                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+                    insertion_angle: 0.95,
+                    curvature: 0.1,
+                    collar_weld_rings: 0
+                },
+                {
+                    level: 1,
+                    segments: 5,
+                    radial_segments_max: 4,
+                    radial_segments_min: 3,
+                    length: 1.15,
+                    radius_ratio: 0.025,
+                    taper: 0.92,
+                    bare_length_ratio: 0.05,
+                    child_count: 0,
+                    insertion_angle: 0.85,
+                    curvature: 0.48,
+                    gravitropism: 0.38,
+                    phototropism: 0.2,
+                    collar_weld_rings: 1
+                }
+            ];
+            config.applyOverrides({ levels: config.levels, replace_levels: true });
+            config.foliage.applyOverrides({
+                enabled: true,
+                card_type: FoliageCardType.RibbedFrond,
+                attach_min_level: 1,
+                cards_per_branch: 3,
+                terminal_rosette_count: 2,
+                bare_ratio: 0.05,
+                card_width: 0.48,
+                card_length: 0.95,
+                fold_angle: 0.28,
+                arch_height: 0.16,
+                camber_droop: 0.24,
+                frond_segments: 6,
+                gravitropism: 0.35,
+                phototropism: 0.55
+            });
+            config.foliage_material.applyOverrides({
+                primary_color: [0.24, 0.50, 0.16],
+                secondary_color: [0.16, 0.36, 0.10],
+                leaf_shape: "frond",
+                leaflets_per_cluster: 11
+            });
+            break;
+        }
+
+        case TreePreset.Oak:
+        default: {
+            config.name = "oak";
+            config.preset = TreePreset.Oak;
+            break;
+        }
+    }
+
+    if (overrides !== undefined && overrides !== null) {
+        config.applyOverrides(overrides);
+    }
+
+    return config;
+}