Metóda BuildBiffPalettePlan

Zostaví deterministický plán len na čítanie pre reprezentáciu priamych farieb RGB a rozpoznaných farieb motívov v 56 fyzických slotoch palety BIFF

Metóda je k dispozícii na IXLSWorkbook aj TXLSXWorkbook a nikdy nemení položky palety, štýly, bunky, počty vlastných farieb ani správanie ukladania

Syntax

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Plán slotov

Slots vždy obsahuje 56 položiek v poradí verejných indexov od 1 do 56 a v poradí fyzických slotov od 8 do 63

Pole	Význam
`SourceARGB`	Normalizovaná farba aktuálne uložená v slote palety
`TargetARGB`	Farba navrhnutá pre slot bez jej aplikovania
`DefinitionCount` a `ReferenceCount`	Indexovaní konzumenti prevzatí z `ScanIndexedColorUsage`
`Kinds`	Kategórie indexovaných konzumentov, ktoré slot chránia
`Locked`	True, keď zdrojový slot musí ostať nezmenený
`Changed`	True, keď navrhnutý cieľ sa odlišuje od zdrojovej farby

Cieľové mapovania

Targets agreguje rovnaké farby a zaznamenáva počet definícií, počet vykreslených odkazov, kategórie konzumentov, účinnú frekvenčnú váhu, vybrané verejné a fyzické indexy, mapovanú hodnotu ARGB, kvadratickú chybu v OKLab a stav presnej zhody

Ak sú prítomné vykreslené odkazy, určujú účinnú váhu; inak udržiavajú uložené definície nepoužívané farby v pláne zastúpené

Do plánovania vstupujú priame a rozpoznané farby motívov z písiem, výplní, gradientov, ohraničení, diferenčných štýlov, dátových líšt a farebných škál, zatiaľ čo indexované, automatické, neplatné a čiastočne priehľadné farby sa cieľmi nestávajú

Správanie plánovania

Existujúce presné farby palety ostanú na svojom najnižšom zodpovedajúcom slote a indexovaní konzumenti uzamknú svoje zdrojové sloty skôr, než sa zváži akýkoľvek voľný slot

Keď sa každý jedinečný cieľ zmestí, voľné sloty dostávajú presné farby v deterministickom poradí ARGB

Keď je farieb viac ako voľných slotov, vyberá zostávajúce cieľové farby priebeh zhlukovania v OKLab vážený frekvenciou s pevným počtom iterácií, pričom uzamknuté a zachované presné sloty ostanú pevné

Konečné mapovania pri rovnakej vzdialenosti používajú najnižší verejný index palety

Identita plánu a štatistiky

SourcePaletteGeneration a SourcePaletteHash identifikujú snímku palety, z ktorej bol plán zostavený

LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared a Quantized zhrňujú výsledok na inšpekciu a rozhodovanie o politike

Príklad

Plan := Workbook.BuildBiffPalettePlan;
if Plan.Quantized then
  LogPaletteError(Plan.WeightedError);

for I := 0 to High(Plan.Slots) do
  if Plan.Slots[I].Changed then
    PreviewPaletteChange(Plan.Slots[I]);