Skip to content

Free Motion Capture for Everyone πŸ’€βœ¨

TypeScript

Blender export options | Installation bug fixes | Improving hand detection (#898)

Aaron Cherian847b60dcbed2
diff --git a/freemocap-ui/src/components/control-panels/server-connection/useServerPanel.ts b/freemocap-ui/src/components/control-panels/server-connection/useServerPanel.ts
index cc8ff2b0..ad3c77bd 100644
--- a/freemocap-ui/src/components/control-panels/server-connection/useServerPanel.ts
+++ b/freemocap-ui/src/components/control-panels/server-connection/useServerPanel.ts
@@ -77,6 +77,7 @@ export function useServerPanel(): ServerPanelState {
const [currentExePath, setCurrentExePath] = useState<string | null>(null);
const [candidates, setCandidates] = useState<ExecutableCandidate[]>([]);
const [candidatesLoading, setCandidatesLoading] = useState(false);
+ const [candidatesInitialized, setCandidatesInitialized] = useState(false);
const [processInfo, setProcessInfo] = useState<{ pid: number | undefined; killed: boolean } | null>(null);
const [error, setError] = useState<string | null>(null);
@@ -139,6 +140,7 @@ export function useServerPanel(): ServerPanelState {
setError(`Failed to load candidates: ${err instanceof Error ? err.message : String(err)}`);
} finally {
setCandidatesLoading(false);
+ setCandidatesInitialized(true);
}
}, [isElectron, api, selectedExePath]);
@@ -180,7 +182,20 @@ export function useServerPanel(): ServerPanelState {
setServerLoading(true);
setError(null);
try {
- await api.pythonServer.start.mutate({ exePath: selectedExePath || null });
+ try {
+ await api.pythonServer.start.mutate({ exePath: selectedExePath || null });
+ } catch (err) {
+ if (selectedExePath) {
+ // Stored path exists on disk but failed to actually launch (stale
+ // mount dir, wrong arch, corrupted, permissions, etc.) β€” clear it
+ // and let the backend auto-detect a valid candidate instead.
+ console.warn('Stored executable path failed to launch, clearing and retrying with auto-detection:', err);
+ setSelectedExePath('');
+ await api.pythonServer.start.mutate({ exePath: null });
+ } else {
+ throw err;
+ }
+ }
await pollServerStatus();
} catch (err) {
console.error('Failed to start server:', err);
@@ -215,7 +230,17 @@ export function useServerPanel(): ServerPanelState {
disconnect();
await api.pythonServer.stop.mutate();
await new Promise((resolve) => setTimeout(resolve, 500));
- await api.pythonServer.start.mutate({ exePath: selectedExePath || null });
+ try {
+ await api.pythonServer.start.mutate({ exePath: selectedExePath || null });
+ } catch (err) {
+ if (selectedExePath) {
+ console.warn('Stored executable path failed to launch, clearing and retrying with auto-detection:', err);
+ setSelectedExePath('');
+ await api.pythonServer.start.mutate({ exePath: null });
+ } else {
+ throw err;
+ }
+ }
await pollServerStatus();
} catch (err) {
console.error('Failed to reset server:', err);
@@ -246,13 +271,18 @@ export function useServerPanel(): ServerPanelState {
if (!isElectron || !api) return;
if (!autoLaunchServer) return;
if (autoLaunchFiredRef.current) return;
+ // Wait for the initial candidate load/validation pass to actually
+ // complete (not just "not currently loading") before auto-launching β€”
+ // candidatesLoading starts false, so checking it alone races against
+ // loadCandidates() setting it true on mount.
+ if (!candidatesInitialized) return;
if (candidatesLoading) return;
if (serverRunning || serverLoading) return;
autoLaunchFiredRef.current = true;
console.log('Auto-launching server...');
startServer();
- }, [isElectron, api, autoLaunchServer, candidatesLoading, serverRunning, serverLoading, startServer]);
+ }, [isElectron, api, autoLaunchServer, candidatesInitialized, candidatesLoading, serverRunning, serverLoading, startServer]);
// ── WebSocket auto-reconnect ──
diff --git a/freemocap-ui/src/components/mocap-setup/mocap-blender-settings.tsx b/freemocap-ui/src/components/mocap-setup/mocap-blender-settings.tsx
index 4e2de77c..ef1d644b 100644
--- a/freemocap-ui/src/components/mocap-setup/mocap-blender-settings.tsx
+++ b/freemocap-ui/src/components/mocap-setup/mocap-blender-settings.tsx
@@ -2,9 +2,19 @@ import React, { useEffect, useRef } from "react";
import SubactionHeader from "@/components/ui-components/SubactionHeader";
import ToggleComponent from "@/components/ui-components/ToggleComponent";
import ButtonSm from "@/components/ui-components/ButtonSm";
+import Checkbox from "@/components/ui-components/Checkbox";
+import NameDropdownSelector from "@/components/ui-components/NameDropdownSelector";
import { useMocap } from "@/hooks/useMocap";
import { useBlender } from "@/hooks/useBlender";
import { useElectronIPC } from "@/services";
+import { useAppDispatch, useAppSelector } from "@/store/hooks";
+import {
+ blenderExportConfigUpdated,
+ selectMocapBlenderExportConfig,
+ BLENDER_MODEL_FORMATS,
+ ARMATURE_REST_POSES,
+ BlenderModelFormat,
+} from "@/store/slices/mocap";
interface MOCAPBlenderSettingsProps {
open: boolean;
@@ -17,6 +27,9 @@ const MOCAPBlenderSettings: React.FC<MOCAPBlenderSettingsProps> = ({
}) => {
const modalRef = useRef<HTMLDivElement>(null);
+ const dispatch = useAppDispatch();
+ const blenderExportConfig = useAppSelector(selectMocapBlenderExportConfig);
+
const { mocapRecordingPath, detectorType } = useMocap();
const { api, isElectron } = useElectronIPC();
const {
@@ -56,6 +69,27 @@ const MOCAPBlenderSettings: React.FC<MOCAPBlenderSettingsProps> = ({
void triggerOpenInBlender(mocapRecordingPath);
};
+ const handleModelFormatToggle = (
+ format: BlenderModelFormat,
+ checked: boolean,
+ ): void => {
+ const formats = checked
+ ? [...blenderExportConfig.formats, format]
+ : blenderExportConfig.formats.filter((f) => f !== format);
+ dispatch(blenderExportConfigUpdated({ formats }));
+ };
+
+ const restPoseLabel =
+ ARMATURE_REST_POSES.find((p) => p.value === blenderExportConfig.rest_pose)
+ ?.label ?? ARMATURE_REST_POSES[0].label;
+
+ const handleRestPoseChange = (label: string): void => {
+ const restPose = ARMATURE_REST_POSES.find((p) => p.label === label);
+ if (restPose) {
+ dispatch(blenderExportConfigUpdated({ rest_pose: restPose.value }));
+ }
+ };
+
// The freemocap_blender_addon only understands MediaPipe output so far -
// an rtmpose recording's Blender export is turned off client-side to match.
const blenderSupported = detectorType === "mediapipe";
@@ -108,7 +142,7 @@ const MOCAPBlenderSettings: React.FC<MOCAPBlenderSettingsProps> = ({
<span className="icon icon-size-20 blender-icon"></span>
<p className="p-1 text-gray">Blender executable</p>
</div>
- <ButtonSm
+ <ButtonSm
text={isDetecting ? "Detecting..." : "Autodetect"}
onClick={redetectBlender}
disabled={isDetecting}
@@ -171,7 +205,59 @@ const MOCAPBlenderSettings: React.FC<MOCAPBlenderSettingsProps> = ({
text="Auto-open .blend file in Blender when done"
isToggled={autoOpenBlendFile && blenderSupported}
onToggle={setAutoOpenBlendFile}
- disabled={!blenderSupported || !exportToBlenderEnabled}
+ disabled={!blenderSupported}
+ />
+
+ <SubactionHeader text="3D Model Export" />
+
+ <div className="flex p-1 flex-row gap-1 items-center">
+ <span className="text sm">Formats</span>
+ {BLENDER_MODEL_FORMATS.map((format) => (
+ <Checkbox
+ key={format.value}
+ label={format.label}
+ checked={blenderExportConfig.formats.includes(format.value)}
+ onChange={(e) =>
+ handleModelFormatToggle(format.value, e.target.checked)
+ }
+ disabled={!blenderSupported}
+ />
+ ))}
+ </div>
+
+ <SubactionHeader text="Armature" />
+
+ <div className="flex p-1 flex-row gap-1 items-center justify-content-space-between">
+ <span className="text sm">Rest Pose</span>
+ <NameDropdownSelector
+ options={ARMATURE_REST_POSES.map((pose) => pose.label)}
+ initialValue={restPoseLabel}
+ onChange={handleRestPoseChange}
+ />
+ </div>
+
+ <SubactionHeader text="Animation Cleanup (Experimental)" />
+
+ <ToggleComponent
+ text="Apply Foot Locking"
+ isToggled={blenderExportConfig.apply_foot_locking}
+ onToggle={(checked) =>
+ dispatch(blenderExportConfigUpdated({ apply_foot_locking: checked }))
+ }
+ disabled={!blenderSupported}
+ />
+
+ <ToggleComponent
+ text="Limit Hand Markers Range of Motion"
+ isToggled={blenderExportConfig.limit_hand_markers_range_of_motion}
+ onToggle={(checked) =>
+ dispatch(
+ blenderExportConfigUpdated({
+ limit_hand_markers_range_of_motion: checked,
+ }),
+ )
+ }
+ disabled={!blenderSupported}
/>
<ButtonSm
diff --git a/freemocap-ui/src/store/slices/blender/blender-thunks.ts b/freemocap-ui/src/store/slices/blender/blender-thunks.ts
index e80a99aa..b9a5193e 100644
--- a/freemocap-ui/src/store/slices/blender/blender-thunks.ts
+++ b/freemocap-ui/src/store/slices/blender/blender-thunks.ts
@@ -67,6 +67,7 @@ export const exportRecordingToBlender = createAsyncThunk<
recordingFolderPath,
blenderExePath,
autoOpenBlendFile: blender.autoOpenBlendFile,
+ blenderExportConfig: state.mocap.config.blender_export,
}),
});
diff --git a/freemocap-ui/src/store/slices/mocap/mocap-slice.ts b/freemocap-ui/src/store/slices/mocap/mocap-slice.ts
index 97517e24..62060840 100644
--- a/freemocap-ui/src/store/slices/mocap/mocap-slice.ts
+++ b/freemocap-ui/src/store/slices/mocap/mocap-slice.ts
@@ -52,6 +52,24 @@ export interface TriangulationConfig {
target_reprojection_error: number;
}
+export type BlenderModelFormat = "fbx" | "bvh";
+export type ArmatureRestPose = "tpose" | "apose";
+
+/**
+ * Options forwarded to the freemocap_blender_addon's export.
+ * Field names use snake_case to match the backend JSON.
+ */
+export interface BlenderExportConfig {
+ /** Formats to write. May be empty, which skips 3D model export entirely. */
+ formats: BlenderModelFormat[];
+ /** Rest pose the armature is built in. */
+ rest_pose: ArmatureRestPose;
+ /** Run the addon's foot-locking motion cleanup before the scene is set up. */
+ apply_foot_locking: boolean;
+ /** Run the addon's hand/finger marker range-of-motion limit before the scene is set up. */
+ limit_hand_markers_range_of_motion: boolean;
+}
+
export interface PosthocFilterConfig {
method: "butter_low_pass";
cutoff: number;
@@ -102,6 +120,7 @@ export interface MocapConfig {
skeleton_filter: RealtimeFilterConfig;
triangulation: TriangulationConfig;
posthoc_filter: PosthocFilterConfig;
+ blender_export: BlenderExportConfig;
detectorType: DetectorType;
rtmPoseModelName: RTMPoseModelName;
rtmPoseConfidenceThreshold: number;
@@ -212,6 +231,24 @@ export const DEFAULT_POSTHOC_FILTER_CONFIG: PosthocFilterConfig ={
order: 4,
};
+/** Matches the addon defaults: export formats fbx+bvh, armature built in T-pose. */
+export const DEFAULT_BLENDER_EXPORT_CONFIG: BlenderExportConfig = {
+ formats: ["fbx", "bvh"],
+ rest_pose: "tpose",
+ apply_foot_locking: false,
+ limit_hand_markers_range_of_motion: false,
+};
+
+export const BLENDER_MODEL_FORMATS: { label: string; value: BlenderModelFormat }[] = [
+ { label: "FBX", value: "fbx" },
+ { label: "BVH", value: "bvh" },
+];
+
+export const ARMATURE_REST_POSES: { label: string; value: ArmatureRestPose }[] = [
+ { label: "TPOSE", value: "tpose" },
+ { label: "APOSE", value: "apose" },
+];
+
export interface MocapDirectoryInfo {
@@ -245,6 +282,12 @@ const DEFAULT_MOCAP_CONFIG: MocapConfig = {
triangulation: {...DEFAULT_TRIANGULATION_CONFIG},
skeleton_filter: {...DEFAULT_REALTIME_FILTER_CONFIG},
posthoc_filter: {...DEFAULT_POSTHOC_FILTER_CONFIG},
+ blender_export: {
+ formats: [...DEFAULT_BLENDER_EXPORT_CONFIG.formats],
+ rest_pose: DEFAULT_BLENDER_EXPORT_CONFIG.rest_pose,
+ apply_foot_locking: DEFAULT_BLENDER_EXPORT_CONFIG.apply_foot_locking,
+ limit_hand_markers_range_of_motion: DEFAULT_BLENDER_EXPORT_CONFIG.limit_hand_markers_range_of_motion,
+ },
detectorType: "rtmpose",
rtmPoseModelName: "rtmw-x-l_256x192",
@@ -284,6 +327,11 @@ const initialMocapConfig: MocapConfig = {
...DEFAULT_MOCAP_CONFIG.posthoc_filter,
...(_persistedMocapConfig?.posthoc_filter ?? {}),
},
+
+ blender_export: {
+ ...DEFAULT_MOCAP_CONFIG.blender_export,
+ ...(_persistedMocapConfig?.blender_export ?? {}),
+ },
};
const initialState: MocapState = {
@@ -370,6 +418,10 @@ export const mocapSlice = createSlice({
state.config.posthoc_filter = {...state.config.posthoc_filter, ...action.payload};
},
+ blenderExportConfigUpdated: (state, action: PayloadAction<Partial<BlenderExportConfig>>) => {
+ state.config.blender_export = { ...state.config.blender_export, ...action.payload };
+ },
+
mocapProgressUpdated: (state, action: PayloadAction<number>) => {
state.recordingProgress = action.payload;
},
@@ -459,6 +511,7 @@ export const selectMocapDetectorConfig = (state: RootState) => state.mocap.confi
export const selectMocapTriangulationConfig = (state: RootState) => state.mocap.config.triangulation;
export const selectSkeletonFilterConfig = (state: RootState) => state.mocap.config.skeleton_filter;
export const selectPosthocFilterConfig = (state: RootState) => state.mocap.config.posthoc_filter;
+export const selectMocapBlenderExportConfig = (state: RootState) => state.mocap.config.blender_export;
export const selectMocapDetectorType = (state: RootState) => state.mocap.config.detectorType;
export const selectMocapRtmPoseModelName = (state: RootState) => state.mocap.config.rtmPoseModelName;
export const selectMocapRtmPoseConfidenceThreshold = (state: RootState) => state.mocap.config.rtmPoseConfidenceThreshold;
@@ -535,6 +588,7 @@ export const {
skeletonFilterConfigUpdated,
triangulationConfigUpdated,
posthocFilterConfigUpdated,
+ blenderExportConfigUpdated,
mocapProgressUpdated,
mocapErrorCleared,
mocapDirectoryInfoUpdated,
diff --git a/freemocap-ui/src/store/slices/mocap/mocap-thunks.ts b/freemocap-ui/src/store/slices/mocap/mocap-thunks.ts
index 9c75ce0b..223b2f55 100644
--- a/freemocap-ui/src/store/slices/mocap/mocap-thunks.ts
+++ b/freemocap-ui/src/store/slices/mocap/mocap-thunks.ts
@@ -29,6 +29,7 @@ function buildPosthocConfig(state: RootState) {
calibrationTomlPath,
triangulationConfig: config.triangulation,
filterConfig: config.posthoc_filter,
+ blenderExportConfig: config.blender_export,
exportToBlender: blenderSupported && blender.exportToBlenderEnabled,
blenderExePath: blender.blenderExePath ?? blender.detectedBlenderExePath,
autoOpenBlendFile: blenderSupported && blender.autoOpenBlendFile,
diff --git a/freemocap/api/http/blender/blender_router.py b/freemocap/api/http/blender/blender_router.py
index b576f7ff..319836d2 100644
--- a/freemocap/api/http/blender/blender_router.py
+++ b/freemocap/api/http/blender/blender_router.py
@@ -6,6 +6,7 @@ from pathlib import Path
from fastapi import APIRouter, HTTPException
from pydantic import BaseModel, ConfigDict, Field
+from freemocap.core.blender.blender_export_config import BlenderExportConfig
from freemocap.core.blender.export_to_blender import export_to_blender
from freemocap.core.blender.helpers.install_blender_addon import \
install_freemocap_blender_addon
@@ -51,12 +52,18 @@ class ExportToBlenderRequest(BaseModel):
"recordingFolderPath": FREEMOCAP_TEST_DATA_PATH,
"blenderExePath": None,
"autoOpenBlendFile": True,
+ "blenderExportConfig": {"formats": ["fbx", "bvh"]},
}
},
)
recording_folder_path: str = Field(alias="recordingFolderPath", default=FREEMOCAP_TEST_DATA_PATH)
blender_exe_path: str | None = Field(alias="blenderExePath", default=None, examples=[None])
auto_open_blend_file: bool = Field(alias="autoOpenBlendFile", default=True)
+ blender_export_config: BlenderExportConfig = Field(
+ alias="blenderExportConfig",
+ default_factory=BlenderExportConfig,
+ description="Options forwarded to the Blender addon's 3D model export step.",
+ )
@property
def blend_file_path(self):
@@ -164,6 +171,7 @@ def export_to_blender_endpoint(request: ExportToBlenderRequest) -> ExportToBlend
blend_file_path=request.blend_file_path,
blender_exe_path=str(blender_exe),
open_file_on_completion=request.auto_open_blend_file,
+ blender_export_config=request.blender_export_config.model_dump(),
)
return ExportToBlenderResponse(
diff --git a/freemocap/core/blender/blender_export_config.py b/freemocap/core/blender/blender_export_config.py
new file mode 100644
index 00000000..abff89ed
--- /dev/null
+++ b/freemocap/core/blender/blender_export_config.py
@@ -0,0 +1,60 @@
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict, Field
+
+# The only formats we offer. The addon's export_3d_model() also has a 'gltf'
+# branch, but its animation export is broken (see the TODO there), so it is
+# deliberately not exposed.
+BlenderModelFormat = Literal["fbx", "bvh"]
+
+# Rest pose the addon builds the armature in.
+ArmatureRestPose = Literal["tpose", "apose"]
+
+DEFAULT_BLENDER_MODEL_FORMATS: list[BlenderModelFormat] = ["fbx", "bvh"]
+DEFAULT_ARMATURE_REST_POSE: ArmatureRestPose = "tpose"
+
+
+class BlenderExportConfig(BaseModel):
+ """Options forwarded to the freemocap_blender_addon for the Blender export.
+
+ These travel to Blender as a serialized argument on the subprocess command
+ line, so they must stay JSON-serializable. The addon ignores options it does
+ not recognize, which lets this model grow ahead of the addon release it is
+ paired with.
+ """
+
+ model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+ formats: list[BlenderModelFormat] = Field(
+ default_factory=lambda: list(DEFAULT_BLENDER_MODEL_FORMATS),
+ description=(
+ "3D model formats to write during the Blender export. Each format produces "
+ "a sibling file (e.g. '<recording>.fbx' and '<recording>.bvh') in the "
+ "'3d_models' subfolder of the recording. May be empty, in which case the "
+ "3D model export stage is skipped entirely."
+ ),
+ )
+ rest_pose: ArmatureRestPose = Field(
+ default=DEFAULT_ARMATURE_REST_POSE,
+ alias="restPose",
+ description=(
+ "Rest pose the armature is built in: 'tpose' or 'apose'. Affects the rig "
+ "created in the .blend file and anything exported from it."
+ ),
+ )
+ apply_foot_locking: bool = Field(
+ default=False,
+ alias="applyFootLocking",
+ description=(
+ "If True, run the addon's foot-locking cleanup over the marker motion before "
+ "the scene is set up. Off by default because it rewrites the marker positions."
+ ),
+ )
+ limit_hand_markers_range_of_motion: bool = Field(
+ default=False,
+ alias="limitHandMarkersRangeOfMotion",
+ description=(
+ "If True, run the addon's hand/finger marker range-of-motion limit before the "
+ "scene is set up. Off by default because it rewrites the marker positions."
+ ),
+ )
diff --git a/freemocap/core/blender/export_to_blender.py b/freemocap/core/blender/export_to_blender.py
index 3b41f85a..0fe0bdee 100644
--- a/freemocap/core/blender/export_to_blender.py
+++ b/freemocap/core/blender/export_to_blender.py
@@ -1,4 +1,5 @@
import inspect
+import json
import logging
import subprocess
from pathlib import Path
@@ -41,12 +42,42 @@ def run_subprocess(command_list: List[str]):
return process
+def _addon_config_payload(blender_export_config: dict | None) -> dict:
+ """Map API-level option names into the freemocap_blender_addon's Config namespace.
+
+ The addon's Config groups its options into sections (export_3d_model, add_rig,
+ ...), which is an addon-side detail. This is the boundary that translates, so
+ the HTTP/CLI contract can stay flat. Only keys the caller actually supplied are
+ forwarded; anything omitted keeps the addon's own default.
+ """
+ config_in = blender_export_config or {}
+ payload: dict = {}
+
+ if "formats" in config_in:
+ payload["export_3d_model"] = {"formats": config_in["formats"]}
+ if "rest_pose" in config_in:
+ payload["add_rig"] = {"rest_pose": config_in["rest_pose"]}
+
+ # Several options can land in the same addon section, so collect them rather
+ # than assigning the section once per option.
+ motion_cleanup = {
+ key: config_in[key]
+ for key in ("apply_foot_locking", "limit_hand_markers_range_of_motion")
+ if key in config_in
+ }
+ if motion_cleanup:
+ payload["motion_cleanup"] = motion_cleanup
+
+ return payload
+
+
def export_to_blender(
recording_folder_path: str|Path,
detector:str,
blend_file_path: str|Path|None=None,
blender_exe_path: str|Path|None=None,
open_file_on_completion:bool=True,
+ blender_export_config: dict|None=None,
):
if detector != "mediapipe":
message = (
@@ -77,6 +108,8 @@ def export_to_blender(
# function returns repr() of the wrapper, not the source file path.
simple_run_script = run_blender_export_module.__file__
+ addon_config_payload = _addon_config_payload(blender_export_config)
+
command_list = [
str(blender_exe_path),
"--background",
@@ -86,6 +119,7 @@ def export_to_blender(
site_packages_path,
str(recording_folder_path),
str(blend_file_path),
+ json.dumps(addon_config_payload),
]
logger.info(f"Starting `blender` sub-process with this command: \n {command_list}")
diff --git a/freemocap/core/blender/helpers/run_blender_export.py b/freemocap/core/blender/helpers/run_blender_export.py
index 2642529c..88727c6f 100644
--- a/freemocap/core/blender/helpers/run_blender_export.py
+++ b/freemocap/core/blender/helpers/run_blender_export.py
@@ -1,8 +1,12 @@
+import json
import sys
import traceback
-def run_blender_export(site_packages_path: str, recording_path_input: str, blender_file_save_path_input: str):
+def run_blender_export(site_packages_path: str,
+ recording_path_input: str,
+ blender_file_save_path_input: str,
+ blender_export_config_input: dict | None = None):
# Inject the freemocap venv's site-packages so freemocap_blender_addon is importable
# without needing to install the addon into Blender
if site_packages_path not in sys.path:
@@ -21,8 +25,25 @@ def run_blender_export(site_packages_path: str, recording_path_input: str, blend
from freemocap_blender_addon.main import ajc27_run_as_main_function
print(f"Imported ajc27_run_as_main_function from: {ajc27_run_as_main_function.__module__}")
+ import freemocap_blender_addon.data_models.parameter_models.load_parameters_config as addon_config
+
+ # An older addon build (no dict loader, or options it does not recognize) must
+ # not fail the export - degrade to its defaults instead.
+ config = addon_config.load_default_parameters_config()
+ if blender_export_config_input:
+ load_from_dict = getattr(addon_config, "load_parameters_config_from_dict", None)
+ if load_from_dict is None:
+ print(f"Installed freemocap_blender_addon cannot apply {blender_export_config_input!r}; using addon defaults")
+ else:
+ try:
+ config = load_from_dict(blender_export_config_input)
+ print(f"Addon config: {config}")
+ except Exception as e:
+ print(f"Could not apply Blender export config {blender_export_config_input!r} ({e}); using addon defaults")
+
ajc27_run_as_main_function(recording_path=str(recording_path_input),
- blend_file_path=str(blender_file_save_path_input))
+ blend_file_path=str(blender_file_save_path_input),
+ config=config)
if __name__ == "__main__":
@@ -34,9 +55,11 @@ if __name__ == "__main__":
site_packages_path_input = str(argv[0])
recording_path_input = str(argv[1])
blender_file_save_path_input = str(argv[2])
+ blender_export_config_input = json.loads(argv[3]) if len(argv) > 3 else None
run_blender_export(site_packages_path=site_packages_path_input,
recording_path_input=recording_path_input,
- blender_file_save_path_input=blender_file_save_path_input)
+ blender_file_save_path_input=blender_file_save_path_input,
+ blender_export_config_input=blender_export_config_input)
print("\nDone!\n", flush=True)
except Exception:
diff --git a/freemocap/core/tasks/mocap/mocap_task_config.py b/freemocap/core/tasks/mocap/mocap_task_config.py
index 3eb219fb..9e57e2bb 100644
--- a/freemocap/core/tasks/mocap/mocap_task_config.py
+++ b/freemocap/core/tasks/mocap/mocap_task_config.py
@@ -14,6 +14,7 @@ from skellytracker.core.temporal_processing.temporal_processing_config import (
)
from skellyforge.post_processing.filters.filter_config import FilterConfig
+from freemocap.core.blender.blender_export_config import BlenderExportConfig
from freemocap.core.tasks.triangulation.helpers.triangulation_config import TriangulationConfig
from freemocap.core.tracking.tracker_factory import build_mediapipe_tracker_config
@@ -121,6 +122,11 @@ class PosthocMocapPipelineConfig(BaseModel):
alias="autoOpenBlendFile",
description="If True, open the .blend file in Blender after export completes.",
)
+ blender_export_config: BlenderExportConfig = Field(
+ default_factory=BlenderExportConfig,
+ alias="blenderExportConfig",
+ description="Options forwarded to the Blender addon's 3D model export step. Ignored when export_to_blender=False.",
+ )
@model_validator(mode="after")
def _build_tracker_config_from_detector_type(self) -> "PosthocMocapPipelineConfig":
diff --git a/freemocap/core/tasks/mocap/posthoc_mocap_task.py b/freemocap/core/tasks/mocap/posthoc_mocap_task.py
index bbcb1b9d..fc403402 100644
--- a/freemocap/core/tasks/mocap/posthoc_mocap_task.py
+++ b/freemocap/core/tasks/mocap/posthoc_mocap_task.py
@@ -154,7 +154,8 @@ def run_posthoc_mocap_aggregator_task(
recording_folder_path=str(recording_info.full_recording_path),
blender_exe_path=task_config.blender_exe_path,
open_file_on_completion=task_config.auto_open_blend_file,
- detector = task_config.detector_type
+ detector = task_config.detector_type,
+ blender_export_config=task_config.blender_export_config.model_dump(),
)
except Exception as e:
# Don't crash the whole aggregator if blender export fails β€”
diff --git a/freemocap/core/tracking/tracker_factory.py b/freemocap/core/tracking/tracker_factory.py
index 3de9a9d0..6896c0b6 100644
--- a/freemocap/core/tracking/tracker_factory.py
+++ b/freemocap/core/tracking/tracker_factory.py
@@ -190,7 +190,7 @@ def _mediapipe_hand_child_stage(
(f"{side}_wrist", f"{side}_pinky"),
),
scale_factor=3.0,
- min_box_size_px=120.0,
+ min_box_size_px=30.0,
),
keypoint_detectors=[
MediapipeHandDetectorConfig(
diff --git a/uv.lock b/uv.lock
index 1ef55e65..6feeb0cd 100644
--- a/uv.lock
+++ b/uv.lock
@@ -597,7 +597,7 @@ tracker-default = [
[[package]]
name = "freemocap-blender-addon"
version = "2026.4.1041"
-source = { git = "https://github.com/freemocap/freemocap_blender_addon?branch=main#9f08f2c7d786ae92ab5c374a71aa6791a43d27b8" }
+source = { git = "https://github.com/freemocap/freemocap_blender_addon?branch=main#549b0fd7fc840c8b0908a8373a986eca91c18ad8" }
[[package]]
name = "h11"