전문적이고 시각적으로 매력적인 PDF 문서를 만들 때 헤더에 이미지와 텍스트를 추가할 수 있는 기능은 필수 기능입니다. 헤더 섹션은 제목, 작성자, 날짜와 같은 필수 정보를 독자에게 제공하기 때문에 문서에서 가장 중요한 영역 중 하나입니다. 헤더에 텍스트를 추가하는 것은 비교적 간단한 프로세스이지만 이미지를 추가하는 것은 더 어려울 수 있으며, 특히 PDF 문서 생성을 처음 접하는 Python 개발자에게는 더욱 그렇습니다. 이 문서에서는 Python Cloud SDK를 사용하여 PDF 문서의 헤더에 이미지와 텍스트를 추가하는 방법을 살펴보겠습니다.
PDF 헤더에 이미지, 로고, 문서를 만든 날짜 및 시간, 문서 제목, 버전 또는 개정 번호, 초안, 작성자 이름, 장 이름을 추가할 수 있습니다.
- PDF 문서 어셈블리를 위한 REST API
- Python을 사용하여 PDF 헤더에 텍스트 추가
- Python을 사용하여 PDF 헤더에 이미지 추가
- cURL 명령을 사용하여 PDF에 텍스트 헤더 추가
- cURL 명령을 사용하여 PDF에 이미지 헤더 추가
PDF 문서 어셈블리를 위한 REST API
Aspose.PDF Cloud SDK for Python는 개발자가 PDF 파일을 프로그래밍 방식으로 조작할 수 있도록 하는 다양한 기능과 방법을 제공합니다. 또한 PDF 문서 헤더에 이미지와 텍스트를 추가하기 위한 강력하고 유연한 도구 세트를 제공하며, 자동화된 PDF 문서 처리를 위해 Python 애플리케이션에 쉽게 통합할 수 있습니다. 이제 헤더에 이미지를 추가하는 프로세스와 관련하여 이미지의 위치와 크기, 이미지가 표시될 페이지 번호를 지정하는 것이 포함됩니다. 마찬가지로 헤더에 텍스트를 추가하려면 텍스트 내용, 글꼴 크기 및 기타 서식 옵션을 지정해야 합니다. SDK는 헤더 내용의 정렬 및 위치를 제어하고 헤더의 배경색을 지정하는 옵션도 제공합니다.
이제 먼저 PIP 및 GitHub 저장소에서 무료로 다운로드할 수 있는 SDK를 설치해야 합니다. 다음 명령을 실행하여 최신 버전의 SDK를 설치하기만 하면 됩니다.
pip install asposepdfcloud
REST API에 액세스하려면 등록하고 개인 자격 증명을 받아야 합니다. 관련 정보는 빠른 시작 가이드를 참조하세요.
Python을 사용하여 PDF 헤더에 텍스트 추가
SDK를 사용하면 문서의 머리글 섹션에 텍스트 문자열을 추가할 수 있으며, 다음 단계에 따라 이 요구 사항을 달성할 수 있습니다.
- 먼저 클라이언트 ID와 클라이언트 비밀번호를 인수로 제공하면서 ApiClient 클래스의 인스턴스를 생성합니다.
- 둘째, ApiClient 객체를 입력 인수로 받는 PdfApi 클래스의 객체를 생성합니다.
- 셋째, TextHeader 인스턴스의 속성을 정의하는 TextHeader 객체를 생성합니다.
- TextHeader에 대한 텍스트 서식을 설정하려면 전경색, 글꼴 크기, 글꼴 이름 등을 정의하는 TextState 객체를 생성합니다.
- 마지막으로 postdocumenttextheader(..) 메서드를 호출하여 PDF 문서에 텍스트 헤더를 추가하고 결과 파일을 클라우드 저장소에 저장합니다.
def addTextHeader():
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 = 'awesomeTable.pdf'
# 텍스트 헤더를 정의하는 객체를 만듭니다.
textHeader = asposepdfcloud.TextHeader()
# 백그라운드에서 헤더를 렌더링할 값을 설정합니다.
textHeader.background = False
# 텍스트 헤더의 수평 정렬을 가운데로 설정
textHeader.horizontal_alignment = 'Center'
# 헤더의 불투명도를 0.5로 설정
textHeader.opacity = 0.5
# 회전 각도 없음
textHeader.rotate = None
textHeader.rotate_angle = 0
# X 및 Y 들여쓰기 값 설정
textHeader.x_indent = 100
textHeader.y_indent = 100
# 확대 비율을 1.0으로 설정하세요
textHeader.zoom = 1.0
# 헤더 내부에 렌더링될 텍스트 값
textHeader.value = 'Aspose.PDF Cloud'
# 텍스트의 형식을 정의하는 TextState 인스턴스를 생성합니다.
textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
{"A": 0,
"R": 252,
"G": 173,
"B": 3},font_style=2)
# TextHeader에 TextState 객체 전달
textHeader.text_state = textState
# PDF 문서에 텍스트 헤더를 추가하기 위해 API를 호출합니다.
response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
# 콘솔에 응답 코드 출력
print(response)
# 콘솔에 메시지 출력 (선택 사항)
print('Text Header successfully added to PDF !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
이미지 2: PDF 문서의 텍스트 머리글 미리보기.
입력 및 결과 PDF 파일은 awesomeTable.pdf 및 awesomeTable-TextHeader.pdf에서 다운로드할 수 있습니다.
Python을 사용하여 PDF 헤더에 이미지 추가
PDF 헤더 섹션에 이미지 객체를 추가하려면 아래 지침을 따르세요. 결과 파일은 클라우드 스토리지에 업로드됩니다.
- 먼저, 클라이언트 ID와 클라이언트 비밀번호를 인수로 제공하면서 ApiClient 클래스의 인스턴스를 생성합니다.
- 둘째, ApiClient 객체를 입력 인수로 받는 PdfApi 클래스의 객체를 생성합니다.
- 이제 ImageHeader의 속성을 정의하는 ImageHeader 객체를 만듭니다.
- 특정 페이지의 헤더 렌더링을 제어하기 위해 startpagenumber 및 endpagenumber 선택적 매개변수에 값이 할당됩니다.
- 마지막으로 postdocumentimageheader(..) 메서드를 호출하여 PDF 문서에 이미지 헤더를 추가하고 결과 파일을 클라우드 저장소에 저장합니다. 헤더는 문서의 처음 두 페이지에만 추가된다는 점에 유의하세요(코드에 지정된 대로).
def addImageHeader():
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 = 'awesomeTable.pdf'
# ImageHeader 인스턴스 생성
imageHeader = asposepdfcloud.ImageHeader()
# 배경 속성을 true로 설정하세요
imageHeader.background = True
# 수평 정렬을 오른쪽으로 설정
imageHeader.horizontal_alignment = 'Right'
imageHeader.opacity = 0.7
imageHeader.rotate = None
imageHeader.rotate_angle = 0
imageHeader.x_indent = 10
imageHeader.y_indent = 10
imageHeader.zoom = .5
# 헤더에 추가할 클라우드 스토리지에 있는 이미지 파일의 이름
imageHeader.file_name = 'Koala.jpg'
# 헤더 이미지의 너비
imageHeader.width = 120
# 헤더의 이미지 높이
imageHeader.height = 120
imageHeader.left_margin = 0
imageHeader.top_margin = 10
imageHeader.right_margin = 10
# 머리글을 추가할 문서의 시작 페이지
startPage = 1
# 문서의 마지막 페이지에 헤더를 추가하세요
endPage = 2
# PDF 문서에 이미지 헤더를 추가하고 결과 파일을 클라우드 스토리지에 저장하기 위해 API를 호출합니다.
response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
# 콘솔의 pritn 응답 코드
print(response)
# 콘솔에 메시지 출력 (선택 사항)
print('Image Header successfully added to PDF !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
Image 3:- Preview of Image Header added in PDF.
위의 예에서 생성된 소스 파일과 결과 파일은 다음에서 다운로드할 수 있습니다.
cURL 명령을 사용하여 PDF에 텍스트 헤더 추가
cURL 명령은 명령줄 터미널을 통해 REST API에 액세스하기 위한 편리한 메커니즘을 제공합니다. Aspose.PDF Cloud도 REST 아키텍처에 따라 개발되었으므로 cURL 명령을 사용하여 API에 액세스할 수도 있습니다. 이 접근 방식은 명령줄 도구로 작업하는 것을 선호하거나 PDF 헤더 편집을 더 큰 자동화 워크플로에 통합해야 하는 개발자에게 유용할 수 있습니다.
이제 REST API를 사용하려면 다음 명령을 실행하여 클라이언트 자격 증명을 기반으로 JSON 웹 액세스 토큰(JWT)을 생성해야 합니다.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
JWT 토큰을 받으면 다음 명령을 사용하여 문서의 첫 번째와 두 번째 페이지 머리글 섹션에 텍스트를 추가해 보세요.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/text?startPageNumber=1&endPageNumber=2" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": false, \"HorizontalAlignment\": \"Center\", \"Opacity\": 0.5, \"Rotate\": \"None\", \"RotateAngle\": 0, \"XIndent\": 100, \"YIndent\": 10, \"Zoom\": 1.0, \"TextAlignment\": \"None\", \"Value\": \"Aspose.PDF Cloud\", \"TextState\": { \"FontSize\": 15, \"Font\": \"Arial\", \"ForegroundColor\": { \"A\": 0, \"R\": 252, \"G\": 173, \"B\": 3 }, \"BackgroundColor\": { \"A\": 10, \"R\": 0, \"G\": 0, \"B\": 0 } }, \"LeftMargin\": 0, \"TopMargin\": 0, \"RightMargin\": 0}"
cURL 명령을 사용하여 PDF에 이미지 헤더 추가
다음 cURL 명령을 사용하여 PDF 문서에 이미지 헤더를 추가하고 결과 파일을 클라우드 저장소에 저장해 보세요. 다음 명령에서 불투명도가 0.7로 정의되고, 확대/축소 계수가 0.5이고, 이미지 높이 및 너비 속성이 120포인트로 정의된 문서의 첫 번째 및 두 번째 페이지에 이미지 헤더를 추가합니다.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/image?startPageNumber=1&endPageNumber=2" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": true, \"HorizontalAlignment\": \"Right\", \"Opacity\": 0.7, \"Rotate\": \"None\", \"RotateAngle\": 0, \"XIndent\": 10, \"YIndent\": 10, \"Zoom\": .5, \"FileName\": \"Koala.jpg\", \"Width\": 120, \"Height\": 120, \"LeftMargin\": 0, \"TopMargin\": 10, \"RightMargin\": 10}"
결론
결론적으로, PDF 문서의 헤더에 이미지와 텍스트를 추가하는 것은 문서의 시각적 매력과 브랜딩을 강화할 수 있는 유용한 기능입니다. Aspose.PDF Cloud SDK for Python을 사용하면 몇 줄의 코드로 간단히 수행할 수 있습니다. 송장, 보고서 또는 헤더가 필요한 다른 문서를 만들 때 이 기능을 사용하면 시간과 노력을 절약하고 출력 품질을 향상시킬 수 있습니다. Aspose.PDF Cloud SDK for Python을 사용하는 것 외에도 cURL 명령을 사용하여 PDF 헤더에 이미지와 텍스트를 추가하는 것도 가능하다는 것을 알게 되었습니다.
이 글이 여러분의 Python 애플리케이션에 이 기능을 추가하는 데 필요한 모든 지침과 영감을 제공하기를 바랍니다.
유용한 링크
관련기사
자세한 내용은 다음 기사를 참조하세요.