// ImageEditorActivity.kt 中的圖片加載方法
privatefun loadImages(mediaFiles: List<MediaFile>) {
    GlobalScope.launch(Dispatchers.IO) {
        val bitmapPairs = mediaFiles.mapNotNull { imageFile ->
            try {
                val bitmap = loadBitmap(imageFile)
                if (bitmap != null) {
                    Pair(bitmap, imageFile.uri.toString())
                } elsenull
            } catch (e: Exception) {
                e.printStackTrace()
                null
            }
        }
        withContext(Dispatchers.Main) {
            imagePagerAdapter.setImages(bitmapPairs)
        }
    }
}

// ImageEditorView.kt 中的圖片初始化
fun setImageWithPath(bitmap: Bitmap, imagePath: String) {
    // ...
    
    // 計算縮放比例以適應視圖
    val viewWidth = width.toFloat()
    val viewHeight = height.toFloat()
    val bitmapWidth = bitmap.width.toFloat()
    val bitmapHeight = bitmap.height.toFloat()

    // 確保圖片完全適應視圖，不會被裁剪
    val scale = (viewWidth / bitmapWidth).coerceAtMost(viewHeight / bitmapHeight)

    // 計算居中位置
    val dx = (viewWidth - bitmapWidth * scale) / 2
    val dy = (viewHeight - bitmapHeight * scale) / 2
    imageMatrix.reset()
    imageMatrix.setScale(scale, scale)
    imageMatrix.postTranslate(dx, dy)
    
    // ...
}

// ImageEditorView.kt 中的繪制方法
overridefun onDraw(canvas: Canvas) {
    super.onDraw(canvas)
    canvas.save()
    // 繪制圖片
    imageBitmap?.let { bitmap ->
        canvas.drawBitmap(bitmap, imageMatrix, imgPaint)
    }

    // 繪制選擇框
    selectionBoxes.forEach { box ->
        box.draw(canvas)
    }
    canvas.restore()
}

// ImageEditorView.kt 中的觸摸事件處理
overridefun onTouchEvent(event: MotionEvent): Boolean {
    // 檢測多點觸摸，如果是多點觸摸則忽略
    if (event.pointerCount > 1) {
        // 如果有正在繪制的臨時框線，則將其移除
        if (tempBox != null) {
            selectionBoxes.remove(tempBox)
            tempBox = null
            invalidate()
        }
        returnfalse
    }
    
    // 獲取圖片的實際變換矩陣
    val inverseMatrix = Matrix()
    imageMatrix.invert(inverseMatrix)

    // 將觸摸點坐標轉換到圖片空間
    val points = floatArrayOf(event.x, event.y)
    inverseMatrix.mapPoints(points)
    val rotatedX = points[0]
    val rotatedY = points[1]

    when (event.action) {
        MotionEvent.ACTION_DOWN -> {
            // 記錄初始觸摸位置，用于后續判斷是點擊還是拖動
            initialTouchX = event.x
            initialTouchY = event.y
            
            // 檢查是否點擊了某個框線
            selectedBox = findTouchedBox(event.x, event.y)
            // ...處理框線選擇或創建新框線
        }
        MotionEvent.ACTION_MOVE -> {
            // 處理移動事件
        }
        MotionEvent.ACTION_UP -> {
            // 處理抬起事件，判斷點擊或拖動
            val moveDistance = sqrt(
                (event.x - initialTouchX).toDouble().pow(2.0) +
                (event.y - initialTouchY).toDouble().pow(2.0)
            ).toFloat()
            
            // 根據移動距離判斷是點擊還是拖動
            if (moveDistance < CLICK_THRESHOLD) {
                // 處理點擊事件
            } else {
                // 處理拖動操作
            }
        }
    }
    returntrue
}

// ImageEditorView.kt 中的旋轉方法
privatefun rotateImage(degrees: Float) {
    val animator = ObjectAnimator.ofFloat(0f, 1f)
    animator.duration = 300
    animator.addUpdateListener { animation ->
        val fraction = animation.animatedValue asFloat
        currentRotation = startRotation + degrees * fraction
        
        // 應用變換矩陣
        // ...
        
        invalidate()
    }
    animator.start()
}

// ImageEditorView.kt 中的SelectionBox內部類
inner class SelectionBox(
    var rect: RectF,
    val context: Context,
    var paint: Paint = Paint().apply {
        style = Paint.Style.STROKE
        color = currentBorderColor
        strokeWidth = DisplayUtils.dpToPx(context, 3f)
    },
    var rotation: Float = currentRotation,  // 初始化時使用當前圖片的旋轉角度
    var initialRect: RectF = RectF(rect)  // 用于記錄移動前的位置
) {
    //...
}

// SelectionBox 中的位置更新方法
fun updatePosition(x: Float, y: Float) {
    // 獲取圖片的實際變換矩陣
    val inverseMatrix = Matrix()
    imageMatrix.invert(inverseMatrix)

    // 將觸摸點坐標轉換到圖片空間
    val touchPoints = floatArrayOf(x, y)
    inverseMatrix.mapPoints(touchPoints)
    val px = touchPoints[0]
    val py = touchPoints[1]

    // 獲取圖片的邊界
    val bitmapWidth = imageBitmap?.width?.toFloat() ?: 0f
    val bitmapHeight = imageBitmap?.height?.toFloat() ?: 0f

    // 限制坐標在圖片邊界內
    val boundedPx = px.coerceIn(0f, bitmapWidth)
    val boundedPy = py.coerceIn(0f, bitmapHeight)
    
    // 根據操作類型更新框線位置
    if (!isDragging) {
        // 調整框線大小
        // ...
    } else {
        // 移動整個框線
        // ...
    }
}

// ImageEditorView.kt 中的操作接口和具體實現
interface Operation {
    fun undo()
    fun redo()
}

class CreateOperation(privateval box: SelectionBox,
                     privateval boxes: MutableList<SelectionBox>) : Operation {
    overridefun redo() {
        if (!boxes.contains(box)) boxes.add(box)
    }
    
    overridefun undo() {
        boxes.remove(box)
    }
}

class MoveOperation(
    privateval box: SelectionBox,
    privateval oldRect: RectF,
    privateval newRect: RectF
) : Operation {
    overridefun redo() {
        box.rect.set(newRect)
    }
    
    overridefun undo() {
        box.rect.set(oldRect)
    }
}

class DeleteOperation(privateval box: SelectionBox,
                     privateval boxes: MutableList<SelectionBox>) : Operation {
    overridefun redo() {
        boxes.remove(box)
    }
    
    overridefun undo() {
        if (!boxes.contains(box)) boxes.add(box)
    }
}

// ImageEditorView.kt 中的添加操作方法
private fun addOperation(operation: Operation) {
    while (operationHistory.size > currentHistoryIndex + 1) {
        operationHistory.removeAt(operationHistory.size - 1)
    }
    operationHistory.add(operation)
    currentHistoryIndex++

    // 通知監聽器操作狀態已變化
    operationStateChangeListener?.onOperationStateChanged()
}

// ImageEditorActivity.kt 中的ViewPager2初始化
private fun initViews() {
    // 初始化ViewPager2
    viewPager = findViewById(R.id.media_picker_image_pager)
    imagePagerAdapter = ImageEditorPagerAdapter()
    viewPager.adapter = imagePagerAdapter
    // 禁用ViewPager的滑動
    viewPager.isUserInputEnabled = false
    // 設置ViewPager的頁面限制，避免頁面被銷毀
    viewPager.offscreenPageLimit = selectedImages?.size ?: 10
    
    // ...設置各種監聽器
}

// ImageEditorActivity.kt 中的RecyclerView初始化
privatefun initViews() {
    // ...ViewPager2初始化
    
    // 初始化RecyclerView
    recyclerView = findViewById<RecyclerView>(R.id.media_picker_image_list)
    recyclerView.layoutManager =
        LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)
    imageListAdapter = ImageListAdapter()
    recyclerView.adapter = imageListAdapter

    // 設置圖片選擇監聽器
    imageListAdapter.setOnImageSelectedListener { position ->
        viewPager.currentItem = position
    }
}

// ImageEditorView.kt 中的狀態保存與恢復
fun setImageWithPath(bitmap: Bitmap, imagePath: String) {
    // 保存當前圖片的狀態
    currentImagePath?.let { path ->
        imageSelectionStates[path] = ImageState(
            selectionBoxes = selectionBoxes.toList(),
            rotation = currentRotation,
            matrix = Matrix(imageMatrix),
            borderColor = currentBorderColor
        )
    }

    // 清除當前狀態
    imageBitmap = bitmap
    currentImagePath = imagePath

    // 恢復圖片狀態或初始化新狀態
    val state = imageSelectionStates[imagePath]
    if (state != null) {
        selectionBoxes.clear()
        selectionBoxes.addAll(state.selectionBoxes)
        currentRotation = state.rotation
        imageMatrix = Matrix(state.matrix)
        currentBorderColor = state.borderColor
    } else {
        // 初始化新狀態
        // ...
    }
}

// 禁用ViewPager的滑動，改用底部縮略圖導航
viewPager.isUserInputEnabled = false

// 檢測多點觸摸，如果是多點觸摸則忽略編輯操作
if (event.pointerCount > 1) {
    if (tempBox != null) {
        selectionBoxes.remove(tempBox)
        tempBox = null
        invalidate()
    }
    return false
}

// 屏幕坐標轉圖片坐標
val inverseMatrix = Matrix()
imageMatrix.invert(inverseMatrix)
val points = floatArrayOf(event.x, event.y)
inverseMatrix.mapPoints(points)
val imageX = points[0]
val imageY = points[1]

// 旋轉處理
imageMatrix.postRotate(currentRotation, viewWidth / 2, viewHeight / 2)

[x']   [a b c]   [x]
[y'] = [d e f] × [y]
[1 ]   [0 0 1]   [1]