feat(orient): auto-orient the largest overhang toward the cooling fan

New printer option fan_direction (undefine/left/right/both, default
undefine) declares which side the auxiliary part-cooling airflow comes
from. When set and the printer has an auxiliary fan, auto-orient adds a
yaw rotation so the dominant overhang area faces the airflow, and newly
added primitive shapes are pre-oriented the same way (except the Cube,
whose axis-aligned bounding box the pressure-advance pattern calibration
depends on).

- FanDirection enum + fan_direction printer option (Accessory group,
  enabled only with auxiliary_fan)
- orient engine: weighted overhang areas per candidate, yaw-direction
  search, vertical rotation applied on top of the primary orientation;
  the cooling weights are taken from the candidate actually chosen,
  including the flat-bottom tie-break
- orient_for_cooling() for primitive placement
- set fan_direction=left on H2C/H2D/H2D Pro/X1/X1E/P1S 0.4 profiles
  (X1C/H2S/P2S/X2D/Qidi X-Max 4 already carried the key, which now
  takes effect)

With fan_direction unset or no auxiliary fan the vertical rotation stays
identity and auto-orient results are unchanged; slicing and g-code are
never affected.
This commit is contained in:
SoftFever
2026-07-10 16:21:48 +08:00
parent 93a81179a1
commit b12aad6a8c
15 changed files with 283 additions and 19 deletions

View File

@@ -38,6 +38,7 @@
#include "slic3r/Utils/FixModelByCgal.hpp"
#include "libslic3r/Format/bbs_3mf.hpp"
#include "libslic3r/Orient.hpp"
#include "libslic3r/PrintConfig.hpp"
#ifdef __WXMSW__
@@ -2560,6 +2561,15 @@ void ObjectList::load_shape_object(const std::string &type_name)
// Create mesh
BoundingBoxf3 bb;
TriangleMesh mesh = create_mesh(type_name, bb);
// Rotate the largest overhang area toward the part cooling fan so new shapes start in a
// cooling friendly orientation. Skip the plain cube: the pressure advance pattern
// calibration reuses it as an axis-aligned anchor and scales it by its bounding box,
// so its orientation must stay fixed.
const Slic3r::DynamicPrintConfig& full_config = wxGetApp().preset_bundle->full_config();
if (type_name != "Cube" && full_config.has("fan_direction") && full_config.has("auxiliary_fan")) {
FanDirection config_dir = full_config.option<ConfigOptionEnum<FanDirection>>("fan_direction")->value;
orientation::orient_for_cooling(mesh, config_dir);
}
// BBS: remove "Shape" prefix
load_mesh_object(mesh, _(type_name));
wxGetApp().mainframe->update_title();