BuildBiffPalettePlan metode

Opbygger en deterministisk, skrivebeskyttet plan for, hvordan direkte RGB- og opløste temafarver repræsenteres i de 56 fysiske BIFF-paletslots

Metoden er tilgængelig på både IXLSWorkbook og TXLSXWorkbook og ændrer aldrig paletindgange, typografier, celler, antal brugerdefinerede farver eller gemningsfunktionsmåde

Syntaks

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Slot-plan

Slots indeholder altid 56 poster i offentlig indeksrækkefølge fra 1 til og med 56 og fysisk slotrækkefølge fra 8 til og med 63

Felt	Betydning
`SourceARGB`	Den normaliserede farve, der i øjeblikket er gemt i paletslottet
`TargetARGB`	Den farve, der foreslås til slottet, uden at den anvendes
`DefinitionCount` og `ReferenceCount`	De indekserede forbrugere, der er arvet fra `ScanIndexedColorUsage`
`Kinds`	De indekserede forbrugerkategorier, der beskytter slottet
`Locked`	True, når kildeslottet skal forblive uændret
`Changed`	True, når det foreslåede mål adskiller sig fra kildefarven

Målafbildninger

Targets samler ens farver og registrerer antal definitioner, antal renderede referencer, forbrugertyper, effektiv frekvensvægt, valgte offentlige og fysiske indeks, afbildet ARGB, kvadreret OKLab-fejl og status for eksakt match

Renderede referencer bestemmer den effektive vægt, når de findes; ellers holder gemte definitioner urefererede farver repræsenteret i planen

Direkte og opløste temafarver fra skrifttyper, fyld, gradienter, kanter, differentielle typografier, databjælker og farveskalaer indgår i planlægningen, mens indekserede, automatiske, ugyldige og delvist gennemsigtige farver ikke bliver mål

Planlægningsfunktionsmåde

Eksisterende eksakte paletfarver bevares på deres laveste matchende slot, og indekserede forbrugere låser deres kilde-slots, før nogen ledig slot overvejes

Når alle unikke mål kan rummes, får ledige slots eksakte farver i deterministisk ARGB-rækkefølge

Når der er flere farver end ledige slots, vælger en OKLab-klyngedannelse vægtet efter frekvens og med fast antal iterationer de resterende målfarver, mens låste og bevarede eksakte slots forbliver faste

Endelige lige-afstands-afbildninger bruger det laveste offentlige paletindeks

Planidentitet og statistik

SourcePaletteGeneration og SourcePaletteHash identificerer paletsnapshotet, som planen blev bygget fra

LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared og Quantized opsummerer resultatet til inspektion og politikbeslutninger

Eksempel

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