feat(connector): resolve footage per project type, anchor parsing on showId
Build Shot only ever worked on UNG. Two assumptions were baked in: that a shot's
plates sit flat in a folder named after the episode, and that a shot code is
three letters followed by three 3-digit tokens. DH2_VFX breaks both -- it groups
a shot's plates under a {shotCode}/ folder, has no episode level, and its showId
contains a digit and an underscore.
- findSequenceFolders prefers {group}/{shotCode}/ and falls back to UNG's flat
{group}/{shotCode}_* scan, so both layouts work with no migration -- moving
delivered footage would break the links in every AE project pointing at it. An
existing-but-empty shot folder returns nothing rather than falling through, so
stray plate folders sitting beside a shot cannot be read as its footage.
Underscore-prefixed folders are never shots or plates.
- getFootageGroupFolder replaces getEpisodeRootFolder: the {showId}_{episode}
folder for episodic shows, the show root otherwise. A scene filters the shot
list, it is not a directory -- which is why Build Shot on DH2 was looking in
V:/_FOOTAGE/DH2/027.
- Shot codes are now parsed by stripping the known showId prefix
({showId}_{episode}_{scene}_{shot} for episodic, {showId}_{scene}_{shot} for
standard) rather than matching /[A-Z]{3}_.../ or counting underscores.
extractShotCode keeps the old pattern as a fallback so a comp from a different
show than the selected one still reads. Same anchoring in deriveEpisodeCode
(no more hardcoded "UNG_"), deriveEpisodeAPIValue, isEpisodeCode and the
getShotExportDir episode fallback.
- Two positional cuts of the same class, found on the way: the DELIVERY path and
Pull Picture Lock's episode-prefix match both used shotCode.substring(0, 7).
Both now go through getEpisodePrefix(). Output is identical for UNG and DH2
(DH2_VFX happens to be 7 characters); the one behaviour change is that
standard shows no longer get a constant group level under DELIVERY/, and DH2
has no delivery history to move.
Verified against the live V:/_FOOTAGE tree by running the real functions under a
Folder stub: UNG_102_019_010 resolves its BG01/FG01 plates via the flat scan, and
DH2_VFX_027_010 and DH2_VFX_066_380 resolve theirs via the grouped layout. Not
yet exercised in After Effects.
Initialise Workspace is untouched and still hardcoded to UNG -- next.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
+178
-33
@@ -33,6 +33,12 @@ var SETTINGS_KEY = "cfg";
|
|||||||
|
|
||||||
var CURRENT_PROJECT = null; // { code, name, showId, projectType }
|
var CURRENT_PROJECT = null; // { code, name, showId, projectType }
|
||||||
|
|
||||||
|
// Only used when no project is selected, or for a comp belonging to another
|
||||||
|
// show than the selected one. Assumes a three-letter show code, which is why
|
||||||
|
// it cannot be the primary pattern any more -- see getShotCodeRegex.
|
||||||
|
var LEGACY_SHOT_CODE_REGEX = /([A-Z]{3}_\d{3}_\d{3}_\d{3})/;
|
||||||
|
var LEGACY_EPISODE_CODE_REGEX = /^[A-Z]{3}_\d{3}$/;
|
||||||
|
|
||||||
var pipelineState = {
|
var pipelineState = {
|
||||||
pollShotCode: null,
|
pollShotCode: null,
|
||||||
pollTaskId: 0,
|
pollTaskId: 0,
|
||||||
@@ -182,24 +188,38 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return text;
|
return text;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Episode folders on disk are named {showId}_{episode} (UNG/UNG_102/...), so
|
||||||
|
// the prefix comes from the selected project rather than a hardcoded "UNG_".
|
||||||
function deriveEpisodeCode(value) {
|
function deriveEpisodeCode(value) {
|
||||||
var text = String(value);
|
var text = trimText(value);
|
||||||
|
var showId = getShowId();
|
||||||
|
|
||||||
if (/^[A-Z]{3}_\d{3}$/.test(text)) {
|
if (showId && text.indexOf(showId + "_") === 0) {
|
||||||
return text;
|
return text;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (/^\d+$/.test(text)) {
|
if (/^\d+$/.test(text)) {
|
||||||
return "UNG_" + padEpisodeNumber(text);
|
return (showId ? showId + "_" : "") + padEpisodeNumber(text);
|
||||||
}
|
}
|
||||||
|
|
||||||
return text;
|
return text;
|
||||||
}
|
}
|
||||||
|
|
||||||
function deriveEpisodeAPIValue(value) {
|
function deriveEpisodeAPIValue(value) {
|
||||||
var text = String(value);
|
var text = trimText(value);
|
||||||
var match = text.match(/[A-Z]{3}_(\d{3})/);
|
var showId = getShowId();
|
||||||
|
var match;
|
||||||
|
|
||||||
|
if (showId && text.indexOf(showId + "_") === 0) {
|
||||||
|
text = text.substring(showId.length + 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
match = text.match(/^\d+/);
|
||||||
|
if (match) {
|
||||||
|
return String(parseInt(match[0], 10));
|
||||||
|
}
|
||||||
|
|
||||||
|
match = text.match(/[A-Z]{3}_(\d{3})/);
|
||||||
if (match && match.length > 1) {
|
if (match && match.length > 1) {
|
||||||
return String(parseInt(match[1], 10));
|
return String(parseInt(match[1], 10));
|
||||||
}
|
}
|
||||||
@@ -250,8 +270,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
|
|
||||||
function getShotsFromAPI(value) {
|
function getShotsFromAPI(value) {
|
||||||
var isEpisodic = CURRENT_PROJECT && CURRENT_PROJECT.projectType === "EPISODIC";
|
var param = isEpisodicProject() ? "episode" : "scene";
|
||||||
var param = isEpisodic ? "episode" : "scene";
|
|
||||||
var url = CONFIG.baseUrl + "/api/ext/projects/" + (CURRENT_PROJECT ? CURRENT_PROJECT.code : "") + "/shots?" + param + "=" + encodeURIComponent(value);
|
var url = CONFIG.baseUrl + "/api/ext/projects/" + (CURRENT_PROJECT ? CURRENT_PROJECT.code : "") + "/shots?" + param + "=" + encodeURIComponent(value);
|
||||||
var data = getAPIData(url);
|
var data = getAPIData(url);
|
||||||
return getListFromResponse(data, "shots");
|
return getListFromResponse(data, "shots");
|
||||||
@@ -305,28 +324,103 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The showId is the single source of truth for both the on-disk show folder
|
||||||
|
// and the shot-code prefix: UNG (episodic) and DH2_VFX (standard) both follow
|
||||||
|
// {showId}_{...}, so anything parsing a code anchors on this rather than
|
||||||
|
// counting underscores or assuming a three-letter code.
|
||||||
|
function getShowId() {
|
||||||
|
return CURRENT_PROJECT ? trimText(CURRENT_PROJECT.showId || CURRENT_PROJECT.code) : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
function isEpisodicProject() {
|
||||||
|
return !!(CURRENT_PROJECT && CURRENT_PROJECT.projectType === "EPISODIC");
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeRegexText(text) {
|
||||||
|
return String(text).replace(/([.*+?^${}()|[\]\\\-])/g, "\\$1");
|
||||||
|
}
|
||||||
|
|
||||||
|
// Shot codes are {showId}_{episode}_{scene}_{shot} on episodic shows and
|
||||||
|
// {showId}_{scene}_{shot} on standard ones -- so the number of 3-digit tokens
|
||||||
|
// after the showId is what distinguishes them.
|
||||||
|
function getShotCodeRegex() {
|
||||||
|
var showId = getShowId();
|
||||||
|
|
||||||
|
if (!showId) {
|
||||||
|
return LEGACY_SHOT_CODE_REGEX;
|
||||||
|
}
|
||||||
|
|
||||||
|
return new RegExp("(" + escapeRegexText(showId) +
|
||||||
|
"(?:_\\d{3}){" + (isEpisodicProject() ? 3 : 2) + "})");
|
||||||
|
}
|
||||||
|
|
||||||
|
function isEpisodeCode(value) {
|
||||||
|
var showId = getShowId();
|
||||||
|
|
||||||
|
if (!showId) {
|
||||||
|
return LEGACY_EPISODE_CODE_REGEX.test(String(value));
|
||||||
|
}
|
||||||
|
|
||||||
|
return new RegExp("^" + escapeRegexText(showId) + "_\\d{3}$").test(String(value));
|
||||||
|
}
|
||||||
|
|
||||||
function getShowExportRoot() {
|
function getShowExportRoot() {
|
||||||
var showId = CURRENT_PROJECT ? (CURRENT_PROJECT.showId || CURRENT_PROJECT.code) : "";
|
var showId = getShowId();
|
||||||
return CONFIG.exportRoot + (showId ? "/" + showId : "");
|
return CONFIG.exportRoot + (showId ? "/" + showId : "");
|
||||||
}
|
}
|
||||||
|
|
||||||
function getShowFootageRoot() {
|
function getShowFootageRoot() {
|
||||||
var showId = CURRENT_PROJECT ? (CURRENT_PROJECT.showId || CURRENT_PROJECT.code) : "";
|
var showId = getShowId();
|
||||||
return CONFIG.footageRoot + (showId ? "/" + showId : "");
|
return CONFIG.footageRoot + (showId ? "/" + showId : "");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// First 3-digit token after the showId, for episodic shots whose API record
|
||||||
|
// is missing `episode`.
|
||||||
|
function deriveEpisodeFromShotCode(shotCode) {
|
||||||
|
var showId = getShowId();
|
||||||
|
var text = String(shotCode);
|
||||||
|
var match;
|
||||||
|
|
||||||
|
if (showId && text.indexOf(showId + "_") === 0) {
|
||||||
|
match = text.substring(showId.length + 1).match(/^(\d{3})_/);
|
||||||
|
return match ? match[1] : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
match = text.match(/^[A-Z]{3}_(\d{3})_/);
|
||||||
|
return match ? match[1] : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
// The prefix episode-wide files share: "UNG_102" for episodic shows, plain
|
||||||
|
// "DH2_VFX" for standard ones, which have no episode level. Replaces
|
||||||
|
// shotCode.substring(0, 7), which only produced this for a 3-letter showId.
|
||||||
|
function getEpisodePrefix(shotCode) {
|
||||||
|
var showId = getShowId();
|
||||||
|
var episode;
|
||||||
|
|
||||||
|
if (!isEpisodicProject()) {
|
||||||
|
return showId;
|
||||||
|
}
|
||||||
|
|
||||||
|
episode = deriveEpisodeFromShotCode(shotCode);
|
||||||
|
return episode ? showId + "_" + episode : showId;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Deliveries are grouped per episode ("DELIVERY/UNG_102/..."). Standard shows
|
||||||
|
// have nothing to group by, so they get no segment at all.
|
||||||
|
function getDeliveryGroupSegment(shotCode) {
|
||||||
|
return isEpisodicProject() ? "/" + getEpisodePrefix(shotCode) : "";
|
||||||
|
}
|
||||||
|
|
||||||
// Mirrors the server's export layout so farm and local renders land together:
|
// Mirrors the server's export layout so farm and local renders land together:
|
||||||
// {exportRoot}/{showId}/[{episode} for episodic]/{shotCode}/{version}
|
// {exportRoot}/{showId}/[{episode} for episodic]/{shotCode}/{version}
|
||||||
function getShotExportDir(shot) {
|
function getShotExportDir(shot) {
|
||||||
var path = getShowExportRoot();
|
var path = getShowExportRoot();
|
||||||
var episode;
|
var episode;
|
||||||
var match;
|
|
||||||
|
|
||||||
if (CURRENT_PROJECT && CURRENT_PROJECT.projectType === "EPISODIC") {
|
if (isEpisodicProject()) {
|
||||||
episode = trimText(shot.episode);
|
episode = trimText(shot.episode);
|
||||||
if (!episode) {
|
if (!episode) {
|
||||||
match = String(shot.shotCode).match(/^[A-Z]{3}_(\d{3})_/);
|
episode = deriveEpisodeFromShotCode(shot.shotCode);
|
||||||
episode = match ? match[1] : "";
|
|
||||||
}
|
}
|
||||||
if (episode) {
|
if (episode) {
|
||||||
path += "/" + episode;
|
path += "/" + episode;
|
||||||
@@ -527,8 +621,23 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return findFolder(episodeCode);
|
return findFolder(episodeCode);
|
||||||
}
|
}
|
||||||
|
|
||||||
function getEpisodeRootFolder(episodeCode) {
|
// The folder a shot's plates are grouped under: the {showId}_{episode} folder
|
||||||
return new Folder(getShowFootageRoot() + "/" + episodeCode);
|
// on episodic shows, the show root on standard ones -- a scene never gets its
|
||||||
|
// own folder on disk, so the scene value from the dropdown is not a path.
|
||||||
|
function getFootageGroupFolder(groupCode) {
|
||||||
|
var root = getShowFootageRoot();
|
||||||
|
|
||||||
|
if (isEpisodicProject() && trimText(groupCode)) {
|
||||||
|
return new Folder(root + "/" + trimText(groupCode));
|
||||||
|
}
|
||||||
|
|
||||||
|
return new Folder(root);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Underscore-prefixed folders are never shots or plates: UNG already uses the
|
||||||
|
// convention for _ARCHIVE, _GFX, _PICLOCKS and _PULLS.
|
||||||
|
function isNonShotFolderName(name) {
|
||||||
|
return String(name).indexOf("_") === 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
function getEpisodeCodesFromDisk() {
|
function getEpisodeCodesFromDisk() {
|
||||||
@@ -565,7 +674,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
|
|
||||||
function getShotCodesForEpisode(episodeCode) {
|
function getShotCodesForEpisode(episodeCode) {
|
||||||
var root = getEpisodeRootFolder(episodeCode);
|
var root = getFootageGroupFolder(episodeCode);
|
||||||
var folders;
|
var folders;
|
||||||
var shotCodes = [];
|
var shotCodes = [];
|
||||||
var i;
|
var i;
|
||||||
@@ -589,8 +698,20 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return shotCodes;
|
return shotCodes;
|
||||||
}
|
}
|
||||||
|
|
||||||
function findSequenceFolders(shotCode, episodeCode) {
|
// Two layouts in the wild and neither is being migrated -- moving delivered
|
||||||
var root = getEpisodeRootFolder(episodeCode);
|
// footage would break the file links in every AE project already pointing at
|
||||||
|
// it. DH2 groups a shot's plates under a {shotCode}/ folder; UNG scatters them
|
||||||
|
// directly in the episode folder:
|
||||||
|
//
|
||||||
|
// {show}/[{show}_{episode}/]{shotCode}/{shotCode}_{ELEM}_{VER}/ (standard)
|
||||||
|
// {show}/{show}_{episode}/{shotCode}_{ELEM}_{VER}/ (UNG)
|
||||||
|
//
|
||||||
|
// The grouped form wins outright where it exists -- an empty shot folder means
|
||||||
|
// "no plates yet", not "go look at the show root", where stray plate folders
|
||||||
|
// for the same shot code would otherwise be picked up as its footage.
|
||||||
|
function findSequenceFolders(shotCode, groupCode) {
|
||||||
|
var root = getFootageGroupFolder(groupCode);
|
||||||
|
var shotFolder;
|
||||||
var folders;
|
var folders;
|
||||||
var matches = [];
|
var matches = [];
|
||||||
var i;
|
var i;
|
||||||
@@ -599,6 +720,18 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return matches;
|
return matches;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
shotFolder = new Folder(root.fsName + "/" + shotCode);
|
||||||
|
if (shotFolder.exists) {
|
||||||
|
folders = shotFolder.getFiles();
|
||||||
|
for (i = 0; i < folders.length; i += 1) {
|
||||||
|
if (folders[i] instanceof Folder && !isNonShotFolderName(folders[i].name)) {
|
||||||
|
matches.push(folders[i]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
matches.sort();
|
||||||
|
return matches;
|
||||||
|
}
|
||||||
|
|
||||||
folders = root.getFiles();
|
folders = root.getFiles();
|
||||||
for (i = 0; i < folders.length; i += 1) {
|
for (i = 0; i < folders.length; i += 1) {
|
||||||
if (folders[i] instanceof Folder && folders[i].name.indexOf(shotCode + "_") === 0) {
|
if (folders[i] instanceof Folder && folders[i].name.indexOf(shotCode + "_") === 0) {
|
||||||
@@ -783,10 +916,20 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
|
|
||||||
function extractShotCode(name) {
|
function extractShotCode(name) {
|
||||||
var match = String(name).match(/([A-Z]{3}_\d{3}_\d{3}_\d{3})/);
|
var text = String(name);
|
||||||
|
var match = text.match(getShotCodeRegex());
|
||||||
|
|
||||||
if (match && match.length > 1) {
|
if (match && match.length > 1) {
|
||||||
return match[1];
|
return match[1];
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// A comp from a different show than the one selected in the panel: read it
|
||||||
|
// with the old pattern rather than reporting no shot code at all.
|
||||||
|
match = text.match(LEGACY_SHOT_CODE_REGEX);
|
||||||
|
if (match && match.length > 1) {
|
||||||
|
return match[1];
|
||||||
|
}
|
||||||
|
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1074,13 +1217,15 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
function buildShotFromCode(episodeCode, shotCode) {
|
// groupCode is the episode code for episodic shows and the scene for standard
|
||||||
|
// ones -- see getFootageGroupFolder for how each resolves on disk.
|
||||||
|
function buildShotFromCode(groupCode, shotCode) {
|
||||||
var existingShotComp = findComp(shotCode);
|
var existingShotComp = findComp(shotCode);
|
||||||
var sequenceFolders;
|
var sequenceFolders;
|
||||||
var footageItems = [];
|
var footageItems = [];
|
||||||
var footageFolder = findFolder("_FOOTAGE_4K");
|
var footageFolder = findFolder("_FOOTAGE_4K");
|
||||||
var precompFolder = findFolder("_PRECOMPS");
|
var precompFolder = findFolder("_PRECOMPS");
|
||||||
var episodeProjectFolder = findEpisodeProjectFolder(episodeCode);
|
var episodeProjectFolder = findEpisodeProjectFolder(groupCode);
|
||||||
var apiData;
|
var apiData;
|
||||||
var footage;
|
var footage;
|
||||||
var footageComp;
|
var footageComp;
|
||||||
@@ -1105,7 +1250,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
return existingShotComp;
|
return existingShotComp;
|
||||||
}
|
}
|
||||||
|
|
||||||
sequenceFolders = findSequenceFolders(shotCode, episodeCode);
|
sequenceFolders = findSequenceFolders(shotCode, groupCode);
|
||||||
if (sequenceFolders.length < 1) {
|
if (sequenceFolders.length < 1) {
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
@@ -1171,10 +1316,10 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
|
|
||||||
function buildShotFromDropdown() {
|
function buildShotFromDropdown() {
|
||||||
var episodeCode;
|
var groupCode;
|
||||||
var shotCode;
|
var shotCode;
|
||||||
var shotComp;
|
var shotComp;
|
||||||
var isEpisodic = CURRENT_PROJECT && CURRENT_PROJECT.projectType === "EPISODIC";
|
var isEpisodic = isEpisodicProject();
|
||||||
|
|
||||||
if (!uiState.episodeDropdown || !uiState.episodeDropdown.selection || !uiState.shotDropdown || !uiState.shotDropdown.selection) {
|
if (!uiState.episodeDropdown || !uiState.episodeDropdown.selection || !uiState.shotDropdown || !uiState.shotDropdown.selection) {
|
||||||
updateStatus(getSelectedComps().length, "Choose a " + (isEpisodic ? "episode" : "scene") + " and shot first.");
|
updateStatus(getSelectedComps().length, "Choose a " + (isEpisodic ? "episode" : "scene") + " and shot first.");
|
||||||
@@ -1183,15 +1328,15 @@ var SETTINGS_KEY = "cfg";
|
|||||||
|
|
||||||
// For episodic, derive full episode code; for standard pass the selected scene value
|
// For episodic, derive full episode code; for standard pass the selected scene value
|
||||||
if (isEpisodic) {
|
if (isEpisodic) {
|
||||||
episodeCode = uiState.episodeDropdown.selection.episodeCode || deriveEpisodeCode(uiState.episodeDropdown.selection.text);
|
groupCode = uiState.episodeDropdown.selection.episodeCode || deriveEpisodeCode(uiState.episodeDropdown.selection.text);
|
||||||
} else {
|
} else {
|
||||||
episodeCode = uiState.episodeDropdown.selection.filterValue || uiState.episodeDropdown.selection.text;
|
groupCode = uiState.episodeDropdown.selection.filterValue || uiState.episodeDropdown.selection.text;
|
||||||
}
|
}
|
||||||
shotCode = uiState.shotDropdown.selection.shotCode || uiState.shotDropdown.selection.text;
|
shotCode = uiState.shotDropdown.selection.shotCode || uiState.shotDropdown.selection.text;
|
||||||
|
|
||||||
app.beginUndoGroup("VFXReview Connector - Build Shot");
|
app.beginUndoGroup("VFXReview Connector - Build Shot");
|
||||||
updateStatus(getSelectedComps().length, "Building shot " + shotCode);
|
updateStatus(getSelectedComps().length, "Building shot " + shotCode);
|
||||||
shotComp = buildShotFromCode(episodeCode, shotCode);
|
shotComp = buildShotFromCode(groupCode, shotCode);
|
||||||
app.endUndoGroup();
|
app.endUndoGroup();
|
||||||
|
|
||||||
if (shotComp) {
|
if (shotComp) {
|
||||||
@@ -1657,9 +1802,9 @@ var SETTINGS_KEY = "cfg";
|
|||||||
|
|
||||||
exrFiles.sort();
|
exrFiles.sort();
|
||||||
|
|
||||||
var episodeCode = shotCode.substring(0, 7);
|
|
||||||
var deliveryDate = getDateString().replace(/\//g, "");
|
var deliveryDate = getDateString().replace(/\//g, "");
|
||||||
deliveryFolderPath = getShowExportRoot() + "/DELIVERY/" + episodeCode + "/" + deliveryDate + "_Delivery/" + shotCode;
|
deliveryFolderPath = getShowExportRoot() + "/DELIVERY" + getDeliveryGroupSegment(shotCode) +
|
||||||
|
"/" + deliveryDate + "_Delivery/" + shotCode;
|
||||||
if (!ensureFolder(deliveryFolderPath)) {
|
if (!ensureFolder(deliveryFolderPath)) {
|
||||||
addFailure(result, comp.name, "Could not create delivery folder");
|
addFailure(result, comp.name, "Could not create delivery folder");
|
||||||
continue;
|
continue;
|
||||||
@@ -1769,7 +1914,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
|
|
||||||
comp = comps[0];
|
comp = comps[0];
|
||||||
shotCode = getShotCodeFromComp(comp);
|
shotCode = getShotCodeFromComp(comp);
|
||||||
episodePrefix = shotCode.substring(0, 7); // e.g. "UNG_106"
|
episodePrefix = getEpisodePrefix(shotCode); // e.g. "UNG_106"
|
||||||
|
|
||||||
// Fetch API data for seq timecodes
|
// Fetch API data for seq timecodes
|
||||||
updateStatus(getSelectedComps().length, "Looking up " + shotCode + "...");
|
updateStatus(getSelectedComps().length, "Looking up " + shotCode + "...");
|
||||||
@@ -1795,7 +1940,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
item = app.project.item(i);
|
item = app.project.item(i);
|
||||||
if (item instanceof FootageItem &&
|
if (item instanceof FootageItem &&
|
||||||
item.parentFolder === piclocksProjectFolder &&
|
item.parentFolder === piclocksProjectFolder &&
|
||||||
item.name.substring(0, 7) === episodePrefix) {
|
item.name.indexOf(episodePrefix + "_") === 0) {
|
||||||
piclockFootage = item;
|
piclockFootage = item;
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
@@ -2082,7 +2227,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
}
|
}
|
||||||
|
|
||||||
function populateEpisodeOrSceneDropdown() {
|
function populateEpisodeOrSceneDropdown() {
|
||||||
var isEpisodic = CURRENT_PROJECT && CURRENT_PROJECT.projectType === "EPISODIC";
|
var isEpisodic = isEpisodicProject();
|
||||||
var i;
|
var i;
|
||||||
var item;
|
var item;
|
||||||
|
|
||||||
@@ -2104,7 +2249,7 @@ var SETTINGS_KEY = "cfg";
|
|||||||
item = uiState.episodeDropdown.add("item", label);
|
item = uiState.episodeDropdown.add("item", label);
|
||||||
item.filterValue = episodeValue;
|
item.filterValue = episodeValue;
|
||||||
item.episodeCode = deriveEpisodeCode(label);
|
item.episodeCode = deriveEpisodeCode(label);
|
||||||
if (!/^[A-Z]{3}_\d{3}$/.test(item.episodeCode)) {
|
if (!isEpisodeCode(item.episodeCode)) {
|
||||||
item.episodeCode = deriveEpisodeCode(episodeValue);
|
item.episodeCode = deriveEpisodeCode(episodeValue);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+30
-18
@@ -56,20 +56,28 @@ Source EXR plates are read from **`<Footage Root>/{SHOW_ID}/`**. Configure `foot
|
|||||||
|
|
||||||
```
|
```
|
||||||
<Footage Root>/
|
<Footage Root>/
|
||||||
└── {SHOW_ID}/ # e.g. UNG/
|
└── {SHOW_ID}/ # e.g. UNG/ or DH2_VFX/
|
||||||
├── {EPISODE_CODE}/ # episodic: e.g. UNG_108/
|
├── {EPISODE_CODE}/ # episodic only: e.g. UNG_108/
|
||||||
│ └── {SHOT_CODE}_{CLIP}/ # e.g. UNG_108_001_010_A315C001/
|
│ └── {SHOT_CODE}/ # standard layout: plates grouped per shot
|
||||||
│ └── *.exr # EXR sequence
|
│ └── {SHOT_CODE}_{ELEM}_{VER}/
|
||||||
│
|
|
||||||
├── {SCENE}/ # standard: e.g. 001/
|
|
||||||
│ └── {SHOT_CODE}_{CLIP}/
|
|
||||||
│ └── *.exr
|
│ └── *.exr
|
||||||
│
|
│
|
||||||
└── _PICLOCKS/
|
└── _PICLOCKS/
|
||||||
└── {EPISODE_CODE}_*.mov # matched by episode prefix
|
└── {EPISODE_CODE}_*.mov # matched by episode prefix
|
||||||
```
|
```
|
||||||
|
|
||||||
Sequence folders must start with the shot code followed by an underscore (`{SHOT_CODE}_*`). The connector imports all matching folders as separate footage layers.
|
**Scenes are not folders.** Standard projects have no level between the show
|
||||||
|
folder and the shot folder — the scene picker filters the shot list only.
|
||||||
|
|
||||||
|
**Two layouts are supported, and neither is migrated.** The connector prefers the
|
||||||
|
grouped layout above; where a `{SHOT_CODE}/` folder does not exist it falls back
|
||||||
|
to scanning the parent for folders named `{SHOT_CODE}_*` (the original UNG
|
||||||
|
layout, where plates sit directly in the episode folder). All matching folders
|
||||||
|
are imported as separate footage layers. If a `{SHOT_CODE}/` folder exists but
|
||||||
|
holds no plate subfolders, that is reported as no footage — the fallback scan is
|
||||||
|
not attempted, so stray plate folders sitting beside the shot cannot be picked up
|
||||||
|
as its footage. Underscore-prefixed folders (`_ARCHIVE`, `_GFX`, `_PULLS`, …) are
|
||||||
|
never treated as shots or plates.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -95,7 +103,7 @@ Same applies to `footageRoot`: change `V:/_FOOTAGE/UNG` → `V:/_FOOTAGE`.
|
|||||||
|
|
||||||
## New production checklist
|
## New production checklist
|
||||||
|
|
||||||
1. Create `<Footage Root>/{SHOW_ID}/{EPISODE or SCENE}/` and place EXR sequences inside, named `{SHOT_CODE}_{clip}`.
|
1. Create `<Footage Root>/{SHOW_ID}/[{EPISODE_CODE}/]{SHOT_CODE}/` — episode level for episodic shows only, never a scene level — and place each plate in its own `{SHOT_CODE}_{ELEM}_{VER}/` folder inside it.
|
||||||
2. `<Export Root>/{SHOW_ID}/` is created automatically on first render.
|
2. `<Export Root>/{SHOW_ID}/` is created automatically on first render.
|
||||||
3. Add the project to the VFXReview server with the correct **Show ID** set.
|
3. Add the project to the VFXReview server with the correct **Show ID** set.
|
||||||
4. Open the panel in After Effects, click **⚙**, enter the Server URL, API Token, bare `exportRoot`, and bare `footageRoot`, then click **Save**.
|
4. Open the panel in After Effects, click **⚙**, enter the Server URL, API Token, bare `exportRoot`, and bare `footageRoot`, then click **Save**.
|
||||||
@@ -158,7 +166,7 @@ Updates the **Status** panel to show the current count of selected `CompItem`s.
|
|||||||
### Fix Comp Names
|
### Fix Comp Names
|
||||||
Renames selected comps so their names match the shot code extracted from their current name.
|
Renames selected comps so their names match the shot code extracted from their current name.
|
||||||
|
|
||||||
- Shot codes follow the pattern `XXX_000_000_000` (e.g. `UNG_106_010_020`).
|
- Shot codes are read by anchoring on the selected project's showId — see [Shot Code Convention](#shot-code-convention).
|
||||||
- If a comp name contains a valid shot code but has extra text, it is trimmed to the code only.
|
- If a comp name contains a valid shot code but has extra text, it is trimmed to the code only.
|
||||||
- Wrapped in an undo group.
|
- Wrapped in an undo group.
|
||||||
|
|
||||||
@@ -254,7 +262,7 @@ Imports a picture-lock (offline cut) video file and trims it to the correct sequ
|
|||||||
|
|
||||||
**Process:**
|
**Process:**
|
||||||
1. Calls the API to retrieve `seqTimecodeStart` and `seqTimecodeEnd` for the shot.
|
1. Calls the API to retrieve `seqTimecodeStart` and `seqTimecodeEnd` for the shot.
|
||||||
2. Searches the `_PICLOCKS` project folder for already-imported footage matching the episode prefix (first 7 characters of the shot code, e.g. `UNG_106`).
|
2. Searches the `_PICLOCKS` project folder for already-imported footage matching the episode prefix — `{showId}_{episode}` on episodic shows (e.g. `UNG_106`), plain `{showId}` on standard ones.
|
||||||
3. If not found, scans `FOOTAGE_ROOT/_PICLOCKS/` for a file matching `{episodePrefix}_*` and imports it.
|
3. If not found, scans `FOOTAGE_ROOT/_PICLOCKS/` for a file matching `{episodePrefix}_*` and imports it.
|
||||||
4. Calculates the in/out offsets from the sequence timecodes relative to the piclock's start (assumed `01:00:00:00` / 3590 s unless embedded timecode is available), with **±8 frame handles**.
|
4. Calculates the in/out offsets from the sequence timecodes relative to the piclock's start (assumed `01:00:00:00` / 3590 s unless embedded timecode is available), with **±8 frame handles**.
|
||||||
5. Adds the piclock footage as a layer at the top of the comp, scales it to fill the frame, and sets `startTime`, `inPoint`, and `outPoint` to isolate the correct range.
|
5. Adds the piclock footage as a layer at the top of the comp, scales it to fill the frame, and sets `startTime`, `inPoint`, and `outPoint` to isolate the correct range.
|
||||||
@@ -340,15 +348,19 @@ Accept: application/json
|
|||||||
|
|
||||||
## Shot Code Convention
|
## Shot Code Convention
|
||||||
|
|
||||||
Shot codes follow the pattern `AAA_NNN_NNN_NNN` where:
|
Shot codes are the project's **showId** followed by three-digit tokens:
|
||||||
- `AAA` = three-letter show prefix (e.g. `UNG`)
|
|
||||||
- First `NNN` = episode number (e.g. `106`)
|
|
||||||
- Second `NNN` = sequence number (e.g. `010`)
|
|
||||||
- Third `NNN` = shot number (e.g. `020`)
|
|
||||||
|
|
||||||
Example: `UNG_106_010_020`
|
| Project type | Pattern | Example |
|
||||||
|
|---|---|---|
|
||||||
|
| Episodic | `{showId}_{episode}_{scene}_{shot}` | `UNG_106_010_020` (showId `UNG`) |
|
||||||
|
| Standard | `{showId}_{scene}_{shot}` | `DH2_VFX_027_010` (showId `DH2_VFX`) |
|
||||||
|
|
||||||
Episode codes follow the pattern `AAA_NNN` (e.g. `UNG_106`).
|
The showId is **not** always three letters and may itself contain underscores, so
|
||||||
|
codes are parsed by stripping the known showId prefix — never by counting
|
||||||
|
underscores or matching a fixed `AAA_` pattern. Everything after the showId is
|
||||||
|
three digits per token.
|
||||||
|
|
||||||
|
Episode codes follow `{showId}_{episode}` (e.g. `UNG_106`).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user