package com.example.datalibrary.view;

import android.graphics.RectF;
import android.view.TextureView;

/**
 * 该类用于实现，图片源(@see ImageSource)数据预览。
 */
public interface PreviewView {
    /**
     * 图片帧缩放类型。
     */
    enum ScaleType {

        /**
         * 宽度与父控件一致，高度自适应
         */
        FIT_WIDTH,
        /**
         * 调试与父控件一致，宽度自适应
         */
        FIT_HEIGHT,
        /**
         * 全屏显示 ，保持显示比例，多余的部分会被裁剪掉。
         */
        CROP_INSIDE,
    }

    TextureView getTextureView();

    /**
     * 设置帧大小。
     *
     * @param width  帧宽度
     * @param height 帧调试
     */
    void setPreviewSize(int width, int height);

    /**
     * 预览View中的坐标映射到，原始图片中。应用场景举例：裁剪框
     *
     * @param rect 预览View中的坐标
     */
    void mapToOriginalRect(RectF rect);

    /**
     * 原始图片中的坐标到预览View坐标中的映射。应用场景举例：预览页面显示人脸框。
     *
     * @param rectF 原始图中的坐标
     */
    void mapFromOriginalRect(RectF rectF);

    /**
     * 设置预览的缩放类型
     *
     * @param scaleType 缩放类型
     */
    void setScaleType(ScaleType scaleType);

    /**
     * 获取预览缩放类型
     *
     * @return 预览缩放类型
     */
    ScaleType getScaleType();

    void setMirrored(boolean mirrored);
}