"Can I add a watermark to a password‑protected PDF?"

"Yes. Load the document with `Watermark.load(path, new LoadOptions(password))` and the API will decrypt it for processing."

"Does GroupDocs.Watermark support SVG images?"

"The library can rasterize SVG files into PNG before embedding, but native SVG insertion is not currently available."

"How many pages can be processed in a single call?"

"The API can handle documents with **500+ pages** without loading the entire file into memory, thanks to its streaming architecture."

"Is it possible to add multiple different watermarks to the same document?"

"Absolutely. Create separate `Watermark` objects for each image and call `document.add(watermark)` for each one."

"What platforms are supported for the Java SDK?"

"Windows, Linux, and macOS are all supported, and the library works with any JVM‑compatible environment, including Docker containers."

Προσθήκη υδατογραφήματος εικόνας σε Java με το GroupDocs.Watermark: ένας ολοκληρωμένος οδηγός

Η προσθήκη υδατογραφήματος εικόνας σε Java είναι μια κοινή απαίτηση για την προστασία της ταυτότητας της μάρκας και τη διασφάλιση της αυθεντικότητας των εγγράφων. Σε αυτό το σεμινάριο θα ανακαλύψετε πώς να add image watermark java χρησιμοποιώντας τη βιβλιοθήκη GroupDocs.Watermark, καλύπτοντας τα πάντα από τη φόρτωση του αρχείου εικόνας μέχρι την αναζήτηση υπαρχόντων υδατογραφημάτων και την αντικατάστασή τους με νέα γραφικά. Στο τέλος, θα έχετε ένα επαναχρησιμοποιήσιμο μοτίβο που λειτουργεί σε PDF, αρχεία Word και έγγραφα βασισμένα σε εικόνες.

Γρήγορες απαντήσεις

Ποια βιβλιοθήκη διαχειρίζεται υδατογραφήματα εικόνας σε Java; GroupDocs.Watermark for Java.
Χρειάζομαι άδεια για παραγωγική χρήση; Ναι, μια εμπορική άδεια αφαιρεί τους περιορισμούς της δοκιμαστικής έκδοσης.
Μπορώ να δουλέψω με PDF και αρχεία Office; Ναι, το API υποστηρίζει περισσότερα από 30 μορφές.
Ποια έκδοση της Java απαιτείται; JDK 8 ή νεότερη.
Είναι το Maven ο μοναδικός τρόπος για να προσθέσετε την εξάρτηση; Το Maven συνιστάται, αλλά μπορείτε επίσης να κατεβάσετε το JAR χειροκίνητα.

Τι είναι το add image watermark java;

add image watermark java αναφέρεται στη διαδικασία ενσωμάτωσης μιας ραστερ γραφικής (PNG, JPEG, BMP, κ.λπ.) σε ένα έγγραφο προγραμματιστικά χρησιμοποιώντας κώδικα Java. Αυτή η τεχνική σας επιτρέπει να επικάθετε λογότυπα, ειδοποιήσεις πνευματικών δικαιωμάτων ή σφραγίδες ασφαλείας χωρίς να αλλάζετε τη διάταξη του αρχικού περιεχομένου.

Γιατί να χρησιμοποιήσετε το GroupDocs.Watermark για Java;

Το GroupDocs.Watermark υποστηρίζει πάνω από 30 μορφές εισόδου και εξόδου — συμπεριλαμβανομένων PDF, DOCX, XLSX, PPTX και κοινών τύπων εικόνων — ενώ επεξεργάζεται αρχεία με εκατοντάδες σελίδες χωρίς να φορτώνει ολόκληρο το έγγραφο στη μνήμη. Η μηχανή αναζήτησης βάσει κατακερματισμού της βιβλιοθήκης μπορεί να εντοπίζει υδατογραφήματα με > 95 % ακρίβεια, μειώνοντας τον χρόνο σάρωσης μεγάλων αρχείων έως και 70 %.

Προαπαιτούμενα

Java Development Kit (JDK): έκδοση 8 ή νεότερη εγκατεστημένη.
GroupDocs.Watermark for Java: έκδοση 24.11 (η έκδοση που χρησιμοποιείται σε αυτόν τον οδηγό).
Maven: για διαχείριση εξαρτήσεων, αν και η χειροκίνητη λήψη του JAR λειτουργεί επίσης.

Αν είστε νέοι στο Maven, το απόσπασμα pom.xml παρακάτω δείχνει ακριβώς τι πρέπει να προσθέσετε.

Ρύθμιση Maven

Προσθέστε την παρακάτω διαμόρφωση στο pom.xml σας για να συμπεριλάβετε το GroupDocs.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>

Άμεση λήψη

Εναλλακτικά, μπορείτε να κατεβάσετε την πιο πρόσφατη έκδοση απευθείας από GroupDocs.Watermark for Java releases.

Απόκτηση άδειας

Δωρεάν δοκιμή: Κατεβάστε ένα δοκιμαστικό πακέτο για να εξερευνήσετε τις βασικές λειτουργίες.
Προσωρινή άδεια: Αποκτήστε ένα κλειδί περιορισμένου χρόνου για εκτεταμένη δοκιμή από το portal του GroupDocs.
Εμπορική άδεια: Αγοράστε πλήρη άδεια για απεριόριστη παραγωγική χρήση και προτεραιότητα στην υποστήριξη.

Πώς να προσθέσετε υδατογράφημα εικόνας java βήμα προς βήμα

Η κλάση Watermark αντιπροσωπεύει ένα έγγραφο που μπορεί να υποβληθεί σε επεξεργασία για λειτουργίες υδατογραφήματος. Το ImageSearchOptions διαμορφώνει κριτήρια για τον εντοπισμό υδατογραφημάτων εικόνας. Το WatermarkSearchResult περιέχει τη συλλογή των υδατογραφημάτων που βρέθηκαν από μια αναζήτηση. Η μέθοδος setImage() αντικαθιστά την εικόνα ενός υδατογραφήματος, και το document.save() γράφει το τροποποιημένο έγγραφο στο δίσκο.

Φορτώστε το στοχευόμενο έγγραφο, εντοπίστε τυχόν υπάρχοντα υδατογραφήματα και αντικαταστήστε τα με μια νέα εικόνα — όλα σε τρία σύντομα βήματα. Η παρακάτω άμεση απάντηση εξηγεί τη γενική ροή πριν εμβαθύνετε σε κάθε ξεχωριστό κομμάτι.

Φορτώστε το PDF (ή άλλο υποστηριζόμενο αρχείο) με Watermark.load(), διαμορφώστε ένα αντικείμενο ImageSearchOptions για να βρείτε υδατογραφήματα που ταιριάζουν με έναν δοσμένο κατακερματισμό, επαναλάβετε τη συλλογή που επιστρέφεται, καλέστε setImage() με το νέο byte array σας, και τέλος αποθηκεύστε το τροποποιημένο έγγραφο με save(). Αυτό το μοτίβο λειτουργεί για PDF, Word, Excel, PowerPoint και αρχεία εικόνας, και εξασφαλίζει ότι μόνο τα επιθυμητά υδατογραφήματα τροποποιούνται.

Βήμα 1: φόρτωση αρχείου εικόνας java

Για να αντικαταστήσετε ένα υδατογράφημα, πρώτα χρειάζεστε τη νέα εικόνα ως byte array. Ο κώδικας παρακάτω διαβάζει οποιοδήποτε αρχείο εικόνας από το δίσκο στη μνήμη, το οποίο μπορείτε στη συνέχεια να δώσετε στο API του υδατογραφήματος.

import com.groupdocs.watermark.Watermarker;

public class Main {
    public static void main(String[] args) {
        Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_PATH.pdf");
        // Proceed to use GroupDocs.Watermark functionalities.
    }
}

Εξήγηση: Το απόσπασμα χρησιμοποιεί ένα FileInputStream τυλιγμένο σε μπλοκ try‑with‑resources, εξασφαλίζοντας ότι η ροή κλείνει αυτόματα. Αυτό αποτρέπει διαρροές χειριστών αρχείων, κάτι ιδιαίτερα σημαντικό όταν επεξεργάζεστε πολλά έγγραφα σε παρτίδα.

Βήμα 2: αναζήτηση υδατογραφημάτων σε ένα έγγραφο

Στη συνέχεια, διαμορφώστε τα κριτήρια αναζήτησης ώστε η μηχανή να γνωρίζει ποια υδατογραφήματα να στοχεύσει. Μπορείτε να ταιριάξετε με βάση τον κατακερματισμό εικόνας, το μέγεθος ή τη διαφάνεια· το παρακάτω παράδειγμα χρησιμοποιεί μια προσέγγιση βάσει κατακερματισμού για υψηλή ακρίβεια.

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

public class LoadImageData {
    private static final String IMAGE_PNG_PATH = "YOUR_DOCUMENT_DIRECTORY/image.png";

    public byte[] loadImageData() throws Exception {
        File imageFile = new File(IMAGE_PNG_PATH);
        byte[] imageData = new byte[(int) imageFile.length()];
        try (InputStream imageInputStream = new FileInputStream(imageFile)) {
            imageInputStream.read(imageData); // Read the file into the byte array.
        }
        return imageData;
    }
}

Εξήγηση: Η Watermark.search() επιστρέφει μια συλλογή WatermarkSearchResult. Παρέχοντας ένα αντικείμενο ImageSearchOptions με τον κατακερματισμό του αρχικού υδατογραφήματος, το API φιλτράρει τα μη σχετιζόμενα γραφικά, δίνοντάς σας μια καθαρή λίστα αντιστοιχίσεων.

Βήμα 3: αντικατάσταση εικόνας στα υδατογραφήματα

Τέλος, επαναλάβετε τα βρεθέντα υδατογραφήματα και αντικαταστήστε τα δεδομένα εικόνας του καθενός με το νέο byte array που δημιουργήσατε στο Βήμα 1. Μετά την ενημέρωση, αποθηκεύστε το έγγραφο σε νέο αρχείο για να διατηρήσετε το αρχικό.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class SearchForWatermarks {
    private static final String INPUT_PDF_PATH = "YOUR_DOCUMENT_DIRECTORY/document.pdf";

    public PossibleWatermarkCollection searchWatermarks() throws Exception {
        Watermarker watermarker = new Watermarker(INPUT_PDF_PATH);
        ImageDctHashSearchCriteria searchCriteria = new ImageDctHashSearchCriteria("YOUR_DOCUMENT_DIRECTORY/logo.bmp");
        
        return watermarker.search(searchCriteria);
    }
}

Εξήγηση: Ο βρόχος καλεί watermark.setImage(newImageBytes) για κάθε αντιστοιχία, και στη συνέχεια αποθηκεύει τις αλλαγές με document.save(outputPath). Επειδή το API λειτουργεί εντός του αρχείου, χρειάζεστε μόνο μία λειτουργία αποθήκευσης ανεξάρτητα από το πόσα υδατογραφήματα αντικαταστάθηκαν.

Συχνά προβλήματα και αντιμετώπιση

LoadOptions σας επιτρέπει να καθορίσετε παραμέτρους όπως κωδικό πρόσβασης ή τρόπο φόρτωσης κατά το άνοιγμα ενός εγγράφου. Το enum LoadMode ορίζει πώς φορτώνεται το αρχείο, π.χ., STREAM για πρόσβαση ροής.

Συμπτωμα	Πιθανή αιτία	Διόρθωση
Δεν βρέθηκαν υδατογραφήματα	Ο κατακερματισμός αναζήτησης δεν ταιριάζει (διαφορετική ανάλυση ή βάθος χρώματος)	Δημιουργήστε τον κατακερματισμό από το ακριβές αρχείο προέλευσης ή χρησιμοποιήστε `ImageSearchOptions.setSimilarity(0.85)` για να επιτρέψετε ασαφή αντιστοίχιση.
Σφάλμα έλλειψης μνήμης σε μεγάλα PDF	Ολόκληρο το έγγραφο φορτώνεται στη μνήμη	Χρησιμοποιήστε `Watermark.load(inputPath, LoadOptions.create().setLoadMode(LoadMode.STREAM))` για ροή του αρχείου.
Το αποθηκευμένο έγγραφο είναι κατεστραμμένο	Η έξοδος ροής δεν κλείνει σωστά	Βεβαιωθείτε ότι χρησιμοποιείται `try‑with‑resources` για την έξοδο ροής, ή καλέστε `document.close()` μετά την αποθήκευση.
Το νέο υδατογράφημα εμφανίζεται μετατοπισμένο	Το αρχικό υδατογράφημα είχε μετασχηματισμό περιστροφής ή κλιμάκωσης	Διατηρήστε τις αρχικές ρυθμίσεις `Watermark.getTransform()` και εφαρμόστε τις στη νέα εικόνα μέσω `watermark.setTransform(originalTransform)`.

Συχνές ερωτήσεις

Ε: Μπορώ να προσθέσω υδατογράφημα σε PDF προστατευμένο με κωδικό;
Α: Ναι. Φορτώστε το έγγραφο με Watermark.load(path, new LoadOptions(password)) και το API θα το αποκρυπτογραφήσει για επεξεργασία.

Ε: Υποστηρίζει το GroupDocs.Watermark εικόνες SVG;
Α: Η βιβλιοθήκη μπορεί να ραστεροποιήσει αρχεία SVG σε PNG πριν την ενσωμάτωση, αλλά η εγγενής εισαγωγή SVG δεν είναι διαθέσιμη αυτή τη στιγμή.

Ε: Πόσες σελίδες μπορούν να επεξεργαστούν σε μία κλήση;
Α: Το API μπορεί να διαχειριστεί έγγραφα με πάνω από 500 σελίδες χωρίς να φορτώνει ολόκληρο το αρχείο στη μνήμη, χάρη στην αρχιτεκτονική ροής του.

Ε: Είναι δυνατόν να προσθέσετε πολλαπλά διαφορετικά υδατογραφήματα στο ίδιο έγγραφο;
Α: Απόλυτα. Δημιουργήστε ξεχωριστά αντικείμενα Watermark για κάθε εικόνα και καλέστε document.add(watermark) για το καθένα.

Ε: Ποιες πλατφόρμες υποστηρίζονται για το Java SDK;
Α: Windows, Linux και macOS υποστηρίζονται, και η βιβλιοθήκη λειτουργεί σε οποιοδήποτε περιβάλλον συμβατό με JVM, συμπεριλαμβανομένων των Docker containers.

Τελευταία ενημέρωση: 2026-08-04
Δοκιμή με: GroupDocs.Watermark 24.11 for Java
Συγγραφέας: GroupDocs

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class ReplaceImageInWatermarks {
    private static final String OUTPUT_PDF_PATH = "YOUR_OUTPUT_DIRECTORY/modified_document.pdf";
    
    public void replaceImages(PossibleWatermarkCollection watermarks, byte[] newImageData) throws Exception {
        Watermarker watermarker = new Watermarker(INPUT_PDF_PATH);

        for (PossibleWatermark watermark : watermarks) {
            try {
                watermark.setImageData(newImageData);
            } catch (Exception e) {
                // Handle exceptions related to unsupported formats or entities.
            }
        }

        watermarker.save(OUTPUT_PDF_PATH);
        watermarker.close();
    }
}