PDFToZPL.Core 1.0.3

PDFToZPL.Core

<p align="center"> <img src="assets/logo.png" width="160" alt="PDFToZPL.Core" /> </p>

Converte PDFs (URL → download → render → bitmap → ZPL) em comandos ZPL usando ^GFA.

Instalação

dotnet add package PDFToZPL.Core

Uso (URL → ZPL)

using System.Net.Http;
using PDFToZPL.Core;
using PDFToZPL.Core.Models;

using var httpClient = new HttpClient();
var converter = new PdfToZplConverter(httpClient);

var options = new PdfToZplOptions
{
    LicenseKey = "<KEY>",
    Dpi = 203,
    BinarizationThreshold = 160
};

var zpl = await converter.ConvertUrlToZplAsync(
    new Uri("https://servidor/arquivo.pdf"),
    options,
    CancellationToken.None);

Uso (URL → arquivos)

Gera uma pasta de execução contendo PDF, imagens (opcional) e ZPL.

using System.Net.Http;
using PDFToZPL.Core;
using PDFToZPL.Core.Models;

using var httpClient = new HttpClient();
var converter = new PdfToZplConverter(httpClient);

var request = new PdfToZplRequest
{
    PdfUri = new Uri("https://servidor/arquivo.pdf"),
    OutputRoot = "output",
    BaseFileName = "etiquetas"
};

var options = new PdfToZplOptions
{
    LicenseKey = "<KEY>",
    TimeoutSeconds = 60,
    RetryCount = 3,
    RetryBaseDelayMs = 500,
    Dpi = 203,
    LabelWidthDots = 812,
    LabelHeightDots = 1218,
    BinarizationThreshold = 160,
    OutputMode = ZplOutputMode.SingleFile,
    SaveImages = true
};

var result = await converter.ConvertFromUrlAsync(request, options, CancellationToken.None);

Opções

• LicenseKey: obrigatório.
• Dpi: DPI usado na renderização (203 é padrão para impressoras 203dpi; aumentar melhora detalhe e aumenta tamanho/tempo).
• BinarizationThreshold: limiar 0–255 para binarização (ajusta contraste).
• LabelWidthDots / LabelHeightDots: dimensões do label em dots (usado no ajuste/centralização conforme implementação).
• OutputMode: SingleFile ou OneFilePerPage.
• SaveImages: salva PNGs intermediários.

Licença (chave)

O pacote valida a chave informada em PdfToZplOptions.LicenseKey. Se estiver ausente ou inválida, a conversão falha com exceção.

Dependências

Este pacote usa:

• PDFtoImage (PDFium) para renderização do PDF
• SkiaSharp para manipulação de bitmap e geração de dados ^GFA (via dependência transitiva)

Troubleshooting

• 403 ao publicar no nuget.org: API key inválida/sem permissão ou PackageId já pertence a outra conta.
• PDFs sem extensão no link: o downloader salva localmente sempre com .pdf.