rotate_zh.md

旋转

翻译：English

Tip

• 以下示例优先用 Compose 版本的组件来演示
• ZoomState.zoomable 等价于 ZoomImageView.zoomable
• ZoomState.subsampling 等价于 ZoomImageView.subsampling

rotate()

ZoomImage 提供了 rotate() 方法用来旋转图像到指定角度，它有一个参数：

• targetRotation: Int：目标旋转角度，它只能是 90 的倍数，比如 0、90、180、270、360 等

示例：

val zoomState: ZoomState by rememberZoomState()

SketchZoomAsyncImage(
    imageUri = "https://sample.com/sample.jpeg",
    contentDescription = "view image",
    modifier = Modifier.fillMaxSize(),
    zoomState = zoomState,
)

val coroutineScope = rememberCoroutineScope()
Button(
    onClick = {
        coroutineScope.launch {
            val targetRotation = zoomState.zoomable.transform.rotation.roundToInt() + 90
            zoomState.zoomable.rotate(targetRotation = targetRotation)
        }
    }
) {
    Text(text = "right rotate 90")
}

Button(
    onClick = {
        coroutineScope.launch {
            val targetRotation = zoomState.zoomable.transform.rotation.roundToInt() - 90
            zoomState.zoomable.rotate(targetRotation = targetRotation)
        }
    }
) {
    Text(text = "left rotate 90")
}

可访问属性

// compose
val zoomState: ZoomState by rememberZoomState()
SketchZoomAsyncImage(zoomState = zoomState)
val zoomable: ZoomableState = zoomState.zoomable

// view
val sketchZoomImageView = SketchZoomImageView(context)
val zoomable: ZoomableEngine = sketchZoomImageView.zoomable

注意：view 版本的相关属性用 StateFlow 包装，所以其名字相比 compose 版本都以 State 为后缀

• zoomable.transform.rotation: Float: 当前旋转角度（基础旋转角度 + 用户旋转角度）
• zoomable.baseTransform.rotation: Float: 当前基础旋转角度，受 rotate() 方法影响
• zoomable.userTransform.rotation: Float: 当前用户旋转角度，一直为 0

监听属性变化

• compose 版本的相关属性是用 State 包装的，在 Composable 函数中直接读取它即可实现监听
• view 的相关属性是用 StateFlow 包装，调用其 collect 函数即可实现监听