PDF görüntüleme özelliklerini kontrol et

PDF dosyaları, görüntüleyici uygulamasının PDF belgesini nasıl görüntüleyeceğini kontrol etmemizi sağlayan görünüm tercihlerini tutmak için benzersiz bir özelliğe sahiptir. Bu nedenle, bir PDF belgesinin görüntüleyici tercihleri sözlüğü, belgenin ekranda veya baskıda sunulma şeklini kontrol etmenizi sağlar.

Lütfen PDF görüntüleyicilerinin görüntüleme özelliklerini kontrol edebileceğimizi unutmayın. PDF belge başlığının görüntülenmesini, Menü Çubuğunu gizlemeyi veya göstermeyi, Durum çubuğunu gizlemeyi/göstermeyi, Pencere Kullanıcı Arayüzünü gizlemeyi/görüntülemeyi içerir. Sayfa düzeni, sayfa modu ve sayfa düzeninin nasıl ayarlanacağını kontrol edin. PDF işleme uygulamalarının çoğu bu işlemleri destekler. Ancak, toplu güncelleme işlemleri için programatik bir çözüm etkili bir çözümdür. Bu makalede, Python kullanarak PDF görüntüleme özelliklerinin nasıl kontrol edileceğine dair ayrıntıları ve adımları tartışacağız.

PDF Manipülasyon SDK’sı

Aspose.PDF Cloud, geliştiricilerin uygulamalarında PDF oluşturma, düzenleme ve işleme özelliklerini uygulamalarını sağlayan REST tabanlı bir API’dir. Daha az kod satırıyla etkileyici PDF işleme uygulamaları geliştirebilirsiniz. Belirli bir yazılım kurulumu gerekmez ve tüm PDF işleme işlemlerini Cloudta gerçekleştirebilirsiniz. Geliştiricilerimize daha fazla kolaylık sağlamak için, Aspose.PDF Cloud etrafında bir sarmalayıcı olan Aspose.PDF Cloud SDK for Python‘u oluşturduk. Bu nedenle, bu SDK’yı kullanmaya başlamak için ilk adım kurulumudur. SDK, PIP ve GitHub deposu üzerinden ücretsiz olarak indirilebilir. Şimdi kurulumu gerçekleştirmek için terminal/komut isteminde aşağıdaki komutu çalıştırmamız gerekiyor.

pip install asposepdfcloud

Ücretsiz Cloud Panosu Hesabı

Bir sonraki önemli adım, Aspose.Cloud panosu aracılığıyla bulut hizmetlerimize ücretsiz aboneliktir. Bu aboneliğin amacı, yalnızca yetkili kişilerin dosya işleme hizmetlerimize erişmesine izin vermektir. GitHub veya Google hesabınız varsa, sadece Kaydolun veya Yeni Hesap Oluştur düğmesine tıklayın ve gerekli bilgileri sağlayın. Şimdi kimlik bilgilerini kullanarak panoya giriş yapın ve panodan Uygulamalar bölümünü genişletin ve İstemci Kimliği ve İstemci Gizli Bilgisi ayrıntılarını görmek için İstemci Kimlik Bilgileri bölümüne doğru aşağı kaydırın.

Müşteri kimlik bilgileri

Resim 1:- Aspose.Cloud Pano’sunda İstemci Kimlik Bilgileri.

Python kullanarak PDF Görüntüleme Özelliklerini Oku

PDF görüntüleyici tercihlerini okumak ve konsolda görüntülemek için lütfen aşağıda verilen kod parçacığını kullanın.

  • İlk olarak, İstemci Kimliği İstemci Gizliliğini argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturun
  • İkinci olarak, giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı örneği oluşturun
  • Son olarak, PDF görüntüleyici tercihlerini almak için getdocumentdisplayproperties(…) yöntemini çağırın
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)

        # PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # Python kullanarak PDF görüntüleme özelliklerini okumak için API'yi çağırın
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # konsolda yanıt yazdır
        print(response)
        
        # konsolda mesajı yazdır (isteğe bağlı)
        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)

Yukarıdaki örnekte kullanılan örnek PDF belgesi PdfWithEmbeddedFiles.pdf adresinden indirilebilir.

Python kullanarak PDF Görüntüleme Özelliklerini Güncelleyin

Bu bölümde, Python SDK kullanarak PDF görüntüleme özelliklerinin nasıl ayarlanacağına ilişkin adımları ve ilgili ayrıntıları ele alacağız. Ancak, daha fazla ilerlemeden önce, öncelikle özellikleri ve bunlara atanabilecek belirli değerleri öğrenmemiz gerekir.

Desteklenen özellikler

| Emlak | Açıklama |

| —————— | ———————— |

| HideToolbar | Belge etkin olduğunda pdf görüntüleyici uygulamasının araç çubuklarının gizlenip gizlenmeyeceğini belirten bir bayrak |

| HideMenuBar | Belge etkin olduğunda pdf görüntüleyici uygulamasının menü çubuğunun gizlenip gizlenmeyeceğini belirten bir bayrak. |

| HideWindowUI | Belgenin penceresindeki kullanıcı arayüzü öğelerinin (kaydırma çubukları ve gezinme denetimleri gibi) gizlenip gizlenmeyeceğini belirten bir bayrak; yalnızca belgenin içeriği görüntülenecektir. |

| FitWindow | Belgenin penceresinin ilk görüntülenen sayfanın boyutuna uyacak şekilde yeniden boyutlandırılıp boyutlandırılmayacağını belirten bir bayrak. |

| CenterWindow | Belgenin penceresinin ekranın ortasına yerleştirilip yerleştirilmeyeceğini belirten bir bayrak. |

| DisplayDocTitle | Pencerenin başlık çubuğunun belge başlığını görüntüleyip görüntülemeyeceğini belirten bir bayrak. |

| PageMode | PDF belgesi bir PDF görüntüleyicide açıldığında belge sayfa modu. Olası değerler: UseNone – Ne belge ana hatları (yer imleri) ne de küçük resim görüntüleri görünür. UseOutlines – Belge ana hatları (yer imleri) görünür. UseThumbs – Küçük resim görüntüleri görünür. FullScreenFull – menü çubuğu, pencere denetimleri veya başka herhangi bir pencerenin görünmediği ekran modu. UseOC – İsteğe bağlı içerik grubu paneli görünür. UseAttachments – Belge ekleri görünür. |

| PageLayout | Belge açıldığında kullanılacak sayfa düzeni. Olası değerler: SinglePage – Bir seferde bir sayfa görüntüler. OneColumn – Sayfaları tek sütunda görüntüler. TwoColumnLeft – Sayfaları iki sütunda görüntüler, tek numaralı sayfalar soldadır. TwoColumnRight – Sayfaları iki sütunda görüntüler, tek numaralı sayfalar sağdadır. |

| NonFullScreenPageMode | PDF görüntüleyici uygulaması tam ekran modundan çıktığında belge sayfası modu. Olası değerler: UseNone – Ne belge ana hatları (yer imleri) ne de küçük resim görüntüleri görünür. UseOutlines – Belge ana hatları (yer imleri) görünür. UseThumbs – Küçük resim görüntüleri görünür. UseOC – İsteğe bağlı içerik grubu paneli görünür. |

  • İstemci Kimliği İstemci Gizli Anahtarını argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturun.
  • Daha sonra giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı örneği oluşturun.
  • Şimdi PDF görüntüleme için yeni görüntüleme özelliklerini tanımlayan bir DocumentProperties örneği oluşturun.
  • Son olarak, PDF dosyası için yeni görüntüleme özelliklerini ayarlamak üzere putdocumentdisplayproperties(…) öğesini çağırın.
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)

        # PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # Belge görüntüleme özellikleri
        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'
        }

        # PDF görüntüleme özelliklerini güncellemek için API'yi çağırın
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # konsolda yanıt yazdır
        print(response)
        
        # konsolda mesajı yazdır (isteğe bağlı)
        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)
güncellenmiş pdf görüntüleme tercihleri

Resim 2:- Güncellenen PDF görüntüleme tercihlerinin önizlemesi.

cURL kullanarak PDF Görüntüleme Özelliklerini Oku

REST API’lerine cURL komutları aracılığıyla da erişilebilir ve Aspose.PDF Cloud REST mimarisine göre geliştirildiğinden, API’ye cURL komutunu kullanarak da erişebiliriz. Ancak, herhangi bir belge düzenleme işlemi gerçekleştirmeden önce, Aspose.Cloud panosu üzerinden belirtilen bireysel istemci kimlik bilgilerinize dayalı bir JSON Web Token (JWT) oluşturmamız gerekir. Bu zorunludur çünkü API’lerimize yalnızca kayıtlı kullanıcılar erişebilir. Lütfen JWT token’ını oluşturmak için aşağıdaki komutu çalıştırın.

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"

JWT belirteci oluşturulduktan sonra, PDF görüntüleme özelliklerini okumak için aşağıdaki cURL komutunu çalıştırmamız gerekebilir.

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

cURL kullanarak PDF Görüntüleme Özelliklerini Güncelleyin

cURL komutu ayrıca PDF belgelerinin görüntüleme özelliklerini güncellemek için de kullanılabilir ve elde edilen dosya tekrar bulut depolama alanına kaydedilir.

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\"}"

Çözüm

Bu makalede, PDF görüntüleme özelliklerinin nasıl okunacağı ve kontrol edileceğine ilişkin ayrıntıları ve adımları inceledik. Bu gereksinimler Python kod parçacıkları ve cURL komutları kullanılarak gerçekleştirilebilir. Ayrıca API tarafından sunulan diğer heyecan verici özellikler hakkında bilgi edinmek için Geliştirici Kılavuzunu incelemenizi öneririz. Ayrıca, Aspose.PDF for Python Cloud SDK’nın tam kaynak kodu GitHub üzerinden indirilebilir hale getirildi. API’yi kullanırken herhangi bir sorunla karşılaşırsanız veya başka sorularınız varsa lütfen Ücretsiz ürün destek forumu aracılığıyla bizimle iletişime geçmekten çekinmeyin.

İlgili Makaleler

Daha fazla bilgi edinmek için aşağıdaki bağlantıları da ziyaret etmenizi öneririz: