lib_set_footprint_height
Directly sets a footprint's height in millimetres to correct missing or wrong 3D-model values and fix placement-collision DRC results.
Instructions
Set one footprint's Height directly, up or down.
The sweep can only derive a height from a 3D body, which leaves two cases it cannot serve: a part with no model, and a part whose model is wrong. There was no setter at all before this, so a footprint carrying an absurd height could be read and not corrected.
WHY TOO TALL IS WORSE THAN TOO SHORT. Footprint.Height drives placement-collision DRC. A footprint claiming 50mm when the part is 3mm fails against everything near it and blocks placements that are fine. A too-low height only fails to catch a real collision. The first floods the report and gets the rule switched off; the second is quiet.
ZERO IS ACCEPTED AND IS NOT NEUTRAL. It disables the rule for that footprint rather than relaxing it, so nothing is ever flagged against it however tall the real part is. The reply says so when zero is written.
Args: height_mm: the height in MILLIMETRES, not mils. Must be non-negative. footprint_name: which footprint. Empty uses the library's current component.
Returns:
{name, old_height_mm, new_height_mm, changed, saved, save_note, note}. saved is always false: the library
is modified in memory and left for you to review and save.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| height_mm | Yes | ||
| footprint_name | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||