Documentation
Some test text!
Sample Java (Android) code for using PDFTron SDK to remove potentially sensitive content within PDF documents. Using 'pdftron.PDF.Redactor' makes sure that if a portion of an image, text, or vector graphics is contained in a redaction region, that portion is destroyed and is not simply hidden with clipping or image masks.
Step 1: Get your free trial license key, or sign in
Step 2: Add the code:
//---------------------------------------------------------------------------------------
// Copyright (c) 2001-2018 by PDFTron Systems Inc. All Rights Reserved.
// Consult legal.txt regarding legal and license information.
//---------------------------------------------------------------------------------------
package com.pdftron.android.pdfnetsdksamples.samples;
import com.pdftron.android.pdfnetsdksamples.OutputListener;
import com.pdftron.android.pdfnetsdksamples.PDFNetSample;
import com.pdftron.android.pdfnetsdksamples.R;
import com.pdftron.android.pdfnetsdksamples.util.Utils;
import com.pdftron.pdf.PDFDoc;
import com.pdftron.pdf.Rect;
import com.pdftron.pdf.Redactor;
import com.pdftron.sdf.SDFDoc;
import java.io.File;
import java.util.ArrayList;
/**
* PDF Redactor is a separately licensable Add-on that offers options to remove
* (not just covering or obscuring) content within a region of PDF.
* With printed pages, redaction involves blacking-out or cutting-out areas of
* the printed page. With electronic documents that use formats such as PDF,
* redaction typically involves removing sensitive content within documents for
* safe distribution to courts, patent and government institutions, the media,
* customers, vendors or any other audience with restricted access to the content.
*
* The redaction process in PDFNet consists of two steps:
*
* a) Content identification: A user applies redact annotations that specify the
* pieces or regions of content that should be removed. The content for redaction
* can be identified either interactively (e.g. using 'com.pdftron.pdf.PDFViewCtrl'
* as shown in PDFView sample) or programmatically (e.g. using 'com.pdftron.pdf.TextSearch'
* or 'com.pdftron.pdf.TextExtractor'). Up until the next step is performed, the user
* can see, move and redefine these annotations.
* b) Content removal: Using 'com.pdftron.pdf.Redactor.Redact()' the user instructs
* PDFNet to apply the redact regions, after which the content in the area specified
* by the redact annotations is removed. The redaction function includes number of
* options to control the style of the redaction overlay (including color, text,
* font, border, transparency, etc.).
*
* PDFTron Redactor makes sure that if a portion of an image, text, or vector graphics
* is contained in a redaction region, that portion of the image or path data is
* destroyed and is not simply hidden with clipping or image masks. PDFNet API can also
* be used to review and remove metadata and other content that can exist in a PDF
* document, including XML Forms Architecture (XFA) content and Extensible Metadata
* Platform (XMP) content.
*/
public class PDFRedactTest extends PDFNetSample {
private static OutputListener mOutputListener;
private static ArrayList<String> mFileList = new ArrayList<>();
public PDFRedactTest() {
setTitle(R.string.sample_pdfredact_title);
setDescription(R.string.sample_pdfredact_description);
// The standard library does not include the Redaction feature.
// If using the full library, please comment out the following
// call.
// DisableRun();
}
@Override
public void run(OutputListener outputListener) {
super.run(outputListener);
mOutputListener = outputListener;
mFileList.clear();
printHeader(outputListener);
// Relative paths to folders containing test files.
try {
Redactor.Redaction[] vec = new Redactor.Redaction[6];
vec[0] = new Redactor.Redaction(1, new Rect(0, 0, 600, 600), false, "Top Secret");
vec[1] = new Redactor.Redaction(2, new Rect(0, 0, 100, 100), false, "foo");
vec[2] = new Redactor.Redaction(2, new Rect(100, 100, 200, 200), false, "bar");
vec[3] = new Redactor.Redaction(2, new Rect(300, 300, 400, 400), false, "");
vec[4] = new Redactor.Redaction(2, new Rect(500, 500, 600, 600), false, "");
vec[5] = new Redactor.Redaction(3, new Rect(0, 0, 700, 20), false, "");
redact(Utils.getAssetTempFile(INPUT_PATH + "newsletter.pdf").getAbsolutePath(), Utils.createExternalFile("redacted.pdf").getAbsolutePath(), vec);
mFileList.add("redacted.pdf");
mOutputListener.println("Done...");
} catch (Exception e) {
e.printStackTrace();
}
for (String file : mFileList) {
addToFileList(file);
}
printFooter(outputListener);
}
public static void redact(String input, String output, Redactor.Redaction[] vec) {
try {
PDFDoc doc = new PDFDoc(input);
if (doc.initSecurityHandler()) {
Redactor.Appearance app = new Redactor.Appearance();
app.redactionOverlay = true;
app.border = false;
app.showRedactedContentRegions = true;
Redactor.redact(doc, vec, app, false, true);
doc.save(output, SDFDoc.SaveMode.REMOVE_UNUSED, null);
mFileList.add(new File(doc.getFileName()).getName());
doc.close();
}
} catch (Exception e) {
e.printStackTrace();
}
}
}