เอาต์พุตของกรณีการใช้งาน CameraX คือ 2 ส่วน ได้แก่ บัฟเฟอร์และข้อมูลการเปลี่ยนรูปแบบ บัฟเฟอร์คือไบต์อาร์เรย์และข้อมูลการเปลี่ยนรูปแบบคือวิธีครอบตัดและหมุนบัฟเฟอร์ก่อนที่จะแสดงต่อผู้ใช้ปลายทาง วิธีนำการเปลี่ยนรูปแบบไปใช้จะขึ้นอยู่กับรูปแบบของบัฟเฟอร์
ImageCapture
สําหรับ Use Case ImageCapture
ระบบจะใช้บัฟเฟอร์สี่เหลี่ยมผืนผ้าครอบตัดก่อนบันทึกลงในดิสก์ และบันทึกการหมุนไว้ในข้อมูล Exif แอปไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม
แสดงตัวอย่าง
สําหรับ Use Case Preview
คุณสามารถรับข้อมูลการเปลี่ยนรูปแบบได้โดยเรียกใช้ SurfaceRequest.setTransformationInfoListener()
ทุกครั้งที่มีการอัปเดตการเปลี่ยนรูปแบบ ผู้เรียกจะได้รับออบเจ็กต์ SurfaceRequest.TransformationInfo
ใหม่
วิธีใช้ข้อมูลการเปลี่ยนรูปแบบจะขึ้นอยู่กับแหล่งที่มาของ Surface
และมักจะซับซ้อน หากเป้าหมายคือการแสดงตัวอย่างเท่านั้น ให้ใช้ PreviewView
PreviewView
คือมุมมองที่กําหนดเองซึ่งจัดการการเปลี่ยนรูปแบบโดยอัตโนมัติ สำหรับการใช้งานขั้นสูง เมื่อคุณต้องแก้ไขสตรีมตัวอย่าง เช่น ด้วย OpenGL ให้ดูตัวอย่างโค้ดในแอปทดสอบหลัก CameraX
เปลี่ยนรูปแบบพิกัด
งานทั่วไปอีกอย่างหนึ่งคือการทำงานกับพิกัดแทนบัฟเฟอร์ เช่น การวาดกล่องรอบๆ ใบหน้าที่ตรวจพบในหน้าตัวอย่าง ในกรณีเช่นนี้ คุณจะต้องแปลงพิกัดของใบหน้าที่ตรวจพบจากการวิเคราะห์รูปภาพเพื่อดูตัวอย่าง
ข้อมูลโค้ดต่อไปนี้จะสร้างเมทริกซ์ที่แมปจากพิกัดการวิเคราะห์รูปภาพกับพิกัด PreviewView
หากต้องการเปลี่ยนรูปแบบพิกัด (x, y) ด้วย Matrix
โปรดดูMatrix.mapPoints()
Kotlin
fun getCorrectionMatrix(imageProxy: ImageProxy, previewView: PreviewView) : Matrix { val cropRect = imageProxy.cropRect val rotationDegrees = imageProxy.imageInfo.rotationDegrees val matrix = Matrix() // A float array of the source vertices (crop rect) in clockwise order. val source = floatArrayOf( cropRect.left.toFloat(), cropRect.top.toFloat(), cropRect.right.toFloat(), cropRect.top.toFloat(), cropRect.right.toFloat(), cropRect.bottom.toFloat(), cropRect.left.toFloat(), cropRect.bottom.toFloat() ) // A float array of the destination vertices in clockwise order. val destination = floatArrayOf( 0f, 0f, previewView.width.toFloat(), 0f, previewView.width.toFloat(), previewView.height.toFloat(), 0f, previewView.height.toFloat() ) // The destination vertexes need to be shifted based on rotation degrees. The // rotation degree represents the clockwise rotation needed to correct the image. // Each vertex is represented by 2 float numbers in the vertices array. val vertexSize = 2 // The destination needs to be shifted 1 vertex for every 90° rotation. val shiftOffset = rotationDegrees / 90 * vertexSize; val tempArray = destination.clone() for (toIndex in source.indices) { val fromIndex = (toIndex + shiftOffset) % source.size destination[toIndex] = tempArray[fromIndex] } matrix.setPolyToPoly(source, 0, destination, 0, 4) return matrix }
Java
Matrix getMappingMatrix(ImageProxy imageProxy, PreviewView previewView) { Rect cropRect = imageProxy.getCropRect(); int rotationDegrees = imageProxy.getImageInfo().getRotationDegrees(); Matrix matrix = new Matrix(); // A float array of the source vertices (crop rect) in clockwise order. float[] source = { cropRect.left, cropRect.top, cropRect.right, cropRect.top, cropRect.right, cropRect.bottom, cropRect.left, cropRect.bottom }; // A float array of the destination vertices in clockwise order. float[] destination = { 0f, 0f, previewView.getWidth(), 0f, previewView.getWidth(), previewView.getHeight(), 0f, previewView.getHeight() }; // The destination vertexes need to be shifted based on rotation degrees. // The rotation degree represents the clockwise rotation needed to correct // the image. // Each vertex is represented by 2 float numbers in the vertices array. int vertexSize = 2; // The destination needs to be shifted 1 vertex for every 90° rotation. int shiftOffset = rotationDegrees / 90 * vertexSize; float[] tempArray = destination.clone(); for (int toIndex = 0; toIndex < source.length; toIndex++) { int fromIndex = (toIndex + shiftOffset) % source.length; destination[toIndex] = tempArray[fromIndex]; } matrix.setPolyToPoly(source, 0, destination, 0, 4); return matrix; }