图形
下表列出了 androidx.graphics
组中的所有工件。
制品 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
显卡核心 | 1.0.0 | - | - | - |
图形路径 | 1.0.1 | - | - | - |
图形形状 | - | - | 1.0.0-beta01 | - |
声明依赖项
如需添加 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-beta01" }
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-beta01") }
如需详细了解依赖项,请参阅添加 build 依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库有任何改进建议,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
此工件没有版本说明。
Graphics Shapes 版本 1.0
版本 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 中包含这些提交内容。
API 变更
- 允许预先旋转形状,以便从不同的位置开始绘制。此更改允许
pillStar
形状从边界上的非默认点开始其曲线。在为形状路径的描边添加动画效果时,以便从形状轮廓上的特定位置开始绘制,这会非常有用。(Ifbb4d、b/324303807) - 向 Morph 添加了
calculateBounds()
函数,可并行处理RoundedPolygon
上的相同函数。(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 中包含这些提交内容。
新功能
- 该库现在提供新的
pill()
和pillStar()
函数,用于轻松创建这些圆角/加星标形状。还有一些新的 API 可用于计算形状所需的精确边界(以前的边界只是基于底层贝塞尔曲线锚点和控制点的估计值),以及可能的最大边界,这可能有助于确定承载该形状的容器的大小(如果该容器会在该容器中旋转)。(I71827)
API 变更
- 新增了用于检索精确边界和最大边界的选项。(I6d49f、b/317286450)
bug 修复
- 由于存在与零长度曲线相关的低级别渲染问题,在将这些形状绘制为描边路径时偶尔会出现渲染伪影。此 bug 已通过消除所有零长度的曲线(形状不需要这些曲线)来修复,从而也节省了形状生成的路径的开销。
版本 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 中包含这些提交内容。
新功能
- 此版本包含多项 API 更改,并修复了一些问题。
- 许多 API 更改使 Shape 库兼容 KMP。这样可以更轻松地从非 Android 代码(例如与 Android 无关的 Compose 代码)进行调用。例如,API 中没有 Android 类型,如之前的 PointF、Matrix 和 Path 类型。
- 出于性能方面的原因,还对 API 和实现进行了一些更改,特别是为了最大限度地减少对象分配(和收集)。例如,从 PointF 移至单独的 Float 参数可避免分配许多临时 PointF 结构来容纳这些顶点。
API 变更
- 将
Morph.asMutableCubics
替换为了用于迭代MutableCubics
的函数。更改了PointTransformer
函数接口,现在它接受Point
的 x 坐标和 y 坐标,并返回TransformedResult
(使用转换后的 x 坐标和 y 坐标构建而成)(I6719e) - 移除了公共
Cubic
构造函数,并将其设为工厂函数。(I409ce) - 添加了 Android 专用转换和绘制 API(I079f6、b/292289543)
- 消除了 Android 依赖项(Iadc1c、b/292289543)
- 锚点和控件属性名称现在更合理(If13bd、b/294562941)
PointF
参数已更改为Float
对(Id4705、b/276466399、b/290254314)progress
现在会直接传递给Morph
绘制命令 (Icdca2)
bug 修复
- 修复了创建较大形状时出现的 bug。(I4fd66、b/313497325)
版本 1.0.0-alpha03
2023 年 6 月 7 日
发布了 androidx.graphics:graphics-shapes:1.0.0-alpha03
。版本 1.0.0-alpha03 中包含这些提交内容。
API 变更
- 添加了新的
RoundedPolygon.rectangle()
函数(I78e7e、b/280322189) - Star 和 Circle 函数现在已废弃,并通过
RoundedPolygon
的伴生对象进行调用:例如RoundedPolygon.star(...)
(I14735)
bug 修复
- 修复了平滑处理方面的 bug (Ibf894)
- 修复了起始形状和结束形状相同时发生的 bug。更好地分配在侧面进行切割的可用空间,首先使用可用空间进行舍入,然后在剩余空间时进行平滑。(Ibd320、b/277936300)
版本 1.0.0-alpha02
2023 年 4 月 19 日
发布了 androidx.graphics:graphics-shapes:1.0.0-alpha02
。版本 1.0.0-alpha02 中包含这些提交内容。
API 变更
- Polygon 父类与其子类
RoundedPolygon
合并;所有多边形现在都是 [可选] 圆角多边形。 - Star 函数(仍然像之前一样返回
RoundedPolygon
)现在接受innerRadius
值,而不是之前的innerRadiusRatio
参数。此参数与现有 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,以便在起始形状和结束形状之间添加动画效果。以动画形式呈现随着时间推移的进展,在每一帧上绘制结果,从而在这些新的圆角形状之间创建平滑的动画。
Graphics Path 版本 1.0
版本 1.0.1
2024 年 5 月 1 日
发布了 androidx.graphics:graphics-path:1.0.1
。版本 1.0.1 中包含这些提交内容。
bug 修复
- 改进了编译器标志。
版本 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 中包含这些提交内容。
bug 修复
- 提升了 PathIterator 在 API 级别低于 34 时的性能 (Id4629)
版本 1.0.0-beta02
2024 年 1 月 10 日
此版本中的更改主要是为了缩减库的大小,由于原生代码所做的假设,库大小超出必要大小。
发布了 androidx.graphics:graphics-path:1.0.0-beta02
。版本 1.0.0-beta02 中包含这些提交内容。
bug 修复
- 将
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 中包含这些提交内容。
API 变更
- 移除了实验性
isAtLeastU()
API 的用法(Ie9117、b/289269026)
bug 修复
- 修复了各种问题并提升了性能,包括该库处理圆锥曲线的方式。
版本 1.0.0-alpha02
2023 年 6 月 7 日
发布了 androidx.graphics:graphics-path:1.0.0-alpha02
。此版本是在内部分支中开发的。
新功能
- 修复了在 Android 14 预览版上运行时会导致内部平台版本检查出现问题(版本检查会失败,但在 Android 14 上执行操作的机制在 Android 14 上无法正常运行)。
版本 1.0.0-alpha01
2023 年 3 月 22 日
发布了 androidx.graphics:graphics-path:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
- 此新库允许通过新的
PathIterator
API 查询路径数据。调用方可使用此 API 遍历 Path 对象的所有线段,以确定这些线段的操作和数据。 - 该库使用了 Android 14 预览版中引入的类似 API,但此 AndroidX 版本的 API 也适用于 API 21 之前的版本。
Graphics Core 版本 1.0
版本 1.0.0
2024 年 5 月 29 日
发布了 androidx.graphics:graphics-core:1.0.0
。版本 1.0.0 中包含这些提交内容。
1.0.0 的主要功能
- 图形核心库的官方稳定版本。从 1.0.0-rc01 中修复了一些次要 bug 并提升了性能
版本 1.0.0-rc01
2024 年 4 月 17 日
发布了 androidx.graphics:graphics-core:1.0.0-rc01
。此版本是在内部分支中开发的。
bug 修复
- 修复了在搭载 Android 14 的某些 Android 设备上导致文件描述符因
CanvasBufferedRendererAPI
发生双重关闭的问题。 - 修复了
FrameBuffer
无法正确删除帧缓冲区实例的问题。
版本 1.0.0-beta01
2023 年 12 月 13 日
发布了 androidx.graphics:graphics-core:1.0.0-beta01
。版本 1.0.0-beta01 中包含这些提交内容。
新功能
- 引入了新的
LowLatencyCanvasView
API,以支持在 View 层次结构中使用 Android 的 2D 图形 API (Canvas + Paint) 进行低延迟渲染。 - 引入了
CanvasBufferedRenderer
API,以支持对HardwareBuffer
进行硬件加速画布渲染。这可用于将界面的一部分绘制到缓冲区中,缓冲区可通过Bitmap.wrapHardwareBuffer
API 转换为位图。
API 变更
- 更新了
CanvasBufferRenderer#releaseBuffer
API,使其具有可选的 fence 参数。更新了文档,说明了何时返回RenderResult#fence
。(If1ea7) - 向
RenderRequest
添加了draw
方法,以支持利用协程调度绘制请求。已将之前使用执行器的绘制方法重命名为drawAsync
。将isClosed()
方法重构为属性。(I5bff6) - 向
CanvasFrontBufferRenderer
公开了缓冲区格式参数,以直接映射到CanvasBufferedRenderer.Builder#setBufferFormat
(I0f272) - 创建了
CanvasBufferedRenderer
API,用于将硬件加速画布渲染处理到HardwareBuffer
中。这提供了一个将实现向后移植到 Android Q 以及配置HardwareBuffers
交换链深度。ColorSpace
配置仍仅限于 Android U 及更高版本,但兼容型实现会代表开发者提供空操作行为。(I9b1d8) - 向
SurfaceControlCompat.Transaction
添加了setFrameRate
/clearFrameRate
API,以便控制帧速率和更改策略,以实现无缝过渡或默认过渡。(I6045c) - 将
setDataSpace
所需的 API 级别从 Android T 降到了 Android Q。(I59c34) - 向
GLFrameBufferRenderer
API 添加了onBufferReleased
回调,使消费者有机会在不再呈现缓冲区时清理状态 (I8a4e2) - 创建
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 中包含这些提交内容。
新功能
- 引入了
GLFrameBufferRenderer
API。它提供了 OpenGL 依赖项、交换链配置、像素格式和SurfaceControl
配置的组合。(Ic775b)
API 变更
- 向各种回调 API 添加了宽度 + 高度参数,以表示
SurfaceHolder#Callbacks
中竖线的尺寸。(I7f9fc) - 添加了清除前缓冲层和多缓冲区层的清晰 API。(Ic1f95)
- 添加了对配置
GLFrontBufferedRenderer
中使用的交换链的底层缓冲区类型的支持。(I07a13) - 为
GLFrameBufferRenderer
的 getter 添加了 kotlin 属性,为最大缓冲区条目添加了IntRange
注解,并为setFormat
/setUsage
添加了HardwareBufferFormart
和HardwareBufferUsage
注解。(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 中包含这些提交内容。
新功能
- 引入了
CanvasFrontBufferedRenderer
,以支持利用android.graphics.Canvas
API 以及现有 OpenGL 实现实现的低延迟图形
API 变更
- 更新了
SurfaceControlCompat.Transaction#setBuffer
API,以允许可为 null 的HardwareBuffer
实例镜像相应的平台 API (I173d7) - 将引用双缓冲区渲染的方法重命名为多缓冲区,因为后备交换链可能包含 2 个以上的缓冲区。(I830d7)
- 创建了
CanvasFrontBufferedRenderer
API,以便 3ps 可通过 Canvas API 利用前端缓冲渲染系统。(Ibfc29)
bug 修复
- 修复了在恢复相应 activity 后
GLFrontBufferedRenderer
无法呈现内容的问题。 - 修复了前端缓冲内容会被过早清除的问题。
- 修复了在低延迟图形 API 发布后不移除
SurfaceHolder.Callbacks
的问题。
版本 1.0.0-alpha03
2023 年 3 月 22 日
发布了 androidx.graphics:graphics-core:1.0.0-alpha03
。版本 1.0.0-alpha03 中包含这些提交内容。
API 变更
- 更新了
GLFrontBufferedRenderer
回调实现,以提供包含缓冲区宽度/高度以及帧缓冲区标识符的BufferInfo
对象,这些标识符可用于在渲染到中间暂存缓冲区后重新定位原始目的地。(I7fe20) - 将
SyncFence
创建合并为SyncFenceCompat
上的静态出厂方法。 - 移除了
eglDupNativeFenceFDANDROID
的公共兼容性方法,取而代之的是用于创建 SyncFence 的SyncFenceCompat
工厂方法。这是为了确保无论 API 级别如何,所有 API Surface 都会收到正确的SyncFence
实现。(I849bb) - 添加了有关
FrameBufferRenderer
和SyncStrategy
的文档。- 将“
FrameBufferRenderer
”“FrameBuffer
”和“FrameBufferPool
”移到了“androidx.graphics.opengl
”软件包 - 将
SyncStrategy
移到了androidx.graphics.opengl
软件包 - 更新了
RenderCallback#onDraw
个文档 - 更新了
RenderCallback#obtainFrameBuffer
的文档,API 实现者负责调用FrameBuffer.close
- 更新了
onDrawComplete
,以指明使用方负责分派要显示的内容 - 将
SyncFence
兼容性接口/类移到了androidx.hardware
软件包,以镜像框架 SyncFence
API 已重命名为SyncFenceV19
,并将其设为不公开,以便将用法整合到SyncFenceCompat
,后者会尽可能利用框架的SyncFence
API。(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 中包含这些提交内容。
API 变更
- 修复了 Android S 中引入的
addTransactionCommitListener
缺少RequiresApi
注解的问题 (I0a035) - 更新了
onDraw<Front/Double>
缓冲区回调,以提供转换矩阵,除了当前缓冲区宽度/高度之外,使用方还可以传递给其顶点着色器。使用方负责使用这些参数正确预旋转其 OpenGL 渲染代码。(I82f9e)
bug 修复
- 通过在发出
SurfaceControl
事务之前预旋转缓冲区,缩短了图形延迟时间。 - 修复了错误日志会显示错误 300d (EGL_BAD_SURFACE) 的问题。
- 修复了
GLFrontBufferedRenderer
在其使用的对应 activity 被恢复后会失效的问题。 - 增加了对模拟器和 ChromeOS 设备的支持。
- 修复了前缓冲层可能会过早隐藏的问题。
版本 1.0.0-alpha01
2022 年 10 月 24 日
发布了 androidx.graphics:graphics-core:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
- 添加了图形核心 AndroidX 库的初始版本。其中包括支持低延迟用例(如触控笔输入)的 API。还引入了一些应用于 OpenGL 的帮助程序 API。
API 变更
- 引入了
GLFrontBufferedRenderer
,用于协助前端和多缓冲区渲染,以实现低延迟和高质量的渲染输出。 - 引入了
GLRenderer
API,用于协助各种 Surface 提供程序(如SurfaceView
、TextureView
等)实现 OpenGL 渲染。