QPictureIO Class Reference

QPictureIO Class Reference

[QtGui module]

该QPictureIO类包含用于加载和保存图片的参数。More…

Methods

__init__ (self)
__init__ (self, QIODevice ioDevice, str format)
__init__ (self, QString fileName, str format)
QString description (self)
QString fileName (self)
str format (self)
float gamma (self)
QIODevice ioDevice (self)
str parameters (self)
QPicture picture (self)
int quality (self)
bool read (self)
setDescription (self, QString)
setFileName (self, QString)
setFormat (self, str)
setGamma (self, float)
setIODevice (self, QIODevice)
setParameters (self, str)
setPicture (self, QPicture)
setQuality (self, int)
setStatus (self, int)
int status (self)
bool write (self)

Static Methods

defineIOHandler (str format, str header, str flags, callable read_picture, callable write_picture)
list-of-QByteArray inputFormats ()
list-of-QByteArray outputFormats ()
QByteArray pictureFormat (QString fileName)
QByteArray pictureFormat (QIODevice)

Detailed Description

该QPictureIO类包含用于加载和保存图片的参数。

QPictureIO包含一个QIODevice对象是用于图像数据I / O。程序员可以在除了那些Qt提供了安装新的图片文件格式。

你通常不需要使用这个类;QPicture.load（）QPicture.save（）。

Method Documentation

QPictureIO.__init__ (self)

构造一个QPictureIO对象设置为零的所有参数。

QPictureIO.__init__ (self, QIODevice ioDevice, str format)

构造一个QPictureIO与I / O设备对象ioDevice和format标记。

QPictureIO.__init__ (self, QString fileName, str format)

构造一个QPictureIO用文件名对象fileName和format标记。

QPictureIO.defineIOHandler (str format, str header, str flags, callable read_picture, callable write_picture)

该read_picture参数也可能没有。

该write_picture参数也可能没有。

定义图片的I / O处理程序称为图片格式format，其使用中所定义的正则表达式被确认header，读取使用readPicture并采用书面writePicture。

flags是一个字符串的单字符标志这种格式。定义的唯一标志目前为T （大写），所以唯一的合法值flags是“T”和空字符串。 “T”型标志表示该图像文件是一个文本文件，和Qt应该把所有的换行符约定等同。（ XPM文件和一些PPM文件是文本文件的例子。）

format用于选择处理程序写QPicture;header用于选择一个处理器来读取一个图像文件。

If readPicture是一个空指针，QPictureIO将无法读取图片中format。如果writePicture是一个空指针，QPictureIO将无法在写图片format。如果两者都为null，则QPictureIO对象是有效的，但没用。

例如：

 void readSVG([QPictureIO]($docs-qpictureio.html) *picture)
 {
     // read the picture using the picture->ioDevice()
 }
 void writeSVG([QPictureIO]($docs-qpictureio.html) *picture)
 {
     // write the picture using the picture->ioDevice()
 }
     // add the SVG picture handler
     // ...

正则表达式测试前，在文件头全部为0字节转换为1个字节。这样做是因为当Qt的是基于ASCII的，QRegExp无法处理的字符串0字节。

正则表达式只适用于前14个字节的文件。

（请注意，如果一个handlerIO支持写入的格式，另外支持读取它， Qt支持读取和写入。如果两个处理器都支持相同的操作， Qt的选择一个武断。）

QString QPictureIO.description (self)

返回图片描述字符串。

See also setDescription（）。

QString QPictureIO.fileName (self)

返回当前设置的文件名。

See also setFileName（）。

str QPictureIO.format (self)

返回图片格式的字符串或0 ，如果没有格式已显式设置。

See also setFormat（）。

float QPictureIO.gamma (self)

返回在其照片将被视为伽玛值。

See also setGamma（）。

list-of-QByteArray QPictureIO.inputFormats ()

返回所支持的图像输入格式图片排序列表。

QIODevice QPictureIO.ioDevice (self)

[

返回当前设置的IO设备。

]($docs-qiodevice.html)

See also setIODevice（）。

list-of-QByteArray QPictureIO.outputFormats ()

返回所支持的图像输出图像格式排序列表。

str QPictureIO.parameters (self)

返回图片的参数字符串。

See also setParameters（）。

QPicture QPictureIO.picture (self)

[

返回当前设置的图片。

]($docs-qpicture.html)

See also setPicture（）。

QByteArray QPictureIO.pictureFormat (QString fileName)

[

返回一个字符串，该字符串指定的文件的图片格式fileName，或null，如果文件不能被读取或者格式无法识别。

]($docs-qbytearray.html)

QByteArray QPictureIO.pictureFormat (QIODevice)

[

这是一个重载函数。

返回一个字符串，它指定从IO设备读取图片的图片格式d，或者0，如果设备无法读取或者格式无法识别。

确保d是在设备（例如，在文件的开头）的位置上。

]($docs-qbytearray.html)

See also QIODevice.at（）。

int QPictureIO.quality (self)

返回写入的图像的质量，相关的压缩比。

See also setQuality（）和QPicture.save（）。

bool QPictureIO.read (self)

读取图片到内存中，并返回True，如果图片是成功读取，否则返回False 。

在阅读的图片，你必须设置一个IO设备或文件名。如果两个IO设备和一个文件名被设置， IO装置将被使用。

设置图像文件的格式字符串是可选的。

请注意，这个函数not设置format用于读取图像。如果您需要这些信息，使用pictureFormat（）静态函数。

例如：

         [QPictureIO]($docs-qpictureio.html) iio;
         [QPixmap](qpixmap.html)  pixmap;
         iio.setFileName("vegeburger.pic");
         if (iio.read()) {        // OK
             [QPicture]($docs-qpicture.html) picture = iio.picture();
             [QPainter](qpainter.html) painter(&pixmap);
             painter.drawPicture(0, 0, picture);
         }

See also setIODevice（）setFileName（）setFormat（）write（）和QPixmap.load（）。

QPictureIO.setDescription (self, QString)

将画面设置描述字符串为支持图片说明，以图片处理程序description。

目前， Qt所支持无图像格式使用的描述字符串。

See also description（）。

QPictureIO.setFileName (self, QString)

设置读取或写入一个图片文件的名称从到fileName。

See also fileName（）和setIODevice（）。

QPictureIO.setFormat (self, str)

设置图片格式format对图像进行读取或写入。

有必要写入一个画面之前指定格式，但它不是必需的阅读一个图像之前指定的格式。

如果没有指定格式已定， Qt的猜测图片的格式读取它。如果格式被设置，如果它有格式的图片才会被读取。

See also read（）write（）和format（）。

QPictureIO.setGamma (self, float)

设置在该画面将被视为对伽玛值gamma。如果图像格式存储的伽马值的量，图像拟被使用，那么该设置将被用于修改图像。设置为0.0将禁用gamma校正（即文件中的任何规范将被忽略）。

默认值是0.0 。

See also gamma（）。

QPictureIO.setIODevice (self, QIODevice)

设置IO设备用于读取或写入的图像。

设置IO设备使照片可读取/写入任何面向块QIODevice。

If ioDevice不为空，这个IO设备将复盖文件名设置。

See also setFileName（）。

QPictureIO.setParameters (self, str)

图片的参数字符串设置为parameters。这对于那些需要特殊参数图片处理程序。

虽然Qt所支持当前图片格式忽略的参数字符串，它可能会在未来的扩展或贡献（例如， JPEG）使用。

See also parameters（）。

QPictureIO.setPicture (self, QPicture)

将画面设置为picture。

See also picture（）。

QPictureIO.setQuality (self, int)

设置写入的图像的质量q，相关的压缩比。

q必须在范围-1 .. 100 。指定0以获得小的压缩文件， 100为大型未压缩的文件。（-1表示默认的压缩。）

See also quality（）和QPicture.save（）。

QPictureIO.setStatus (self, int)

将画面设置的IO状态status。一个非零值表示错误，而0表示IO操作是成功的。

See also status（）。

int QPictureIO.status (self)

返回图片的IO状态。一个非零值表示错误，而0表示IO操作是成功的。

See also setStatus（）。

bool QPictureIO.write (self)

写一个图片IO设备并返回True如果图片被成功写入，否则返回False 。

之前写一个图片，你必须设置一个IO设备或文件名。如果两个IO设备和一个文件名被设置， IO装置将被使用。

图片将使用指定的图片格式写入。

例如：

         [QPictureIO]($docs-qpictureio.html) iio;
         [QPicture]($docs-qpicture.html)   picture;
         [QPainter](qpainter.html) painter(&picture);
         painter.drawPixmap(0, 0, pixmap);
         iio.setPicture(picture);
         iio.setFileName("vegeburger.pic");
         iio.setFormat("PIC");
         if (iio.write())
             return true; // returned true if written successfully

See also setIODevice（）setFileName（）setFormat（）read（）和QPixmap.save（）。