このページは Cloud Translation API によって翻訳されました。

グラフィック

API リファレンス
androidx.graphics

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

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

アーティファクト	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
グラフィックスコア	1.0.0	-	-	-
グラフィックパス	1.0.1	-	-	-
グラフィックシェイプ	-	1.0.0-rc01	-	-

このライブラリの最終更新日: 2024 年 7 月 24 日

依存関係の宣言

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

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

Groovy

dependencies {
    implementation "androidx.graphics:graphics-core:1.0.0"
    implementation "androidx.graphics:graphics-path:1.0.1"
    implementation "androidx.graphics:graphics-shapes:1.0.0-rc01"
}

Kotlin

dependencies {
    implementation("androidx.graphics:graphics-core:1.0.0")
    implementation("androidx.graphics:graphics-path:1.0.1")
    implementation("androidx.graphics:graphics-shapes:1.0.0-rc01")
}

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

フィードバック

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

新しい問題を報告する

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

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

Graphics Shapes バージョン 1.0

バージョン 1.0.0-rc01

2024 年 7 月 24 日

androidx.graphics:graphics-shapes:1.0.0-rc01、androidx.graphics:graphics-shapes-android:1.0.0-rc01、androidx.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-beta01、androidx.graphics:graphics-shapes-android:1.0.0-beta01、androidx.graphics:graphics-shapes-desktop:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

シェイプを事前に回転し、別の地点から開始できるようにします。この変更により、pillStar シェイプで、境界のデフォルトではない点から曲線を開始できるようになりました。これ��、シェイプのパスのストロークをアニメーション化し、シェイプのアウトライン上の特定の位置から描画を開始する場合に便利です。（Ifbb4d、b/324303807）。
RoundedPolygon で同じ関数を並列化する calculateBounds() 関数を Morph に追加しました。（I8a3b6、b/325463575）。

バージョン 1.0.0-alpha05

2024 年 2 月 7 日

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

新機能

ライブラリに新しい pill() 関数と pillStar() 関数が追加され、丸みを帯びた図形や星付きの図形を簡単に作成できるようになりました。シェイプに必要な境界を正確に計算するための新しい API（以前の境界は、基礎となるベジェ曲線のアンカーとコントロールポイントに基づく推定値にすぎない）や、可能な範囲の上限を計算するための新しい API もあります。この API は、保持するコンテナがコンテナ内で回転される場合のサイズを決定するために役立ちます。（I71827）。

API の変更

正確な境界と最大の境界を取得するためのオプションが追加されました。（I6d49f、b/317286450）。

バグの修正

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

バージョン 1.0.0-alpha04

2023 年 12 月 13 日

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

新機能

このリリースには、いくつかの API の変更と、バグの修正が含まれています。
API の変更の多くにより、シェイプライブラリが KMP に対応しました。これにより、Android 以外のコード（Android に依存しない Compose コードなど）からの呼び出しが容易になります。たとえば、上記の PointF、行列、パスの各型など、Android の型は API にはありません。
また、パフォーマンス上の理由、特にオブジェクトの割り当て（および収集）を最小限に抑えるために、API と実装に対していくつかの変更が行われました。たとえば、PointF から個別の Float パラメータに移行することで、一時的な PointF 構造体を多数割り当てて頂点を保持する必要がなくなります。

API の変更

Morph.asMutableCubics を MutableCubics を反復する関数に置き換えました。PointTransformer 関数インターフェースを変更しました。これにより、Point の x 座標と y 座標を受け取り、TransformedResult（変換された x 座標と y 座標で構築）を返すようになりました（I6719e）。
パブリック Cubic コンストラクタを削除し、ファクトリ関数に変更しました。（I409ce）。
Android 固有の変換 API と描画 API の追加（I079f6、b/292289543）
Android の依存関係を排除しました（Iadc1c、b/292289543）
アンカーとコントロールのプロパティ名がわかりやすくなりました（If13bd、b/294562941）。
PointF パラメータが Float ペアに変更されました。（Id4705、b/276466399、b/290254314）
progress が Morph 描画コマンドに直接渡されるようになりました（Icdca2）。

バグの修正

大きなシェイプを作成する場合のバグを修正しました。（I4fd66、b/313497325）。

バージョン 1.0.0-alpha03

2023 年 6 月 7 日

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

API の変更

新しい RoundedPolygon.rectangle() 関数を追加しました。（I78e7e、b/280322189）
スター関数と円関数が頭文字で区切られ、RoundedPolygon のコンパニオンオブジェクト（例:RoundedPolygon.star(...)（I14735）。

バグの修正

平滑化に関するバグを修正しました（Ibf894）。
開始形状と終了形状が同じ場合に発生するバグを修正しました。切り取り用に使用可能なスペースをより適切に配分します。まず使用可能なスペースを使用して丸め、スペースがある場合は滑らかにします。（Ibd320、b/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 値を取るようになりました。この値は、既存の radius パラメータと同じ単位で指定され、よりシンプルかつ一貫性のあるものになります。また、内側と外側の両方の半径に同じ数値が適用されることを明確にするために、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 まで設定可能な「モーフ」シェイプを自動的に計算し、開始シェイプと終了シェイプの間でアニメーション化できます。フレームごとに結果を描画して時間の経過に伴うアニメーション化を行い、新しい丸みを帯びたシェイプ間で滑らかなアニメーションを作成します。