Класс QPicture

Класс QPicture — это устройство рисования, которое записывает и воспроизводит команды QPainter. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

• 14 открытых функций, унаследованных от QPaintDevice

Связанные нечлены

Дополнительные унаследованные члены

• 1 защищённая функция, унаследованная от QPaintDevice

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

Класс QPicture — это устройство рисования, которое записывает и воспроизводит команды QPainter.

Изображение сериализует команды painter в устройство ввода-вывода в независимом от платформы формате. Иногда их называют метафайлами.

Изображения Qt используют собственный двоичный формат. В отличие от родных форматов изображений (метафайлов) на многих системных платформах, изображения Qt не имеют ограничений в отношении их содержимого. Всё, что можно нарисовать на виджете или pixmap (например, шрифты, pixmaps, области, преобразованные графики и т. д.), также можно хранить в изображении.

QPicture не зависит от разрешения, т. е. QPicture может отображаться на разных устройствах (например, svg, pdf, ps, принтер и экран), выглядя одинаково. Это, например, необходимо для предварительного просмотра печати WYSIWYG. QPicture работает с предустановленным разрешением системы и масштабирует painter, чтобы соответствовать различиям в разрешении в зависимости от системной платформы.

Пример того, как записать изображение:

        QPicture picture;
        QPainter painter;
        painter.begin(&picture);           // paint in picture
        painter.drawEllipse(10,20, 80,70); // draw an ellipse
        painter.end();                     // painting done
        picture.save("drawing.pic");       // save picture

Обратите внимание, что список команд painter сбрасывается при каждом вызове функции QPainter::begin().

Пример того, как воспроизвести изображение:

        QPicture picture;
        picture.load("drawing.pic");           // load picture
        QPainter painter;
        painter.begin(&myImage);               // paint in myImage
        painter.drawPicture(0, 0, picture);    // draw the picture at (0,0)
        painter.end();                         // painting done

Изображения также могут быть нарисованы с помощью play(). Доступна базовая информация об изображении, например, size(), isNull() и boundingRect().

См. также QMovie.

Документация по функциям-членам

QPicture::QPicture(int formatVersion = -1)

Создаёт пустое изображение.

Параметр formatVersion может использоваться для создания QPicture, которое может быть прочитано приложениями, скомпилированными с более ранними версиями Qt.

Обратите внимание, что значение по умолчанию formatVersion равно -1, что указывает на текущую версию, т. е. для Qt 4.0 значение formatVersion 7 эквивалентно значению по умолчанию formatVersion -1.

Чтение изображений, сгенерированных более ранними версиями Qt, в Qt 4.0 не поддерживается.

QPicture::QPicture(const QPicture &pic)

Создаёт копию pic.

Этот конструктор быстрый благодаря неявной совместной работе.

[virtual] QPicture::~QPicture()

Удаляет изображение.

QRect QPicture::boundingRect() const

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

См. также setBoundingRect().

const char *QPicture::data() const

Возвращает указатель на данные изображения. Указатель действителен до следующего вызова функции, которая не является константной, для этого изображения. Возвращаемый указатель равен 0, если изображение не содержит данных.

См. также setData(), size() и isNull().

bool QPicture::isNull() const

Возвращает true если изображение не содержит данных; в противном случае возвращает false.

bool QPicture::load(const QString &fileName, const char *format = nullptr)

Загружает изображение из файла, указанного параметром fileName, и возвращает true в случае успеха; в противном случае делает изображение недействительным и возвращает false.

Обратите внимание, что параметр format устарел и не будет иметь никакого эффекта.

См. также save().

bool QPicture::load(QIODevice *dev, const char *format = nullptr)

Это перегруженная функция.

dev — устройство, используемое для загрузки.

bool QPicture::play(QPainter *painter)

Воспроизводит изображение с помощью painter и возвращает true при успехе; в противном случае возвращает false.

Эта функция делает точно то же самое, что и QPainter::drawPicture() с (x, y) = (0, 0).

bool QPicture::save(const QString &fileName, const char *format = nullptr)

Сохраняет изображение в файл, указанный параметром fileName, и возвращает true в случае успеха; в противном случае возвращает false.

Обратите внимание, что параметр format устарел и не будет иметь никакого эффекта.

См. также load().

bool QPicture::save(QIODevice *dev, const char *format = nullptr)

Это перегруженная функция.

dev — устройство, используемое для сохранения.

void QPicture::setBoundingRect(const QRect &r)

Устанавливает прямоугольник ограничивающей области изображения на r. Автоматически вычисляемое значение переопределяется.

См. также boundingRect().

[virtual] void QPicture::setData(const char *data, uint size)

Устанавливает данные изображения непосредственно из data и size. Эта функция копирует входные данные.

См. также data() и size().

uint QPicture::size() const

Возвращает размер данных изображения.

См. также data().

void QPicture::swap(QPicture &other)

Меняет местами изображение other с текущим изображением. Эта операция очень быстрая и никогда не приводит к ошибкам.

Эта функция была добавлена в Qt 4.8.

QPicture &QPicture::operator=(const QPicture &p)

Присваивает изображение p текущему изображению и возвращает ссылку на это изображение.

QPicture &QPicture::operator=(QPicture &&other)

Перемещает присвоение other данному экземпляру QPicture.

Эта функция была добавлена в Qt 5.2.