Overview

Author: Vincenzo Mossuto Creation Date: 24/09/2025
Last Reviewer: Sara Altomare/Rossana Mazza

See the Changelog for the full history of updates.

The Spaarkly Animation add-on is a script that streamlines product animation inside Blender.
It exposes tools in the 3D View → Sidebar → “Spaarkly 1.0.0” panel, grouped by task:

• Explosion animation — Creates a parametric “explode/implode” animation for frame components.
• Animated assets — Appends baked camera layouts, Clip-on armatures, and Interchangeable lens armatures from external .blend libraries.

UI & Controls

• Sliders (Scene → explosion_distance) control per-category offsets used by the explosion animation:
  • Frame Front, Lenses, Screws, Hinges, Temples, Temple Tips, Rivets, Wirecore, Logos, Side-Shield.
• Apply explosion animation: apply the animated explodion rig to selected objects.
• Add animated Clip-on / Interchangeable lens: appends the right rig preset and binds it to your selected geometry.

File Paths (constants)

These constants are read by the operators and must point to valid locations on your machine.
The defaults below come from the add-on source code:

• HDR directory (hdr_directory)
  Z:\3D Modeling\Spaarkly Materials\HDRI

• HDR file name (hdr_name)
  studio_small_08_8k.exr

• Animation assets root (animation_path) – libraries that contain cameras, clip-on armatures, and interchangeable-lens armatures
  Z:\3D Modeling\Spaarkly Materials\Animation Asset

Expected blend files in animation_path

• Cameras (UI: “Add Animated Camera”)
  EXPL_Camera_1_BAKED_LANDSCAPE.blend
EXPL_Camera_1_BAKED_PORTRAIT.blend

• Clip-on armatures (UI: “Add animated Clip-on armature”)
  CO_FULL_AN_2.blend
CO_CUT_AN_2.blend

• Interchangeable-lens armatures (UI: “Add animated Interchangeable lens armature”)
  IL_FULL_AN_1.blend
IL_CUT_AN_1.blend

If you move assets or use a different folder structure, update these constants in the add-on code before installing/enabling it. Otherwise the operators will fail to locate the required files.

Naming Requirements (crucial)

The tools rely on prefix-based names to auto-detect parts:

• Frame Front: FF_...
• Lenses: LN_... with increment _1_, _2_ (e.g., LN_1_..., LN_2_...)
• Temples: TM_... with side & index, e.g., TM_DX_1_..., TM_SX_2_...
• Temple Tips: TT_DX_..., TT_SX_...
• Wirecores: WC_DX_..., WC_SX_...
• Hinges: HN_DX_TH, HN_DX_FH, HN_SX_TH, HN_SX_FH
• Screws: SR_DX_..., SR_SX_...
• Nosepads: NP_DX_..., NP_SX_...
• Logos: LG_DX_TL_..., LG_DX_TT_..., LG_SX_TL_..., LG_SX_TT_..., or LG_FL_...
• Side-shield: SS_...
• Clip-on (mesh to bind): must start with CO_
• Interchangeable lenses: LN_1_..., LN_2_... plus FF_... (frame front) and SR_... (screw)

Incorrect names trigger clear error messages in the operators.

---