Documentation – 파이썬에서 PDF 아티팩트로 작업하기

Python-Net: 파이썬에서 PDF에 베이츠 넘버링 추가

Wed, 10 Jun 2026 00:00:00 +0000

베이츠 넘버링은 법률, 의료 및 비즈니스 워크플로우에서 문서 세트 내의 페이지에 고유한 순차 식별자를 할당하는 데 널리 사용됩니다..NET을 통한 Python용 Aspose.PDF 프로그램은 이 프로세스를 자동화하는 간단하고 유연한 API를 제공하므로 표준화된 베이츠 번호를 모든 PDF에 프로그래밍 방식으로 적용할 수 있습니다.

를 사용하여 BatesNArtifact 클래스에서 개발자는 시작 번호, 자릿수, 접두사 및 접미사, 정렬 및 여백을 포함하여 번호 지정 동작을 완전히 사용자 지정할 수 있습니다.구성이 완료되면 아티팩트를 에 적용할 수 있습니다. Document 를 통해 add_bates_numbering 에 대한 메서드 PageCollection 또는 목록의 일부로 추가 PaginationArtifact 사물.또한 Aspose.PDF 는 델리게이트 기반 구성 스타일을 지원하므로 런타임 시 아티팩트 설정을 동적으로 제어할 수 있습니다.

API는 Bates 번호를 생성하는 것 외에도 다음을 사용하여 Bates 번호를 쉽게 제거할 수 있는 방법을 제공합니다. delete_bates_numbering문서 처리 워크플로우에 완벽한 유연성을 제공합니다.

이 문서에서는 Aspose.PDF for Python을 사용하여.NET을 통해 PDF에서 Bates 넘버링을 추가하고 제거하는 여러 방법을 아티팩트 구성, 적용 및 제거에 대한 명확한 예와 함께 보여줍니다.

베이츠 넘버링 아티팩트 추가

이 예제에서는 .NET을 통해 Python용 Aspose.PDF 를 사용하여 PDF 문서에 Bates 넘버링을 프로그래밍 방식으로 추가하는 방법을 보여줍니다.를 구성하여 BatesNArtifact 원하는 설정을 사용하여 문서 페이지에 적용하면 각 페이지에 표준화된 식별자를 추가하는 프로세스를 자동화할 수 있습니다.

Bates 넘버링 아티팩트를 a에 추가하려면 Document, 전화해 AddBatesNumbering(BatesNArtifact) 의 확장 메서드 PageCollection, 합격 BatesNArtifact 매개 변수로서의 인스턴스:

import sys
from os import path
import aspose.pdf as ap

def _create_bates_artifact():
    """Create a Bates numbering artifact with default settings."""
    artifact = ap.BatesNArtifact()
    artifact.start_page = 1
    artifact.end_page = 0
    artifact.subset = ap.Subset.ALL
    artifact.number_of_digits = 6
    artifact.start_number = 1
    artifact.prefix = ""
    artifact.suffix = ""
    artifact.artifact_vertical_alignment = ap.VerticalAlignment.BOTTOM
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.RIGHT
    artifact.right_margin = 72
    artifact.left_margin = 72
    artifact.top_margin = 36
    artifact.bottom_margin = 36
    return artifact

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact(infile, outfile):
    """Add Bates numbering artifact to a PDF document."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_bates_numbering(document.pages, bates_artifact)
        document.save(outfile)

페이징 아티팩트를 사용하여 Bates 넘버링 추가

파이썬용 Aspose.PDF 파일의 페이지네이션 아티팩트 컬렉션을 사용하여 PDF에 베이츠 넘버링을 추가합니다.

PDF 문서를 로드합니다.
필요한 경우 넘버링을 적용하기 전에 추가 페이지를 삽입합니다.
베이츠 아티팩트를 만드세요.
아티팩트 속성을 구성합니다.
아티팩트를 페이지 매김 컬렉션에 추가합니다.
페이지에 페이지 매김을 적용합니다.
업데이트된 문서를 저장합니다.

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact_pagination(infile, outfile):
    """Add Bates numbering using pagination artifacts collection."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_pagination(document.pages, [bates_artifact])
        document.save(outfile)

베이츠 넘버링 삭제

에서 Bates 넘버링을 제거하려면 Document, 사용 delete_bates_numbering() 에 대한 메서드 PageCollection:

import sys
from os import path
import aspose.pdf as ap

def delete_bates_numbering(infile, outfile):
    """Delete Bates numbering from a PDF document."""
    with ap.Document(infile) as document:
        ap.PageCollectionExtensions.delete_bates_numbering(document.pages)
        document.save(outfile)

Python-Net: 파이썬에서 PDF 배경 추가

Wed, 10 Jun 2026 00:00:00 +0000

PDF에 배경 이미지 추가

배경 이미지를 사용하여 문서에 워터마크 또는 기타 미묘한 디자인을 추가할 수 있습니다..NET을 통한 Python용 Aspose.PDF 문서에서 각 PDF 문서는 페이지 모음이고 각 페이지에는 아티팩트 컬렉션이 포함되어 있습니다. 배경 아티팩트 클래스는 페이지 개체에 배경 이미지를 추가하는 데 사용할 수 있습니다.

이 방법은 장식 이미지를 검색 가능한 문서 텍스트로 바꾸지 않고 주요 PDF 내용 뒤에 배치해야 할 때 유용합니다.

다음 코드 스니펫은 Python에서 BackgroundArtifact 객체를 사용하여 PDF 페이지에 배경 이미지를 추가하는 방법을 보여줍니다.

PDF 문서를 로드합니다.
배경 아티팩트 만들기.
이미지 파일을 로드합니다.
아티팩트를 페이지에 첨부합니다.
업데이트된 문서를 저장합니다.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_to_pdf(infile, imagefile, outfile):
    """Add a background image to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

PDF에 불투명도가 있는 배경 이미지 추가

파이썬용 Aspose.PDF 를 사용하여 PDF 페이지에 반투명 배경 이미지를 추가합니다.

불투명도를 적용하면 배경 이미지가 부분적으로 투명해져서 원본 페이지 내용 (텍스트, 이미지 등) 이 선명하게 보입니다.이는 특히 다음과 같은 경우에 유용합니다.

워터마크
브랜딩 오버레이
미묘한 디자인 개선

배경이 아티팩트로 추가되어 모든 페이지 콘텐츠 뒤에 그대로 유지됩니다.

PDF 문서를 로드합니다.
배경 아티팩트 만들기.
이미지 파일을 로드합니다.
불투명도 수준을 설정합니다.
아티팩트를 페이지에 첨부합니다.
업데이트된 문서를 저장합니다.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_with_opacity_to_pdf(infile, imagefile, outfile):
    """Add a background image with opacity to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        artifact.opacity = 0.5
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

PDF에 배경색 추가

파이썬용 Aspose.PDF 파일을 사용하여 PDF 페이지에 단색 배경색을 적용합니다.

PDF 문서를 로드합니다.
배경 아티팩트 만들기.
배경색을 설정합니다.
아티팩트를 페이지에 첨부합니다.
업데이트된 문서를 저장합니다.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_color_to_pdf(infile, outfile):
    """Add a solid color background to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_color = ap.Color.dark_khaki
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

PDF에서 배경 제거

파이썬용 Aspose.PDF 파일을 사용하여 PDF 페이지에서 배경 아티팩트를 제거합니다. PDF의 배경은 아티팩트로 저장되는 경우가 많은데, 이 메서드는 배경 요소로 분류된 아티팩트만 선택적으로 식별하여 제거합니다.

PDF 문서를 로드합니다.
페이지 아티팩트에 액세스합니다.
배경 아티팩트를 필터링합니다.
배경 요소를 수집하세요.
배경 아티팩트를 삭제합니다.
업데이트된 문서를 저장합니다.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def remove_background(infile, outfile):
    with ap.Document(infile) as document:
        backgrounds = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.BACKGROUND
        ]

        for background in backgrounds:
            document.pages[1].artifacts.delete(background)

        document.save(outfile)

Python-Net: 파이썬에서 PDF에 워터마크 추가

Wed, 10 Jun 2026 00:00:00 +0000

PDF에 워터마크 아티팩트 추가 Document .NET을 통해 파이썬용 Aspose.PDF 사용.워터마크는 브랜딩, 보안 또는 정보 제공 목적으로 페이지에 적용되는 시각적 오버레이입니다.이 예제에서는 구성 방법을 보여줍니다. TextState 모양, 위치 지정 HorizontalAlignment 과 VerticalAlignment에 워터마크를 적용하기 전의 회전 및 투명도 Page.

PDF에서 워터마크 추출

PDF 문서를 로드합니다.
페이지 아티팩트에 액세스합니다.
워터마크 아티팩트를 필터링합니다.
워터마크 요소를 수집하세요.
워터마크 속성을 추출합니다.
워터마크 정보를 출력합니다.

from os import path
import sys
import aspose.pdf as ap

def extract_watermark_from_pdf(infile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            print(f"{watermark.text} {watermark.rectangle}")

PDF에 워터마크 추가

파이썬용 Aspose.PDF 를 사용하여 PDF 문서에 텍스트 워터마크를 추가합니다.

PDF 문서를 로드합니다.
텍스트 상태를 생성합니다.
워터마크 아티팩트를 생성합니다.
워터마크 텍스트와 스타일을 설정합니다.
위치 지정 및 회전을 구성합니다.
불투명도 및 배경 동작을 설정합니다.
페이지에 워터마크를 첨부합니다.
업데이트된 문서를 저장합니다.

from os import path
import sys
import aspose.pdf as ap

def add_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        text_state = ap.text.TextState()
        text_state.font_size = 72
        text_state.foreground_color = ap.Color.blue_violet
        text_state.font_style = ap.text.FontStyles.BOLD
        text_state.font = ap.text.FontRepository.find_font("Arial")

        watermark = ap.WatermarkArtifact()
        watermark.set_text_and_state("WATERMARK", text_state)
        watermark.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
        watermark.artifact_vertical_alignment = ap.VerticalAlignment.CENTER
        watermark.rotation = 60
        watermark.opacity = 0.2
        watermark.is_background = True

        document.pages[1].artifacts.append(watermark)
        document.save(outfile)

PDF 페이지에서 워터마크 아티팩트 제거

Python용 Aspose.PDF API를 사용하여 PDF 문서의 특정 페이지에서 워터마크 아티팩트를 제거합니다.이 접근 방식은 페이지 아티팩트로 저장된 워터마크 요소 (특히 페이지 매김 워터마크 하위 유형으로 분류된 요소) 를 대상으로 하고, 이를 반복하고, 업데이트된 문서를 저장하기 전에 삭제합니다.

PDF 문서를 로드합니다.
페이지 아티팩트에 액세스합니다.
워터마크 아티팩트를 필터링합니다.
워터마크 아티팩트를 삭제합니다.
업데이트된 문서를 저장합니다.

from os import path
import sys
import aspose.pdf as ap

def delete_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            document.pages[1].artifacts.delete(watermark)

        document.save(outfile)

Python-Net: 파이썬에서 PDF 아티팩트 계산

Wed, 10 Jun 2026 00:00:00 +0000

특정 유형의 아티팩트 계산

PDF의 페이지 매김 아티팩트 검사 및 계산 Document .NET을 통해 파이썬용 Aspose.PDF 사용.페이지 매김 아티팩트에는 레이아웃 및 식별 목적으로 페이지에 적용되는 워터마크, 배경, 머리글, 바닥글과 같은 요소가 포함됩니다.필터링을 통해 Artifact a에 있는 객체 Page 하위 유형별로 그룹화 (Artifact.ArtifactSubtype) 를 통해 개발자는 문서의 구조를 빠르게 분석하고 특정 요소가 있는지 확인할 수 있습니다.

특정 유형의 아티팩트의 총 개수 (예: 워터마크의 총 수) 를 계산하려면 다음 코드를 사용하십시오.이 예제에서는 페이지의 내용을 필터링합니다. Artifacts 컬렉션 (또는 ArtifactCollection) 에 의해 Artifact.ArtifactType 그런 다음 하위 유형을 계산합니다 (Artifact.ArtifactSubtype).

PDF 문서 열기 (참조 Document).
페이지를 사용하여 페이지 매김 아티팩트를 필터링합니다. Artifacts 컬렉션.
하위 유형별 아티팩트 수 계산 (Artifact.ArtifactSubtype).
결과를 인쇄합니다.


from os import path
from collections import Counter
import sys
import aspose.pdf as ap

def count_pdf_artifacts(infile):
    """Count and display artifacts of different types on the first page."""
    with ap.Document(infile) as document:
        pagination_artifacts = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
        ]

        subtypes = [artifact.subtype for artifact in pagination_artifacts]
        counts = Counter(subtypes)

        print(f"Watermarks: {counts.get(ap.Artifact.ArtifactSubtype.WATERMARK, 0)}")
        print(f"Backgrounds: {counts.get(ap.Artifact.ArtifactSubtype.BACKGROUND, 0)}")
        print(f"Headers: {counts.get(ap.Artifact.ArtifactSubtype.HEADER, 0)}")
        print(f"Footers: {counts.get(ap.Artifact.ArtifactSubtype.FOOTER, 0)}")

Python-Net: Python을 사용하여 PDF 머리말과 꼬리말 관리하기

Wed, 10 Jun 2026 00:00:00 +0000

스타일이 적용된 텍스트 아티팩트 만들기

이 유틸리티 함수는 Python용 Aspose.PDF 를 사용하여 PDF 페이지용 재사용 가능한 텍스트 아티팩트를 만드는 방법을 설명합니다.글꼴 설정, 색상, 크기 및 정렬을 포함하여 일관된 서식을 사용하여 스타일이 지정된 머리글 또는 바닥글을 생성하도록 설계되었습니다.이 함수는 아티팩트 생성을 추상화하여 다양한 페이지 수준의 텍스트 장식에 재사용할 수 있도록 합니다.

아티팩트 오브젝트를 인스턴스화합니다.
아티팩트 텍스트 내용을 설정합니다.
텍스트 스타일 적용
정렬을 설정합니다.
구성된 아티팩트를 반환합니다.

from os import path
import aspose.pdf as ap
import sys

def _create_text_artifact(artifact_class, text):
    """Create a text artifact (header/footer) with common styling."""
    artifact = artifact_class()
    artifact.text = text
    artifact.text_state.font_size = 14
    artifact.text_state.font = ap.text.FontRepository.find_font("Arial")
    artifact.text_state.foreground_color = ap.Color.navy
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
    return artifact

PDF에 머리글 추가

입력 PDF를 엽니다.
“샘플 헤더”라는 텍스트로 헤더 아티팩트를 생성합니다.
첫 페이지에 추가합니다.
업데이트된 PDF를 저장합니다.

from os import path
import aspose.pdf as ap
import sys

def add_header_artifact(infile, outfile):
    """Add a header artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        header = _create_text_artifact(ap.HeaderArtifact, "Sample Header")
        document.pages[1].artifacts.append(header)
        document.save(outfile)

PDF에 바닥글 추가

입력 PDF를 엽니다.
“샘플 푸터”라는 텍스트로 푸터 아티팩트를 생성합니다.
첫 페이지에 추가합니다.
출력 파일을 저장합니다.

from os import path
import aspose.pdf as ap
import sys

def add_footer_artifact(infile, outfile):
    """Add a footer artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        footer = _create_text_artifact(ap.FooterArtifact, "Sample Footer")
        document.pages[1].artifacts.append(footer)
        document.save(outfile)

머리글 또는 바닥글 아티팩트 삭제

PDF를 엽니다.
페이지네이션 머리글 또는 바닥글로 표시된 아티팩트를 찾을 수 있습니다.
첫 페이지에서 삭제하세요.
정리한 문서를 저장합니다.

from os import path
import aspose.pdf as ap
import sys

def delete_header_footer_artifact(infile, outfile):
    with ap.Document(infile) as document:
        header_footers = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and (
                artifact.subtype == ap.Artifact.ArtifactSubtype.HEADER
                or artifact.subtype == ap.Artifact.ArtifactSubtype.FOOTER
            )
        ]

        for art in header_footers:
            document.pages[1].artifacts.delete(art)

        document.save(outfile)

Documentation – 파이썬에서 PDF 아티팩트로 작업하기

Python-Net: 파이썬에서 PDF에 베이츠 넘버링 추가

베이츠 넘버링 아티팩트 추가

페이징 아티팩트를 사용하여 Bates 넘버링 추가

베이츠 넘버링 삭제

관련 아티팩트 주제

Python-Net: 파이썬에서 PDF 배경 추가

PDF에 배경 이미지 추가

PDF에 불투명도가 있는 배경 이미지 추가

PDF에 배경색 추가

PDF에서 배경 제거

관련 아티팩트 주제

Python-Net: 파이썬에서 PDF에 워터마크 추가

PDF에서 워터마크 추출

PDF에 워터마크 추가

PDF 페이지에서 워터마크 아티팩트 제거

관련 아티팩트 주제

Python-Net: 파이썬에서 PDF 아티팩트 계산

특정 유형의 아티팩트 계산

관련 아티팩트 주제

Python-Net: Python을 사용하여 PDF 머리말과 꼬리말 관리하기

스타일이 적용된 텍스트 아티팩트 만들기

PDF에 머리글 추가

PDF에 바닥글 추가

머리글 또는 바닥글 아티팩트 삭제

관련 아티팩트 주제