QPictureIO Class Reference · PyQt4 中文文檔

# QPictureIO Class Reference ## [[QtGui](index.htm) module] 該QPictureIO類包含用于加載和保存圖片的參數。[More...](#details) ### 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](qiodevice.html)對象是用于圖像數據I / O。程序員可以在除了那些Qt提供了安裝新的圖片文件格式。你通常不需要使用這個類;[QPicture.load](qpicture.html#load)（）[QPicture.save](qpicture.html#save)（）。 * * * ## Method Documentation ``` QPictureIO.__init__ (self) ``` 構造一個[QPictureIO](qpictureio.html)對象設置為零的所有參數。 ``` QPictureIO.__init__ (self, QIODevice?ioDevice, str?format) ``` 構造一個[QPictureIO](qpictureio.html)與I / O設備對象_ioDevice_和_format_標記。 ``` QPictureIO.__init__ (self, QString?fileName, str?format) ``` 構造一個[QPictureIO](qpictureio.html)用文件名對象_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](qpicture.html);_header_用于選擇一個處理器來讀取一個圖像文件。 If _readPicture_是一個空指針，[QPictureIO](qpictureio.html)將無法讀取圖片中_format_。如果_writePicture_是一個空指針，[QPictureIO](qpictureio.html)將無法在寫圖片_format_。如果兩者都為null，則[QPictureIO](qpictureio.html)對象是有效的，但沒用。例如： ``` void readSVG([QPictureIO](qpictureio.html) *picture) { // read the picture using the picture->ioDevice() } void writeSVG([QPictureIO](qpictureio.html) *picture) { // write the picture using the picture->ioDevice() } // add the SVG picture handler // ... ``` 正則表達式測試前，在文件頭全部為0字節轉換為1個字節。這樣做是因為當Qt的是基于ASCII的，[QRegExp](qregexp.html)無法處理的字符串0字節。正則表達式只適用于前14個字節的文件。（請注意，如果一個handlerIO支持寫入的格式，另外支持讀取它， Qt支持讀取和寫入。如果兩個處理器都支持相同的操作， Qt的選擇一個武斷。） ``` QString QPictureIO.description (self) ``` 返回圖片描述字符串。 **See also** [setDescription](qpictureio.html#setDescription)（）。 ``` QString QPictureIO.fileName (self) ``` 返回當前設置的文件名。 **See also** [setFileName](qpictureio.html#setFileName)（）。 ``` str QPictureIO.format (self) ``` 返回圖片格式的字符串或0 ，如果沒有格式已顯式設置。 **See also** [setFormat](qpictureio.html#setFormat)（）。 ``` float QPictureIO.gamma (self) ``` 返回在其照片將被視為伽瑪值。 **See also** [setGamma](qpictureio.html#setGamma)（）。 ``` list-of-QByteArray QPictureIO.inputFormats () ``` 返回所支持的圖像輸入格式圖片排序列表。 ``` QIODevice QPictureIO.ioDevice (self) ``` [ 返回當前設置的IO設備。 ](qiodevice.html) [**See also**](qiodevice.html) [setIODevice](qpictureio.html#setIODevice)（）。 ``` list-of-QByteArray QPictureIO.outputFormats () ``` 返回所支持的圖像輸出圖像格式排序列表。 ``` str QPictureIO.parameters (self) ``` 返回圖片的參數字符串。 **See also** [setParameters](qpictureio.html#setParameters)（）。 ``` QPicture QPictureIO.picture (self) ``` [ 返回當前設置的圖片。 ](qpicture.html) [**See also**](qpicture.html) [setPicture](qpictureio.html#setPicture)（）。 ``` QByteArray QPictureIO.pictureFormat (QString?fileName) ``` [ 返回一個字符串，該字符串指定的文件的圖片格式_fileName_，或null，如果文件不能被讀取或者格式無法識別。 ](qbytearray.html) ``` QByteArray QPictureIO.pictureFormat (QIODevice) ``` [ 這是一個重載函數。返回一個字符串，它指定從IO設備讀取圖片的圖片格式_d_，或者0，如果設備無法讀取或者格式無法識別。確保_d_是在設備（例如，在文件的開頭）的位置上。 ](qbytearray.html) [**See also**](qbytearray.html) [QIODevice.at](index.htm#at)（）。 ``` int QPictureIO.quality (self) ``` 返回寫入的圖像的質量，相關的壓縮比。 **See also** [setQuality](qpictureio.html#setQuality)（）和[QPicture.save](qpicture.html#save)（）。 ``` bool QPictureIO.read (self) ``` 讀取圖片到內存中，并返回True，如果圖片是成功讀取，否則返回False 。在閱讀的圖片，你必須設置一個IO設備或文件名。如果兩個IO設備和一個文件名被設置， IO裝置將被使用。設置圖像文件的格式字符串是可選的。請注意，這個函數_not_設置[format](qpictureio.html#format)用于讀取圖像。如果您需要這些信息，使用[pictureFormat](qpictureio.html#pictureFormat)（）靜態函數。例如： ``` [QPictureIO](qpictureio.html) iio; [QPixmap](qpixmap.html) pixmap; iio.setFileName("vegeburger.pic"); if (iio.read()) { // OK [QPicture](qpicture.html) picture = iio.picture(); [QPainter](qpainter.html) painter(&pixmap); painter.drawPicture(0, 0, picture); } ``` **See also** [setIODevice](qpictureio.html#setIODevice)（）[setFileName](qpictureio.html#setFileName)（）[setFormat](qpictureio.html#setFormat)（）[write](qpictureio.html#write)（）和[QPixmap.load](qpixmap.html#load)（）。 ``` QPictureIO.setDescription (self, QString) ``` 將畫面設置描述字符串為支持圖片說明，以圖片處理程序_description_。目前， Qt所支持無圖像格式使用的描述字符串。 **See also** [description](qpictureio.html#description)（）。 ``` QPictureIO.setFileName (self, QString) ``` 設置讀取或寫入一個圖片文件的名稱從到_fileName_。 **See also** [fileName](qpictureio.html#fileName)（）和[setIODevice](qpictureio.html#setIODevice)（）。 ``` QPictureIO.setFormat (self, str) ``` 設置圖片格式_format_對圖像進行讀取或寫入。有必要寫入一個畫面之前指定格式，但它不是必需的閱讀一個圖像之前指定的格式。如果沒有指定格式已定， Qt的猜測圖片的格式讀取它。如果格式被設置，如果它有格式的圖片才會被讀取。 **See also** [read](qpictureio.html#read)（）[write](qpictureio.html#write)（）和[format](qpictureio.html#format)（）。 ``` QPictureIO.setGamma (self, float) ``` 設置在該畫面將被視為對伽瑪值_gamma_。如果圖像格式存儲的伽馬值的量，圖像擬被使用，那么該設置將被用于修改圖像。設置為0.0將禁用gamma校正（即文件中的任何規范將被忽略）。默認值是0.0 。 **See also** [gamma](qpictureio.html#gamma)（）。 ``` QPictureIO.setIODevice (self, QIODevice) ``` 設置IO設備用于讀取或寫入的圖像。設置IO設備使照片可讀取/寫入任何面向塊[QIODevice](qiodevice.html)。 If _ioDevice_不為空，這個IO設備將復蓋文件名設置。 **See also** [setFileName](qpictureio.html#setFileName)（）。 ``` QPictureIO.setParameters (self, str) ``` 圖片的參數字符串設置為_parameters_。這對于那些需要特殊參數圖片處理程序。雖然Qt所支持當前圖片格式忽略的參數字符串，它可能會在未來的擴展或貢獻（例如， JPEG）使用。 **See also** [parameters](qpictureio.html#parameters)（）。 ``` QPictureIO.setPicture (self, QPicture) ``` 將畫面設置為_picture_。 **See also** [picture](qpictureio.html#picture)（）。 ``` QPictureIO.setQuality (self, int) ``` 設置寫入的圖像的質量_q_，相關的壓縮比。 _q_必須在范圍-1 .. 100 。指定0以獲得小的壓縮文件， 100為大型未壓縮的文件。（-1表示默認的壓縮。） **See also** [quality](qpictureio.html#quality)（）和[QPicture.save](qpicture.html#save)（）。 ``` QPictureIO.setStatus (self, int) ``` 將畫面設置的IO狀態_status_。一個非零值表示錯誤，而0表示IO操作是成功的。 **See also** [status](qpictureio.html#status)（）。 ``` int QPictureIO.status (self) ``` 返回圖片的IO狀態。一個非零值表示錯誤，而0表示IO操作是成功的。 **See also** [setStatus](qpictureio.html#setStatus)（）。 ``` bool QPictureIO.write (self) ``` 寫一個圖片IO設備并返回True如果圖片被成功寫入，否則返回False 。之前寫一個圖片，你必須設置一個IO設備或文件名。如果兩個IO設備和一個文件名被設置， IO裝置將被使用。圖片將使用指定的圖片格式寫入。例如： ``` [QPictureIO](qpictureio.html) iio; [QPicture](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](qpictureio.html#setIODevice)（）[setFileName](qpictureio.html#setFileName)（）[setFormat](qpictureio.html#setFormat)（）[read](qpictureio.html#read)（）和[QPixmap.save](qpixmap.html#save)（）。