> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/input-output/outputs-exports/cycle-timer.md).

# Cycle Timer

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

## 📥 المدخلات

هذه الدالة لا تحتوي على مدخلات.

## 📤 المخرجات

* `Seconds` — يعيد الزمن المنقضي (بالثواني) منذ التقييم السابق. عند أول تقييم بعد وضع البلوك أو إعادة التهيئة ستكون القيمة صفرًا.

## 🕹️ Controls

* `No Controls` — هذا البلوك ليس له عناصر تحكم للمستخدم. يقوم بتحديث الطابع الزمني الداخلي تلقائيًا عند كل تشغيل.

## ⚙️ آلية التشغيل

* في كل مرة يتم فيها تقييم البلوك داخل السيناريو، يقارن الوقت الحالي بالوقت المسجل في التقييم السابق ويعيد الفرق كقيمة `Seconds`.
* التقييم الأول يعمل كمهيئة ويُعيد صفرًا لعدم وجود طابع زمني سابق.
* يقيس البلوك الزمن الحقيقي (wall-clock) بدقة عالية، مما يجعله مناسبًا لقياس فترات قصيرة بين خطوات أو أحداث.

## 🎯 Features

* قياس فترات تلقائي وخفيف بدون إعدادات.
* توقيت عالي الدقة مناسب للملف الزمني ومراقبة الدورات.
* القيم متاحة فورًا لمعالجة لاحقة أو تسجيل.

## 📝 Usage Instructions

1. ضع البلوك في السيناريو في المكان الذي تريد قياس الزمن بين التقييمات فيه.
2. اقرأ مخرج `Seconds` في البلوكات اللاحقة لتسجيل أو تحليل أو تفعيل إجراءات بناءً على الزمن المنقضي.
3. تذكّر أن القياس الأول بعد وضع البلوك أو إعادة التهيئة يكون صفرًا.

تركيبات شائعة:

* استخدم مع `Rising Edge` أو `Logic Input` لقياس الزمن بين أحداث منفصلة أو إجراءات يدوية.
* استخدم مع مصادر الصورة مثل `Camera USB`, `Stream Reader` أو `Video` لقياس فترات الإطارات أو زمن معالجة الصورة.
* مرّر المخرج إلى `Round` للحصول على عرض رقمي مُنسق، أو إلى `Scope` لعرض مخطط زمني مباشر لأزمنة الدورات.
* أرسل القيم إلى `CSV Export` أو `Image Logger` لتسجيل تاريخ أزمنة الدورات.

## 💡 Tips and Tricks

* لمراقبة استقرار المعالجة، مرّر `Seconds` إلى `Scope` لرؤية التذبذب والقمم على مدى الوقت.
* للتسجيل على المدى الطويل، استخدم `CSV Export` لجمع قيم `Seconds` للتحليل اللاحق.
* عند القياس بين إجراءات يدوية، اجمعه مع `Keyboard/Barcode Reader` أو `Logic Input` لالتقاط مدد دقيقة من حدث لحدث.
* إذا احتجت عرضًا منسقًا، استخدم `Round` لتقليل المنازل العشرية قبل عرض القيم في واجهة المستخدم.

## 🛠️ Troubleshooting

* إذا كنت ترى دائمًا قيمًا تساوي صفرًا، تأكد أن السيناريو يعمل بتكرار وأنه غير متوقف؛ التقييم الأول بعد وضع البلوك أو إعادة التهيئة مصمم أن يكون صفرًا.
* إذا أظهرت القياسات فترات صغيرة غير متوقعة جدًا، تحقق أن البلوك لا يتم تقييمه عدة مرات خلال نفس الخطوة المنطقية بواسطة تركيبات التدفق الأخرى. فكر باستخدام مُحدِث حدث مثل `Rising Edge` ليقيس البلوك فقط عند اللحظات المقصودة.
* لتقليل القمم الضوضائية في القياسات قصيرة المدى، قم بتمهيد أو متوسط عدة قيم متتالية من `Seconds` باستخدام معالجة لاحقة أو بتسجيلها ثم معالجتها بعد ذلك.