Movie

A movie.

Methods:

autoTag, bringForward, bringToFront, clearTransformations, convertShape, detach, duplicate, extractLabel, fit, getElements, insertLabel, markup, move, override, placeXML, redefineScaling, remove, removeOverride, select, sendBackward, sendToBack, store, toSource, toSpecifier, transform, verifyURL

Objects:

Boolean, File, FloatingWindowPosition, FloatingWindowSize, Graphic, Guide, Images, Layer, Link, Movie, MoviePosterTypes, Number, Object, PageItem, PlayMode, Sound, String, XMLItem

Property Listing

Property

Type

Access

Description

allowOverrides

Boolean

read/write

If true, the master page item can be overridden.

associatedXMLElement

XMLItem

readonly

The XML element associated with the Movie.

description

String

read/write

The description of the Movie.

embedInPDF

Boolean

read/write

If true, the file is embedded in the PDF. If false, the file is linked to the PDF. Note: To embed movie files, acrobat compatibility must be acrobat 6 or higher.

filePath

String

File

read/write

The file path (colon delimited on the Mac OS). Can also accept: File.

floatingWindow

Boolean

read/write

If true, opens a new window to play the movie. If false, plays the movie in the poster frame on the PDF document page.

floatingWindowPosition

FloatingWindowPosition

FloatingWindowPosition.CENTER

FloatingWindowPosition.CENTER_LEFT

FloatingWindowPosition.CENTER_RIGHT

FloatingWindowPosition.LOWER_LEFT

FloatingWindowPosition.LOWER_MIDDLE

FloatingWindowPosition.LOWER_RIGHT

FloatingWindowPosition.UPPER_LEFT

FloatingWindowPosition.UPPER_MIDDLE

FloatingWindowPosition.UPPER_RIGHT

read/write

The position of the floating window that displays the movie.

floatingWindowSize

FloatingWindowSize

FloatingWindowSize.FULL

FloatingWindowSize.MAX

FloatingWindowSize.ONE_FIFTH

FloatingWindowSize.ONE_FOURTH

FloatingWindowSize.ONE_HALF

FloatingWindowSize.QUADRUPLE

FloatingWindowSize.TRIPLE

FloatingWindowSize.TWICE

read/write

The size of the floating window that displays the movie.

geometricBounds

Array of Number

Array of String

read/write

The bounds of the Movie excluding the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box.

horizontalScale

Number

read/write

The horizontal scaling applied to the Movie.

id

Number

readonly

The unique ID of the Movie.

images

Images Image

readonly

A collection of bitmap images in any bitmap file format (including TIFF, JPEG, or GIF).

index

Number

readonly

The index of the Movie within its containing object.

itemLayer

Layer

read/write

The layer that the Movie is on.

itemLink

Link

readonly

The source file of the link.

label

String

read/write

A property that can be set to any string.

moviePosterType

MoviePosterTypes

MoviePosterTypes.FROM_MOVIE

MoviePosterTypes.NONE

MoviePosterTypes.PROXY_IMAGE

MoviePosterTypes.STANDARD

read/write

The type of poster for the movie.

name

String

read/write

The name of the Movie.

overridden

Boolean

readonly

If true, the object originated on a master spread and was overridden. If false, the object either originated on a master spread and was not overridden, or the object did not originate on a master page.

overriddenMasterPageItem

Graphic

Guide

Movie

PageItem

Sound

readonly

An object that originated on a master page and has been overridden. Can return: PageItem, Guide, Graphic, Movie or Sound.

parent

Oval

Rectangle

PageItem

Polygon

readonly

The parent of the Movie (a PageItem, Oval, Rectangle or Polygon).

playMode

PlayMode

PlayMode.ONCE

PlayMode.REPEAT_PLAY

PlayMode.STAY_OPEN

read/write

The movie's playback mode.

playOnPageTurn

Boolean

read/write

If true, the movie plays automatically when a user views the page that contains the movie poster in the PDF document.

posterFile

String

read/write

The poster file.

properties

Object

read/write

A property that allows setting of several properties at the same time.

showControls

Boolean

read/write

If true, displays playback controls at the bottom of the movie display window.

url

String

read/write

The URL.

verticalScale

Number

read/write

The vertical scaling applied to the Movie.

visibleBounds

Array of Number

Array of String

read/write

The bounds of the Movie including the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box.

Method Listing

undefined autoTag ()

Tag the object or the parent story using default tags defined in XML preference.

undefined bringForward ()

Brings the Movie forward one level in its layer.

undefined bringToFront ()

Brings the Movie to the front.

undefined clearTransformations ()

Clears transformations from the Movie. Transformations include rotation, scaling, flipping, fitting, and shearing.

undefined convertShape (given:ConvertShapeOptions, numberOfSides:Number, insetPercentage:Number, cornerRadius:Number String)

Converts the Movie to a different shape.

Parameter

Type

Description

given

ConvertShapeOptions

ConvertShapeOptions.CONVERT_TO_BEVELED_RECTANGLE

ConvertShapeOptions.CONVERT_TO_CLOSED_PATH

ConvertShapeOptions.CONVERT_TO_INVERSE_ROUNDED_RECTANGLE

ConvertShapeOptions.CONVERT_TO_LINE

ConvertShapeOptions.CONVERT_TO_OPEN_PATH

ConvertShapeOptions.CONVERT_TO_OVAL

ConvertShapeOptions.CONVERT_TO_POLYGON

ConvertShapeOptions.CONVERT_TO_RECTANGLE

ConvertShapeOptions.CONVERT_TO_ROUNDED_RECTANGLE

ConvertShapeOptions.CONVERT_TO_STRAIGHT_LINE

ConvertShapeOptions.CONVERT_TO_TRIANGLE

The Movie's new shape.

numberOfSides

Number (range 3 - 100)

The number of sides for the resulting polygon. (Range: 3 to 100) (Optional)

insetPercentage

Number (range 0 - 100)

The star inset percentage for the resulting polygon. (Range: 0.0 to 100.0) (Optional)

cornerRadius

Number

String

The corner radius of the resulting rectangle. (Optional)

undefined detach ()

Detaches an overridden master page item from the master page.

Movie duplicate ()

Duplicates the Movie.

String extractLabel (key:String)

Gets the label value associated with the specified key.

Parameter

Type

Description

key

String

The key.

undefined fit (given:FitOptions)

Applies the specified fit option to content in a frame.

Parameter

Type

Description

given

FitOptions

FitOptions.CENTER_CONTENT

FitOptions.CONTENT_TO_FRAME

FitOptions.FILL_PROPORTIONALLY

FitOptions.FRAME_TO_CONTENT

FitOptions.PROPORTIONALLY

The fit option to use.

Movie getElements ()

Resolves the object specifier, creating an array of object references.

undefined insertLabel (key:String, value:String)

Sets the label to the value associated with the specified key.

Parameter

Type

Description

key

String

The key.

value

String

The value.

undefined markup (using:XMLElement)

Associates the page item with the specified XML element while preserving existing content.

Parameter

Type

Description

using

XMLElement

The XML element.

undefined move (to:Array of Varies 2 Units Page Spread Layer, by:Array of Number String)

Moves the Movie to a new location. Note: Either the 'to' or 'by' parameter is required; if both parameters are defined, only the to value is used.

Parameter

Type

Description

to

Array of 2 Units

Page

Spread

Layer

The new location of the Movie,in the format (x, y). Can accept: Array of 2 Units, Spread, Page or Layer. (Optional)

by

Array of Number

Array of String

The amount (in measurement units) to move the Movie relative to its current position, in the format (x, y). (Optional)

Varies override (destinationPage:Page)

Overrides a master page item and places the item on the document page as a new object.

Parameter

Type

Description

destinationPage

Page

The document page that contains the master page item to override.

undefined placeXML (using:XMLElement)

Places XML content into the specified object. Note: Replaces any existing content.

Parameter

Type

Description

using

XMLElement

The XML element whose content you want to place.

undefined redefineScaling (to:Array of Number)

Apply an item's scaling to its content if possible.

Parameter

Type

Description

to

Array of Number

The scale factors to be left on the item. The default is {1.0, 1.0}. (Optional)

undefined remove ()

Deletes the Movie.

undefined removeOverride ()

Removes the override from a previously overridden master page item.

undefined select ([existingSelection:SelectionOptions=SelectionOptions])

Selects the object.

Parameter

Type

Description

existingSelection

SelectionOptions

SelectionOptions.ADD_TO

SelectionOptions.REMOVE_FROM

SelectionOptions.REPLACE_WITH

The selection status of the Movie in relation to previously selected objects. (Optional)

(default: SelectionOptions.REPLACE_WITH)

undefined sendBackward ()

Sends the Movie back one level in its layer.

undefined sendToBack ()

Sends the Movie to the back.

Asset store (using:Library, withProperties:Object)

Stores the object in the specified library.

Parameter

Type

Description

using

Library

The library in which to store the object.

withProperties

Object

Initial values for properties of the new Movie (Optional)

String toSource ()

Generates a string which, if executed, will return the Movie.

String toSpecifier ()

Retrieves the object specifier.

undefined transform (in:CoordinateSpaces, from:Array of Varies AnchorPoint AnchorPoints 2 Reals BoundingBoxLimitss CoordinateSpacess Arrays of 2 Reals LongIntegers, withMatrix:Array of Varies 6 Reals TransformationMatrix, replacingCurrent:Array of Varies MatrixContent enumerators MatrixContent LongInteger, [consideringRulerUnits:Boolean=Boolean])

Transform the page item.

Parameter

Type

Description

in

CoordinateSpaces

CoordinateSpaces.INNER_COORDINATES

CoordinateSpaces.PARENT_COORDINATES

CoordinateSpaces.PASTEBOARD_COORDINATES

The coordinate space to use

from

AnchorPoint

AnchorPoint.BOTTOM_CENTER_ANCHOR

AnchorPoint.BOTTOM_LEFT_ANCHOR

AnchorPoint.BOTTOM_RIGHT_ANCHOR

AnchorPoint.CENTER_ANCHOR

AnchorPoint.LEFT_CENTER_ANCHOR

AnchorPoint.RIGHT_CENTER_ANCHOR

AnchorPoint.TOP_CENTER_ANCHOR

AnchorPoint.TOP_LEFT_ANCHOR

AnchorPoint.TOP_RIGHT_ANCHOR

AnchorPoints AnchorPoint

Array of 2 Reals

BoundingBoxLimitss BoundingBoxLimits

CoordinateSpacess CoordinateSpaces

Array of Arrays of 2 Reals

LongIntegers

The temporary origin during the transformation. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.

withMatrix

Array of 6 Reals

TransformationMatrix

Transform matrix. Can accept: Array of 6 Reals or TransformationMatrix.

replacingCurrent

Array of MatrixContent enumerators

MatrixContent

MatrixContent.ROTATION_VALUE

MatrixContent.SCALE_VALUES

MatrixContent.SHEAR_VALUE

MatrixContent.TRANSLATION_VALUES

LongInteger

Transform components to consider; providing this optional parameter causes the target's existing transform components to be replaced with new values. Without this parameter, the given matrix is concatenated onto the target's existing transform combining the effect of the two. Can accept: MatrixContent enumerator, Array of MatrixContent enumerators or Long Integer. (Optional)

consideringRulerUnits

Boolean

If true then a ruler based origin is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional)

(default: false)

Boolean verifyURL ()

Verifies that the specified URL is valid and contains the specified movie file. Valid only when the movie file is specified by a URL rather than a file path.

Object of

FormField.overriddenMasterPageItem

Button.overriddenMasterPageItem

Movie.overriddenMasterPageItem

Sound.overriddenMasterPageItem

PageItem.overriddenMasterPageItem

Oval.overriddenMasterPageItem

Rectangle.overriddenMasterPageItem

GraphicLine.overriddenMasterPageItem

Polygon.overriddenMasterPageItem

Group.overriddenMasterPageItem

Image.overriddenMasterPageItem

EPS.overriddenMasterPageItem

PDF.overriddenMasterPageItem

WMF.overriddenMasterPageItem

PICT.overriddenMasterPageItem

Graphic.overriddenMasterPageItem

Guide.overriddenMasterPageItem

ImportedPage.overriddenMasterPageItem

TextFrame.overriddenMasterPageItem

MovieBehavior.movieItem

Image.parent

XMLElement.xmlContent

Return

Movies.add()

Movie.duplicate()

Movie.getElements()

Movies.anyItem()

Movies.everyItem()

Movies.nextItem()

Movies.previousItem()

Movies.itemByID()

Movies.item()

Movies.itemByName()

Movies.itemByRange()

Movies.firstItem()

Movies.lastItem()

Movies.middleItem()