sgcPDF Macierz funkcji

Wszystko, co robi sgcPDF, pogrupowane według zadania. Każda funkcja jest zaimplementowana w Object Pascalu w jednostkach sgcPDF_*.pas i dostarczana z pełnym kodem źródłowym. Przykłady kodu na tej stronie zostały skompilowane ze źródłami sgcPDF i uruchomione.

Tworzenie

FunkcjaSzczegóły
StronyDowolny rozmiar i orientacja strony, A4, Letter lub niestandardowy, oraz obrót strony.
Tekst14 standardowych czcionek PDF i kolorowy tekst, z zawijaniem akapitów przez płótno i renderery HTML.
Osadzone czcionkiTrueType, OpenType (kontury TrueType i CFF) oraz kolekcje TrueType, automatycznie osadzane i tworzone jako podzbiór, z mapami Unicode ToUnicode, dzięki czemu tekst można kopiować i wyszukiwać.
Złożone systemy pismaKerning i ligatury, arabskie formy łączenia przez GSUB oraz dwukierunkowy algorytm Unicode dla tekstu pisanego od prawej do lewej.
Tekst CJKTekst chiński, japoński i koreański za pomocą osadzonych czcionek TrueType i kolekcji TrueType.
ObrazyJPEG, PNG z kanałem alfa, BMP i TIFF (w tym obrazy faksowe CCITT), z miękkimi maskami.
Grafika wektorowaLinie, prostokąty, okręgi, elipsy, krzywe Béziera, wielokąty, wzory kresek, zakończenia i połączenia linii, przezroczystość i gradienty.
TabeleTabele z nagłówkami, obramowaniami, marginesami komórek i kolorami kontynuowanymi na kolejnych stronach.
Kody kreskoweCode 128, Code 39, EAN-13, EAN-8, UPC-A, ITF, Codabar, GS1-128, kod QR, DataMatrix (ECC200) i PDF417, rysowane jako wektory.
Adnotacje i linkiNotatki tekstowe, podświetlenia, linki do URL i stron, pieczęcie i adnotacje tekstowe.
Zakładki i warstwyZagnieżdżone zakładki (konspekt) i opcjonalne grupy treści (warstwy), które czytelnicy mogą pokazywać lub ukrywać.
HTML na PDFTsgcPDFHTMLRenderer: nagłówki, akapity, style CSS inline, listy, tabele, obrazy, linki, podziały stron, nagłówki, stopki i numery stron.
Płótno i EMF na PDFTsgcPDFCanvas zapisuje wywołania rysowania jako treść PDF, a metapliki EMF są odtwarzane jako wektory PDF, dzięki czemu istniejący kod raportów i wykresów generuje wyjście PDF.

HTML na PDF

procedure HTMLToPDF(const APDFFile: string);
var
  oHTML: TsgcPDFHTMLRenderer;
begin
  oHTML := TsgcPDFHTMLRenderer.Create(nil);
  try
    oHTML.PageWidth := 595;
    oHTML.PageHeight := 842;
    oHTML.FooterText := 'Page {page} of {pages}';
    oHTML.HTMLToPDFFile(
      '<html><head><style>h1 { color: #003366 }</style></head><body>' +
      '<h1>Invoice 2026-001</h1>' +
      '<table><tr><th>Item</th><th>Amount</th></tr>' +
      '<tr><td>Consulting</td><td>299.00</td></tr></table>' +
      '</body></html>', APDFFile);
  finally
    oHTML.Free;
  end;
end;

Edycja

FunkcjaSzczegóły
Znaki wodne i pieczęcieZnaki wodne z czcionką, rozmiarem, obrotem, kolorem i przezroczystością, na jednej lub wszystkich stronach.
Nagłówki, stopki, numery stronTekst nagłówka i stopki oraz numery stron w formacie takim jak Page %d of %d.
Operacje na stronachŁączenie dokumentów, dzielenie, wyodrębnianie zakresów stron, wstawianie, usuwanie, obracanie i zmiana kolejności stron.
Zapis przyrostowyZmiany są dodawane do oryginalnego pliku jako nowa wersja, dzięki czemu wcześniejsze podpisy cyfrowe pozostają ważne.
Kompaktowe wyjścieStrumienie obiektów i strumienie odniesień krzyżowych dla mniejszych plików, plus TsgcPDFOptimizer do usuwania duplikatów i nieużywanych obiektów oraz zmniejszania rozdzielczości obrazów.
Duże plikiPrzesunięcia są w pełni 64-bitowe, a obiekty są wczytywane na żądanie ze strumienia, dzięki czemu można otwierać i zapisywać pliki większe niż 2 GB.

Renderowanie i przeglądarki

FunkcjaSzczegóły
Przeglądarka VCLTsgcPDFViewerControl z przewijaniem, trybami powiększenia, nawigacją po stronach, zaznaczaniem i kopiowaniem tekstu, wyszukiwaniem z podświetleniem, wypełnianiem pól formularza, nawigacją po linkach i drukowaniem, plus TsgcPDFThumbnailView i TsgcPDFOutlineView.
Przeglądarka FireMonkeyTsgcPDFViewerFMX rysuje poprzez płótno FMX w systemach Windows, macOS, iOS i Android.
Renderer rastrowy dla serwerówTsgcPDFRendererRaster to rasteryzator w czystym Object Pascalu, który renderuje strony do pikseli lub PNG bez GDI, w systemach Windows i Linux.
Renderer GDI i eksportRenderowanie do bitmapy lub kontekstu urządzenia w Windows oraz eksport stron i miniatur do BMP, PNG lub JPEG za pomocą TsgcPDFExporter.
Model graficznyPrzestrzenie kolorów DeviceGray, DeviceRGB, DeviceCMYK, indeksowane, ICCBased i Lab, cieniowania osiowe i promieniowe, wzory kafelkowe, miękkie maski, przezroczystość mieszania i formularzowe XObject.
CzcionkiOsadzone programy czcionek TrueType, CFF, OpenType i Type 1 są renderowane na podstawie ich konturów, ze standardowymi kodowaniami i czcionkami CID Identity-H.
Dekodery obrazówFlate, LZW, ASCII85, ASCIIHex, RunLength, JPEG (baseline i progresywny, CMYK), JPEG 2000, CCITT grupa 3 i 4 oraz JBIG2.

Ekstrakcja

FunkcjaSzczegóły
TekstTekst strony lub całego dokumentu, z mapowaniem Unicode czcionek osadzonych i CID.
Pozycje tekstuTsgcPDFTextExtractor zwraca każdy fragment tekstu wraz z X, Y, nazwą i rozmiarem czcionki.
WyszukiwanieZnajdowanie tekstu na stronie lub w dokumencie.
ObrazyTsgcPDFImageExtractor wylicza obrazy strony, w tym obrazy inline i te wewnątrz formularzowych XObject, i dekoduje je do PNG, JPEG lub BMP.
Metadane i załącznikiInformacje o dokumencie, metadane XMP, zakładki, warstwy i osadzone pliki.

Formularze

FunkcjaSzczegóły
Twórz formularzePola tekstowe, pola wyboru, przyciski opcji, listy rozwijane, listy i przyciski ze strumieniami wyglądu.
Wypełnij i spłaszczUstaw wartości pól w kodzie lub w przeglądarce, a następnie spłaszcz formularz do statycznej treści strony.
FDF i XFDFImportuj i eksportuj dane formularza jako FDF i XFDF.

Bezpieczeństwo i podpisy

FunkcjaSzczegóły
Szyfrowanie hasłemRC4 40-bitowy i 128-bitowy, AES-128 i AES-256 (rewizje 5 i 6), z hasłem użytkownika i właściciela oraz flagami uprawnień. Zaszyfrowane pliki są odszyfrowywane przy wczytywaniu.
Szyfrowanie certyfikatemSzyfrowanie kluczem publicznym dla jednego lub wielu certyfikatów odbiorcy (adbe.pkcs7.s4 i adbe.pkcs7.s5).
Podpisy cyfrowePodpisywanie certyfikatem PFX, widocznymi lub niewidocznymi polami podpisu, SHA-256, SHA-384 i SHA-512, znacznikami czasu RFC 3161 i znacznikami czasu dokumentu.
PAdES przez sgcSignTsgcPDFPAdESSigner tworzy podpisy ETSI.CAdES.detached na poziomach B-B, B-T, B-LT i B-LTA, z danymi walidacyjnymi DSS, korzystając z dowolnego dostawcy kluczy sgcSign (PEM, PFX, PKCS#11, magazyn certyfikatów Windows, chmurowe HSM). sgcSign jest licencjonowany osobno.
WeryfikacjaTsgcPDFSignatureVerifier sprawdza integralność, pokrycie zakresu bajtów, certyfikat podpisującego i łańcuch certyfikatów każdego podpisu.
RedagowanieTsgcPDFRedactor usuwa tekst na poziomie glifu, piksele obrazu, ścieżki wektorowe i adnotacje w obrębie obszaru lub pasujące do tekstu, dodaje nakładkę i może usunąć metadane. Usuniętego tekstu nie można wyodrębnić z wyniku.

Szyfrowanie hasłem AES-256

procedure CreateEncryptedPDF(const AFileName: string);
var
  oPDF: TsgcPDFDocument;
begin
  oPDF := TsgcPDFDocument.Create;
  try
    oPDF.AddPage(595, 842).DrawText('Secret', 50, 780, sfHelveticaBold, 24);
    // user password opens the file, owner password grants full rights
    oPDF.SetEncryption(emAES_256, 'user123', 'owner456');
    oPDF.SaveToFile(AFileName);
  finally
    oPDF.Free;
  end;
end;

Podpisywanie certyfikatem PFX

procedure SignPDF(const AInput, AOutput: string);
var
  oSigner: TsgcPDFSignatureHandler;
begin
  oSigner := TsgcPDFSignatureHandler.Create;
  try
    oSigner.LoadCertificateFromPFX('signer.pfx', 'test123');
    oSigner.Reason := 'Document approval';
    oSigner.Location := 'Barcelona';
    oSigner.HashAlgorithm := shaSHA256;
    // visible signature field on page 1: Left, Bottom, Right, Top
    oSigner.SetField('Signature1', 0, 50, 50, 250, 100);
    oSigner.SignDocument(AInput, AOutput);
  finally
    oSigner.Free;
  end;
end;

PAdES przez mostek sgcSign

procedure SignPAdES(const AInput, AOutput: string);
var
  oKey: TsgcPEMKeyProvider;
  oSigner: TsgcPDFPAdESSigner;
begin
  oKey := TsgcPEMKeyProvider.Create(nil);
  oSigner := TsgcPDFPAdESSigner.Create(nil);
  try
    // any sgcSign key provider: PEM, PFX, PKCS#11, Windows store, cloud HSM
    oKey.LoadFromFile('signer.pem', 'signer.key');
    oSigner.KeyProvider := oKey;
    // paBB, paBT (timestamp), paBLT and paBLTA (long term validation)
    oSigner.Level := paBB;
    // signature field and appearance through the sgcPDF handler
    oSigner.Handler.SetField('Signature1', 0, 350, 50, 550, 110);
    oSigner.Handler.SignerName := 'John Smith';
    oSigner.Handler.Reason := 'Approved';
    oSigner.SignPDFFile(AInput, AOutput);
    oSigner.KeyProvider := nil;
  finally
    oSigner.Free;
    oKey.Free;
  end;
end;

Redaguj nazwisko i obszar

procedure RedactFile(const AInput, AOutput: string);
var
  oRedactor: TsgcPDFRedactor;
  vOptions: TsgcPDFRedactionOptions;
begin
  oRedactor := TsgcPDFRedactor.Create;
  try
    // every occurrence of a text, on all pages
    oRedactor.AddText('John Smith');
    // an area of page 0: left, bottom, right, top in points
    oRedactor.AddArea(0, 50, 500, 250, 650);
    vOptions := oRedactor.Options;
    vOptions.OverlayText := 'REDACTED';
    vOptions.RemoveMetadata := True;
    oRedactor.Options := vOptions;
    oRedactor.Apply(AInput, AOutput);
  finally
    oRedactor.Free;
  end;
end;

Archiwizacja i dostępność

FunkcjaSzczegóły
PDF/AWyjście PDF/A-1, PDF/A-2 i PDF/A-3 w poziomach a i b, z metadanymi XMP, output intent i osadzonymi czcionkami.
WalidatorTsgcPDFAValidator sprawdza plik pod kątem wybranego poziomu PDF/A i zgłasza błędy oraz ostrzeżenia.
Otagowany PDFDrzewo struktury z Document, Part, Sect, H1-H6, P, L, LI, Table, TR, TH, TD i Figure z tekstem alternatywnym, treścią oznaczoną, mapą ról, językiem i MarkInfo.
PDF/UA-1Dostępne wyjście razem z PDF/A-2a lub PDF/A-3a oraz kontrole PDF/UA-1 w walidatorze.
ZałącznikiOsadzone pliki z typem MIME, datami i powiązaniami plików powiązanych PDF/A-3.
Factur-X i ZUGFeRDOsadza XML faktury ze schematem rozszerzenia XMP Factur-X dla profili Minimum, Basic WL, Basic, EN 16931, Extended i XRechnung, i zapisuje plik jako PDF/A-3b.

Faktura Factur-X jako PDF/A-3b

procedure CreateFacturX(const AInvoiceXML, AFileName: string);
var
  oPDF: TsgcPDFDocument;
  oXML: TMemoryStream;
  vXML: TBytes;
  vFont: Integer;
begin
  oPDF := TsgcPDFDocument.Create;
  oXML := TMemoryStream.Create;
  try
    // the invoice XML (CII) is created by your application
    oXML.LoadFromFile(AInvoiceXML);
    SetLength(vXML, oXML.Size);
    Move(oXML.Memory^, vXML[0], oXML.Size);
    oPDF.Info.Title := 'Invoice 2026-001';
    // PDF/A requires embedded fonts
    vFont := oPDF.AddTrueTypeFont('Arial', False, False);
    oPDF.AddPage(595, 842).DrawTextTT('Invoice 2026-001', 50, 780, vFont, 18);
    // embeds factur-x.xml, adds the Factur-X XMP schema, saves as PDF/A-3b
    oPDF.Attachments.AddFacturX(vXML, fxpEN16931);
    oPDF.SaveToFile(AFileName);
  finally
    oXML.Free;
    oPDF.Free;
  end;
end;

Waliduj PDF/A

procedure ValidatePDFA(const AFileName: string);
var
  oParser: TsgcPDFParser;
  oValidator: TsgcPDFAValidator;
  i: Integer;
begin
  oParser := TsgcPDFParser.Create;
  oValidator := TsgcPDFAValidator.Create(paA3b);
  try
    oParser.LoadFromFile(AFileName);
    oParser.Parse;
    if oValidator.Validate(oParser) then
      WriteLn('PDF/A-3b: no errors')
    else
      for i := 0 to oValidator.Errors.Count - 1 do
        WriteLn('Error: ', oValidator.Errors[i]);
  finally
    oValidator.Free;
    oParser.Free;
  end;
end;
Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Buduj z sgcPDF

Poproś o wersję próbną i dodaj funkcje PDF do swojej aplikacji Delphi lub C++ Builder.