Προσθήκη υποσέλιδου κεφαλίδας σε PDF

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

Επιπλέον, θα πρέπει να γνωρίζετε ότι οι κεφαλίδες και τα υποσέλιδα είναι χρήσιμα για την παροχή γρήγορων πληροφοριών σχετικά με το έγγραφό σας σε προβλέψιμη μορφή και επίσης βοηθούν στον καθορισμό διαφορετικών τμημάτων ενός εγγράφου. Σε αυτό το άρθρο, θα μάθουμε σχετικά με την προσθήκη κειμένου και εικόνων στις περιοχές κεφαλίδας και υποσέλιδου των αρχείων PDF χρησιμοποιώντας το Aspose.PDF Cloud SDK για Java.

Προσθήκη κειμένου στην κεφαλίδα χρησιμοποιώντας το cURL

Οι εντολές cURL είναι ένας συναρπαστικός τρόπος πρόσβασης στα RESTFul API μέσω του τερματικού της γραμμής εντολών. Δεδομένου ότι το Aspose.PDF Cloud SDK έχει αναπτυχθεί σύμφωνα με τις αρχές REST, ώστε να είναι εύκολα προσβάσιμο μέσω της γραμμής εντολών. Ωστόσο, σημειώστε ότι για να διασφαλιστεί το απόρρητο των χρηστών και η ακεραιότητα των δεδομένων, όλα τα API μας είναι προσβάσιμα μόνο σε εξουσιοδοτημένα άτομα. Επομένως, πρέπει πρώτα να επισκεφτείτε το Aspose.Cloud dashboard και εάν έχετε λογαριασμό GitHub ή Google, απλώς Εγγραφείτε. Διαφορετικά, κάντε κλικ στο κουμπί Δημιουργία νέου λογαριασμού και δώστε τις απαιτούμενες πληροφορίες. Τώρα συνδεθείτε στον πίνακα εργαλείων χρησιμοποιώντας διαπιστευτήρια και αναπτύξτε την ενότητα Εφαρμογές από τον πίνακα εργαλείων και μετακινηθείτε προς τα κάτω προς την ενότητα Διαπιστευτήρια πελάτη για να δείτε στοιχεία Client ID και Client Secret.

Η ακόλουθη εντολή δείχνει πώς να δημιουργήσετε ένα διακριτικό πρόσβασης JWT το οποίο θα χρησιμοποιηθεί για την προσθήκη κειμένου στην περιοχή Κεφαλίδα του εγγράφου PDF.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Χρησιμοποιήστε την ακόλουθη εντολή cURL για να προσθέσετε Κείμενο στην ενότητα κεφαλίδας του εγγράφου PDF.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/text?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"CENTER\",  \"Opacity\": 0.8,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 0,  \"YIndent\": 0,  \"Zoom\": 1,  \"TextAlignment\": \"CENTER\",  \"Value\": \"Aspose.PDF Cloud SDK for Java via cURL\",  \"TextState\": {    \"FontSize\": 16,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 0xDA,      \"G\": 0xA5,      \"B\": 0x20    },    \"BackgroundColor\": {      \"A\": 0,      \"R\": 0xFA,      \"G\": 0xEB,      \"B\": 0xD7    },  },  \"LeftMargin\": 1,  \"TopMargin\": 20,  \"RightMargin\": 200}"
Κεφαλίδα κειμένου σε PDF

Εικόνα 1:- Η κεφαλίδα κειμένου προστέθηκε μέσω εντολής cURL.

Τα δείγματα αρχείων που χρησιμοποιούνται σε αυτό το παράδειγμα μπορούν να ληφθούν από:

Προσθήκη κεφαλίδας κειμένου σε PDF χρησιμοποιώντας Java

Για να χρησιμοποιήσετε το SDK, πρέπει πρώτα να το εγκαταστήσετε είτε από το Maven είτε από το GitHub. Παρακάτω δίνονται οι λεπτομέρειες σχετικά με τον τρόπο λήψης και χρήσης του Aspose.Pdf.jar στο έργο κατασκευής Maven.

Προσθέστε τις ακόλουθες εξαρτήσεις στο αρχείο pom.xml.

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

Παρακάτω δίνονται τα βήματα για τον τρόπο εκπλήρωσης αυτής της απαίτησης.

  • Πρώτα απ ‘όλα, δημιουργήστε μια παρουσία του PdfApi παρέχοντας τα στοιχεία ClientSecret και ClientId
  • Δεύτερον, δημιουργήστε ένα αντικείμενο Color για να ορίσετε τις λεπτομέρειες χρώματος ForeGround και BackGround.
  • Δεύτερον, δημιουργήστε ένα αντικείμενο κλάσης TextState.
  • Χρησιμοποιήστε τη μέθοδο fontSize(..) για να ορίσετε λεπτομέρειες μεγέθους γραμματοσειράς. Η μέθοδος font(..) για τον ορισμό της όψης γραμματοσειράς. Η μέθοδος foregroundColor(…) ορίζει λεπτομέρειες του προσκηνίου κειμένου και η μέθοδος backgroundColor(…) για τον ορισμό πληροφοριών φόντου.
  • Τώρα δημιουργήστε αντικείμενο TextHeader και ορίστε λεπτομέρειες περιθωρίου.
  • Χρησιμοποιήστε μεθόδους value(..) για να καθορίσετε το περιεχόμενο του αντικειμένου Κεφαλίδα κειμένου.
  • Τώρα καλέστε τη μέθοδο textState(…) και περάστε πάνω από τη δημιουργία TextState ως όρισμα.
  • Για να εμφανιστεί η Κεφαλίδα πίσω από το περιεχόμενο της σελίδας, περάστε την αληθινή τιμή ως όρισμα στη μέθοδο background(…) της κλάσης TextHeader.
  • Τώρα για να αποδώσετε την εικόνα στην αριστερή πλευρά, περάστε την τιμή HorizontalAlignment.CENTER στη μέθοδο horizontalAlignment(…).
  • Η μέθοδος αδιαφάνειας(…) υποδεικνύει την αδιαφάνεια της σφραγίδας. Η προεπιλεγμένη τιμή είναι 1,0.
  • Αφού ορίσουμε την τιμή ζουμ, δημιουργήστε αντικείμενο AsposeResponse.
  • Τέλος, καλέστε τη μέθοδο PdfApi.postDocumentTextHeader(…) και περάστε το όνομα αρχείου PDF πηγής, το αντικείμενο TextHeader, τις σελίδες έναρξης και τέλους (όπου πρέπει να προστεθεί σφραγίδα) ως ορίσματα.
// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// στιγμιότυπο δημιουργίαςPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// εισαγωγή εγγράφου PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// αρχική σελίδα του PDF για να τοποθετήσετε την εικόνα κεφαλίδας
int startPage = 2;

// τελική σελίδα του PDF για να τοποθετήσετε την εικόνα κεφαλίδας
int endPage = 3;
		        
// καθορίστε το χρώμα του προσκηνίου ως SlateBlue σε Hex κώδικα
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// καθορίστε το χρώμα φόντου ως AntiqueWhite σε Hex κώδικα
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// Δημιουργήστε αντικείμενο TextState για να ορίσετε λεπτομέρειες μεγέθους γραμματοσειράς, προσώπου και χρώματος
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// δημιουργήστε μια παρουσία του αντικειμένου TextHeader
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // το περιεχόμενο της κεφαλίδας κειμένου που πρόκειται να αποδοθεί
  .value("Aspose.PDF Cloud SDK For Java")
	
  // ορίστε την ευθυγράμμιση ως κέντρο
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // ορίστε Κείμενο κεφαλίδας πίσω από το περιεχόμενο της σελίδας
  headerObject.background(true)
	
  // ορίστε τη στοίχιση κεφαλίδας κειμένου ως Κέντρο
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // ορίστε την αδιαφάνεια της κεφαλίδας κειμένου ως 0,8
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// καλέστε τη μέθοδο API για να προσθέσετε Κεφαλίδα κειμένου σε PDF
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());
Η κεφαλίδα κειμένου προστέθηκε σε Java

Εικόνα 2: - Προεπισκόπηση της κεφαλίδας κειμένου που προστέθηκε με Java.

Για να προσθέσετε κείμενο στην περιοχή του υποσέλιδου, δημιουργήστε μια παρουσία της κλάσης TextFooter και καλέστε τη μέθοδο postDocumentTextFooter(…) της κλάσης PdfApi. Τα υπόλοιπα βήματα και λεπτομέρειες θα παραμείνουν τα ίδια όπως αναφέρθηκαν παραπάνω για την προσθήκη της κεφαλίδας κειμένου.

Εικόνα σε Κεφαλίδα PDF χρησιμοποιώντας το cURL

Μπορούμε εύκολα να προσθέσουμε αρχεία εικόνας χρησιμοποιώντας το PostDocumentImageHeader API στην ενότητα κεφαλίδας του αρχείου PDF χρησιμοποιώντας την εντολή cURL. Κατά την προσθήκη μιας σφραγίδας εικόνας, έχουμε την επιλογή να καθορίσουμε λεπτομέρειες Horizontal Alignment, Opacity, RotateAngle, Συντελεστής ζουμ της εικόνας, Width, Height, LeftMargin, TopMargin, RightMargin, κ.λπ.

Η παράμετρος όνομα καθορίζει το έγγραφο εισόδου/πηγής PDF, το imageHeader καθορίζει το αρχείο εικόνας που θα σφραγιστεί, η ιδιότητα startPageNumber ορίζει την αρχική σελίδα και το endPageNumber η τελική σελίδα του εγγράφου PDF να περιέχει σφραγίδες εικόνας. Στην ακόλουθη εντολή cURL, η ιδιότητα Background ορίζεται ως false ώστε η εικόνα να είναι ορατή. Η Οριζόντια Στοίχιση καθορίζεται ως Αριστερά, η τιμή Αδιαφάνειας ορίζεται ως 0,8, ο συντελεστής Ζουμ ορίζεται ως 1, το Πλάτος ορίζεται ως 250, το Ύψος ορίζεται ως 80 σημεία και το Δεξιό Περιθώριο ορίζεται ως 500 σημεία.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/image?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"  \
-H  "Content-Type: application/json" \
-d "{"Background":false,"HorizontalAlignment":'Left',"Opacity": .8,"Rotate":'None',"RotateAngle": 0,"XIndent": 2,"YIndent": 5,"Zoom": 1,"FileName": 'asposetoolsnew.png',"Width": 250,"Height": 80,"LeftMargin": 1,"TopMargin": 10,"RightMargin": 500}"
Σφραγίδα εικόνας στην κεφαλίδα

Εικόνα 3: - Σφραγίδα εικόνας στην ενότητα Κεφαλίδα του PDF.

Τα δείγματα αρχείων που χρησιμοποιούνται στο παραπάνω παράδειγμα μπορείτε να τα κατεβάσετε από τον ακόλουθο σύνδεσμο:

Προσθήκη εικόνας στο Header χρησιμοποιώντας Java

Το Aspose.PDF Cloud SDK για Java παρέχει μια αξιοσημείωτη δυνατότητα προσθήκης μιας κεφαλίδας εικόνας σε ένα αρχείο PDF με λιγότερες γραμμές κώδικα.

Παρακάτω δίνονται βήματα σχετικά με τον τρόπο προσθήκης της κεφαλίδας εικόνας σε έγγραφο PDF

  • Δημιουργήστε ένα αντικείμενο του PdfApi ενώ παρέχετε στοιχεία ClientSecret και ClientId.
  • Δεύτερον, δημιουργήστε ένα αντικείμενο κλάσης ImageHeader.
  • Χρησιμοποιήστε τις μεθόδους width(..) και height(…) της κλάσης ImageHeader για να ορίσετε λεπτομέρειες πλάτους και ύψους εικόνας.
  • Τώρα χρησιμοποιήστε τη μέθοδο fileName(…) για να ορίσετε λεπτομέρειες διαδρομής για την εικόνα κεφαλίδας.
  • Για να εμφανίσετε την εικόνα πίσω από το περιεχόμενο της σελίδας, περάστε το false όρισμα στη μέθοδο background(…).
  • Τώρα για να αποδώσετε την εικόνα στην αριστερή πλευρά, περάστε την τιμή HorizontalAlignment.LEFT στη μέθοδο horizontalAlignment(…).
  • Η μέθοδος αδιαφάνειας(…) υποδεικνύει την αδιαφάνεια της σφραγίδας. Η προεπιλεγμένη τιμή είναι 1,0.
  • Αφού ορίσουμε την τιμή ζουμ, δημιουργήστε αντικείμενο AsposeResponse.
  • Τέλος, καλέστε τη μέθοδο PdfApi.postDocumentImageHeader(…) ενώ μεταβιβάζετε το όνομα αρχείου PDF πηγής, το αντικείμενο ImageHeader, τις σελίδες έναρξης και τέλους (όπου πρέπει να προστεθεί σφραγίδα) ως ορίσματα σε αυτήν τη μέθοδο.
// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// στιγμιότυπο δημιουργίαςPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// εισαγωγή εγγράφου PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// αρχική σελίδα του PDF για να τοποθετήσετε την εικόνα κεφαλίδας
int startPage = 2;

// τελική σελίδα του PDF για να τοποθετήσετε την εικόνα κεφαλίδας
int endPage = 3;
		        
// δημιουργήστε μια παρουσία του αντικειμένου ImageHeader
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// φέρτε την εικόνα κεφαλίδας στο προσκήνιο/ορατή
	headerObject.background(false)
	
	// ορίστε τη στοίχιση κεφαλίδας εικόνας ως Αριστερά
	.horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.LEFT)
	.opacity(0.8)
	.rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
	.rotateAngle(0.)
	.xindent(2.0)
	.yindent(5.0)
	.zoom(1.0);

// καλέστε τη μέθοδο API για να προσθέσετε εικόνα κεφαλίδας σε PDF
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

Για να προσθέσετε μια εικόνα στην περιοχή του υποσέλιδου, δημιουργήστε ένα αντικείμενο κλάσης ImageFooter και καλέστε τη μέθοδο postDocumentImageFooter(…) της κλάσης pdfApi. Τα υπόλοιπα βήματα θα παραμείνουν τα ίδια όπως εξηγήθηκαν παραπάνω για την εικόνα στην ενότητα Κεφαλίδα παραπάνω.

Σύναψη

Σε αυτό το άρθρο, συζητήσαμε τα βήματα σχετικά με τον τρόπο πρόσβασης στο Aspose.PDF Cloud μέσω εντολών cURL για την προσθήκη κειμένου και εικόνων στις περιοχές Κεφαλίδα/Υποσέλιδο των εγγράφων PDF. Εξερευνήσαμε επίσης τα βήματα για την εγκατάσταση του Aspose.PDF Cloud SDK για Java και τη χρήση του σε γλώσσα Java για την προσθήκη κειμένου και εικόνας στην ενότητα κεφαλίδας ή υποσέλιδου του αρχείου PDF. Για περισσότερες λεπτομέρειες σχετικά με άλλες συναρπαστικές δυνατότητες του API, εξερευνήστε την τεκμηρίωση προϊόντος.

Όλα τα Cloud SDK μας είναι OpenSource, επομένως μπορείτε να λάβετε έναν πλήρη πηγαίο κώδικα από το GitHub.