ऑब्जेक्ट सेंसर#

परिचय#

ऑब्जेक्ट सेंसर द्वारा परावर्तनशीलता को मापने और वस्तुओं का पता लगाने के लिए objectdetector क्लास का उपयोग किया जाता है।

क्लास कंस्ट्रक्टर#

objectdetector( 
  triport::port &port, 
  bool           bReverse = false );

क्लास डिस्ट्रक्टर#

objectdetector ऑब्जेक्ट को नष्ट करता है और उससे जुड़े संसाधनों को मुक्त करता है।

virtual ~objectdetector();

पैरामीटर#

पैरामीटर

प्रकार

विवरण

port

triport::port &

ऑब्जेक्ट सेंसर जिस 3-वायर पोर्ट से जुड़ा है, उसे Brain.ThreeWirePort.X या ExpanderName.Xके रूप में लिखा जाता है, जहाँ X पोर्ट अक्षर है (उदाहरण के लिए, Brain.ThreeWirePort.A या Expander1.A)।

bReverse

bool

ऑब्जेक्ट सेंसर की दिशा उलटने के लिए एक वैकल्पिक बूलियन मान:

  • false (डिफ़ॉल्ट) — दिशा न उलटें
  • true — दिशा उलटें

उदाहरण#

// Create an objectdetector instance in Port A
objectdetector ObjectSensorA = objectdetector(Brain.ThreeWirePort.A, true);

सदस्य कार्य#

objectdetector क्लास में निम्नलिखित सदस्य फ़ंक्शन शामिल हैं:

  • reflectivity — ऑब्जेक्ट सेंसर द्वारा पता लगाए गए परावर्तन को लौटाता है।

  • isObjectDetected — यह बताता है कि ऑब्जेक्ट सेंसर किसी ऑब्जेक्ट का पता लगाता है या नहीं।

  • setDetectionThreshold — ऑब्जेक्ट सेंसर की डिटेक्शन रेंज सेट करता है।

  • objectDetected — ऑब्जेक्ट सेंसर द्वारा किसी ऑब्जेक्ट का पता लगाने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

  • objectLost — ऑब्जेक्ट सेंसर द्वारा ऑब्जेक्ट खो जाने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

किसी भी objectdetector सदस्य फ़ंक्शन को कॉल करने से पहले, एक objectdetector इंस्टेंस बनाना आवश्यक है, जैसा कि नीचे दिखाया गया है:

// Create an objectdetector instance in Port A
objectdetector ObjectSensorA = objectdetector(Brain.ThreeWirePort.A, true);

reflectivity#

ऑब्जेक्ट सेंसर द्वारा मापी गई परावर्तनशीलता लौटाता है।

Available Functions
int32_t reflectivity( 
  percentUnits units = percentUnits::pct );

Parameters

पैरामीटर

प्रकार

विवरण

units

percentUnits

परावर्तनशीलता को दर्शाने वाली इकाई:

  • percent / pct — प्रतिशत

Return Values

यह 0 - 100% की सीमा में ऑब्जेक्ट डिटेक्टर द्वारा मापी गई परावर्तनशीलता को प्रतिशत के रूप में दर्शाने वाला int32_t लौटाता है।

Examples
// Display the detected reflectivity on the Brain's screen
int32_t value = ObjectSensorA.reflectivity();
Brain.Screen.print(value);

isObjectDetected#

यह बताता है कि ऑब्जेक्ट डिटेक्टर द्वारा वर्तमान में किसी ऑब्जेक्ट का पता लगाया गया है या नहीं।

Available Functions
bool isObjectDetected();

Parameters

यह फ़ंक्शन कोई पैरामीटर नहीं लेता है।

Return Values

यह एक बूलियन मान लौटाता है जो यह दर्शाता है कि कोई वस्तु पहचानी गई है या नहीं:

  • true — An object is detected.
  • false — No object is detected.

setDetectionThreshold#

ऑब्जेक्ट डिटेक्टर के लिए डिटेक्शन थ्रेशहोल्ड को एक विशिष्ट मान पर सेट करता है।

Available Functions
void setDetectionThreshold( 
  int32_t      threshold, 
  percentUnits units = percentUnits::pct );

Parameters

पैरामीटर

प्रकार

विवरण

threshold

int32_t

ऑब्जेक्ट डिटेक्शन के लिए परावर्तनशीलता की सीमा 0 से 100 के बीच होती है।

units

percentUnits

The unit that represents the new threshold:

  • percent / pct — percent

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

Examples
// Set the reflectivity threshold to 50%
ObjectSensorA.setDetectionThreshold(50);

objectDetected#

किसी ऑब्जेक्ट का पता चलने पर कॉलबैक फ़ंक्शन को पंजीकृत करता है।

Available Functions
void objectDetected(void (* callback)(void));

Parameters

पैरामीटर

प्रकार

विवरण

callback

void (*)(void)

ऑब्जेक्ट का पता चलने पर कॉल की जाने वाली कॉलबैक फ़ंक्शन।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

Examples

कॉलबैक फ़ंक्शन को परिभाषित करें ( int main() के बाहर)

// Display a message when an object is detected.
void detected() {
  Brain.Screen.print("object detected");
}

कॉलबैक को int main() के अंदर पंजीकृत करें

int main() {
  // Run detected when the Object Detector detects an object.
  ObjectSensorA.objectDetected(detected);
}

objectLost#

किसी ऑब्जेक्ट के खो जाने पर कॉलबैक फ़ंक्शन को पंजीकृत करता है।

Available Functions
void objectLost(void (* callback)(void));

Parameters

पैरामीटर

प्रकार

विवरण

callback

void (*)(void)

ऑब्जेक्ट खो जाने पर कॉल की जाने वाली कॉलबैक फ़ंक्शन।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

Examples

कॉलबैक फ़ंक्शन को परिभाषित करें ( int main() के बाहर)

// Display a message when an object is lost.
void lost() {
  Brain.Screen.print("object lost");
}

कॉलबैक को int main() के अंदर पंजीकृत करें

int main() {
  // Run lost when the Object Detector loses an object.
  ObjectSensorA.objectLost(lost);
}