frameRate

Usage

-- Lingo syntax
memberObjRef.frameRate

// JavaScript syntax
memberObjRef.frameRate;

Description

Cast member property; specifies the playback frame rate for the specified digital video, or Flash movie cast member.

The possible values for the frame rate of a digital video member correspond to the radio buttons for selecting digital video playback options.

• When the frameRate member property is between 1 and 255, the digital video movie plays every frame at that frame rate. The frameRate member property cannot be greater than 255.
• When the frameRate member property is set to -1 or 0, the digital video movie plays every frame at its normal rate. This allows the video to sync to its soundtrack. When the frameRate is set to any value other than -1 or 0, the digital video soundtrack will not play.
• When the frameRate member property is set to -2, the digital video movie plays every frame as fast as possible.

For Flash movie cast members, the property indicates the frame rate of the movie created in Flash.

This property can be tested but not set.

Example

This statement sets the frame rate of the QuickTime digital video cast member Rotating Chair to 30 frames per second:

-- Lingo syntax 
member("Rotating Chair").frameRate = 30

// JavaScript syntax
member("Rotating Chair").frameRate = 30;

This statement instructs the QuickTime digital video cast member Rotating Chair to play every frame as fast as possible:

-- Lingo syntax
member("Rotating Chair").frameRate = -2
// JavaScript syntax
member("Rotating Chair").frameRate = -2;

The following sprite script checks to see if the sprite's cast member was originally created in Flash with a frame rate of less than 15 frames per second. If the movie's frame rate is slower than 15 frames per second, the script sets the playBackMode property for the sprite so it can be set to another rate. The script then sets the sprite's fixedRate property to 15 frames per second.

-- Lingo syntax
property spriteNum

on beginSprite me
   if sprite(spriteNum).member.frameRate < 15 then
      sprite(spriteNum).playBackMode = #fixed
      sprite(spriteNum).fixedRate = 15
   end if
end

// JavaScript syntax
function beginSprite () {
   var fr = sprite(this.spriteNum).member.frameRate;
   if (fr < 15) {
      sprite(this.spriteNum).playBackMode = symbol("fixed");
      sprite(this.spriteNum).fixedRate = 15;
   }
}

See also

fixedRate, playRate (QuickTime, AVI), currentTime (QuickTime, AVI), playBackMode

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/director/mx2004/release_en/09_pr261.htm

Add Comment