На этом шаге мы рассмотрим назначение, форматы конструктора и основные методы этого класса.

    Класс QPixmap предназначен для работы с изображениями в контекстно-зависимом представлении. Данные хранятся в виде, позволяющем отображать изображение на экране наиболее эффективным способом, поэтому класс часто используется в качестве буфера для предварительного рисования графики перед выводом ее на экран. Иерархия наследования:

   QPaintDevice - QPixmap

    Поскольку класс QPixmap наследует класс QPaintDevice, мы можем использовать его как поверхность для рисования. Вывести изображение позволяет метод drawPixmap() класса QPainter (см. 190 шаг).

    Форматы конструктора класса:

  <Объект> = QPixmap()
  <Объект> = QPixmap(<Ширина>, <Высота>)
  <Объект> = QPixmap(<QSize>)
  <Объект> = QPixmap(<Путь к файлу>[, format=None][, flags=AutoColor])
  <Объект> = QPixmap(<QPixmap>)

    Первый конструктор создает пустой объект изображения. Второй и третий конструкторы позволяют указать размеры изображения: если размеры равны нулю, то будет создан пустой объект. Четвертый конструктор предназначен для загрузки изображения из файла. Во втором параметре указывается тип изображения в виде строки (например, "PNG") - если он не указан, то формат будет определен по расширению загружаемого файла. Пятый конструктор создает копию изображения.

    Класс QPixmap поддерживает следующие методы (здесь приведены только основные,- их полный список находится на странице https://doc.qt.io/qt-5/qpixmap.html):

• isNull () - возвращает значение True, если объект является пустым, и False - в противном случае;

• loаd (<Путь к файлу>[, format=None] [, flags=AutoColor]) - загружает изображение из файла. В первом параметре указывается абсолютный или относительный путь к файлу. Во втором параметре можно задать формат файла в виде строки - если он не указан, формат определяется по расширению файла. Необязательный параметр flags задает тип преобразования цветов. Метод возвращает значение True, если изображение успешно загружено, и False - в противном случае;

• loadFromData (<QByteArray>[, format=Hone] [, flags=AutoColor]) - загружает изображение из экземпляра класса QByteArray. В первом параметре можно указать данные, имеющие тип bytes. Метод возвращает значение True, если изображение успешно загружено, и False - в противном случае;

• save (<Путь к файлу>[, format=None] [, quality=-1]) - сохраняет изображение в файл. В первом параметре указывается абсолютный или относительный путь к файлу. Во втором параметре можно задать формат файла в виде строки - если он не указан, формат будет определен по расширению файла. Необязательный параметр quality позволяет задать качество изображения. Можно передать значение в диапазоне от 0 до 100. Метод возвращает значение True, если изображение успешно сохранено, и False - в противном случае;

• convertFromImage (<QImage> [, flags=AutoColor]) - преобразует экземпляр класса QImage в экземпляр класса QPixmap. Метод возвращает значение True, если изображение успешно преобразовано, и False - в противном случае;

• fromImage(<QImage>[, flags=AutoColor]) - преобразует экземпляр класса QImage в экземпляр класса QPixmap, который и возвращает. Метод является статическим;

• toImage () - преобразует экземпляр класса QPixmap в экземпляр класса QImage и возвращает его;

• fill ([color=white]) - производит заливку изображения указанным цветом;

• width () - возвращает ширину изображения;

• height () - возвращает высоту изображения;

• size () - возвращает экземпляр класса QSize с размерами изображения;

• rect () - возвращает экземпляр класса QRect с координатами и размерами прямоугольной области, ограничивающей изображение;

• depth () - возвращает глубину цвета;

• isQBitmap () - возвращает значение True, если глубина цвета равна одному биту (то есть это монохромное изображение), и False - в противном случае;

• createMaskFromColor (<QColor> [, mode=MaskInColor]) - создает на основе изображения маску в виде экземпляра класса QBitmap и возвращает ее. Первый параметр задает цвет: области, закрашенные этим цветом, будут на маске либо прозрачными, либо непрозрачными. Необязательный параметр mode задает режим создания маски в виде следующих атрибутов класса QtCore.Qt:
  • MaskInColor (или 0) - области, закрашенные указанным цветом, будут прозрачными;
  • MaskOutColor (или 1) - области, закрашенные указанным цветом, будут непрозрачными;

• setMask (<QBitmap>) - устанавливает маску;

• mask () - возвращает экземпляр класса QBitmap с маской изображения;

• сору () - возвращает экземпляр класса QPixmap с фрагментом изображения. Если параметр rect не указан, изображение копируется полностью. Форматы метода:

    сору([rect=QRect()])
    сору(<Х>, <Y>, <Ширина>, <Высота>)
  

• scaled () - изменяет размер изображения и возвращает результат в виде экземпляра класса QPixmap. Исходное изображение не изменяется. Форматы метода:

    scaled(<Ширина>, <Высота>[, aspectRatioMode=IgnoreAspectRatio][,
      transfоrmMode=FastTransformation]) 
    scaled(<QSize>[, aspectRatioMode=IgnoreAspectRatio][,
      transformMode=FastTransformation])
  

      В необязательном параметре aspectRatioMode могут быть указаны следующие атрибуты класса Qtcore.Qt:

  • IgnoreAspectRatio (или 0) - изменяет размеры без сохранения пропорций сторон;
  • KeepAspectRatio (или 1) - изменяет размеры с сохранением пропорций сторон. При этом часть области нового изображения может оказаться незаполненной;
  • KeepAspectRatioByExpanding (или 2) - изменяет размеры с сохранением пропорций сторон. При этом часть нового изображения может выйти за пределы его области.

      В необязательном параметре transformMode могут быть указаны следующие атрибуты из класса QtCore.Qt:

  • FastTransfomation (или 0) - сглаживание выключено;
  • SmoothTransformation (или 1) - сглаживание включено;

• scaledToWidth (<Ширина>[, mode=FastTransformation]) - изменяет ширину изображения и возвращает результат в виде экземпляра класса QPixmap. Высота изображения изменяется пропорционально. Исходное изображение не изменяется. Параметр mode аналогичен параметру transformMode в методе scaled();

• scaledToHeight (<Высота>[, mode=FastTransformation]) - изменяет высоту изображения и возвращает результат в виде экземпляра класса QPixmap. Ширина изображения изменяется пропорционально. Исходное изображение не изменяется. Параметр mode аналогичен параметру transformMode в методе scaled();

• transformed (<QTransform> [, mode=FastTransformation]) - производит трансформацию изображения (например, поворот) и возвращает результат в виде экземпляра класса QPixmap. Исходное изображение не изменяется. Трансформация задается с помощью экземпляра класса QTransform. Параметр mode аналогичен параметру transformMode в методе scaled();

• swap (<QPixmap>) - заменяет текущее изображение указанным в параметре;

• hasAlpha () - возвращает True, если изображение имеет прозрачные области, и False - в противном случае;

• hasAlphaChannel () - возвращает True, если формат изображения поддерживает прозрачность, и False - в противном случае.

    На следующем шаге мы рассмотрим класс QBitmap.

Предыдущий шаг Содержание Следующий шаг