Qt 编程指南 8 显示静态小图片和动态大图片 显示控件概览 图片浏览示例
图片浏览示例
第一行是一个标签控件，objectName 为 labelShow，文本内容清空，因为是用来显示图片用的。
主界面第二行的控件是四个普通按钮
第一个按钮文本是 "打开图片"，objectName 为 pushButtonOpenPic；
第二个按钮文本是 "打开动态图"，objectName 为 pushButtonOpenMov；
第三个按钮文本是 "播放"，objectName 为 pushButtonStart；
第四个按钮文本是 "停止"，objectName 为 pushButtonStop。
水平滑动条，objectName 为 horizontalSlider。这个水平滑动条适用于显示动态图播放进度的
main.cpp
#include "Qt_Show.h"
#include <QtWidgets/QApplication>
#include <QBitmap>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
Qt_Show w;
QPixmap pixmap("images/timg2.jpg"); // 读取图片
QPalette palette;
palette.setBrush(w.backgroundRole(), QBrush(pixmap)); // 将图片设置在指定窗口
w.setPalette(palette);
//w.setMask(pixmap.mask()); //可以将图片中透明部分显示为透明的
w.setAutoFillBackground(true); // 自动充满
w.show();
return a.exec();
}
窗口头文件
#pragma once
#include <QtWidgets/QMainWindow>
#include "ui_Qt_Show.h"
#include <QPixmap> //像素图
#include <QMovie> //动态图
#include <QImageReader> //可以打开图片或者查看支持的图片格式
class Qt_Show : public QMainWindow
{
Q_OBJECT
public:
Qt_Show(QWidget *parent = Q_NULLPTR);
~Qt_Show();
public slots:
//接收出错的信号
void RecvPlayError(QImageReader::ImageReaderError error);
//接收播放时帧号变化
void RecvFrameNumber(int frameNumber);
private slots:
void on_pushButtonOpenPic_clicked();
void on_pushButtonOpenMov_clicked();
void on_pushButtonStart_clicked();
void on_pushButtonStop_clicked();
private:
Ui::Qt_ShowClass ui;
//像素图指针
QPixmap *m_pPixMap;
//动态图指针
QMovie *m_pMovie;
//是否为动态图
bool m_bIsMovie;
//动态图是否在播放中，如果在播放中，那么循环播放
bool m_bIsPlaying;
//清除函数，在打开新图之前，清空旧的 打开新图之前，清理旧的像素图、动态图对象，并重置两个标志位变量。
void ClearOldShow();
};
窗体实体
#include "Qt_Show.h"
#include <QDebug>
#include <QFileDialog> //打开文件对话框
#include <QScrollArea> //为标签添加滚动区域
#include <QMessageBox> //消息框
Qt_Show::Qt_Show(QWidget *parent)
: QMainWindow(parent)
{
ui.setupUi(this);
//初始化成员变量
m_pPixMap = NULL;
m_pMovie = NULL;
m_bIsMovie = false;
m_bIsPlaying = false;
//获取标签矩形
QRect rcLabel = ui.labelShow->geometry();
//为标签添加滚动区域，方便浏览大图
QScrollArea *pSA = new QScrollArea(this); //该对象交给主窗体自动管理，不用手动删除
//把标签填充到滚动区域里
pSA->setWidget(ui.labelShow);
//设置滚动区域占据矩形
pSA->setGeometry(rcLabel);
//打印支持的图片格式
qDebug() << QImageReader::supportedImageFormats();
//打印支持的动态图格式
qDebug() << QMovie::supportedFormats();
}
Qt_Show::~Qt_Show()
{
//手动清空
ClearOldShow();
//原有的代码
// delete ui;
}
void Qt_Show::ClearOldShow()
{
//清空标签内容
ui.labelShow->clear();
//像素图不空就删除
if (m_pPixMap != NULL)
{
//删除像素图
delete m_pPixMap; m_pPixMap = NULL;
}
//如果短片不为空，就删除
if (m_pMovie != NULL)
{
//如果正在播放则停止
if (m_bIsPlaying)
{
m_pMovie->stop();
}
//删除动态图
delete m_pMovie; m_pMovie = NULL;
}
//标志位重置
m_bIsMovie = false;
m_bIsPlaying = false;
}
void Qt_Show::on_pushButtonOpenPic_clicked()
{
QString strFileName; //文件名
strFileName = QFileDialog::getOpenFileName(this, tr("打开静态图片"), "",
"Pictures (*.bmp *.jpg *.jpeg *.png *.xpm);;All files(*)");
if (strFileName.isEmpty())
{
//文件名为空，返回
return;
}
//清空旧的图片或短片
ClearOldShow();
//打印文件名
qDebug() << strFileName;
//新建像素图
m_pPixMap = new QPixmap();
//加载
if (m_pPixMap->load(strFileName))
{
//加载成功
//设置给标签
ui.labelShow->setPixmap(*m_pPixMap);
//设置标签的新大小，与像素图一样大
ui.labelShow->setGeometry(m_pPixMap->rect());
//设置 bool 状态
m_bIsMovie = false; //不是动态图
m_bIsPlaying = false; //不是动态图播放
}
else
{
//加载失败，删除图片对象，返回
delete m_pPixMap; m_pPixMap = NULL;
//提示失败
QMessageBox::critical(this, tr("打开失败"),
tr("打开图片失败，文件名为：
%1").arg(strFileName));
}
}
void Qt_Show::on_pushButtonOpenMov_clicked()
{
QString strFileName; //文件名
strFileName = QFileDialog::getOpenFileName(this, tr("打开动态图片"), "",
"Movies (*.gif *.mng);;All files(*)");
if (strFileName.isEmpty())
{
//文件名为空，返回
return;
}
//清除旧的图片或短片
ClearOldShow();
//打印文件名
qDebug() << strFileName;
//新建动态图
m_pMovie = new QMovie(strFileName);
//判断是否动态图文件可用
if (!m_pMovie->isValid())
{
//不可用
QMessageBox::critical(this, tr("动态图不可用"),
tr("动态图格式不支持或读取出错，文件名为：
%1").arg(strFileName));
//清除
delete m_pMovie; m_pMovie = NULL;
return; //不可用就直接返回
}
//动态图的总帧数
int nCount = m_pMovie->frameCount(); //如果动态图格式不支持计数，那么会返回 0
//打印帧数
qDebug() << tr("总帧数：%1").arg(nCount);
//如果有统计帧数，那就设置滑动条上限
if (nCount > 0)
{
ui.horizontalSlider->setMaximum(nCount);
}
else
{
//获取不到帧数，默认当作 100
ui.horizontalSlider->setMaximum(100);
}
//把动态图设置给标签
ui.labelShow->setMovie(m_pMovie);
//修改 bool 状态
m_bIsMovie = true;
m_bIsPlaying = false; //还没点击播放开始的按钮
//待续
//关联播放时的信号
//播放出错信号
connect(m_pMovie, SIGNAL(error(QImageReader::ImageReaderError)),
this, SLOT(RecvPlayError(QImageReader::ImageReaderError)));
//播放的帧号变化信号
connect(m_pMovie, SIGNAL(frameChanged(int)),
this, SLOT(RecvFrameNumber(int)));
//将动态图片跳转到起始帧
if (m_pMovie->jumpToFrame(0))
{
//跳转成功
//对于打头的帧，设置标签的矩形为帧的矩形
ui.labelShow->setGeometry(m_pMovie->frameRect());
}
//如果跳转失败，槽函数 RecvPlayError() 会提示出错
}
//播放开始按钮
void Qt_Show::on_pushButtonStart_clicked()
{
if (!m_bIsMovie) //不是动态图
{
return;
}
if (m_bIsPlaying) //已经在播放了
{
return;
}
//播放动态图
m_bIsPlaying = true; //开始播放状态
m_pMovie->start(); //播放
//打印动态图默认的播放循环轮数，0 代表不循环，-1 代表无限循环
qDebug() << tr("循环计数：%1").arg(m_pMovie->loopCount());
}
//停止播放按钮
void Qt_Show::on_pushButtonStop_clicked()
{
if (!m_bIsMovie) //不是动态图
{
return;
}
if (!m_bIsPlaying) //没有处于播放状态
{
return;
}
//停止播放
m_bIsPlaying = false;
m_pMovie->stop();
}
//接收播放错误信号
void Qt_Show::RecvPlayError(QImageReader::ImageReaderError error)
{
//打印
qDebug() << tr("读取动态图错误的代码：%1").arg(error);
//提示播放出错
QMessageBox::critical(this, tr("播放出错"),
tr("播放动态图出错，文件名为：
%1").arg(m_pMovie->fileName()));
//回到停止状态
m_bIsPlaying = false;
}
//接收帧号变化信号
void Qt_Show::RecvFrameNumber(int frameNumber)
{
ui.horizontalSlider->setValue(frameNumber);
}
- 问题1 都是图片，opensuse.png 能打开，opensuse.jpg 打开出错，这是为什么呢？
用这两张图片举例，不是为了说明 png 格式比 jpg 好，也不是为了说明我们例子代码有问题，
而是为了说明有些错误不在程序本身！
我们举例的 opensuse.png 和 opensuse.jpg 两张图片文件的数据是一模一样的，就是复制了一份，改了个扩展名而已。
opensuse 的图片原本就是 PNG 格式的，在下载的时候错误地保存为 opensuse.jpg。虽然操作系统的图片查看器、之前的 QTextBrowser 示例都能浏览这个错误扩展名的图片，但是 QPixmap::load() 函数根据 jpg 扩展名加载 opensuse.jpg 时出现了错误，因为这张图根本不是 jpg 图片。
这里打开 opensuse.jpg 出错，就是因为图片扩展名错了，与程序本身没关系。
那么 5.3.4 QTextBrowser 示例怎么能正确显示 opensuse.jpg 呢？那是因为它没有用 QPixmap::load() 函数加载图片，而是 QImage::loadFromData() 函数，感兴趣的读者可以看看 QImage::loadFromData() 函数帮助文档，它是直接从文件数据头判断文件格式，而不管扩展名是什么，因此能正确显示扩展名错误的图片。