A macOS API to allow for UI presentation of a pdf page picker when importing pdf data into a single image.
The API includes two facilities:
- A
NSResponderextension that allows for requesting a single page out of pdf data or a pdf file, as well as an interception point for configuring presentation of that page picker. ImageWell, a subclass ofNSImageViewthat intercepts paste and drop operations and presents the pdf page picker if needed.
Select "Add package…" in the Xcode File menu and paste the URL for this same repository in the search bar. Then import PDFPagePicker in whichever files need it.
The best way to see how it works is to check the Test application at https://github.com/Gabardone/PDFPagePickerTestApp.git and examine how it uses the API in this package.
For any of the options, if the default presentation behavior doesn't work for your needs you can always override
NSResponder.presentPDFPagePicker any place down the responder chain where it will catch the call.
For example, assume that your app has already obtained a pdf file during an import operation, and you want to save the image for the selected page, if the user selects any. You would make a call similar to the following from any component of the responder chain (i.e. the view controller coordinating the process), give or take some localization:
pickPDFPage(from: pdfFileURL, verb: "Import") { image in
save(image)
}Use it as a direct replacement for an editable
NSImageWell. It will also ensure that pasting or
dropping image files on the well will extract the image data off the file instead of the file's icon.