measure. Создание объекта на основе существующего графического файла

measure. Создание объекта на основе существующего графического файла

^image::measure[файл]
^image::measure[имя файла]
^image::measure[файл;опции] [3.4.6]
^image::measure[имя файла;опции] [3.4.6]

Создает объект класса image, измеряя размеры существующего графического файла или объекта класса file в поддерживаемом формате. Поддерживаются GIF, JPEG и PNG, а начиная с версии [3.4.6] дополнительно поддерживаются TIFF, BMP, WEBP и при указании опции $.video(true) - еще и MP4 (MOV).

Сама картинка не считывается, основное назначение метода - определение размеров и, например, последующий вызов для созданного объекта метода html.

Параметры конструктора:
Файл - объект класса file;
Имя файла - имя файла с путем.

Можно задать хеш опций:

	По умолчанию	Описание
$.video(false\|true)	false	Определять размеры у видеофайлов в формате MP4 (MOV);
$.exif(false\|true)	false	Считывать EXIF-информацию из JPEG-файлов; до версии *[3.4.6]* EXIF-информация считывалась всегда;
$.xmp(false\|true)	false	Считывать XMP-информацию из JPEG-файлов;
$.xmp-charset[кодировка]	UTF-8	Кодировка XMP-информации.

Примечание: поддерживается EXIF 1.0, считываются теги из IFD0 и SubIFD.

Пример создания тега IMG с указанием размеров изображения
$photo[^image::measure[photo.png]]
^photo.html[]

Будет создан объект photo класса image на основе готового графического изображения в формате PNG и выдан тег IMG, ссылающийся на данный файл, с указанием width и height.

Пример работы с EXIF-информацией
$image[^image::measure[jpg/DSC00003.JPG; $.exif(true) ]]
$exif[$image.exif]
^if($exif){
 Производитель фотоаппарата, модель: $exif.Make $exif.Model 
 Время съемки: ^exif.DateTimeOriginal.sql-string[] 
 Выдержка: $exif.ExposureTime секунды 
 Диафрагма: F$exif.FNumber 
 Использовалась вспышка: ^if(def $exif.Flash){^if($exif.Flash){да;нет};неизвестно} 
}{
 нет EXIF-информации 
}

Дата обновления: 20.12.2024