JSX משלכם —
הסקריפט הראשון שלכם.

בניגוד ל-Expression שרץ בתוך תכונה, סקריפט רץ על האפליקציה כולה. הוא יכול ליצור קומפוזיציות, להוסיף שכבות, לשנות properties — בקיצור, לעשות כל דבר שאפשר לעשות באפטר ידנית, אוטומטית.

מה אפשר לעשות עם script

• אוטומציה — חוזרים על אותה פעולה מאות פעמים בלחיצה.
• Batch processing — עיבוד 50 קבצים זהה בבת-אחת.
• UI mods — יצירת panels מותאמים אישית.
• Data import — קריאת CSV/JSON ויצירת graphics אוטומטית.
• Code generation — בניית פרויקטים מתבניות.

סוגי scripts

סוג	איפה רץ	איך מפעילים
Run Once	פותח, רץ, נסגר	File → Scripts → Run Script File
ScriptUI Panel	פאנל קבוע (כמו Effects)	Window → [שם הפאנל]
Startup Script	רץ אוטומטית כל הפעלה	בתיקיית Scripts/Startup

אופציה 1 — ExtendScript Toolkit (ESTK)

• ה-IDE הרשמי של Adobe לסקריפטים.
• חינם — adobe.com/products/estk/.
• תמיכה ב-debugger, breakpoints, autocomplete בסיסי.
• בעיה: Adobe לא מתחזקת אותו עוד מ-2018. עובד אבל מיושן.

אופציה 2 — VS Code עם Extension (מומלץ)

• VS Code חינם — code.visualstudio.com.
• Extension: "ExtendScript Debugger" (Adobe).
• תמיכה ב-syntax highlighting, debug, modern UI.
• זה מה שכל הסקריפטרים המקצועיים משתמשים בו ב-2026.

אופציה 3 — לפתוח עם editor רגיל

לסקריפטים פשוטים — Notepad++, Sublime, או אפילו Notepad. אבל בלי autocomplete של ה-API של אפטר, התהליך איטי וטעון שגיאות.

הקוד המינימלי

alert("שלום מסקריפט!");

איך מריצים

1. שמרו את הקובץ כ-hello.jsx ב-Desktop.
2. באפטר: File → Scripts → Run Script File.
3. בוחרים את hello.jsx ולוחצים Open.
4. קופץ דיאלוג עם הטקסט "שלום מסקריפט!".

כן, אפטר תומכת בעברית ב-alerts. תוכלו לבדוק עם alert("Hello אפטר 123!").

קוד שני — בודק עם איזה Comp עובדים

var comp = app.project.activeItem;

if (comp && comp instanceof CompItem) {
  alert("הקומפוזיציה: " + comp.name +
        "\n רוחב: " + comp.width +
        "\n גובה: " + comp.height +
        "\n משך: " + comp.duration + " שניות");
} else {
  alert("בחרו קומפוזיציה ב-Project Panel קודם!");
}

פתחו פרויקט עם Comp פעיל, הריצו את הסקריפט. תקבלו דיאלוג עם פרטי הקומפוזיציה.

השרשרת הבסיסית

var proj = app.project;            // הפרויקט
var comp = proj.activeItem;       // הקומפ הפעיל
var layer = comp.layer(1);        // שכבה ראשונה (1-indexed!)
var pos = layer.transform.position; // תכונה Position
var value = pos.value;             // ערך נוכחי [x, y]

חשוב — אינדקסים מתחילים מ-1

בניגוד ל-JavaScript הרגיל (0-indexed), ב-ExtendScript אובייקטים של אפטר הם 1-indexed. comp.layer(1) זו השכבה הראשונה (לא layer(0)).

איך עוברים על כל השכבות

for (var i = 1; i <= comp.numLayers; i++) {
  var layer = comp.layer(i);
  alert("שכבה " + i + ": " + layer.name);
}

פילטור — רק שכבות טקסט

for (var i = 1; i <= comp.numLayers; i++) {
  var layer = comp.layer(i);
  if (layer instanceof TextLayer) {
    alert("טקסט: " + layer.name);
  }
}

חלון בסיסי

var win = new Window("palette", "כותרת");
win.add("statictext", undefined, "שלום");

var btn = win.add("button", undefined, "לחץ עליי");
btn.onClick = function() {
  alert("לחצת!");
};

win.show();

שדה קלט

var input = win.add("edittext", undefined, "");
input.characters = 20;

var okBtn = win.add("button", undefined, "OK");
okBtn.onClick = function() {
  var userText = input.text;
  alert("הוקלד: " + userText);
};

פאנל קבוע (לא חלון מרחף)

כדי שהסקריפט יופיע כפאנל קבוע (כמו Effects Panel), הקוד מתחיל אחרת:

function myPanel(thisObj) {
  var panel = (thisObj instanceof Panel)
    ? thisObj
    : new Window("palette", "My Tool");

  panel.add("statictext", undefined, "זה הפאנל שלי");

  if (panel instanceof Window) {
    panel.show();
  }
}

myPanel(this);

// סקריפט: יוצר 10 שכבות טקסט מסודרות
// מאת: BDNHOST · 2026

app.beginUndoGroup("Create 10 Text Layers");

try {
  // 1. יצירת קומפוזיציה חדשה
  var comp = app.project.items.addComp(
    "Generated Comp", 1920, 1080, 1.0, 10, 30
  );

  // 2. רשימת מילים שייצרו את השכבות
  var words = [
    "חלום", "מטרה", "תוכנית", "פעולה", "התמדה",
    "כישלון", "לימוד", "שיפור", "הצלחה", "חזרה"
  ];

  // 3. צבעים שונים לכל שכבה
  var colors = [
    [1.0, 0.5, 0.3], [0.3, 0.7, 1.0],
    [0.5, 1.0, 0.3], [1.0, 0.3, 0.7],
    [1.0, 1.0, 0.3], [0.7, 0.3, 1.0],
    [0.3, 1.0, 1.0], [1.0, 0.7, 0.3],
    [0.5, 0.5, 1.0], [1.0, 1.0, 1.0]
  ];

  // 4. לולאה — יוצרים 10 שכבות
  for (var i = 0; i < words.length; i++) {
    var textLayer = comp.layers.addText(words[i]);

    // הגדרת stilo
    var textProp = textLayer.property("Source Text");
    var doc = textProp.value;
    doc.fontSize = 80;
    doc.fillColor = colors[i];
    doc.font = "Heebo-Bold";
    doc.justification = ParagraphJustification.CENTER_JUSTIFY;
    textProp.setValue(doc);

    // מיקום: עמודה אחת, מסודרים אנכית
    textLayer.transform.position.setValue(
      [960, 100 + i * 90]
    );

    // keyframes של Opacity (delay לפי i)
    var opacity = textLayer.transform.opacity;
    opacity.setValueAtTime(i * 0.1, 0);
    opacity.setValueAtTime(i * 0.1 + 0.3, 100);
  }

  // 5. פתיחת הקומפוזיציה
  comp.openInViewer();

  alert("נוצרו " + words.length + " שכבות טקסט!");

} catch(e) {
  alert("שגיאה: " + e.toString());
}

app.endUndoGroup();

איך מריצים

1. שמרו את הקוד כ-create-10-layers.jsx.
2. פותחים אפטר עם פרויקט פתוח.
3. File → Scripts → Run Script File.
4. בוחרים את הקובץ. בלחיצה — נוצרת קומפוזיציה חדשה עם 10 שכבות טקסט בעברית, בצבעים שונים, נכנסות עם delay של 0.1 שניות בין אחת לשנייה.

ExtendScript / JSX מאפשר לכם לכתוב קוד שעובד "על" אפטר. גישה ל-DOM (project, comp, layer, property), יצירת אובייקטים (addComp, addText, setValueAtTime), ובניית UI עם ScriptUI. הסקריפט הראשון שלכם הוא 50 שורות שמייצרות שכבות אוטומטית — הבסיס לכל אוטומציה רצינית.

מהסקריפט הראשון לסקריפט מסחרי הדרך לא ארוכה: שיפוץ הקוד, הוספת UI, debugging, וטיפול ב-edge cases. זה בדיוק התהליך שעברנו עם Text Layer Manager — שיוצר היום הכנסה חודשית.