BuildBiffPalettePlan-methode

Bouwt een deterministisch alleen-lezen plan op voor het weergeven van directe RGB-kleuren en opgeloste themakleuren in de 56 fysieke BIFF-paletslots

De methode is beschikbaar op zowel IXLSWorkbook als TXLSXWorkbook en wijzigt nooit paletinvoer, stijlen, cellen, aantallen aangepaste kleuren of opslaggedrag

Syntaxis

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Slotplan

Slots bevat altijd 56 invoeren in openbare indexvolgorde van 1 tot en met 56 en in fysieke slotvolgorde van 8 tot en met 63

Veld	Betekenis
`SourceARGB`	De genormaliseerde kleur die momenteel in het paletslot is opgeslagen
`TargetARGB`	De kleur die voor het slot wordt voorgesteld, zonder deze toe te passen
`DefinitionCount` en `ReferenceCount`	De geïndexeerde consumenten die uit `ScanIndexedColorUsage` zijn overgenomen
`Kinds`	De categorieën geïndexeerde consumenten die het slot beschermen
`Locked`	True wanneer het bronslot ongewijzigd moet blijven
`Changed`	True wanneer het voorgestelde doel afwijkt van de bronkleur

Doeltoewijzingen

Targets voegt gelijke kleuren samen en registreert definitieaantal, aantal gerenderde verwijzingen, categorieën van consumenten, effectief frequentiegewicht, gekozen openbare en fysieke indexen, toegewezen ARGB, gekwadrateerde OKLab-fout en exact-matchstatus

Gerenderde verwijzingen bepalen het effectieve gewicht wanneer ze aanwezig zijn; anders houden opgeslagen definities niet-gerefereerde kleuren in het plan vertegenwoordigd

Directe en opgeloste themakleuren uit lettertypen, vullingen, verlopen, randen, differentiële stijlen, gegevensbalken en kleurschalen nemen deel aan de planning, terwijl geïndexeerde, automatische, ongeldige en gedeeltelijk transparante kleuren geen doelen worden

Planningsgedrag

Bestaande exacte paletkleuren blijven op hun laagste overeenkomende slot, en geïndexeerde consumenten vergrendelen hun bronslots voordat een vrij slot wordt overwogen

Wanneer elk uniek doel past, krijgen vrije slots exacte kleuren in deterministische ARGB-volgorde

Wanneer er meer kleuren zijn dan vrije slots, kiest een frequentiegewogen OKLab-clusteringsronde met vast aantal iteraties de overige doelkleuren, terwijl vergrendelde en behouden exacte slots vast blijven

Definitieve toewijzingen bij gelijke afstand gebruiken de laagste openbare paletindex

Planidentiteit en statistieken

SourcePaletteGeneration en SourcePaletteHash identificeren de paletmomentopname waaruit het plan is opgebouwd

LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared en Quantized vatten het resultaat samen voor inspectie en beleidsbeslissingen

Voorbeeld

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]);