實作 IWICDevelopRaw
IWICDevelopRaw
IWICDevelopRaw介面會公開原始影像處理特有的處理選項。 所有原始編解碼器都必須支援 IWICDevelopRaw 介面。 某些原始編解碼器可能無法支援此介面公開的每個設定，但您應該支援編解碼器能夠執行的所有設定。 每個原始編解碼器至少都必須實作 SetRotation 和 SetRenderMode 方法。
此外，對於其他編解碼器而言是選擇性的方法和介面，強烈建議用於原始編解碼器。 其中包括容器層級解碼器類別上的 GetPreview 和 GetThumbnail 方法，以及框架層級解碼類別上的 IWICBitmapSourceTransform 介面。
使用 IWICDevelopRaw 方法所設定的設定，應該以與其他中繼資料保存方式一致的方式保存編解碼器，但您不應該覆寫原始的「快照」設定。 藉由保存中繼資料並實作 LoadParameterSet 和 GetCurrentParameterSet，您可以啟用原始處理應用程式，以跨會話擷取和套用處理設定。
IWICDevelopRaw介面的主要用途是讓應用程式開發人員建置使用者介面，以調整原始參數，以便盡可能在不同編解碼器之間以一致的方式運作。 假設終端使用者會使用滑杆控制項來調整參數，其最小值和最大值會對應至參數的最小值和最大值。 若要支援這項作業，您應該努力將所有參數範圍視為線性。 若要確保滑杆控制項不過度敏感，您也應該盡可能支援每個參數的範圍，涵蓋最多 50% 的可能範圍。 例如，如果最大可能的對比範圍是從純灰色到純黑色和白色，且預設值對應至 0.0，則編解碼器所支援的最低範圍至少介於預設值與低端灰色 (–1.0) 之間，至少介於預設值與純黑色與白色之間的一半 (+1.0) 。
interface IWICDevelopRaw : IWICBitmapFrameDecode
{
HRESULT QueryRawCapabilitiesInfo ( WICRawCapabilitiesInfo *pInfo );
HRESULT LoadParameterSet ( WICRawParameterSet ParameterSet );
HRESULT GetCurrentParameterSet ( IPropertyBag2 **ppCurrentParameterSet );
HRESULT SetExposureCompensation ( double ev );
HRESULT GetExposureCompensation ( double *pEV );
HRESULT SetWhitePointRGB ( UINT Red, UINT Green, UINT Blue );
HRESULT GetWhitePointRGB ( UINT *pRed, UINT *pGreen, UINT *pBlue );
HRESULT SetNamedWhitePoint ( WICNamedWhitePoint WhitePoint );
HRESULT GetNamedWhitePoint ( WICNamedWhitePoint *pWhitePoint );
HRESULT SetWhitePointKelvin ( UINT WhitePointKelvin );
HRESULT GetWhitePointKelvin ( UINT *pWhitePointKelvin );
HRESULT GetKelvinRangeInfo ( UINT *pMinKelvinTemp,
UINT *pMaxKelvinTemp,
UINT *pKelvinTempStepValue );
HRESULT SetContrast ( double Contrast );
HRESULT GetContrast ( double *pContrast );
HRESULT SetGamma ( double Gamma );
HRESULT GetGamma ( double *pGamma );
HRESULT SetSharpness ( double Sharpness );
HRESULT GetSharpness ( double *pSharpness );
HRESULT SetSaturation ( double Saturation );
HRESULT GetSaturation ( double *pSaturation );
HRESULT SetTint ( double Tint );
HRESULT GetTint ( double *pTint );
HRESULT SetNoiseReduction ( double NoiseReduction );
HRESULT GetNoiseReduction ( double *pNoiseReduction );
HRESULT SetDestinationColorContext (const IWICColorContext *pColorContext );
HRESULT SetToneCurve ( UINT cbToneCurveSize,
const WICRawToneCurve *pToneCurve );
HRESULT GetToneCurve ( UINT cbToneCurveBufferSize,
WICRawToneCurve *pToneCurve,
UINT *pcbActualToneCurveBufferSize );
HRESULT SetRotation ( double Rotation );
HRESULT GetRotation ( double *pRotation );
HRESULT SetRenderMode ( WICRawRenderMode RenderMode );
HRESULT GetRenderMode ( WICRawRenderMode *pRenderMode );
HRESULT SetNotificationCallback ( IWICDevelopRawNotificationCallback
*pCallback );
}
- QueryRawCapabilitiesInfo
- LoadParameterSet
- GetCurrentParameterSet
- Set/GetExposureCompensation
- Set/GetCurrentParameterRGB、Set/GetNamedWhitePoint、Set/GetwhitePointKelvin
- Set/GetContrast
- Set/GetGamma
- Set/GetSharpness
- Set/GetSaturation
- Set/GetTint
- Set/GetNoiseReduction
- SetDestinationColorCoNtext
- Set/GetToneCurve
- Set/GetRotation
- Set/GetRenderMode
- SetNotificationCallback
QueryRawCapabilitiesInfo
QueryRawCapabilitiesInfo 會傳回此原始檔案支援的一組功能。 WICRawCapabilitiesInfo結構的定義如下：
struct WICRawCapabilitiesInfo
{
UINT cbSize;
UINT CodecMajorVersion;
UINT CodecMinorVersion;
WICRawCapabilities ExposureCompensationSupport;
WICRawCapabilities ContrastSupport;
WICRawCapabilities RGBWhitePointSupport;
WICRawCapabilities NamedWhitePointSupport;
UINT NamedWhitePointSupportMask;
WICRawCapabilities KelvinWhitePointSupport;
WICRawCapabilities GammaSupport;
WICRawCapabilities TintSupport;
WICRawCapabilities SaturationSupport;
WICRawCapabilities SharpnessSupport;
WICRawCapabilities NoiseReductionSupport;
WICRawCapabilities DestinationColorProfileSupport;
WICRawCapabilities ToneCurveSupport;
WICRawRotationCapabilities RotationSupport;
}
此結構中使用的 WICRawCapabilities 列舉定義為：
enum WICRawCapabilities
{
WICRawCapabilityNotSupported,
WICRawCapabilityGetSupported,
WICRawCapabilityFullySupported
}
最後一個欄位是 WICRawRotationCapabilities 列舉，定義為：
enum WICRawRotationCapabilities
{
WICRawRotationCapabilityNotSupported,
WICRawRotationCapabilityGetSupported,
WICRawRotationCapabilityNinetyDegreesSupported
WICRawRotationCapabilityFullySupported
}
LoadParameterSet
LoadParameterSet 可讓使用者指定是否要使用 As Shot 設定、使用使用者調整的設定，或要求解碼器自動校正影像。
enum WICRawParameterSet
{
WICAsShotParameterSet,
WICUserAdjustedParameterSet,
WICAutoAdjustedParameterSet
}
GetCurrentParameterSet
GetCurrentParameterSet 會傳回具有目前參數集的 IPropertyBag2 。 接著，呼叫端可以將此參數設定為編碼器，以作為編碼器選項使用。
Set/GetExposureCompensation
GetExposureCompensation 和 SetExposureCompensation 表示要套用至最終輸出的曝光補償。 EV 的有效範圍是 –5.0 到 +5.0 停止。
Set/GetCurrentParameterRGB、Set/GetNamedWhitePoint、Set/GetwhitePointKelvin
這些函式全都提供取得和設定白點的方法，可以是 RGB 值、預設具名值，或做為 Kelvin 值。 Kelvin 可接受的範圍是 1，500 – 30，000。
Set/GetContrast
GetContrast 和 SetContrast 表示要套用至輸出的對比量。 指定對比的有效範圍是 –1.0 到 +1.0，預設對比為 0.0。
Set/GetGamma
GetGamma 和 SetGamma 表示要套用的 Gamma。 Gamma 的有效範圍是 0.2 到 5.0，預設值為 1.0。 Gamma 通常會使用傳統的 Gamma 電源函數來實作， (具有 unity 取得) 的線性電源函式。 亮度隨著增加 Gamma 而增加，並隨著 Gamma 接近零而減少。 (請注意，最小值為非零，因為零會導致傳統 Gamma 計算中的除以零誤差。邏輯最小限制為 1/max，這就是為什麼最小值為 0.2.)
Set/GetSharpness
GetSharpness 和 SetSharpness 表示要套用的尖角量。 有效範圍是 –1.0 到 +1.0，0.0 是預設的尖角，而 –1.0 表示完全沒有尖角。
Set/GetSaturation
GetSaturation 和 SetSaturation 表示要套用的飽和度量。 指定飽和度的有效範圍是 –1.0 到 +1.0，0.0 為正常飽和度，–1.0 代表完整還原，而 +1.0 代表完整飽和度。
Set/GetTint
GetTint 和 SetTint 表示要套用的色調，位於綠色/紅色偏差上。 有效範圍是 –1.0 到 +1.0，綠色位於正數尺規的負端和放大鏡。 色調刻度定義為色彩溫度的正交。
Set/GetNoiseReduction
GetNoiseReduction 和 SetNoiseReduction 表示要套用的雜訊減少量。 的有效範圍是 –1.0 到 +1.0，0.0 表示降低雜訊的預設量，–1.0 表示無雜訊降低，而 +1.0 表示最大雜訊降低。
SetDestinationColorCoNtext
SetDestinationColorCoNtext 指定要套用至影像的色彩設定檔。 您可以呼叫 GetColorCoNtexts 來擷取目前的色彩設定檔。
Set/GetToneCurve
GetToneCurve 和 SetToneCurve 指定要套用的音調曲線。 假設點之間的線性插補。 pToneCurve是WICRawToneCurve結構，其中包含WICRawToneCurvePoint結構的陣列，以及陣列中點數的計數。
struct WICRawToneCurve
{
UINT cPoints;
WICRawToneCurvePoint aPoints[];
}
WICRawToneCurvePoint包含輸入值和輸出值。
struct WICRawToneCurvePoint
{
double Input;
double Output;
}
當呼叫端在pToneCurve參數中傳遞Null時，您應該將WICRawToneCurve的必要大小傳回于azureActualToneCurveBufferSize參數中。
Set/GetRotation
GetRotation 和 SetRotation 表示要套用的旋轉程度。 旋轉 90.0 會指定順時針旋轉 90 度。 (使用 SetRotation 和使用 CopyPixels 方法設定旋轉之間的差異在於，使用 SetRotation 設定的旋轉角度應該由編解碼器保存，而透過 CopyPixels 設定旋轉只會在記憶體中旋轉影像。
Set/GetRenderMode
GetRenderMode 和 SetRenderMode 表示呼叫端所需的輸出品質等級。 當使用者調整參數時，如果套用變更，應用程式應該會顯示實際影像外觀非常快速的近似值。 為了達到此目的，影像通常會以螢幕解析度或更少顯示，而不是實際影像解析度，以提供立即的意見反應給使用者。 這是應用程式要求草稿模式品質的時機，因此這應該非常快速。 當使用者進行所有變更時，以草稿模式預覽這些變更，並決定使用目前的設定來解碼完整影像，應用程式會要求 Best Quality 解碼。 這通常也會要求列印。 當需要品質的速度之間合理的取捨時，應用程式會要求一般品質。
enum WICRawRenderMode
{
WICRawRenderModeDraftMode,
WICRawRenderModeNormalQuality ,
WICRawRenderModeBestQuality
}
SetNotificationCallback
SetNotificationCallback 會在任何原始處理參數變更時，為解碼器註冊要呼叫的回呼函式。 IWICDevelopRawNotificationCallback的簽章只有一個稱為Notify的方法。 Notify 具有單一參數，這是一個遮罩，指出哪些原始處理參數已變更。
HRESULT Notify ( UINT NotificationMask );
OR 作業會在下列 NotificationMask 值上執行。
WICRawChangeNotification_ExposureCompensation
WICRawChangeNotification_NamedWhitePoint
WICRawChangeNotification_KelvinWhitePoint
WICRawChangeNotification_RGBWhitePoint
WICRawChangeNotification_Contrast
WICRawChangeNotification_Gamma
WICRawChangeNotification_Sharpness
WICRawChangeNotification_Saturation
WICRawChangeNotification_Tint
WICRawChangeNotification_NoiseReduction
WICRawChangeNotification_DestinationColorContext
WICRawChangeNotification_ToneCurve
WICRawChangeNotification_Rotation
WICRawChangeNotification_RenderMode
相關主題
-
參考
-
概念
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應