QMovie Class Reference · PyQt4 中文文檔

# QMovie Class Reference ## [[QtGui](index.htm) module] 該QMovie類是一個方便的類，用于播放電影的[QImageReader](qimagereader.html)。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum CacheMode { CacheNone, CacheAll }` * `enum MovieState { NotRunning, Paused, Running }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, QIODevice?device, QByteArray?format?=?QByteArray(), QObject?parent?=?None)` * `__init__ (self, QString?fileName, QByteArray?format?=?QByteArray(), QObject?parent?=?None)` * `QColor backgroundColor (self)` * `CacheMode cacheMode (self)` * `int currentFrameNumber (self)` * `QImage currentImage (self)` * `QPixmap currentPixmap (self)` * `QIODevice device (self)` * `QString fileName (self)` * `QByteArray format (self)` * `int frameCount (self)` * `QRect frameRect (self)` * `bool isValid (self)` * `bool jumpToFrame (self, int?frameNumber)` * `bool jumpToNextFrame (self)` * `int loopCount (self)` * `int nextFrameDelay (self)` * `QSize scaledSize (self)` * `setBackgroundColor (self, QColor?color)` * `setCacheMode (self, CacheMode?mode)` * `setDevice (self, QIODevice?device)` * `setFileName (self, QString?fileName)` * `setFormat (self, QByteArray?format)` * `setPaused (self, bool?paused)` * `setScaledSize (self, QSize?size)` * `setSpeed (self, int?percentSpeed)` * `int speed (self)` * `start (self)` * `MovieState state (self)` * `stop (self)` ### Static Methods * `list-of-QByteArray supportedFormats ()` ### Qt Signals * `void error (QImageReader::ImageReaderError)` * `void finished ()` * `void frameChanged (int)` * `void resized (const QSize&)` * `void started ()` * `void stateChanged (QMovie::MovieState)` * `void updated (const QRect&)` * * * ## Detailed Description 該QMovie類是一個方便的類，用于播放電影的[QImageReader](qimagereader.html)。這個類是用來顯示簡單的動畫沒有聲音。如果你想顯示的視頻和媒體內容，使用[Phonon](index.htm)多媒體框架來代替。首先，通過傳遞一個文件的名稱或一個指向創建QMovie對象[QIODevice](qiodevice.html)含動畫圖像格式QMovie的構造函數。您可以致電[isValid](qmovie.html#isValid)（），以檢查是否在圖像數據是有效的，從電影之前。開始播放影片，通話[start](qmovie.html#start)（）。 QMovie將進入[Running](qmovie.html#MovieState-enum)狀態，并放出[started](qmovie.html#started)（）和[stateChanged](qmovie.html#stateChanged)（）。為了得到影片的當前狀態，請致電[state](qmovie.html#state)（）。若要顯示影片在您的應用程序，你可以通過你的QMovie對象[QLabel.setMovie](qlabel.html#setMovie)（）。例如： ``` [QLabel](qlabel.html) label; QMovie *movie = new QMovie("animations/fire.gif"); label.setMovie(movie); movie->start(); ``` 每當一個新的框架是在電影中使用， QMovie會發出[updated](qmovie.html#updated)（）。如果該幀的大小變化，[resized](qmovie.html#resized)（）被發射。您可以致電[currentImage](qmovie.html#currentImage)（）或[currentPixmap](qmovie.html#currentPixmap)（）來獲得當前幀的副本。當影片完成后， QMovie發出[finished](qmovie.html#finished)（）。如果播放（即圖像文件已損壞）過程中發生任何錯誤， QMovie會發出[error](qmovie.html#error)（）。你可以通過調用控制影片的播放速度[setSpeed](qmovie.html#speed-prop)（），它采用原始速度的百分比作為參數。通過調用setPaused （真）暫停電影。 QMovie將進入[Paused](qmovie.html#MovieState-enum)國家和EMIT[stateChanged](qmovie.html#stateChanged)（）。如果調用setPaused （假）， QMovie將重新進入[Running](qmovie.html#MovieState-enum)狀態，然后再次開始播放電影。停止播放視頻，呼叫[stop](qmovie.html#stop)（）。某些動畫格式允許您設置背景顏色。您可以致電[setBackgroundColor](qmovie.html#setBackgroundColor)（）來設置顏色，或[backgroundColor](qmovie.html#backgroundColor)（）來獲取當前背景色。 [currentFrameNumber](qmovie.html#currentFrameNumber)（）返回在當前幀的序列號。在動畫的第一幀具有序列號0。[frameCount](qmovie.html#frameCount)（）返回的幀的總數目在動畫中，如果圖像格式支持這一點。您可以致電[loopCount](qmovie.html#loopCount)（）來獲得本次電影應該在完成循環之前的數量。[nextFrameDelay](qmovie.html#nextFrameDelay)（）返回毫秒為單位的當前幀應該顯示的數目。 QMovie可以通過調用被指示動畫的幀緩存[setCacheMode](qmovie.html#cacheMode-prop)（）。 Call [supportedFormats](qmovie.html#supportedFormats)（）對于格式的列表QMovie支持。 * * * ## Type Documentation ``` QMovie.CacheMode ``` 這個枚舉變量描述了不同的緩存模式[QMovie](qmovie.html)。 | Constant | Value | Description | | --- | --- | --- | | `QMovie.CacheNone` | `0` | 沒有幀緩存（默認值）。 | | `QMovie.CacheAll` | `1` | 所有的幀緩存。 | ``` QMovie.MovieState ``` 該枚舉描述的不同狀態[QMovie](qmovie.html)。 | Constant | Value | Description | | --- | --- | --- | | `QMovie.NotRunning` | `0` | 這部電影沒有運行。這是[QMovie](qmovie.html)的初始狀態，并且狀態后，它進入[stop](qmovie.html#stop)（）被調用或電影結束。 | | `QMovie.Paused` | `1` | 電影被暫停，并[QMovie](qmovie.html)停止發光[updated](qmovie.html#updated)（）或[resized](qmovie.html#resized)（）。調用后進入此狀態[pause](index.htm#pause)（）或setPaused （真）。當前幀號是蒙了，這部電影將繼續與下一幀時[unpause](index.htm#unpause)（）或setPaused （假）被調用。 | | `QMovie.Running` | `2` | 這部電影正在運行。 | * * * ## Method Documentation ``` QMovie.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QMovie](qmovie.html)對象，通過_parent_反對[QObject](qobject.html)的構造。 **See also** [setFileName](qmovie.html#setFileName)（）[setDevice](qmovie.html#setDevice)（）和[setFormat](qmovie.html#setFormat)（）。 ``` QMovie.__init__ (self, QIODevice?device, QByteArray?format?=?QByteArray(), QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QMovie](qmovie.html)對象。[QMovie](qmovie.html)將使用讀取的圖像數據從_device_，它假定為開放性和可讀性。如果_format_不為空，[QMovie](qmovie.html)將使用的圖像格式_format_對圖像數據進行解碼。否則，[QMovie](qmovie.html)會嘗試猜測的格式。該_parent_對象被傳遞給[QObject](qobject.html)的構造。 ``` QMovie.__init__ (self, QString?fileName, QByteArray?format?=?QByteArray(), QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QMovie](qmovie.html)對象。[QMovie](qmovie.html)將使用讀取的圖像數據從_fileName_。如果_format_不為空，[QMovie](qmovie.html)將使用的圖像格式_format_對圖像數據進行解碼。否則，[QMovie](qmovie.html)會嘗試猜測的格式。該_parent_對象被傳遞給[QObject](qobject.html)的構造。 ``` QColor QMovie.backgroundColor (self) ``` [](qcolor.html) [返回電影的背景顏色。如果沒有背景色已經被分配，一個無效的](qcolor.html)[QColor](qcolor.html)返回。 **See also** [setBackgroundColor](qmovie.html#setBackgroundColor)（）。 ``` CacheMode QMovie.cacheMode (self) ``` [ ``` int QMovie.currentFrameNumber (self) ``` 返回當前幀的序列號。在電影的第一幀的數目是0。 ](qmovie.html#CacheMode-enum) ``` QImage QMovie.currentImage (self) ``` [](qimage.html) [返回當前幀作為](qimage.html)[QImage](qimage.html)。 **See also** [currentPixmap](qmovie.html#currentPixmap)（）和[updated](qmovie.html#updated)（）。 ``` QPixmap QMovie.currentPixmap (self) ``` [](qpixmap.html) [返回當前幀作為](qpixmap.html)[QPixmap](qpixmap.html)。 **See also** [currentImage](qmovie.html#currentImage)（）和[updated](qmovie.html#updated)（）。 ``` QIODevice QMovie.device (self) ``` [](qiodevice.html) [返回設備](qiodevice.html)[QMovie](qmovie.html)從讀取圖像數據。如果沒有設備目前已被分配，則返回0 。 **See also** [setDevice](qmovie.html#setDevice)（）和[fileName](qmovie.html#fileName)（）。 ``` QString QMovie.fileName (self) ``` 返回的文件的名稱[QMovie](qmovie.html)從讀取圖像數據。如果沒有文件名已經被分配，或者如果指定的設備是不是一個文件，一個空[QString](qstring.html)返回。 **See also** [setFileName](qmovie.html#setFileName)（）和[device](qmovie.html#device)（）。 ``` QByteArray QMovie.format (self) ``` [](qbytearray.html) [返回格式](qbytearray.html)[QMovie](qmovie.html)圖像數據進行解碼時使用。如果沒有指定格式已經被分配，一個空QByteArray中（）返回。 **See also** [setFormat](qmovie.html#setFormat)（）。 ``` int QMovie.frameCount (self) ``` 返回幀的電影數量。某些動畫格式不支持此功能，在這種情況下，返回0。 ``` QRect QMovie.frameRect (self) ``` [](qrect.html) [返回的最后一幀的正確。如果沒有框架至今尚未更新，無效](qrect.html)[QRect](qrect.html)返回。 **See also** [currentImage](qmovie.html#currentImage)（）和[currentPixmap](qmovie.html#currentPixmap)（）。 ``` bool QMovie.isValid (self) ``` 返回True如果影片是有效的（例如，圖像數據是可讀的，并且所支持的圖像格式），否則返回False 。 ``` bool QMovie.jumpToFrame (self, int?frameNumber) ``` 跳轉到幀號_frameNumber_。成功時返回TRUE ，否則返回False 。 ``` bool QMovie.jumpToNextFrame (self) ``` 這種方法也是一個Qt槽與C + +的簽名`bool jumpToNextFrame()`。跳轉到下一幀。成功時返回TRUE ，否則返回False 。 ``` int QMovie.loopCount (self) ``` 返回的次數這部電影將循環完成之前。如果影片只能播放一次（無循環）， loopCount返回0 。如果影片永遠循環， loopCount返回-1 。需要注意的是，如果圖像數據是來自一個連續的設備（例如一插座）[QMovie](qmovie.html)如果只能回路的電影[cacheMode](qmovie.html#cacheMode-prop)被設置為[QMovie.CacheAll](qmovie.html#CacheMode-enum)。 ``` int QMovie.nextFrameDelay (self) ``` 返回的毫秒數[QMovie](qmovie.html)更新在動畫中的下一幀之前，將等待。 ``` QSize QMovie.scaledSize (self) ``` [ 返回的幀的縮放大小。這個函數是Qt 4.1中引入。 ](qsize.html) [**See also**](qsize.html) [setScaledSize](qmovie.html#setScaledSize)（）和[QImageReader.scaledSize](qimagereader.html#scaledSize)（）。 ``` QMovie.setBackgroundColor (self, QColor?color) ``` 對于支持它的圖像格式，該函數設置背景顏色為_color_。 **See also** [backgroundColor](qmovie.html#backgroundColor)（）。 ``` QMovie.setCacheMode (self, CacheMode?mode) ``` ``` QMovie.setDevice (self, QIODevice?device) ``` 設置當前設備_device_。[QMovie](qmovie.html)會從電影運行時該設備讀取的圖像數據。 **See also** [device](qmovie.html#device)（）和[setFormat](qmovie.html#setFormat)（）。 ``` QMovie.setFileName (self, QString?fileName) ``` 載的文件的名稱[QMovie](qmovie.html)讀取圖像數據，以_fileName_。 **See also** [fileName](qmovie.html#fileName)（）[setDevice](qmovie.html#setDevice)（）和[setFormat](qmovie.html#setFormat)（）。 ``` QMovie.setFormat (self, QByteArray?format) ``` 設置格式[QMovie](qmovie.html)解碼圖像數據時，要會用_format_。默認情況下，[QMovie](qmovie.html)會嘗試猜測的圖像數據的格式。您可以致電[supportedFormats](qmovie.html#supportedFormats)（）對于格式的完整列表[QMovie](qmovie.html)支持。 **See also** [format](qmovie.html#format)（）和[QImageReader.supportedImageFormats](qimagereader.html#supportedImageFormats)（）。 ``` QMovie.setPaused (self, bool?paused) ``` 這種方法也是一個Qt槽與C + +的簽名`void setPaused(bool)`。 If _paused_是真的，[QMovie](qmovie.html)將進入[Paused](qmovie.html#MovieState-enum)狀態并放出stateChanged （暫停），否則將進入[Running](qmovie.html#MovieState-enum)狀態并放出stateChanged （運行）。 **See also** [paused](index.htm#paused)（）和[state](qmovie.html#state)（）。 ``` QMovie.setScaledSize (self, QSize?size) ``` 設置縮放幀尺寸為_size_。這個函數是Qt 4.1中引入。 **See also** [scaledSize](qmovie.html#scaledSize)（）和[QImageReader.setScaledSize](qimagereader.html#setScaledSize)（）。 ``` QMovie.setSpeed (self, int?percentSpeed) ``` ``` int QMovie.speed (self) ``` ``` QMovie.start (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void start()`。開始播放電影。[QMovie](qmovie.html)將進入[Running](qmovie.html#MovieState-enum)狀態，并開始發光[updated](qmovie.html#updated)（）和[resized](qmovie.html#resized)（）作為電影的進展。 If [QMovie](qmovie.html)在[Paused](qmovie.html#MovieState-enum)狀態時，此功能相當于調用setPaused （假）。如果[QMovie](qmovie.html)已經在[Running](qmovie.html#MovieState-enum)狀態，這個函數什么都不做。 **See also** [stop](qmovie.html#stop)（）和[setPaused](qmovie.html#setPaused)（）。 ``` MovieState QMovie.state (self) ``` [](qmovie.html#MovieState-enum) [返回的當前狀態](qmovie.html#MovieState-enum)[QMovie](qmovie.html)。 **See also** [MovieState](qmovie.html#MovieState-enum)和[stateChanged](qmovie.html#stateChanged)（）。 ``` QMovie.stop (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void stop()`。停止該影片。[QMovie](qmovie.html)進入[NotRunning](qmovie.html#MovieState-enum)狀態，并停止發出[updated](qmovie.html#updated)（）和[resized](qmovie.html#resized)（）。如果[start](qmovie.html#start)（）再次被調用時，影片將從頭開始重新啟動。 If [QMovie](qmovie.html)已經在[NotRunning](qmovie.html#MovieState-enum)狀態，這個函數什么都不做。 **See also** [start](qmovie.html#start)（）和[setPaused](qmovie.html#setPaused)（）。 ``` list-of-QByteArray QMovie.supportedFormats () ``` 傳回的圖像格式所支持的列表[QMovie](qmovie.html)。這個函數是Qt 4.1中引入。 **See also** [QImageReader.supportedImageFormats](qimagereader.html#supportedImageFormats)（）。 * * * ## Qt Signal Documentation ``` void error (QImageReader::ImageReaderError) ``` 這是該信號的默認超載。這個信號是由發射[QMovie](qmovie.html)當錯誤_error_在播放過程中發生的。[QMovie](qmovie.html)將停止播放電影，并輸入[QMovie.NotRunning](qmovie.html#MovieState-enum)狀態。 ``` void finished () ``` 這是該信號的默認超載。當影片結束這個信號被發射。 **See also** [QMovie.stop](qmovie.html#stop)（）。 ``` void frameChanged (int) ``` 這是該信號的默認超載。這個信號被發射時的幀編號變更為_frameNumber_。您可以致電[currentImage](qmovie.html#currentImage)（）或[currentPixmap](qmovie.html#currentPixmap)（）來獲取幀的副本。這個函數是Qt 4.1中引入。 ``` void resized (const QSize&) ``` 這是該信號的默認超載。當當前幀已經被改變到這一信號被發射_size_。這種效果有時用于動畫作為替代更換幀。您可以致電[currentImage](qmovie.html#currentImage)（）或[currentPixmap](qmovie.html#currentPixmap)（）來獲取更新的幀的副本。 ``` void started () ``` 這是該信號的默認超載。之后此信號被發射[QMovie.start](qmovie.html#start)（）被調用，并[QMovie](qmovie.html)已進入[QMovie.Running](qmovie.html#MovieState-enum)狀態。 ``` void stateChanged (QMovie::MovieState) ``` 這是該信號的默認超載。每當這個信號被發射的電影的狀態發生改變。新的狀態被指定_state_。 **See also** [QMovie.state](qmovie.html#state)（）。 ``` void updated (const QRect&) ``` 這是該信號的默認超載。這個信號被發射時的RECT_rect_在當前幀中已被更新。您可以致電[currentImage](qmovie.html#currentImage)（）或[currentPixmap](qmovie.html#currentPixmap)（）來獲取更新的幀的副本。