Redaction

Text redaction is the process of removing or obscuring sensitive or confidential information from a document before it is shared or made public. This process ensures that private data, such as personal identifiers, financial details, or classified information, is masked to protect privacy, comply with regulatory requirements, and maintain data security. Redaction typically involves making the redacted information unreadable or inaccessible by masking or blacking out portions of text. It is widely used in various industries like:

Legal Government Healthcare Finance

where secure document sharing is essential.

In digital document processing, redaction can include not only visible masking, but also the removal of underlying data to prevent unauthorized recovery. In this example, we use TX Text Control to redact selected text areas to create a 100% secure, redacted PDF document.

Redaction Process

For real redaction, the text must be completely removed and replaced with placeholders. The redaction process consists of the following steps:

Load a document into TX Text Control. Identify the text areas that should be redacted. Replace text with dynamically created SVG images. Save the document as a PDF.

To do this, we will generate SVG images with the exact width and height of the text we want to remove. The TX Text Control API provides all necessary information about character boundaries and other required information. Consider the following document, where the &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; TextChar Class &#9584; Bounds Property Gets the bounding rectangle of the character. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Text Char. Bounds property is used to visualize the boundaries of each character.

In the first step, the user selects text areas and converts them to &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; SubTextPart Class A SubTextPart object represents a user-defined part of a TX Text Control document. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Sub Text Parts with a specific name ( tx_redact ).

SubTextPart subTextPart = new SubTextPart("tx_redact", 1);

subTextPart.HighlightColor = Color.FromArgb(200, Color.Black); subTextPart.HighlightMode = HighlightMode.Always;

textControl1.SubTextParts.Add(subTextPart); The following screenshot shows the inserted SubTextParts before conversion.

When all areas are selected, the following code iterates through all SubTextParts , stores the start and length indexes, and passes these values to the Redaction.RedactSelection method.

// store the redacted values List redactValues = new List ();

// get the enumerator SubTextPartCollection.SubTextPartEnumerator enumerator = textControl1.SubTextParts.GetEnumerator(); enumerator.MoveNext();

int subTextPartCount = textControl1.SubTextParts.Count;

// iterate through all subtextparts for (int i = 0; i < subTextPartCount; i++) { SubTextPart subTextPart = (SubTextPart)enumerator.Current;

if (subTextPart.Name == "tx_redact") { // store the redacted values redactValues.Add(new(subTextPart.Start - 1, subTextPart.Length));

// remove the subtextpart textControl1.SubTextParts.Remove(subTextPart, true, true); } }

int removedCharacterCount = 0;

// redact the values foreach ((int start, int length) in redactValues) { removedCharacterCount += Redaction.RedactSelection(start - removedCharacterCount, length, textControl1); } In the following screenshot you can see the dynamically generated SVGs that were inserted in red.

When you open the document in Acrobat Reader, the redacted text cannot be selected or copied because it has been completely removed and replaced with black SVGs.

Generating SVGs

The process itself is implemented in the Redaction class with the static method RedactSelection , which takes a start index, a length, and a ServerTextControl instance as parameters in the constructor.

using System.Text; using TXTextControl;

public static class Redaction { static int removedCharacterCount = 0;

public static int RedactSelection(int start, int length, ServerTextControl textControl) { int currentLine = -1; int processLength = 0; int processStart = start; removedCharacterCount = length;

List characterBounds = new List ();

for (int i = start; i < start + length; i++) { textControl.Select(i, 1); var curLine = textControl.Lines.GetItem(i);

if (currentLine != curLine.Number) { if (characterBounds.Count > 0) { // Process the accumulated line when switching lines ProcessLine(textControl, ref processStart, ref processLength, characterBounds); removedCharacterCount--;

// Adjust index and length to prevent reprocessing of characters i = i - characterBounds.Count + 1; processStart = i; length = length - characterBounds.Count + 1;

currentLine = curLine.Number; characterBounds.Clear(); processLength = 0; } }

currentLine = curLine.Number;

float lineBaseline = textControl.Lines[currentLine].Baseline;

RectangleF currentCharBounds = textControl.TextChars[i + 1].Bounds; currentCharBounds.Height -= (currentCharBounds.Bottom - lineBaseline);

// Add the current character bounds characterBounds.Add(currentCharBounds); processLength++; }

// Process any remaining characters on the last line ProcessLine(textControl, ref processStart, ref processLength, characterBounds);

return removedCharacterCount - 1; }

private static void ProcessLine(ServerTextControl textControl, ref int processStart, ref int processLength, List characterBounds) { if (characterBounds.Count == 0) return;

textControl.Select(processStart, processLength);

if (textControl.Selection.Text.EndsWith(' ') || textControl.Selection.Text.EndsWith('\n')) { textControl.Selection.Length -= 1; characterBounds.RemoveAt(characterBounds.Count - 1); removedCharacterCount--; }

textControl.Selection.Text = "";

byte[] svgBytes = GenerateSVGForChars(characterBounds);

if (svgBytes.Length == 0) return;

using (MemoryStream ms = new MemoryStream(svgBytes, 0, svgBytes.Length, writable: false, publiclyVisible: true)) { TXTextControl.Image img = new TXTextControl.Image(ms); textControl.Images.Add(img, -1); } }

private static byte[] GenerateSVGForChars(List characterBounds) { if (characterBounds.Count == 0) return Array.Empty ();

var combinedBounds = GetBoundingRectangle(characterBounds);

float baselineAdjustment = characterBounds[0].Bottom - combinedBounds.Bottom; combinedBounds.Height -= baselineAdjustment;

return CreateRedactionSVG(combinedBounds.Size); }

private static RectangleF GetBoundingRectangle(List bounds) { float xMin = bounds.Min(b => b.Left); float yMin = bounds.Min(b => b.Top); float xMax = bounds.Max(b => b.Right); float yMax = bounds.Max(b => b.Bottom); return new RectangleF(xMin, yMin, xMax - xMin, yMax - yMin); }

private static byte[] CreateRedactionSVG(SizeF size) { size.Width /= 20; size.Height /= 20;

string svg = $" "; return Encoding.UTF8.GetBytes(svg); } } The code basically creates images for contiguous characters for each line and replaces the text with the generated images. For performance and space reasons, contiguous characters are bundled and a new image is generated when the selection breaks a line. The generated image height is also dynamically calculated so that all font sizes are covered by the image.

The following screenshot shows the redacted text with a dynamically generated SVG. The line height is adjusted accordingly.

Live Demo

We have published this as a live demo in our online demos for you to try.

Live Demo

Try it live in our online demos and select text to redact and create a finished PDF document.

Live Demo

Conclusion

Text redaction is a critical process in many industries to protect sensitive information. The process of redacting text in a document can be automated using TX Text Control. The API provides all the necessary information to identify text areas and replace them with dynamically generated SVG images. The resulting PDF document is 100% secure and the redacted text cannot be selected or copied.

Download the Redaction class code from GitHub and try it yourself.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

Redaction

Post tagged with Redaction in 2024

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

Redaction

Post tagged with Redaction in 2024 ​

November 2024

Post tagged with Redaction in 2024