krites crop¶
Description¶
Propose a composition crop and record it on a frame's edit record — proposed,
never auto-applied, and baked to pixels only on
krites export (0006 R-CROP-1; R-EDIT-1). krites proposes;
you dispose.
The crop is the largest rectangle of the target aspect (--aspect, or the
frame's own aspect by default) placed by a strategy (0006 §9-Q4, R-CROP-3 —
config-driven, never hardcoded):
| Strategy | What it does | Backing |
|---|---|---|
keep-original |
Centres the crop — no recomposition | none (pure geometry) |
thirds-subject |
Puts the largest detected subject on a rule-of-thirds line | reuses the cull's face detector |
thirds-saliency |
(planned) places on a saliency map | a saliency provider, added later |
thirds-subject is the default. It needs the face detector, which is off by
default (local-first, R-PRIV-1); with no detector — or no subject found — it
proposes nothing, and keep-original leaves the frame uncropped unless you set an
aspect. Recomposition therefore needs room: a target aspect tighter than the
frame, or a straighten edit (whose leveled inner-crop
the crop stays within, so no empty corners show — R-CROP-2). A crop never falls
below --min-short-side of the frame (R-CROP-2).
Non-destructive: only the frame's .krites/edits/<frame>.yaml record changes —
the original is never touched (R-ND-1). Undo it with
krites reset.
Usage¶
Name a single frame, or pass --all to propose across every keeper — exactly
one of the two. The shoot is taken from --shoot, or the current working
directory if omitted (R-SCOPE-1).
Flags¶
| Flag | Description | Default |
|---|---|---|
--shoot |
Shoot directory to scope to | the current directory |
--all |
Propose a crop for every keeper frame | false |
--aspect |
Target aspect ratio W:H |
develop config (keep the frame's aspect) |
--strategy |
keep-original or thirds-subject |
develop config (thirds-subject) |
--min-short-side |
Minimum crop short side as a fraction of the frame | develop config (0.5) |
--output |
Output format: text or json |
text |
Examples¶
# Re-frame keepers to 4:5 for the album, placing faces on the thirds
krites crop --shoot ~/shoots/smith-wedding --all --aspect 4:5
# A centred square crop of one frame, no subject detection
krites crop --shoot ~/shoots/smith-wedding --strategy keep-original --aspect 1:1 044.jpg
See also¶
krites straighten— level a frame (crop stays within it).krites cull— judge the shoot (run first).krites reset— clear a frame's edits.krites export— bake edits to pixels (the only writer).