rd_Slated to work with precomps/nested comps

What type of scripts do you need?

Moderator: byronnash

Post Reply
Avinash Ramanath
Posts: 12
Joined: April 19th, 2017, 4:53 am

Code: Select all

// rd_Slated.jsx
// Copyright (c) 2008-2013 Jeffrey R. Almasol. All rights reserved.
// portfolio: http://www.redefinery.com
// 
// Name: rd_Slated
// Version: 1.2
// 
// Description:
// This script renders slates, single-frame images of a specific template composition 
// whose data is fed by the information in a text file exported from a spreadsheet.
// 
// Prerequisites:
//  -- This script requires After Effects CS4 or later.
// 
// Usage:
//  1. Run this script.
//  2. Select the project containing the template composition named "comp"
//     to use for the slates.
//  3. Select the tab-delimited data file whose columnar data values match 
//      the layer names in the "comp" template.
//  4. Select the output folder into which the slates will be rendered.
// 
// The slates will be rendered in Photoshop format.
// 
// Notes:
//  -- The machine on which you run the script should have an output module 
//  template named "Photoshop", which should be available in the default set 
// of templates.
// 
// Legal Notices:
// This script is provided "as is," without warranty of any kind, expressed or implied.
// In no event shall the script's author be held liable for any damages arising in any
// way from the use of this script.
// 
// This script is excerpted from Adobe After Effects CC Visual Effects and Compositing Studio Techniques by Mark Christiansen.
// (c) 2013. Published by Adobe Press. All rights reserved. A complete chapter on scripting
// by Jeff Almasol is included with the book. Additional scripts are available at
// http://aescripts.com/rd-studio-techniques/



[color=#000000][size=120][font=monospace]
(function rd_Slated()[/font][/size][/color][color=#000000][size=120][font=monospace]
{[/font][/size][/color][color=#000000][size=120][font=monospace]
	// Globals[/font][/size][/color]
	[color=#000000][size=120][font=monospace]
	// Store all constants in a global object, for consolidated organization in ExtendScript Toolkit's Data Browser[/font][/size][/color][color=#000000][size=120][font=monospace]
	var rd_SlatedData = new Object();[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.scriptName = "rd: Slated";[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.scriptTitle = rd_SlatedData.scriptName + " v1.2";[/font][/size][/color]
	[color=#000000][size=120][font=monospace]
	// Various text strings are defined as associative arrays (dictionaries) to support localizability via rd_localize() function[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strTplCompName = {en: "template"};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strSelTplProj = {en: "Select the template project"};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strSelDataFile = {en: "Select the text file containing slate data"};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strSelOutFolder = {en: "Select the output folder for rendered slates"};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strSlatesFolderSuffix = {en: " Slates"};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strErrOpenProj = {en: "Could not open the template project."};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strErrNoTplComp = {en: "Could not find a comp named 'template'."};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strErrCreateOutFolder = {en: "Could not create the output folder."};[/font][/size][/color][color=#000000][size=120][font=monospace]
	rd_SlatedData.strMinAE90 = {en: "This script requires Adobe After Effects CS4 or later."};[/font][/size][/color]
	
	
	
	[color=#000000][size=120][font=monospace]
	// rd_localize()[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Description:[/font][/size][/color][color=#000000][size=120][font=monospace]
	// This function localizes the given string variable based on the current locale.[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Parameters:[/font][/size][/color][color=#000000][size=120][font=monospace]
	//   strVar - The string variable's name.[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Returns:[/font][/size][/color][color=#000000][size=120][font=monospace]
	// String.[/font][/size][/color][color=#000000][size=120][font=monospace]
	//[/font][/size][/color][color=#000000][size=120][font=monospace]
	function rd_localize(strVar)[/font][/size][/color][color=#000000][size=120][font=monospace]
	{[/font][/size][/color][color=#000000][size=120][font=monospace]
		return strVar["en"];[/font][/size][/color][color=#000000][size=120][font=monospace]
	}[/font][/size][/color]
	
	
	
	[color=#000000][size=120][font=monospace]
	// rd_Slated_main()[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Description:[/font][/size][/color][color=#000000][size=120][font=monospace]
	// This function performs the main operation of the script.[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Parameters:[/font][/size][/color][color=#000000][size=120][font=monospace]
	// None.[/font][/size][/color][color=#000000][size=120][font=monospace]
	// [/font][/size][/color][color=#000000][size=120][font=monospace]
	// Returns:[/font][/size][/color][color=#000000][size=120][font=monospace]
	// Nothing.[/font][/size][/color][color=#000000][size=120][font=monospace]
	//[/font][/size][/color][color=#000000][size=120][font=monospace]
	function rd_Slated_main()[/font][/size][/color][color=#000000][size=120][font=monospace]
	{[/font][/size][/color][color=#000000][size=120][font=monospace]
		// Select/open the template project[/font][/size][/color][color=#000000][size=120][font=monospace]
		var projFile = File.openDialog(rd_localize(rd_SlatedData.strSelTplProj));[/font][/size][/color][color=#000000][size=120][font=monospace]
		if ((projFile === null) || !projFile.exists)[/font][/size][/color][color=#000000][size=120][font=monospace]
			return;[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		var proj = app.open(projFile);[/font][/size][/color][color=#000000][size=120][font=monospace]
		if (proj === null)[/font][/size][/color][color=#000000][size=120][font=monospace]
			return;[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Check that the template comp exists[/font][/size][/color][color=#000000][size=120][font=monospace]
		var comp = null;[/font][/size][/color][color=#000000][size=120][font=monospace]
		for (var i=1; i<=proj.numItems; i++)[/font][/size][/color][color=#000000][size=120][font=monospace]
		{[/font][/size][/color][color=#000000][size=120][font=monospace]
			if ((proj.item(i) instanceof CompItem) && (proj.item(i).name === rd_localize(rd_SlatedData.strTplCompName)))[/font][/size][/color][color=#000000][size=120][font=monospace]
			{[/font][/size][/color][color=#000000][size=120][font=monospace]
				comp = proj.item(i);[/font][/size][/color][color=#000000][size=120][font=monospace]
				break;[/font][/size][/color][color=#000000][size=120][font=monospace]
			}[/font][/size][/color][color=#000000][size=120][font=monospace]
		}[/font][/size][/color][color=#000000][size=120][font=monospace]
		// If comp is still null, the comp doesn't exist in the project[/font][/size][/color][color=#000000][size=120][font=monospace]
		if (comp === null)[/font][/size][/color][color=#000000][size=120][font=monospace]
		{[/font][/size][/color][color=#000000][size=120][font=monospace]
			alert(rd_localize(rd_SlatedData.strErrNoTplComp), rd_SlatedData.scriptName);[/font][/size][/color][color=#000000][size=120][font=monospace]
			return;[/font][/size][/color][color=#000000][size=120][font=monospace]
		}[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Select the data file[/font][/size][/color][color=#000000][size=120][font=monospace]
		var dataFile = File.openDialog(rd_localize(rd_SlatedData.strSelDataFile));[/font][/size][/color][color=#000000][size=120][font=monospace]
		if ((dataFile === null) || !dataFile.exists)[/font][/size][/color][color=#000000][size=120][font=monospace]
			return;[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Select the folder where the slates will be rendered[/font][/size][/color][color=#000000][size=120][font=monospace]
		var outFolder = Folder.selectDialog(rd_localize(rd_SlatedData.strSelOutFolder));[/font][/size][/color][color=#000000][size=120][font=monospace]
		if (outFolder === null)[/font][/size][/color][color=#000000][size=120][font=monospace]
			return;[/font][/size][/color][color=#000000][size=120][font=monospace]
		// If the folder doesn't exist, create it[/font][/size][/color][color=#000000][size=120][font=monospace]
		if (!outFolder.exists)[/font][/size][/color][color=#000000][size=120][font=monospace]
		{[/font][/size][/color][color=#000000][size=120][font=monospace]
			if (!outFolder.create())[/font][/size][/color][color=#000000][size=120][font=monospace]
			{[/font][/size][/color][color=#000000][size=120][font=monospace]
				alert(rd_localize(rd_SlatedData.strErrCreateOutFolder), rd_SlatedData.scriptName);[/font][/size][/color][color=#000000][size=120][font=monospace]
				return;[/font][/size][/color][color=#000000][size=120][font=monospace]
			}[/font][/size][/color][color=#000000][size=120][font=monospace]
		}[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Build a catalog of layer names for text and footage layers, the types of layers that can be replaced[/font][/size][/color][color=#000000][size=120][font=monospace]
		var layerCat = new Array();[/font][/size][/color][color=#000000][size=120][font=monospace]
		for (var i=1; i<=comp.numLayers; i++)[/font][/size][/color][color=#000000][size=120][font=monospace]
		{[/font][/size][/color][color=#000000][size=120][font=monospace]
			// Look for text (TextLayer) and footage (AVLayer) layers only[/font][/size][/color][color=#000000][size=120][font=monospace]
			var layer = comp.layer(i);[/font][/size][/color][color=#000000][size=120][font=monospace]
			if ((layer instanceof TextLayer) || (layer instanceof AVLayer))[/font][/size][/color][color=#000000][size=120][font=monospace]
			{[/font][/size][/color][color=#000000][size=120][font=monospace]
				var layerName = layer.name;[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Check if the layer's name was previously stored; this allows multiple layers[/font][/size][/color][color=#000000][size=120][font=monospace]
				// to be updated[/font][/size][/color][color=#000000][size=120][font=monospace]
				if (layerCat[layerName] === undefined)[/font][/size][/color][color=#000000][size=120][font=monospace]
				{[/font][/size][/color][color=#000000][size=120][font=monospace]
					// Layer name wasn't previously encountered, so create a new array to store layer indices[/font][/size][/color][color=#000000][size=120][font=monospace]
					layerCat[layerName] = new Array();[/font][/size][/color][color=#000000][size=120][font=monospace]
				}[/font][/size][/color][color=#000000][size=120][font=monospace]
				// Append the current layer's index to the newly created or existing (if same layer name was previously encountered)[/font][/size][/color][color=#000000][size=120][font=monospace]
				layerCat[layerName].push(i);[/font][/size][/color][color=#000000][size=120][font=monospace]
			}[/font][/size][/color][color=#000000][size=120][font=monospace]
		}[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Create a subfolder to place the slate comps and any footage needed for each[/font][/size][/color][color=#000000][size=120][font=monospace]
		// Subfolder name will be based on the data file name[/font][/size][/color][color=#000000][size=120][font=monospace]
		var slatesFolder = app.project.items.addFolder(dataFile.name + rd_localize(rd_SlatedData.strSlatesFolderSuffix));[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Process the lines of text from the data file[/font][/size][/color][color=#000000][size=120][font=monospace]
		// First line should be the field names, tab-separated, with subsequent lines the data[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Open the data file for reading[/font][/size][/color][color=#000000][size=120][font=monospace]
		dataFile.open("r");[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Read the first line, which are the field names[/font][/size][/color][color=#000000][size=120][font=monospace]
		var fields = dataFile.readln();[/font][/size][/color][color=#000000][size=120][font=monospace]
		if (!dataFile.eof)[/font][/size][/color][color=#000000][size=120][font=monospace]
		{[/font][/size][/color][color=#000000][size=120][font=monospace]
			// Split the field string at tab characters[/font][/size][/color][color=#000000][size=120][font=monospace]
			var fieldNames = fields.split("\t");[/font][/size][/color]
			[color=#000000][size=120][font=monospace]
			// Read the rest of the lines, and create slate comps for each[/font][/size][/color]
			[color=#000000][size=120][font=monospace]
			var dataLine, dataValues, layersToUpdate, layerData, currLayer;[/font][/size][/color][color=#000000][size=120][font=monospace]
			while (!dataFile.eof)[/font][/size][/color][color=#000000][size=120][font=monospace]
			{[/font][/size][/color][color=#000000][size=120][font=monospace]
				dataLine = dataFile.readln();[/font][/size][/color][color=#000000][size=120][font=monospace]
				dataValues = dataLine.split("\t");[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Make sure the data line contains the same number of values as there are fields[/font][/size][/color][color=#000000][size=120][font=monospace]
				if (dataValues.length !== fieldNames.length)[/font][/size][/color][color=#000000][size=120][font=monospace]
					continue;[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Duplicate the comp for the current line of data, and move it into the slates folder[/font][/size][/color][color=#000000][size=120][font=monospace]
				var slateComp = comp.duplicate();[/font][/size][/color][color=#000000][size=120][font=monospace]
				slateComp.parentFolder = slatesFolder;[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Name the comp based on the first field's value (hopefully, it's unique)[/font][/size][/color][color=#000000][size=120][font=monospace]
				if (fieldNames.length > 0)[/font][/size][/color][color=#000000][size=120][font=monospace]
					slateComp.name = dataValues[0];[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Loop through the fields and match up the data to the layers[/font][/size][/color][color=#000000][size=120][font=monospace]
				for (var f=0; f<fieldNames.length; f++)[/font][/size][/color][color=#000000][size=120][font=monospace]
				{[/font][/size][/color][color=#000000][size=120][font=monospace]
					// Get the set of layers matching the current field's name[/font][/size][/color][color=#000000][size=120][font=monospace]
					layersToUpdate = layerCat[fieldNames[f]];[/font][/size][/color][color=#000000][size=120][font=monospace]
					// Get the data to use for the field[/font][/size][/color][color=#000000][size=120][font=monospace]
					layerData = dataValues[f];[/font][/size][/color]
					[color=#000000][size=120][font=monospace]
					// Loop through all matching layers, and update their content using the data to use[/font][/size][/color][color=#000000][size=120][font=monospace]
					for (var l=1; l<layersToUpdate.length; l++)[/font][/size][/color][color=#000000][size=120][font=monospace]
					{[/font][/size][/color][color=#000000][size=120][font=monospace]
						currLayer = slateComp.layer(layersToUpdate[l]);[/font][/size][/color]
						[color=#000000][size=120][font=monospace]
						// Depending on the layer type, update as appropriate[/font][/size][/color][color=#000000][size=120][font=monospace]
						if (currLayer instanceof TextLayer)[/font][/size][/color][color=#000000][size=120][font=monospace]
						{[/font][/size][/color][color=#000000][size=120][font=monospace]
							// For a text layer, use the data value as the source text[/font][/size][/color][color=#000000][size=120][font=monospace]
							currLayer.sourceText.setValue(new TextDocument(layerData));[/font][/size][/color][color=#000000][size=120][font=monospace]
						}[/font][/size][/color][color=#000000][size=120][font=monospace]
						else if (currLayer instanceof AVLayer)[/font][/size][/color][color=#000000][size=120][font=monospace]
						{[/font][/size][/color][color=#000000][size=120][font=monospace]
							// For a footage layer, import the data value (hopefully is the footage's file name) and replace the source for the layer[/font][/size][/color][color=#000000][size=120][font=monospace]
							if (File(layerData).exists)[/font][/size][/color][color=#000000][size=120][font=monospace]
							{[/font][/size][/color][color=#000000][size=120][font=monospace]
								var fItem = proj.importFile(new ImportOptions(File(layerData)));[/font][/size][/color][color=#000000][size=120][font=monospace]
								if (fItem !== null)[/font][/size][/color][color=#000000][size=120][font=monospace]
								{[/font][/size][/color][color=#000000][size=120][font=monospace]
									// Move footage to the slates folder, then replace the footage layer[/font][/size][/color][color=#000000][size=120][font=monospace]
									fItem.parentFolder = slatesFolder;[/font][/size][/color][color=#000000][size=120][font=monospace]
									currLayer.replaceSource(fItem, false);[/font][/size][/color][color=#000000][size=120][font=monospace]
								}[/font][/size][/color][color=#000000][size=120][font=monospace]
							}[/font][/size][/color][color=#000000][size=120][font=monospace]
						}[/font][/size][/color][color=#000000][size=120][font=monospace]
					}[/font][/size][/color][color=#000000][size=120][font=monospace]
				}[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Trim the comp to the first frame of the work area[/font][/size][/color][color=#000000][size=120][font=monospace]
				slateComp.workAreaDuration = slateComp.frameDuration;[/font][/size][/color]
				[color=#000000][size=120][font=monospace]
				// Add the comp to the render queue; use Photoshop output module template[/font][/size][/color][color=#000000][size=120][font=monospace]
				var rqItem = proj.renderQueue.items.add(slateComp);[/font][/size][/color][color=#000000][size=120][font=monospace]
				rqItem.outputModule(1).applyTemplate("Photoshop");[/font][/size][/color][color=#000000][size=120][font=monospace]
				rqItem.outputModule(1).file = new File(outFolder.fsName + "/" + slateComp.name + "_[#####].psd");[/font][/size][/color][color=#000000][size=120][font=monospace]
			}[/font][/size][/color][color=#000000][size=120][font=monospace]
		}[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Close the data file when done[/font][/size][/color][color=#000000][size=120][font=monospace]
		dataFile.close();[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Start the render[/font][/size][/color][color=#000000][size=120][font=monospace]
		proj.renderQueue.render();[/font][/size][/color]
		[color=#000000][size=120][font=monospace]
		// Select only the slates folder[/font][/size][/color][color=#000000][size=120][font=monospace]
		for (var i=1; i<=proj.numItems; i++)[/font][/size][/color][color=#000000][size=120][font=monospace]
			proj.item(i).selected = false;[/font][/size][/color][color=#000000][size=120][font=monospace]
		slatesFolder.selected = true;[/font][/size][/color][color=#000000][size=120][font=monospace]
	}[/font][/size][/color]
	
	
	
	[color=#000000][size=120][font=monospace]
	// main code:[/font][/size][/color][color=#000000][size=120][font=monospace]
	//[/font][/size][/color]
	[color=#000000][size=120][font=monospace]
	// Prerequisite check for After Effects CS4 or later[/font][/size][/color][color=#000000][size=120][font=monospace]
	if (parseFloat(app.version) < 9.0)[/font][/size][/color][color=#000000][size=120][font=monospace]
		alert(rd_localize(rd_SlatedData.strMinAE90), rd_SlatedData.scriptName);[/font][/size][/color][color=#000000][size=120][font=monospace]
	else[/font][/size][/color][color=#000000][size=120][font=monospace]
		rd_Slated_main();[/font][/size][/color][color=#000000][size=120][font=monospace]
})();[/font][/size][/color]


Avinash Ramanath
Posts: 12
Joined: April 19th, 2017, 4:53 am

Could any one of you please make this script work with text and footage when its precomped
Post Reply