استكشاف الأخطاء وإصلاحها

إذا كنت تواجه مشكلة مع OpenShot، مثل التجميد أو التعطل أو رسالة خطأ، فهناك العديد من التقنيات المختلفة التي يمكن أن تكون مفيدة لاستكشاف المشكلة وإصلاحها.

ملفات المشاريع الكبيرة أو البطيئة مع موجات الصوت

يمكن أن تحتوي المشاريع القديمة التي تحتوي على العديد من موجات الصوت على ملفات .osp كبيرة بشكل غير عادي وتستغرق وقتًا أطول للفتح أو الحفظ. كانت الإصدارات القديمة تخزن قياسات الموجة داخل ملف المشروع، وأحيانًا تكررها للمقاطع وتاريخ التراجع.

الإصدار الأحدث يخزن هذه القياسات في ملفات موجة مضغوطة منفصلة بدلاً من ذلك. يحتفظ المشروع بمراجع صغيرة لتلك الملفات، مما يقلل من البيانات المنسوخة أثناء التحرير والمكتوبة في ملف .osp. تصف هذه الملفات مستويات الصوت للعرض، وليست نسخًا من الصوت نفسه؛ الوسائط والصوت المصدر الخاص بك لا يتغيران.

لتحديث مشروع قديم:

1. افتحه في الإصدار الأحدث. يقوم OpenShot تلقائيًا بنقل بيانات الموجة المضمنة إلى ذاكرة التخزين المؤقت للموجة، مع الحفاظ على مظهر الموجة الحالي.

2. اختر ملف → حفظ المشروع باسم للاحتفاظ بالمشروع الأصلي كنسخة احتياطية، أو احفظ بشكل عادي لتحديث الملف الحالي.

3. احتفظ بمجلد _assets الخاص بالمشروع المحفوظ بجانب ملف .osp عند نسخ المشروع أو عمل نسخة احتياطية منه.

على سبيل المثال، يخزن ملف MyProject.osp ملفات الموجة المضغوطة .wfc في MyProject_assets/waveforms/. يحتوي كل ملف على قياسات رقمية مضغوطة للتخزين. يمكن لبيانات الموجة المتطابقة مشاركة نفس ملف التخزين المؤقت. يستخدم OpenShot أيضًا ذاكرة تخزين مؤقت محلية أثناء عملك، بما في ذلك قبل الحفظ الأول.

لا يزال الفتح الأول يحتاج إلى قراءة البيانات المضمنة القديمة، لذا قد يستغرق وقتًا. يتم كتابة ملف المشروع الأصغر عند الحفظ. يتطلب إنشاء موجة صوتية لملف صوتي جديد وطويل تحليل ذلك الصوت. إذا كانت ملفات ذاكرة التخزين المؤقت للموجة مفقودة، يمكن لـ OpenShot إعادة بناء الموجات المرئية من الوسائط الأصلية. انظر شكل الموجة لخيارات عرض الموجة وإعادة توليدها.

استخدام السجلات لاستكشاف مشكلة

السجل هو ملف نصي يسجل ما يفعله OpenShot، مع التحذيرات والأخطاء. يمكن لهذه الملفات مساعدة فريق الدعم على فهم المشكلة، حتى عندما لا ترى رسالة خطأ على الشاشة.

يحفظ OpenShot ملفي سجل في مجلد .openshot_qt داخل مجلد المنزل الخاص بك. على Linux و macOS، يُكتب هذا الموقع كـ ~/.openshot_qt/. قد يكون المجلد مخفيًا في مدير الملفات الخاص بك.

ملفا السجل الاثنان

الملف	ما يسجله
openshot-qt.log	النشاط في المحرر: بدء OpenShot، تحميل المشاريع، تغيير الإعدادات، واستخدام الواجهة. هذا عادةً هو أفضل مكان للبدء عند التحقيق في مشكلة.
libopenshot.log	النشاط في محرك الفيديو والصوت الخاص بـ OpenShot، الجزء الذي يقرأ الوسائط ويبني الصور والصوت المستخدم في المعاينات والفيديوهات المصدرة. يمكن أن يساعد تسجيل المحرك التفصيلي في التحقيق في مشاكل التشغيل والتصدير.

تسجل هذه الملفات أجزاء مختلفة من نفس التطبيق. عند الإبلاغ عن مشكلة، قم بتضمين كلا الملفين إذا كانا متاحين. لا تحتاج إلى فهم كل سطر بنفسك.

اختر أي جزء من OpenShot تريد تسجيله

افتح تعديل → التفضيلات → متقدم للعثور على هذين الإعدادين:

التفضيلات وخيارات الطرفية المطابقة

التفضيل	الحجة المطابقة	ملف السجل
تسجيل تصحيح واجهة المستخدم	--debug-ui	openshot-qt.log
تسجيل تصحيح محرك الفيديو والصوت	--debug-engine	libopenshot.log

كلا التفضيلين مغلقان افتراضيًا، مما يحافظ على رسائل الملخص العادية. تشغيل أحدهما يضيف تفاصيل إلى ملف السجل الخاص به فورًا. لا يغير السجل الآخر أو يضيف رسائل إلى الطرفية. تبقى التفضيلات مفعلة بين الإطلاقات حتى تقوم بإيقافها.

تسجيل تصحيح واجهة المستخدم هو نقطة انطلاق جيدة للمشاكل المتعلقة بالبدء، تحميل المشاريع، الإعدادات، أو الواجهة. تسجيل تصحيح محرك الفيديو والصوت يضيف تفاصيل حول معالجة الفيديو والصوت، مما يمكن أن يساعد في التحقيق في مشاكل التشغيل والتصدير. يمكن أن تنمو سجلات المحرك بسرعة كبيرة وقد تبطئ OpenShot. قم بتشغيل هذا الإعداد قبل تكرار المشكلة بقليل، ثم أوقفه بعد ذلك.

كان تفضيل المحرك يُسمى سابقًا وضع التصحيح (مفصل). يتم نقل إعداد التشغيل/الإيقاف المحفوظ إلى الاسم الجديد.

استخدم الطرفية لإطلاق واحد

الطرفية هي نافذة تكتب فيها الأوامر. الحُجج المطابقة تُمكّن نفس التفاصيل الإضافية مثل التفضيلات، وتعرضها أيضًا في الطرفية:

openshot-qt --debug-ui

هذا يسجل تفاصيل الواجهة لإطلاق واحد. الخيارات المعروفة --debug و -d تعني نفس الشيء تمامًا مثل --debug-ui. لتفاصيل محرك الفيديو والصوت، استخدم:

openshot-qt --debug-engine

لجمع كلا النوعين من التفاصيل معًا:

openshot-qt --debug-ui --debug-engine

كرر الخطوات التي تسبب المشكلة، ثم أغلق OpenShot وجمع السجلات. هذه الحجج لا تغير تفضيلاتك المحفوظة. بدء OpenShot بشكل طبيعي يعود إلى إعدادات التسجيل المعتادة.

يبدأ openshot-qt.log ملفًا جديدًا عندما يصل إلى حوالي 25 ميجابايت ويحتفظ بثلاث نسخ أقدم. يستمر libopenshot.log في النمو مع إضافة الرسائل. بعد حفظ أي سجلات تحتاجها، يمكنك إزالة ملفات السجل القديمة أثناء إغلاق OpenShot.

خيارات تسجيل أخرى

معظم المستخدمين يحتاجون فقط إلى التحكمين أعلاه. تتيح لك الخيارات التالية اختيار مقدار التفاصيل التي تدخل في الملفات أو تظهر في الطرفية. هنا، تعني الكونسول مخرجات الطرفية. للقائمة الكاملة لخيارات تشغيل التطبيق، انظر خيارات تشغيل سطر الأوامر. لتحرير المشاريع أو أتمتة التصدير من الطرفية، انظر واجهة سطر الأوامر.

خيارات التسجيل

الخيار	ما يفعله
--debug-ui, --debug, أو -d	يُمكّن تسجيل تصحيح واجهة المستخدم في ملفه وفي الطرفية.
--debug-engine	يُمكّن تسجيل تصحيح محرك الفيديو والصوت في ملفه وفي الطرفية.
--debug-file	يضيف تفاصيل المحرر إلى openshot-qt.log دون إضافة تفاصيل إلى الطرفية.
--debug-console	يضيف تفاصيل المحرر في الطرفية دون إضافة تفاصيل إلى الملف.
--log-level LEVEL	يضبط مستوى التفاصيل لكلا السجلين ومخرجات الطرفية الخاصة بهما.
--log-file-level LEVEL	يضبط مستوى التفاصيل لكلا ملفي السجل، مع ترك إعدادات الطرفية كما هي.
--log-console-level LEVEL	يضبط مستوى التفاصيل في الطرفية لكل من المحرر والمحرك، مع ترك إعدادات الملفات كما هي.

استبدل LEVEL بـ debug للرسائل التفصيلية أو info للملخص العادي. يعرض warning التحذيرات والأخطاء؛ يعرض error الأخطاء والإخفاقات الحرجة؛ يعرض critical الإخفاقات الحرجة فقط. توقف off رسائل السجل العادية، لكن قد تستمر كتابة تشخيصات الأعطال الحالية. الأسماء بحروف كبيرة مثل DEBUG تعمل أيضًا.

على سبيل المثال، لجمع رسائل تفصيلية في كلا الملفين مع الحفاظ على مستوى الطرفية المعتاد:

openshot-qt --log-file-level debug

هذا يُمكّن أيضًا سجل المحرك الكبير، لذا استخدمه لفترة قصيرة. خيارات --debug-file و --debug-console القديمة لا تزال تعمل رغم عدم ظهورها في --help.

متغيرات البيئة

متغير البيئة هو إعداد مسمى يُمرر إلى البرنامج عند بدء تشغيله. هذه مفيدة عند تشغيل OpenShot من سكريبت أو عندما يطلب منك الدعم تجربة إعداد معين. لا تحتاج إلى تعيينها للاستخدام العادي.

إعدادات بيئية اختيارية

المتغير	ما الذي يتحكم به
OPENSHOT_LOG_LEVEL	التفاصيل في كلا الملفين والطرفية.
OPENSHOT_LOG_FILE_LEVEL	التفاصيل في كلا الملفين فقط.
OPENSHOT_LOG_CONSOLE_LEVEL	التفاصيل في الطرفية فقط، لكلا جزئي OpenShot.
LIBOPENSHOT_LOG_LEVEL	التفاصيل لمحرك الفيديو والصوت، في ملفه والطرفية.
LIBOPENSHOT_LOG_FILE_LEVEL	التفاصيل في libopenshot.log فقط.
LIBOPENSHOT_LOG_CONSOLE_LEVEL	تفاصيل المحرك في الطرفية فقط.

على سبيل المثال، هذا الأمر في طرفية Linux/macOS يطلب تسجيل محرك مفصل في ملفه لإطلاق واحد:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

إذا تداخلت الإعدادات، فإن خيارات سطر الأوامر لها الأولوية، تليها متغيرات البيئة، ثم التفضيلات، ثم الإعدادات الافتراضية العادية. كل تحكم يؤثر فقط على المخرجات التي يصفها: --debug لا يتجاوز تفضيل المحرك. التجاوزات المؤقتة لا تغير تفضيلاتك المحفوظة. مرر فوق أي مربع اختيار لترى ما إذا كان إعداد آخر يتحكم في ملف السجل هذا.

داخل إعدادات البيئة، قيم LIBOPENSHOT_ لها أولوية على قيم OPENSHOT_ للمحرك. داخل أي مجموعة، مستوى الملف فقط أو الطرفية فقط له أولوية على المستوى العام. خيارات سطر الأوامر تتبع نفس قاعدة الملف/الطرفية. يتم رفض مستويات سطر الأوامر المتضاربة لنفس المخرجات؛ يتم الإبلاغ عن المستويات البيئية غير الصالحة وتجاهلها.

بالنسبة للسكريبتات القديمة، لا يزال LIBOPENSHOT_DEBUG يمكّن رسائل المحرك التفصيلية في الطرفية متى ما كان موجودًا، حتى لو كانت قيمته 0. إعدادات المستوى الأحدث لها أولوية عليه. LIBOPENSHOT_LOG_FILE مخصص للبرامج التي تستخدم المحرك بشكل منفصل؛ أما OpenShot نفسه فيستخدم مجلد السجل أعلاه. تغيير إعدادات التسجيل لا يغير تفضيلك في الإبلاغ عن الأخطاء.

عدم استجابة Windows 11

إذا واجهت تجميدًا في Windows 11، فهذه مشكلة معروفة مع PyQt5 وWindows 11، تتعلق بميزات إمكانية الوصول في Qt. يتم تفعيلها عند الضغط على Ctrl+C في OpenShot (فقط على Windows 11). سيصبح OpenShot غير مستجيب ويوجد تسرب في الذاكرة (أي كلما طال عدم استجابة OpenShot، زاد تسرب الذاكرة حتى يتعطل OpenShot أو يقوم المستخدم بإنهاء العملية).

الحل البسيط هو تجنب استخدام Ctrl+C على Windows 11، واستخدام قوائم النسخ/اللصق بزر الفأرة الأيمن بدلاً من ذلك. حل آخر هو إعادة تعيين اختصار "نسخ" من Ctrl+C إلى شيء آخر، مثل Alt+C. يمكنك تغيير تعيينات لوحة المفاتيح في تفضيلات OpenShot. انظر لوحة المفاتيح.

تصحيح أخطاء Windows باستخدام GDB

إذا كنت تواجه تعطلًا أو تجميدًا مع OpenShot في Windows 10/11، فإن التعليمات التالية خطوة بخطوة ستساعدك في تحديد سبب التعطل. ستعرض هذه التعليمات تتبع المكدس لشيفرة مصدر OpenShot، في موقع التعطل. يمكن أن تكون هذه المعلومات مفيدة للغاية لفريق التطوير لدينا، ومفيدة جدًا لإرفاقها بتقارير الأخطاء (لحل أسرع).

تثبيت أحدث إصدار يومي

قبل إرفاق مصحح الأخطاء، يرجى تنزيل أحدث إصدار من OpenShot: https://www.openshot.org/download#daily. قم بتثبيت هذا الإصدار من OpenShot في الموقع الافتراضي: C:\Program Files\OpenShot Video Editor\. لمزيد من التعليمات التفصيلية حول تصحيح أخطاء OpenShot على Windows، يرجى مراجعة هذه الصفحة.

تثبيت MSYS2

يتم تجميع نسخة Windows من OpenShot باستخدام بيئة تسمى MSYS2. لكي تتمكن من إرفاق مصحح الأخطاء GDB بالتنفيذية openshot-qt.exe، يجب أولاً تثبيت MSYS2. هذه الخطوة مطلوبة مرة واحدة فقط.

1. تنزيل وتثبيت MSYS2: http://www.msys2.org/

2. شغّل موجه الأوامر MSYS2 MinGW x64 (على سبيل المثال: C:\msys64\msys2_shell.cmd -mingw64)

3. تحديث جميع الحزم (انسخ/الصق الأمر التالي):

   pacman -Syu
   

4. تثبيت مصحح الأخطاء GDB (انسخ/الصق الأمر التالي):

   pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
   

تشغيل OpenShot مع مصحح الأخطاء GDB

شغّل موجه الأوامر MSYS2 MinGW x64 (على سبيل المثال: C:\msys64\msys2_shell.cmd -mingw64)

تحديث PATH (انسخ/الصق الأوامر التالية):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

تحميل OpenShot في مصحح الأخطاء GDB (انسخ/الصق الأوامر التالية):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

تشغيل OpenShot من موجه GDB (انسخ/الصق الأمر التالي):

run --debug

طباعة معلومات التصحيح

بمجرد تشغيل OpenShot بنجاح مع إرفاق GDB، كل ما عليك فعله هو التسبب في تعطل أو تجميد في OpenShot. عند حدوث تعطل، عد إلى طرفية MSYS2 MinGW64 وقم بتشغيل أحد الأوامر التالية (عن طريق كتابته والضغط على ENTER). عادةً، يكون الأمر الأول الذي يتم إدخاله هو bt، والذي يعني backtrace. المزيد من الأوامر مدرجة أدناه.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

شاشات عالية الدقة / 4K

يوفر محرر الفيديو OpenShot دعمًا قويًا لشاشات عالية الدقة (نقاط في البوصة)، مما يضمن أن تبدو الواجهة واضحة وسهلة القراءة على الشاشات ذات إعدادات DPI المختلفة. هذا الدعم مفيد بشكل خاص على شاشات 4K والشاشات عالية الدقة الأخرى.

الوعي بـ DPI لكل شاشة

يكون OpenShot مدركًا لـ DPI لكل شاشة على حدة، مما يعني أنه يمكنه ضبط مقياس العرض ديناميكيًا بناءً على إعدادات DPI لكل شاشة متصلة. يساعد هذا في توفير تجربة متسقة عبر الشاشات المختلفة.

تدرج DPI على ويندوز

على ويندوز، يقوم OpenShot بتقريب عامل التدرج إلى أقرب قيمة صحيحة للحفاظ على سلامة العرض البصري. يساعد هذا في تجنب التشوهات البصرية في واجهة المستخدم ويحافظ على وضوح ومحاذاة عناصر الواجهة. بسبب هذا التقريب، قد تؤدي بعض خيارات التدرج إلى ظهور خطوط وعناصر واجهة أكبر من المتوقع.

• تدرج 125% يُقرب إلى 100%

• تدرج 150% يُقرب إلى 200%

حلول بديلة للتعديل الدقيق

بينما يساعد التقريب في الحفاظ على واجهة نظيفة، هناك حلول بديلة للمستخدمين الذين يحتاجون إلى تحكم أدق في التدرج. هذه الطرق غير موصى بها بسبب احتمال ظهور تشوهات بصرية:

• QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough

  • يمكن أن يؤدي تعيين متغير البيئة هذا إلى تعطيل التقريب والسماح بتدرج أكثر دقة.

  • ملاحظة: قد يسبب هذا تشوهات بصرية، خاصة في الجدول الزمني، ولا يُنصح به.

• QT_SCALE_FACTOR=1.25 (أو قيمة مماثلة)

  • يمكن أن يوفر تعيين عامل التدرج يدويًا تعديلات أدق على حجم الخط وتدرج واجهة المستخدم.

  • يمكن أيضًا تعيين هذا عبر التفضيلات (مقياس واجهة المستخدم)، لكن توقع مشاكل في الحدود/الخطوط على ويندوز مع التدرجات الكسرية.

  • ملاحظة: قد تؤدي هذه الطريقة أيضًا إلى تشوهات بصرية وتجعل استخدام OpenShot أكثر صعوبة.

لمزيد من المعلومات حول تعديل متغيرات البيئة هذه، يرجى زيارة https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.