วิธีค้นหารูปภาพใน Excel ด้วย GroupDocs.Watermark Java

การค้นหารูปภาพเฉพาะภายในสมุดงาน Excel อาจเป็นเรื่องยุ่งยาก โดยเฉพาะเมื่อทำงานกับไฟล์ขนาดใหญ่หรือกราฟิกที่ฝังจำนวนมาก How to search images กลายเป็นคำถามสำคัญสำหรับผู้ที่ทำงานอัตโนมัติของเอกสาร ในคู่มือนี้เราจะแสดงให้คุณเห็นอย่างชัดเจนวิธีค้นหารูปภาพในสเปรดชีต Excel ด้วย GroupDocs.Watermark Java พร้อมทั้งครอบคลุมขั้นตอนสำคัญในการ load Excel file java โครงการอย่างมีประสิทธิภาพ.

คำตอบด่วน

  • วิธีที่เร็วที่สุดในการค้นหารูปภาพที่ฝังอยู่คืออะไร? Use ImageDctHashSearchCriteria with SpreadsheetSearchableObjects.AttachedImages.
  • ฉันต้องการใบอนุญาตพิเศษหรือไม่? A temporary or trial license unlocks full search capabilities.
  • ต้องการ dependency ของ Maven ใด? Add com.groupdocs:groupdocs-watermark to your pom.xml.
  • ฉันสามารถจำกัดการค้นหาให้เป็นแผ่นเดียวได้หรือไม่? Yes, configure SpreadsheetLoadOptions with the sheet name.
  • API ปลอดภัยต่อการทำงานหลายเธรดหรือไม่? All public methods are safe for concurrent use after proper initialization.

ImageDctHashSearchCriteria กำหนด DCT hash ที่ใช้สำหรับการเปรียบเทียบรูปภาพ SpreadsheetSearchableObjects.AttachedImages จำกัดการค้นหาให้เฉพาะรูปภาพที่ฝังอยู่.

“how to search images” คืออะไรในบริบทของ GroupDocs.Watermark?

“How to search images” หมายถึงการค้นหาออบเจ็กต์รูปภาพที่ฝังอยู่ภายในเอกสารโดยใช้ Watermarker API อย่างโปรแกรมเมติก ไลบรารีจะสแกนแต่ละแผ่นงาน ดึงออบเจ็กต์รูปภาพ คำนวณ Discrete Cosine Transform (DCT) hash ของมัน และเปรียบเทียบกับ hash ของรูปภาพเป้าหมาย แล้วคืนค่าการจับคู่ใด ๆ เป็นออบเจ็กต์ watermark ที่สามารถประมวลผลต่อได้.

ทำไมต้องใช้ GroupDocs.Watermark สำหรับการค้นหารูปภาพใน Excel?

GroupDocs.Watermark รองรับ 50+ รูปแบบไฟล์เข้าและออก — รวมถึง XLSX, XLS, CSV, และ ODS — ในขณะที่ประมวลผลสมุดงานหลายร้อยหน้าโดยไม่ต้องโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ อัลกอริธึม DCT‑hash ของมันสามารถระบุรูปภาพที่คล้ายกันด้วยความแม่นยำ > 95 % ลดผลบวกเท็จอย่างมาก นอกจากนี้ไลบรารียังให้การเข้าถึงแบบสตรีมมิ่ง ทำให้คุณทำงานกับไฟล์ที่ใหญ่กว่าหน่วยความจำที่มีอยู่ได้ และมีการสนับสนุนในตัวสำหรับสมุดงานที่มีรหัสผ่าน ทำให้เหมาะกับการทำงานอัตโนมัติระดับองค์กร.

ข้อกำหนดเบื้องต้น

ก่อนเริ่มทำงาน โปรดตรวจสอบว่าคุณมี:

  • Java Development Kit (JDK) 8+ ติดตั้งและกำหนดค่าใน PATH ของคุณ.
  • Maven สำหรับการจัดการ dependency (หรือคุณสามารถดาวน์โหลด JARs ด้วยตนเอง).
  • ใบอนุญาต GroupDocs.Watermark (ทดลอง, ชั่วคราว หรือถาวร) เพื่อเปิดใช้งาน API การค้นหา.
  • ความคุ้นเคยพื้นฐานกับคอลเลกชันของ Java และการจัดการข้อยกเว้น.

ไลบรารีและ Dependency ที่จำเป็น

เพื่อทำงานกับ GroupDocs.Watermark Java ให้ตั้งค่าสภาพแวดล้อมของคุณด้วย Maven หรือดาวน์โหลดไลบรารีที่จำเป็น ตรวจสอบให้แน่ใจว่ามี:

  • การกำหนดค่า Maven: เพิ่มรีโพซิทอรีของ GroupDocs และ dependency ลงใน pom.xml ของคุณ.
  • Java Development Kit (JDK): ต้องเป็นเวอร์ชัน 8 หรือสูงกว่า.

ความต้องการในการตั้งค่าสภาพแวดล้อม

ตรวจสอบให้แน่ใจว่า Java ถูกติดตั้งอย่างถูกต้องบนระบบของคุณ พร้อมกับ Maven สำหรับการจัดการ dependency หากคุณเลือกวิธีการติดตั้งนี้.

ความรู้เบื้องต้นที่จำเป็น

ความเข้าใจพื้นฐานเกี่ยวกับการเขียนโปรแกรม Java และการจัดการไฟล์ Excel อย่างโปรแกรมเมติกจะเป็นประโยชน์ หากคุณยังใหม่กับแนวคิดเหล่านี้ ควรสำรวจแหล่งข้อมูลเบื้องต้นก่อน.

วิธีตั้งค่า GroupDocs.Watermark สำหรับ Java?

โหลดโปรเจกต์ Maven ของคุณ เพิ่ม dependency แล้วเริ่มต้น Watermarker ด้วยการตั้งค่าที่เหมาะสม กระบวนการสองขั้นตอนนี้จะทำให้คุณพร้อมเริ่มค้นหา ขั้นแรกให้เพิ่มรีโพซิทอรีและ dependency ลงใน pom.xml ของคุณ แล้วสร้างอินสแตนซ์ Watermarker โดยส่งพาธไฟล์ Excel และออบเจ็กต์ WatermarkLoadOptions ที่ระบุแผ่นและการตั้งค่าการค้นหาที่ต้องการ SpreadsheetLoadOptions ให้คุณระบุแผ่นที่ต้องการโหลดและกำหนดตัวเลือกการค้นหา เช่น ความไวต่อขนาดอักษร Watermarker เป็นจุดเริ่มต้นหลักสำหรับการโหลดเอกสารและทำการค้นหา หรือการใส่ watermark.

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

วิธีโหลดไฟล์ Excel ด้วย Java พร้อมการตั้งค่าการค้นหาเฉพาะ?

โหลดสมุดงานพร้อมบอกไลบรารีให้มองหาเฉพาะรูปภาพที่ฝังอยู่ วิธีนี้ช่วยลดเวลาในการประมวลผลได้ถึง 30 % สำหรับสเปรดชีตทั่วไป.

import com.groupdocs.watermark.Watermarker;
// Basic initialization code here...

วิธีกำหนดค่าการค้นหาให้มุ่งเป้าเฉพาะรูปภาพที่ฝังอยู่?

Enum SpreadsheetSearchableObjects ให้คุณระบุสิ่งที่ต้องสแกนอย่างชัดเจน การตั้งค่าเป็น AttachedImages จะจำกัดเอนจินให้สแกนเฉพาะออบเจ็กต์รูปภาพ ไม่สนใจข้อความ สูตร หรือแผนภูมิ.

import com.groupdocs.watermark.WatermarkerSettings;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

WatermarkerSettings settings = new WatermarkerSettings();
settings.getSearchableObjects().setSpreadsheetSearchableObjects(SpreadsheetSearchableObjects.AttachedImages);

วิธีดำเนินการค้นหารูปภาพโดยใช้เกณฑ์ DCT hash?

วิธี DCT‑hash สร้างลายนิ้วมือขนาดกะทัดรัดของรูปอ้างอิงและเปรียบเทียบกับรูปภาพที่ฝังแต่ละรูป ส่งคืนผลลัพธ์ที่มีความคล้ายคลึงกันสูง.

import com.groupdocs.watermark.Watermarker;

String filePath = "YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx";
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker(filePath, loadOptions, settings);

วิธีกำหนดเกณฑ์การค้นหา DCT hash?

ImageDctHashSearchCriteria รวมรูปอ้างอิงและค่าขีดจำกัดความคล้าย (threshold) ที่กำหนดได้ คุณสามารถปรับ threshold (0‑100) เพื่อทำให้การจับคู่เข้มงวดหรือผ่อนคลายขึ้น.

// Reuse the previous configuration from the 'Load Spreadsheet' section.

วิธีรันการค้นหาและประมวลผลผลลัพธ์?

การเรียก watermarker.search(criteria) จะคืนคอลเลกชันของออบเจ็กต์ Watermark วนลูปผ่านคอลเลกชันเพื่อดึงหมายเลขหน้า ที่อยู่เซลล์ หรือแทนที่รูปภาพได้.

import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;

String imagePath = "YOUR_DOCUMENT_DIRECTORY/sample_image.png";
ImageDctHashSearchCriteria criteria = new ImageDctHashSearchCriteria(imagePath);

การประยุกต์ใช้งานจริง

ต่อไปนี้เป็นสถานการณ์จริงที่คุณลักษณะเหล่านี้ทำให้เกิดประโยชน์:

  1. ระบบจัดการเอกสาร: ทำดัชนีและแท็กสเปรดชีตอัตโนมัติตามโลโก้หรือรูปสินค้าแบบฝัง.
  2. การตรวจสอบข้อมูล: ตรวจสอบว่าข้อมูลภาพ (แผนภูมิ, ภาพหน้าจอ) ไม่ถูกแก้ไขโดยเปรียบเทียบ DCT hash ระหว่างเวอร์ชัน.
  3. การตรวจสอบเนื้อหา: รับประกันว่ามีเพียงสินทรัพย์แบรนด์ที่ได้รับอนุญาตปรากฏในรายงานการเงินหรือสไลด์การตลาด.

ข้อควรพิจารณาด้านประสิทธิภาพ

เพื่อให้แอปพลิเคชันของคุณทำงานเร็ว:

  • จำกัดการค้นหา ให้เป็น AttachedImages เท่านั้น; จะลดการใช้ CPU ประมาณ ~30 % เฉลี่ย.
  • ประมวลผลไฟล์ขนาดใหญ่ เป็นชิ้นโดยโหลดแต่ละแผ่นแทนการโหลดสมุดงานทั้งหมด.
  • ใช้ WatermarkerSettings ซ้ำ ในการค้นหาหลายครั้งเพื่อหลีกเลี่ยงการสร้างออบเจ็กต์ใหม่บ่อย.
  • ตรวจสอบหน่วยความจำ ด้วยเครื่องมือ profiling ของ Java; ไลบรารีสตรีมข้อมูลได้ แต่รูปภาพขนาดใหญ่อาจยังคงใช้ heap มาก.

ปัญหาทั่วไปและวิธีแก้

อาการสาเหตุที่เป็นไปได้วิธีแก้
ไม่ได้ผลลัพธ์ใด ๆตั้งค่า searchable objects เป็น Noneตั้งค่า SpreadsheetSearchableObjects.AttachedImages.
OutOfMemoryError บนไฟล์ 500‑หน้าโหลดสมุดงานทั้งหมดเข้าสู่หน่วยความจำใช้ SpreadsheetLoadOptions กับ setLoadAllSheets(false) แล้วโหลดแผ่นแยกกัน.
ผลบวกเท็จในการเปรียบเทียบ hashThreshold ต่ำเกินไป (เช่น 30)เพิ่ม threshold ความคล้ายเป็น 80‑90 เพื่อให้เข้มงวดขึ้น.

คำถามที่พบบ่อย

Q: GroupDocs.Watermark รองรับรูปแบบไฟล์อะไรบ้างสำหรับ Excel?
A: รองรับ XLSX, XLS, CSV, และ ODS ทั้งโครงสร้างสมุดงานเก่าและใหม่.

Q: ฉันสามารถค้นหารูปภาพที่ไม่ได้ฝัง (เช่น รูปแบบลอย) ได้หรือไม่?
A: ได้ โดยตั้งค่า SpreadsheetSearchableObjects.All เพื่อรวมรูปภาพลอย, แผนภูมิ, และออบเจ็กต์วาดอื่น ๆ.

Q: DCT hash มีความแม่นยำเท่าไหร่?
A: อัลกอริธึมให้การตรวจจับความคล้าย > 95 % สำหรับรูปภาพที่ปรับขนาดหรือเปลี่ยนสีเล็กน้อย, เหมาะสำหรับการตรวจสอบแบรนด์.

Q: สามารถแทนที่รูปภาพที่พบโดยอัตโนมัติได้หรือไม่?
A: แน่นอน หลังจากค้นพบ Watermark ให้เรียก watermarker.replace(watermark, newImagePath) เพื่อสลับกราฟิก.

Q: ไลบรารีทำงานบนคอนเทนเนอร์ Linux ได้หรือไม่?
A: ใช่, GroupDocs.Watermark เป็น Java แท้ ๆ ทำงานบนแพลตฟอร์มใด ๆ ที่มี JRE ที่เข้ากันได้ รวมถึงคอนเทนเนอร์ Docker‑based Linux.

สรุป

ในบทแนะนำนี้เราได้อธิบาย วิธีค้นหารูปภาพ ภายในสมุดงาน Excel ด้วย GroupDocs.Watermark Java ตั้งแต่การตั้งค่าสภาพแวดล้อมจนถึงการดำเนินการค้นหาแบบ DCT‑hash โดยการจำกัดการสแกนให้เป็นรูปภาพที่ฝังอยู่และใช้การเปรียบเทียบ hash ที่ทรงพลัง คุณจะสามารถเร่งกระบวนการตรวจสอบรูปภาพได้อย่างมากในขณะที่รักษาความแม่นยำสูง ต่อไปลองสำรวจความสามารถในการเพิ่ม watermark หรือผสานตรรกะการค้นหาเข้ากับไพป์ไลน์การประมวลผลเอกสารที่ใหญ่ขึ้น.

อัปเดตล่าสุด: 2026-06-01
ทดสอบด้วย: GroupDocs.Watermark 23.12 for Java
ผู้เขียน: GroupDocs

แหล่งข้อมูล

import com.groupdocs.watermark.PossibleWatermarkCollection;

PossibleWatermarkCollection possibleWatermarks = watermarker.search(criteria);

แหล่งข้อมูล

บทแนะนำที่เกี่ยวข้อง