BuildBiffPalettePlan metódus

Determinisztikus, csak olvasható tervet épít a közvetlen RGB-színek és a feloldott témaszínek 56 fizikai BIFF-palettahelyen való megjelenítéséhez

A metódus az IXLSWorkbook és a TXLSXWorkbook esetében egyaránt elérhető, és soha nem módosítja a palettabejegyzéseket, stílusokat, cellákat, egyéni színszámokat vagy a mentési viselkedést

Szintaxis

function BuildBiffPalettePlan: TXLSBiffPalettePlan;

Palettahely-terv

A Slots mindig 56 bejegyzést tartalmaz, a nyilvános indexek sorrendjében 1-től 56-ig és a fizikai helyek sorrendjében 8-tól 63-ig

Mező	Jelentés
`SourceARGB`	A palettahelyen jelenleg tárolt normalizált szín
`TargetARGB`	A helyre javasolt szín, alkalmazás nélkül
`DefinitionCount` és `ReferenceCount`	A `ScanIndexedColorUsage`-ból átvett indexelt fogyasztók
`Kinds`	A helyet védő indexelt fogyasztói kategóriák
`Locked`	True, ha a forráshelynek változatlanul kell maradnia
`Changed`	True, ha a javasolt cél eltér a forrásszíntől

Célleképezések

A Targets összegzi az egyforma színeket, és rögzíti a definíciók számát, a megjelenített hivatkozások számát, a fogyasztói kategóriákat, a hatásos frekvenciasúlyt, a kiválasztott nyilvános és fizikai indexeket, a leképezett ARGB értéket, a négyzetes OKLab hibát és a pontos egyezés állapotát

A megjelenített hivatkozások határozzák meg a hatásos súlyt, ha jelen vannak; egyébként a tárolt definíciók tartják meg a tervben a nem hivatkozott színeket

A tervezésben részt vesznek a betűtípusokból, kitöltésekből, gradiensből, keretekből, differenciális stílusokból, adatsávokból és színskálákból származó közvetlen és feloldott témaszínek, míg az indexelt, automatikus, érvénytelen és részben átlátszó színek nem válnak célokká

Tervezési viselkedés

A meglévő pontos palettaszínek a legalacsonyabb egyező helyükön maradnak, és az indexelt fogyasztók zárolják a forráshelyeiket, mielőtt bármely szabad hely szóba kerülne

Ha minden egyedi cél elfér, a szabad helyek determinisztikus ARGB sorrendben kapják a pontos színeket

Ha több szín van, mint szabad hely, egy rögzített iterációjú, frekvenciasúlyozott OKLab klaszterezési menet választja ki a maradék célszíneket, miközben a zárolt és megtartott pontos helyek rögzítve maradnak

A végső azonos távolságú leképezések a legalacsonyabb nyilvános palettaindexet használják

A terv identitása és statisztikái

A SourcePaletteGeneration és a SourcePaletteHash azonosítja azt a palettapillanatképet, amelyből a terv felépült

A LockedSlotCount, ChangedSlotCount, TotalTargetWeight, ExactTargetWeight, WeightedError, MaxDistanceSquared és Quantized összegzi az eredményt a vizsgálathoz és a szabályzati döntésekhez

Példa

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