FaceStylizer

lớp cuối cùng công khai FaceStylizer

Thực hiện cách điệu khuôn mặt trên hình ảnh.

Lưu ý rằng, ngoài API cách điệu tiêu chuẩn, stylize(MPImage) và ERROR(/#stylizeForVideo), dùng để chụp ảnh đầu vào và trả về kết quả đầu ra, nhưng bao gồm cả bản sao sâu của dữ liệu trả về, FaceStylizer cũng hỗ trợ API callback (gọi lại) stylizeWithResultListener(MPImage) và ERROR(/#stylizeForVideoWithResultListener), cho phép bạn truy cập dữ liệu đầu ra thông qua bản sao 0 trong suốt thời gian của trình nghe kết quả.

API gọi lại có sẵn cho tất cả RunningMode trong FaceStylizer. Đặt OutputHandler.ResultListener trong FaceStylizer.FaceStylizerOptions đúng cách để sử dụng API callback.

API yêu cầu phiên bản TFLite sẽ có Siêu dữ liệu mô hình TFLite.

  • Hình ảnh đầu vào MPImage
    • Hình ảnh mà trình cách điệu khuôn mặt chạy trên đó.
  • Đầu ra MPImage MPImage
    • Một MPImage chứa một khuôn mặt cách điệu.

Lớp lồng ghép

lớp FaceStylizer.FaceStylizerOptions Các tuỳ chọn để thiết lập FaceStylizer. 

Phương thức công khai

tĩnh FaceStylizer
createFromOptions(Ngữ cảnh theo bối cảnh, FaceStylizer.FaceStylizerOptions stylizerOptions)
Tạo một thực thể FaceStylizer từ FaceStylizer.FaceStylizerOptions.
FaceStylizerResult
cách điệu hoá(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp.
FaceStylizerResult
cách điệu hoá(hình ảnh MPImage)
Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
void
stylizeWithResultListener(hình ảnh MPImage)
Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là
void
stylizeWithResultListener(hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)
Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong FaceStylizer.FaceStylizerOptions.

Các phương thức kế thừa

Phương thức công khai

công khai tĩnh FaceStylizer createFromOptions (Ngữ cảnh theo bối cảnh, FaceStylizer.FaceStylizerOptions stylizerOptions)

Tạo một thực thể FaceStylizer từ FaceStylizer.FaceStylizerOptions.

Thông số
bối cảnh một ERROR(/Context) trên Android.
stylizerOptions một thực thể FaceStylizer.FaceStylizerOptions.
Gửi
nếu có lỗi trong quá trình tạo FaceStylizer.

công khai FaceStylizerResult cách điệu (MPImage hình ảnh, ImageProcessingOptions imageprocessingOptions)

Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp. Chỉ sử dụng phương thức này khi FaceStylizer được tạo bằng RunningMode.IMAGE.

FaceStylizer hỗ trợ các loại hệ màu sau:

Hình ảnh nhập vào có thể có kích thước bất kỳ. Hình ảnh đầu ra là hình ảnh cách điệu có khuôn mặt hiển thị nhiều nhất. Kích thước hình ảnh đầu ra cách điệu giống với kích thước đầu ra của mô hình. Khi không phát hiện khuôn mặt nào trên hình ảnh nhập vào, hàm sẽ trả về Optional.empty().

Thông số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
imageProcessingOptions ImageProcessingOptions xác định cách xử lý hình ảnh đầu vào trước khi chạy suy luận. Lưu ý rằng tác vụ này không hỗ trợ khu vực quan tâm: việc chỉ định ImageProcessingOptions.regionOfInterest() sẽ dẫn đến việc phương thức này gửi một IllegalArgumentException.
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ. Hoặc nếu FaceStylizer được tạo bằng OutputHandler.ResultListener.

công khai FaceStylizerResult cách điệu (MPImage)

Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp bằng các tuỳ chọn xử lý hình ảnh mặc định, tức là không áp dụng chế độ xoay nào. Chỉ sử dụng phương thức này khi FaceStylizer được tạo bằng RunningMode.IMAGE.

FaceStylizer hỗ trợ các loại hệ màu sau:

Hình ảnh nhập vào có thể có kích thước bất kỳ. Hình ảnh đầu ra là hình ảnh cách điệu có khuôn mặt hiển thị nhiều nhất. Kích thước hình ảnh đầu ra cách điệu giống với kích thước đầu ra của mô hình. Khi không phát hiện khuôn mặt nào trên hình ảnh nhập vào, hàm sẽ trả về Optional.empty().

Thông số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
Gửi
nếu có lỗi nội bộ. Hoặc nếu FaceStylizer được tạo bằng OutputHandler.ResultListener.

công khai trống stylizeWithResultListener (hình ảnh MPImage)

Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp với các tuỳ chọn xử lý hình ảnh mặc định, tức là không áp dụng chế độ xoay và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong FaceStylizer.FaceStylizerOptions. Chỉ sử dụng phương thức này khi FaceStylizer được tạo bằng RunningMode.IMAGE.

FaceStylizer hỗ trợ các loại hệ màu sau:

Hình ảnh nhập vào có thể có kích thước bất kỳ. Hình ảnh đầu ra là hình ảnh cách điệu có khuôn mặt hiển thị nhiều nhất. Kích thước hình ảnh đầu ra cách điệu giống với kích thước đầu ra của mô hình. Khi không phát hiện khuôn mặt nào trên hình ảnh nhập vào, hàm sẽ trả về Optional.empty().

Thông số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ. Hoặc nếu FaceStylizer không được tạo bằng OutputHandler.ResultListener được đặt trong FaceStylizer.FaceStylizerOptions.

công khai void stylizeWithResultListener (Hình ảnh MPImage, ImageProcessingOptions imageprocessingOptions)

Thực hiện cách điệu khuôn mặt trên một hình ảnh được cung cấp và cung cấp kết quả không sao chép thông qua OutputHandler.ResultListener trong FaceStylizer.FaceStylizerOptions. Chỉ sử dụng phương thức này khi FaceStylizer được tạo bằng RunningMode.IMAGE.

FaceStylizer hỗ trợ các loại hệ màu sau:

Hình ảnh nhập vào có thể có kích thước bất kỳ. Hình ảnh đầu ra là hình ảnh cách điệu có khuôn mặt hiển thị nhiều nhất. Kích thước hình ảnh đầu ra cách điệu giống với kích thước đầu ra của mô hình. Khi không phát hiện khuôn mặt nào trên hình ảnh nhập vào, hàm sẽ trả về Optional.empty().

Thông số
hình ảnh một đối tượng MPImage MediaPipe để xử lý.
imageProcessingOptions ImageProcessingOptions xác định cách xử lý hình ảnh đầu vào trước khi chạy suy luận. Lưu ý rằng tác vụ này không hỗ trợ khu vực quan tâm: việc chỉ định ImageProcessingOptions.regionOfInterest() sẽ dẫn đến việc phương thức này gửi một IllegalArgumentException.
Gửi
IllegalArgumentException nếu ImageProcessingOptions chỉ định một khu vực quan tâm.
nếu có lỗi nội bộ. Hoặc nếu FaceStylizer không được tạo bằng OutputHandler.ResultListener được đặt trong FaceStylizer.FaceStylizerOptions.