pdf_manipulator

Description:

pdf manipulator

Word from creator #
Hello👋, This package is completely compatible with flutter and it also supports using Android Uri of picked file to work with which offers some real benefits such as manipulating them without caching or validating them without caching.
Yes, without a doubt, giving a free 👍 or ⭐ will encourage me to keep working on this plugin.
Package description #
A flutter plugin for doing various manipulations such as merge, split, compress and many more on PDF easily.
Note: This project utilises itext7 for various operations involving PDFs and since itext7 AGPL V3 License is used in this plugin, it is also licenced under this licence. The project/plugin developer, the owner of the copyright, and the contributors are not accountable or liable for any damage resulting from this project/plugin.
Features #

Works on Android 5.0 (API level 21) or later.
Works with both absolute file path and Android native Uri.
Supports merging multiple PDFs.
Supports splitting PDF.
Supports rotating PDF pages.
Supports deleting PDF pages.
Supports reordering PDF pages.
Supports rotating, deleting, reordering PDF pages at the same time for more efficiency.
Supports compressing PDF.
Supports watermarking PDF.
Supports encrypting PDF.
Supports decrypting PDF.
Supports converting images to PDF.
Supports getting PDF validity and protection info.
Supports getting PDF page size info.

Note: To use it in realease mode you will need to create a file named proguard-rules.pro in your project Android->App->proguard-rules.pro. In that file you need to add the below block of text at the end of the file.
# To use iText in release mode Otherwise we get
# PlatformException AbstractITextEvent is only for internal usage.
-keep public class com.itextpdf.**
-keep public class org.apache.**
copied to clipboard
For reference see this project file.
Then, setup your App->build.gradle buildTypes release config as done in this project file.
If you don't do all of this then you will get PlatformException: AbstractITextEvent is only for internal usage in Release build.
Note: If you are getting errors in you IDE after updating this plugin to newer version and the error contains works like Redeclaration, Conflicting declarations, Overload resolution ambiguity then to fix that you probably need to remove the older version of plugin from pub cache C:\Users\username\AppData\Local\Pub\Cache\hosted\pub.dev\older_version or simply run flutter clean.
Getting started #

In pubspec.yaml, add this dependency:

pdf_manipulator:
copied to clipboard

Add this package to your project:

import 'package:pdf_manipulator/pdf_manipulator.dart';
copied to clipboard
Basic Usage #
Merging multiple PDFs #
String? mergedPdfPath = await PdfManipulator().mergePDFs(
params: PDFMergerParams(pdfsPaths: [pdfPath1, padfPath2]),
);
copied to clipboard
Spliting PDF #
String? mergedPdfPath = await PdfManipulator().mergePDFs(
params: PDFMergerParams(pdfsPaths: [pdfPath1, padfPath2]),
);
copied to clipboard
Split PDF by page count
List<String>? splitPdfPaths = await PdfManipulator().splitPDF(
params: PDFSplitterParams(pdfPath: pdfPath, pageCount: 2),
);
copied to clipboard
Split PDF by size
List<String>? splitPdfPaths = await PdfManipulator().splitPDF(
params: PDFSplitterParams(pdfPath: pdfPath, byteSize: splitSize),
);
copied to clipboard
Split PDF by page numbers
List<String>? splitPdfPaths = await PdfManipulator().splitPDF(
params: PDFSplitterParams(pdfPath: pdfPath, pageNumbers: [2, 5]),
);
copied to clipboard
Extract PDF pages by page range
List<String>? splitPdfPaths = await PdfManipulator().splitPDF(
params: PDFSplitterParams(pdfPath: pdfPath, pageRanges: ["2", "5-10"]),
);
copied to clipboard
Rotaing PDF pages #
String? rotatedPagesPdfPath = await PdfManipulator().pdfPageRotator(
params: PDFPageRotatorParams(pdfPath: pdfPath, pagesRotationInfo: [PageRotationInfo(pageNumber: 1, rotationAngle: 180)]),
);
copied to clipboard
Deleting PDF pages #
String? deletedPagesPdfPath = await PdfManipulator().pdfPageDeleter(
params: PDFPageDeleterParams(pdfPath: pdfPath, pageNumbers: [1, 2, 3]),
);
copied to clipboard
Reordering PDF pages #
String? reorderedPagesPdfPath = await PdfManipulator().pdfPageReorder(
params: PDFPageReorderParams(pdfPath: pdfPath, pageNumbers: [4, 1]),
);
copied to clipboard
Rotating, Deleting, Reordering PDF pages at the same time #
String? rotatedDeletedReorderedPagesPdfPath = await PdfManipulator().pdfPageRotatorDeleterReorder(
params: PDFPageRotatorDeleterReorderParams(
pdfPath: pdfPath,
pagesRotationInfo: [PageRotationInfo(pageNumber: 1, rotationAngle: 180)],
pageNumbersForReorder: [4, 3, 2, 1],
pageNumbersForDeleter: [3, 2]),
);
copied to clipboard
Compressing PDF #
String? compressedPdfPath = await PdfManipulator().pdfCompressor(
params: PDFCompressorParams(pdfPath: pdfPath, imageQuality: 100, imageScale: 1),
);
copied to clipboard
Watermarking PDF #
String? watermarkedPdfPath = await PdfManipulator().pdfWatermark(
params: PDFWatermarkParams(
pdfPath: pdfPath,
text: "Watermark Text",
watermarkColor: Colors.red,
fontSize: 50,
watermarkLayer: WatermarkLayer.overContent,
opacity: 0.7,
positionType: PositionType.center),
);
copied to clipboard
Note: When using PositionType.custom you need to provide customPositionXCoordinatesList and customPositionYCoordinatesList.
Encrypting PDF #
String? encryptedPdfPath = await PdfManipulator().pdfEncryption(
params: PDFEncryptionParams(
pdfPath: pdfPath,
ownerPassword: "ownerpw",
userPassword: "userpw",
encryptionAES256: true // Set true to enable encryptionAES256 encryption.
);
copied to clipboard
PDFEncryptionParams other parameters with their default values is as follows:-

bool allowPrinting = false Set true to allow printing permission.
bool allowModifyContents = false Set true to allow modify permission.
bool allowCopy = false Set true to allow copy permission.
bool allowModifyAnnotations = false Set true to allow modifying annotations permission.
bool allowFillIn = false Set true to allow fill in permission.
bool allowScreenReaders = false Set true to allow screen readers permission.
bool allowAssembly = false Set true to allow assembly permission.
bool allowDegradedPrinting = false Set true to allow degraded printing permission.
bool standardEncryptionAES40 = false Set true to enable StandardEncryptionAES40 encryption. standardEncryptionAES40 implicitly sets doNotEncryptMetadata and encryptEmbeddedFilesOnly as false.
bool standardEncryptionAES128 = false Set true to enable StandardEncryptionAES128 encryption. standardEncryptionAES128 implicitly sets EncryptionConstants.EMBEDDED_FILES_ONLY as false.
bool encryptionAES128 = false Set true to enable encryptionAES128 encryption.
bool encryptEmbeddedFilesOnly = false Set true to encrypt embedded files only.
bool doNotEncryptMetadata = false Set true to not encrypt metadata.

Note: Please be aware that the passed encryption types may override permissions.
Decrypting PDF #
String? decryptedPdfPath = await PdfManipulator().pdfDecryption(
params: PDFDecryptionParams(
pdfPath: pdfPath,
password: ownerOrUserPassword,
);
copied to clipboard
Converting images to PDF #
List<String>? pdfsPaths = await PdfManipulator().imagesToPdfs(
params: ImagesToPDFsParams(
imagesPaths: imagesPaths,
createSinglePdf: false,
);
copied to clipboard
Images in JPEG, JPEG2000, GIF, PNG, BMP, WMF, TIFF, CCITT and JBIG2 formats are supported.
PDF validity and protection info #
PdfValidityAndProtection? pdfValidityAndProtectionInfo = await PdfManipulator().pdfValidityAndProtection(
params: PDFValidityAndProtectionParams(
pdfPath: pdfPath,
);

/// Getting info.
bool? isPDFValid = pdfValidityAndProtectionInfo?.isPDFValid;
bool? isOwnerPasswordProtected = pdfValidityAndProtectionInfo?.isOwnerPasswordProtected;
bool? isOpenPasswordProtected = pdfValidityAndProtectionInfo?.isOpenPasswordProtected;
bool? isPrintingAllowed = pdfValidityAndProtectionInfo?.isPrintingAllowed;
bool? isModifyContentsAllowed = pdfValidityAndProtectionInfo?.isModifyContentsAllowed;
copied to clipboard
Don't provide password if you just want to check validity and protection. Only provide password if you want to check if that password is correct or not.
Note: If you only want to check validity and protection then I suggest to use pdf_bitmaps as that is fast and requires less memory.
PDF page size info #
List<PageSizeInfo>? pdfPagesSizeInfo = await PdfManipulator().pdfPagesSize(
params: PDFPagesSizeParams(
pdfPath: pdfPath,
);

/// Getting 1st page info.
double? widthOfPage = pdfPagesSizeInfo[0]?.widthOfPage;
double? heightOfPage = pdfPagesSizeInfo[0]?.heightOfPage;
copied to clipboard
Note: If you only want to get page size then I suggest to use pdf_bitmaps as that is fast and requires less memory.
Note: To try the demos shown in below images run the example included in this plugin.