将图像裁剪成特定形状

您可以将图像适配到裁剪后的形状中,并在形状周围绘制阴影,以呈现立体感。此技术对于创建头像和产品缩略图等设计,或显示自定义形状的徽标非常有用。

要显示裁剪成特定形状的图像,您必须执行以下操作

  • 创建形状。
  • 将图像裁剪到形状中。

版本兼容性

此实现要求您的项目 minSDK 设置为 API 级别 21 或更高。

依赖项

创建形状

以下代码创建了一个自定义形状,该形状可以动态绘制和渲染圆角多边形

fun RoundedPolygon.getBounds() = calculateBounds().let { Rect(it[0], it[1], it[2], it[3]) }
class RoundedPolygonShape(
    private val polygon: RoundedPolygon,
    private var matrix: Matrix = Matrix()
) : Shape {
    private var path = Path()
    override fun createOutline(
        size: Size,
        layoutDirection: LayoutDirection,
        density: Density
    ): Outline {
        path.rewind()
        path = polygon.toPath().asComposePath()
        matrix.reset()
        val bounds = polygon.getBounds()
        val maxDimension = max(bounds.width, bounds.height)
        matrix.scale(size.width / maxDimension, size.height / maxDimension)
        matrix.translate(-bounds.left, -bounds.top)

        path.transform(matrix)
        return Outline.Generic(path)
    }
}

关于代码的关键点

  • RoundedPolygon.getBounds()RoundedPolygon 类上定义了一个扩展函数,用于计算其边界。
  • RoundedPolygonShape 类实现了 Shape 接口,您可以在 Jetpack Compose 中定义自定义形状(圆角多边形)。
  • 该形状使用 Matrix 来管理缩放和平移操作,以实现灵活渲染。
  • createOutline() 函数接受一个 RoundedPolygon 对象,对其进行缩放和平移以适应给定大小,并返回一个描述要绘制的最终形状的 Outline 对象。

将图像裁剪到形状中

以下代码将图像裁剪成六边形,并添加细微的投影,以提供深度感

val hexagon = remember {
    RoundedPolygon(
        6,
        rounding = CornerRounding(0.2f)
    )
}
val clip = remember(hexagon) {
    RoundedPolygonShape(polygon = hexagon)
}
Box(
    modifier = Modifier
        .clip(clip)
        .background(MaterialTheme.colorScheme.secondary)
        .size(200.dp)
) {
    Text(
        "Hello Compose",
        color = MaterialTheme.colorScheme.onSecondary,
        modifier = Modifier.align(Alignment.Center)
    )
}

关于代码的关键点

  • RoundedPolygonRoundedPolygonShape 对象用于定义六边形形状并将其应用于图像。
  • 代码使用 graphicsLayer 为图像添加基于高度的阴影。这会产生深度感,并使图像在视觉上与背景分离。
  • 使用 remember 块可优化性能,确保形状和裁剪定义仅计算一次,并在后续界面重新组合时记住。

结果

Dog in hexagon with shadow applied around the edges
图 1. 将自定义形状应用于裁剪。

包含此指南的合集

此指南是这些精选快速指南合集的一部分,这些合集涵盖了更广泛的 Android 开发目标

探索使用明亮、引人入胜的视觉效果为您的 Android 应用赋予精美外观的技术。

有问题或反馈?

前往我们的常见问题页面,了解快速指南,或联系我们,让我们知道您的想法。