📋 JSON Schema & Configuration

Coordinate Convention

• X axis - Profile direction (left/right across the blade)
• Y axis - Thickness direction (into/out of blade face)
• Z axis - Height direction (up/down, aligned with gravity)

Perpendicular Cuts (Block-based)

For simple cuts with no angle or tilt, a block is created directly at the final position:

sld blo centerX centerY centerZ sizeX sizeY sizeZ 0 0 0 i_body

'*** Rotate for compound blade orientation
if bladeAngle <> 0 then
   sld rot 1 i_body 0 0 0 0 0 1 bladeAngle
end if

Angled/Tilted Cuts (Kurve-based)

For cuts with draft angles or tilt, the cutter is built in XY plane first, then rotated:

1. Build 2D profile in XY plane - X=profile direction, Y=height
2. Convert kurve to sheet - Creates flat sheet in XY
3. Rotate 90° around X - Moves to XZ plane (X=profile, Z=height)
4. Rotate by blade angle around Z - For compound blade orientations
5. Thicken in Y direction - Creates solid covering blade thickness

This approach is more reliable than trying to construct angled geometry directly.

gravityDirection (in profile section)

Direction that gravity acts - determines which faces are "up" vs "down" for trimming operations.

• "AUTO" - Derive from blade normal (default). For blade normal in XY plane, gravity is -Z.
• "BOTTOM" - Gravity toward -Z (most common)
• "TOP" - Gravity toward +Z
• "LEFT" - Gravity toward -X
• "RIGHT" - Gravity toward +X
• "FRONT" - Gravity toward -Y
• "BACK" - Gravity toward +Y
• "NONE" - No gravity direction (disables gravity-based operations)

AUTO mode: Analyzes the blade normal vector. Gravity is assumed to act on the axis where the blade normal has the smallest component. This works correctly for standard vertical blades and compound angle blades.

openSide

Which side of the blade is cut away (open). Relative to gravity direction.

• "none" - Full blade, no open side (default)
• "top" - Cut away top, blade supports from below
• "bottom" - Cut away bottom (rare, trim fixtures)

sideExtension

Extend blade beyond part profile on left/right sides (looking along blade normal).

"sideExtension": {
  "left": 10.0,   // Extend left side 10mm
  "right": 15.0   // Extend right side 15mm
}

gravityTrim

Trim blade walls along gravity direction. Keeps material near contact surface, removes material away from contact. Distances are measured from the contact point along the wall - how much to keep, not how much to remove.

"gravityTrim": {
  "enabled": true,
  "side": "both",        // "left", "right", or "both"
  "leftDist": 20.0,      // Keep 20mm on left wall from contact
  "rightDist": 30.0      // Keep 30mm on right wall from contact
}

Use case: When a part rests in a pocket, the wall portions near the floor support the part. The upper portions of the walls can be trimmed away to reduce weight and material cost.

Asymmetric trim: Left and right walls can have different distances - useful when one side of the part is heavier or when access is needed on one side.

widthTrim

Trim blade walls from the outside edge inward toward the pocket. Used for extraction clearance (remove walls entirely) or wall thinning (keep specified thickness).

"widthTrim": {
  "enabled": true,
  "side": "both",          // "none", "left", "right", or "both"
  "leftThickness": 0.0,    // Wall thickness interpretation:
  "rightThickness": 5.0,   //   0 = remove wall to pocket edge
                            //   >0 = keep this much wall from pocket edge
                            //   <0 = cut past pocket edge (aggressive)
  "leftAngle": 15.0,       // Draft angle for extraction (degrees)
  "rightAngle": 15.0,      // +ve = opens outward at top (V-exit)
  "leftTilt": 0.0,         // Tilt perpendicular to outer face
  "rightTilt": 0.0,
  "leftOffset": 10.0,      // Vertical offset above pivot reference (mm)
  "rightOffset": 10.0,
  "leftInset": 0.0,        // Horizontal inset from pocket edge (mm)
  "rightInset": 0.0,       // Only used when thickness <= 0
  "anglePivot": "corner"   // "corner", "contact", or "bottom"
}

Thickness values:

• 0 - Remove wall entirely, cut to pocket edge (safe, won't affect center geometry)
• >0 - Keep this much wall from pocket edge (e.g., 5 = leaves 5mm wall stub)
• <0 - Aggressive removal, cut past pocket edge toward center (e.g., -10 = cuts 10mm into base area)

Angle pivot modes:

The anglePivot parameter controls where the vertical-to-angled transition occurs on the cut face. The cutter is a 5-sided "pencil" shape that creates a vertical wall section below the pivot and an angled wall section above it.

• "corner" (recommended for most cases) - Pivot point is calculated from the geometric pocket corner (where the inner wall meets the pocket floor) plus the offset value. This mode uses actual blade geometry rather than user-defined values, making it more reliable for automated processing.
  Use case: Standard fixture blades where you want a stable vertical base and angled extraction above the pocket floor.
• "contact" (default) - Pivot point is at the user-defined contact level (w_FX_CONTACT_LEVEL) plus the offset value. The contact level represents where the part rests in the blade pocket.
  Use case: When you need precise control over where the angle starts relative to the part position.
• "bottom" - Pivot point is at the blade bottom. The entire wall is angled from base to top with no vertical section.
  Use case: Maximum draft angle for easy extraction, or when wall stability is not a concern.

Angled cuts: The angle parameters create draft angles for part extraction. Positive angles open outward at the top, creating a V-shape exit path. The angle pivots from the point specified by anglePivot plus any offset.

Horizontal inset: The inset parameter only applies when removing walls entirely (thickness ≤ 0). It creates a horizontal shelf/ledge at the bottom of the angled cut. For wall thinning (thickness > 0), inset is ignored.

Configuration

"dangerZone": {
  "enabled": false,        // Master enable for danger zone marking
  "distance": 5,           // Width of red strip from edge (mm) - also blend radius
  "angleThreshold": 90,    // Max angle between faces to mark (degrees)
  "blend": false           // Apply blend to inner edges between red faces
}

Parameters

How It Works

1. Thin Face Detection - Only processes edges on faces where shortest edge ≤ material thickness
2. Sharp Edge Identification - Finds edges where BOTH adjacent faces are thin AND meet at acute angle
3. Danger Strip Creation - Imprints red strips on both faces adjacent to each danger edge
4. Optional Blending - If enabled, applies constant blend to edges between two red faces

Global Variables

Direct Macro Call

'*** Set globals and call directly:
i_FX_JSON_DANGER_ZONE_ENABLED = 1
w_FX_JSON_DANGER_ZONE_DIST = 5
w_FX_JSON_DANGER_ZONE_ANGLE = 90
i_FX_JSON_DANGER_ZONE_BLEND = 1
call fxDangerZoneMarking i_bladeBody

'*** Check results:
write $_FIXTURE_PERSISTENT_MESSAGE 'Danger zones marked: ' i_FX_DANGER_ZONE_COUNT
call fxPrintStatus

Quick Reference: JSON Configuration

"edgeFeatures": {
  "grippers": {
    "enabled": true,
    "zones": ["left-inside", "bottom-inside", "right-inside"],
    "radius": 3.0,
    "interval": 25.0,
    "clearance": 0.5,
    "depthOffset": 2.0
  },
  "plungers": {
    "enabled": true,
    "zones": ["left-inside"],
    "width": 12.0,
    "depth": 8.0,
    "spacing": 50.0,
    "fromTop": 15.0
  },
  "labels": {
    "enabled": true,
    "zones": ["top-left"],
    "text": "BLADE-001",
    "height": 5.0,
    "depth": 0.3
  }
}

Available Zones (14 Total)

Zones are grouped by category:

• Inside (4): left-inside, right-inside, bottom-inside, all-inside
• Outside (7): left-outside, right-outside, bottom-outside, top-left, top-right, all-outside, all-outside-except-base
• Combined (3): all-no-topZFaces, all-everything, all-everything-except-base

See full zone descriptions →

Configuration

"referenceMarker": {
  "enabled": true,           // Enable reference marker placement
  "diameter": "3mm"          // Marker diameter with units
}

Global vs Per-Blade Settings

Global (in fixtureConfig): Applies to all blades unless overridden

"fixtureConfig": {
  "referenceMarker": {
    "enabled": true,
    "diameter": "3mm",
    "color": { "r": 255, "g": 0, "b": 0 }
  }
}

Per-Blade Override (in blades array):

"blades": [
  {
    "id": 1,
    "referenceMarker": {
      "diameter": "5mm"    // Override for this blade only
    }
  },
  {
    "id": 2               // Uses global 3mm default
  }
]

Face Naming (Internationalized)

Both the parent face and the marker face are named for identification:

Note: The ^24 9999 prefix indicates internationalization-ready strings.

Resolution Order

1. If blade has referenceMarker.diameter → use blade value
2. Else if global fixtureConfig.referenceMarker.diameter exists → use global
3. Else → use hardcoded default: 3mm

Global Variables

Macro Usage

'*** Interactive mode - pick a face
call fxPlaceRefImprint

'*** Programmatic mode - specify face ID
call fxPlaceRefImprint 512

'*** With per-blade override
w_FX_BLADE_REFMARKER_DIAMETER = 5.0    '*** 5mm for this blade
call fxPlaceRefImprint i_faceID
w_FX_BLADE_REFMARKER_DIAMETER = 0      '*** Reset for next blade