Metoda BuildBiffPalettePlan

Sestaví deterministický plán jen pro čtení pro reprezentaci přímých barev RGB a rozpoznaných barev motivů v 56 fyzických slotech palety BIFF

Metoda je k dispozici na IXLSWorkbook i TXLSXWorkbook a nikdy nemění položky palety, styly, buňky, počty vlastních barev ani chování ukládání

Syntaxe

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Plán slotů

Slots vždy obsahuje 56 položek v pořadí veřejných indexů od 1 do 56 a v pořadí fyzických slotů od 8 do 63

Pole	Význam
`SourceARGB`	Normalizovaná barva aktuálně uložená v slotu palety
`TargetARGB`	Barva navržená pro slot, aniž by se aplikovala
`DefinitionCount` a `ReferenceCount`	Indexovaní konzumenté převzatí z `ScanIndexedColorUsage`
`Kinds`	Kategorie indexovaných konzumentů, které slot chrání
`Locked`	True, když zdrojový slot musí zůstat beze změny
`Changed`	True, když navržený cíl se liší od zdrojové barvy

Cílová mapování

Targets agreguje stejné barvy a zaznamenává počet definic, počet vykreslených odkazů, kategorie konzumentů, účinnou frekvenční váhu, vybrané veřejné a fyzické indexy, mapovanou hodnotu ARGB, kvadratickou chybu v OKLab a stav přesné shody

Pokud jsou přítomny vykreslené odkazy, určují účinnou váhu; jinak udržují uložené definice nepoužívané barvy v plánu zastoupené

Do plánování vstupují přímé a rozpoznané barvy motivů z písem, výplní, přechodů, ohraničení, diferenciálních stylů, datových lišt a barevných škál, zatímco indexované, automatické, neplatné a částečně průhledné barvy se cíli nestávají

Chování plánování

Stávající přesné barvy palety zůstávají na svém nejnižším odpovídajícím slotu a indexovaní konzumenté uzamknou své zdrojové sloty dříve, než se zváží jakýkoli volný slot

Když se každý jedinečný cíl vejde, volné sloty dostávají přesné barvy v deterministickém pořadí ARGB

Když je barev více než volných slotů, volí zbývající cílové barvy průchod shlukování v OKLab vážený frekvencí s pevným počtem iterací, přičemž uzamčené a zachované přesné sloty zůstávají pevné

Konečná mapování při stejné vzdálenosti používají nejnižší veřejný index palety

Identita plánu a statistiky

SourcePaletteGeneration a SourcePaletteHash identifikují snímek palety, z něhož byl plán sestaven

LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared a Quantized shrnují výsledek pro inspekci a rozhodování o politice

Pří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]);