mirror of https://github.com/imgproxy/imgproxy.git synced 2024-11-29 08:22:11 +02:00

* Update autoquality.md

* Update best_format.md

* Update chained_pipelines.md

* Update chaining_the_processing.md

* Update encrypting_the_source_url.md

* Update getting_the_image_info.md

* Update object_detection.md

2022-12-15 21:02:35 +06:00

1.9 KiB

Raw Blame History

Object detection

imgproxy can detect objects on the image and use them for smart cropping, bluring the detections, or drawing the detections.

For object detection purposes, imgproxy uses the Darknet YOLO model. We provide Docker images with a model trained for face detection, but you can use any Darknet YOLO model found in the zoo or you can train your own model by following this guide.

Configuration

You need to define four config variables to enable object detection:

IMGPROXY_OBJECT_DETECTION_CONFIG: a path to the neural network config
IMGPROXY_OBJECT_DETECTION_WEIGHTS: a path to the neural network weights
IMGPROXY_OBJECT_DETECTION_CLASSES: a path to the text file with the classes names, one per line
IMGPROXY_OBJECT_DETECTION_NET_SIZE: the size of the neural network input. The width and the heights of the inputs should be the same, so this config value should be a single number. Default: 416

Read the configuration guide for more config values info.

Usage examples

Object-oriented crop

You can crop your images and keep objects of desired classes in frame:

.../crop:256:256/g:obj:face/...

Bluring detections

You can blur objects of desired classes, thus making anonymization or hiding NSFW content possible:

.../blur_detections:7:face/...

Draw detections

You can make imgproxy draw bounding boxes for the detected objects of the desired classes (this is handy for testing your models):

.../draw_detections:1:face/...

1.9 KiB Raw Blame History