Compose笔记(二十三)--多点触控

这一节主要了解一下Compose中多点触控,在Jetpack Compose 中,多点触控处理需要结合Modifier和手势API来实现,一般通过组合 pointerInput、TransformableState 和 TransformModifier 来创建支持缩放、旋转和平移的组件。

一、 API

  1. PointerInput

含义:处理低级触摸事件的主要API,支持多点触控。

用法:通过pointerInput修饰符拦截和处理触摸事件。

  1. TransformableState

含义:管理变换状态(缩放、旋转、平移)的状态容器。

用法:与transformable修饰符结合,监听手势并更新变换值。

  1. TransformModifier

含义:应用变换效果(缩放、旋转、平移)的修饰符。

用法:通过graphicsLayer或transformable应用变换。
二、关键类与接口

  1. PointerInputScope

提供处理触摸事件的作用域,包含:

detectDragGestures:处理单指拖拽。

detectTransformGestures:处理双指缩放 / 旋转。

detectTapGestures:处理点击事件。

  1. TransformScope

在detectTransformGestures中提供:

panChange:平移变化量。

zoomChange:缩放变化量。

rotationChange:旋转变化量。

  1. Transformation

包含三个变换参数:

scale:缩放因子。

rotation:旋转角度。

offset:平移偏移量。

栗子:

  1. 单指拖拽
Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectDragGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.size
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.consumeAllChanges
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.unit.dp
import com.example.composenavigationdemo.R

@Composable
fun TestImage() {
    var offset by remember { mutableStateOf(Offset.Zero) }

    Box(
        modifier = Modifier
            .size(200.dp)
            .background(Color.LightGray)
            .pointerInput(Unit) {
                detectDragGestures { change, dragAmount ->
                    // 阻止事件冒泡
                    change.consumeAllChanges()
                    // 更新偏移量
                    offset = offset + dragAmount
                }
            }
            .graphicsLayer {
                translationX = offset.x
                translationY = offset.y
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier.fillMaxSize()
        )
    }
}
  1. 双指缩放与旋转
Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectTransformGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import com.example.composenavigationdemo.R

@Composable
fun TestImage() {
    var scale by remember { mutableStateOf(1f) }
    var rotation by remember { mutableStateOf(0f) }
    var offset by remember { mutableStateOf(Offset.Zero) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.LightGray)
            .pointerInput(Unit) {
                detectTransformGestures { centroid, pan, zoom, rotationChange ->
                    // 更新变换参数
                    scale = (scale * zoom).coerceIn(0.5f, 5f)
                    rotation += rotationChange
                    offset = centroid
                }
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier
                .align(Alignment.Center)
                .graphicsLayer {
                    scaleX = scale
                    scaleY = scale
                    rotationZ = rotation
                    translationX = offset.x - size.width / 2
                    translationY = offset.y - size.height / 2
                }
        )
    }
}

3 组合多种手势

Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectDragGestures
import androidx.compose.foundation.gestures.detectTransformGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import com.example.composenavigationdemo.R
import kotlinx.coroutines.coroutineScope
import kotlinx.coroutines.launch

@Composable
fun TestImage() {
    var scale by remember { mutableStateOf(1f) }
    var rotation by remember { mutableStateOf(0f) }
    var offset by remember { mutableStateOf(Offset.Zero) }
    var isDragging by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.LightGray)
            .pointerInput(Unit) {
                coroutineScope {
                    launch {
                      
                        detectDragGestures(
                            onDragStart = { isDragging = true },
                            onDragEnd = { isDragging = false }
                        ) { change, dragAmount ->
                            offset += dragAmount
                        }
                    }

                    launch {
                  
                        detectTransformGestures(
                            panZoomLock = true
                        ) { _, pan, zoom, rotationChange ->
                            scale *= zoom
                            rotation += rotationChange
                            offset += pan
                        }
                    }
                }
            }
            .graphicsLayer {
                scaleX = scale
                scaleY = scale
                rotationZ = rotation
                translationX = offset.x
                translationY = offset.y
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier.align(Alignment.Center)
        )
    }
}

注意:

1 事件消费:通过change.consumeAllChanges()阻止事件冒泡。

2 坐标系转换:注意centroid(双指中心点)和offset的坐标系差异。

3 状态管理:使用remember保存变换状态,确保配置变更后状态恢复。

相关推荐
kfepiza2 分钟前
Debian的`/etc/network/interfaces`的`allow-hotplug`和`auto`对比讲解 笔记250704
linux·服务器·网络·笔记·debian
alexhilton14 分钟前
为什么你的App总是忘记所有事情
android·kotlin·android jetpack
刘龙超2 小时前
如何应对 Android 面试官 -> 玩转 Jetpack DataBinding
android jetpack
I'm写代码3 小时前
el-tree树形结构笔记
javascript·vue.js·笔记
Andy杨4 小时前
20250707-4-Kubernetes 集群部署、配置和验证-K8s基本资源概念初_笔记
笔记·容器·kubernetes
UQI-LIUWJ7 小时前
李宏毅LLM笔记: AI Agent
人工智能·笔记
ouliten7 小时前
cuda编程笔记(6)--流
笔记
Love__Tay7 小时前
笔记/云计算基础
笔记·学习·云计算
李元豪8 小时前
【行云流水ai笔记】粗粒度控制:推荐CTRL、GeDi 细粒度/多属性控制:推荐TOLE、GPT-4RL
人工智能·笔记
特种加菲猫9 小时前
指尖上的魔法:优雅高效的Linux命令手册
linux·笔记