Qt项目实战2:图片查看器QImageViewer

在博文Qt学习笔记2:QMainWindow和QWidget的区别中介绍了使用空的Qt项目创建带有菜单栏、工具栏的界面。
这里,使用一个简单的图片查看器项目,来熟悉一下Qt的图片显示和基本操作。
该项目实现的主要功能:

  • 实现图片的打开、关闭、居中显示;
  • 实现图片上一张/下一张切换;
  • 实现图片的放大、缩小操作
  • 实现图片的左旋、右旋操作

需要用的Qt类:

QFileDialog  QImage  QPixmap  QFileInfo

使用空的Qt项目创建带有菜单栏和工具栏的界面的操作参考博文Qt学习笔记1:创建一个QT的空项目

页面布局

根据自己的实际需求添加菜单栏和工具栏,参考如下图:

1

工具栏图标依次是:打开图片、关闭图片、上一张、下一张、左旋、右旋、放大、缩小

此项目算是一个小demo,主要是熟悉图片处理的相关的操作,基础类和操作熟悉之后可以加入复杂的功能。

实现图片的打开、关闭

文件打开和显示的步骤:
(1)使用QFileDislog函数选择一个图片文件,获取到文件的路径名;
(2)使用QImage类加载文件,生成image对象;
(3)使用QLabel类的setPixmap函数将图片显示在界面上。

参考代码如下:

void QImageViewer::openActionTriggered(void)
{
    filename = QFileDialog::getOpenFileName(this, tr("Select image:"),
        "D:\\Documents\\Pictures", tr("Images (*.png *.bmp *.jpg *.gif)"));
    if (filename.isEmpty()) {
        return ;
    }

    QImage image;
    if (!image.load(filename)) {
        QMessageBox::information(this, tr("Error"), tr("Open file error"));
        return ;
    }

    QPixmap pixmap = QPixmap::fromImage(image);
    imageSize = pixmap.size();

    imageLabel->setPixmap(pixmap);
    imageLabel->resize(imageSize);
    //qDebug() << "filname: " << filename;

    setWindowTitle(QFileInfo(filename).fileName() + tr(" - imageViewer"));
}

图片关闭时,只需将label清空即可:

void QImageViewer::closeActionTriggered(void)
{
    imageLabel->clear();
    imageLabel->resize(QSize(200, 100));
    setWindowTitle(tr("imageViewer"));
}

图片打开、关闭的函数,作为QAction的槽函数触发即可:

    connect(openAction, SIGNAL(triggered(bool)), this, SLOT(openActionTriggered()));
    connect(closeAction, SIGNAL(triggered(bool)), this, SLOT(closeActionTriggered()));

提示:在图片打开时可以将界面名改为文件名+标题,关闭时去掉文件名,方便用户使用。

实现图片居中显示、页面自动调整

通过上述操作,已经可以创建一个label,并将图片显示在label中。

但是会出现各种问题,例如:label在resize时部分尺寸超出页面的大小显示不全、图片不能居中显示等。

需要做以下操作来解决上述问题:

  • 使用QLabel类的setPixmap函数将图片显示在界面上;
  • 创建一个QScrollArea部件,将label加载到scrollarea中;
  • 设置scrollarea部件为中心对齐,无边框;
  • 设置页面布局方式为格点布局,并将scrollarea部件增加到0,0点上。

参考代码:

void QImageShow::setImageShowWidget(void)
{
    /* label show image */
    imageLabel = new QLabel();

    QScrollArea *imageScrollArea = new QScrollArea();
    imageScrollArea->setAlignment(Qt::AlignCenter);
    imageScrollArea->setFrameShape(QFrame::NoFrame);
    imageScrollArea->setWidget(imageLabel);

    QGridLayout *mainLayout = new QGridLayout();
    mainLayout->addWidget(imageScrollArea, 0, 0);
    centralWidget->setLayout(mainLayout);
}

当打开一张图片时,自动居中对齐;当图片大小超过中心窗口尺寸时,scrollarea部件出现滑动条,显示配合放大、缩小功能,显示效果更好。
效果如下图所示:

2

实现上一张/下一张切换

在打开文件同时,获取到当前目录的文件列表,保存到文件信息链表中。
当需要对打开的文件上、下切换时,只需对当前链表的下表进行轮询并获取图片显示即可。

void QImageViewer::getImgInfoList(QFileInfoList &imgInfoList)
{
    imgInfoList.clear();

    QDir dir = QFileInfo(filename).absolutePath();
    QFileInfoList infoList = dir.entryInfoList(QDir::Files);
    //qDebug() << "GET:" << infoList.count() << dir;

    QFileInfo info;
    for (int i = 0; i < infoList.count(); i++) {
        info = infoList.at(i);
        //qDebug() << i << info.absolutePath();
        QString suffix = info.suffix();

        if (suffix == "jpg" || suffix == "bmp" || suffix == "png") {
            imgInfoList.append(info);
            //qDebug() << "getImgInfoList:" << i << info.absolutePath() << info.suffix();
        }
    }

    QFileInfo curImageInfo = QFileInfo(filename);
    for (int j = 0; j < imgInfoList.count(); j++) {
        info = imgInfoList.at(j);
        if (info.fileName() == curImageInfo.fileName()) {
            index = j;
            //qDebug() << "curImage index:" << index;
        }
    }
}

在菜单栏和工具栏增加上一张/下一张按钮,实现QAction行为触发。

实现步骤:
(1)使用QFileInfoList链表保存下已经打开的文件所在路径下所有的图片文件的信息;
(2)记录下当前文件的下表,上一张/下一张时间触发时,对下标进行增减;
(3)获取到文件路径和文件名;
(4)重新构造image对象,加载图片文件并显示。

参考代码:

void QImageViewer::lastActionTriggered(void)
{
    //getImgInfoList(imgInfoList);

    index = index - 1;
    int count = imgInfoList.count();
    //qDebug() << "left count: " << count << "index: " << index;
    if (index < 0) {
        index = count - 1;
    }

    filename.clear();
    filename.append(path);
    filename += "/";
    filename += imgInfoList.at(index).fileName();
    //qDebug() << "filname: " << filename;

    QImage image;
    if (!image.load(filename)) {
        QMessageBox::information(this, tr("Error"), tr("Open file error"));
        return ;
    }

    QPixmap pixmap = QPixmap::fromImage(image);
    imageSize = pixmap.size();

    imageLabel->setPixmap(pixmap);
    imageLabel->resize(imageSize);

    setWindowTitle(QFileInfo(filename).fileName() + tr(" - imageViewer"));
}

void QImageViewer::nextActionTriggered(void)
{
    //getImgInfoList(imgInfoList);

    index = index + 1;
    int count = imgInfoList.count();
    //qDebug() << "right count: " << count << "index: " << index;
    if (index == count) {
        index = 0;
    }

    filename.clear();
    filename.append(path);
    filename += "/";
    filename += imgInfoList.at(index).fileName();
    //qDebug() << "filname: " << filename;

    QImage image;
    if (!image.load(filename)) {
        QMessageBox::information(this, tr("Error"), tr("Open file error"));
        return ;
    }

    QPixmap pixmap = QPixmap::fromImage(image);
    imageSize = pixmap.size();

    imageLabel->setPixmap(pixmap);
    imageLabel->resize(imageSize);

    setWindowTitle(QFileInfo(filename).fileName() + tr(" - imageViewer"));
}

图片的左旋、右旋操作

图片的旋转使用QImage类的transformed行为来实现,使用成员变量保存下当前图片的旋转角度,每次触发旋转操作,将旋转角度以90度间隔增减。

实现步骤:
(1)通过当前图片文件名静态加载image;
(2)将成员变量旋转角度,以90度间隔增、减;
(3)通过QImage类的transformed行为修改加载的图片角度;
(4)显示修改后的图片,并重置图片尺寸等;

参考代码:

void QImageViewer::toLeftActionTriggered(void)
{
    QImage imgRotate;
    QMatrix matrix;
    QPixmap pixmap;
    QImage image;

    imageAngle += 3;
    imageAngle = imageAngle % 4;
    qDebug() << "angle:%d" << imageAngle;
    matrix.rotate(imageAngle * 90);

    image.load(filename);
    imgRotate = image.transformed(matrix);
    pixmap = QPixmap::fromImage(imgRotate);
    imageSize = pixmap.size();

    imageLabel->resize(imgRotate.size());
    imageLabel->setPixmap(pixmap);
}

void QImageViewer::toRightActionTriggered(void)
{
    QImage imgRotate;
    QMatrix matrix;
    QPixmap pixmap;
    QImage image;

    imageAngle += 1;
    imageAngle = imageAngle % 4;
    //qDebug() << "angle:%d" << imageAngle;
    matrix.rotate(imageAngle * 90);

    image.load(filename);
    imgRotate = image.transformed(matrix);
    pixmap = QPixmap::fromImage(imgRotate);
    imageSize = pixmap.size();

    imageLabel->resize(imgRotate.size());
    imageLabel->setPixmap(pixmap);
}

图片的放大、缩小操作

图片的放大、缩小操作通过QImage类的scaled行为实现。可以重置image的尺寸,返回新的image对象。

这里增加一个功能:支持图片旋转之后进行放大、缩小操作。只需对放大、缩小后新的image对象再进行旋转操作即可。

实现步骤:
(1)通过当前图片文件名静态加载image;
(2)修改成员变量图片尺寸,设置放大倍数为1.2,缩小倍数为0.8,保存新的尺寸;
(3)通过QImage类的transformed行为修改加载的图片角度;
(5)显示修改后的图片,并重置图片尺寸等;

参考代码:

void QImageViewer::toEnlargeActionTriggered(void)
{
    QImage imgScaled;
    QPixmap pixmap;
    QImage image;
    QImage imgRotate;
    QMatrix matrix;

    image.load(filename);
    matrix.rotate(imageAngle * 90);
    imgRotate = image.transformed(matrix);

    imgScaled = imgRotate.scaled(imageSize.width() * 1.2,
                             imageSize.height() * 1.2,
                             Qt::KeepAspectRatio);

    pixmap = QPixmap::fromImage(imgScaled);
    imageSize = pixmap.size();
    //qDebug() << "width:%d, height:%d" << imageSize.width() << imageSize.height();

    imageLabel->setPixmap(pixmap);
    imageLabel->resize(imageSize);
}

void QImageViewer::toLessenActionTriggered(void)
{
    QImage imgScaled;
    QPixmap pixmap;
    QImage image;
    QImage imgRotate;
    QMatrix matrix;

    image.load(filename);
    matrix.rotate(imageAngle * 90);
    imgRotate = image.transformed(matrix);

    imgScaled = imgRotate.scaled(imageSize.width() * 0.8,
                             imageSize.height() * 0.8,
                             Qt::KeepAspectRatio);

    pixmap = QPixmap::fromImage(imgScaled);
    imageSize = pixmap.size();
    //qDebug() << "width:%d, height:%d" << imageSize.width() << imageSize.height();

    imageLabel->setPixmap(pixmap);
    imageLabel->resize(imageSize);
}

需要注意的地方

  • 图片关闭、上一张、下一张操作是在图片打开成功之后才能操作,所以误点按钮导致程序崩溃,需要加使能操作。

  • 此处图片对象的创建没有使用new操作,理由是需要手动delete比较麻烦;直接使用局部变量,编译器会自动释放资源。

  • 此处使用空的Qt模板创建,不使用系统的ui文件,需要手动初始化菜单栏、工具栏和中心窗口等。

源码下载链接:https://github.com/gitorup/QImageViewer

  • 32
    点赞
  • 118
    收藏
    觉得还不错? 一键收藏
  • 14
    评论
Qt Widgets项目实战是一种使用Qt框架和Widgets库开发应用程序的实践方法。以下是一个简单的Qt Widgets项目实战示例: 步骤1:创建Qt Widgets项目 使用Qt Creator创建一个新的Qt Widgets项目。选择“File”->“New File or Project”,然后选择“Qt Widgets Application”模板。按照向导的指示命名项目并选择保存路径。 步骤2:设计界面 使用Qt Designer设计应用程序的界面。在Qt Creator中打开.ui文件,拖拽并放置各种Widgets来构建用户界面。可以设置属性、布局、信号和槽等。 步骤3:编写业务逻辑 在Qt Creator中打开对应的源代码文件,编写与界面交互的业务逻辑。可以处理用户输入、响应事件、执行操作等。使用C++语言编写代码,可以使用Qt提供的各种类和API。 步骤4:编译和运行 点击Qt Creator中的“Build”按钮编译项目,并且确保没有错误和警告。然后点击“Run”按钮运行应用程序,查看界面和功能。 步骤5:调试和优化 如果遇到问题,可以使用Qt Creator提供的调试工具来调试代码。可以设置断点、观察变量值、单步执行等。根据需要,优化代码以提高性能或修复错误。 步骤6:部署和发布 完成开发后,可以使用Qt Creator提供的部署工具将应用程序打包成可执行文件。根据目标平台的要求,选择正确的编译选项和依赖项,并生成应用程序的发布版本。 这只是一个简单的Qt Widgets项目实战示例,实际开发中可能涉及到更多的功能和复杂性。但是通过这个示例,你可以了解Qt Widgets项目的一般开发流程和步骤。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 14
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值