Автоматическая коррекция соотношения сторон изображений

Для автоматического кадрирования изображений в div-image до ожидаемого соотношения сторон используйте расширение aspect_correction (только для iOS). Ожидаемое соотношение сторон задается свойством aspect элемента:

{
  "type": "image",
  "image_url": "https://example.com/image.png",
  "aspect": {
    "ratio": 1.5
  },
  "extensions": [
    {
      "id": "aspect_correction"
    }
  ]
}

У расширения нет параметров. Допуск отклонения соотношения сторон задается в приложении при создании обработчика.

Особенности работы

  • Расширение применяется к элементу div-image, у которого задано свойство aspect.
  • Изображение кадрируется, если его фактическое соотношение сторон отличается от ожидаемого больше чем на допуск.
  • Если фактическое соотношение сторон меньше ожидаемого, изображение обрезается по высоте.
  • Если фактическое соотношение сторон больше ожидаемого, изображение обрезается по ширине.

Подключение

DivKitComponents(
  ...
  extensionHandlers: [
    AspectCorrectionExtensionHandler(aspectTolerance: 0.001)
  ]
)

aspectTolerance — допуск отклонения соотношения сторон. Если фактическое соотношение сторон отличается от ожидаемого не больше чем на это значение, кадрирование не применяется. По умолчанию: 0.001.

Узнать больше

Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: https://t.me/divkit_community_ru.

Репозиторий DivKit