Aggiungere una filigrana a un PDF è un requisito comune per proteggere i documenti, indicare la riservatezza o marchiare i tuoi file. In questo articolo, ti guideremo attraverso i dettagli su come inserire una filigrana in un PDF con poche righe di codice. Sia che tu voglia aggiungere filigrane a immagini all’interno di PDF o a un documento PDF completo, questa guida copre tutto ciò di cui hai bisogno.
- Perché aggiungere un marchio d’acqua all’immagine nel PDF?
- API REST per la manipolazione dei PDF
- Immagine Filigrana utilizzando C#
- Come inserire una filigrana utilizzando cURL
- App gratuita online per watermark PDF
Perché aggiungere un marchio di immagine a un PDF?
- Proteggi i tuoi documenti da distribuzioni non autorizzate.
- Rendi il tuo branding coerente in tutti i file PDF.
- Indicare chiaramente lo stato riservato o di bozza.
API REST per la manipolazione di PDF
Il GroupDocs.Watermark Cloud SDK per .NET ti consente di aggiungere, gestire e personalizzare filigrane di immagini nei documenti PDF con pochi passaggi. Con questo SDK, puoi proteggere i tuoi PDF, mantenere la coerenza del marchio e controllare l’aspetto della filigrana programmaticamente senza la necessità di software desktop.
👉 - Oltre ai PDF, puoi anche elaborare Word, PPTX, Excel e vari file di immagini con questa API.
Caratteristiche del watermarking delle immagini PDF
- Aggiungi filigrane alle immagini nei file PDF facilmente utilizzando .NET.
- Applica filigrane a tutte le pagine o a pagine specifiche di un PDF.
- Personalizza l’opacità, la dimensione, l’allineamento e la rotazione dei filigrane delle immagini.
- Aggiorna o rimuovi le filigrane di immagine esistenti dai documenti PDF secondo necessità.
Installazione
Installa l’SDK tramite NuGet nel tuo progetto .NET:
PM> NuGet\Install-Package GroupDocs.Watermark-Cloud -Version 23.8.0
Immagine filigrana usando C#
Per favore, segui le istruzioni qui sotto per aggiungere un watermark di immagine a un file PDF utilizzando C# .NET.
Passo 1. – Configura l’API.
var configuration = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
var watermarkApi = new WatermarkApi(configuration);
Step 2. – Specifica il nome del file PDF di input.
var fileInfo = new FileInfo
{
FilePath = "SourceFile.pdf"
};
Step 3. – Definisci le caratteristiche del watermark.
WatermarkOptions = new PdfWatermarkOptions
{
ImageWatermark = new ImageWatermark
{
FilePath = "logo.png",
HorizontalAlignment = "Center",
VerticalAlignment = "Center",
Opacity = 0.5
}
}
Step 4. – Inserisci il filigrana dell’immagine.
var response = watermarkApi.AddWatermark(request);
- Puoi inserire una filigrana in PDF in posizioni specifiche, regolare l’opacità o ridimensionare l’immagine.
// Per ulteriori esempi, si prega di visitare https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet
var configuration = new Configuration("XXXXXXX-XXXXXXX-XXXXXX-XXXXXXX", "XXXXXXXXXXXX");
var watermarkApi = new WatermarkApi(configuration);
var fileInfo = new FileInfo
{
// input pdf file available in cloud storage
FilePath = "sample.pdf",
};
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo { FilePath = "confidential.jpg" }
}
}
},
ProtectLevel = WatermarkOptions.ProtectLevelEnum.DocumentAndImages
};
// crea richiesta per aggiungere filigrana all'immagine
var request = new Requests.AddRequest(options);
// Inserisci filigrana immagine nel file PDF
var response = watermarkApi.Add(request);
Come inserire una filigrana utilizzando cURL
L’API REST consente anche di aggiungere filigrane di immagini ai documenti PDF utilizzando comandi cURL. Questa funzione è utile se preferisci lavorare direttamente con richieste HTTP anziché con SDK.
Passo 1 – Ottenere il Token di Accesso
curl -X POST "https://api.groupdocs.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
Passaggio 2 – Inserisci filigrana nel PDF
curl -v -X POST "https://api.groupdocs.cloud/v1.0/watermark" \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{ \"FileInfo\": { \"FilePath\": \"sourceFile.pdf\", \"StorageName\": \"internal\" }, \"OutputFolder\": \"resultant\", \"WatermarkDetails\": [ { \"ImageWatermarkOptions\": { \"Image\": { \"FilePath\": \"confidential.jpeg\", \"StorageName\": \"internal\" } }, \"Position\": { \"X\": 120, \"Y\": 120, \"Width\": 200, \"Height\": 200, \"HorizontalAlignment\": \"center\", \"VerticalAlignment\": \"center\", \"Margins\": { \"Right\": 100, \"Left\": 100, \"Top\": 100, \"Bottom\": 100 }, \"ScaleFactor\": 1, \"RotateAngle\": 180, \"ConsiderParentMargins\": true, \"IsBackground\": true }, \"Opacity\": 1 } ], \"PdfOptions\": { \"PrintOnlyAnnotationWatermarks\": true, \"Rasterize\": true }}"
Sostituisci
{ACCESSTOKEN}con il token generato sopra.
App gratuita online per filigrana PDF
Se sei interessato a testare la funzionalità di Cloud SDK senza codice, puoi prendere in considerazione l’utilizzo della nostra gratuita Online PDF Watermark App. Tutto quello che devi fare è caricare il documento PDF di input, specificare il file immagine e scaricare il PDF con filigrana, senza scrivere una sola riga di codice.
Aggiungi una filigrana a PDF online.
Conclusione
In questo articolo, abbiamo appreso che l’uso di GroupDocs.Watermark Cloud SDK per .NET per aggiungere filigrane ai file PDF è una soluzione veloce, affidabile e flessibile per sviluppatori e aziende. Consente di aggiungere filigrane di immagini, controllare la loro posizione, opacità e dimensione, e applicarle a tutte o a pagine selezionate senza la necessità di software desktop come Adobe Acrobat. Prova a utilizzare questa API per generare documenti PDF professionali, sicuri e facilmente gestibili.
Domande Frequenti – FAQ
Posso aggiungere un watermark di immagine a pagine specifiche di un PDF? Sì. Puoi scegliere di applicare il filigrana dell’immagine a tutte le pagine o solo a pagine selezionate nel PDF.
È possibile aggiungere una filigrana a un PDF senza modificare il file originale? Sì. L’API genera un nuovo PDF con filigrana mantenendo intatto il documento originale.
Devo installare Adobe Acrobat o altro software esterno? No. Tutte le operazioni vengono eseguite nel cloud, non è richiesto alcun software desktop.
Posso sostituire o rimuovere un marchio d’acqua esistente in un PDF? Sì. L’SDK ti consente di aggiornare o rimuovere le filigrane esistenti dai documenti PDF in qualsiasi momento.
Esiste una versione gratuita dell’API per le filigrane? Sì. Crea un free trial account per testare le funzionalità di watermarking online.