Gainmap クラス

リファレンス

定義

名前空間:: Android.Graphics

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。

[Android.Runtime.Register("android/graphics/Gainmap", ApiSince=34, DoNotGenerateAcw=true)]
public sealed class Gainmap : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/graphics/Gainmap", ApiSince=34, DoNotGenerateAcw=true)>]
type Gainmap = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承: Object

Object
Gainmap

属性: RegisterAttribute

実装: IParcelable IJavaObject IJavaPeerable IDisposable

注釈

ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。これは、ゲインマップを適用する方法を説明する一連のメタデータと、ゲインマップデータ自体を表す 1 ( android.graphics.Bitmap.Config#ALPHA_8 アルファチャネルを無視した場合など android.graphics.Bitmap.Config#ARGB_8888 ) または 3 チャネル Bitmap の組み合わせです。

アクティビティにレンダリングすると、十分な android.content.pm.ActivityInfo#COLOR_MODE_HDR HDR ヘッドルームが使用可能になると、ハードウェアアクセラレータ Canvas によってゲインマップが自動的に適用されます。

<h3>ゲインマップ構造</h3>

ゲインマップのイメージの論理全体は、2 つ目の拡張イメージを含むゲインマップに加えて、ゲインマップのサポートなしで表示される元のイメージを表す基本ビットマップで構成されます。 JPEG の場合、基本イメージは、形式が一般的に関連付けられている一般的な 8 ビット SDR イメージになります。ゲインマップイメージは、基本イメージと共に埋め込まれます。多くの場合、低解像度 (1/4 など) と、ゲインマップを適用する方法を説明するメタデータが含まれます。次に、ゲインマップイメージ自体は、基本イメージに適用して HDR 表示を再構築する変換を表すグレースケールイメージです。

したがって、これらの「ゲインマップイメージ」は3つの部分で構成されています - このクラスのインスタンスを返すベースBitmapBitmap#getGainmap()で、h3>を介して#getGainmapContents()<アクセス可能な別のビットマップとして表される拡張レイヤーを含み、手動でゲインマップ<を適用する/h3>

OpenGL ES や Vulkan コンテキストなどのカスタムレンダリングを実行する場合、ゲインマップは自動的には適用されません。このような状況では、次の手順は、基本イメージと組み合わせてゲインマップをレンダリングするのに適しています。

ディスプレイに H の HDR 対 SDR 比があり、このディスプレイにゲインマップを含む画像を表示するとします。 B は、基本イメージの原色と線形転送関数を持つ色空間内の基本イメージからのピクセル値とします。 G をゲインマップのピクセル値にします。 D を B と同じ色空間の出力ピクセルにします。D の値は次のように計算されます。

まず、ゲインマップを適用する量を決定する重みパラメーターを W に設定します。

W = clamp((log(H)                      - log(minDisplayRatioForHdrTransition)) /
                        (log(displayRatioForFullHdr) - log(minDisplayRatioForHdrTransition), 0, 1)

次に、L をログ領域のゲインマップ値にします。これを、テクスチャからサンプリングされた値 G から次のように計算します。

L = mix(log(ratioMin), log(ratioMax), pow(G, gamma))

最後に、表示されるピクセルである計算 D にゲインマップを適用します。基本イメージが SDR の場合は、次を計算します。

D = (B + epsilonSdr) * exp(L * W) - epsilonHdr

上記の数学では、log() は自然対数で、exp() は自然指数です。これらの関数のベースは取り消され、結果に影響しないため、必要に応じて他のベースを使用できます。

の Java ドキュメント android.graphics.Gainmap。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

Gainmap(Bitmap)

特定のビットマップからゲインマップを作成します。

プロパティ

Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Creator	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。
DisplayRatioForFullHdr	ゲインマップが完全に適用される時点の hdr/sdr 比を取得します。または、ゲインマップが完全に適用される時点での hdr/sdr 比を設定します。
GainmapContents	ゲインマップの画像データを設定します。
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
JniPeerMembers	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。
MinDisplayRatioForHdrTransition	SDR イメージのみが表示される、以下の hdr/sdr 比率を取得します。または、SDR イメージのみが表示される hdr/sdr 比を設定します。
PeerReference	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 (継承元 Object)
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 (継承元 Object)

メソッド

Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
DescribeContents()	特別な区画の内容はありません。
Dispose()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
Dispose(Boolean)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetEpsilonHdr()	hdr epsilon を取得します。
GetEpsilonSdr()	sdr epsilon を取得します。
GetGamma()	ゲインマップガンマを取得します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetRatioMax()	最大ゲインマップ比を取得します。
GetRatioMin()	最大ゲインマップ比を取得します。
JavaFinalize()	ガベージコレクションがオブジェクトへの参照がなくなったと判断したときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドをウェイクアップします。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドをウェイクアップします。 (継承元 Object)
SetEpsilonHdr(Single, Single, Single)	数値が不安定にならないようにするために使用される hdr epsilon を設定します。
SetEpsilonSdr(Single, Single, Single)	数値が不安定にならないようにするために使用される sdr epsilon を設定します。
SetGamma(Single, Single, Single)	ゲインマップガンマを設定します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetRatioMax(Single, Single, Single)	ゲインマップの比率を最大に設定します。
SetRatioMin(Single, Single, Single)	ゲインマップ比を最小に設定します。
ToArray<T>()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または <em>割り込み</em によって待機します>。 (継承元 Object)
Wait(Int64)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	ゲインマップをパーセルに書き込みます。

明示的なインターフェイスの実装

IJavaPeerable.Disposed()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.Finalized()	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。 (継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。
GetJniTypeName(IJavaPeerable)	ゲインマップは、可変表示調整機能を備えた HDR イメージを生成する SDR イメージを拡張するためのメカニズムを表します。

適用対象