digi21.io.pdf

Módulo: digi21.io

Escribe archivos PDF (.pdf) de una página con el dibujo. El exportador no lee PDF, así que el módulo no tiene open.

import digi21.io.pdf as pdf

create

create(path, digitab=None, crs="", *, page_size="auto", scale=1000.0, explode_symbology=True,
       title="") -> DrawingWriter

Los parámetros a partir de page_size son los de la orden PARAMETROS_IMPORTACION para PDF, y se pasan solo por nombre.

Qué hace el exportador:

• Dibuja la página al cerrar el escritor.
• No dibuja las geometrías de los códigos que la tabla de códigos marca como no imprimibles.
• No dibuja símbolos: una tabla de códigos cargada con DigiTab.load no tiene las fuentes de símbolos.

Con page_size="auto", la página toma la extensión de las geometrías dibujadas. Si esa extensión no tiene ancho y alto mayores que 0 (no se ha dibujado ninguna geometría, por ejemplo sin tabla de códigos, o solo un punto), cerrar el escritor lanza RuntimeError con un mensaje que pide elegir un tamaño de página.

Excepciones de create: ValueError si page_size no es un tamaño válido, scale no es mayor que 0 o crs no es válido; FileNotFoundError si la carpeta de path no existe.

Ejemplos

Los ejemplos de esta página se han ejecutado con Python 3.12; la salida que se muestra es la real. Como el módulo no lee PDF, el ejemplo de lectura busca en el archivo el tamaño de la página y el título.

Crear un PDF A4 desde cero

import digi21.io.pdf as pdf
from digi21.base import DigiTab, Line, Point, Polygon, Text

digitab = DigiTab.load("Digi.tab.xml")

with pdf.create("parcelas.pdf", digitab, page_size="A4", title="Parcelas") as writer:
    writer.add(Point((500010.0, 4400010.0, 650.0), ["010123"]))
    writer.add(Line(["040645"], [(500000, 4400000, 650), (500100, 4400000, 652), (500100, 4400080, 655)]))
    writer.add(Polygon(["020402"], [(500000, 4400000, 650), (500100, 4400000, 652),
                                    (500100, 4400080, 655), (500000, 4400000, 650)]))
    writer.add(Text("Parcela 12", (500050, 4400040, 653), ["020402"], text_height=2.5))

print(writer.written, "escritas,", writer.rejected, "rechazadas")
with open("parcelas.pdf", "rb") as archivo:
    print(archivo.read(8))

4 escritas, 0 rechazadas
b'%PDF-1.7'

Leer el tamaño de la página y el título

import re

with open("parcelas.pdf", "rb") as archivo:
    contenido = archivo.read()

print(re.search(rb"/MediaBox\s*\[[^\]]*\]", contenido).group().decode())
print(re.search(rb"/Title\s*\([^)]*\)", contenido).group().decode())

/MediaBox[0 0 595 842]
/Title(Parcelas)

595 × 842 puntos PDF es el tamaño A4.

Convertir un archivo BinDouble a PDF A3

import digi21.io.bindouble as bind
import digi21.io.pdf as pdf
from digi21.base import DigiTab

digitab = DigiTab.load("Digi.tab.xml")
with pdf.create("parcelas-convertido.pdf", digitab, page_size="A3") as writer:
    for geometry in bind.open("parcelas.bind", digitab):
        writer.add(geometry)

print(writer.written, "escritas,", writer.rejected, "rechazadas")

4 escritas, 0 rechazadas

parcelas.bind es el archivo que crea el primer ejemplo de digi21.io.bindouble.

Página automática a dos escalas

import re

import digi21.io.pdf as pdf
from digi21.base import DigiTab, Line

digitab = DigiTab.load("Digi.tab.xml")
for escala in (1000.0, 500.0):
    nombre = f"escala-{int(escala)}.pdf"
    with pdf.create(nombre, digitab, scale=escala) as writer:
        writer.add(Line(["040645"], [(500000, 4400000, 650), (500100, 4400000, 652), (500100, 4400080, 655)]))
    with open(nombre, "rb") as archivo:
        print(escala, re.search(rb"/MediaBox\s*\[[^\]]*\]", archivo.read()).group().decode())

1000.0 /MediaBox[0 0 283.465 226.772]
500.0 /MediaBox[0 0 566.929 453.543]

La línea ocupa 100 × 80 m. A 1:1000 son 10 × 8 cm (283,465 × 226,772 puntos PDF); a 1:500, el doble.

Tamaño de página no válido

import digi21.io.pdf as pdf

try:
    pdf.create("x.pdf", page_size="A7")
except ValueError as error:
    print(error)
print(hasattr(pdf, "open"))

Unknown page_size 'A7'. Valid values: auto, A0, A1, A2, A3, A4, A5, RA0, RA1, RA2, RA3, RA4, RA5, B0, B1, B2, B3, B4, B5, Quarto, Foolscap, Executive, GovernmentLetter, Letter, Legal, Ledger, Tabloid, Post, Crown, LargePost, Demy, Medium, Royal, Elephant, DoubleDemy, QuadDemy, STMT, Folio, Statement, Size10x14.
False

Véase también

• digi21.io — índice de módulos y lo que tienen en común.
• DrawingWriter
• Formato PDF