Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QImageIOHandler Class Reference
^{[QtGui module]}

该QImageIOHandler类定义Qt中的所有图像格式的图像常见的I / O接口。More...

Types

• enum ImageOption { Size, ClipRect, Description, ScaledClipRect, ..., BackgroundColor }

Methods

• __init__ (self)
• bool canRead (self)
• int currentImageNumber (self)
• QRect currentImageRect (self)
• QIODevice device (self)
• QByteArray format (self)
• int imageCount (self)
• bool jumpToImage (self, int imageNumber)
• bool jumpToNextImage (self)
• int loopCount (self)
• QByteArray name (self)
• int nextImageDelay (self)
• QVariant option (self, ImageOption option)
• bool read (self, QImage image)
• setDevice (self, QIODevice device)
• setFormat (self, QByteArray format)
• setOption (self, ImageOption option, QVariant value)
• bool supportsOption (self, ImageOption option)
• bool write (self, QImage image)

Detailed Description

该QImageIOHandler类定义Qt中的所有图像格式的图像常见的I / O接口。

Qt使用QImageIOHandler通过读取和写入图像QImageReader和QImageWriter。您也可以从这个类派生使用Qt的插件机制来编写自己的图像格式处理程序。

Call setDevice（ ）到设备分配给处理程序，setFormat（ ）的形式分配给它。一QImageIOHandler可以支持一个以上的图像格式。canRead（）返回True，如果一个图像可以从设备读取，并read（）和write（ ）返回True，如果读取或写入图像已成功完成。

QImageIOHandler也有动画格式的支持，通过功能loopCount（ ）imageCount（ ）nextImageDelay（）和currentImageNumber（ ） 。

为了确定哪些选项的图像处理程序支持， Qt会调用supportsOption（）和setOption（ ） 。请务必重新实现这些功能，如果你能提供任何在该选项的支持ImageOption枚举。

写你自己的图像处理程序，您必须至少重新实现canRead（）和read（ ） 。然后创建一个QImageIOPlugin它可以创建的处理程序。最后，安装插件，QImageReader和QImageWriter将自动加载该插件，并开始使用它。

Type Documentation

QImageIOHandler.ImageOption

这个枚举变量描述了所支持的不同选择QImageIOHandler。有些选项是用来查询的图像的性质，有些则是用来切换中的图像应该写入的方式。

Method Documentation

QImageIOHandler.__init__ (self)

构造一个QImageIOHandler对象。

bool QImageIOHandler.canRead (self)

这种方法是抽象的，应在任何子类中重新实现。

返回True如果图像可以从设备读取（即图像格式的支持，该设备可以读取和初始头信息表明，图像可以被读取），否则返回False 。

当重新实现的CanRead （ ） ，请确保I / O设备（device（））被留在其原来的状态（例如，通过使用PEEK（ ），而不是read（））。

See also read（）和QIODevice.peek（ ） 。

int QImageIOHandler.currentImageNumber (self)

对于支持动画图像格式，该函数返回当前图像的动画序列号。如果这个函数被调用任何图像之前read（ ） ，则返回-1。序列中的第一图像的数目是0。

如果图像格式不支持动画，则返回0 。

See also read（ ） 。

QRect QImageIOHandler.currentImageRect (self)

返回当前图像的正确。如果没有RECT定义为图像，以及空查阅QRect （ ）返回。

这个功能对于动画，其中帧的唯一部件可以在同一时间进行更新是有用的。

QIODevice QImageIOHandler.device (self)

返回当前分配给该设备QImageIOHandler。如果没有设备已经被分配，则返回0 。

See also setDevice（ ） 。

QByteArray QImageIOHandler.format (self)

返回当前分配到的格式QImageIOHandler。如果没有指定格式已被分配，则返回一个空字符串。

See also setFormat（ ） 。

int QImageIOHandler.imageCount (self)

对于支持动画图像格式，该函数返回的动画图像的数量。如果图像格式不支持动画，或者如果它是无法确定的图像的数量，则返回0 。

默认实现返回1 ，如果canRead（ ）返回True，否则返回0。

bool QImageIOHandler.jumpToImage (self, int imageNumber)

对于支持动画图像格式，该函数跳转到的序列号是图像imageNumber。到下一次调用read（ ）将尝试读取这个形象。

默认实现不执行任何操作，并返回False 。

bool QImageIOHandler.jumpToNextImage (self)

对于支持动画图像格式，该功能跳转到下一个图像。

默认实现不执行任何操作，并返回False 。

int QImageIOHandler.loopCount (self)

对于支持动画图像格式，该函数返回的时候动画应该循环的次数。如果图像格式不支持动画，则返回0 。

QByteArray QImageIOHandler.name (self)

int QImageIOHandler.nextImageDelay (self)

对于支持动画图像格式，该函数返回的毫秒数要等到读取下一个图像。如果图像格式不支持动画，则返回0 。

QVariant QImageIOHandler.option (self, ImageOption option)

返回指定的值option作为QVariant。值的类型取决于选项。例如，选项（尺寸）返回一个QSize变体。

See also setOption（）和supportsOption（ ） 。

bool QImageIOHandler.read (self, QImage image)

这种方法是抽象的，应在任何子类中重新实现。

从设备中读取的图像，并将其存储在image。返回True如果图像被成功读取，否则返回False 。

对于支持增量加载的图像格式，并为动画格式，图像处理程序可以假设image指向前一帧。

See also canRead（ ） 。

QImageIOHandler.setDevice (self, QIODevice device)

设置的设备QImageIOHandler至device。读取和写入图像时的图像处理程序将使用该设备。

该设备只能设置一次，并调用之前必须设置canRead（ ）read（ ）write（ ）等，如果你需要读取多个文件，建立相应的多个实例QImageIOHandler子类。

See also device（ ） 。

QImageIOHandler.setFormat (self, QByteArray format)

设置的格式QImageIOHandler至format。该格式是支持多种格式的图像处理程序非常有用。

See also format（ ） 。

QImageIOHandler.setOption (self, ImageOption option, QVariant value)

设置选项option与该值value。

See also option（）和ImageOption。

bool QImageIOHandler.supportsOption (self, ImageOption option)

返回True如果QImageIOHandler支持选项option否则返回False 。例如，如果QImageIOHandler支持Size选项， supportsOption （尺寸）必须返回True 。

See also setOption（）和option（ ） 。

bool QImageIOHandler.write (self, QImage image)

写入图像image到所分配的设备。成功时返回TRUE ，否则返回False 。

默认实现不执行任何操作，并简单地返回False 。