AFTEREFFECTS

News, Information & Workflows from Users & the Adobe Ae Team

Region of Interest: Adobe weblog about After Effects and related stuff from the After Effects team

details of video preview with Mercury Transmit in the 2014 update to After Effects CC

NOTE: This article is about new functionality in the 2014 update to After Effects CC, which is one of the many Creative Cloud updates announced today. For more details about this release of After Effects, read the complete list of what’s new and changed.
 

After Effects has for a long time had the ability to send frames to a video device for preview, for example on a broadcast monitor. In the 2014 update to After Effects CC, the underlying architecture for that functionality has been replaced with the same Mercury Transmit technology used by Premiere Pro.

This is an important change for After Effects because it removes a dependency on fragile, deprecated operating system components. Aside from that, Mercury Transmit allows for new functionality and enhancements with video preview:

  • Full-screen display on a monitor connected to your computer’s video card. This includes the HDMI port built into recent models of MacBook Pro.
  • 10-bit color output in 16-bpc and 32-bpc projects when using devices from AJA, Blackmagic Design, Bluefish444, and Matrox.
  • RAM preview frame rate performance is improved for memory-intensive compositions when video preview is enabled.
  • Simplified controls that no longer require you to specify the output video mode; After Effects and the device negotiate to set the video mode.

In addition to the above changes provided by Mercury Transmit, in the 2014 update to After Effects CC, the video preview image is color managed in the Rec. 709 color space.

Below are details about how video preview works in the 2014 update to After Effects CC, including known issues and limitations. If you have questions about these changes, please post to this thread in the After Effects user-to-user forum.

 


what is Mercury Transmit?


Mercury Transmit is a software interface that Adobe digital video applications use to send video frames to external video displays. Video device manufacturers AJA, Blackmagic Design, Bluefish444, and Matrox provide plug-ins that route the video frames from Mercury Transmit to their hardware. The same Mercury Transmit plug-ins work in Adobe Premiere Pro, Prelude, Speedgrade, and After Effects.

Mercury Transmit can also use monitors connected to your computer’s video card and FireWire-connected DV devices without an additional plug-in.

IMPORTANT: Mercury Transmit does not use GPU acceleration. It is a different technology from the Mercury Playback Engine in Premiere Pro.

 


how to set up video preview using Mercury Transmit in After Effects


To enable video preview with Mercury Transmit, open Preferences > Video Preview, choose Enable Mercury Transmit, and choose a video device from the list.

  • Devices named AJA Kona 3G, Blackmagic Playback, or similar represent a video device connected to your computer.
  • Adobe Monitor devices are the computer monitors connected to your video card.
  • Adobe DV requires a DV device connected to a FireWire port on your computer.

To change the options for your video device, click the “Setup” text next to the device name. More options may be available in the device’s control panel or management application.

To toggle external video preview on or off without opening the Preferences dialog box, press the forward slash (/) key on the numeric keypad. On a Mac keyboard without a numeric keypad, such as on a MacBook, use Control+Shift+/.

 


using color management with video preview


When you choose a color working space for the project, the image sent to the video preview monitor is transformed from the working color space to the Rec. 709 color space. The gamma curve of the image is linearized (gamma = 1.0) if the Linearize Working Space option is enabled.

If you use a monitor with a color profile other than Rec. 709, please tell us more about your workflow in this forum thread.

 


general notes about using video preview


In the Composition, Footage, and Layer panels:

  • Overlays such as safe margins, guides, mask paths, and effect controls are not sent to the video preview monitor.
  • Viewer settings such as magnification (zoom), color and alpha channel views, transparency grid (checkerboard), pixel aspect ratio correction, and exposure do not affect the video preview image.
  • When the region of interest is enabled, or when mask views are enabled in the Layer panel, the visible image will be scaled up to the size of the composition on the video preview monitor.
  • Fast Draft preview mode does not interactively update the video preview image. The video preview image will update when the mouse button is released.
  • Wireframe preview mode does not update the video preview image. Switch to a different preview mode to update the video preview image.

When rendering a composition using the render queue, After Effects will update the image on the video preview monitor. To disable this, turn off the Video Preview During Render Queue Output option in Preferences > Video Preview.

After Effects will stop sending the video preview image to the video preview monitor if you switch to a different application. To allow After Effects to continue to use the video preview monitor when it is not the frontmost application, turn off the Disable Video Output When In The Background option in Preferences > Video Preview. Note that After Effects will stop updating the image when it is not the frontmost application. RAM previews and render queue output will continue to render, but the image on the video preview monitor will not be updated until you return to After Effects.

 


performance of RAM preview playback when video preview is enabled


Video preview from After Effects requires additional processing power, which may cause RAM preview playback speeds to be less than real-time for memory-intensive compositions. This was true in previous versions of After Effects and remains true for video preview using Mercury Transmit, although Mercury Transmit provides better performance than the previous technology.

RAM preview frame rate performance is affected by a combination of your computer’s capabilities and the memory requirements of the composition. If you do not get real-time performance during RAM preview, try the following:

  • Reduce the resolution in the Composition or Preview panels.
  • Reduce the RAM preview frame rate in the Preview panel.
  • Reduce the project color depth to 16-bpc or 8-bpc, if applicable.
  • Disable color management (set the project’s working space to None).

 


notes about using video preview with AJA, Blackmagic Design, Bluefish444, and Matrox devices


Download the latest drivers and Mercury Transmit plug-ins for your device. While After Effects uses the same Mercury Transmit plug-ins as Premiere Pro, the plug-ins need to be updated for compatibility with After Effects.

AJA: The AJA Preview plug-in will conflict with Mercury Transmit for control of the monitor. Either disable Mercury Transmit (Preferences > Video Preview) or disable the AJA Preview plug-in (Window > AJA Preview).

Blackmagic Design: Blackmagic devices will not output compositions that do not match the device’s supported video modes. (ex. 720p59.94) Refer to the documentation for your Blackmagic device for a list of supported video modes.

Bluefish444: Check the Bluefish444 web site for up-to-date documentation.

Matrox: Uninstall previous drivers and install the latest drivers for your Matrox device. The driver installation will detect which versions of After Effects are installed on your computer and install the Mercury Transmit plug-in and/or the Matrox WYSIWYG plug-in that is appropriate for each version.

 


notes about using video preview with a computer monitor


The monitors connected to your video card appear as Adobe Monitor 1 or 2, etc. in the Video Preview preferences. These monitors will only be available when there is more than one monitor connected and the desktop is extended across these monitors. Desktop mirroring must be disabled.

Video preview using Mercury Transmit does not work on the same monitor that is being used by the After Effects application frame. Move or resize the application frame so it does not stretch across the monitor that you want to use for video preview. Panels can be undocked and placed on that monitor, but they will not be visible when Mercury Transmit is enabled.

The Full Screen option in the Preview panel is not compatible with Mercury Transmit. Disable it when using a monitor connected to your video card.

The video preview image is displayed full-screen on the computer monitor, with letterbox or pillar-box bars as appropriate, regardless of the size of the composition or the resolution of the monitor.

The video preview image may not display correctly if you plug in the monitor cable while After Effects is running. Quit and restart After Effects to get a correct preview.

what’s new and changed in After Effects CC 2014 (13.0)

As David Wadhwani has just announced, today we have released the next major update to Creative Cloud applications, including After Effects CC.

The After Effects CC 2014 update (version 13.0) is available to all Adobe Creative Cloud members. Just go to the Creative Cloud download center or open the Creative Cloud desktop application to download the new updates for After Effects and many other applications.

For information about purchasing a Creative Cloud subscription, go here. For more information about Creative Cloud, see this overview video and the Creative Cloud FAQ list.

Please, if you want to ask questions about these new and changed features, come on over to the After Effects user-to-user forum. That’s the best place for questions (and, if you follow that link, you’ll find more information about how to communicate with us). Questions left in comments on a blog post are much harder to work with; the blog comment system just isn’t set up for conversations. If you’d like to submit feature requests (or bug reports), you can do so here.


new features in the After Effects CC 2014 (13.0) update

  • Key Cleaner effect and Advanced Spill Suppressor effect
  • text templates created in After Effects editable in Premiere Pro
  • compositing options for each effect, including ability to confine the area affected by each effect with masks
  • import of masks from Premiere Pro
  • HTML5 panels using CEP infrastructure
  • Kuler panel
  • ProEXR v1.9: higher-performance OpenEXR importer, updated IDentifier and EXtractoR effects
  • import of Sony RAW footage (raw files from F5, F55, and F65 cameras)
  • import of MPEG-4 SStP (Simple Studio Profile) Sony SR MXF files
  • video preview on external monitor using Mercury Transmit
  • scripting access to render settings and output module settings
  • automatic adjustment in Curves effect, plus improvements to Curves effect user interface
  • menu command to add fonts from Typekit
  • digital Cinema Package (DCP) export through Adobe Media Encoder

resources for learning about these new and changed features

Read on for a virtually comprehensive list of changes, with detail beyond the summaries of the top items listed above. We’ll be posting a lot more detail over the coming weeks, and the outline below will be populated with links to in-depth articles and tutorials, so bookmark this page and check back.


Key Cleaner effect and Advanced Spill Suppressor effect

The Key Cleaner effect recovers detail from a scene keyed by a typical keying effect, including recovering detail from a keyed scene with compression artifacts.

The Advanced Spill Suppressor effect removes color spill on a foreground subject from a colored background used for color keying.

The Key Cleaner and Advanced Spill Suppressor effects are intended to be used along with any keying effect that can provide the original RGB data as input (e.g., as the Keylight effect can using its Intermediate Result setting).

Brian Maffitt demonstrates the use of the Key Cleaner and Advanced Spill Suppressor effects in this video on the Adobe website.

The Advanced Spill Suppressor effect has two methods for spill suppression: Standard and Ultra. The Ultra method is based on the spill suppression in the Ultra Key effect in Premiere Pro. The Standard method is simpler and requires less user input. In the majority of cases in our testing, the Standard method provides the better results, but the Ultra method can be useful for scenes in which the screen color is refracted through an object. If Standard doesn’t work for you, then try Ultra.

Tip: You can use an effect mask on the Key Cleaner effect to restrict the result of a wider Additional Edge Radius value (e.g., hair) without causing unwanted semi-transparent regions in sharper regions (e.g., shoulders/arms).

You can control the contrast in the alpha channel in semitransparent regions (along edges) with the Alpha Contrast property in the Key Cleaner effect.

The easiest way to apply these three effects is with the Keylight + Key Cleaner + Advanced Spill Suppressor animation preset:

1. Apply the Keylight + Key Cleaner + Advanced Spill Suppressor animation preset, which is in the Animation Presets > Image – Utilities category in the Effects & Presets panel. This adds the Keylight, Key Cleaner, and Advanced Spill Suppressor effects to the layer. The Advanced Spill Suppressor effect is turned off by default to allow you to sample the key color in the Keylight effect.

2. Use the Keylight effect’s Screen Colour eyedropper to sample the key color from the layer in the Composition panel. Adjust other Keylight effect settings as you normally would to get the best results.

3. Turn on the effect switch for the Advanced Spill Suppressor effect to remove color spill from the scene.

Note: If you use the Keylight + Key Cleaner + Advanced Spill Suppressor animation preset, the Key Color property is already linked with an expression to the Keylight effect’s Screen Colour property, so you don’t need to change it unless you want to use a different color for the despill process. If so, just disable or remove the expression.

To use a keying effect other than the Keylight effect, do the following:

1. Apply the keying effect to the layer.

2. Set the effect to the equivalent of the Keylight effect’s Intermediate Result setting, so that the keying effect gives the full RGB result without attempting to perform its own spill suppression.

3. Apply the Key Cleaner effect after the keying effect.

4. Apply the Advanced Spill Suppressor effect after the Key Cleaner effect.


text templates created in After Effects editable in Premiere Pro

You can create text template compositions in After Effects for which the source text remains editable in Premiere Pro.

Any composition with text layers can be used as a text template, and any unlocked text layers in that composition will remain editable in Premiere Pro.

Brian Maffitt demonstrates the new text templates workflow in this video on the Adobe website.

Here is a basic set of instructions for exercising this feature that shows off how it works:

1. Create an After Effects composition with one or more text layers.

2. In the Advanced tab of the Composition Settings dialog box, check the box next to “Template (unlocked text layers editable in Premiere Pro”. Note the important descriptive text under this control: “When ‘Template’ is checked, only template compositions in this project will be visible to Premiere Pro.”
Animate, add effects, and do whatever else you like, just as you would normally work in After Effects.

3. Lock any text layers that you do not want to be editable in Premiere Pro.

4. In Premiere Pro, import the After Effects composition.

5. Load the composition in the Source Monitor (context-click the source item in the Project panel and choose Open In Source Monitor) and look in the Effect Controls panel in Premiere Pro, where you will see a new After Effects Editable Text category.

6. Edit one or more of the source text items in the Effect Controls panel in Premiere Pro, and verify that this appears in the content in Premiere Pro. The changes do not affect the original material in After Effects.

7. In After Effects, modify some aspects of the composition, including properties of the text layer, such as position and color. Verify that these changes are also shown in Premiere Pro.

8. In After Effects, modify the source text of one of the text layers for which you already changed the corresponding text in Premiere Pro. Verify that the text does not change in Premiere Pro.

As you can see by following these steps, changes made to the text in Premiere Pro cause the text content of that field to become “owned” by Premiere Pro, but all other changes in After Effects are carried through to Premiere Pro through Dynamic Link.

One convenient way to understand how text templates work in Premiere Pro is to think of the After Effects composition loaded into Premiere Pro as being just like any other media asset–like a movie file–and the text settings as being just like any other master clip effect.


compositing options for each effect, including ability to confine area affected by each effect with masks

In the Timeline panel, each effect’s property group includes a Compositing Options property group.

By default, the Compositing Options property group includes an Effect Opacity property, which can be thought of as providing the same functionality as the Blend With Original control found in a few effects in previous versions of After Effects.

You can also add any number of mask references to an effect to constrain the area within which the effect’s operations are applied. For example, you can draw and track masks around a subject’s eyes and constrain the Change To Color effect to only operate within those two masks to change the eye color, leaving colors outside the masks unaffected. Another simple and common usage is to use a blur effect or the Mosaic effect on a tracked rectangular or elliptical mask to obscure a license plate, logo, or face, as in the example below:

To add a mask reference to an effect, click the plus sign next to the Compositing Options heading and choose a mask from the Mask Reference menu.

You can only choose a mask on the same layer as the effect. You can add as many mask references as you like. Note that you can use different masks for various effects on the same layer. Feathering, mask tracking, and mask expansion properties of the mask are honored in the constraints of the effect area.

When a mask is used as an effect mask, it is not also used as a layer mask – i.e., when a mask is used to constrain the area of an effect, the mask is not also used to modify the alpha channel of the layer. A mask that is used as an effect mask has a blue fx icon to the left of its name in the Timeline panel; clicking this icon expands the effect(s) for which the mask is used as an effect mask. Similarly, when an effect is constrained by a mask, the entry for the effect in the Effect Controls panel has a blue circle icon to the left of the effect name; clicking this icon expands and selects the mask(s) in the Timeline panel.

Brian Maffitt demonstrates the new effect masks and compositing options in a video on the Adobe website.

John Dickinson’s video overview of the new features does an excellent job showing the effect mask feature.


import of masks from Premiere Pro

When you import a clip from Premiere Pro that includes masks, those masks are preserved and converted to After Effects masks.

This works for all methods of importing clips from Premiere Pro, including using the Replace With After Effects Composition command in Premiere Pro, copying and pasting from Premiere Pro to After Effects, and importing a Premiere Pro project into After Effects.

The mask shape, feather, opacity, expansion, and inversion properties are all preserved, including keyframes on those properties.

If a clip has a Crop effect applied in Premiere Pro, this is converted to a mask on a layer when imported into After Effects.


Auto adjustment in Curves effect

To adjust the curves in the Curves effect automatically, click the Auto button beneath the curves in the Effect Controls panel.

This automatic adjustment is based on a database of curve adjustments performed by color and photography experts on a broad range of input images. The adjustment made to an image is an interpolation between the adjustments made to reference input images with similar color distributions.


improvements to Curves effect user interface

The primary user interface element in the Curves effect (the curves graph itself) is now resizable using buttons immediately above the curves.

You can directly select and manipulate the individual color channels’ curves without using the Channel menu.

The curves themselves are drawn more smoothly.

The icon-based buttons for Open, Save, Smooth, and Reset (which didn’t even have tooltips) have been replaced with word-based buttons that make their functionality more discoverable.

John Dickinson’s video overview of the new features does an excellent job showing the Curves effect improvements.


HTML5 panels using CEP infrastructure

After Effects now includes the CEP (Common Extensibility Platform) infrastructure for loading and using HTML5 panels. These panels have access to the entire After Effects scripting object model – in addition to being able to use HTML, CSS, and JavaScript – so a very wide variety of extensions can be created using this system.

Premiere Pro and several other Adobe applications have already integrated this infrastructure, so you may already be familiar with such panels as those created by stock footage companies, training providers, and so on. The previous name for the CEP system was ‘CSXS’, so you may know it by that name.


Kuler panel

The Kuler panel integrated into After Effects is one of the first instances of an HTML5 CEP panel built for After Effects.

Using this panel, you can load and explore collections of colors and sample from these swatches for use in After Effects.


menu command to add fonts from Typekit

In the File menu, there is a new command, Add Fonts From Typekit, which opens the Typekit website in your default web browser. You can then download fonts from the Typekit library for immediate use in After Effects and other applications.


ProEXR v1.9: higher-performance OpenEXR importer, IDentifier effect, EXtractoR effect

Brendan Bolles explains the new and improved features of the ProEXR plug-ins here and here, including a higher-performance OpenEXR importer.


Sony RAW importer (for raw files from F5, F55, and F65 cameras)

You can now import raw files from Sony F5, F55, and F65 cameras into After Effects.

To test this feature with Premiere Pro, start by importing such files into Premiere Pro and then import clips based on these files into After Effects using Dynamic Link, importing the Premiere Pro project into After Effects, et cetera.

As with ARRIRAW files, the source settings are not carried over when transferring a clip from Premiere Pro to After Effects.


video preview on external monitor using Mercury Transmit

We have replaced the QuickTime-based and DirectShow-based video preview system for external monitors with a system based on Mercury Transmit.

For details of these changes, see this article.

Video preview using Mercury Transmit sends the contents of the Composition, Layer, or Footage panel viewer to an external monitor. The external monitor can be a video monitor connected through third-party video hardware (e.g., AJA, Blackmagic, Matrox I/O devices), a DV device connected over FireWire, or it can be a computer monitor connected to your video display card (via HDMI, DVI, VGA, DisplayPort, etc.).

The video preview sent to an external monitor using Mercury Transmit is color-managed (treating the external video preview monitor as an HDTV Rec. 709 device). This fixes a long-standing limitation in external video preview in After Effects when using color management.


fixed bug in implementation of Perlin noise algorithm

We’re not posting the details of all of the bugs fixed in the next version of After Effects, but this bug seemed worthy of special mention, since the fix does change the appearance and behavior of old projects.

The implementation of the Perlin noise algorithm used by After Effects has had a long-standing bug that caused results to be biased toward negative results, as well as causing excessive flat regions in the function’s graph. This bug has been fixed.

The result is that the wiggle expression method, the Wiggle Transforms shape layer operator, and various other features that use this form of noise will render differently in this version of After Effects. In general, this should not be a concern, since it is unlikely that anyone was depending on any specific random values being generated. However, if you do have any examples where this change causes a problem, let us know.


expression sampling interval

After Effects evaluates an expression at various times to determine whether the values held in the global performance cache are current or are stale and need to be updated with fresh values. This sampling at various times along the composition can cause interactions in a composition that combines expressions and certain other features to be rather slow, which causes various interactions to be sluggish.

You can force the number of samples for a given expression to be exactly 1 for the entire composition by inserting the following comment in the expression:

// cacheCompareSamplesPerSecond 0

Even without the addition of this comment, After Effects will only use one sample for the entire composition if there are no features used that span across multiple frames, such as motion blur or wide-time effects (e.g., the Echo effect).

The risk of using this feature to specify that only one sample is used is that you may get stale values in the global performance cache. Only use this comment when you are experiencing slowdowns with expression evaluation; be sure to check your rendered frames to make sure that they are updating as they should.

You can also use the same comment with a whole number value to specify a sampling rate with the units of samples per second. For example, the following comment forces the expression to be sampled 25 times per second – i.e., on every frame of a 25fps composition:

// cacheCompareSamplesPerSecond 25

You should very rarely need to specify a higher sampling rate than the default, since After Effects will by default use an adaptive sampling rate that should be appropriate for most cases. Only set a higher sampling rate if you find that the frames that you are seeing contain the wrong image information that is not updating when it should. Specifying a high sample rate will slow down expression evaluation, so it should only be used when a problem is actually observed. You are only likely to run into this problem if the expression is upstream from a temporal effect such as Echo or Roto Brush or an extreme time speedup, or has very high frequencies and is motion blurred.


export of Digital Cinema Package (DCP) files through Adobe Media Encoder

Adobe Media Encoder is adding many new useful features, including the ability to export a Digital Cinema Package (DCP). See this page for more information, and stay tuned for additional details.


scripting access to render settings and output module settings

  • Added: RenderQueueItem object getSetting, setSetting methods
  • Added: OutputModule object getSetting, setSetting methods
  • Added: RenderQueueItem object getSettings, setSettings methods
  • Added: OutputModule object getSettings, setSettings methods

Example:
// Get current value of render setting's "Proxy Use"
// Key and value strings are English.

var rqItem1_proxyUse = app.project.renderQueue.item(1).getSetting("Proxy Use");

// Get string version of same setting, add "-str" at the end of key string

var rqItem1_proxyUse_str = app.project.renderQueue.item(1).getSetting("Proxy Use-str");

// Set value of "Proxy Use" to "Use All Proxies"

app.project.renderQueue.item(1).setSetting("Proxy Use", "Use All Proxies");

// You can use numbers, too.
// The next line does the same as the previous example.

app.project.renderQueue.item(1).setSetting("Proxy Use", 1);

Example:

// Get object containing string version of all current render setting
// values of render queue item 1.
// To get the values in the number format, use GetSettingsFormat.NUMBER
// as an argument.

var rqItem1_all_str = app.project.renderQueue.item(1).getSettings( GetSettingsFormat.STRING );

// Convert to JSON format so that it is human-readable.

var rqItem1_all_str_json = rqItem1_all_str.toSource();

// Get an object that contains string version of settable render setting
// values of render queue item 1.
// To get the values in the number format, use
// GetSettingsFormat.NUMBER_SETTABLE as an argument.

var rqItem1_settable_str = app.project.renderQueue.item(1).getSettings( GetSettingsFormat.STRING_SETTABLE );

// Set render queue item 2 with values that you got from render
//queue item 1.

app.project.renderQueue.item(2).setSettings( rqItem1_settable_str );

// Set render queue item 3 with values you create.

var my_renderSettings = {
"Color Depth":"32 bits per channel",
"Quality":"Best",
"Effects":"All On",
"Time Span Duration":"1.0",
"Time Span Start":"2.0"
};
app.project.renderQueue.item(2).setSettings( my_renderSettings );

// Get object that contains all possible values of all render settings of
// render queue item 1 and convert to JSON format.

var rqItem1_spec_str = app.project.renderQueue.item(1).getSettings(GetSettingsFormat.SPEC);
var rqItem1_spec_str_json = rqItem1_spec_str.toSource();

// Get object that contains the string version of all current output module setting
// values of output module item 1 from render queue item 1.
// To get the values in the number format, use GetSettingsFormat.NUMBER as an argument.

var omItem1_all_str= app.project.renderQueue.item(1).outputModule(1).getSettings( GetSettingsFormat.STRING );

// Convert to JSON format so that it is human-readable.

var omItem1_all_str_json = omItem1_all_str.toSource();

// Get object that contains string version of settable output module setting values
// of output module item 1 from render queue item 1.
// If you want to get the values in the number format, use
// GetSettingsFormat.NUMBER_SETTABLE as an argument.

var omItem1_settable_str = app.project.renderQueue.item(1).outputModule(1).getSettings( GetSettingsFormat.STRING_SETTABLE );

// Set output module item 1 of render queue item 2 with values that you get from
// output module 1 of render queue item 1

app.project.renderQueue.item(2).outputModule(1).setSettings( omItem1_settable_str );

// Set output module item 1 of render queue item 3 with values that you create.

var crop_data = {
"Crop":true,
"Crop Bottom":0,
"Crop Left":0,
"Crop Right":8,
"Crop Top":10
};

app.project.renderQueue.item(1).outputModule(3).setSettings( crop_data );

// Currently, the format setting in the output module is not settable, but it
// is readable. The next line will tell you the current format of output module
// item 1 from render queue item 1.

var current_format = app.project.renderQueue.item(1).outputModule(1).getSettings(GetSettingsFormat.STRING).Format;

// This line will tell you the output module file info.

var current_omFileTempalte = app.project.renderQueue.item(1).outputModule(1).getSettings(GetSettingsFormat.STRING)["Output File Info"]["File Template"];

// Note: there is a bug that causes OutputModule object to be invalidated after the
// output module setting is modified.
// So, you need to retrieve OMitem after you modify it.

Example:

// This is the new way to change the output file path of output module 1 of
// render queue item 1.
// In this example, output file is routed to the user directory.

var om1 = app.project.renderQueue.item(1).outputModule(1);
var file_name = File.decode( om1.file.name ); // Name contains special character, space?
var new_path = "~/new_output";
var new_dir = new Folder( new_path );
new_path = new_dir.fsName;

var new_data = {
"Output File Info":
{
"Base Path":new_path,
"Subfolder Path":"draft",
"File Name":file_name
}
};

om1.setSettings( new_data );
}

Example:

// This is the new way to change the output file path of output module 1 of
// render queue item 1.
// In this example, the output file is routed to the user directory,
// but this time using the full path.

var om1 = app.project.renderQueue.item(1).outputModule(1);

var file_name = File.decode( om1.file.name ); // Name contains special character, such as space?
var new_path = "/Users/myAccount/new_output";
var separator = "/";
if ($.os.indexOf("Mac") == -1)
{
new_path = "C:\\Users\\myAccount\\new_output";
separator = "\\";
}

var new_data = {
"Output File Info":
{
"Full Flat Path":new_path + separator + file_name
}
};

om1.setSettings( new_data );


After Effects localized into Russian and Brazilian Portuguese

The next version of After Effects will be available in two more languages: Russian and Brazilian Portuguese.


new command for saving backward one major version

The command for saving project as a copy for the previous version has been incremented to File > Save As > Save A Copy As CC (12). To save a project that can be opened by After Effects CS6 requires an additional step, saving back from After Effects CC (12).


old Spill Suppressor effect obsolete

The Spill Suppressor effect has been moved to the Obsolete category. It has been superseded by the Advanced Spill Suppressor effect.


removal of H.264, MPEG-2, WMV, FLV, F4V, and SWF exporters from After Effects

To export to final delivery formats such as MPEG-2, H.264, and WMV, use Adobe Media Encoder. You can either add compositions directly to the Adobe Media Encoder encoding queue (Composition > Add To Adobe Media Encoder Queue) or render and export a lossless master file directly from After Effects that Adobe Media Encoder picks up from a watch folder to encode to various final delivery formats.

The SWF, FLV, and F4V exporters were removed because the recommended workflow for creating movies that play in Flash Player is to create an H.264 video using Adobe Media Encoder and then use Flash Professional to link or embed that video in a SWF container.

what’s new and changed in the 2014 update to Adobe Media Encoder CC

As David Wadhwani has just announced, today we have released the next major update to Creative Cloud applications, including Adobe Media Encoder (AME) CC.

The Adobe Media Encoder CC 2014 update (version 8.0) is available to all Adobe Creative Cloud members. Just go to the Creative Cloud download center or open the Creative Cloud desktop application to download the new updates for After Effects and many other applications.

For information about purchasing a Creative Cloud subscription, go here. For more information about Creative Cloud, see this overview video and the Creative Cloud FAQ list.

One of the first things that you’ll notice about this version of Adobe Media Encoder is that it is available for download and installation separate from other applications—i.e., you can install Adobe Media Encoder CC 2014 on a computer without also installing After Effects or Premiere Pro or another client application on that same computer. This makes it much simpler, for example, to set up a computer to be used as a dedicated system for transcoding master output files to various final delivery formats.

For broadcast we’ve added AS-11 functionality, specifically catering to the requirements for the UK using the DPP specifications. The AS-11 workflow starts in Premiere Pro, where you can add all required metadata and add markers for segmentation. In AME, you can choose from suitable options for producing AS-11 output. AME will automatically take care of choosing the correct codec, the frame rate, and everything else that’s required to get your work ready for prime time.

The second packaging technology we’re adding is licensed from one of the leaders in Digital Cinema Package (DCP) technologies. The Wraptor DCP exporter by Quvis is a fast and easy way for taking your project to a theater at 2K with 24 fps and up to 5.1 audio.

Adobe Media Encoder CC 2014 also provides fault-tolerant rendering, which tracks issues and heals red-frame and black-frame issues without holding up your render queue.

Additionally, there are lots of other improvements like a wider range of GPU-accelerated tasks, enhancements to the overall AME user experience, and expanded features related to a number of new UltraHD and 4K standards, such as XAVC.

Patrick Palmer shows a few of these new features in Adobe Media Encoder CC 2014 in this video on Adobe TV.

scripting changes in After Effects CC (12.0-12.2)

This article describes the changes to the After Effects scripting interface implemented in After Effects CC (12.0). You can use this article together with the most recent full version of the After Effects scripting guide (for After Effects CS6), which you can find on the After Effects Developer Center page.

There were no significant changes in the scripting interface for After Effects CC (12.1) or After Effects CC (12.2).


ScriptUI Drover adpapter

ScriptUI is now based on the same controls as the main application.

The scripting reference for ScriptUI is in the Adobe Creative Cloud JavaScript Tools Guide (PDF).


access to effect’s internal version string

Added: Application effects object’s version attribute to get an effect’s internal version string. This value might be different than the version number the plug-in vendor decides to show in the effect’s about box.


ability to get and set preview mode

Added: ViewOptions fastPreview property to access the state of the Fast Previews menu with the scripting interface. This is a read/write attribute using an enumerated value:

Value Fast Previews menu option
FastPreviewType.FP_OFF Off (Final Quality)
FastPreviewType.FP_ADAPTIVE_RESOLUTION Adaptive Resolution
FastPreviewType.FP_DRAFT Draft
FastPreviewType.FP_FAST_DRAFT Fast Draft
FastPreviewType.FP_WIREFRAME Wireframe

If you try to get or set the attribute’s value in the Layer or Footage panel, you’ll get an error message.

The Draft preview mode is only available in ray-traced 3D compositions. If you try to use it in a Classic 3D composition, you’ll get an error: “Cannot set Draft fast preview mode in a Classic 3D composition.”


access to layer sampling method

Added: layer.samplingQuality and LayerSamplingQuality enum to set/get layer sampling method (bicubic or bilinear):

Example:
// Set layer to bicubic sampling

app.project.activeItem.layer(1).samplingQuality = LayerSamplingQuality.BICUBIC;

// Set layer to bilinear sampling

app.project.activeItem.layer(1).samplingQuality = LayerSamplingQuality.BILINEAR;


changed preference and settings methods

Preferences and settings methods now take a third argument to specify the target preferences file if Section/Key is not in “Adobe After Effects 12.x Prefs.txt”. If the third argument is not passed, default value (PREFType.PREF_Type_MACHINE_SPECIFIC) is used and After Effects tries to save/get from the “Adobe After Effects 12.x Prefs.txt” preferences file. The third argument is enum PREFType value.

You can now pass the preference type with a script with new PREFType enum:

  • PREF_Type_MACHINE_SPECIFIC
    Adobe After Effects 12.x Prefs.txt
  • PREF_Type_MACHINE_INDEPENDENT
    Adobe After Effects 12.x Prefs-indep-general.txt
  • PREF_Type_MACHINE_INDEPENDENT_RENDER
    Adobe After Effects 12.x Prefs-indep-render.txt
  • PREF_Type_MACHINE_INDEPENDENT_OUTPUT
    Adobe After Effects 12.x Prefs-indep-output.txt
  • PREF_Type_MACHINE_INDEPENDENT_COMPOSITION
    Adobe After Effects 12.x Prefs-indep-composition.txt
  • PREF_Type_MACHINE_SPECIFIC_TEXT
    Adobe After Effects 12.x Prefs-text.txt
  • PREF_Type_MACHINE_SPECIFIC_PAINT
    Adobe After Effects 12.x Prefs-paint.txt

Example:
// Section ["Settings_test_section"] is saved in "Adobe After Effects 12.x Prefs.txt" without third argument

app.settings.saveSetting("test_section", "test_key1", "test_key1_value");

if (app.settings.haveSetting("test_section", "test_key1"))
var current_set = app.settings.getSetting("test_section", "test_key1");

// Section ["Settings_test_section2"] is saved in "Adobe After Effects 12.x Prefs-indep-general.txt"

app.settings.saveSetting("test_section2", "test_key1", "test_key1_value", PREFType.PREF_Type_MACHINE_INDEPENDENT);

if (app.settings.haveSetting("test_section2", "test_key1", PREFType.PREF_Type_MACHINE_INDEPENDENT))
var current_set2 = app.settings.getSetting("test_section2", "test_key1", PREFType.PREF_Type_MACHINE_INDEPENDENT);

Example:
alert(app.preferences.getPrefAsString("Text Style Sheet", "Font Family Name", PREFType.PREF_Type_MACHINE_SPECIFIC_TEXT));

Maxon Cinema 4D importer plug-in updated, fixes “Unexpected FunctionBlock5 flags” error

Maxon has fixed a bug in their plug-in for exchange of data with After Effects CC that caused some errors when the plug-in was loaded.

To get the new plug-in, go to this page on the Maxon website and click the “Download” link next to the “Plugins for After Effects CC CINEMA 4D R14/R15 connection” heading.

With the previous version of the plug-in, you might see the following error messages when After Effects started and loaded the plug-in:

“After Effects error internal verification failure, sorry! {Unexpected FunctionBlock5 flags for FunctionBlock4} (5024 ::53)”

“AEGP Plugin SDK_IO: Could not register file type. (5027 :: 12).”

“AEGP Plugin SDK_IO: There was an error registering the plugin. (5027 :: 12).”

You can tell whether you have the current version of the plug-in by looking at its modification date in the file system, which is February 28, 2014 for the new version.

Nvidia CUDA driver update fixes crashes for After Effects and other applications

We are seeing reports that the Nvidia CUDA 5.5.47 update released today addresses crashing problems introduced by the CUDA 5.5.43 update.

So, if you have an Nvidia GPU, please update your drivers to use the most recent version of the CUDA driver.

IMPORTANT: DO NOT install CUDA drivers on computer systems that do not have an Nvidia GPU! If you have done so, then you must uninstall the CUDA framework from your system. If you have CUDA software installed on a computer that does not have Nvidia CUDA-capable hardware, bad things happen, including crashes.

On Mac OS, you can update your version of the CUDA driver from the CUDA panel, available from the Mac OS System Preferences. For CUDA downloads, see the Nvidia website.

Feel free to let us know on this forum thread whether or not this update is working for you.

Also, make sure that you have installed the most recent updates for your Adobe video applications.

After Effects CC (12.2.1) bug-fix update

The After Effects CC (12.2.1) bug-fix update is now available.

You can install the update through the Creative Cloud desktop application, or you can check for new updates from within any Adobe application by choosing Help > Updates. One way to check for updates is by closing all Adobe applications other than Adobe Bridge, and choosing Help > Updates in Adobe Bridge; this ensures that all processes related to Adobe video applications have been quit and can be updated safely.

Ideally, you should install the updates automatically through the Creative Cloud desktop application or by choosing Help > Updates, but you can also directly download the update packages from the download page for Windows or Mac OS by choosing the “Adobe After Effects CC (12.2.1)” update for your operating system.

We have also been working with several providers of plug-ins, codecs, and hardware devices to assist them in updating their software to fix some errors and crashes. Please take this opportunity to download and install updated codecs, plug-ins, and drivers from these providers, as relevant to your work.

Updates are cumulative, so this update includes all of the features and bug fixes in the After Effects CC (12.2) and After Effects CC (12.1) updates.

For details of all of the other updates for Adobe professional video and audio applications, see this page.

Please, if you want to ask questions about this update, come on over to the After Effects user-to-user forum. If you’d like to submit feature requests (or bug reports), you can do so here.


summary of what’s fixed in After Effects CC (12.2.1)


  • Dragging a folder of source items into the Project panel did not import the source items. This is now fixed.
  • The output audio sample rate was reset to the lowest value (often 8kHz) in the Output Module Settings dialog box. This is now fixed.
  • QuickTime output files had extra frames at the end when exporting with audio to certain codecs, including ProRes. This is now fixed.
  • Purging of the disk cache using the commands in After Effects did not function on systems that use comma as decimal separator. This is now fixed.
  • After Effects crashed when attempting to read temporal XMP metadata from files created by Illustrator 17.1 (as well as files from other applications based on those Illustrator files). This is now fixed for After Effects CC (12.2.1), but the same badly formed files can cause problems in previous versions of After Effects; see this page for details of a workaround for previous versions of After Effects.
  • We also fixed several bugs related to output file name and location templates.

We previously published a list of these known issues and workarounds for them here.

IMPORTANT: Additionally, the new version of the Creative Cloud desktop application fixes a major issue regarding the setting of permissions for folders during installation that caused many applications to crash or behave incorrectly. Be sure to follow the instructions here to update the Creative Cloud desktop application, since this patch fixes several issues related to After Effects, too.

known issues and workarounds for After Effects CC (12.2)

[UPDATE: These issues are addressed in the After Effects CC (12.2.1) bug-fix update. ]

Since we released After Effects CC (12.2), we have found some bugs. We are working on fixing these bugs, of course, and we’ll be releasing a bug-fix update soon (within a couple of weeks if all goes well) that addresses many of them. Stay tuned to this blog for details of the upcoming bug-fix update. In the meantime, we wanted to make sure that you knew of these issues and how to work around them.


Dragging a folder of source items into the Project panel does not import the source items.

The After Effects CC (12.2) update broke the ability to import a folder of source files into a project by dragging the folder into the Project panel.

We’re testing a fix for this bug right now. In the meantime, you can still import files using the File > Import commands and by double-clicking in an empty area of the Project panel.


Output audio sample rate is reset to lowest value (often 8kHz) in Output Module Settings dialog box.

Beginning in After Effects CC (12.2), when you interact with the Output Module Settings dialog box, the audio sample rate is changed to the lowest value acceptable for the format and the codec selected. For example, with QuickTime the lowest value is 8kHz, and for MXF OP1a the only acceptable value is 48kHz. This causes some outputs to mistakenly be created with the wrong audio sample rate.

See this article by Chris and Trish Meyer and this forum thread with Tim Kurkoski for more details and a simple workaround.


QuickTime output files have extra frames at the end when exporting with audio to some codecs.

Some QuickTime movies created by After Effects using certain video codecs (e.g., ProRes, DVCPROHD) contain extra frames at the end if the output includes audio.

See this forum post by Tim Kurkoski for details about this bug and how to work around it for now.


Purging of the disk cache using the commands in After Effects does not function on systems that use comma as decimal separator.

If the computer system’s locale settings specifies that the decimal separator is a comma (,)–as is common in many locales–then the commands in After Effects for purging the disk cache fail.

To work around this bug, you can either manually delete the cache files or switch your locale settings in your OS to use the dot (.) as the decimal separator.

For more information, see this forum thread with Will Lockwood.


In some cases, output file name and location templates are not used on the first try.

In some cases, when you attempt to use an output file name and location template, the change is not applied on the first try. The workaround is simple: If the output file name and location template that you want to use is not applied when you choose it, just choose it again.


After Effects crashes when attempting to read temporal XMP metadata from files created by Illustrator 17.1 and Photoshop 14.2.

(This isn’t actually an issue specific to After Effects CC (12.2); it affects every version of After Effects.)

The new version of Adobe Illustrator (17.1) creates files (.ai, .eps, .pdf files) that contain XMP metadata in a format that caused After Effects to crash when reading that metadata. The same problem exists for some files created by Photoshop 14.2, including JPEG and PNG files, though this may be limited to Photoshop files created with assets originating from Illustrator 17.1.

To avoid this problem, disable the Create Layer Markers From Footage XMP Metadata preference, which prevents After Effects from scanning the imported file for temporal XMP metadata when its footage item is added to a composition.

For more information, see this post on the After Effects team blog.


After Effects fails to start on Mac OS with warning message about not being about to rename or move a file.

(This, too, isn’t actually an issue specific to After Effects CC (12.2); it affects every version of After Effects and a lot of other applications.)

In some cases, After Effects fails to start, giving a warning message like this:
“After Effects warning: Could not rename the file ‘/Users/USERNAME/Library/Preferences/Adobe/After Effects/12.2/Workspaces.numbers.xml’ to ‘workspaces.xml’.”

The warning might be about something somewhat different, but any message that says that a file can’t be written, overwritten, or renamed is likely caused by the same root issue:

This happens because Mac OS has incorrectly set the permissions for some files, preventing After Effects from writing and moving the files that it needs to operate.

One common cause of this problem is that when you upgrade a Mac OS (as opposed to installing the new version fresh), Mac OS will often set permissions of folders and files incorrectly.

To fix this in the case of After Effects, go to the preferences folder and set the entire preferences folder ( Users/USERNAME/Library/Preferences/Adobe/After Effects/12.2/ ) and all of its contents to be writable, not read-only.

Note that Apple hides the Library folder by default, so you’ll need to show the Library folder. See this page on the Apple website for instructions on setting permissions.

opening After Effects projects from previous versions and saving back to previous versions


opening and importing projects from previous versions of After Effects

Each version of After Effects can open and import projects made with that version and several other versions, but only going back a limited number of versions:

  • After Effects CC 2014 (13) can open projects from After Effects 7 through After Effects CC 2014 (13).
  • After Effects CC (12) can open projects from After Effects 7 through After Effects CC (12).
  • After Effects CS6 (11) can open projects from After Effects 7 through After Effects CS6 (11).
  • After Effects CS5.5 (10.5) can open projects from After Effects 6.5 through After Effects CS5.5 (10.5).
  • After Effects CS5 (10) can open projects from After Effects 6 through After Effects CS5 (10).
  • After Effects CS4 (9) can open projects from After Effects 5 through After Effects CS4 (9).
  • After Effects CS3 (8) can open projects from After Effects 4 through After Effects CS3 (8).
  • After Effects 7 can open projects from After Effects 3.0 through After Effects 7.

There are two main reasons for us incrementing the oldest version that can be imported or opened from one version to the next: 1) this limits the amount of testing that we need to do and 2) sometimes there are conversions from one project format to another that are very difficult or buggy or otherwise problematic.

Note that we haven’t incremented the oldest version that can be opened or imported in the past several versions. This is in part because our automated testing has improved, so the testing burden is less of a problem, and it’s in part because we haven’t had any technical limitations that would cause the conversion to be too tricky. We’re trying to keep the backward support as long as possible so that you can still easily use your old projects as needed.


saving backward

In After Effects CS5.5, we added the ability to save a copy of a project backward so that it could be opened by the previous major version.

  • After Effects CS5.5 (10) has the command Save > Save As > Save A Copy As CS5.
  • After Effects CS6 (11) has the command Save > Save As > Save A Copy As CS5.5.
  • After Effects CC (12) has the command Save > Save As > Save A Copy As CS6.
  • After Effects CC 2014 (13) has the command Save > Save As > Save A Copy As CC (12).

If you need to save back from, say, After Effects CC (12.2) to After Effects CS5 (10), you’ll need to go through a multi-step process, saving back one version at a time.

Or, if you don’t mind spending a few dollars on a very handy script, pt_OpenSesame, you can save to a text-based format that preserves much (though not all) of a project’s information and can be opened in any version of After Effects from CS3 (8) onward. This script is also terrific for automated workflows when you want to be able to edit a project file without opening After Effects to do so, such as when just replacing a little bit of text.

preventing crash in After Effects when using Illustrator files

The new version of Adobe Illustrator (17.1) creates files (.ai, .eps, .pdf files) that contain XMP metadata in a format that causes After Effects to crash when reading that metadata. The crash occurs when you add a footage item from Illustrator to a composition.

We have released a bug-fix update for After Effects CC (12) to prevent this crash, but the crash still affects After Effects CS6 (11.0) and earlier.

The workaround is rather simple: You can prevent After Effects from reading the XMP metadata from the file from Illustrator by turning off the preference Create Layer Markers from Footage XMP Metadata in the Media & Disk Cache preferences category. This will only prevent temporal metadata in footage items from being converted to markers in After Effects, which is not a feature that you would be using with files from Illustrator, anyway.

By the way, thank you to all folks who submit crash reports. Those crash reports are how we found this problem only days after the new version of Illustrator that creates these files was released.

 

Region of Interest: Get technical information about After Effects

Join The Discussion