mirror of
https://github.com/storytold/pdfcraft.git
synced 2026-10-25 02:29:31 -06:00
komo1iddinandClaude Opus 5.5
36d239d2b1
Moving an image whose crop is its own (`q re W n cm Do Q`) as part of a group put a fresh `cm` before the clip path on every move, so twenty moves left twenty `cm` operators in front of one `re`. It never nested deeper, but the content stream grew with every drag. When a `cm` already sits right before that clip (one an earlier move added, or the file's own), `translate_images` now replaces it with the product of the new and old matrices. The CTM at the clip is `c · prev · outer` either way (ISO 32000-1 8.3.4, 8.4.4). A previous `cm` that is not finite, or a product larger than 1e12, keeps the old behaviour and inserts a separate `cm`. The new test moves an image cropped smaller than itself twenty times and checks that the image and its visible crop both moved by the full offset, that the operator count stays at its value after the first move, and that the caption after it is untouched. It fails without this change (32 operators against 13). Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
47 lines
3.4 KiB
Markdown
47 lines
3.4 KiB
Markdown
# Editing existing images and figures
|
|
|
|
In **Edit a PDF → Edit text and images**, click a figure to select it. Drag the selected
|
|
figure to move it, drag a corner to resize it proportionally, or press Delete to remove
|
|
that placement. The context menu also rotates or flips it. Changes support undo and
|
|
survive saving/reopening. For single-figure transforms, a clipping path exclusive to one image moves and resizes
|
|
together with its pixels, including nested graphics states, intervening state operators
|
|
and paths split across content streams. A clip shared with other content stays where it is.
|
|
When the figure already sits alone in a `q … cm … Q` (its own placement, or the one an
|
|
earlier edit added), moving or resizing it again changes that `cm`, so repeated edits don't
|
|
nest one more graphics state each time. Moving a privately cropped figure again likewise
|
|
changes the `cm` before its clip instead of adding another.
|
|
|
|
PDF figures are not always bitmap images. Imported diagrams often use a **Form XObject**,
|
|
which packages text, vector paths, and nested images into one object. PdfCraft selects
|
|
this object using its `BBox` and optional `Matrix` and edits it as a whole. Its original
|
|
content, resources, clipping box, and transparency settings remain intact. Moving or
|
|
deleting one use of a shared figure does not alter its other placements or pages.
|
|
|
|
**Replace Image** and **Save Image As** apply only to raster Image XObjects; these menu
|
|
items are disabled for grouped Form artwork. The tool does not ungroup Forms, edit their
|
|
individual internal elements, select arbitrary ungrouped vector paths, or edit inline
|
|
images (`BI`/`ID`/`EI`). A Form's bounding box may include whitespace.
|
|
|
|
For automation, `page_images` lists both kinds with `kind: "image"` or `kind: "form"`.
|
|
Forms have `pixels: [0, 0]`, since they have no single bitmap resolution. Use the returned
|
|
number with `image_edit` (move, rotate, flip_horizontal, flip_vertical, delete).
|
|
Coordinates are top-left-origin page points. `image_save` and `image_edit`'s replace action
|
|
return a clear error for Form artwork.
|
|
|
|
Selection frames follow the visible portion of artwork after page and path clipping. Clicking
|
|
editable text takes precedence over overlapping artwork, including labels inside an image's
|
|
visible rectangle. Hidden image placements have no selection frame. Bezier extrema determine
|
|
curved-path frames. Hit testing evaluates the actual clipping paths with their nonzero or
|
|
even-odd fill rule, so holes and empty corners do not intercept clicks. Intersections of several
|
|
curved clips can still have a loose bounding frame. Dragging the visible frame moves or resizes
|
|
the full placement by the same change; resizing keeps the opposite corner fixed, including
|
|
horizontal-only or vertical-only corner drags, and grabbing a grip slightly off-centre does not
|
|
jump. A selected corner keeps control of its drag even over a text label; the drag previews one
|
|
frame and applies one undoable edit on release. Exclusive crops and their holes move
|
|
with the selected image; shared clips stay fixed without moving neighbouring text or artwork.
|
|
|
|
`image_hit` applies the same path and hole checks headlessly. `page_images` retains `rect` as
|
|
the full placement rectangle used by `image_edit` and adds `visible_rect` for selection (null
|
|
when fully clipped). `object_list` reports visible artwork bounds while keeping the original
|
|
source indexes. A selection frame does not create, remove or enlarge the PDF's clipping path.
|