Clone Objects #1194
Assignees
Labels
is-feature
A feature request
Comments
|
Sounds good! I couldn't pin-point specific issues that were caused by this missing feature, but I also have the impression it would be helpful in some cases. I'm uncertain what a good interface would be. Would the proposed interface mean we could take an object from a PdfReader and clone it to a PdfWriter? What would happen to (indirect) objects referenced within the cloned object? Do we maybe need a |
Merged
MartinThoma
pushed a commit
that referenced
this issue
Dec 11, 2022
The method `.clone(pdf_dest,[force_duplicate])` clones the objects and all referenced objects. If an object is already cloned, the already cloned object is returned (unless force_duplicate is set) mainly for internal use but can be used on a page for pageObject/DictionnaryObject/[Encoded/Decoded/Content]Stream an extra parameter ignore_fields list that provide the list of fields that should not be cloned. When available, the pointer to an object is available in `indirect_obj` attribute. New API for add_page/insert_page that : * returns the cloned page object * ignore_fields can be provided as a parameter. ## Others * file is closed at the end of PdfWriter.write when a filename is provided * Breaking Change: `add_outline_item` now has a parameter before which is not the last parameter ## Update * The public API of PdfMerger has been added to PdfWriter (ready to make PdfMerger an alias of it) * Process properly Outline merging * Process properly Named destinated Deals with #1194, #1322, #471, #1337
|
cloning has been introduced. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Explanation
I've noted some (many?) issues dealing that PyPDF2 is missing capability to clone objects (and all items below)
for example this would allow to insert the same page multiple time but modifying it
Code Example
the proposed interface would be (for all type of objects)
object.clone(pdf_dest,force_duplicate=False) -> duplicated_objectpdf_dest would be a PdfWriter or PdfMerger
by default already duplicated indirect object will be kept unique but setting force_duplicate to true will force duplication
Any Feedbacks?
The text was updated successfully, but these errors were encountered: