PDF 디스플레이 속성 제어

PDF 파일에는 뷰어 애플리케이션이 PDF 문서를 표시하는 방법을 제어할 수 있는 보기 기본 설정을 보관하는 고유한 기능이 있습니다. 따라서 PDF 문서의 뷰어 기본 설정 사전을 사용하면 문서가 화면이나 인쇄본에 표시되는 방식을 제어할 수 있습니다.

PDF 뷰어의 디스플레이 속성을 제어할 수 있다는 점에 유의하세요. 여기에는 PDF 문서 제목 표시, 메뉴바 숨기기 또는 표시, 상태 표시줄 숨기기/표시, 창 UI 숨기기/표시가 포함됩니다. 페이지 레이아웃, 페이지 모드 및 페이지 레이아웃을 설정하는 방법을 제어합니다. 대부분의 PDF 처리 애플리케이션은 이러한 작업을 지원합니다. 그러나 대량 업데이트 작업의 경우 프로그래밍 솔루션이 효과적인 솔루션입니다. 이 문서에서는 Python을 사용하여 PDF 디스플레이 속성을 제어하는 방법에 대한 세부 정보와 단계를 설명합니다.

PDF 조작 SDK

Aspose.PDF Cloud는 개발자가 애플리케이션에서 PDF 생성, 조작 및 렌더링 기능을 구현할 수 있도록 하는 REST 기반 API입니다. 코드 줄이 적으므로 인상적인 PDF 처리 애플리케이션을 개발할 수 있습니다. 특정 소프트웨어 설치가 필요 없으며 클라우드에서 모든 PDF 처리 작업을 수행할 수 있습니다. 개발자의 편의를 위해 Aspose.PDF Cloud를 감싸는 래퍼인 Aspose.PDF Cloud SDK for Python을 만들었습니다. 따라서 이 SDK를 시작하려면 첫 번째 단계가 설치입니다. SDK는 PIP 및 GitHub 저장소에서 무료로 다운로드할 수 있습니다. 이제 설치를 수행하기 위해 터미널/명령 프롬프트에서 다음 명령을 실행해야 합니다.

pip install asposepdfcloud

무료 클라우드 대시보드 계정

다음 주요 단계는 Aspose.Cloud 대시보드를 통한 클라우드 서비스의 무료 구독입니다. 이 구독의 목적은 권한이 있는 사람만 파일 처리 서비스에 액세스할 수 있도록 하는 것입니다. GitHub 또는 Google 계정이 있는 경우 간단히 가입하거나 새 계정 만들기 버튼을 클릭하고 필요한 정보를 제공하세요. 이제 자격 증명을 사용하여 대시보드에 로그인하고 대시보드에서 애플리케이션 섹션을 확장하고 클라이언트 자격 증명 섹션으로 스크롤하여 클라이언트 ID 및 클라이언트 비밀 세부 정보를 확인하세요.

클라이언트 자격 증명

이미지 1: Aspose.Cloud 대시보드의 클라이언트 자격 증명.

Python을 사용하여 PDF 디스플레이 속성 읽기

PDF 뷰어 환경 설정을 읽고 콘솔에 표시하려면 아래에 제공된 코드 조각을 사용하세요.

  • 먼저, 클라이언트 ID와 클라이언트 비밀번호를 인수로 제공하면서 ApiClient 클래스의 인스턴스를 생성합니다.
  • 둘째, ApiClient 객체를 입력 인수로 사용하는 PdfApi 클래스의 인스턴스를 생성합니다.
  • 마지막으로 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)

        # PdfApiClient를 인수로 전달하면서 PdfApi 인스턴스를 생성합니다.
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # Python을 사용하여 PDF 디스플레이 속성을 읽기 위한 API 호출
        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)

위 예제에서 사용된 샘플 PDF 문서는 PdfWithEmbeddedFiles.pdf에서 다운로드할 수 있습니다.

Python을 사용하여 PDF 표시 속성 업데이트

이 섹션에서는 Python SDK를 사용하여 PDF 디스플레이 속성을 설정하는 방법에 대한 단계와 관련 세부 정보를 논의합니다. 그러나 더 진행하기 전에 먼저 속성과 이에 할당할 수 있는 특정 값을 알아야 합니다.

지원되는 속성

| 부동산 | 설명 |

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

| HideToolbar | 문서가 활성화되어 있을 때 PDF 뷰어 애플리케이션의 도구 모음을 숨길지 여부를 지정하는 플래그 |

| HideMenuBar | 문서가 활성화되어 있을 때 PDF 뷰어 애플리케이션의 메뉴 막대를 숨길지 여부를 지정하는 플래그입니다. |

| HideWindowUI | 문서 창에서 스크롤 막대 및 탐색 컨트롤과 같은 사용자 인터페이스 요소를 숨기고 문서의 내용만 표시할지 여부를 지정하는 플래그입니다. |

| FitWindow | 첫 번째로 표시되는 페이지의 크기에 맞게 문서 창의 크기를 조절할지 여부를 지정하는 플래그입니다. |

| CenterWindow | 문서 창을 화면 중앙에 배치할지 여부를 지정하는 플래그입니다. |

| DisplayDocTitle | 창 제목 표시줄에 문서 제목을 표시할지 여부를 지정하는 플래그입니다. |

| PageMode | PDF 뷰어에서 PDF 문서를 열 때의 문서 페이지 모드입니다. 가능한 값: UseNone – 문서 개요(북마크)나 축소판 이미지가 표시되지 않습니다. UseOutlines – 문서 개요(북마크)가 표시됩니다. UseThumbs – 축소판 이미지가 표시됩니다. FullScreenFull – 메뉴 막대, 창 컨트롤 또는 다른 창이 표시되지 않는 화면 모드입니다. UseOC – 선택적 콘텐츠 그룹 패널이 표시됩니다. UseAttachments – 문서 첨부 파일이 표시됩니다. |

| PageLayout | 페이지 레이아웃은 문서를 열 때 사용됩니다. 가능한 값: SinglePage – 한 번에 한 페이지씩 표시합니다. OneColumn – 한 열에 페이지를 표시합니다. TwoColumnLeft – 두 열에 페이지를 표시하고, 왼쪽에 홀수 번호 페이지를 표시합니다. TwoColumnRight – 두 열에 페이지를 표시하고, 오른쪽에 홀수 번호 페이지를 표시합니다. |

| NonFullScreenPageMode | pdf 뷰어 애플리케이션이 전체 화면 모드를 종료할 때의 문서 페이지 모드입니다. 가능한 값: UseNone – 문서 개요(북마크)도 축소판 이미지도 표시되지 않습니다. UseOutlines – 문서 개요(북마크)가 표시됩니다. UseThumbs – 축소판 이미지가 표시됩니다. UseOC – 선택적 콘텐츠 그룹 패널이 표시됩니다. |

  • 클라이언트 ID와 클라이언트 비밀번호를 인수로 제공하면서 ApiClient 클래스의 인스턴스를 생성합니다.
  • 그런 다음 ApiClient 객체를 입력 인수로 사용하는 PdfApi 클래스의 인스턴스를 생성합니다.
  • 이제 PDF 표시를 위한 새로운 표시 속성을 정의하는 DocumentProperties의 인스턴스를 만듭니다.
  • 마지막으로 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)

        # PdfApiClient를 인수로 전달하면서 PdfApi 인스턴스를 생성합니다.
        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'
        }

        # PDF 표시 속성을 업데이트하기 위한 API 호출
        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)
업데이트된 pdf 표시 환경 설정

이미지 2: 업데이트된 PDF 표시 기본 설정의 미리보기.

cURL을 사용하여 PDF 디스플레이 속성 읽기

REST API는 cURL 명령을 통해서도 액세스할 수 있으며 Aspose.PDF Cloud는 REST 아키텍처에 따라 개발되었으므로 cURL 명령을 사용하여 API에 액세스할 수도 있습니다. 그러나 문서 조작 작업을 수행하기 전에 Aspose.Cloud 대시보드에서 지정한 개별 클라이언트 자격 증명을 기반으로 JSON 웹 토큰(JWT)을 생성해야 합니다. 이는 필수 사항으로, 등록된 사용자만 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"

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

cURL을 사용하여 PDF 표시 속성 업데이트

cURL 명령은 PDF 문서의 표시 속성을 업데이트하는 데에도 사용할 수 있으며, 결과 파일은 다시 클라우드 저장소에 저장됩니다.

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

결론

이 문서에서는 PDF 디스플레이 속성을 읽고 제어하는 방법에 대한 세부 정보와 단계를 살펴보았습니다. 이러한 요구 사항은 Python 코드 조각과 cURL 명령을 사용하여 달성할 수 있습니다. 또한 개발자 가이드를 탐색하여 API에서 제공하는 다른 흥미로운 기능에 대해 알아보는 것이 좋습니다. 또한 Aspose.PDF Cloud SDK for Python의 전체 소스 코드는 GitHub에서 다운로드할 수 있습니다. API를 사용하는 동안 문제가 발생하거나 추가 질문이 있는 경우 무료 제품 지원 포럼을 통해 언제든지 문의해 주십시오.

관련기사

자세한 내용을 알아보려면 다음 링크를 방문해 보세요.