Dokumentacija HotXLS

Paleta barv po meri

Pregled

Delovni zvezki Excela upravljajo z oblikovanjem barv z dvema modeloma: starejša indeksirana paleta 56 barv v BIFF8 (klasični XLS) ter poljubne vezi RGB ali mesta teme v OpenXML (XLSX); HotXLS zagotavlja API-je za prilagajanje indeksov preslikave palete in za gladko premoščanje razlik med tema formatoma

Indeksiranje barv palete

Format BIFF8 preslika barve oblikovanja v indeksne vnose od 8 do 63; za razveljavitev privzetih definicij barv uporabite vmesnik barv delovnega zvezka

procedure SetColor(const AIndex: Integer; const AColor: TColor);

Če vrednost RGB po meri dodelite neposredno celici brez posodobitve indeksa palete, jo bo HotXLS samodejno preslikal na najbližjo barvo v aktivni paleti delovnega zvezka

Deterministic Indexed-Color Resolution

IXLSWorkbook and TXLSXWorkbook expose matching ResolveIndexedColor preobremenitvi za interpretacijo indeksa brez spreminjanja delovnega zvezka

Klicatelj identificira izvorni indeksni prostor kot javni ColorIndex, BIFF icv, or OOXML indexed; rezultat ločuje žetone palete, samodejne, sistemske in neveljavne ter normalizirano vrednost ARGB poroča šele, ko je na voljo konkretna barva

Sistemski in samodejni žetoni nikoli ne preberejo trenutnega namizja po implicitni poti; ko je potreben izhod RGB, specifičen za okolje, podajte izrecen razreševalnik sistemskih barv

Vloga uporabe ohranja pomen, specifičen za obliko, na primer to, da je mejni indeks BIFF 0 nedoločen in ne črn

Use NearestIndexedColor za preslikavo vrednosti RGB na najbližji fizični vnos palete; deljeni predpomnjeni ujemovalnik OKLab vrne javni in fizični indeks brez spreminjanja delovnega zvezka

Use ScanIndexedColorUsage da pridobite deterministični inventar s 56 režami, preden načrtujete spremembe palete; definicije in sklici iz stilov, objektov delovnega lista, grafikonov, pripomb in pogojnih oblik označijo prizadete reže kot zaklenjene

Mutation-Free Palette Planning

Use BuildBiffPalettePlan da si ogledate, kako se lahko neposredni RGB in razrešene barve tem umestijo v 56 fizičnih rež palete BIFF, brez spreminjanja delovnega zvezka

Načrt ohrani vsako indeksirano režo, prijavljeno kot zaklenjeno, obdrži obstoječe točne barve na najnižji ujemajoči reži, dodeli točne barve, dokler je še zmogljivost, in uporabi deterministično grozdenje OKLab, uteženo s frekvenco, šele ko edinstveni cilji presežejo proste reže

Vsak cilj poroča svoj izbrani javni in fizični indeks, preslikano vrednost ARGB, frekvenčno težo, kvadrirano percepcijsko razdaljo in stanje točnega ujemanja; polja povzetka poročajo točno težo, uteženo napako, največjo napako, spremenjene reže in to, ali je bila kvantizacija potrebna

Generacija in zgoščena vrednost izvorne palete omogočata ApplyBiffPalettePlan zavrniti zastarel ali manipuliran načrt, preden se katera koli reža spremeni; uspešna uporaba enkrat znova zgradi predpomnjeni ujemovalnik, veljaven načrt brez delovanja pa generacijo pusti nespremenjeno

Classic workbooks also expose BiffPaletteSavePolicy; privzeta vrednost ohrani zgodovinsko paleto, izrecna vrednost optimizacije pa zgradi in uporabi trenutni načrt le za izhod BIFF8 in obnovi izvirno paleto, če shranjevanje spodleti ali se prekliče

Bogata preslikava barv RGB

Delovni zvezki XLSX obidejo omejitve palete in omogočajo neposredno dodeljevanje 24-bitnih vrednosti RGB; oglejte si API-je za pretvorbo barv spodaj