QImageReader Class Reference · PyQt4 中文文檔

# QImageReader Class Reference ## [[QtGui](index.htm) module] 該QImageReader類提供了從文件或其它設備讀取圖像的格式無關的接口。[More...](#details) ### Types * `enum ImageReaderError { UnknownError, FileNotFoundError, DeviceError, UnsupportedFormatError, InvalidDataError }` ### Methods * `__init__ (self)` * `__init__ (self, QIODevice?device, QByteArray?format?=?QByteArray())` * `__init__ (self, QString?fileName, QByteArray?format?=?QByteArray())` * `bool autoDetectImageFormat (self)` * `QColor backgroundColor (self)` * `bool canRead (self)` * `QRect clipRect (self)` * `int currentImageNumber (self)` * `QRect currentImageRect (self)` * `bool decideFormatFromContent (self)` * `QIODevice device (self)` * `ImageReaderError error (self)` * `QString errorString (self)` * `QString fileName (self)` * `QByteArray format (self)` * `int imageCount (self)` * `QImage.Format imageFormat (self)` * `bool jumpToImage (self, int?imageNumber)` * `bool jumpToNextImage (self)` * `int loopCount (self)` * `int nextImageDelay (self)` * `int quality (self)` * `QImage read (self)` * `bool read (self, QImage?image)` * `QRect scaledClipRect (self)` * `QSize scaledSize (self)` * `setAutoDetectImageFormat (self, bool?enabled)` * `setBackgroundColor (self, QColor?color)` * `setClipRect (self, QRect?rect)` * `setDecideFormatFromContent (self, bool?ignored)` * `setDevice (self, QIODevice?device)` * `setFileName (self, QString?fileName)` * `setFormat (self, QByteArray?format)` * `setQuality (self, int?quality)` * `setScaledClipRect (self, QRect?rect)` * `setScaledSize (self, QSize?size)` * `QSize size (self)` * `bool supportsAnimation (self)` * `bool supportsOption (self, QImageIOHandler.ImageOption?option)` * `QString text (self, QString?key)` * `QStringList textKeys (self)` ### Static Methods * `QByteArray imageFormat (QString?fileName)` * `QByteArray imageFormat (QIODevice?device)` * `list-of-QByteArray supportedImageFormats ()` * * * ## Detailed Description 該QImageReader類提供了從文件或其它設備讀取圖像的格式無關的接口。對圖像進行讀取的最常見的方式是通過[QImage](qimage.html)和[QPixmap](qpixmap.html)的構造函數，或致電[QImage.load](qimage.html#load)（）和[QPixmap.load](qpixmap.html#load)（）。 QImageReader是一家專業類閱讀圖像時它給你更多的控制。例如，你可以通過調用讀取圖像到一個特定的大小[setScaledSize](qimagereader.html#setScaledSize)（），你可以選擇一個剪輯矩形，有效地只加載部分的圖像，通過調用[setClipRect](qimagereader.html#setClipRect)（）。根據不同的圖像格式的支持基礎上的，這樣可以節省內存，加快加載圖像。要讀取的圖像，你通過構建一個QImageReader對象開始。通過其中一個文件名或設備指針，圖像格式QImageReader的構造函數。然后，您可以設置多個選項，如剪輯矩形（通過調用[setClipRect](qimagereader.html#setClipRect)（））和縮放大小（通過調用[setScaledSize](qimagereader.html#setScaledSize)（））。[canRead](qimagereader.html#canRead)（）返回的圖像，如果QImageReader可以讀取圖像（即，被支持的圖像格式和設備開放閱讀）。通話[read](qimagereader.html#read)（）來讀取該圖像。如果在讀取圖像時出現任何錯誤，[read](qimagereader.html#read)（）將返回一個null[QImage](qimage.html)。然后，您可以調用[error](qimagereader.html#error)（）找到所發生的錯誤的類型，或者[errorString](qimagereader.html#errorString)（）來得到一個什么地方出了錯人類可讀的描述。 Call [supportedImageFormats](qimagereader.html#supportedImageFormats)（）用于該QImageReader可以閱讀格式的列表。 QImageReader支持所有內置的圖像格式，除了支持讀取任何圖像格式的插件。 QImageReader自動檢測默認的圖像格式，通過查看所提供（可選）格式字符串，文件名后綴，和數據流內容。您可以啟用或禁用此功能，通過調用[setAutoDetectImageFormat](qimagereader.html#setAutoDetectImageFormat)（）。 * * * ## Type Documentation ``` QImageReader.ImageReaderError ``` 這個枚舉變量描述了不同類型的錯誤與讀取圖像時可能發生的[QImageReader](qimagereader.html)。 | Constant | Value | Description | | --- | --- | --- | | `QImageReader.FileNotFoundError` | `1` | [QImageReader](qimagereader.html)被使用的文件名，而不是文件被發現使用該名稱。這也可能發生，如果文件名不包含擴展名，不支持的Qt用正確的擴展名的文件。 | | `QImageReader.DeviceError` | `2` | [QImageReader](qimagereader.html)讀取圖像時遇到設備錯誤。您可以諮詢您的特定設備上出了什么問題的更多細節。 | | `QImageReader.UnsupportedFormatError` | `3` | Qt不支持所請求的圖像的格式。 | | `QImageReader.InvalidDataError` | `4` | 圖像數據是無效的，并[QImageReader](qimagereader.html)無法從中讀取圖像。如果圖像文件被損壞可能發生。 | | `QImageReader.UnknownError` | `0` | 發生未知錯誤。如果在調用后得到這個值[read](qimagereader.html#read)（），它是最有可能的一個錯誤引起的[QImageReader](qimagereader.html)。 | * * * ## Method Documentation ``` QImageReader.__init__ (self) ``` 構造一個空[QImageReader](qimagereader.html)對象。在閱讀的圖像，調用[setDevice](qimagereader.html#setDevice)（）或[setFileName](qimagereader.html#setFileName)（）。 ``` QImageReader.__init__ (self, QIODevice?device, QByteArray?format?=?QByteArray()) ``` 構造一個[QImageReader](qimagereader.html)與設備對象_device_和圖像格式_format_。 ``` QImageReader.__init__ (self, QString?fileName, QByteArray?format?=?QByteArray()) ``` 構造一個[QImageReader](qimagereader.html)用文件名對象_fileName_和圖像格式_format_。 **See also** [setFileName](qimagereader.html#setFileName)（）。 ``` bool QImageReader.autoDetectImageFormat (self) ``` 返回True如果圖像格式自動檢測是對這個形象的讀者能，否則返回False 。默認情況下，自動檢測被啟用。 **See also** [setAutoDetectImageFormat](qimagereader.html#setAutoDetectImageFormat)（）。 ``` QColor QImageReader.backgroundColor (self) ``` [ 返回的閱讀一個圖像時使用的背景顏色。如果圖像格式不支持設置背景色無效的顏色恢復。這個函數是Qt 4.1中引入。 ](qcolor.html) [**See also**](qcolor.html) [setBackgroundColor](qimagereader.html#setBackgroundColor)（）和[read](qimagereader.html#read)（）。 ``` bool QImageReader.canRead (self) ``` 返回True如果圖像可以讀取的設備（例如，支持的圖像格式，并且該設備似乎包含有效的數據），否則返回False 。的CanRead （）是一個輕量級函數只能執行快速測試以查看該圖像數據是有效的。[read](qimagereader.html#read)（）的CanRead后仍可能返回False （）返回True ，如果圖像數據被破壞。對于支持動畫影像時，所有幀都被讀取，的CanRead （）返回False 。 **See also** [read](qimagereader.html#read)（）和[supportedImageFormats](qimagereader.html#supportedImageFormats)（）。 ``` QRect QImageReader.clipRect (self) ``` [](qrect.html) [返回圖像的剪輯矩形（也被稱為ROI ，或感興趣區域）。如果沒有剪輯矩形已定，一個無效的](qrect.html)[QRect](qrect.html)返回。 **See also** [setClipRect](qimagereader.html#setClipRect)（）。 ``` int QImageReader.currentImageNumber (self) ``` 對于支持動畫圖像格式，該函數返回當前幀的序列號。如果圖像格式不支持動畫，則返回0 。該函數返回-1，如果發生了錯誤。 **See also** [supportsAnimation](qimagereader.html#supportsAnimation)（）[QImageIOHandler.currentImageNumber](qimageiohandler.html#currentImageNumber)（）和[canRead](qimagereader.html#canRead)（）。 ``` QRect QImageReader.currentImageRect (self) ``` [ 對于支持動畫圖像格式，該函數返回的矩形為當前幀。否則，將返回一個空矩形。 ](qrect.html) [**See also**](qrect.html) [supportsAnimation](qimagereader.html#supportsAnimation)（）和[QImageIOHandler.currentImageRect](qimageiohandler.html#currentImageRect)（）。 ``` bool QImageReader.decideFormatFromContent (self) ``` 返回的圖像讀取器是否應該決定哪些插件只使用基于數據流的內容，而不是文件擴展名。 **See also** [setDecideFormatFromContent](qimagereader.html#setDecideFormatFromContent)（）。 ``` QIODevice QImageReader.device (self) ``` [](qiodevice.html) [返回當前分配給設備](qiodevice.html)[QImageReader](qimagereader.html)，或者0，如果沒有設備已經被分配。 **See also** [setDevice](qimagereader.html#setDevice)（）。 ``` ImageReaderError QImageReader.error (self) ``` [ 返回上次發生錯誤的類型。 ](qimagereader.html#ImageReaderError-enum) [**See also**](qimagereader.html#ImageReaderError-enum) [ImageReaderError](qimagereader.html#ImageReaderError-enum)和[errorString](qimagereader.html#errorString)（）。 ``` QString QImageReader.errorString (self) ``` 返回上次發生錯誤的可讀描述。 **See also** [error](qimagereader.html#error)（）。 ``` QString QImageReader.fileName (self) ``` 如果當前分配裝置是[QFile](qfile.html)，或者如果[setFileName](qimagereader.html#setFileName)（）被調用，此函數返回文件的名稱[QImageReader](qimagereader.html)讀取。否則（即，如果沒有設備已被分配或設備不是[QFile](qfile.html)），空[QString](qstring.html)返回。 **See also** [setFileName](qimagereader.html#setFileName)（）和[setDevice](qimagereader.html#setDevice)（）。 ``` QByteArray QImageReader.format (self) ``` [](qbytearray.html) [返回格式](qbytearray.html)[QImageReader](qimagereader.html)用來讀取圖像。可以分配一個設備向讀者以確定該設備的格式之后，調用此函數。例如： ``` [QImageReader](qimagereader.html) reader("image.png"); // reader.format() == "png" ``` 如果讀者不能從設備讀取任何圖像（例如，沒有圖像出現，或圖像已經被讀取），或者如果格式是不支持的，這個函數返回一個空QByteArray中（）。 **See also** [setFormat](qimagereader.html#setFormat)（）和[supportedImageFormats](qimagereader.html#supportedImageFormats)（）。 ``` int QImageReader.imageCount (self) ``` 對于支持動畫圖像格式，該函數返回的動畫圖像的總數。如果格式不支持動畫，則返回0 。該函數返回-1，如果發生了錯誤。 **See also** [supportsAnimation](qimagereader.html#supportsAnimation)（）[QImageIOHandler.imageCount](qimageiohandler.html#imageCount)（）和[canRead](qimagereader.html#canRead)（）。 ``` QByteArray QImageReader.imageFormat (QString?fileName) ``` [](qbytearray.html) [返回的圖像的格式，而無需實際讀出圖像的內容。該格式描述的圖像格式](qbytearray.html)[QImageReader.read](qimagereader.html#read)（）返回，而不是實際的圖像的格式。如果圖像格式不支持此功能，這個函數返回一個無效的格式。此功能被引入Qt的4.5 。 **See also** [QImageIOHandler.ImageOption](qimageiohandler.html#ImageOption-enum)，[QImageIOHandler.option](qimageiohandler.html#option)（）和[QImageIOHandler.supportsOption](qimageiohandler.html#supportsOption)（）。 ``` QByteArray QImageReader.imageFormat (QIODevice?device) ``` [ 如果支持的話，這個函數返回文件的圖像格式_fileName_。否則，返回一個空字符串。 ](qbytearray.html) ``` QImage.Format QImageReader.imageFormat (self) ``` [ 如果支持，則該函數返回設備的圖像格式_device_。否則，返回一個空字符串。 ](qimage.html#Format-enum) [**See also**](qimage.html#Format-enum) [QImageReader.autoDetectImageFormat](qimagereader.html#autoDetectImageFormat)（）。 ``` bool QImageReader.jumpToImage (self, int?imageNumber) ``` 對于支持動畫圖像格式，該函數將跳到其序列號是圖像_imageNumber_，返回True，如果成功則返回False相應的圖像不能被發現。到下一次調用[read](qimagereader.html#read)（）將嘗試讀取這個形象。 **See also** [jumpToNextImage](qimagereader.html#jumpToNextImage)（）和[QImageIOHandler.jumpToImage](qimageiohandler.html#jumpToImage)（）。 ``` bool QImageReader.jumpToNextImage (self) ``` 對于支持動畫圖像格式，該功能的步驟在當前圖像，返回True，如果成功或假，如果有在動畫沒有下面的圖像。默認實現調用[read](qimagereader.html#read)（），則丟棄所得到的圖像，但圖像處理程序可能必須執行這一操作的更有效的方法。 **See also** [jumpToImage](qimagereader.html#jumpToImage)（）和[QImageIOHandler.jumpToNextImage](qimageiohandler.html#jumpToNextImage)（）。 ``` int QImageReader.loopCount (self) ``` 對于支持動畫圖像格式，該函數返回的時候動畫應該循環的次數。如果這個函數返回-1 ，它可以意味著動畫應該永遠循環下去，或者發生了錯誤。如果發生錯誤，則[canRead](qimagereader.html#canRead)（）將返回False 。 **See also** [supportsAnimation](qimagereader.html#supportsAnimation)（）[QImageIOHandler.loopCount](qimageiohandler.html#loopCount)（）和[canRead](qimagereader.html#canRead)（）。 ``` int QImageReader.nextImageDelay (self) ``` 對于支持動畫圖像格式，該函數返回的毫秒數要等到顯示在動畫的下一幀。如果圖像格式不支持動畫，則返回0 。該函數返回-1，如果發生了錯誤。 **See also** [supportsAnimation](qimagereader.html#supportsAnimation)（）[QImageIOHandler.nextImageDelay](qimageiohandler.html#nextImageDelay)（）和[canRead](qimagereader.html#canRead)（）。 ``` int QImageReader.quality (self) ``` 返回的圖像的質量級別。這個函數中引入了Qt 4.2中。 **See also** [setQuality](qimagereader.html#setQuality)（）。 ``` QImage QImageReader.read (self) ``` [](qimage.html) [讀取從設備中的圖像。成功時，所讀取的圖像傳回，否則空](qimage.html)[QImage](qimage.html)返回。然后，您可以調用[error](qimagereader.html#error)（）找到所發生的錯誤的類型，或者[errorString](qimagereader.html#errorString)（）來獲得錯誤的可讀描述。對于支持動畫，調用讀取的圖像格式（）多次將返回下一幀。當所有的幀都被讀取，一個空的圖像將被退回。 **See also** [canRead](qimagereader.html#canRead)（）[supportedImageFormats](qimagereader.html#supportedImageFormats)（）[supportsAnimation](qimagereader.html#supportsAnimation)（）和[QMovie](qmovie.html)。 ``` bool QImageReader.read (self, QImage?image) ``` 這是一個重載函數。讀取從設備中的圖像進_image_，它必須指向一個[QImage](qimage.html)。成功時返回TRUE ，否則返回False 。 If _image_具有相同的格式和大小，因為這是將要讀取的圖像數據，此功能可能并不需要閱讀之前，分配一個新的形象。正因為如此，它可以比其它快[read](qimagereader.html#read)（）重載，它總是構造一個新的形象;讀取多個圖像具有相同的格式和大小時尤其如此。 ``` [QImage](qimage.html) icon(64, 64, [QImage](qimage.html).Format_RGB32); [QImageReader](qimagereader.html) reader("icon_64x64.bmp"); if (reader.read(&icon)) { // Display icon } ``` 對于支持動畫，調用圖像格式[read](qimagereader.html#read)（）多次將返回下一幀。當所有的幀都被讀取，一個空的圖像將被退回。 **See also** [canRead](qimagereader.html#canRead)（）[supportedImageFormats](qimagereader.html#supportedImageFormats)（）[supportsAnimation](qimagereader.html#supportsAnimation)（）和[QMovie](qmovie.html)。 ``` QRect QImageReader.scaledClipRect (self) ``` [ 返回的圖像的縮放的夾子正確。 ](qrect.html) [**See also**](qrect.html) [setScaledClipRect](qimagereader.html#setScaledClipRect)（）。 ``` QSize QImageReader.scaledSize (self) ``` [ 返回的圖像的縮放大小。 ](qsize.html) [**See also**](qsize.html) [setScaledSize](qimagereader.html#setScaledSize)（）。 ``` QImageReader.setAutoDetectImageFormat (self, bool?enabled) ``` If _enabled_誠然，圖像格式自動檢測被啟用，否則，它被禁用。默認情況下，自動檢測被啟用。 [QImageReader](qimagereader.html)使用廣泛的方法來檢測圖像格式：首先，如果你傳遞一個文件名[QImageReader](qimagereader.html)，它會嘗試檢測文件的擴展名，如果給定的文件名不指向現有的文件，通過追加支持默認擴展到給定的文件名，一次一個。然后使用下面的方法來檢測圖像格式： * Image plugins are queried first, based on either the optional format string, or the file name suffix (if the source device is a file). No content detection is done at this stage. [QImageReader](qimagereader.html) will choose the first plugin that supports reading for this format. * If no plugin supports the image format, Qt's built-in handlers are checked based on either the optional format string, or the file name suffix. * If no capable plugins or built-in handlers are found, each plugin is tested by inspecting the content of the data stream. * If no plugins could detect the image format based on data contents, each built-in image handler is tested by inspecting the contents. * Finally, if all above approaches fail, [QImageReader](qimagereader.html) will report failure when trying to read the image. 通過禁用圖像格式自動檢測，[QImageReader](qimagereader.html)只有查詢的基礎上，格式字符串（例如，沒有文件擴展名進行測試）的插件和內置的處理程序。 **See also** [autoDetectImageFormat](qimagereader.html#autoDetectImageFormat)（）[QImageIOHandler.canRead](qimageiohandler.html#canRead)（）和[QImageIOPlugin.capabilities](index.htm#capabilities)（）。 ``` QImageReader.setBackgroundColor (self, QColor?color) ``` 設置背景色為_color_。支持此操作的圖像格式，預計到后臺初始化_color_前閱讀一個圖像。這個函數是Qt 4.1中引入。 **See also** [backgroundColor](qimagereader.html#backgroundColor)（）和[read](qimagereader.html#read)（）。 ``` QImageReader.setClipRect (self, QRect?rect) ``` 設定影像剪輯矩形（也稱為投資回報率，或感興趣區域），以_rect_。的坐標_rect_是相對于未轉化的圖像的大小，所返回的[size](qimagereader.html#size)（）。 **See also** [clipRect](qimagereader.html#clipRect)（）[setScaledSize](qimagereader.html#setScaledSize)（）和[setScaledClipRect](qimagereader.html#setScaledClipRect)（）。 ``` QImageReader.setDecideFormatFromContent (self, bool?ignored) ``` If _ignored_設置為True ，則圖像閱讀器將忽略指定的格式或文件擴展名，并決定哪些插件只是基于在數據流中的內容使用。設置這個標志意味著所有圖像插件被加載。每個插件將讀取的圖像數據的第一個字節，并決定是否插件兼容與否。這也將禁用自動檢測的圖像格式。 **See also** [decideFormatFromContent](qimagereader.html#decideFormatFromContent)（）。 ``` QImageReader.setDevice (self, QIODevice?device) ``` Sets [QImageReader](qimagereader.html)的設備_device_。如果設備已經被設置，舊設備是從除去[QImageReader](qimagereader.html)而在其他情況保持不變。如果該設備尚未打開，[QImageReader](qimagereader.html)將嘗試在打開設備[QIODevice.ReadOnly](qiodevice.html#OpenModeFlag-enum)模式通過調用open （）。注意，這并不對某些設備，如工作[QProcess](qprocess.html)，[QTcpSocket](qtcpsocket.html)和[QUdpSocket](qudpsocket.html)，其中更多的邏輯需要打開設備。 **See also** [device](qimagereader.html#device)（）和[setFileName](qimagereader.html#setFileName)（）。 ``` QImageReader.setFileName (self, QString?fileName) ``` 設置的文件名[QImageReader](qimagereader.html)至_fileName_。在內部，[QImageReader](qimagereader.html)將創建一個[QFile](qfile.html)對象，并在打開它[QIODevice.ReadOnly](qiodevice.html#OpenModeFlag-enum)模式，閱讀圖像時使用這個。 If _fileName_不包括文件擴展名（例如，。 PNG或。 BMP ），[QImageReader](qimagereader.html)將循環遍歷所有支持的擴展，直到找到一個匹配的文件。 **See also** [fileName](qimagereader.html#fileName)（）[setDevice](qimagereader.html#setDevice)（）和[supportedImageFormats](qimagereader.html#supportedImageFormats)（）。 ``` QImageReader.setFormat (self, QByteArray?format) ``` 設置格式[QImageReader](qimagereader.html)將使用閱讀圖像時，以_format_。_format_是不區分大小寫的文本字符串。例如： ``` [QImageReader](qimagereader.html) reader; reader.setFormat("png"); // same as reader.setFormat("PNG"); ``` 您可以致電[supportedImageFormats](qimagereader.html#supportedImageFormats)（）對于格式的完整列表[QImageReader](qimagereader.html)支持。 **See also** [format](qimagereader.html#format)（）。 ``` QImageReader.setQuality (self, int?quality) ``` 這是一種圖像格式的具體功能，用于設置圖像的質量水平來_quality_。對于不支持設置質量的圖像格式，該值將被忽略。的取值范圍_quality_取決于圖像格式。例如， “JPEG”格式支持的質量范圍從0（低品質，高壓縮）到100 （高品質，低壓縮率）。這個函數中引入了Qt 4.2中。 **See also** [quality](qimagereader.html#quality)（）。 ``` QImageReader.setScaledClipRect (self, QRect?rect) ``` 設置縮放剪輯矩形到_rect_。縮放剪輯矩形是剪輯矩形（也稱為投資回報率，或感興趣區域）所應用的圖像已被縮放后。 **See also** [scaledClipRect](qimagereader.html#scaledClipRect)（）和[setScaledSize](qimagereader.html#setScaledSize)（）。 ``` QImageReader.setScaledSize (self, QSize?size) ``` 設置圖像的縮放的大小來_size_。的縮放初始剪輯矩形后進行的，但經縮放的剪輯矩形應用之前。用于縮放的算法依賴于圖像格式。默認情況下（即，如果圖像格式不支持縮放）[QImageReader](qimagereader.html)將使用QImage.scale （）與Qt.SmoothScaling 。 **See also** [scaledSize](qimagereader.html#scaledSize)（）[setClipRect](qimagereader.html#setClipRect)（）和[setScaledClipRect](qimagereader.html#setScaledClipRect)（）。 ``` QSize QImageReader.size (self) ``` [ 返回圖像的大小，而無需實際讀出圖像的內容。如果圖像格式不支持此功能，這個函數返回一個無效的大小。 Qt的內置圖像處理程序都支持此功能，但自定義圖像格式的插件并不需要這么做。 ](qsize.html) [**See also**](qsize.html) [QImageIOHandler.ImageOption](qimageiohandler.html#ImageOption-enum)，[QImageIOHandler.option](qimageiohandler.html#option)（）和[QImageIOHandler.supportsOption](qimageiohandler.html#supportsOption)（）。 ``` list-of-QByteArray QImageReader.supportedImageFormats () ``` 傳回的圖像格式所支持的列表[QImageReader](qimagereader.html)。默認情況下， Qt可以閱讀以下格式： | Format | Description | | --- | --- | | BMP | Windows Bitmap | | GIF | Graphic Interchange Format (optional) | | JPG | Joint Photographic Experts Group | | JPEG | Joint Photographic Experts Group | | MNG | Multiple-image Network Graphics | | PNG | Portable Network Graphics | | PBM | Portable Bitmap | | PGM | Portable Graymap | | PPM | Portable Pixmap | | TIFF | Tagged Image File Format | | XBM | X11 Bitmap | | XPM | X11 Pixmap | | SVG | Scalable Vector Graphics | | TGA | Targa Image Format | 讀取和寫入SVG文件是通過Qt的支持[SVG Module](index.htm)。 TGA只支持擴展到讀非RLE壓縮文件。尤其調用 [capabilities](http://doc.qt.nokia.com/4.7-snapshot/qimageioplugin.html#capabilities)對于TGA插件只返回[QImageIOPlugin.CanRead](index.htm#Capability-enum)，不[QImageIOPlugin.CanWrite](index.htm#Capability-enum)。要配置的Qt與支持GIF ，通過`-qt-gif`到`configure`腳本或檢查在圖形安裝程序中的相應選項。注意，這個[QApplication](qapplication.html)實例必須調用此函數之前創建。 **See also** [setFormat](qimagereader.html#setFormat)（）[QImageWriter.supportedImageFormats](qimagewriter.html#supportedImageFormats)（）和[QImageIOPlugin](index.htm)。 ``` bool QImageReader.supportsAnimation (self) ``` 返回True如果圖像格式支持動畫，否則返回False 。這個函數是Qt 4.1中引入。 **See also** [QMovie.supportedFormats](qmovie.html#supportedFormats)(). ``` bool QImageReader.supportsOption (self, QImageIOHandler.ImageOption?option) ``` 返回True如果讀者支持_option_否則返回False 。不同的圖像格式支持不同的選項。調用此函數來判斷某個選項是否支持當前格式。例如， PNG格式允許你嵌入文本到圖像的元數據（見[text](qimagereader.html#text)（）），和BMP格式允許您確定圖像的大小，而無需加載整個圖像到內存中（見[size](qimagereader.html#size)（））。 ``` [QImageReader](qimagereader.html) reader(":/image.png"); if (reader.supportsOption([QImageIOHandler](qimageiohandler.html).Size)) qDebug() << "Size:" << reader.size(); ``` 這個函數中引入了Qt 4.2中。 **See also** [QImageWriter.supportsOption](qimagewriter.html#supportsOption)（）。 ``` QString QImageReader.text (self, QString?key) ``` 返回與相關圖像的文字_key_。支持這個選項是通過實施[QImageIOHandler.Description](qimageiohandler.html#ImageOption-enum)。這個函數是Qt 4.1中引入。 **See also** [textKeys](qimagereader.html#textKeys)（）和[QImageWriter.setText](qimagewriter.html#setText)（）。 ``` QStringList QImageReader.textKeys (self) ``` 返回文本鍵這一形象。您可以使用這些按鍵與[text](qimagereader.html#text)（）列出圖像文本的某些關鍵。支持這個選項是通過實施[QImageIOHandler.Description](qimageiohandler.html#ImageOption-enum)。這個函數是Qt 4.1中引入。 **See also** [text](qimagereader.html#text)（）[QImageWriter.setText](qimagewriter.html#setText)（）和[QImage.textKeys](qimage.html#textKeys)（）。