محور

مقدمة

الفئة axis هي فئة مشتقة من الفئة controller. وهي توفر الوصول إلى قيم محاور عصا التحكم ووظائف الاستدعاء لتغيير محاور عصا التحكم.

يتم الوصول إلى كائن المحور axis من خلال كائن وحدة التحكم controller ولا يتم إنشاؤه بشكل مباشر.

وصول

توفر فئة controller كائنات المحاور التالية. كل كائن هو نسخة من فئة المحور axis

كائن المحور	مثال على الاستخدام	وصف
Axis1	Controller.Axis1.position()	المحور الأفقي لعصا التحكم اليمنى.
Axis2	Controller.Axis2.position()	المحور الرأسي لعصا التحكم اليمنى.
Axis3	Controller.Axis3.position()	المحور الرأسي لعصا التحكم اليسرى.
Axis4	Controller.Axis4.position()	المحور الأفقي لعصا التحكم اليسرى.

ملحوظات

• قبل استخدام دالة العضو axis ، قم بإنشاء كائن controller.

• position returns a value from -100 to 100.

// Create a controller object
controller Controller = controller();

الدوال الأعضاء

تتضمن فئة المحور axis الدوال الأعضاء التالية:

المُستقبِل — قراءة موضع محور عصا التحكم.

• position — تُرجع موضع محور عصا التحكم.

استدعاء الدالة — تشغيل دالة عند تغير موضع عصا التحكم على طول محور معين.

• changed — يقوم بتشغيل وظيفة عندما يتغير موضع عصا التحكم على طول هذا المحور.

المحصل

position

position تُرجع موضع محور عصا التحكم كقيمة من -100 إلى 100.

الوظائف المتاحة

int32_t position(percentUnits units = percentUnits::pct) const;

المعلمة	يكتب	وصف
units	percentUnits	اختياري. الوحدة المستخدمة لقيمة المحور المُعادة. القيمة الافتراضية هي percentUnits::pct.

القيمة المُعادة

Returns an int32_t value from -100 to 100.

• 100 — يتم تحريك محور عصا التحكم بالكامل في الاتجاه الموجب.

• 0 — محور عصا التحكم في المنتصف.

• -100 — يتم تحريك محور عصا التحكم بالكامل في الاتجاه السالب.

مثال

// Turn with the left joystick
while (true) {
  if (Controller.Axis4.position() > 10) {
    Drivetrain.turn(right);
  }
  else if (Controller.Axis4.position() < -10) {
    Drivetrain.turn(left);
  }
  else {
    Drivetrain.stop();
  }

  wait(20, msec);
}

أتصل مرة أخرى

changed

changed تشغيل وظيفة عندما يتغير موضع عصا التحكم على طول هذا المحور.

الوظائف المتاحة

void changed(void (* callback)(void)) const;

المعلمة	يكتب	وصف
callback	void (*)(void)	دالة يتم تشغيلها في كل مرة يتغير فيها موضع عصا التحكم على طول ذلك المحور.

القيمة المُعادة

هذه الدالة لا تُرجع قيمة.

مثال

قم بتعريف دالة الاستدعاء خارج الدالة الرئيسية main.

// Play a sound when the left joystick moves
void playSound() {
  Brain.playSound(siren);
}

قم بتسجيل رد الاتصال داخل main.

int main() {
  vexcodeInit();

  // Run playSound when the joystick's position changes along Axis4
  Controller.Axis4.changed(playSound);
}