backend_pdf

Un back-end PDF Matplotlib.

Autore: Jouni K Seppänen < jks @ iki . fi > e altri.

matplotlib.backends.backend_pdf. FigureCanvas

alias diFigureCanvasPdf

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

Basi:FigureCanvasBase

disegna ( )

Rendi il file Figure.

Questo metodo deve percorrere l'albero dell'artista, anche se non viene prodotto alcun output, poiché attiva il lavoro differito a cui gli utenti potrebbero voler accedere prima di salvare l'output su disco. Ad esempio limiti di calcolo, limiti automatici e valori tick.

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

fisso_dpi = 72

get_default_filetype ( )

Restituisce il formato di file savefig predefinito come specificato in rcParams["savefig.format"](default: 'png').

La stringa restituita non include un punto. Questo metodo viene sovrascritto nei backend che supportano solo un singolo tipo di file.

print_pdf ( nome file , * , bbox_inches_restore = Nessuno , metadati = Nessuno )

classe matplotlib.backends.backend_pdf. GraphicsContextPdf ( file )

Basi:GraphicsContextBase

alpha_cmd ( alfa , forzato , effettivo_alfa )

capstyle_cmd ( stile )

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

clip_cmd ( cliprect , clippath )

Imposta il rettangolo della clip. Chiamate pop()e push().

comandi = ((('_cliprect', '_clippath'), <funzione GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effect_alphas'), <funzione GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <funzione GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <funzione GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <funzione GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <funzione GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <function GraphicsContextPdf.dash_cmd>), (('_rgb',), <function GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>))

copy_properties ( altro )

Copia le proprietà di other in self.

trattino_cmd ( trattini )

delta ( altro )

Copia le proprietà di other in self e restituisce i comandi PDF necessari per trasformare self in other.

fill ( * args )

Predicato: il percorso deve essere riempito?

È possibile utilizzare un argomento facoltativo per specificare un _fillcolor alternativo, come richiesto da RendererPdf.draw_markers.

fillcolor_cmd ( rgb )

finalizzare ( )

Assicurati che ogni stato grafico spinto venga estratto.

cmd_tratteggio ( tratteggio , colore_tratteggio )

joinstyle_cmd ( stile )

joinstyles = {'bevel': 2, 'mitre': 0, 'round': 1}

linewidth_cmd ( larghezza )

vernice ( )

Restituisce l'operatore pdf appropriato per fare in modo che il percorso venga tracciato, riempito o entrambi.

pop ( )

premi ( )

rgb_cmd ( rgb )

tratto ( )

Predicato: il percorso deve essere accarezzato (il suo contorno disegnato)? Questo verifica le varie condizioni che disabilitano la tracciatura del percorso, nel qual caso sarebbe presumibilmente riempito.

classe matplotlib.backends.backend_pdf. Nome ( nome )

Basi:object

Oggetto nome PDF.

esadecimale statico ( corrispondenza )

[ Deprecato ]

Appunti

Deprecato dalla versione 3.6:

nome

pdfRepr ( )

classe matplotlib.backends.backend_pdf. Op ( valore )

Basi:Enum

Operatori PDF (elenco non esaustivo).

testo_inizio = b'BT'

clip = b'W'

close_fill_stroke = sib'b'

close_stroke = b's'

closepath = b'h'

concat_matrix = b'cm'

curveto = b'c'

end_text = b'ET'

percorso finale = b'n '

riempimento = b'f'

fill_stroke = b'B'

grestore = b'Q'

gsave = b'q'

lineto = b'l'

moveto = b'm'

proprietà op

classmethod paint_path ( fill , stroke )

Restituisce l'operatore PDF per tracciare un percorso.

Parametri :

riempire bool

Riempi il percorso con il colore di riempimento.

colpo bool

Traccia il contorno del percorso con il colore della linea.

pdfRepr ( )

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

ombreggiatura = b'sh'

mostra = b'Tj'

showkern = b'TJ'

tratto = b'S'

textmatrix = b'Tm'

textpos = b'Td'

use_xobject = b'Do'

classe matplotlib.backends.backend_pdf. Operatore ( op )

Basi:object

[ Deprecato ]

Appunti

Deprecato dalla versione 3.6:

operazione

pdfRepr ( )

classe matplotlib.backends.backend_pdf. PdfFile ( nome file , metadati = Nessuno )

Basi:object

Oggetto file PDF.

Parametri :

filename str o simile a un percorso o simile a un file

Obiettivo di uscita; se una stringa, verrà aperto un file per la scrittura.

i metadati dettano da stringhe a stringhe e date

Oggetto dizionario informazioni (vedere la sezione di riferimento PDF 10.2.1 'Dizionario informazioni documento'), ad es.: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Le chiavi standard sono "Title", "Author", "Subject", "Keywords", "Creator", "Producer", "CreationDate", "ModDate" e "Trapped". I valori sono stati predefiniti per 'Creator', 'Producer' e 'CreationDate'. Possono essere rimossi impostandoli su None.

addGouraudTriangles ( punti , colori )

Aggiungi un'ombreggiatura triangolare Gouraud.

Parametri :

punti np.ndarray

Vertici del triangolo, forma (n, 3, 2) dove n = numero di triangoli, 3 = vertici, 2 = x, y.

colori np.ndarray

Colori dei vertici, forma (n, 3, 1) o (n, 3, 4) come per i punti, ma l'ultima dimensione è (grigio) o (r, g, b, alfa).

Resi :

Nome, Riferimento

alphaState ( alpha )

Restituisce il nome di un ExtGState che imposta alpha sul valore specificato.

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

chiudi ( )

Svuota tutti i buffer e libera tutte le risorse.

createType1Descriptor ( t1font , fontfile )

dviFontName ( dvifont )

Dato un oggetto font dvi, restituisce un nome adatto a Op.selectfont. Registra le informazioni sui font self.dviFontInfose non ancora registrate.

embedTTF ( nome file , caratteri )

Incorpora il carattere TTF dal file indicato nel documento.

endStream ( )

finalizzare ( )

Scrivi i vari oggetti differiti e la questione finale del pdf.

fontName ( fontprop )

Seleziona un font basato su fontprop e restituisce un nome adatto a Op.selectfont. Se fontprop è una stringa, verrà interpretato come il nome file del font.

hatchPattern ( hatch_style )

imageObject ( immagine )

Restituisce il nome di un'immagine XObject che rappresenta l'immagine data.

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

Restituisce il nome di un marcatore XObject che rappresenta il percorso specificato.

nuovaPagina ( larghezza , altezza )

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

output ( * dati )

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

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

static pathOperations ( percorso , trasformazione , clip = None , semplifica = None , sketch = None )

recordXref ( id )

reserveObject ( nome = '' )

Prenota un ID per un oggetto indiretto.

Il nome viene utilizzato per il debug nel caso in cui ci dimentichiamo di stampare l'oggetto con writeObject.

scrivi ( dati )

writeExtGStates ( )

writeFonts ( )

writeGouraudTriangles ( )

writeHatches ( )

writeImages ( )

writeInfoDict ( )

Scrivi il dizionario delle informazioni, verificandone la buona forma

writeMarkers ( )

writeObject ( oggetto , contenuto )

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

writePathCollectionTemplates ( )

writeTrailer ( )

Scrivi il trailer in PDF.

scriviXrif ( )

Scrivi la tabella xrif.

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

Basi:object

Un file PDF multipagina.

Appunti

In realtà PdfPagesè un sottile involucro attorno PdfFilea , per evitare confusione quando si usa savefige si dimentica l'argomento del formato.

Esempi

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

Crea un nuovo oggetto PdfPages.

Parametri :

filename str o simile a un percorso o simile a un file

I grafici che utilizzano PdfPages.savefigverranno scritti in un file in questa posizione. Il file viene aperto immediatamente e qualsiasi file precedente con lo stesso nome viene sovrascritto.

keep_empty bool, facoltativo

Se impostato su False, i file pdf vuoti verranno eliminati automaticamente alla chiusura.

metadati dict, facoltativo

Oggetto dizionario informazioni (vedere la sezione di riferimento PDF 10.2.1 'Dizionario informazioni documento'), ad es.: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Le chiavi standard sono "Title", "Author", "Subject", "Keywords", "Creator", "Producer", "CreationDate", "ModDate" e "Trapped". I valori sono stati predefiniti per 'Creator', 'Producer' e 'CreationDate'. Possono essere rimossi impostandoli su None.

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

Aggiungi una nuova nota di testo alla pagina da salvare successivamente. L'opzionale positionRect specifica la posizione della nuova nota sulla pagina. È fuori dalla pagina per impostazione predefinita per assicurarsi che sia invisibile sulle stampe.

chiudi ( )

Finalizza questo oggetto, trasformando il file sottostante in un file PDF completo.

get_pagecount ( )

Restituisce il numero corrente di pagine nel file pdf multipagina.

infodict ( )

Restituisce un oggetto dizionario informazioni modificabile (vedere la sezione di riferimento PDF 10.2.1 'Dizionario informazioni documento').

tieni_vuoto

savefig ( cifra = Nessuno , ** kwargs )

Salva Figurein questo file come nuova pagina.

Qualsiasi altro argomento di parola chiave viene passato a savefig.

Parametri :

figure Figureo int, default: la figura attiva

La figura, o l'indice della figura, salvata nel file.

classe matplotlib.backends.backend_pdf. Riferimento ( id )

Basi:object

Oggetto di riferimento PDF.

Utilizzare PdfFile.reserveObject() per creare riferimenti.

pdfRepr ( )

write ( contenuto , file )

classe matplotlib.backends.backend_pdf. RendererPdf ( file , image_dpi , altezza , larghezza )

Basi:RendererPDFPSBase

check_gc ( gc , fillcolor = None )

draw_gouraud_triangle ( gc , points , colors , trans )

Disegna un triangolo ombreggiato da Gouraud.

Parametri :

gcGraphicsContextBase

Il contesto grafico.

points (3, 2) come un array

Array di (x, y) punti per il triangolo.

colors (3, 4) simile a un array

Colori RGBA per ogni punto del triangolo.

trasformarematplotlib.transforms.Transform

Una trasformazione affine da applicare ai punti.

draw_gouraud_triangles ( gc , points , colors , trans )

Disegna una serie di triangoli Gouraud.

Parametri :

punti (N, 3, 2) simili a array

Array di N (x, y) punti per i triangoli.

colori (N, 3, 4) simili a array

Array di N colori RGBA per ogni punto dei triangoli.

trasformarematplotlib.transforms.Transform

Una trasformazione affine da applicare ai punti.

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

Disegna un'immagine RGBA.

Parametri :

gcGraphicsContextBase

Un contesto grafico con informazioni di ritaglio.

x scalare

La distanza in unità fisiche (ovvero, punti o pixel) dal lato sinistro della tela.

y scalare

La distanza in unità fisiche (ovvero, punti o pixel) dal lato inferiore dell'area di disegno.

im (N, M, 4) simile a un array di np.uint8

Un array di pixel RGBA.

trasformarematplotlib.transforms.Affine2DBase

Se e solo se il backend concreto è scritto in modo tale che option_scale_imagerestituisce True, può essere passata Affine2DBasea . Il vettore di traslazione della trasformazione è dato in unità fisiche (cioè, punti o pixel). Si noti che la trasformazione non sovrascrive x e y e deve essere applicata prima di tradurre il risultato in x e y (questo può essere ottenuto aggiungendo x e y al vettore di traduzione definito da transform ).draw_image

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

Disegna un marcatore su ciascuno dei vertici del percorso (esclusi i punti di controllo).

L'implementazione di base (fallback) effettua più chiamate a draw_path. I backend potrebbero voler sovrascrivere questo metodo per disegnare il marcatore solo una volta e riutilizzarlo più volte.

Parametri :

gcGraphicsContextBase

Il contesto grafico.

marker_transmatplotlib.transforms.Transform

Una trasformazione affine applicata al marcatore.

transmatplotlib.transforms.Transform

Una trasformazione affine applicata al percorso.

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

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

Disegna Pathun'istanza usando la trasformata affine data.

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

Disegna una raccolta di percorsi .

Ogni percorso viene prima trasformato dalla voce corrispondente in all_transforms (un elenco di (3, 3) matrici) e quindi da master_transform . Vengono quindi tradotti dalla voce corrispondente in offsets , che è stata prima trasformata da offset_trans .

facecolors , edgecolors , linewidths , linestyles e antialiased sono elenchi che impostano le proprietà corrispondenti.

offset_position non è attualmente utilizzato, ma l'argomento viene mantenuto per compatibilità con le versioni precedenti.

L'implementazione di base (fallback) effettua più chiamate a draw_path. I backend potrebbero voler eseguire l'override di questo per eseguire il rendering di ogni set di dati di percorso solo una volta e quindi fare riferimento a quel percorso più volte con i diversi offset, colori, stili ecc. I metodi del generatore _iter_collection_raw_pathse _iter_collectionsono forniti per aiutare con (e standardizzare) l'implementazione attraverso i backend. Si consiglia vivamente di utilizzare tali generatori, in modo che le modifiche al comportamento di draw_path_collectionpossano essere apportate a livello globale.

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

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

Disegna un'istanza di testo.

Parametri :

gcGraphicsContextBase

Il contesto grafico.

x galleggiante

La posizione x del testo nelle coordinate di visualizzazione.

tu galleggi

La posizione y della linea di base del testo nelle coordinate di visualizzazione.

str _

La stringa di testo.

puntellomatplotlib.font_manager.FontProperties

Le proprietà del carattere.

galleggiante angolare

L'angolo di rotazione in gradi in senso antiorario.

mtestomatplotlib.text.Text

Oggetto di testo originale di cui eseguire il rendering.

Appunti

Nota per gli implementatori di backend:

Quando stai cercando di determinare se hai ottenuto il riquadro di delimitazione corretto (che è ciò che consente al layout/allineamento del testo di funzionare correttamente), è utile modificare la riga in text.py:

if 0: bbox_artist(self, renderer)

a se 1, quindi il riquadro di delimitazione effettivo verrà tracciato insieme al testo.

codifica_stringa ( s , fonttype )

finalizzare ( )

get_image_magnification ( )

Ottieni il fattore di cui ingrandire le immagini passate a draw_image. Consente a un backend di avere immagini con una risoluzione diversa rispetto ad altri artisti.

new_gc ( )

Restituisce un'istanza di un file GraphicsContextBase.

classe matplotlib.backends.backend_pdf. Stream ( id , len , file , extra = Nessuno , png = Nessuno )

Basi:object

Oggetto flusso PDF.

Questo non ha il metodo pdfRepr. Invece, chiama begin(), quindi invia in output il contenuto del flusso chiamando write() e infine chiama end().

Parametri :

id int

ID oggetto del flusso.

len Riferimento o Nessuno

Un oggetto Reference inutilizzato per la lunghezza del flusso; Nessuno significa utilizzare un buffer di memoria in modo che la lunghezza possa essere incorporata.

file PdfFile

L'oggetto sottostante in cui scrivere il flusso.

extra dict da Nome a qualsiasi cosa o Nessuno

Coppie chiave-valore aggiuntive da includere nell'intestazione del flusso.

png dict o Nessuno

Se i dati sono già codificati in png, i parametri di decodifica.

compressobj

fine ( )

Finalizza il flusso.

extra

file

di identificazione

len

pdfFile

posizione

scrivi ( dati )

Scrivi alcuni dati sul flusso.

classe matplotlib.backends.backend_pdf. Verbatim ( x )

Basi:object

Memorizza il contenuto del comando PDF alla lettera per includerlo successivamente nello stream.

pdfRepr ( )

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

[ Deprecato ]

Appunti

Deprecato dalla versione 3.6: utilizza invece una copia venduta di _fill.

matplotlib.backends.backend_pdf. pdfRepr ( obj )

Associa gli oggetti Python alla sintassi PDF.