# PointPredictor（报点预测功能）

> phone 5.0.0(12)+ | 2in1 5.0.1(13)+ | tablet 5.0.0(12)+

本模块提供报点预测能力。通过调用报点预测接口，可以优化应用中手写效果的绘制跟手性，提升应用中手写笔书写场景的跟手体验。

**起始版本：** 5.0.0(12)

## 导入模块

```typescript
import { PointPredictor } from '@kit.Penkit';
```

本模块提供以下方法。

|方法名称|说明|
|:----------------------------------------|:-------|
|[getPredictionPoint](#getpredictionpoint)|获取预测点信息。|

## getPredictionPoint

getPredictionPoint(event: TouchEvent): TouchPoint

获取预测点信息。

**模型约束：** 此接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.Stylus.Handwrite

**起始版本：** 5.0.0(12)

**参数：**

|**参数名**|**类型**|必填|**说明**|
|:------|:-----------------------------------------------------------------------------------------------------------------------|:-|:-----|
|event|[TouchEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-events-touch#touchevent对象说明)|是|当前点信息。|

**返回值：**

|类型|说明|
|:----------------------------------------------------------------------------------------------------|:-----|
|[TouchPoint](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-types#touchpoint11)|预测点信息。|

**示例：**

```typescript
import { PointPredictor } from '@kit.Penkit';

@Entry
@Component
struct PointPredictorDemo {
  @State actualXCoordinate: number = 0;
  @State actualYCoordinate: number = 0;
  @State predictorXCoordinate: Dimension = 0;
  @State predictorYCoordinate: Dimension = 0;
  pointPredictor: PointPredictor = new PointPredictor();

  aboutToAppear() {
    console.info('getPredictionPoint aboutToAppear');
  }

  aboutToDisappear() {
    console.info('getPredictionPoint aboutToDisappear');
  }

  build() {
    Stack({ alignContent: Alignment.TopEnd }) {
      this.canvas(); // 画布。
    }.height('100%').width('100%')
  }

  // 画布
  @Builder
  canvas() {
    Column() {
      Text('实际点坐标： X: ' + this.actualXCoordinate + ' Y: ' + this.actualYCoordinate).textAlign(TextAlign.Start)
      Text('预测点坐标： X: ' + this.predictorXCoordinate + ' Y: ' + this.predictorYCoordinate)
        .textAlign(TextAlign.Start)
    }.position({ x: 0, y: 0 })
    .alignItems(HorizontalAlign.Start)

    Stack()
      .width('100%')
      .height('100%')
      .onTouch((event: TouchEvent) => {
        switch (event.type) {
          case TouchType.Down: // 按下时，新建一条画图路径。
            break;
          case TouchType.Move: // 使用预测算法进行预测，获得预测点。
            let point = this.pointPredictor?.getPredictionPoint(event);
            this.actualXCoordinate = event.touches[0]?.x;
            this.actualYCoordinate = event.touches[0]?.y;
            this.predictorXCoordinate = point?.x;
            this.predictorYCoordinate = point?.y;
            console.info('pointPredictor 实际点坐标 x:' + event.touches[0]?.x + ' y:' + event.touches[0]?.y);
            console.info('pointPredictor 预测点坐标 x:' + point?.x + '  y:' + point?.y);
            break;
          case TouchType.Up:
            break;
        }
      })
  }
}
```