footagesource
FootageSource object
Section titled “FootageSource object”app.project.item(index).mainSource
app.project.item(index).proxySource
Description
Section titled “Description”The FootageSource object holds information describing the source of some footage. It is used as the mainSource of a FootageItem object, or the proxySource of a CompItem object or FootageItem.
FootageSource is the base class for SolidSource object, so FootageSource attributes and methods are available when working with SolidSource objects.
Attributes
Section titled “Attributes”FootageSource.alphaMode
Section titled “FootageSource.alphaMode”app.project.item(index).mainSource.alphaMode
app.project.item(index).proxySource.alphaMode
Description
Section titled “Description”Defines how the alpha information in the footage is interpreted. If hasAlpha is false, this attribute has no relevant meaning.
An Alpha Mode enumerated value; (read/write). One of:
AlphaMode.IGNOREAlphaMode.STRAIGHTAlphaMode.PREMULTIPLIED
FootageSource.conformFrameRate
Section titled “FootageSource.conformFrameRate”app.project.item(index).mainSource.conformFrameRate
app.project.item(index).proxySource.conformFrameRate
Description
Section titled “Description”A frame rate to use instead of the nativeFrameRate value. If set to 0, the nativeFrameRate is used instead. It is an error to set this value if FootageSource.isStill is true. It is an error to set this value to 0 if removePulldown is not set to PulldownPhase.OFF. If this is 0 when you set removePulldown to a value other than PulldownPhase.OFF, then this is automatically set to the value of nativeFrameRate.
Floating-point value, in the range [0.0..99.0]; read/write.
FootageSource.displayFrameRate
Section titled “FootageSource.displayFrameRate”app.project.item(index).mainSource.displayFrameRate
app.project.item(index).proxySource.displayFrameRate
Description
Section titled “Description”The effective frame rate as displayed and rendered in compositions by After Effects. If removePulldown is PulldownPhase.OFF, then this is the same as the conformFrameRate (if non-zero) or the nativeFrameRate (if conformFrameRate is 0). If removePulldown is not PulldownPhase.OFF, this is conformFrameRate * 0.8, the effective frame rate after removing 1 of every 5 frames.
Floating-point value, in the range [0.0..99.0]; read-only.
FootageSource.fieldSeparationType
Section titled “FootageSource.fieldSeparationType”app.project.item(index).mainSource.fieldSeparationType
app.project.item(index).proxySource.fieldSeparationType
Description
Section titled “Description”How the fields are to be separated in non-still footage. It is an error to set this attribute if isStill is true. It is an error to set this value to FieldSeparationType.OFF if removePulldown is not PulldownPhase.OFF.
A FieldSeparationType enumerated value; read/write. One of:
FieldSeparationType.OFFFieldSeparationType.UPPER_FIELD_FIRSTFieldSeparationType.LOWER_FIELD_FIRST
FootageSource.hasAlpha
Section titled “FootageSource.hasAlpha”app.project.item(index).mainSource.hasAlpha
app.project.item(index).proxySource.hasAlpha
Description
Section titled “Description”When true, the footage has an alpha component. In this case, the attributes alphaMode, invertAlpha, and premulColor have valid values. When false, those attributes have no relevant meaning for the footage.
Boolean; read-only.
FootageSource.highQualityFieldSeparation
Section titled “FootageSource.highQualityFieldSeparation”app.project.item(index).mainSource.highQualityFieldSeparation
app.project.item(index).proxySource.highQualityFieldSeparation
Description
Section titled “Description”When true, After Effects uses special algorithms to determine how to perform high-quality field separation. It is an error to set this attribute if isStill is true, or if fieldSeparationType is FieldSeparationType.OFF.
Boolean; read/write.
FootageSource.invertAlpha
Section titled “FootageSource.invertAlpha”app.project.item(index).mainSource.invertAlpha
app.project.item(index).proxySource.invertAlpha
Description
Section titled “Description”When true, an alpha channel in a footage clip or proxy should be inverted. This attribute is valid only if an alpha is present. If hasAlpha is false, or if alphaMode is AlphaMode.IGNORE, this attribute is ignored.
Boolean; read/write.
FootageSource.isStill
Section titled “FootageSource.isStill”app.project.item(index).mainSource.isStill
app.project.item(index).proxySource.isStill
Description
Section titled “Description”When true the footage is still; When false, it has a time-based component. Examples of still footage are JPEG files, solids, and placeholders with a duration of 0. Examples of non-still footage are movie files, sound files, sequences, and placeholders of non-zero duration.
Boolean; read-only.
FootageSource.loop
Section titled “FootageSource.loop”app.project.item(index).mainSource.loop
app.project.item(index).proxySource.loop
Description
Section titled “Description”The number of times that the footage is to be played consecutively when used in a composition. It is an error to set this attribute if isStill is true.
Integer, in the range [1..9999]; default is 1; read/write.
FootageSource.nativeFrameRate
Section titled “FootageSource.nativeFrameRate”app.project.item(index).mainSource.nativeFrameRate
app.project.item(index).proxySource.nativeFrameRate
Description
Section titled “Description”The native frame rate of the footage.
Floating-point value; read-only.
FootageSource.premulColor
Section titled “FootageSource.premulColor”app.project.item(index).mainSource.premulColor
app.project.item(index).proxySource.premulColor
Description
Section titled “Description”The color to be premultiplied. This attribute is valid only if the alphaMode is alphaMode.PREMULTIPLIED.
Array of three floating-point values, [R, G, B], in the range [0.0..1.0]; read/write.
FootageSource.removePulldown
Section titled “FootageSource.removePulldown”app.project.item(index).mainSource.removePulldown
app.project.item(index).proxySource.removePulldown
Description
Section titled “Description”How the pulldowns are to be removed when field separation is used. It is an error to set this attribute if isStill is true. It is an error to attempt to set this to a value other than PulldownPhase.OFF in the case where fieldSeparationType is FieldSeparationType.OFF.
A PulldownPhase enumerated value; read/write. One of:
PulldownPhase.RemovePulldown.OFFPulldownPhase.RemovePulldown.WSSWWPulldownPhase.RemovePulldown.SSWWWPulldownPhase.RemovePulldown.SWWWSPulldownPhase.RemovePulldown.WWWSSPulldownPhase.RemovePulldown.WWSSWPulldownPhase.RemovePulldown.WSSWW_24P_ADVANCEPulldownPhase.RemovePulldown.SSWWW_24P_ADVANCEPulldownPhase.RemovePulldown.SWWWS_24P_ADVANCEPulldownPhase.RemovePulldown.WWWSS_24P_ADVANCEPulldownPhase.RemovePulldown.WWSSW_24P_ADVANCE
Methods
Section titled “Methods”FootageSource.guessAlphaMode()
Section titled “FootageSource.guessAlphaMode()”app.project.item(index).mainSource.guessAlphaMode()
app.project.item(index).proxySource.guessAlphaMode()
Description
Section titled “Description”Sets alphaMode, premulColor, and invertAlpha to the best estimates for this footage source. If hasAlpha is false, no change is made.
Parameters
Section titled “Parameters”None.
Returns
Section titled “Returns”Nothing.
FootageSource.guessPulldown()
Section titled “FootageSource.guessPulldown()”app.project.item(index).mainSource.guessPulldown(method)
app.project.item(index).proxySource.guessPulldown(method)
Description
Section titled “Description”Sets fieldSeparationType and removePulldown to the best estimates for this footage source. If isStill is true, no change is made.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
method | PulldownMethod enum. | The method to use for estimation. One of: |
- PulldownMethod.PULLDOWN_3_2 | ||
- PulldownMethod.ADVANCE_24P |
Returns
Section titled “Returns”Nothing.