backend_pdf

PDF Matplotlib 백엔드.

저자: Jouni K Seppänen < jks @ iki . FI > 및 기타.

matplotlib.backends.backend_pdf. FigureCanvas

별칭FigureCanvasPdf

클래스 matplotlib.backends.backend_pdf. FigureCanvasPdf ( 그림 = 없음 )

베이스:FigureCanvasBase

그리기 ( )

를 렌더링합니다 Figure.

이 메서드는 출력이 생성되지 않더라도 아티스트 트리를 탐색해야 합니다. 출력을 디스크에 저장하기 전에 사용자가 액세스하려는 지연된 작업을 트리거하기 때문입니다. 예를 들어 컴퓨팅 한계, 자동 한계 및 눈금 값.

filetypes = {'pdf': 'Portable Document Format'}

fixed_dpi = 72

get_default_filetype ( )

rcParams["savefig.format"](기본값: ) 에 지정된 대로 기본 savefig 파일 형식을 반환합니다 'png'.

반환된 문자열에는 마침표가 포함되어 있지 않습니다. 이 방법은 단일 파일 형식만 지원하는 백엔드에서 재정의됩니다.

print_pdf ( 파일 이름 , * , bbox_inches_restore = 없음 , 메타데이터 = 없음 )

클래스 matplotlib.backends.backend_pdf. GraphicsContextPdf ( 파일 )

베이스:GraphicsContextBase

alpha_cmd ( 알파 , 강제 , effective_alphas )

capstyle_cmd ( 스타일 )

capstyles = {'엉덩이': 0, '투영': 2, '둥근': 1}

clip_cmd ( cliprect , clippath )

클립 사각형을 설정합니다. 통화 pop()및 push().

명령 = ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <function GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <function GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <function GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <function GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <기능 GraphicsContextPdf.dash_cmd>), (('_rgb',), <함수 GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>))

copy_properties ( 기타 )

다른 사람의 속성을 자신에게 복사합니다.

dash_cmd ( 대시 )

델타 ( 기타 )

다른 사람의 속성을 자신에게 복사하고 자신을 다른 사람으로 변환하는 데 필요한 PDF 명령을 반환합니다.

채우기 ( * 인수 )

술어: 경로를 채워야 합니까?

선택적 인수를 사용하여 RendererPdf.draw_markers에서 필요에 따라 대체 _fillcolor를 지정할 수 있습니다.

fillcolor_cmd ( rgb )

마무리 ( )

푸시된 모든 그래픽 상태가 팝되는지 확인합니다.

hatch_cmd ( 해치 , 해치 _색상 )

joinstyle_cmd ( 스타일 )

joinstyles = {'베벨': 2, '마이터': 0, '라운드': 1}

linewidth_cmd ( 너비 )

페인트 ( )

적절한 pdf 연산자를 반환하여 경로를 선으로 채우거나 채우거나 둘 다 만듭니다.

팝 ( )

푸시 ( )

rgb_cmd ( rgb )

스트로크 ( )

술어: 경로를 획으로 칠해야 합니까(윤곽선을 그어야 합니까)? 이것은 아마도 경로가 채워질 경우 경로 스트로크를 비활성화하는 다양한 조건을 테스트합니다.

클래스 matplotlib.backends.backend_pdf. 이름 ( 이름 )

베이스:object

PDF 이름 객체.

정적 hexify ( 일치 )

[ 더 이상 사용되지 않음 ]

메모

버전 3.6부터 사용되지 않음:

이름

pdfRepr ( )

클래스 matplotlib.backends.backend_pdf. 작업 ( 값 )

베이스:Enum

PDF 연산자(전체 목록이 아님).

begin_text = b'BT'

클립 = b'W'

close_fill_stroke = b'b'

close_stroke = b's'

closepath = b'h'

concat_matrix = b'cm'

curveto = b'c'

end_text = b'ET'

endpath = b'n'

채우기 = b'f'

fill_stroke = b'B'

grestore = b'Q'

gsave = b'q'

lineto = b'l'

moveto = b'm'

속성 op

classmethod paint_path ( 채우기 , 획 )

PDF 연산자를 반환하여 경로를 그립니다.

매개변수 :

채우기 부울

채우기 색상으로 패스를 채웁니다.

스트로크 부울

선 색상으로 경로의 윤곽선을 그립니다.

pdfRepr ( )

직사각형 = b're'

selectfont = b'Tf'

setcolor_nonstroke = b'scn'

setcolor_stroke = b'SCN'

setcolorspace_nonstroke = b'cs'

setcolorspace_stroke = b'CS'

setdash = b'd'

setgray_nonstroke = b'g'

setgray_stroke = b'G'

setgstate = b'gs'

setlinecap = b'J'

setlinejoin = b'j'

setlinewidth = b'w'

setrgb_nonstroke = b'rg'

setrgb_stroke = b'RG'

음영 = b'sh'

show = b'Tj'

showkern = b'TJ'

스트로크 = b'S'

textmatrix = b'Tm'

textpos = b'Td'

use_xobject = b'Do'

클래스 matplotlib.backends.backend_pdf. 연산자 ( op )

베이스:object

[ 더 이상 사용되지 않음 ]

메모

버전 3.6부터 사용되지 않음:

작업

pdfRepr ( )

클래스 matplotlib.backends.backend_pdf. PdfFile ( 파일 이름 , 메타데이터 = 없음 )

베이스:object

PDF 파일 객체.

매개변수 :

filename str 또는 경로 유사 또는 파일 유사

출력 대상; 문자열이면 쓰기를 위해 파일이 열립니다.

문자열에서 문자열 및 날짜로의 메타데이터 사전

정보 사전 개체(PDF 참조 섹션 10.2.1 '문서 정보 사전' 참조), 예: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

표준 키는 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' 및 'Trapped'입니다. 'Creator', 'Producer' 및 'CreationDate'에 대한 값이 사전 정의되었습니다. 로 설정하여 제거할 수 있습니다 None.

addGouraudTriangles ( 포인트 , 색상 )

Gouraud 삼각형 음영을 추가합니다.

매개변수 :

포인트 np.ndarray

삼각형 정점, 모양 (n, 3, 2) 여기서 n = 삼각형 수, 3 = 정점, 2 = x, y.

색상 np.ndarray

꼭짓점 색상, 모양은 점과 같이 (n, 3, 1) 또는 (n, 3, 4)이지만 마지막 차원은 (회색) 또는 (r, g, b, 알파)입니다.

반환 :

이름, 참조

alphaState ( 알파 )

알파를 주어진 값으로 설정하는 ExtGState의 이름을 반환합니다.

beginStream ( id , len , extra = None , png = None )

닫기 ( )

모든 버퍼를 플러시하고 모든 리소스를 해제합니다.

createType1Descriptor ( t1font , fontfile )

dviFontName ( dvifont )

dvi 글꼴 개체가 주어지면 Op.selectfont에 적합한 이름을 반환합니다. self.dviFontInfo아직 등록되지 않은 경우 글꼴 정보를 등록합니다.

embedTTF ( 파일 이름 , 문자 )

명명된 파일의 TTF 글꼴을 문서에 포함합니다.

endStream ( )

마무리 ( )

다양한 지연 객체와 PDF 최종 문제를 작성합니다.

fontName ( fontprop )

fontprop를 기반으로 글꼴을 선택하고 Op.selectfont에 적합한 이름을 반환합니다. fontprop가 문자열이면 글꼴의 파일 이름으로 해석됩니다.

hatchPattern ( 해치 스타일 )

imageObject ( 이미지 )

주어진 이미지를 나타내는 이미지 XObject의 이름을 반환합니다.

markerObject ( path , trans , fill , stroke , lw , joinstyle , capstyle )

주어진 경로를 나타내는 마커 XObject의 이름을 반환합니다.

newPage ( 너비 , 높이 )

newTextnote ( 텍스트 , positionRect = [-100, -100, 0, 0] )

출력 ( * 데이터 )

outputStream ( ref , data , * , extra = None )

pathCollectionObject ( gc , path , trans , padding , filled , stroked )

정적 pathOperations ( 경로 , 변환 , 클립 = 없음 , 단순화 = 없음 , 스케치 = 없음 )

recordXref ( id )

reserveObject ( 이름 = '' )

간접 개체에 대한 ID를 예약합니다.

이 이름은 writeObject로 개체를 인쇄하는 것을 잊은 경우 디버깅에 사용됩니다.

쓰기 ( 데이터 )

writeExtGSTates ( )

writeFonts ( )

writeGouraudTriangles ( )

writeHatches ( )

writeImages ( )

writeInfoDict ( )

정보 사전을 작성하고 형식이 올바른지 확인합니다.

writeMarkers ( )

writeObject ( 객체 , 내용 )

writePath ( 경로 , 변환 , 클립 = False , 스케치 = 없음 )

writePathCollectionTemplates ( )

writeTrailer ( )

PDF 예고편을 작성합니다.

writeXref ( )

외부 참조 테이블을 작성합니다.

클래스 matplotlib.backends.backend_pdf. PdfPages ( 파일 이름 , keep_empty = True , 메타데이터 = 없음 )

베이스:object

여러 페이지로 된 PDF 파일입니다.

메모

실제로 는 형식 인수를 사용하고 잊어버릴 때 혼동을 피하기 위해 를 PdfPages둘러싼 얇은 래퍼 입니다.PdfFilesavefig

예

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

새 PdfPages 개체를 만듭니다.

매개변수 :

filename str 또는 경로 유사 또는 파일 유사

사용하는 플롯 PdfPages.savefig은 이 위치의 파일에 기록됩니다. 파일이 한 번에 열리고 이름이 같은 이전 파일을 덮어씁니다.

keep_empty 부울, 선택 사항

False로 설정하면 빈 pdf 파일은 닫힐 때 자동으로 삭제됩니다.

메타데이터 사전, 선택 사항

정보 사전 개체(PDF 참조 섹션 10.2.1 '문서 정보 사전' 참조), 예: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

표준 키는 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' 및 'Trapped'입니다. 'Creator', 'Producer' 및 'CreationDate'에 대한 값이 사전 정의되었습니다. 로 설정하여 제거할 수 있습니다 None.

attach_note ( 텍스트 , positionRect = [-100, -100, 0, 0] )

다음에 저장할 페이지에 새 텍스트 메모를 추가합니다. 선택적 positionRect는 페이지에서 새 메모의 위치를 ​​지정합니다. 인쇄물에서 보이지 않도록 기본적으로 페이지 외부에 있습니다.

닫기 ( )

이 개체를 마무리하여 기본 파일을 완전한 PDF 파일로 만듭니다.

get_pagecount ( )

다중 페이지 pdf 파일의 현재 페이지 수를 반환합니다.

infodict ( )

수정 가능한 정보 사전 객체를 반환합니다(PDF 참조 섹션 10.2.1 '문서 정보 사전' 참조).

keep_empty

savefig ( 그림 = 없음 , ** kwargs )

Figure이 파일에 새 페이지로 저장합니다 .

다른 모든 키워드 인수는 에 전달됩니다 savefig.

매개변수 :

숫자 Figure또는 int, 기본값: 활성 숫자

파일에 저장되는 그림 또는 그림의 인덱스입니다.

클래스 matplotlib.backends.backend_pdf. 참조 ( id )

베이스:object

PDF 참조 객체.

참조를 생성하려면 PdfFile.reserveObject()를 사용하십시오.

pdfRepr ( )

쓰기 ( 내용 , 파일 )

클래스 matplotlib.backends.backend_pdf. RendererPdf ( 파일 , image_dpi , 높이 , 너비 )

베이스:RendererPDFPSBase

check_gc ( gc , fillcolor = 없음 )

draw_gouraud_triangle ( gc , 포인트 , 색상 , 트랜스 )

Gouraud 음영 삼각형을 그립니다.

매개변수 :

gcGraphicsContextBase

그래픽 컨텍스트입니다.

포인트 (3, 2) 배열형

삼각형의 (x, y) 점 배열입니다.

색상 (3, 4) 배열형

삼각형의 각 점에 대한 RGBA 색상입니다.

변환matplotlib.transforms.Transform

점에 적용할 아핀 변환입니다.

draw_gouraud_triangles ( gc , 포인트 , 색상 , 트랜스 )

일련의 Gouraud 삼각형을 그립니다.

매개변수 :

포인트 (N, 3, 2) 배열형

삼각형에 대한 N (x, y) 포인트 의 배열입니다 .

색상 (N, 3, 4) 배열형

삼각형의 각 점에 대한 N RGBA 색상 의 배열입니다 .

변환matplotlib.transforms.Transform

점에 적용할 아핀 변환입니다.

draw_image ( gc , x , y , im , 변환 = 없음 )

RGBA 이미지를 그립니다.

매개변수 :

gcGraphicsContextBase

클리핑 정보가 있는 그래픽 컨텍스트입니다.

x 스칼라

캔버스 왼쪽에서 물리적 단위(즉, 점 또는 픽셀)로 표시되는 거리입니다.

y 스칼라

캔버스 아래쪽에서 물리적 단위(즉, 점 또는 픽셀)로 표시되는 거리입니다.

im (N, M, 4) np.uint8의 배열과 유사

RGBA 픽셀의 배열입니다.

변환matplotlib.transforms.Affine2DBase

option_scale_image구체적인 백엔드가 를 반환 하도록 작성된 경우에만 True아핀 변환(즉, Affine2DBase) 이 에 전달될 수 있습니다 draw_image. 변환의 변환 벡터는 물리적 단위(즉, 도트 또는 픽셀)로 제공됩니다. 변환은 x 및 y 를 재정의하지 않으며 결과를 x 및 y 로 변환 하기 전에 적용 해야 합니다(이는 변환 에 의해 정의된 변환 벡터에 x 및 y 를 추가하여 수행할 수 있음 ).

draw_markers ( gc , marker_path , marker_trans , path , trans , rgbFace = None )

경로 의 각 정점(제어점 제외) 에 마커를 그 립니다.

기본(대체) 구현은 draw_path. 백엔드는 마커를 한 번만 그리고 여러 번 재사용하기 위해 이 메서드를 재정의할 수 있습니다.

매개변수 :

gcGraphicsContextBase

그래픽 컨텍스트입니다.

marker_transmatplotlib.transforms.Transform

마커에 적용된 아핀 변환입니다.

트랜스matplotlib.transforms.Transform

경로에 적용된 아핀 변환입니다.

draw_mathtext ( gc , x , y , s , prop , angle )

draw_path ( gc , 경로 , 변환 , rgbFace = 없음 )

Path주어진 아핀 변환을 사용하여 인스턴스를 그립니다 .

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiaseds , urls , offset_position )

경로 모음을 그 립니다.

각 경로는 먼저 all_transforms ((3, 3) 행렬 목록) 의 해당 항목에 의해 변환된 다음 master_transform 에 의해 변환됩니다 . 그런 다음 offset_trans 에 의해 처음 변환된 offsets 의 해당 항목에 의해 변환됩니다 .

facecolors , edgecolors , linewidths , linestyles 및 antialiased 는 해당 속성을 설정하는 목록입니다.

offset_position 은 현재 사용되지 않지만 이전 버전과의 호환성을 위해 인수가 유지됩니다.

기본(대체) 구현은 draw_path. 백엔드는 각 경로 데이터 집합을 한 번만 렌더링하기 위해 이를 재정의하고 다른 오프셋, 색상, 스타일 등으로 해당 경로를 여러 번 참조할 수 있습니다. 생성기 메서드 는 구현을 지원( _iter_collection_raw_paths및 _iter_collection표준화)하기 위해 제공됩니다. 백엔드에서. 이러한 생성기를 사용하여 의 동작을 전역적으로 변경할 수 있도록 하는 것이 좋습니다 draw_path_collection.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None )

draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None )

텍스트 인스턴스를 그립니다.

매개변수 :

gcGraphicsContextBase

그래픽 컨텍스트입니다.

x 플로트

디스플레이 좌표에서 텍스트의 x 위치입니다.

y 플로트

디스플레이 좌표에서 텍스트 기준선의 y 위치입니다.

s str

텍스트 문자열입니다.

소품matplotlib.font_manager.FontProperties

글꼴 속성입니다.

앵글 플로트

시계 반대 방향의 회전 각도입니다.

여러 줄 문자matplotlib.text.Text

렌더링할 원본 텍스트 개체입니다.

메모

백엔드 구현자를 위한 참고 사항:

바운딩 박스가 올바른지 확인하려고 할 때(텍스트 레이아웃/정렬이 제대로 작동하도록 하는 것) text.py에서 줄을 변경하는 데 도움이 됩니다.

if 0: bbox_artist(self, renderer)

1이면 실제 경계 상자가 텍스트와 함께 그려집니다.

encode_string ( s , fonttype )

마무리 ( )

get_image_magnification ( )

에 전달된 이미지를 확대할 배율을 가져옵니다 draw_image. 백엔드에서 다른 아티스트와 다른 해상도의 이미지를 가질 수 있습니다.

new_gc ( )

의 인스턴스를 반환합니다 GraphicsContextBase.

클래스 matplotlib.backends.backend_pdf. 스트림 ( id , len , file , extra = None , png = None )

베이스:object

PDF 스트림 객체.

이것은 pdfRepr 방법이 없습니다. 대신 begin()을 호출한 다음 write()를 호출하여 스트림의 내용을 출력하고 마지막으로 end()를 호출합니다.

매개변수 :

ID 정수

스트림의 개체 ID입니다.

len 참조 또는 없음

스트림 길이에 대해 사용되지 않는 참조 개체입니다. 없음은 메모리 버퍼를 사용하여 길이를 인라인할 수 있음을 의미합니다.

PDF 파일 파일

스트림을 쓸 기본 개체입니다.

Name에서 무엇이든 추가 dict 또는 None

스트림 헤더에 포함할 추가 키-값 쌍입니다.

png dict 또는 없음

데이터가 이미 png로 인코딩된 경우 디코딩 매개변수입니다.

compressobj

끝 ( )

스트림을 마무리합니다.

추가

파일

아이디

렌

pdf파일

위치

쓰기 ( 데이터 )

스트림에 일부 데이터를 씁니다.

클래스 matplotlib.backends.backend_pdf. 약어 ( x )

베이스:object

나중에 스트림에 포함할 수 있도록 그대로 PDF 명령 콘텐츠를 저장합니다.

pdfRepr ( )

matplotlib.backends.backend_pdf. 채우기 ( 문자열 , linelen = 75 )

[ 더 이상 사용되지 않음 ]

메모

버전 3.6부터 사용되지 않음: 대신 _fill의 벤더 사본을 사용하십시오.

matplotlib.backends.backend_pdf. pdfRepr ( obj )

Python 개체를 PDF 구문에 매핑합니다.