Nodes/comfyui-AGSoft/🧑✂️AGSoft Crop Face
ComfyUI Node

🧑✂️AGSoft Crop Face

EN: Detects faces in images using RetinaFace and crops them with customizable parameters. Supports batch processing, mask-based filtering, aspect ratio presets, and independent horizontal/vertical shift. Outputs cropped faces and their bounding box data. RU: Обнаруживает лица на изображениях с помощью RetinaFace и кадрирует их с настраиваемыми параметрами. Поддерживает пакетную обработку, фильтрацию по маске, пресеты соотношения сторон и независимый сдвиг по горизонтали/вертикали. Выводит кадрированные лица и данные об их bounding box.

By Art-xmaster·Created 11 months ago·Updated 22 days ago· 20
🧑✂️AGSoft Crop Face
  • image
  • mask
  • face
  • crop_data
◄number_of_faces5►
◄scale_factor2.0►
◄shift_factor_x0.50►
◄shift_factor_y0.50►
◄start_index0►
◄max_faces_per_image50►
◄aspect_ratio1:1►
◄confidence_threshold0.70►
◄divisible_by8►
CategoryAGSoft/Crop

Inputs (11)

NameTypeDefaultDescription
imageIMAGEEN: Input image containing one or more faces to detect and crop. Supports batch processing (multiple images at once). RU: 📷 Входное изображение, содержащее одно или несколько лиц для обнаружения и кадрирования. Поддерживает пакетную обработку (несколько изображений сразу).
number_of_facesINT51–100EN: 🔢 How many faces to return. Faces are sorted by size (largest first). • If more faces found → returns only this number (largest ones) • If fewer faces found → returns all found (no duplicates) RU: Сколько лиц вернуть. Лица сортируются по размеру (большие первыми). • Если найдено больше → вернет только указанное количество (самые большие) • Если найдено меньше → вернет все найденные (без дубликатов)
scale_factorFLOAT2.01–5EN: How much to enlarge the crop around the face. • 1.0 = Tight crop (face fills almost entire image) • 2.0 = Comfortable crop (face + some background, recommended) • 3.0+ = Wide crop (face + lots of surrounding context) RU: 📏 Насколько увеличить область кадрирования вокруг лица. • 1.0 = Плотный кроп (лицо занимает почти всё изображение) • 2.0 = Комфортный кроп (лицо + немного фона, рекомендуется) • 3.0+ = Широкий кроп (лицо + много окружающего контекста)
shift_factor_xFLOAT0.500–1EN: ↔️ Horizontal position of the face within the cropped image. Controls where the face sits horizontally in the final crop. • 0.00 = Face at the far LEFT (more space on right) • 0.50 = Face in the CENTER (balanced, default) • 1.00 = Face at the far RIGHT (more space on left) RU: ↔️ Горизонтальная позиция лица в кадрированном изображении. Контролирует, где лицо располагается по горизонтали в финальном кадре. • 0.00 = Лицо слева (больше места справа) • 0.50 = Лицо в ЦЕНТРЕ (сбалансировано, по умолчанию) • 1.00 = Лицо справа (больше места слева)
shift_factor_yFLOAT0.500–1EN: ⬆️⬇️ Vertical position of the face within the cropped image. Controls where the face sits vertically in the final crop. • 0.00 = Face at the very TOP (more space below) • 0.50 = Face in the CENTER (balanced, default) • 1.00 = Face at the very BOTTOM (more space above) RU: ⬆️⬇️ Вертикальная позиция лица в кадрированном изображении. Контролирует, где лицо располагается по вертикали в финальном кадре. • 0.00 = Лицо в самом ВЕРХУ (больше места снизу) • 0.50 = Лицо в ЦЕНТРЕ (сбалансировано, по умолчанию) • 1.00 = Лицо в самом НИЗУ (больше места сверху)
start_indexINT00–999EN: 🔀 Which face to start from. Faces sorted by size (0=largest, 1=2nd, etc.) • Index 0 = Start from largest face (main subject) • Index 1 = Skip largest, start from 2nd largest Selection wraps cyclically if more faces requested than found. RU: 🔀 С какого лица начать. Лица отсортированы по размеру (0=самое большое, 1=2-е и т.д.) • Индекс 0 = Начать с самого большого лица (главный объект) • Индекс 1 = Пропустить самое большое, начать со 2-го Выбор циклический, если запрошено больше лиц, чем найдено.
max_faces_per_imageINT501–1000EN: 🔍 Maximum faces detector will look for (safety limit). Different from 'number_of_faces': • max_faces_per_image = How many to DETECT (technical limit) • number_of_faces = How many to RETURN (your choice) RU: 🔍 Максимум лиц, которые детектор будет искать (предел безопасности). Отличается от 'number_of_faces': • max_faces_per_image = Сколько ОБНАРУЖИТЬ (технический лимит) • number_of_faces = Сколько ВЕРНУТЬ (ваш выбор)
aspect_ratioCOMBO1:1EN: 📐 Width-to-height ratio of the final crop. • 1:1 = Square (Instagram, avatars, face swaps) • 3:4 = Portrait (classic portrait orientation) • 16:9 = Widescreen (YouTube/video format) • 9:16 = Vertical (TikTok/Reels/Stories) RU: 📐 Соотношение ширины к высоте финального кропа. • 1:1 = Квадрат (Instagram, аватарки, замена лиц) • 3:4 = Портрет (классическая портретная ориентация) • 16:9 = Широкоформатный (YouTube/видео) • 9:16 = Вертикальный (TikTok/Reels/Stories)
confidence_thresholdFLOAT0.700.1–1EN: 🎯 Minimum confidence to accept a detected face (0.0-1.0). • 0.90-1.0 = Very strict (only 100% certain faces) • 0.70-0.85 = Balanced (recommended default) • 0.50-0.65 = Lenient (more faces, possible false positives) RU: 🎯 Минимальная уверенность для принятия обнаруженного лица (0.0-1.0). • 0.90-1.0 = Очень строго (только 100% уверенные лица) • 0.70-0.85 = Сбалансировано (рекомендуется по умолчанию) • 0.50-0.65 = Мягко (больше лиц, возможны ложные срабатывания)
divisible_byINT81–64EN: 🔢 Round output dimensions to multiples of N. Important for VAE/KSampler compatibility (they need dims divisible by 8/16/32). • 8 = Standard (works with most nodes, recommended) • 16 = Stricter (some VAE models) • 1 = No rounding (use only if you know why) RU: 🔢 Округлить размеры выхода до кратных N. Важно для совместимости с VAE/KSampler (требуют размеры кратные 8/16/32). • 8 = Стандарт (работает с большинством нод, рекомендуется) • 16 = Строже (некоторые модели VAE) • 1 = Без округления (используйте только если знаете зачем)
maskoptMASKEN: 🎭 Optional mask to limit where faces are detected. Only faces whose CENTER is in WHITE (bright) areas will be detected. • White (1.0) = Detector searches here • Black (0.0) = Detector ignores this area RU: 🎭 Опциональная маска для ограничения области поиска лиц. Будут обнаружены только лица, чей ЦЕНТР в БЕЛЫХ (ярких) областях. • Белый (1.0) = Детектор ищет здесь • Черный (0.0) = Детектор игнорирует эту область

Outputs (2)

NameTypeDescription
faceIMAGE—
crop_dataCROP_DATA—