Kleurbeheereffect
Gebruik het kleurbeheereffect om een afbeelding van het ene ICC-kleurenprofiel (International Color Consortium) naar het andere te transformeren. Het effect transformeert de afbeelding volgens de ICC-specificatie.
De CLSID voor dit effect is CLSID_D2D1ColorManagement.
- eigenschappen van effect
- Rendering-intentiemodi
- alfamodi voor invoerafbeeldingen
- naleving van de ICC-specificatie
- Alfa-kanaalgedrag
- kwaliteitsmodi
- voorbeeldcode
- vereisten
- Verwante onderwerpen
Effecteigenschappen
| Weergavenaam en indexenumeratie | Beschrijving |
|---|---|
| SourceContext D2D1_COLORMANAGEMENT_PROP_SOURCE_COLOR_CONTEXT |
De informatie over de bronkleurruimte. Het type is ID2D1ColorContext. De standaardwaarde is NULL. |
| SourceIntent D2D1_COLORMANAGEMENT_PROP_SOURCE_RENDERING_INTENT |
Welke ICC-renderingintentie moet worden gebruikt. Het type is D2D1_COLORMANAGEMENT_RENDERING_INTENT. De standaardwaarde is D2D1_COLORMANAGEMENT_RENDERING_INTENT_PERCEPTUAL. |
| DestinationContext D2D1_COLORMANAGEMENT_PROP_DESTINATION_COLOR_CONTEXT |
De informatie over de doelkleurruimte. Het type is ID2D1ColorContext. De standaardwaarde is NULL. |
| DestinationIntent D2D1_COLORMANAGEMENT_PROP_DESTINATION_RENDERING_INTENT |
Welke ICC-renderingintentie moet worden gebruikt. Het type is D2D1_COLORMANAGEMENT_RENDERING_INTENT. De standaardwaarde is D2D1_COLORMANAGEMENT_RENDERING_INTENT_PERCEPTUAL. |
| AlphaMode D2D1_COLORMANAGEMENT_PROP_ALPHA_MODE |
Alfagegevens interpreteren die zijn opgenomen in de invoerafbeelding. Het type is D2D1_COLORMANAGEMENT_ALPHA_MODE. De standaardwaarde is D2D1_COLORMANAGEMENT_ALPHA_MODE_PREMULTIPLIED. |
| Kwaliteit D2D1_COLORMANAGEMENT_PROP_QUALITY |
Het kwaliteitsniveau van de transformatie. Het type is D2D1_COLORMANAGEMENT_QUALITY. De standaardwaarde is D2D1_COLORMANAGEMENT_QUALITY_NORMAL. |
Intentiemodi weergeven
| Opsomming | Beschrijving |
|---|---|
| D2D1_COLORMANAGEMENT_RENDERING_INTENT_PERCEPTUAL | Het effect comprimeert of breidt het volledige kleurenbereik van de afbeelding uit om het kleurenbereik van het apparaat te vullen, om een perceptually aantrekkelijke uitvoer te produceren die kleurdetails behoudt, maar kleurnauwkeurigheid kan opofferen. Het is handig voor algemene reproductie van echte inhoud zoals foto's. |
| D2D1_COLORMANAGEMENT_RENDERING_INTENT_RELATIVE_COLORIMETRIC | Het effect past alle kleuren aan die buiten het gamut vallen dat het uitvoerapparaat kan weergeven naar de dichtstbijzijnde kleur die kan worden weergegeven. Het witte punt blijft niet behouden. |
| D2D1_COLORMANAGEMENT_RENDERING_INTENT_SATURATION | Het effect behoudt de verzadiging van pure kleuren in de afbeelding ten koste van tint en lichtheid. Het is handig voor afbeeldingen zoals grafieken en diagrammen. |
| D2D1_COLORMANAGEMENT_RENDERING_INTENT_ABSOLUTE_COLORIMETRIC | Het effect past alle kleuren aan die buiten het gamut vallen dat het uitvoerapparaat kan weergeven naar de dichtstbijzijnde kleur die kan worden weergegeven. Het effect wijzigt de kleuren in het gamut niet en behoudt het witte punt. |
Alfamodi voor invoerafbeelding
| Opsomming | Beschrijving |
|---|---|
| D2D1_COLORMANAGEMENT_ALPHA_MODE_PREMULTIPLIED | Bij het effect wordt ervan uitgegaan dat de alfamodus vooraf is voorbereid. |
| D2D1_COLORMANAGEMENT_ALPHA_MODE_STRAIGHT | Bij het effect wordt ervan uitgegaan dat de alfamodus recht is. |
D2D1_GAMMA1_G2084 gedrag verandert
Als uw toepassing gebruikmaakt van de D2D1_GAMMA1_G2084 ruimte of een van de DXGI_COLOR_SPACE_TYPE opsommingswaarden die gebruikmaken van de SMPTE ST.2084-kleurruimte (Perceptual Quantizer), is de toepassing van plan om te werken met HDR-gegevens.
De ID2D1DeviceContext5::CreateColorContextFromSimpleColorProfile en ID2D1DeviceContext5::CreateColorContextFromDxgiColorSpace-API's zijn hiervoor niet van toepassing; In plaats daarvan wordt de HDR-inhoud geschaald om in het bereik van 0-1 te passen tijdens de G2084 DeGamma-bewerking.
In de praktijk gebruikt inhoud die in deze gammaruimte is gecodeerd een verwijzing WhiteLevel van 10.000 Nits, die normaal gesproken in CCCS wordt weergegeven als 10.000 / 80 = 125,0. Om uw app beter te vergemakkelijken, is het eenvoudigst voor deze gammaconversie om ook de helderheid met een factor 125 te schalen. Vanaf Windows 10 versie 1809 (10.0; Build 17763), het gedrag van het kleurbeheereffect is zodanig dat deze schaalaanpassing wordt toegepast. Dat betekent dat u, als ontwikkelaar, geen tweede aanpassingseffect op witniveau hoeft toe te passen in de pijplijn.
Naleving van ICC-specificatie
Het kleurbeheereffect voldoet aan de ICC v4.3-specificatie, met deze beperkingen:
- Het effect ondersteunt de kleurruimten 1, 3 en 4 kanalen.
- Het effect biedt geen ondersteuning voor ColorSpace- of Named Color-profielen.
Alfakanaalgedrag
Over het algemeen stelt het effect alfa in op 1 (ondoorzichtig) als er geen alfagegevens in de bronafbeelding staan en de alfagegevens worden verwijderd als er geen ruimte in de doelafbeelding is. In de tabel hier wordt het alfagedrag beschreven.
| Bronkleurruimte, pixelindeling | Doelkleurruimte, pixelindeling | Alfagedrag |
|---|---|---|
| 1 kanaal, R pixelformaat |
1 kanaal, R pixelformaat | (Geen alfagegevens) |
| 1 kanaal, RGBA pixelformaat | Alfagegevens zijn ingesteld op 1 (ondoorzichtig) | |
| 3-kanaals, RGBA-pixelindeling | Alfagegevens zijn ingesteld op 1 (ondoorzichtig) | |
| 4-kanaals, RGBA-pixelformaat | (Geen alfagegevens) | |
| 1 kanaal, RGBA pixelformaat |
1 kanaal, R pixelformaat | Alfagegevens worden verwijderd |
| 1 kanaal, RGBA pixelformaat | Alfagegevens worden doorgegeven | |
| 3-kanaals, RGBA-pixelindeling | Alfagegevens worden doorgegeven | |
| 4-kanaals, RGBA-pixelformaat | Alfagegevens worden verwijderd | |
| 3-kanaals, RGBA-pixelindeling |
1 kanaal, R pixelformaat | Alfagegevens worden verwijderd |
| 1 kanaal, RGBA pixelformaat | Alfagegevens worden doorgegeven | |
| 3-kanaals, RGBA-pixelindeling | Alfagegevens worden doorgegeven | |
| 4-kanaals, RGBA-pixelformaat | Alfagegevens worden verwijderd | |
| 4-kanaals, RGBA-pixelformaat |
1 kanaal, R pixelformaat | (Geen alfagegevens) |
| 1 kanaal, RGBA pixelformaat | Alfagegevens zijn ingesteld op 1 (ondoorzichtig) | |
| 3-kanaals, RGBA-pixelindeling | Alfagegevens zijn ingesteld op 1 (ondoorzichtig) | |
| 4-kanaals, RGBA-pixelformaat | (Geen alfagegevens) |
Kwaliteitsmodi
| Wijze | Beschrijving |
|---|---|
| D2D1_COLORMANAGEMENT_QUALITY_PROOF | De laagste kwaliteitsmodus. Voor deze modus is functieniveau 9_1 of hoger vereist. |
| D2D1_COLORMANAGEMENT_QUALITY_NORMAL | Normale kwaliteitsmodus. Voor deze modus is functieniveau 9_1 of hoger vereist. |
| D2D1_COLORMANAGEMENT_QUALITY_BEST | De beste kwaliteitsmodus. Deze modus vereist functieniveau 10_0 of hoger, evenals drijvendekommaprecisiebuffers. Deze modus ondersteunt drijvendekommaprecisie en uitgebreid bereik zoals gedefinieerd in de ICC v4.3-specificatie. |
Het kleurbeheereffect mislukt bij het tekenen als de toepassing een kwaliteitsmodus aanvraagt die niet wordt ondersteund door de hardware. U kunt het functieniveau bepalen wanneer u D3D11CreateDeviceaanroept. U kunt controleren op ondersteuning voor drijvende-kommabuffer door ID2D1EffectContext::IsBufferPrecisionSupported aan te roepen met de waarde D2D1_BUFFER_PRECISION_32BPC_FLOAT.
Voorbeeldcode
Voor een voorbeeld van dit effect downloadt u het Voorbeeld van fotoaanpassing van Direct2D-effectenen raadpleegt u Les 4 van het voorbeeld.
Eisen
| Eis | Waarde |
|---|---|
| Minimaal ondersteunde client | Windows 8 en Platform Update voor Windows 7 [desktop-apps | Windows Store-apps] |
| Minimaal ondersteunde server | Windows 8 en Platform Update voor Windows 7 [desktop-apps | Windows Store-apps] |
| Rubriek | d2d1effects.h |
| Bibliotheek | d2d1.lib, dxguid.lib |