HarmonyOS NEXT实战：图片放大和缩小

目标：通过两个手指捏合放大和缩小图片

知识点：
捏合手势（PinchGesture）用于触发捏合手势，触发捏合手势的最少手指为2指，最大为5指，最小识别距离为5vp。
接口

PinchGesture(value?:{
   fingers?:number, distance?:number})

捏合手势用于触发捏合手势事件，拥有两个可选参数：

1. fingers：用于声明触发捏合手势所需要的最少手指数量，最小值为2，最大值为5，默认值为2。触发手势手指可以多于fingers数目，但只有先落下的与fingers相同数目的手指参与手势计算。
2. distance：用于声明触发捏合手势的最小距离，单位为vp，默认值为5。说明：取值范围：[0, +∞)，当识别距离的值小于等于0时，会被转化为默认值。

API15新增：
isFingerCountLimited
是否检查触摸屏幕的手指数量。若触摸屏幕的手指数量不等于设置的触发捏合的最少手指数（即上述fingers参数），手势将不会被识别。只有当触摸屏幕的手指数等于设置的触发捏合手势的最小手指数，并且滑动距离满足阈值要求时，手势才能被成功识别（只有先落下的两根手指参与手势计算，若抬起其中的一个，手势识别失败）。对于已经成功识别的手势，后续改变触摸屏幕的手指数量，将不会触发onActionUpdate事件，但可以触发onActionEnd事件。默认值：false。

事件

onActionStart(event:(event: GestureEvent) => void)    //Pinch手势识别成功回调。
onActionUpdate(event:(event: GestureEvent) => void)    //Pinch手势移动过程中回调。
onActionEnd(event:(event: GestureEvent) => void)    //Pinch手势识别成功，手指抬起后触发回调。
onActionCancel(event: () => void)    //Pinch手势识别成功，接收到触摸取消事件触发回调。

属性
tag：设置Pinch手势标志，用于自定义手势判定时区分绑定的手势。
allowedTypes：设置Pinch手势支持的事件输入源。

实战：ImageEnlargementReductionDemoPage

@Entry
@Component
struct ImageEnlargementReductionDemoPage {
   
  @State scaleValue: number = 1;
  @State pinchValue: number = 1;
  @State pinchX: number = 0;
  @State pinchY: number = 0;

  build() {
   
    Stack({
    alignContent: Alignment.Top }) {
   
      Image('https://pica.zhimg.com/v2-764199c9470ff436082f35610f1f81f4_1440w.jpg')
        .width('100%')
          // 在组件上绑定缩放比例，可以通过修改缩放比例来实现组件的缩小或者放大
        .scale({
    x: this.scaleValue, y: this.scaleValue, z: 1 })
        .gesture(
          // 在组件上绑定2指触发的捏合手势
          PinchGesture({
    fingers: 2 })
            .onActionStart((event: GestureEvent | undefined) => {
   
              console.info('Pinch start');
            })
              // 当捏合手势触发时，可以通过回调函数获取缩放比例，从而修改组件的缩放比例
            .onActionUpdate((event: GestureEvent | undefined) => {
   
              if (event) {
   
                this.scaleValue = this.pinchValue * event.scale;
                this.pinchX = event.pinchCenterX;
                this.pinchY = event.pinchCenterY;
              }
            })
            .onActionEnd(() => {
   
              this.pinchValue = this.scaleValue;
              console.info('Pinch end');
            })
        )

      Text('图片放大缩小Demo')
        .fontColor(Color.Orange)
        .fontSize(24)
    }
    .width('100%')
    .height('100%')
  }
}