GroupDocs.Redaction Java: คู่มือการทำ Grayscale Rasterization

Introduction

หากคุณต้องการ สร้างไฟล์ pdf แบบสีเทา พร้อมกับรักษาความปลอดภัยและความเป็นมืออาชีพของเอกสารไว้ คุณมาถูกที่แล้ว ในบทเรียนนี้เราจะพาคุณผ่านขั้นตอนที่แน่นอนเพื่อแปลงไฟล์ DOCX, PDF หรือไฟล์ที่รองรับอื่น ๆ ที่มีสีสันให้เป็นเวอร์ชันสีเทาที่แรสเตอร์ไลซ์โดยใช้ GroupDocs.Redaction สำหรับ Java คุณจะได้เรียนรู้ว่าทำไมการแรสเตอร์ไลซ์จึงเพิ่มชั้นความปลอดภัยเพิ่มเติม วิธีการตั้งค่าห้องสมุด และวิธีจัดการทรัพยากรอย่างมีประสิทธิภาพ—all ในสไตล์สนทนาแบบขั้นตอนต่อขั้นตอน

Quick Answers

  • Grayscale rasterization ทำอะไร? มันจะแปลงแต่ละหน้าของเอกสารเป็นภาพความละเอียดสูงแล้วใส่ฟิลเตอร์สีเทา เพื่อลบข้อมูลสีทั้งหมดออก
  • ทำไมต้องใช้ GroupDocs.Redaction สำหรับเรื่องนี้? มันรวมความปลอดภัยของการลบข้อมูล (redaction) กับตัวเลือกการแรสเตอร์ไลซ์ที่ทรงพลังไว้ใน API เดียว
  • ฟอร์แมตที่รองรับมีอะไรบ้าง? DOCX, PDF, XLSX, PPTX, RTF และอื่น ๆ อีกมากมาย
  • ต้องมีลิขสิทธิ์หรือไม่? จำเป็นต้องมีลิขสิทธิ์ GroupDocs.Redaction ที่ใช้งานได้สำหรับการผลิต; มีรุ่นทดลองสำหรับการทดสอบ
  • ต้องใช้ Java เวอร์ชันใด? JDK 8 หรือสูงกว่า

What is create grayscale pdf?

การสร้าง PDF แบบสีเทาหมายถึงการแปลงทุกองค์ประกอบภาพของเอกสารต้นฉบับให้เป็นเฉดสีเทา ผลลัพธ์คือไฟล์ที่มีขนาดเล็กกว่าและเหมาะสำหรับการพิมพ์ ซึ่งกำจัดการรบกวนจากสีและให้ประโยชน์ด้านความปลอดภัยเล็กน้อยเนื่องจากเนื้อหาเป็นรูปภาพแล้ว

Why use grayscale rasterization with GroupDocs.Redaction?

  • ความปลอดภัยที่เพิ่มขึ้น – หน้าแรสเตอร์ไลซ์ไม่สามารถเลือก, คัดลอก หรือแก้ไขเป็นข้อความได้
  • ลักษณะที่สม่ำเสมอ – สีถูกลบออก ทำให้ดูเป็นระเบียบและเป็นมืออาชีพ
  • รองรับฟอร์แมตหลากหลาย – API เดียวทำงานกับ DOCX, PDF, PPTX และอื่น ๆ
  • การควบคุมที่ละเอียด – คุณสามารถปรับ DPI, ฟอร์แมตผลลัพธ์, และตัวเลือกขั้นสูงเช่นการแปลงเป็นสีเทาได้

Prerequisites

  • Java Development Kit (JDK) 8 หรือใหม่กว่า ตรวจสอบด้วย java -version
  • IDE (IntelliJ IDEA, Eclipse หรือ NetBeans) เพื่อความสะดวกในการเขียนโค้ดและดีบัก
  • GroupDocs.Redaction สำหรับ Java ที่เพิ่มผ่าน Maven หรือ Gradle
  • ตัวอย่างเอกสาร (เช่น DOCX หลายหน้า) ที่คุณสามารถทดลองได้อย่างปลอดภัย
  • พื้นที่ดิสก์เพียงพอสำหรับผลลัพธ์ที่แรสเตอร์ไลซ์ (ไฟล์แรสเตอร์อาจใหญ่ก่าไฟล์ต้นฉบับ)

Import Packages

การตั้งค่าการนำเข้าให้ถูกต้องเหมือนกับการจัดระเบียบกล่องเครื่องมือก่อนเริ่มโครงการ การนำเข้าต่อไปนี้จะให้คุณเข้าถึงคลาส Redactor หลักและตัวเลือกการแรสเตอร์ไลซ์ที่เราต้องใช้

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.RasterizationOptions;
import com.groupdocs.redaction.options.AdvancedRasterizationOptions;

Step 1: Initialize the Redactor Object

การสร้างอินสแตนซ์ Redactor จะเปิดประตูสู่ความสามารถทั้งหมดในการประมวลผลเอกสาร

final Redactor redactor = new Redactor(Constants.MULTIPAGE_SAMPLE_DOCX);

เปลี่ยน Constants.MULTIPAGE_SAMPLE_DOCX ให้เป็นพาธของไฟล์ที่คุณต้องการแปลงเป็น PDF สีเทา

Step 2: Configure Save Options

SaveOptions กำหนดวิธีการเขียนไฟล์สุดท้าย การเพิ่ม suffix ช่วยให้คุณเก็บไฟล์ต้นฉบับไว้ไม่เปลี่ยนแปลง

SaveOptions so = new SaveOptions();
so.setRedactedFileSuffix("_scan");

ผลลัพธ์จะถูกตั้งชื่อเป็น yourfile_scan.docx (หรือฟอร์แมตที่คุณระบุในภายหลัง)

Step 3: Enable Rasterization

การเปิดใช้งานการแรสเตอร์ไลซ์บอกให้เอนจินเรนเดอร์แต่ละหน้าเป็นภาพก่อนบันทึก

so.getRasterization().setEnabled(true);

การแรสเตอร์ไลซ์เป็นพื้นฐานสำหรับการสร้าง PDF สีเทา เพราะมันแปลงเอกสารเป็นรูปแบบภาพ

Step 4: Apply Grayscale Conversion

ตอนนี้เราจะเพิ่มฟิลเตอร์สีเทาเข้าไปใน pipeline ของการแรสเตอร์ไลซ์

so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Grayscale);

ตัวเลือกนี้บังคับให้พิกเซลทุกตัวถูกเรนเดอร์เป็นเฉดสีเทา ทำให้คุณได้ผลลัพธ์ create grayscale pdf ที่ต้องการ

Step 5: Execute the Document Transformation

คำสั่ง save จะรันโซ่การประมวลผลทั้งหมด

redactor.save(so);

หลังจากบรรทัดนี้ทำงานเสร็จ คุณจะพบไฟล์ใหม่บนดิสก์ที่แรสเตอร์ไลซ์เต็มรูปแบบ, เป็นสีเทา, และบันทึกด้วย suffix _scan

Step 6: Proper Resource Management

การทำความสะอาดทรัพยากรช่วยป้องกันไฟล์ล็อกและการรั่วไหลของหน่วยความจำ

finally { redactor.close(); }

สำหรับ Java รุ่นใหม่คุณยังสามารถใช้รูปแบบ try‑with‑resources ที่ปิด Redactor โดยอัตโนมัติ:

try (Redactor redactor = new Redactor(Constants.MULTIPAGE_SAMPLE_DOCX)) {
    // Your processing code here
}
// Automatic cleanup happens here

ทั้งสองวิธีปลอดภัย; วิธีหลังสั้นกว่า

Advanced Configuration Options

Adjust DPI for Quality or Size

DPI ที่สูงกว่าจะให้ภาพคมชัดขึ้น (เหมาะสำหรับการพิมพ์) ส่วน DPI ที่ต่ำจะลดขนาดไฟล์

saveOptions.getRasterization().setDpi(300); // High quality for printing
// or
saveOptions.getRasterization().setDpi(150); // Balanced quality and size

Choose an Output Format

คุณสามารถบังคับผลลัพธ์ที่แรสเตอร์ไลซ์ให้เป็นคอนเทนเนอร์ฟอร์แมตเฉพาะ เช่น PDF

saveOptions.setRasterizationFormat(RasterizationFormat.PDF);

Common Use Cases

  • การเก็บเอกสารทางกฎหมาย – สร้าง PDF สีเทาแบบไม่เปลี่ยนแปลงที่ไม่สามารถแก้ไขได้
  • รายงานพร้อมพิมพ์ – รับประกันผลลัพธ์ขาว‑ดำที่สม่ำเสมอสำหรับการพิมพ์จำนวนมาก
  • กระบวนการปฏิบัติตามกฎ – ผสานการลบข้อมูลกับการแรสเตอร์ไลซ์สีเทาเพื่อให้สอดคล้องกับระเบียบความเป็นส่วนตัวของข้อมูลที่เข้มงวด

Common Issues and Solutions

IssueWhy it HappensFix
ไฟล์ผลลัพธ์ใหญ่กว่าที่คาดตั้ง DPI สูงเกินไปหรือปิดการบีบอัดภาพลด DPI (เช่น 150) หรือเปิดการบีบอัดใน RasterizationOptions
ข้อความดูเบลอDPI ไม่เพียงพอสำหรับขนาดฟอนต์ต้นฉบับเพิ่ม DPI เป็น 300 หรือสูงกว่า
กระบวนการโยน OutOfMemoryError กับเอกสารขนาดใหญ่โหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำใช้ API สตรีมมิ่งหรือประมวลผลหน้าเป็นชุดถ้ารองรับ
ไม่ได้แปลงเป็นสีเทาตัวเลือกขั้นสูงไม่ได้เพิ่มอย่างถูกต้องตรวจสอบว่าเรียก addAdvancedOption(AdvancedRasterizationOptions.Grayscale) ก่อน save()

Frequently Asked Questions

Q: สามารถแปลงเอกสารเป็นสีเทาโดยไม่แรสเตอร์ไลซ์ได้หรือไม่?
A: ใน GroupDocs.Redaction ตัวเลือกสีเทาถูกผูกกับการแรสเตอร์ไลซ์ ซึ่งทำให้ผลลัพธ์สม่ำเสมอและเพิ่มความปลอดภัย

Q: ฟอร์แมตเอกสารใดบ้างที่รองรับการแรสเตอร์ไลซ์สีเทา?
A: ฟอร์แมตหลักทั้งหมดที่ GroupDocs.Redaction รองรับรวมถึง DOCX, PDF, XLSX, PPTX, RTF และอื่น ๆ สามารถแรสเตอร์ไลซ์และแปลงเป็นสีเทาได้

Q: การแรสเตอร์ไลซ์จะส่งผลต่อขนาดไฟล์ของเอกสารหรือไม่?
A: ใช่ ไฟล์ที่มีข้อความเป็นส่วนใหญ่อาจเพิ่มขนาดขึ้น ในขณะที่ไฟล์ที่มีรูปภาพเป็นส่วนใหญ่อาจลดลง การตั้งค่า DPI มีผลมากที่สุด

Q: สามารถย้อนกลับกระบวนการแรสเตอร์ไลซ์สีเทาได้หรือไม่?
A: ไม่ได้ การแรสเตอร์ไลซ์เป็นกระบวนการทางเดียว; ควรเก็บสำเนาไฟล์ต้นฉบับไว้หากต้องการกลับสู่สภาพเดิม

Q: จะปรับคุณภาพของเอกสารที่แรสเตอร์ไลซ์สีเทาอย่างไร?
A: ใช้ DPI สูงกว่า (300 + สำหรับคุณภาพการพิมพ์) และเลือกฟอร์แมตผลลัพธ์ที่เหมาะสม (PDF เป็นที่นิยมสำหรับการเก็บรักษา)

Conclusion

คุณมีสูตรครบถ้วนพร้อมใช้งานในระดับผลิตภัณฑ์เพื่อ create grayscale pdf ด้วย GroupDocs.Redaction สำหรับ Java แล้ว ด้วยการเปิดใช้งานการแรสเตอร์ไลซ์, เพิ่มตัวเลือกขั้นสูงสีเทา, และจัดการทรัพยากรอย่างรับผิดชอบ คุณสามารถผลิตเอกสารที่ปลอดภัย, พร้อมพิมพ์, และสอดคล้องกับมาตรฐานการปฏิบัติตามได้


Last Updated: 2026-02-13
Tested With: GroupDocs.Redaction 23.11 for Java
Author: GroupDocs