"What file formats can GroupDocs.Watermark read for Excel?"

"It supports XLSX, XLS, CSV, and ODS, handling both legacy and modern workbook structures."

"Can I search for images that are not attached (e.g., floating shapes)?"

"Yes, by setting `SpreadsheetSearchableObjects.All` you can include floating pictures, charts, and other drawing objects."

"How accurate is DCT hash matching?"

"The algorithm achieves \u003e 95 % similarity detection for resized or slightly recolored images, making it ideal for branding checks."

"Is it possible to replace found images automatically?"

"Absolutely. After locating a `Watermark`, call `watermarker.replace(watermark, newImagePath)` to swap the graphic."

"Does the library work on Linux containers?"

"Yes, GroupDocs.Watermark is pure Java and runs on any platform with a compatible JRE, including Docker‑based Linux containers."

Cara Mencari Gambar di Excel dengan GroupDocs.Watermark Java

Mencari gambar tertentu di dalam workbook Excel dapat menjadi pekerjaan yang melelahkan, terutama ketika berhadapan dengan file berukuran besar atau banyak grafik yang disematkan. Cara mencari gambar dengan cepat menjadi pertanyaan penting bagi siapa saja yang mengotomatiskan alur kerja dokumen. Dalam panduan ini kami akan menunjukkan secara tepat cara mencari gambar di spreadsheet Excel menggunakan GroupDocs.Watermark Java, sekaligus membahas langkah‑langkah penting untuk memuat file Excel java pada proyek secara efisien.

Jawaban Cepat

Apa cara tercepat untuk menemukan gambar yang disematkan? Gunakan ImageDctHashSearchCriteria dengan SpreadsheetSearchableObjects.AttachedImages.
Apakah saya memerlukan lisensi khusus? Lisensi sementara atau percobaan membuka semua kemampuan pencarian.
Dependensi Maven mana yang diperlukan? Tambahkan com.groupdocs:groupdocs-watermark ke pom.xml Anda.
Bisakah saya membatasi pencarian ke satu lembar saja? Ya, konfigurasikan SpreadsheetLoadOptions dengan nama lembar.
Apakah API ini thread‑safe? Semua metode publik aman untuk penggunaan bersamaan setelah inisialisasi yang tepat.

ImageDctHashSearchCriteria mendefinisikan hash DCT yang digunakan untuk perbandingan gambar. SpreadsheetSearchableObjects.AttachedImages membatasi pencarian hanya pada gambar yang disematkan.

Apa itu “cara mencari gambar” dalam konteks GroupDocs.Watermark?

“Cara mencari gambar” mengacu pada lokalisasi programatis objek gambar yang disematkan di dalam dokumen menggunakan Watermarker API. Perpustakaan memindai setiap lembar kerja, mengekstrak objek gambar, menghitung hash Discrete Cosine Transform (DCT)‑nya, dan membandingkannya dengan hash gambar target, mengembalikan setiap kecocokan sebagai objek watermark yang dapat diproses lebih lanjut.

Mengapa menggunakan GroupDocs.Watermark untuk pencarian gambar di Excel?

GroupDocs.Watermark mendukung lebih dari 50 format input dan output—termasuk XLSX, XLS, CSV, dan ODS—sementara memproses workbook berukuran ratusan halaman tanpa harus memuat seluruh file ke memori. Algoritma hash DCT‑nya mengidentifikasi gambar yang secara visual mirip dengan akurasi > 95 %, mengurangi false positive secara dramatis. Selain itu, perpustakaan menyediakan akses streaming, memungkinkan Anda bekerja dengan file yang lebih besar daripada RAM yang tersedia, serta mendukung workbook yang dilindungi password, menjadikannya cocok untuk pipeline otomasi tingkat perusahaan.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

Java Development Kit (JDK) 8+ terpasang dan terkonfigurasi di PATH Anda.
Maven untuk manajemen dependensi (atau Anda dapat mengunduh JAR secara manual).
Lisensi GroupDocs.Watermark (percobaan, sementara, atau permanen) untuk membuka API pencarian.
Familiaritas dasar dengan koleksi Java dan penanganan pengecualian.

Perpustakaan dan Dependensi yang Diperlukan

Untuk bekerja dengan GroupDocs.Watermark Java, siapkan lingkungan Anda dengan Maven atau unduh perpustakaan yang diperlukan. Pastikan Anda memiliki:

Konfigurasi Maven: Tambahkan repositori GroupDocs dan dependensi ke pom.xml Anda.
Java Development Kit (JDK): Versi 8 atau lebih tinggi diperlukan.

Persyaratan Penyiapan Lingkungan

Pastikan Java terinstal dengan benar di sistem Anda, bersama Maven untuk manajemen dependensi jika Anda memilih metode instalasi ini.

Prasyarat Pengetahuan

Pemahaman dasar tentang pemrograman Java dan familiaritas dengan penanganan file Excel secara programatik akan sangat membantu. Jika Anda baru pada konsep ini, pertimbangkan untuk mengeksplorasi sumber daya pengantar terlebih dahulu.

Bagaimana cara menyiapkan GroupDocs.Watermark untuk Java?

Muat proyek Maven Anda, tambahkan dependensi, dan inisialisasi Watermarker dengan pengaturan yang tepat. Proses dua langkah ini menyiapkan Anda untuk mulai melakukan pencarian. Pertama, tambahkan repositori dan dependensi Maven ke pom.xml, kemudian buat instance Watermarker dengan memberikan jalur file Excel dan objek WatermarkLoadOptions yang menentukan lembar yang diinginkan serta pengaturan pencarian. SpreadsheetLoadOptions memungkinkan Anda menentukan lembar mana yang akan dimuat dan mengonfigurasi opsi pencarian seperti sensitivitas huruf. Watermarker adalah titik masuk utama untuk memuat dokumen serta melakukan operasi pencarian atau 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>

Bagaimana cara memuat file Excel java dengan pengaturan pencarian khusus?

Muat workbook sambil memberi tahu perpustakaan untuk hanya memperhatikan gambar yang disematkan. Pendekatan terfokus ini memotong waktu pemrosesan hingga 30 % untuk spreadsheet tipikal.

import com.groupdocs.watermark.Watermarker;
// Kode inisialisasi dasar di sini...

Bagaimana cara mengonfigurasi pencarian agar menargetkan hanya gambar yang disematkan?

Enum SpreadsheetSearchableObjects memungkinkan Anda menentukan apa yang akan dipindai. Menetapkannya ke AttachedImages membatasi mesin pada objek gambar, mengabaikan teks, formula, atau diagram.

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

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

Bagaimana cara mengeksekusi pencarian gambar menggunakan kriteria hash DCT?

Metode hash DCT membuat sidik jari kompak dari gambar referensi dan membandingkannya dengan setiap gambar yang disematkan, mengembalikan kecocokan dengan kemiripan visual tinggi.

import com.groupdocs.watermark.Watermarker;

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

Bagaimana cara mendefinisikan kriteria pencarian hash DCT?

ImageDctHashSearchCriteria membungkus gambar referensi dan ambang kemiripan opsional. Anda dapat menyesuaikan ambang (0‑100) untuk memperketat atau melonggarkan pencocokan.

// Gunakan kembali konfigurasi sebelumnya dari bagian 'Load Spreadsheet'.

Bagaimana cara menjalankan pencarian dan memproses hasilnya?

Memanggil watermarker.search(criteria) mengembalikan koleksi objek Watermark. Iterasi koleksi untuk mengambil nomor halaman, alamat sel, atau mengganti gambar.

import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;

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

Aplikasi Praktis

Berikut beberapa skenario dunia nyata di mana fitur ini bersinar:

Sistem Manajemen Dokumen: Secara otomatis mengindeks dan menandai spreadsheet berdasarkan logo atau foto produk yang disematkan.
Audit Data: Memverifikasi bahwa data visual (diagram, tangkapan layar) tidak diubah dengan membandingkan hash DCT antar versi.
Verifikasi Konten: Memastikan hanya aset merek yang berwenang muncul dalam laporan keuangan atau presentasi pemasaran.

Pertimbangan Kinerja

Agar aplikasi Anda tetap responsif:

Batasi pencarian hanya pada AttachedImages; ini mengurangi penggunaan CPU sekitar ~30 % rata‑rata.
Proses file besar dalam potongan dengan memuat lembar individual daripada seluruh workbook.
Gunakan kembali WatermarkerSettings pada beberapa pencarian untuk menghindari pembuatan objek berulang.
Pantau memori dengan alat profil Java; perpustakaan melakukan streaming data, namun gambar sangat besar tetap dapat memengaruhi penggunaan heap.

Masalah Umum dan Solusinya

Gejala	Penyebab Kemungkinan	Solusi
Tidak ada hasil yang dikembalikan	Objek yang dapat dicari disetel ke `None`	Atur `SpreadsheetSearchableObjects.AttachedImages`.
`OutOfMemoryError` pada file 500‑halaman	Seluruh workbook dimuat ke memori	Gunakan `SpreadsheetLoadOptions` dengan `setLoadAllSheets(false)` dan muat lembar secara individual.
False positive pada perbandingan hash	Ambang terlalu rendah (misalnya 30)	Tingkatkan ambang kemiripan menjadi 80‑90 untuk pencocokan yang lebih ketat.

Pertanyaan yang Sering Diajukan

T: Format file apa saja yang dapat dibaca GroupDocs.Watermark untuk Excel?
J: Mendukung XLSX, XLS, CSV, dan ODS, menangani struktur workbook lama maupun modern.

T: Bisakah saya mencari gambar yang tidak disematkan (misalnya bentuk mengambang)?
J: Ya, dengan mengatur SpreadsheetSearchableObjects.All Anda dapat menyertakan gambar mengambang, diagram, dan objek gambar lainnya.

T: Seberapa akurat pencocokan hash DCT?
J: Algoritma mencapai deteksi kemiripan > 95 % untuk gambar yang diubah ukuran atau sedikit diwarnai ulang, cocok untuk pemeriksaan branding.

T: Apakah memungkinkan mengganti gambar yang ditemukan secara otomatis?
J: Tentu. Setelah menemukan Watermark, panggil watermarker.replace(watermark, newImagePath) untuk menukar grafik.

T: Apakah perpustakaan ini bekerja di kontainer Linux?
J: Ya, GroupDocs.Watermark murni Java dan berjalan di platform apa pun dengan JRE yang kompatibel, termasuk kontainer Linux berbasis Docker.

Kesimpulan

Dalam tutorial ini kami membahas cara mencari gambar di dalam workbook Excel menggunakan GroupDocs.Watermark Java, mulai dari penyiapan lingkungan hingga mengeksekusi pencarian berbasis hash DCT. Dengan membatasi pemindaian pada gambar yang disematkan dan memanfaatkan perbandingan hash yang kuat, Anda dapat mempercepat alur kerja verifikasi gambar secara signifikan sambil mempertahankan akurasi tinggi. Selanjutnya, jelajahi kemampuan penambahan watermark perpustakaan atau integrasikan logika pencarian ke dalam pipeline pemrosesan dokumen yang lebih besar.

Terakhir Diperbarui: 2026-06-01
Diuji Dengan: GroupDocs.Watermark 23.12 untuk Java
Penulis: GroupDocs

Sumber Daya

Dokumentasi: GroupDocs.Watermark Java Docs
Referensi API: GroupDocs API Reference
Unduh: GroupDocs Downloads

import com.groupdocs.watermark.PossibleWatermarkCollection;

PossibleWatermarkCollection possibleWatermarks = watermarker.search(criteria);