Έλεγχος ιδιοτήτων εμφάνισης PDF χρησιμοποιώντας Python

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

Λάβετε υπόψη ότι μπορούμε να ελέγξουμε τις ιδιότητες εμφάνισης των προγραμμάτων προβολής PDF. Περιλαμβάνει τον έλεγχο της εμφάνισης του τίτλου του εγγράφου PDF, την απόκρυψη ή την εμφάνιση της γραμμής μενού, την απόκρυψη/εμφάνιση γραμμής κατάστασης, την απόκρυψη/εμφάνιση του παραθύρου διεπαφή χρήστη. Ελέγξτε πώς να ρυθμίσετε τη διάταξη σελίδας, τη λειτουργία σελίδας και τη διάταξη σελίδας. Η πλειοψηφία των εφαρμογών επεξεργασίας PDF υποστηρίζει αυτές τις λειτουργίες. Ωστόσο, για τις λειτουργίες μαζικής ενημέρωσης, μια λύση μέσω προγραμματισμού είναι μια αποτελεσματική λύση. Σε αυτό το άρθρο, θα συζητήσουμε τις λεπτομέρειες και τα βήματα σχετικά με τον τρόπο ελέγχου των ιδιοτήτων εμφάνισης PDF χρησιμοποιώντας την Python.

• SDK χειρισμού PDF
• Διαβάστε τις ιδιότητες προβολής PDF χρησιμοποιώντας Python
• Ενημερώστε τις ιδιότητες προβολής PDF χρησιμοποιώντας Python
• Διαβάστε τις ιδιότητες προβολής PDF χρησιμοποιώντας το cURL
• Ενημερώστε τις ιδιότητες οθόνης PFDF χρησιμοποιώντας το cURL

SDK χειρισμού PDF

Το Aspose.PDF Cloud είναι ένα API που βασίζεται σε REST που επιτρέπει στους προγραμματιστές να εφαρμόζουν δυνατότητες δημιουργίας, χειρισμού και απόδοσης PDF στις εφαρμογές τους. Με λιγότερες γραμμές κώδικα, μπορείτε να αναπτύξετε εντυπωσιακές εφαρμογές επεξεργασίας PDF. Δεν απαιτείται συγκεκριμένη εγκατάσταση λογισμικού και μπορείτε να εκτελέσετε όλες τις λειτουργίες επεξεργασίας PDF στο Cloud. Για να διευκολύνουμε περαιτέρω τους προγραμματιστές μας, δημιουργήσαμε το Aspose.PDF Cloud SDK for Python που είναι ένα περιτύλιγμα γύρω από το Aspose.PDF Cloud. Για να ξεκινήσετε λοιπόν με αυτό το SDK, το πρώτο βήμα είναι η εγκατάστασή του. Το SDK είναι διαθέσιμο για δωρεάν λήψη μέσω του αποθετηρίου PIP και GitHub. Τώρα πρέπει να εκτελέσουμε την ακόλουθη εντολή στο τερματικό/γραμμή εντολών για να εκτελέσουμε την εγκατάσταση.

pip install asposepdfcloud
copy

Δωρεάν λογαριασμός Cloud Dashboard

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

Διαβάστε τις ιδιότητες προβολής PDF χρησιμοποιώντας Python

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

• Πρώτον, δημιουργήστε μια παρουσία της κλάσης ApiClient ενώ παρέχετε ως ορίσματα Client ID Client Secret
• Δεύτερον, δημιουργήστε ένα στιγμιότυπο κλάσης PdfApi που λαμβάνει το αντικείμενο ApiClient ως όρισμα εισόδου
• Τέλος, καλέστε τη μέθοδο getdocumentdisplayproperties(…) για να ανακτήσετε τις προτιμήσεις προβολής PDF

def readPDFDisplayProperties():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # δημιουργήστε την παρουσία PdfApi ενώ μεταβιβάζετε το PdfApiClient ως όρισμα
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # καλέστε το API για να διαβάσετε ιδιότητες εμφάνισης PDF χρησιμοποιώντας Python
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # απόκριση εκτύπωσης στην κονσόλα
        print(response)
        
        # εκτύπωση μηνύματος στην κονσόλα (προαιρετικό)
        print('PDF Display preferences successfully retrieved !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
copy

Το δείγμα εγγράφου PDF που χρησιμοποιείται στο παραπάνω παράδειγμα μπορεί να ληφθεί από το PdfWithEmbeddedFiles.pdf.

Ενημερώστε τις ιδιότητες προβολής PDF χρησιμοποιώντας Python

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

Υποστηριζόμενες ιδιότητες

| Ακίνητα | Περιγραφή |

| —————– | ———————— |

| HideToolbar | Μια σημαία που καθορίζει εάν θα αποκρύπτονται οι γραμμές εργαλείων της εφαρμογής προβολής pdf όταν το έγγραφο είναι ενεργό |

| HideMenuBar | Μια σημαία που καθορίζει εάν θα αποκρύπτεται η γραμμή μενού της εφαρμογής προβολής pdf όταν το έγγραφο είναι ενεργό. |

| HideWindowUI | Μια σημαία που καθορίζει εάν θα κρύβονται στοιχεία διεπαφής χρήστη στο παράθυρο του εγγράφου (όπως γραμμές κύλισης και στοιχεία ελέγχου πλοήγησης), αφήνοντας να εμφανίζονται μόνο τα περιεχόμενα του εγγράφου. |

| FitWindow | Μια σημαία που καθορίζει εάν θα αλλάξει το μέγεθος του παραθύρου του εγγράφου ώστε να ταιριάζει στο μέγεθος της πρώτης σελίδας που εμφανίζεται. |

| Κέντρο Παράθυρο | Μια σημαία που καθορίζει εάν θα τοποθετηθεί το παράθυρο του εγγράφου στο κέντρο της οθόνης. |

| DisplayDocTitle | Μια σημαία που καθορίζει εάν η γραμμή τίτλου του παραθύρου πρέπει να εμφανίζει τον τίτλο του εγγράφου. |

| PageMode | Η λειτουργία σελίδας εγγράφου όταν ανοίγει το έγγραφο pdf σε πρόγραμμα προβολής pdf. Πιθανές τιμές: UseNone – Ούτε το περίγραμμα εγγράφου (σελιδοδείκτες) ούτε οι μικρογραφίες είναι ορατές. UseOutlines – Το περίγραμμα εγγράφου (σελιδοδείκτες) είναι ορατό. UseThumbs – Οι μικρογραφίες είναι ορατές. FullScreenFull – λειτουργία οθόνης, χωρίς γραμμή μενού, στοιχεία ελέγχου παραθύρου ή οποιοδήποτε άλλο παράθυρο ορατό. UseOC – Είναι ορατός ο προαιρετικός πίνακας ομάδας περιεχομένου. UseAttachments – Τα συνημμένα εγγράφων είναι ορατά. |

| Διάταξη σελίδας | Η διάταξη σελίδας πρέπει να χρησιμοποιείται όταν ανοίγει το έγγραφο. Πιθανές τιμές: SinglePage – Εμφανίζει μία σελίδα κάθε φορά. OneColumn – Εμφανίζει τις σελίδες σε μία στήλη. TwoColumnLeft – Εμφανίζει τις σελίδες σε δύο στήλες, με σελίδες με μονούς αριθμούς στα αριστερά. TwoColumnRight – Εμφανίζει τις σελίδες σε δύο στήλες, με σελίδες με μονούς αριθμούς στα δεξιά. |

| NonFullScreenPageMode | Η λειτουργία σελίδας εγγράφου όταν η εφαρμογή προβολής pdf εξέρχεται από τη λειτουργία πλήρους οθόνης. Πιθανές τιμές: UseNone – Ούτε το περίγραμμα εγγράφου (σελιδοδείκτες) ούτε οι μικρογραφίες είναι ορατές. UseOutlines – Το περίγραμμα εγγράφου (σελιδοδείκτες) είναι ορατό. UseThumbs – Οι μικρογραφίες είναι ορατές. UseOC – Είναι ορατός ο προαιρετικός πίνακας ομάδας περιεχομένου. |

• Δημιουργήστε μια παρουσία της κλάσης ApiClient ενώ παρέχετε ως ορίσματα Client ID Client Secret.
• Στη συνέχεια, δημιουργήστε ένα στιγμιότυπο της κλάσης PdfApi που λαμβάνει το αντικείμενο ApiClient ως όρισμα εισόδου.
• Τώρα δημιουργήστε μια παρουσία του DocumentProperties που ορίζει νέες ιδιότητες εμφάνισης για προβολή PDF.
• Τέλος, καλέστε το putdocumentdisplayproperties(…) για να ορίσετε νέες ιδιότητες εμφάνισης για το αρχείο PDF.

def updatePDFDisplayProperties():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # δημιουργήστε την παρουσία PdfApi ενώ μεταβιβάζετε το PdfApiClient ως όρισμα
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # Ιδιότητες εμφάνισης εγγράφων
        newDocumentProperties = asposepdfcloud.DocumentProperties
        {
          "Links": [
            {
               "Href": '/PdfWithEmbeddedFiles.pdf/displayproperties',
                "Rel": 'self',
                "Type": None,
                "Title": None    }
          ],
          "CenterWindow": True,
          "Direction": 'L2R',
          "DisplayDocTitle": True,
          "HideMenuBar": True,
          "HideToolBar": False,
          "HideWindowUI": True,
          "NonFullScreenPageMode": 'UseOutlines',
          "PageLayout":'TwoColumnRight',
          "PageMode": 'UseThumbs'
        }

        # καλέστε το API για να ενημερώσετε τις ιδιότητες εμφάνισης PDF
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # απόκριση εκτύπωσης στην κονσόλα
        print(response)
        
        # εκτύπωση μηνύματος στην κονσόλα (προαιρετικό)
        print('PDF Display preferences successfully updated !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
copy

Διαβάστε τις ιδιότητες προβολής PDF χρησιμοποιώντας το cURL

Τα API REST μπορούν επίσης να προσπελαστούν μέσω εντολών cURL και δεδομένου ότι το Aspose.PDF Cloud έχει αναπτυχθεί σύμφωνα με την αρχιτεκτονική REST, επομένως μπορούμε επίσης να έχουμε πρόσβαση στο API χρησιμοποιώντας την εντολή cURL. Ωστόσο, πριν εκτελέσουμε οποιαδήποτε λειτουργία χειρισμού εγγράφων, πρέπει να δημιουργήσουμε ένα JSON Web Token (JWT) με βάση τα μεμονωμένα διαπιστευτήρια πελάτη που καθορίζονται στον πίνακα εργαλείων Aspose.Cloud. Είναι υποχρεωτικό επειδή τα API μας είναι προσβάσιμα μόνο σε εγγεγραμμένους χρήστες. Εκτελέστε την ακόλουθη εντολή για να δημιουργήσετε το διακριτικό JWT.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
copy

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

curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/displayproperties" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"
copy

Ενημερώστε τις ιδιότητες οθόνης PDF χρησιμοποιώντας το cURL

Η εντολή cURL μπορεί επίσης να χρησιμοποιηθεί για την ενημέρωση των ιδιοτήτων εμφάνισης των εγγράφων PDF και το αρχείο που προκύπτει αποθηκεύεται ξανά στον χώρο αποθήκευσης cloud.

curl -v -X PUT "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/displayproperties" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Links\": [    {       \"Href\": \"/PdfWithEmbeddedFiles.pdf/displayproperties\",        \"Rel\": \"self\",        \"Type\": null,        \"Title\": null    }  ],  \"CenterWindow\": true,  \"Direction\": \"L2R\",  \"DisplayDocTitle\": true,  \"HideMenuBar\": true,  \"HideToolBar\": false,  \"HideWindowUI\": true,  \"NonFullScreenPageMode\": \"UseOutlines\",  \"PageLayout\": \"TwoColumnRight\",  \"PageMode\": \"UseThumbs\"}"
copy

Σύναψη

Σε αυτό το άρθρο, έχουμε εξερευνήσει τις λεπτομέρειες και τα βήματα σχετικά με τον τρόπο ανάγνωσης και ελέγχου των ιδιοτήτων εμφάνισης PDF. Αυτές οι απαιτήσεις μπορούν να επιτευχθούν χρησιμοποιώντας αποσπάσματα κώδικα Python καθώς και χρησιμοποιώντας τις εντολές cURL. Συνιστούμε επίσης να εξερευνήσετε τον Οδηγό προγραμματιστή για να μάθετε για άλλες συναρπαστικές δυνατότητες που προσφέρει το API. Επιπλέον, ο πλήρης πηγαίος κώδικας του Aspose.PDF Cloud SDK για Python έχει γίνει διαθέσιμος για λήψη μέσω GitHub. Σε περίπτωση που αντιμετωπίσετε προβλήματα κατά τη χρήση του API ή εάν έχετε περαιτέρω απορίες, μη διστάσετε να επικοινωνήσετε μαζί μας μέσω του Δωρεάν φόρουμ υποστήριξης προϊόντων.

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

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

• PDF σε εικόνα – Μετατροπή PDF σε JPEG στην Python
• Λήψη Συνημμένου από PDF χρησιμοποιώντας Python
• Προσθήκη ή αφαίρεση σελίδων PDF χρησιμοποιώντας Python
• Εύρεση και αντικατάσταση κειμένου σε PDF χρησιμοποιώντας Python
• Εξαγωγή εικόνων από PDF σε Python
• Εξαγωγή κειμένου από PDF σε Python