Nativní vektorové grafy

HotPDF vykresluje grafy jako nativní vektorový obsah PDF pro ostrý tisk a malé výstupyTHPDFChart kombinuje datové řady, osy, témata, legendy, popisky a přístupný text do znovupoužitelného modelu grafu, který vykresluje THPDFPage.DrawChart

Rozhraní podporuje osy, řady, legendy, popisky, datové značky a omezené uspořádání v oblasti stránky

Model grafu

THPDFChart vlastní své instance THPDFChartSeries a své dva objekty THPDFChartAxis, zatímco každá řada geometricky rozšiřuje úložiště bodů pro amortizované přidávání v konstantním čase

Zavolejte THPDFChart.AddSeries s hodnotou THPDFChartKind a poté přidávejte konečné souřadnice přes THPDFChartSeries.AddPoint

THPDFChart.ClearSeries uvolní všechny vlastněné řady, zatímco THPDFChartSeries.Clear zachová konfiguraci řady a odstraní jen její body

Vlastnosti SeriesCount, Series, Count a Points poskytují indexovaný read přístup k modelu

Řady a osy

• hckLine kreslí spojené cesty s volitelnými vektorovými značkami a popisky bodů
• hckBar kreslí seskupené sloupce kolem každé číselné souřadnice X a zahrnuje nulu do automatických mezí Y
• hckArea uzavírá každou řadu k viditelné nulové základně a používá blend výplň vnímající téma
• hckPie kreslí jednu řadu s kladnými hodnotami jako samostatně barevné vektorové výseče
• hckScatter kreslí nezávislé vektorové značky na číselných souřadnicích

Řady line, bar, area i scatter mohou sdílet jeden kartézský plot, zatímco výsečový graf musí obsahovat přesně jednu řadu hckPie

THPDFChartAxis.AutomaticMinimum a AutomaticMaximum vybírají meze řízené daty; vypnutí kterékoliv vlastnosti aktivuje odpovídající hodnotu Minimum nebo Maximum

TickCount se při renderování omezuje na rozsah 2 až 20, ShowGrid řídí mřížku os a NumberFormat dodává číselný formát pro ticky a generované popisky

Vzhled a popisky

THPDFChartTheme vybírá palety hctLight, hctDark nebo hctMonochrome

THPDFChartLegendPosition vybírá žádnou legendu, pravou legendu nebo spodní legendu přes hclNone, hclRight a hclBottom

Každá řada exponuje Name, Kind, Color, LineWidth, ShowMarkers, ShowLabels a opatřená popisky data THPDFChartPoint

Nastavte Color na reálné TColor pro explicitní barvu řady, nebo ponechte defaultní hodnotu, aby se použila aktivní paleta

Přístupnost

THPDFChart.BuildAccessibleText vrací explicitní AlternativeText, když existuje, nebo staví ohraničený souhrn titulu, řad, popisků, X a Y, s nezávislými limity bodů a bajtů

Předejte strukturního rodiče rozšířenému přetížení DrawChart, aby se kompletní graf zabalil do tagovaného Figure s položkou Alt a ohraničujícím rámem rozvržení

Strukturním rodičem by normálně měl být Document, Sect nebo layout element obsahující figure, vytvořený pro aktuální stránku

Rozpočty a statistiky

THPDFChartRenderOptions.Default připouští 64 řad, 100 000 bodů na řadu, 1 000 000 bodů celkem, 512 viditelných popisků, 64 bodů v generovaném přístupném textu a 8 192 bajtů přístupného textu

Neplatná geometrie, nekonečné souřadnice, smíšený obsah výsečí a překročené rozpočty řad nebo bodů vyvolají výjimku dřív, než začne kreslení

THPDFChartRenderStatistics hlásí vykreslené řady, body, popisky, segmenty cest, tagování figure a zkracování popisků

Validační i renderovací průchody jsou lineární v počtu řad a bodů, s ohraničenou prací popisků a přístupného textu

Podpůrné typy

Veřejný povrch tvoří THPDFChartKind, THPDFChartTheme, THPDFChartLegendPosition, THPDFChartPoint, THPDFChartSeries, THPDFChartAxis, THPDFChart, THPDFChartRenderOptions a THPDFChartRenderStatistics

Příklad

Chart := THPDFChart.Create;
try
  Chart.Title := 'Quarterly revenue';
  Chart.XAxis.Title := 'Quarter';
  Chart.YAxis.Title := 'Revenue';
  Chart.Theme := hctLight;

  SeriesItem := Chart.AddSeries(hckBar, 'North');
  SeriesItem.ShowLabels := True;
  SeriesItem.AddPoint(1, 120, 'Q1');
  SeriesItem.AddPoint(2, 175, 'Q2');
  SeriesItem.AddPoint(3, 164, 'Q3');

  Options := THPDFChartRenderOptions.Default;
  Document.CurrentPage.DrawChart(
    Chart, 48, 72, 500, 320, Options, Statistics
  );
finally
  Chart.Free;
end;

Viz také: THPDFPage.DrawChart, Přehled vektorové grafiky, Automatická struktura PDF/UA