グラフィック

  
複数の Android プラットフォーム リリースでグラフィック機能を利用します

androidx.graphics グループ内のすべてのアーティファクトのリストを以下に示します。

アーティファクト 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
graphics-core 1.0.3 - - -
graphics-path 1.0.1 - - -
graphics-shapes 1.0.1 - 1.1.0-beta01 -
このライブラリの最終更新日: 2025 年 7 月 30 日

依存関係の宣言

Graphics への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.3"
    implementation "androidx.graphics:graphics-path:1.0.1"
    implementation "androidx.graphics:graphics-shapes:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.3")
    implementation("androidx.graphics:graphics-path:1.0.1")
    implementation("androidx.graphics:graphics-shapes:1.1.0-beta01")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

Graphics バージョン 1.1

バージョン 1.1.0-beta01

2025 年 7 月 30 日

androidx.graphics:graphics-*:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 にはこれらの commit が含まれています。

API の変更

  • Kotlin 2.0 でリリースされたプロジェクトを使用するには、KGP 2.0.0 以降が必要です(Idb6b5
  • mingwX64、js、wasm のコンパイル ターゲットを追加します。(I2c46a

バージョン 1.1.0-alpha01

2024 年 12 月 11 日

androidx.graphics:graphics-*:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 にはこれらの commit が含まれています。

新機能

  • メインのデモを汎用のシェイプ エディタに作り直しました。これにより、SVG パスからシェイプをインポートしたり、自動プロセスで検出されなかった特徴を手動で編集したり、結果を本番環境のコードで使用できるコードにエクスポートしたりできます。(I1ac13
  • シェイプ アウトラインの進行状況の角度測定を曲線長の測定に置き換え、より複雑なシェイプをモーフィングに使用できるようにしました。(I75478)、I390dd
  • 特徴マッピング アルゴリズムを改善し、より自然なモーフィングを実現しました。(I83287

API の変更

  • SVG パスのインポートと特徴シリアライザーを追加。通常のフローは次のとおりです。
    • 新しい SvgPathParser.parseFeatures() を使用して、svg パス(svg の path 要素の d 属性の値)を List<Feature> に変換します。
    • これは変更可能で、FeatureSerializer.serialize() を使用して文字列にシリアル化できます。
    • 生成された文字列は、FeatureSerializer.parse() でインポートして本番環境コードで使用できます。
    • ステップ 1 と 2 は 1 回だけ行い、新しいアプリで行うことができます。プロダクション コードではステップ 3 のみを行う必要があります。(I9bd00b/371196190)、(Ic3842)、(If68ed)、(I10251
  • ポリゴン対象物と対象物タイプを公開します。List<Features> を受け取るベース コンストラクタを使用して、より汎用的な RoundedPolygons を作成できるようになりました。特徴は主に 3 次ベジエ曲線のリストですが、モーフィング アルゴリズムが開始図形と終了図形を一致させるのに役立つタグが付けられています(凸角は凸角に、凹角は凹角にマッピングされます)。(I61e76)、(I1fc5c
  • watchosDeviceArm64 KMP ターゲットとターゲット kotlin 1.9 のサポートを追加しました。(Icf15db/364652024

バグの修正

  • 最後の特徴が空の場合のエッジケースを修正しました。(I390dd
  • RoundedPolygon の作成をより堅牢にします。(Ib862cb/360888486
  • RoundedPolygon の初期化に関するバグを修正しました。(I83ddb
  • ポリゴンの中心を推定するアルゴリズムのエラーを修正しました。(Ida147

Graphics Shapes バージョン 1.0

バージョン 1.0.1

2024 年 9 月 4 日

androidx.graphics:graphics-shapes:1.0.1androidx.graphics:graphics-shapes-android:1.0.1androidx.graphics:graphics-shapes-desktop:1.0.1 がリリースされました。バージョン 1.0.1 にはこれらの commit が含まれています。

バージョン 1.0.0

2024 年 8 月 21 日

androidx.graphics:graphics-shapes:1.0.0androidx.graphics:graphics-shapes-android:1.0.0androidx.graphics:graphics-shapes-desktop:1.0.0 がリリースされました。バージョン 1.0.0 にはこれらの commit が含まれています。

バージョン 1.0.0-rc01

2024 年 7 月 24 日

androidx.graphics:graphics-shapes:1.0.0-rc01androidx.graphics:graphics-shapes-android:1.0.0-rc01androidx.graphics:graphics-shapes-desktop:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 にはこれらの commit が含まれています。

バージョン 1.0.0-beta01

2024 年 5 月 1 日

androidx.graphics:graphics-shapes:1.0.0-beta01androidx.graphics:graphics-shapes-android:1.0.0-beta01androidx.graphics:graphics-shapes-desktop:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 にはこれらの commit が含まれています。

API の変更

  • シェイプを事前に回転させて、別のポイントから開始できるようにします。この変更により、pillStar シェイプの曲線を境界上のデフォルト以外のポイントから開始できるようになります。これは、シェイプのパスのストロークをアニメーション化して、シェイプのアウトライン上の特定の場所から描画を開始する場合に便利です。(Ifbb4db/324303807
  • Morph に calculateBounds() 関数を追加しました。これは RoundedPolygon の同じ関数と並行して動作します。(I8a3b6b/325463575

バージョン 1.0.0-alpha05

2024 年 2 月 7 日

androidx.graphics:graphics-shapes:1.0.0-alpha05androidx.graphics:graphics-shapes-android:1.0.0-alpha05androidx.graphics:graphics-shapes-desktop:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください

新機能

  • このライブラリには、これらの丸みのある星形の図形を簡単に作成できる新しい pill() 関数と pillStar() 関数が用意されています。また、シェイプに必要な正確な境界を計算する新しい API(以前の境界は、基盤となるベジエ曲線のアンカー ポイントと制御点に基づく推定値にすぎませんでした)と、可能な最大境界を計算する新しい API もあります。これは、コンテナ内で回転させる場合に、そのコンテナのサイズを決定するのに役立ちます。(I71827

API の変更

  • 正確な境界と最大境界を取得するためのオプションが増えました。(I6d49fb/317286450

バグの修正

  • これらのシェイプをストローク パスとして描画すると、ゼロ長の曲線に関連する低レベルのレンダリングの問題により、レンダリング アーティファクトがまれに発生していました。このバグは、長さがゼロのすべての曲線(形状には不要なため、形状によって生成されるパスのオーバーヘッドも削減されます)を排除することで修正されました。

バージョン 1.0.0-alpha04

2023 年 12 月 13 日

androidx.graphics:graphics-shapes:1.0.0-alpha04androidx.graphics:graphics-shapes-android:1.0.0-alpha04androidx.graphics:graphics-shapes-desktop:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください

新機能

  • このリリースには、いくつかの API 変更とバグの修正が含まれています。
  • API の変更の多くは、Shapes ライブラリを KMP 対応にするものです。これにより、Android 以外のコード(Android に依存しない Compose コードなど)から呼び出しやすくなります。たとえば、API には、以前の PointF、Matrix、Path などの Android 型はありません。
  • パフォーマンス上の理由から、API と実装にもいくつかの変更が加えられました。特に、オブジェクトの割り当て(と収集)を最小限に抑えるための変更です。たとえば、PointF から個別の Float パラメータに移行することで、それらの頂点を保持するために多くの一時的な PointF 構造体を割り当てることを回避できます。

API の変更

  • Morph.asMutableCubicsMutableCubics を反復処理する関数に置き換えました。PointTransformer 関数型インターフェースが変更され、Point の x 座標と y 座標を受け取り、TransformedResult(変換された x 座標と y 座標で構築される)を返すようになりました(I6719e
  • パブリック Cubic コンストラクタを削除し、ファクトリ関数にしました。(I409ce
  • Android 固有の変換 API と描画 API を追加(I079f6b/292289543
  • Android の依存関係を排除しました(Iadc1cb/292289543
  • アンカーと制御のプロパティ名がより適切なものになりました(If13bdb/294562941
  • PointF パラメータを Float ペアに変更しました(Id4705b/276466399b/290254314
  • progressMorph 描画コマンドに直接渡されるようになりました。(Icdca2

バグの修正

  • 大きな図形を作成する際のバグを修正しました。(I4fd66b/313497325

バージョン 1.0.0-alpha03

2023 年 6 月 7 日

androidx.graphics:graphics-shapes:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください

API の変更

  • 新しい RoundedPolygon.rectangle() 関数を追加しました(I78e7eb/280322189
  • Star 関数と Circle 関数が小文字になり、RoundedPolygon のコンパニオン オブジェクトを介して呼び出されるようになりました(例: RoundedPolygon.star(...)(I14735)

バグの修正

  • スムージングに関するバグを修正しました(Ibf894
  • 開始シェイプと終了シェイプが同じ場合に発生するバグを修正しました。カット用にサイドの空きスペースをより適切に配分します。まず、丸め処理に空きスペースを使用し、スペースが残っている場合は平滑化処理に使用します。(Ibd320b/277936300

バージョン 1.0.0-alpha02

2023 年 4 月 19 日

androidx.graphics:graphics-shapes:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください

API の変更

  • Polygon スーパークラスがサブクラス RoundedPolygon と統合されました。すべてのポリゴンが丸みを帯びたポリゴンになりました(任意)。
  • Star 関数(以前と同様に RoundedPolygon を返します)は、以前の innerRadiusRatio パラメータではなく、innerRadius 値を受け取るようになりました。これは既存の半径パラメータと同じ単位であるため、シンプルで一貫性のあるものになります。また、内側と外側の両方の半径に同じ数値が適用されることを明確にするため、numOuterVertices パラメータの名前が numVerticesPerRadius に変更されました。
  • CornerRounding.radius は以前、ポリゴンのサイズに対する相対値としてドキュメントに記載されていましたが、実際には相対値ではなく絶対値です。ドキュメントが更新され、最大値が 1.0 に制限されるアノテーションが修正されました。

バージョン 1.0.0-alpha01

2023 年 4 月 5 日

Graphics-Shapes は、丸みを帯びた多角形の形状を簡単に作成してレンダリングできる新しいライブラリです。また、異なる形状間の単純な自動モーフィング(アニメーション)も可能です。

androidx.graphics:graphics-shapes:1.0.0-alpha01 がリリースされました。このバージョンは内部ブランチからリリースされました。

新機能

  • Polygon API を使用して、必要な数の頂点を持つ正多角形と星形多角形を作成します。
  • オプションの CornerRounding パラメータを使用して、角の丸め半径とスムージング パラメータを指定します。これにより、角が丸い多角形が生成されます。
  • 新しい Morph(Polygon, Polygon) API を使用して、「モーフィング」シェイプを自動的に計算します。このシェイプの進行状況は 0 ~ 1 の範囲で設定でき、開始シェイプと終了シェイプの間でアニメーション化できます。その進行状況を時間とともにアニメーション化し、すべてのフレームで結果を描画して、新しい丸みを帯びた図形間のスムーズなアニメーションを作成します。

Graphics Path バージョン 1.0

バージョン 1.0.1

2024 年 5 月 1 日

androidx.graphics:graphics-path:1.0.1 がリリースされました。バージョン 1.0.1 にはこれらの commit が含まれています。

バグの修正

  • コンパイラ フラグの改善。

バージョン 1.0.0

2024 年 3 月 6 日

androidx.graphics:graphics-path:1.0.0 がリリースされました。

バージョン 1.0.0-rc01

2024 年 2 月 21 日

androidx.graphics:graphics-path:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください

バグの修正

  • API 34 未満での PathIterator のパフォーマンスを改善(Id4629

バージョン 1.0.0-beta02

2024 年 1 月 10 日

このリリースの変更は、ネイティブ コードの想定により必要以上に大きくなっていたライブラリのサイズを縮小することに重点を置いています。

androidx.graphics:graphics-path:1.0.0-beta02 がリリースされました。バージョン 1.0.0-beta02 に含まれる commit については、こちらをご覧ください

バグの修正

  • libandroidx.graphics.path.so のサイズを 96% 縮小しました。(I71397
  • libandroidx.graphics.path.so のサイズを 5% 縮小します。(I2da7c
  • androidx.graphics:graphics-path のネイティブ コンポーネントを 43% 縮小しました。(I8e40d

バージョン 1.0.0-beta01

2023 年 11 月 29 日

androidx.graphics:graphics-path:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

API の変更

  • 試験運用版の isAtLeastU() API の使用を削除しました(Ie9117b/289269026

バグの修正

  • ライブラリが円錐曲線を取り扱う方法など、さまざまな修正とパフォーマンスの改善を行いました。

バージョン 1.0.0-alpha02

2023 年 6 月 7 日

androidx.graphics:graphics-path:1.0.0-alpha02 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

  • Android 14 プレビューで実行したときに問題が発生する原因となっていた内部プラットフォーム バージョン チェックの問題を修正しました(バージョン チェックは失敗しますが、以前のリリースで処理を行うメカニズムが Android 14 では特に正しく動作しません)。

バージョン 1.0.0-alpha01

2023 年 3 月 22 日

androidx.graphics:graphics-path:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • この新しいライブラリでは、新しい PathIterator API を介して Path データをクエリできます。この API を使用すると、呼び出し元は Path オブジェクトのすべてのセグメントを反復処理して、それらのセグメントのオペレーションとデータを特定できます。
  • このライブラリは、Android 14 プレビューで導入された同様の API を使用しますが、この AndroidX バージョンの API は API 21 まで遡って機能します。

Graphics Core バージョン 1.0

バージョン 1.0.3

2025 年 3 月 26 日

androidx.graphics:graphics-core:1.0.3 がリリースされました。バージョン 1.0.3 にはこれらの commit が含まれています。

バグの修正

  • API<33 の一部のデバイスで描画中に全画面がちらつく問題を修正。

バージョン 1.0.2

2024 年 10 月 16 日

androidx.graphics:graphics-core:1.0.2 がリリースされました。バージョン 1.0.2 にはこれらの commit が含まれています。

バグの修正

  • SurfaceControl インスタンスがリリースされた後もシステム コンポジタによって管理され続ける問題を修正しました。
  • 低レイテンシの依存関係が破棄された後に、現在表示されている HardwareBuffer インスタンスがリリースされない問題を修正
  • フロント バッファ使用フラグをサポートしていない一部の Android 14 以降のデバイスで発生するちらつきの問題を修正しました

バージョン 1.0.1

2024 年 9 月 4 日

androidx.graphics:graphics-core:1.0.1 がリリースされました。バージョン 1.0.1 にはこれらの commit が含まれています。

バグの修正

  • メモリリソースが解放されないことがある問題を修正しました。

バージョン 1.0.0

2024 年 5 月 29 日

androidx.graphics:graphics-core:1.0.0 がリリースされました。バージョン 1.0.0 にはこれらの commit が含まれています。

1.0.0 の主な機能

  • graphics-core ライブラリの公式安定版リリース。1.0.0-rc01 の軽微なバグの修正とパフォーマンスの改善が含まれています

バージョン 1.0.0-rc01

2024 年 4 月 17 日

androidx.graphics:graphics-core:1.0.0-rc01 がリリースされました。このバージョンは内部ブランチで開発されています。

バグの修正

  • Android 14 を搭載する特定の Android デバイスで CanvasBufferedRendererAPI を使用すると、ファイル記述子が二重に閉じられる可能性がある問題を修正しました。
  • FrameBuffer がフレームバッファ インスタンスを適切に削除しない問題を修正しました。

バージョン 1.0.0-beta01

2023 年 12 月 13 日

androidx.graphics:graphics-core:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

新機能

  • View 階層内で Android の 2D グラフィック API(Canvas + Paint)による低遅延レンダリングをサポートする新しい LowLatencyCanvasView API を導入しました。
  • HardwareBuffer へのハードウェア アクセラレーション キャンバス レンダリングをサポートする CanvasBufferedRenderer API を導入しました。これは、Bitmap.wrapHardwareBuffer API を使用して Bitmap に変換できるバッファにユーザー インターフェースの一部を描画するために使用できます。

API の変更

  • オプションのフェンス パラメータを持つように CanvasBufferRenderer#releaseBuffer API を更新しました。RenderResult#fence が返されるタイミングについて説明するようにドキュメントを更新しました。(If1ea7
  • コルーチンを活用して描画リクエストをスケジュール設定できるよう、draw メソッドを RenderRequest に追加しました。エグゼキュータを使用する以前の描画メソッドの名前を drawAsync に変更しました。isClosed() メソッドをプロパティにリファクタリングしました。(I5bff6
  • バッファ形式パラメータを CanvasFrontBufferRenderer に公開して CanvasBufferedRenderer.Builder#setBufferFormat に直接マッピング(I0f272
  • HardwareBuffer へのハードウェア アクセラレーテッド キャンバス レンダリングを処理する CanvasBufferedRenderer API を作成しました。これにより、スワップチェーンの深さ HardwareBuffers の構成とともに、Android Q に移植された実装が提供されます。ColorSpace 構成は Android U+ に限定されますが、互換性実装はデベロッパーに代わって no-op 動作を提供します。(I9b1d8
  • setFrameRate/clearFrameRate API を SurfaceControlCompat.Transaction に追加して、シームレスまたはデフォルトのトランジションの変更戦略とともにフレームレートを制御します。(I6045c
  • setDataSpace の必須 API レベルを Android T から Android Q に引き下げました。(I59c34
  • バッファが提示されなくなったときにコンシューマーが状態をクリーンアップできるように、GLFrameBufferRenderer API に onBufferReleased コールバックを追加しました(I8a4e2
  • View 階層のレンダリングと同期される低レイテンシのコンテンツ レンダリングというシンプルなユースケースをサポートする LowLatencyCanvasView を作成します。これにより、同期された低レイテンシ レンダリングのために、画面上で変換される SurfaceView インスタンスを内部で管理することで、SurfaceView 管理に伴う複雑さを軽減します。(I9253b
  • CanvasFrontBufferedRenderer API にカラースペース構成のサポートを追加しました。マルチバッファ コールバックを更新して、バックバッファ SurfaceControl も含めるようにしました(I24bd9

バージョン 1.0.0-alpha05

2023 年 9 月 6 日

androidx.graphics:graphics-core:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください

新機能

  • GLFrameBufferRenderer API を導入しました。これにより、OpenGL の依存関係、スワップ チェーン構成、ピクセル形式、SurfaceControl 構成の組み合わせが提供されます。(Ic775b

API の変更

  • SurfaceHolder#Callbacks からディメンションをパイプ処理するために、さまざまなコールバック API に幅と高さのパラメータを追加しました。(I7f9fc
  • フロント レイヤーとマルチ バッファ レイヤーの両方をクリアするクリア API を追加しました。(Ic1f95
  • GLFrontBufferedRenderer 内で使用されるスワップチェーンの基盤となるバッファタイプを設定するサポートを追加しました。(I07a13
  • GLFrameBufferRenderer、最大バッファ エントリの IntRange アノテーション、setFormat/setUsageHardwareBufferFormart アノテーションと HardwareBufferUsage アノテーションのゲッターの Kotlin プロパティを追加しました。(Ief89e
  • SurfaceControl トランザクションの setBuffer API を更新して、リリース フェンスを提供しました。(Ice1bb
  • データ空間を構成し、拡張輝度範囲を設定する SurfaceControlCompat.Transaction API を追加しました。(Ic378d

バージョン 1.0.0-alpha04

2023 年 6 月 7 日

androidx.graphics:graphics-core:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください

新機能

  • 既存の OpenGL 実装とともに android.graphics.Canvas API を活用して低レイテンシのグラフィックをサポートする CanvasFrontBufferedRenderer を導入

API の変更

  • 対応するプラットフォーム API を反映するため、null 許容の HardwareBuffer インスタンスを許可するように SurfaceControlCompat.Transaction#setBuffer API を更新(I173d7
  • バッキング スワップチェーンに 2 つ以上のバッファが含まれている可能性があるため、ダブル バッファ レンダリングを参照するメソッドの名前をマルチ バッファに変更します。(I830d7
  • Canvas API を使用して、サードパーティがフロント バッファリング レンダリング システムを活用できるようにする CanvasFrontBufferedRenderer API を作成します。(Ibfc29

バグの修正

  • 対応するアクティビティを再開した後、GLFrontBufferedRenderer がコンテンツをレンダリングしない問題を修正しました。
  • 前面バッファのコンテンツが早期にクリアされる問題を修正しました。
  • 低遅延グラフィック API がリリースされた後も SurfaceHolder.Callbacks が削除されない問題を修正しました。

バージョン 1.0.0-alpha03

2023 年 3 月 22 日

androidx.graphics:graphics-core:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください

API の変更

  • GLFrontBufferedRenderer コールバックの実装を更新して、バッファの幅と高さを含む BufferInfo オブジェクトと、中間スクラッチ バッファへのレンダリング後に元の宛先を再ターゲット設定するために使用できるフレーム バッファ識別子を提供するようにしました。(I7fe20
  • SyncFence の作成を SyncFenceCompat の静的ファクトリ メソッドに統合しました。
  • eglDupNativeFenceFDANDROID のパブリック互換性メソッドを削除し、SyncFence 作成用の SyncFenceCompat ファクトリー メソッドに置き換えました。これは、API レベルにかかわらず、すべての API サーフェスが正しい SyncFence 実装を受け取るようにするためです。(I849bb
  • FrameBufferRendererSyncStrategy のドキュメントを追加しました。
    • FrameBufferRenderer + FrameBuffer + FrameBufferPoolandroidx.graphics.opengl パッケージに移動しました
    • SyncStrategyandroidx.graphics.opengl パッケージに移動しました
    • RenderCallback#onDraw のドキュメントを更新しました
    • API の実装者が FrameBuffer.close を呼び出す責任を負う RenderCallback#obtainFrameBuffer のドキュメントを更新しました
    • onDrawComplete を更新して、表示するコンテンツのディスパッチはコンシューマーの責任であることを示す
    • フレームワークをミラーリングするため、SyncFence 互換性インターフェース/クラスを androidx.hardware パッケージに移動
    • SyncFence API の名前を SyncFenceV19 に変更し、非公開にしました。これにより、可能な限りフレームワークの SyncFence API を活用する SyncFenceCompat に使用法を統合します。(I5149c
  • GLFrontBufferedRenderer#cancel メソッドと GLFrontBufferedRenderer#execute メソッドを追加しました。前者は、フロント バッファへのレンダリングをキャンセルしてフロント バッファを非表示にする必要があるパーム リジェクションのシナリオで役立ちます。後者は、レンダリングをスケジュールすることなく GL スレッドでオブジェクトを操作するシナリオで役立ちます。(If0b7f
  • ダブル バッファリングされたレイヤに直接レンダリングする API を追加。これにより、再開後のシーンの再レンダリングが支援されるとともに、レンダリングするシーンに基づいてフロント バッファリング レンダリングを動的に活用するタイミングをコンシューマーが選択的に決定できるようになります。(Ied56c
  • SurfaceControlCompat.Builder に新しい API が追加され、SurfaceView からの既存のメカニズムに加えて、別の SurfaceControl インスタンスから親 SurfaceControl を構成できるようになりました。(I1d1b6
  • 非推奨になった非表示関数の戻り値の型の null 可能性を拡大しました。(Ibf7b0
  • EGL_ANDROID_get_native_client_buffer 拡張機能定数を追加しました。これにより、Android デバイスが HardwareBuffer インスタンスを EGLImage インスタンスとして使用できる EGLClientBuffer オブジェクトにインポートすることをサポートしているかどうかを照会できます。(Iad767
  • @JvmDefaultWithCompatibility アノテーションを追加しました。(I8f206

バージョン 1.0.0-alpha02

2022 年 11 月 9 日

androidx.graphics:graphics-core:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください

API の変更

  • Android S で導入された addTransactionCommitListenerRequiresApi アノテーションが欠落する問題を修正しました(I0a035
  • onDraw<Front/Double> バッファのコールバックを更新して、コンシューマーが現在のバッファの幅、高さに加えて、頂点シェーダーに渡すことができる変換マトリックスを提供するようにしました。これらのパラメータを使用して、OpenGL レンダリング コードを正しく事前回転することは、コンシューマーの責任です。(I82f9e

バグの修正

  • SurfaceControl トランザクションを発行する前にバッファを事前回転することで、グラフィックのレイテンシを改善しました。
  • エラーログにエラー 300d(EGL_BAD_SURFACE)が表示される問題を修正しました。
  • 対応するアクティビティが再開された後、内部で使用された GLFrontBufferedRenderer が無効になる問題を修正しました。
  • エミュレータと ChromeOS デバイスのサポートを強化しました。
  • 前面バッファのレイヤが非表示になるのが早すぎる可能性がある問題を修正しました。

バージョン 1.0.0-alpha01

2022 年 10 月 24 日

androidx.graphics:graphics-core:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • graphics コア AndroidX ライブラリの初回リリースです。このリリースには、タッチペン入力などの低レイテンシ ユースケースをサポートする API が含まれています。また、OpenGL を使用するためのヘルパー API もいくつか導入されています。

API の変更

  • GLFrontBufferedRenderer を導入しました。このクラスは、前面およびマルチバッファのレンダリングを補助し、低レイテンシかつ高品質のレンダリング出力を実現します。
  • GLRenderer API を導入しました。この API は、SurfaceViewTextureView などのさまざまなサーフェス プロバイダで OpenGL レンダリングを補助します。