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

परिचय

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

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

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

void detected() {
  Brain.Screen.print("object detected");
}

// 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

void lost() {
  Brain.Screen.print("object lost");
}

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