HotXLS-dokumentasjon

BuildBiffPalettePlan metode

Bygger en deterministisk skrivebeskyttet plan for å representere direkte RGB-farger og løste temafarger i de 56 fysiske BIFF-palettslotter

Metoden er tilgjengelig på både IXLSWorkbook og TXLSXWorkbook og endrer aldri palettoppføringer, stiler, celler, tellinger av egendefinerte farger eller lagringsatferd

Syntaks

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Slotplan

Slots inneholder alltid 56 oppføringer i offentlig indeksrekkefølge fra 1 til 56 og i fysisk slot-rekkefølge fra 8 til 63

FeltBetydning
SourceARGBDen normaliserte fargen som for øyeblikket er lagret i palettslotten
TargetARGBFargen som foreslås for slotten, uten å ta den i bruk
DefinitionCount og ReferenceCountDe indekserte forbrukerne som arves fra ScanIndexedColorUsage
KindsDe indekserte forbrukerkategoriene som beskytter slotten
LockedSann når kildeslotten må forbli uendret
ChangedSann når foreslått mål avviker fra kildefargen

Måltilordninger

Targets samler like farger og registrerer definisjonstelling, antall gjengitte referanser, forbrukerkategorier, effektiv frekvensvekt, valgte offentlige og fysiske indekser, tilordnet ARGB, kvadrert OKLab-feil og status for eksakt samsvar

Gjengitte referanser bestemmer den effektive vekten når de finnes; ellers holder lagrede definisjoner urefererte farger representert i planen

Direkte og løste temafarger fra skrifter, fyllinger, gradienter, kantlinjer, differensielle stiler, databarer og fargeskalaer deltar i planleggingen, mens indekserte, automatiske, ugyldige og delvis gjennomsiktige farger ikke blir mål

Planleggingsatferd

Eksakte palettfarger som finnes fra før, beholdes på sin laveste samsvarende slot, og indekserte forbrukere låser sine kildeslots før noen ledig slot vurderes

Når hvert unikt mål får plass, får ledige slotter eksakte farger i deterministisk ARGB-rekkefølge

Når det finnes flere farger enn ledige slotter, velger et frekvensvektet OKLab-klyngingstrekk med fast antall iterasjoner de gjenværende målfargene, mens låste og beholdte eksakte slotter forblir faste

Endelige tilordninger med lik avstand bruker den laveste offentlige palettindeksen

Planidentitet og statistikk

SourcePaletteGeneration og SourcePaletteHash identifiserer palettøyeblikksbildet som planen ble bygget ut fra

LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared og Quantized oppsummerer resultatet for inspeksjon og valg av retningslinjer

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

Se også