Σχολιασμός PDF

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

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

Εγκατάσταση του SDK

Το Aspose.PDF Cloud SDK for Java είναι ένα API προγραμματισμού που επιτρέπει στους προγραμματιστές Java να δημιουργούν, να χειρίζονται καθώς και να μετατρέπουν υπάρχοντα έγγραφα PDF σε άλλες υποστηριζόμενες μορφές εγγράφων. Το Cloud SDK είναι διαθέσιμο για λήψη μέσω Maven και GitHub. Τώρα προσθέστε τις ακόλουθες λεπτομέρειες στο αρχείο pom.xml για λήψη και χρήση του Aspose.Pdf.jar στο έργο κατασκευής Maven.

<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>

Για περισσότερες πληροφορίες, επισκεφτείτε το How to install Aspose.Cloud SDKs.

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

Κείμενο Strikeout με χρήση Java

Μερικές φορές έχουμε την απαίτηση να επισημάνουμε συγκεκριμένο περιεχόμενο μέσα στο έγγραφο ως ξεπερασμένο χωρίς να το αφαιρέσουμε από το έγγραφο. Το Strikethrough (γνωστό και ως strikeout) αντιπροσωπεύεται από λέξεις με οριζόντια γραμμή στο κέντρο τους. Υπονοεί ότι το κείμενο είναι λάθος ή ξεπερασμένο και πρόσφατα διαγράφηκε ή επισημάνθηκε ως τέτοιο. Μπορούμε να ορίσουμε τις ρυθμίσεις των σχολιασμών διαγραφής χρησιμοποιώντας την ιδιότητα strikethroughSettings. Η ιδιότητα strikethroughSettings χρησιμοποιείται για τον ορισμό των ιδιοτήτων χρώματος, αδιαφάνειας, συγγραφέα, θέματος, modifiedDate και isLocked των σχολιασμών διαγραφής.

// Λάβετε 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 = "PdfWithTable.pdf";	        
			        
int pageNumber = 1;
// δημιουργήστε ορθογώνια περιοχή για Σχολιασμό  
Rectangle rect = new Rectangle()
    .LLX(200.)
    .LLY(380.)
    .URX(250.)
    .URY(375.);

List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

List<Point> points = new ArrayList<>();
points.add(new Point().X(132.).Y(380.)); // Top-Left edge of the Strike Through line
points.add(new Point().X(95.).Y(10.));	// Top-Right edge of the strike through line
points.add(new Point().X(130.).Y(25.));
points.add(new Point().X(130.).Y(10.));

StrikeOutAnnotation annotation = new StrikeOutAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setZindex(1);
annotation.setTitle("Title");
annotation.setQuadPoints(points);
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        

List<StrikeOutAnnotation> annotations = new ArrayList<>();
annotations.add(annotation);

AsposeResponse response = pdfApi.postPageStrikeOutAnnotations(sourcePDF, pageNumber, annotations, null, null);
assertEquals(200, (int)response.getCode());

Προσθήκη σχολιασμού επισήμανσης

Η επισήμανση του περιεχομένου εντός του PDF είναι απαραίτητη επειδή μας επιτρέπει να επιστήσουμε την προσοχή σε σημαντικές πληροφορίες μέσα στο έγγραφο. Η επισήμανση είναι αποτελεσματική επειδή ζητά πρώτα από τον αναγνώστη να επιλέξει τα σημαντικά μέρη και στη συνέχεια παρέχει έναν αποτελεσματικό τρόπο για να επανεξετάσει αυτές τις πληροφορίες αργότερα. Το Cloud API μας παρέχει τις δυνατότητες επισήμανσης περιεχομένου εντός εγγράφων PDF. Παρακάτω δίνονται τα βήματα για την προσθήκη σχολιασμών επισήμανσης σε ένα αρχείο PDF.

  • Πρώτα απ ‘όλα, δημιουργήστε μια παρουσία του PdfApi ενώ παρέχετε στοιχεία ClientSecret και ClientId.
  • Δημιουργούμε μια παρουσία αρχείου για τη φόρτωση ενός αρχείου PDF από το τοπικό σύστημα και στη συνέχεια καλούμε τη μέθοδο uploadFile(…) της κλάσης PdfApi για να ανεβάσουμε το έγγραφο στο χώρο αποθήκευσης cloud.
  • Τώρα δημιουργήστε μια παρουσία της κλάσης Rectangle για να καθορίσετε την ορθογώνια περιοχή όπου μπορεί να προστεθεί σχολιασμός.
  • Στη συνέχεια, δημιουργήστε μια ArrayList τύπου Point για να διατηρήσετε τις πληροφορίες σχετικά με τα σημεία για να σχεδιάσετε το HighlightAnnotation.
  • Δημιουργήστε ένα αντικείμενο κλάσης HighlightAnnotation και ορίστε την ημερομηνία τροποποίησης Όνομα, Ορθογώνια περιοχή, Θέμα, Τίτλος, Τετραπόντους, Σχολιασμός.
  • Το επόμενο βήμα είναι να δημιουργήσετε έναν τύπο λίστας HighlightAnnotation και να προσθέσετε το αντικείμενο HighlightAnnotation που δημιουργήθηκε παραπάνω σε αυτήν τη λίστα.
  • Τέλος, καλέστε τη μέθοδο postPageHighlightAnnotations(…) της κλάσης PdfApi και περάστε ως ορίσματα την πηγή PDF, τον αριθμό σελίδας και τη λίστα Annotations.
Επισημάνετε την προεπισκόπηση σχολιασμού

Εικόνα 1: - Επισημάνετε τον σχολιασμό σε αρχείο PDF.

Μπορείτε να κάνετε λήψη των δειγμάτων αρχείων που χρησιμοποιούνται στο παραπάνω παράδειγμα από τους παρακάτω συνδέσμους

Πώς να προσθέσετε σχολιασμό γραμμής

Παρόμοια με την προσθήκη σχολιασμών διαγραφής και επισήμανσης, το API σάς επιτρέπει επίσης να προσθέτετε σχολιασμούς γραμμής σε έγγραφα PDF. Έχουμε μια κλάση με το όνομα LineAnnotation για να ολοκληρώσουμε αυτήν την απαίτηση. Παρακάτω δίνονται περισσότερες λεπτομέρειες σχετικά με τον τρόπο εκπλήρωσης αυτής της απαίτησης.

  • Πρώτα απ ‘όλα, δημιουργήστε μια παρουσία του PdfApi παρέχοντας ταυτόχρονα στοιχεία ClientSecret και ClientId.
  • Προαιρετικά, δημιουργούμε μια παρουσία αρχείου για τη φόρτωση ενός αρχείου PDF από το τοπικό σύστημα και στη συνέχεια καλούμε τη μέθοδο uploadFile(…) της κλάσης PdfApi για να ανεβάσουμε το έγγραφο στο χώρο αποθήκευσης cloud. Σε περίπτωση που το αρχείο είναι ήδη διαθέσιμο στο Cloud storage, μπορούμε να το χρησιμοποιήσουμε.
  • Οι υπόλοιπες ιδιότητες αρχικοποίησης αντικειμένου είναι οι ίδιες που αναφέρθηκαν παραπάνω για το HighlithAnnotation εκτός από το ότι πρέπει να δημιουργήσουμε ένα αντικείμενο κλάσης LineAnnotation και να ορίσουμε το σημείο έναρξης και τέλους μιας γραμμής χρησιμοποιώντας τις μεθόδους setStarting(…) και setEnding(…).
// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// στιγμιότυπο δημιουργίαςPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// εισαγωγή εγγράφου PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// Φορτώστε το αρχείο από το τοπικό σύστημα
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// μεταφορτώστε το αρχείο στο χώρο αποθήκευσης cloud
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);

// αριθμός σελίδας όπου θα προστεθεί σχολιασμός				
int pageNumber = 1;

// δημιουργήστε ορθογώνια περιοχή για Σχολιασμό  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(500.)
    .URX(400.)
    .URY(510.);

// δημιουργία αντικειμένου λίστας τύπου AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// Δημιουργία αντικειμένου Line Annotations
LineAnnotation annotation = new LineAnnotation();

annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// ορίστε το σημείο εκκίνησης της γραμμής
annotation.setStarting(new Point().X(100.).Y(100.));
// ορίστε το τελικό σημείο της γραμμής
annotation.setEnding(new Point().X(20.).Y(680.));

// δημιουργήστε παράδειγμα χρώματος για το stablue
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// ορίστε το χρώμα του σχολιασμού
annotation.interiorColor(color);

// ορίστε ημερομηνία τροποποίησης σχολιασμού			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// Δημιουργία παρουσίας λίστας σχολιασμών γραμμής
List<LineAnnotation> annotations = new ArrayList<>();
// προσθέστε αντικείμενο LineAnnotation στη λίστα Line Annotations
annotations.add(annotation);

// καλέστε τη μέθοδο API για να προσθέσετε Σχολιασμό γραμμής σε αρχείο PDF
AsposeResponse response = pdfApi.postPageLineAnnotations(sourcePDF, pageNumber, annotations, null, null);

Προσθήκη σχολιασμού κύκλου σε PDF

Οι σχολιασμοί κύκλων χρησιμοποιούνται επίσης συνήθως σε έγγραφα PDF και το API υποστηρίζει πολύ καλά αυτόν τον τύπο σχολιασμού. Για να προσθέσετε σχολιασμούς κύκλων, δοκιμάστε να χρησιμοποιήσετε την τάξη CircleAnnotation. Ο κωδικός που καθορίζεται παρακάτω μπορεί να χρησιμοποιηθεί για την εκπλήρωση αυτής της απαίτησης.

// Λάβετε ClientID και ClientSecret από https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// στιγμιότυπο δημιουργίαςPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// εισαγωγή εγγράφου PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// Φορτώστε το αρχείο από το τοπικό σύστημα
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// μεταφορτώστε το αρχείο στο χώρο αποθήκευσης cloud
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);
// αριθμός σελίδας όπου θα προστεθεί ο σχολιασμός				
int pageNumber = 1;

// δημιουργήστε ορθογώνια περιοχή για Σχολιασμό  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(700.)
    .URX(300.)
    .URY(500.);

// δημιουργία αντικειμένου λίστας τύπου AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// Δημιουργία αντικειμένου Σημειώσεις Σημειώσεων
CircleAnnotation annotation = new CircleAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// δημιουργία χρωματικής παρουσίας για stablue
Color color = new Color();
color.setR(0xC7);
color.setG(0xE2);
color.setB(0x6f);
// ορίστε το χρώμα του σχολιασμού
annotation.interiorColor(color);

// ορίστε ημερομηνία τροποποίησης σχολιασμού			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// Δημιουργία παρουσίας λίστας σχολιασμών επισήμανσης
List<CircleAnnotation> annotations = new ArrayList<>();

// προσθέστε αντικείμενο CircleAnnotation στη λίστα Circle Annotations
annotations.add(annotation);

// καλέστε τη μέθοδο API για να προσθέσετε το Circle Annotation σε αρχείο PDF
AsposeResponse response = pdfApi.postPageCircleAnnotations(sourcePDF, pageNumber, annotations, null, null);
Κύκλος σχολιασμού σε PDF

Εικόνα 2: - Κύκλος σχολιασμού σε αρχείο PDF.

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

Γρήγορη συμβουλή

Χρησιμοποιήστε τη δωρεάν διαδικτυακή μας PDF Annotation App για να αφαιρέσετε όλους τους σχολιασμούς από το PDF σας με ένα κλικ.

Σύναψη

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

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

Σχετικά Άρθρα

Συνιστούμε ανεπιφύλακτα να επισκεφτείτε τους παρακάτω συνδέσμους για να μάθετε περισσότερα σχετικά με: