سكريبت المارك في After Effects مع خيارات التسمية ومنطقة الحماية


في هذه الوثيقة، سأشرح كيفية استخدام سكريبت مخصص في After Effects لإضافة علامات إلى الوقت المحدد في الخط الزمني مع التعليقات القابلة للتخصيص، وألوان التسميات، وخيار تمكين Protected Regions. تم تصميم السكريبت ليتم تشغيله مباشرةً عبر AE Juice Toolbar، مما يسمح لك بالنقر على أيقونة للتنفيذ بسهولة.


نظرة عامة

يسمح لك هذا السكريبت بإضافة علامة في التركيب عند الموضع الدقيق للرأس الزمني (playhead) في الخط الزمني. يتضمن:

  • تعليقات مخصصة: يمكنك إدخال أي نص لتعليق العلامة.
  • اختيار لون التسمية: اختر من بين 16 لونًا مختلفًا لتسميات After Effects للمساعدة في تنظيم خطك الزمني بصريًا.
  • Protected Regions: تمكين المناطق المحمية لحماية أقسام معينة من التركيب لأغراض القوالب أو التحرير.

تم تصميم هذا السكريبت لمستخدمي After Effects الذين يرغبون في تبسيط سير العمل الخاص بهم وإضافة علامات بسهولة مع خصائص مخصصة. من خلال دمج السكريبت في AE Juice Toolbar، يمكنك تشغيله مباشرةً عن طريق النقر على أيقونة معينة.


الميزات

  • إضافة علامة عند موضع الرأس الزمني: يتم إضافة العلامة بالضبط حيث يتم وضع الرأس الزمني الحالي في الخط الزمني، مما يضمن تحديد موقع دقيق.
  • تعليق مخصص: يمكنك إدخال تعليق للعلامة.
  • اختيار لون التسمية: اختر لون التسمية من قائمة من 16 لونًا تتوافق مع نظام تسميات After Effects القياسي.
  • Checkbox لـ Protected Regions: خيار لتمكين Protected Regions، والتي تكون مفيدة عند العمل مع القوالب أو لمنع التعديلات في مناطق معينة من التركيب.

تعليمات تثبيت واستخدام السكريبت

1. الإعداد في After Effects

  1. تثبيت السكريبت:
    • احفظ السكريبت كملف .jsx وضعه في مكان يمكن لـ After Effects الوصول إليه.
  2. تشغيل السكريبت عبر AE Juice Toolbar:
    • افتح AE Juice Toolbar وانتقل إلى خيارات تخصيص شريط الأدوات.
    • أنشئ أو اختر أيقونة (مثل أيقونة التسمية) لتمثيل السكريبت.
    • قم بتعيين ملف السكريبت .jsx المحفوظ إلى الأيقونة، بحيث يؤدي النقر على الأيقونة إلى تشغيل السكريبت.

2. استخدام السكريبت

  1. موضع الرأس الزمني: حرك الرأس الزمني إلى النقطة الدقيقة في الخط الزمني حيث تريد إضافة العلامة.
  2. انقر على الأيقونة: انقر على الأيقونة التي قمت بتعيينها للسكريبت في AE Juice Toolbar.
  3. املأ اللوحة:
    • تعليق: أدخل تعليق للعلامة.
    • لون التسمية: اختر لون التسمية من القائمة المنسدلة (16 لون متاح).
    • تمكين Protected Regions: إذا كنت ترغب في حماية هذه المنطقة، قم بتحديد مربع الاختيار.
  4. إضافة العلامة: انقر على زر “Add Marker”، وستتم إضافة العلامة عند موضع الرأس الزمني الحالي مع إعداداتك المخصصة.

كود السكريبت

إليك الكود الكامل للسكريبت، والذي يمكنك نسخه وحفظه كملف .jsx لاستخدامه في After Effects:


function addMarkerPanel(thisObj) {
    // Create the UI panel
    var panel = (thisObj instanceof Panel) ? thisObj : new Window("palette", "Add Marker", undefined, {resizeable: true});
    panel.orientation = "column";
    
    // Comment input field
    var commentGroup = panel.add("group");
    commentGroup.add("statictext", undefined, "Comment:");
    var commentInput = commentGroup.add("edittext", undefined, "Your Comment Here");
    commentInput.characters = 30;

    // Label color dropdown
    var labelGroup = panel.add("group");
    labelGroup.add("statictext", undefined, "Label Color:");
    var labelDropdown = labelGroup.add("dropdownlist", undefined, ["Red", "Yellow", "Aqua", "Pink", "Lavender", "Green", "Cyan", "Blue", "Orange", "Brown", "Purple", "Fuchsia", "Tan", "Peach", "Mint", "Gray"]);
    labelDropdown.selection = 0; // Default to "Red"

    // Protected region checkbox
    var protectedRegionGroup = panel.add("group");
    var protectedRegionCheckbox = protectedRegionGroup.add("checkbox", undefined, "Enable Protected Region");

    // Add Marker button
    var addButton = panel.add("button", undefined, "Add Marker");

    // Define what happens when the button is clicked
    addButton.onClick = function() {
        var comp = app.project.activeItem;

        if (comp && comp instanceof CompItem) {
            app.beginUndoGroup("Add Marker with Custom UI");

            // Get the current time from the timeline cursor (playhead)
            var markerTime = comp.time; // Get current time

            // Get input values from the panel
            var markerComment = commentInput.text;
            var markerLabel = labelDropdown.selection.index + 1; // Get the index of the label (1-based)

            // Create the marker with the comment
            var marker = new MarkerValue(markerComment);
            marker.label = markerLabel; // Set the label color

            // Check if the protected region checkbox is enabled
            if (protectedRegionCheckbox.value) {
                marker.protectedRegion = true; // Enable protected region if checkbox is checked
            }

            // Add marker to the composition's timeline at the current playhead time
            comp.markerProperty.setValueAtTime(markerTime, marker);

            app.endUndoGroup();
        } else {
            alert("Please select an active composition.");
        }
    };

    // Show the panel
    if (panel instanceof Window) {
        panel.center();
        panel.show();
    }
}

addMarkerPanel(this);



مثال للاستخدام

  1. تسمية قسم حرج: أضف علامة عند نقطة حرجة في خطك الزمني واختر لون تسميات مميز (مثل Red) لجذب الانتباه.
  2. تحديد Protected Regions: إذا كنت تعمل على قالب مشروع وتريد منع تعديل مناطق معينة، يمكنك تمكين مربع الاختيار لـ Protected Regions لحماية تلك المنطقة.
  3. تحديد أحداث الخط الزمني بسهولة: باستخدام خيارات التعليق ولون التسمية، يمكنك بسرعة تحديد أقسام مختلفة من تركيبك بمجرد النظر.

خاتمة

يوفر هذا السكريبت المخصص في After Effects وسيلة سهلة وفعالة لإدارة علامات التركيب، مع خيارات إضافية للتعليقات والألوان وProtected Regions. من خلال دمجه مع AE Juice Toolbar، يمكنك تعيين السكريبت إلى أيقونة، مما يجعل العملية أسرع وأكثر سهولة.

لا تتردد في تعديل السكريبت حسب الحاجة، وشارك نتائجك أو تحسيناتك! استمتع بالتحريك!