backend_pdf

Um back-end PDF Matplotlib.

Autor: Jouni K Seppänen < jks @ iki . fi > e outros.

matplotlib.backends.backend_pdf. FigureCanvas

pseudônimo deFigureCanvasPdf

classe matplotlib.backends.backend_pdf. FigureCanvasPdf ( figure = None )

Bases:FigureCanvasBase

desenhar ( )

Renderize o Figure.

Esse método deve percorrer a árvore do artista, mesmo que nenhuma saída seja produzida, porque aciona o trabalho adiado que os usuários podem querer acessar antes de salvar a saída no disco. Por exemplo, calcular limites, limites automáticos e valores de escala.

filetypes = {'pdf': ' Formato de documento portátil '}

dpi_fixo = 72

get_default_filetype ( )

Retorna o formato de arquivo savefig padrão conforme especificado em rcParams["savefig.format"](padrão: 'png').

A string retornada não inclui um ponto. Este método é substituído em back-ends que suportam apenas um único tipo de arquivo.

print_pdf ( filename , * , bbox_inches_restore = Nenhum , metadados = Nenhum )

classe matplotlib.backends.backend_pdf. GraphicsContextPdf ( arquivo )

Bases:GraphicsContextBase

alpha_cmd ( alpha , forçado , Effective_alphas )

capstyle_cmd ( estilo )

capstyles = {'butt': 0, 'projecting': 2, 'round': 1}

clip_cmd ( cliprect , clippath )

Defina o retângulo do clipe. Chamadas pop()e push().

comandos = ((('_cliprect', '_clippath'), <função GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <função GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <função GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <função GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <função GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <função GraphicsContextPdf.linewidth_cmd>), (('_traços',), <função GraphicsContextPdf.dash_cmd>), (('_rgb',), <função GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <função GraphicsContextPdf.hatch_cmd>))

copy_properties ( outro )

Copiar propriedades de outros para si mesmo.

traço_cmd ( travessões )

delta ( outro )

Copie as propriedades de outro para si mesmo e retorne os comandos PDF necessários para transformar o eu em outro.

fill ( * args )

Predicado: o caminho precisa ser preenchido?

Um argumento opcional pode ser usado para especificar um _fillcolor alternativo, conforme necessário para RendererPdf.draw_markers.

fillcolor_cmd ( rgb )

finalizar ( )

Certifique-se de que todos os estados gráficos enviados sejam exibidos.

hatch_cmd ( hatch , hatch_color )

joinstyle_cmd ( estilo )

joinstyles = {'bisel': 2, 'esquadria': 0, 'redondo': 1}

linewidth_cmd ( largura )

pintar ( )

Retorne o operador pdf apropriado para fazer com que o caminho seja traçado, preenchido ou ambos.

pop ( )

push ( )

rgb_cmd ( rgb )

acidente vascular cerebral ( )

Predicado: o caminho precisa ser traçado (seu contorno desenhado)? Isso testa as várias condições que desativam o traçado do caminho, caso em que presumivelmente seria preenchido.

classe matplotlib.backends.backend_pdf. Nome ( nome )

Bases:object

Objeto de nome PDF.

hexify estático ( correspondência )

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.6:

nome

pdfRepr ( )

classe matplotlib.backends.backend_pdf. Op ( valor )

Bases:Enum

Operadores de PDF (lista não exaustiva).

begin_text = b'BT'

clipe = 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'

fill = b'f'

fill_stroke = b'B'

grestore = b'Q'

gsave = b'q'

lineto = b'l'

moveto = b'm'

propriedade op

classmethod paint_path ( fill , stroke )

Retorne o operador PDF para pintar um caminho.

Parâmetros :

preenchimento bool

Preencha o caminho com a cor de preenchimento.

acidente vascular cerebral bool

Trace o contorno do caminho com a cor da linha.

pdfRepr ( )

retângulo = 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'

sombreamento = b'sh'

show = b'Tj'

showkern = b'TJ'

curso = b'S'

textmatrix = b'Tm'

textpos = b'Td'

use_xobject = b'Do'

classe matplotlib.backends.backend_pdf. Operador ( op )

Bases:object

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.6:

op

pdfRepr ( )

classe matplotlib.backends.backend_pdf. PdfFile ( filename , metadata = None )

Bases:object

Objeto de arquivo PDF.

Parâmetros :

filename str ou path-like ou file-like

Meta de saída; se for string, um arquivo será aberto para escrita.

ditado de metadados de strings para strings e datas

Objeto do dicionário de informações (consulte a seção de referência do PDF 10.2.1 'Dicionário de informações do documento'), por exemplo: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

As chaves padrão são 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' e 'Trapped'. Os valores foram predefinidos para 'Creator', 'Producer' e 'CreationDate'. Eles podem ser removidos definindo-os como None.

addGouraudTriangles ( pontos , cores )

Adicione um sombreamento de triângulo Gouraud.

Parâmetros :

pontos np.ndarray

Vértices do triângulo, forma (n, 3, 2) onde n = número de triângulos, 3 = vértices, 2 = x, y.

cores np.ndarray

Cores de vértice, forma (n, 3, 1) ou (n, 3, 4) como com pontos, mas a última dimensão é (cinza,) ou (r, g, b, alfa).

Devoluções :

Nome, Referência

alphaState ( alpha )

Nome de retorno de um ExtGState que define alfa para o valor fornecido.

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

fechar ( )

Descarregue todos os buffers e libere todos os recursos.

createType1Descriptor ( t1font , fontfile )

dviFontName ( dvifont )

Dado um objeto de fonte dvi, retorne um nome adequado para Op.selectfont. Isso registra as informações da fonte, self.dviFontInfocaso ainda não estejam registradas.

embedTTF ( nome do arquivo , caracteres )

Incorpore a fonte TTF do arquivo nomeado ao documento.

endStream ( )

finalizar ( )

Escreva os vários objetos adiados e o assunto final do pdf.

fontName ( fontprop )

Selecione uma fonte baseada em fontprop e retorne um nome adequado para Op.selectfont. Se fontprop for uma string, ela será interpretada como o nome do arquivo da fonte.

hatchPattern ( hatch_style )

imageObject ( imagem )

Nome de retorno de um XObject de imagem que representa a imagem fornecida.

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

Nome de retorno de um XObject marcador que representa o caminho fornecido.

newPage ( largura , altura )

newTextnote ( text , positionRect = [-100, -100, 0, 0] )

saída ( * dados )

outputStream ( ref , dados , * , extra = Nenhum )

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

static pathOperations ( caminho , transformar , cortar = Nenhum , simplificar = Nenhum , esboço = Nenhum )

recordXref ( id )

reserveObject ( nome = '' )

Reserve um ID para um objeto indireto.

O nome é usado para depuração caso nos esqueçamos de imprimir o objeto com writeObject.

escreva ( dados )

writeExtGStates ( )

writeFonts ( )

writeGouraudTriangles ( )

writeHatches ( )

writeImages ( )

writeInfoDict ( )

Escreva o dicionário de informações, verificando se está em boas condições

writeMarkers ( )

writeObject ( objeto , conteúdo )

writePath ( path , transform , clip = False , sketch = None )

writePathCollectionTemplates ( )

writeTrailer ( )

Escreva o trailer em PDF.

writeXref ( )

Escreva a tabela refex.

classe matplotlib.backends.backend_pdf. PdfPages ( filename , keep_empty = True , metadata = None )

Bases:object

Um arquivo PDF de várias páginas.

Notas

Na realidade, PdfPagesé um wrapper fino em torno PdfFilede , para evitar confusão ao usar savefige esquecer o argumento de formato.

Exemplos

>>> 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()

Crie um novo objeto PdfPages.

Parâmetros :

filename str ou path-like ou file-like

Os gráficos usando PdfPages.savefigserão gravados em um arquivo neste local. O arquivo é aberto imediatamente e qualquer arquivo antigo com o mesmo nome é substituído.

keep_empty bool, opcional

Se definido como Falso, os arquivos PDF vazios serão excluídos automaticamente quando fechados.

dicionário de metadados , opcional

Objeto do dicionário de informações (consulte a seção de referência do PDF 10.2.1 'Dicionário de informações do documento'), por exemplo: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

As chaves padrão são 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' e 'Trapped'. Os valores foram predefinidos para 'Creator', 'Producer' e 'CreationDate'. Eles podem ser removidos definindo-os como None.

attach_note ( text , positionRect = [-100, -100, 0, 0] )

Adicione uma nova nota de texto à página a ser salva a seguir. O positionRect opcional especifica a posição da nova nota na página. Ele fica fora da página por padrão para garantir que fique invisível nas impressões.

fechar ( )

Finalize este objeto, tornando o arquivo subjacente um arquivo PDF completo.

get_pagecount ( )

Retorna o número atual de páginas no arquivo PDF de várias páginas.

infodict ( )

Retorna um objeto de dicionário de informações modificável (consulte a seção de referência do PDF 10.2.1 'Dicionário de informações do documento').

mantenha_vazio

savefig ( figure = None , ** kwargs )

Salve um Figureneste arquivo como uma nova página.

Quaisquer outros argumentos de palavra-chave são passados ​​para savefig.

Parâmetros :

figura Figureou int, padrão: a figura ativa

A figura, ou índice da figura, que é salva no arquivo.

classe matplotlib.backends.backend_pdf. Referência ( id )

Bases:object

Objeto de referência PDF.

Use PdfFile.reserveObject() para criar Referências.

pdfRepr ( )

escreva ( conteúdo , arquivo )

classe matplotlib.backends.backend_pdf. RendererPdf ( arquivo , image_dpi , altura , largura )

Bases:RendererPDFPSBase

check_gc ( gc , fillcolor = Nenhum )

draw_gouraud_triangle ( gc , pontos , cores , trans )

Desenhe um triângulo sombreado por Gouraud.

Parâmetros :

gcGraphicsContextBase

O contexto gráfico.

pontos (3, 2) tipo array

Matriz de (x, y) pontos para o triângulo.

cores (3, 4) tipo array

Cores RGBA para cada ponto do triângulo.

transformarmatplotlib.transforms.Transform

Uma transformação afim para aplicar aos pontos.

draw_gouraud_triangles ( gc , pontos , cores , trans )

Desenhe uma série de triângulos de Gouraud.

Parâmetros :

pontos (N, 3, 2) tipo matriz

Matriz de N (x, y) pontos para os triângulos.

cores (N, 3, 4) tipo matriz

Matriz de N cores RGBA para cada ponto dos triângulos.

transformarmatplotlib.transforms.Transform

Uma transformação afim para aplicar aos pontos.

draw_image ( gc , x , y , im , transform = None )

Desenhe uma imagem RGBA.

Parâmetros :

gcGraphicsContextBase

Um contexto gráfico com informações de recorte.

x escalar

A distância em unidades físicas (ou seja, pontos ou pixels) do lado esquerdo da tela.

y escalar

A distância em unidades físicas (ou seja, pontos ou pixels) da parte inferior da tela.

im (N, M, 4) semelhante a uma matriz de np.uint8

Uma matriz de pixels RGBA.

transformarmatplotlib.transforms.Affine2DBase

Se e somente se o back-end concreto for escrito de forma que option_scale_imageretorne True, uma transformação afim (isto é, um Affine2DBase) poderá ser passada para draw_image. O vetor de translação da transformação é dado em unidades físicas (ou seja, pontos ou pixels). Observe que a transformação não substitui x e y , e deve ser aplicada antes de traduzir o resultado por x e y (isso pode ser feito adicionando x e y ao vetor de translação definido por transform ).

draw_markers ( gc , marcador_caminho , marcador_trans , caminho , trans , rgbFace = Nenhum )

Desenhe um marcador em cada um dos vértices do caminho (excluindo os pontos de controle).

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir esse método para desenhar o marcador apenas uma vez e reutilizá-lo várias vezes.

Parâmetros :

gcGraphicsContextBase

O contexto gráfico.

marcador_transmatplotlib.transforms.Transform

Uma transformação afim aplicada ao marcador.

transmatplotlib.transforms.Transform

Uma transformação afim aplicada ao caminho.

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

draw_path ( gc , path , transform , rgbFace = None )

Desenhe uma Pathinstância usando a transformação afim fornecida.

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

Desenhe uma coleção de caminhos .

Cada caminho é primeiro transformado pela entrada correspondente em all_transforms (uma lista de (3, 3) matrizes) e depois por master_transform . Eles são então convertidos pela entrada correspondente em offsets , que foi primeiro transformada por offset_trans .

facecolors , edgecolors , linewidths , linestyles e antialiased são listas que definem as propriedades correspondentes.

offset_position não é usado agora, mas o argumento é mantido para compatibilidade com versões anteriores.

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir isso para renderizar cada conjunto de dados de caminho apenas uma vez e, em seguida, referenciar esse caminho várias vezes com diferentes deslocamentos, cores, estilos, etc. Os métodos do gerador _iter_collection_raw_pathse _iter_collectionsão fornecidos para ajudar (e padronizar) a implementação através de back-ends. É altamente recomendável usar esses geradores, para que as alterações no comportamento de draw_path_collectionpossam ser feitas globalmente.

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

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

Desenhe uma instância de texto.

Parâmetros :

gcGraphicsContextBase

O contexto gráfico.

x flutuar

A localização x do texto nas coordenadas de exibição.

você flutua

A localização y da linha de base do texto nas coordenadas de exibição.

s str

A sequência de texto.

suportematplotlib.font_manager.FontProperties

As propriedades da fonte.

ângulo flutuante

O ângulo de rotação em graus no sentido anti-horário.

mtextmatplotlib.text.Text

O objeto de texto original a ser renderizado.

Notas

Observação para implementadores de back-end:

Quando você está tentando determinar se acertou sua caixa delimitadora (que é o que permite que o layout/alinhamento do texto funcione corretamente), é útil alterar a linha em text.py:

if 0: bbox_artist(self, renderer)

para se 1 e, em seguida, a caixa delimitadora real será plotada junto com seu texto.

encode_string ( s , tipo de fonte )

finalizar ( )

get_image_magnification ( )

Obtenha o fator pelo qual ampliar as imagens passadas para draw_image. Permite que um back-end tenha imagens em uma resolução diferente de outros artistas.

new_gc ( )

Retorne uma instância de um GraphicsContextBase.

classe matplotlib.backends.backend_pdf. Stream ( id , len , arquivo , extra = Nenhum , png = Nenhum )

Bases:object

Objeto de fluxo PDF.

Isso não tem método pdfRepr. Em vez disso, chame begin(), em seguida, gere o conteúdo do fluxo chamando write() e, finalmente, chame end().

Parâmetros :

id int

ID do objeto do fluxo.

Len Referência ou Nenhum

Um objeto de referência não utilizado para o comprimento do fluxo; Nenhum significa usar um buffer de memória para que o comprimento possa ser embutido.

arquivo PDFArquivo

O objeto subjacente no qual gravar o fluxo.

dict extra de Name para qualquer coisa, ou None

Pares extra de valor-chave para incluir no cabeçalho do stream.

png ditado ou nenhum

Se os dados já estiverem codificados em png, os parâmetros de decodificação.

compactarobj

fim ( )

Finalizar fluxo.

extra

arquivo

id

len

pdfArquivo

posição

escreva ( dados )

Escreva alguns dados no fluxo.

classe matplotlib.backends.backend_pdf. Verbatim ( x )

Bases:object

Armazene o conteúdo do comando PDF literal para inclusão posterior no fluxo.

pdfRepr ( )

matplotlib.backends.backend_pdf. fill ( strings , linelen = 75 )

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.6: em vez disso, use uma cópia fornecida de _fill.

matplotlib.backends.backend_pdf. pdfRepr ( obj )

Mapeie objetos Python para sintaxe PDF.