QML-тип Thumbnail

Генерирует и отображает кэшированный эскиз исходного изображения или видео. Подробнее...

Строка импорта: import Nemo.Thumbnailer 1.0

Свойства

Подробное описание

Вместо элементов типа Qt Quick Image для отображения эскизов изображений и видео может использоваться специализированный QML-тип Thumbnail. Плагин Thumbnailer предоставляет дополнительный API, с помощью которого можно задавать приоритет запросам, а также получать текущее состояние процесса генерации эскиза. Загруженные эскизы хранятся в локальном дисковом кэше, что ускоряет их последующую загрузку, особенно если исходное изображение или видео достаточно большого размера.

import QtQuick 2.0
import Nemo.Thumbnailer 1.0

Thumbnail {
    source: "photo.jpg"
    width: thumbnailWidth
    height: thumbnailHeight
    sourceSize.width: width
    sourceSize.height: height
    priority: {
        if (visibleRangeStart <= index && index < visibleRangeEnd) {
            return Thumbnail.HighPriority
        } else {
            return Thumbnail.LowPriority
        }
    }
}

Описание свойств

fillMode : enumeration

Данному свойству необходимо задать значение для определения действия, которое будет выполняться, если соотношение сторон исходного изображения отличается от соотношения сторон эскиза.

  • Thumbnail.PreserveAspectFit — изображение масштабируется равномерно без обрезки;
  • Thumbnail.PreserveAspectCrop — изображение масштабируется равномерно и при необходимости обрезается. Это поведение по умолчанию.

mimeType : string

MIME-тип эскиза, который облегчает корректное обнаружение типа файла.

priority. : NemoThumbnailItem::Priority

С помощью данной системы можно задать больший приоритет изображениям, показанным в данный момент на экране. Например, всегда имеет смысл давать высокий приоритет видимым элементам при быстром прокручивании списка фотографий, файлы которых, как правило, имеют большой размер.

Параметр priority может принимать одно из значений:

  • Thumbnail.HighPriority — высокий приоритет;
  • Thumbnail.NormalPriority — обычный приоритет;
  • Thumbnail.LowPriority — низкий приоритет.

source : url

В свойстве source указывается расположение исходного изображения или видео в виде абсолютного или относительного URL.

sourceSize : QSize

Содержит фактические ширину и высоту кэшированного и отображаемого в данный момент эскиза. Эти размеры должны быть всегда определены.

status : enumeration

Содержит текущее состояние загрузки эскиза. Данное свойство может принимать одно из следующих значений:

  • Thumbnail.Null — изображение не задано;
  • Thumbnail.Ready — эскиз загружен;
  • Thumbnail.Loading — эскиз в настоящий момент загружается;
  • Thumbnail.Error — при генерировании эскиза произошла ошибка.