Документация для разработчиков
Темная тема

ResizeImageFile

CFile::ResizeImageFile(
	$sourceFile,
	&$destinationFile,
	$arSize,
	$resizeType = BX_RESIZE_IMAGE_PROPORTIONAL,
	$arWaterMark = array(),
	$jpgQuality=false,
	$arFilters=false
)

Метод производит изменение размера графического файла. Если исходный файл с расширением BMP, то файл-результат будет переконвертирован как JPEG и в destinationFile вернется модифицированное имя. Статический метод.

Параметры

Параметр Описание С версии
sourceFile Путь к исходному файлу
destinationFile Путь к файлу - результату обработки. Если исходный файл в формате BMP, то файл будет переконвертирован в JPEG и в destinationFile вернется модифицированное имя.
Size Массив вида array("width" => $width, "height" => $height)); оба ключа обязательны.
resizeType тип масштабирования:
  • BX_RESIZE_IMAGE_EXACT - масштабирует в прямоугольник $arSize без сохранения пропорций;
  • BX_RESIZE_IMAGE_PROPORTIONAL - масштабирует с сохранением пропорций, размер ограничивается $arSize;
  • BX_RESIZE_IMAGE_PROPORTIONAL_ALT - масштабирует с сохранением пропорций, размер ограничивается $arSize, улучшенная обработка вертикальных картинок.
arWaterMark массив с параметрами водяного знака, ключи:
  • text - текст водяного знака
  • font - путь к TTF-шрифту (TTF/UTF-8)
  • type - text или image
  • min_size_picture - минимальная ширина картинки
  • color - цвет "RRGGBB"
  • alpha_level - прозрачность от 0 до 100, где 0 = прозрачно, 100 = непрозрачно. (Применяется только для авторского знака в виде картинки.)
  • size - размер. big; medium; small; real, для произвольного изменения масштаба возможно указание коэффициента через параметр 'coefficient', параметр 'real' применим только для изображений ('type'=>'image')
  • position - указание расположения водяного знака на изображении возможно в двух нотациях:
    • "{m|b}{c|r}", где m - центр по вертикали, b - низ, c - центр по горизонтали, r - правый край.
    • topleft; topcenter; topright; centerleft; center; centerright; bottomleft; bottomcenter; bottomright.
jpgQuality Величина JPG-сжатия. Необязательный. По умолчанию false, что равно 95% качества изображения. Если необходимо полное качество, передавайте параметр "100".9.0.0
Filters Массив параметров фильтра. Необязательный. По умолчанию false.10.0.4

Примеры использования



© «Битрикс», 2001-2024, «1С-Битрикс», 2024