स्क्रीन#

परिचय #

screen क्लास brain बेस क्लास से व्युत्पन्न है। यह नियंत्रित करता है कि V5 ब्रेन अपने टचस्क्रीन पर टेक्स्ट, नंबर और ग्राफिक्स कैसे प्रदर्शित करता है, और यह टच इनपुट पर कैसे प्रतिक्रिया करता है।

डिफ़ॉल्ट रूप से, ब्रेन में प्रिंट करने के लिए फ़ॉन्ट मोनोस्पेस्ड स्मॉल है जिसमें 12 पंक्तियाँ और 48 कॉलम होते हैं।

चित्र बनाने के लिए, मस्तिष्क का रिज़ॉल्यूशन 480 x 240 पिक्सल है।

V5 ब्रेन स्क्रीन पर लाल ग्रिड लाइनें कुल 12 पंक्तियों और 48 स्तंभों का लेआउट दिखा रही हैं। पिक्सेल आयाम 479 चौड़ाई और 239 ऊँचाई के हैं। ऊपरी बायां कोना 0,0 पिक्सेल और पंक्ति 1, स्तंभ 1 से शुरू होता है, जबकि निचला दायां कोना 479, 239 पिक्सेल और पंक्ति 12, स्तंभ 48 पर समाप्त होता है

पहुँच #

screen क्लास को निम्न प्रकार से एक्सेस किया जा सकता है:

Brain.Screen

नोट्स #

screen ऑब्जेक्ट ब्रेन द्वारा प्रदान किया जाता है। इसे सीधे तौर पर निर्मित नहीं किया जाता है।
प्रोजेक्ट एक एकल वैश्विक Brain ऑब्जेक्ट का उपयोग करते हैं, इसलिए स्क्रीन फ़ंक्शन को Brain.Screen उपयोग करके कॉल किया जाता है।

उदाहरण #

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the V5 Brain
brain Brain = brain();

// Print text to the Brain screen
Brain.Screen.print("Hello!");

सदस्य कार्य #

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

print — ब्रेन स्क्रीन पर स्वरूपित पाठ, संख्याएँ या बूलियन मान प्रिंट करता है।
setCursor — टेक्स्ट कर्सर को निर्दिष्ट पंक्ति और स्तंभ पर ले जाता है।
newLine — वर्तमान पंक्ति के शेष भाग को साफ़ करता है और कर्सर को अगली पंक्ति में ले जाता है।
clearLine — वर्तमान लाइन के शेष भाग को साफ़ करता है या एक निर्दिष्ट लाइन को साफ़ करता है।
row — वह पंक्ति लौटाता है जहाँ पाठ मुद्रित किया जाएगा।
column — वह कॉलम लौटाता है जहाँ टेक्स्ट प्रिंट किया जाएगा।
getStringHeight — वर्तमान फ़ॉन्ट का उपयोग करके पिक्सेल में एक स्ट्रिंग की ऊँचाई लौटाता है।
getStringWidth — वर्तमान फ़ॉन्ट का उपयोग करके पिक्सेल में एक स्ट्रिंग की चौड़ाई लौटाता है।
printAt — x, y पिक्सेल स्थान पर स्वरूपित पाठ प्रिंट करता है।
clearScreen — ब्रेन स्क्रीन से सभी चित्र और टेक्स्ट साफ़ करता है।
setFont — स्क्रीन पर प्रिंटिंग के लिए उपयोग किए जाने वाले फ़ॉन्ट को सेट करता है।
setPenWidth — खींची गई रेखाओं और आकृति की रूपरेखा की मोटाई निर्धारित करता है।
setPenColor — टेक्स्ट, पिक्सेल, लाइन और आकार की रूपरेखा का रंग सेट करता है।
setFillColor — खींचे गए आकार और मुद्रित पाठ पृष्ठभूमि के लिए भरने का रंग सेट करता है।
setOrigin — स्क्रीन निर्देशांक के लिए उपयोग किए जाने वाले मूल को सेट करता है।
setClipRegion — स्क्रीन आउटपुट को एक आयताकार क्षेत्र तक सीमित करता है।
drawPixel — एक निर्देशांक पर एक पिक्सेल खींचता है।
drawLine — दो बिंदुओं के बीच एक रेखा खींचता है।
drawRectangle — निर्दिष्ट आकार के साथ x, y स्थान पर एक आयत बनाता है।
drawCircle — निर्दिष्ट त्रिज्या के साथ x, y स्थान पर एक वृत्त बनाता है।
drawImageFromFile — एसडी कार्ड फ़ाइल से स्क्रीन पर एक छवि बनाता है।
render — डबल बफरिंग को सक्षम करता है या बैक बफर को स्क्रीन पर रेंडर करता है।
pressing — लौटाता है कि स्क्रीन वर्तमान में दबाई जा रही है या नहीं।
xPosition — सबसे हालिया स्क्रीन प्रेस का x-निर्देशांक लौटाता है।
yPosition — सबसे हालिया स्क्रीन प्रेस का y-निर्देशांक लौटाता है।
pressed — स्क्रीन दबाए जाने पर चलने के लिए कॉलबैक फ़ंक्शन को पंजीकृत करता है।
released — दबाए जाने के बाद स्क्रीन रिलीज़ होने पर चलने के लिए एक कॉलबैक फ़ंक्शन पंजीकृत करता है।

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

// Create the V5 Brain
brain Brain = brain();

print #

V5 ब्रेन स्क्रीन पर टेक्स्ट, संख्याएँ या बूलियन मान प्रदर्शित करता है।

Available Functions

1 — स्ट्रिंग लिटरल या रीड-ओनली सी-स्टाइल स्ट्रिंग का उपयोग करके स्वरूपित टेक्स्ट प्रिंट करता है।
void print(
    const char* format,
    ... );

2 — परिवर्तनीय वर्ण सरणियों का उपयोग करके स्वरूपित पाठ मुद्रित करता है।
void print(
    char* format,
    ... );

Parameters

पैरामीटर	प्रकार	विवरण
`format`	`const char*`	एक फॉर्मेट स्ट्रिंग जिसे स्ट्रिंग लिटरल या रीड-ओनली सी-स्टाइल स्ट्रिंग के रूप में प्रदान किया गया है (उदाहरण के लिए, `“Score: %d”`)।
`format`	`char*`	एक प्रारूप स्ट्रिंग जिसे एक संशोधनीय वर्ण सरणी के रूप में प्रदान किया गया है।
`…`		एक या एक से अधिक अतिरिक्त मान जिन्हें अल्पविराम से अलग करके प्रारूप स्ट्रिंग में डाला जाता है।

Return Values

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

Notes

आउटपुट स्क्रीन पर वर्तमान कर्सर स्थिति से शुरू होता है
मुद्रित पाठ स्क्रीन फ़ॉन्ट का उपयोग करता है।
मुद्रित पाठ पेन रंग का उपयोग करता है।
print के साथ मुद्रित पाठ हमेशा पृष्ठभूमि के साथ मुद्रित होता है, और पृष्ठभूमि का रंग वर्तमान फिल रंग द्वारा निर्धारित किया जाता है।
फॉर्मेट स्ट्रिंग का उपयोग करते समय, पास किए गए मानों की संख्या और प्रकार स्ट्रिंग में फॉर्मेट स्पेसिफायर से मेल खाना चाहिए।

Examples

// Display a message at the starting cursor
Brain.Screen.print("Hello, Robot!");

V5 ब्रेन का एक स्क्रीनशॉट जिसमें स्क्रीन के ऊपरी बाएँ कोने में सफेद अक्षरों में "हैलो, रोबोट!" लिखा हुआ है।

setCursor #

कर्सर को V5 ब्रेन स्क्रीन पर एक विशिष्ट पंक्ति और स्तंभ पर ले जाता है। अगला print कॉल उस स्थान पर प्रिंट करना शुरू कर देगा।

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

पैरामीटर	प्रकार	विवरण
`row`	`int32_t`	कर्सर को जिस पंक्ति में ले जाना है।
`col`	`int32_t`	कर्सर को जिस कॉलम में ले जाना है।

Return Values

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

Notes

print का उपयोग करते समय बाद के पाठ आउटपुट कहाँ से शुरू होता है, इसे प्रभावित करता है।
पंक्तियाँ और स्तंभ वर्तमान में सेट स्क्रीन फ़ॉन्ट पर आधारित हैं।
डिफ़ॉल्ट फ़ॉन्ट (mono20) में 12 पंक्तियाँ और 48 स्तंभ होते हैं।
setCursor को कॉल करने से केवल बाद के टेक्स्ट आउटपुट की स्थिति प्रभावित होती है।

Examples

// Display text starting at Row 3 Column 12
Brain.Screen.setCursor(3, 12);
Brain.Screen.print("Row 3, Column 12");

V5 ब्रेन का एक स्क्रीनशॉट जिसमें स्क्रीन के केंद्र के पास ऊपरी भाग में, उस स्थिति पर पंक्ति 3 कॉलम 12 मुद्रित है।

newLine #

ब्रेन स्क्रीन पर कर्सर को अगली पंक्ति के प्रारंभ में ले जाता है।

Available Functions

void newLine();

Parameters

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

Return Values

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

Notes

यदि कर्सर किसी वाक्य के मध्य में है, तो newLine कर्सर के बाद की पंक्ति के शेष भाग को साफ़ कर देगा और फिर अगली पंक्ति पर चला जाएगा।
newLineको कॉल करने के बाद, कर्सर अगली पंक्ति के पहले कॉलम पर स्थित हो जाता है।
कर्सर की स्थिति और पंक्ति संख्या setCursor का उपयोग करके सेट की जाती है।

Examples

// Display two lines of text
Brain.Screen.print("Line 1");
Brain.Screen.newLine();
Brain.Screen.print("Line 2");

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें ऊपरी बाएँ कोने में सफेद रंग की दो पंक्तियाँ दिखाई दे रही हैं। पहली पंक्ति में 'लाइन 1' लिखा है, और उसके ठीक नीचे दूसरी पंक्ति में लाइन 2' लिखा है।

clearLine #

V5 ब्रेन स्क्रीन पर किसी पंक्ति से टेक्स्ट हटाता है।

Available Functions

1 — कर्सर की स्थिति से वर्तमान पंक्ति के शेष भाग को साफ़ करता है।
void clearLine();

2 — वर्तमान में कॉन्फ़िगर किए गए भरने का रंग का उपयोग करके निर्दिष्ट पंक्ति को साफ़ करता है।
void clearLine(
    int number );

3 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके निर्दिष्ट पंक्ति को साफ़ करता है।
void clearLine(
    int          number,
    const color& color );

4 — हेक्साडेसिमल रंग मान का उपयोग करके निर्दिष्ट पंक्ति को साफ़ करता है।
void clearLine(
    int         number,
    const char* color );

5 — ह्यू वैल्यू का उपयोग करके निर्दिष्ट पंक्ति को साफ़ करता है।
void clearLine(
    int number,
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`number`	`int`	साफ़ करने के लिए पंक्ति संख्या। पंक्ति क्रमांकन `1` से शुरू होता है।
`color`	`const color&`	यह फ़ंक्शन `color` ऑब्जेक्ट का उपयोग करके पंक्ति को साफ़ करता है। पूर्वनिर्धारित रंगों में शामिल हैं: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` यह कस्टम रंग ऑब्जेक्ट का भी उपयोग कर सकता है।
`color`	`const char*`	हेक्साडेसिमल रंग मान का उपयोग करके पंक्ति को साफ़ करता है (उदाहरण के लिए, `“#000000”`)।
`hue`	`int`	यह पंक्ति को `0`–`359`सीमा में एक पूर्णांक रंग मान का उपयोग करके साफ़ करता है, जो रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है।

Return Values

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

Notes

किसी पंक्ति को साफ़ करने से कर्सर की वर्तमान स्थिति नहीं बदलती है।
कर्सर की स्थिति और पंक्ति संख्या setCursor का उपयोग करके सेट की जाती है।
hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

एक रंग चक्र जो 0 से 359 तक के रंगों की श्रेणी दर्शाता है, जहाँ लाल 0 है, हरा 120 है और नीला 240 है।

Examples

// Display text on two rows
Brain.Screen.print("This text stays");
Brain.Screen.newLine();
Brain.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Brain.Screen.clearLine(2);

row #

यह उस पंक्ति को लौटाता है जहां V5 ब्रेन स्क्रीन पर टेक्स्ट प्रिंट किया जाएगा।

Available Functions

int32_t row();

Parameters

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

Return Values

यह int32_t लौटाता है जो उस पंक्ति को दर्शाता है जहां पाठ मुद्रित किया जाएगा।

पंक्ति क्रमांकन 1 से शुरू होता है।

Notes

कर्सर की स्थिति स्क्रीन फ़ॉन्ट पर आधारित है।
लौटाया गया मान यह दर्शाता है कि अगला मुद्रित आउटपुट कहाँ दिखाई देगा।
पंक्ति मान तब बदलता है जब पाठ मुद्रित होता है या जब setCursor को कॉल किया जाता है।

Examples

// Display the cursor's current row
Brain.Screen.setCursor(3, 12);
Brain.Screen.print(Brain.Screen.row());

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें स्क्रीन के ऊपरी बाएँ चतुर्थांश में, पंक्ति 3 कॉलम 12 की स्थिति पर सफेद रंग में 3 लिखा हुआ है।

column #

यह उस कॉलम को लौटाता है जहां V5 ब्रेन स्क्रीन पर टेक्स्ट प्रिंट किया जाएगा।

Available Functions

int32_t column();

Parameters

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

Return Values

यह int32_t लौटाता है जो उस कॉलम को दर्शाता है जहां टेक्स्ट प्रिंट किया जाएगा।

स्तंभों की क्रमांकन संख्या 1 से शुरू होती है।

Notes

कर्सर की स्थिति स्क्रीन फ़ॉन्ट पर आधारित है।
लौटाया गया मान यह दर्शाता है कि अगला मुद्रित आउटपुट कहाँ दिखाई देगा।
टेक्स्ट प्रिंट होने पर या setCursor कॉल होने पर कॉलम का मान बदल जाता है।

Examples

// Display the cursor's current column
Brain.Screen.setCursor(5, 15);
Brain.Screen.print(Brain.Screen.column());

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें स्क्रीन के ऊपरी बाएँ चतुर्थांश में, पंक्ति 3 स्तंभ 15 की स्थिति पर सफेद रंग में 15 लिखा हुआ है।

getStringHeight #

V5 ब्रेन स्क्रीन पर प्रदर्शित होने पर किसी स्ट्रिंग की ऊंचाई, पिक्सल में, लौटाता है।

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

पैरामीटर	प्रकार	विवरण
`cstr`	`const char*`	मापे जाने वाला पाठ, सी-शैली स्ट्रिंग के रूप में प्रदान किया गया (उदाहरण के लिए, `“Hello”`)।

Return Values

ब्रेन स्क्रीन पर रेंडर होने पर पिक्सेल में स्ट्रिंग की ऊंचाई को दर्शाने वाला int32_t लौटाता है।

Notes

लौटाई गई ऊँचाई वर्तमान में चयनित स्क्रीन फ़ॉन्ट पर निर्भर करती है
यह फ़ंक्शन स्ट्रिंग को स्क्रीन पर दिखाए बिना ही उसका माप लेता है।
लौटाई गई ऊंचाई यह दर्शाती है कि प्रिंट होने पर स्ट्रिंग कैसी दिखाई देगी।

getStringWidth #

V5 ब्रेन स्क्रीन पर प्रदर्शित होने पर किसी स्ट्रिंग की चौड़ाई (पिक्सेल में) लौटाता है।

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

पैरामीटर	प्रकार	विवरण
`cstr`	`const char*`	मापे जाने वाला पाठ, सी-शैली स्ट्रिंग के रूप में प्रदान किया गया (उदाहरण के लिए, `“Hello”`)।

Return Values

ब्रेन स्क्रीन पर रेंडर होने पर पिक्सेल में स्ट्रिंग की चौड़ाई को दर्शाने वाला int32_t लौटाता है।

Notes

लौटाई गई वर्तमान में चयनित स्क्रीन फ़ॉन्ट पर निर्भर करती है।
यह फ़ंक्शन स्ट्रिंग को स्क्रीन पर दिखाए बिना ही उसका माप लेता है।
लौटाई गई चौड़ाई यह दर्शाती है कि प्रिंट होने पर स्ट्रिंग कैसी दिखाई देगी।

printAt #

V5 ब्रेन स्क्रीन पर किसी विशिष्ट निर्देशांक पर टेक्स्ट, संख्याएँ या बूलियन मान प्रिंट करता है।

Available Functions

1 — निर्दिष्ट पिक्सेल स्थान पर स्वरूपित आउटपुट प्रिंट करता है।
void printAt(
    int32_t    x,
    int32_t    y,
    const char* format,
    ... );

2 — निर्दिष्ट पिक्सेल स्थान पर स्वरूपित आउटपुट प्रिंट करता है और यह सेट करता है कि टेक्स्ट बैकग्राउंड अपारदर्शी है या पारदर्शी।
void printAt(
    int32_t    x,
    int32_t    y,
    bool       bOpaque,
    const char* format,
    ... );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int32_t`	स्क्रीन के मूल बिंदु के संदर्भ में, प्रिंट करने के लिए x-स्थिति।
`y`	`int32_t`	स्क्रीन के मूल बिंदु के संदर्भ में, प्रिंट करने के लिए y-स्थिति।
`bOpaque`	`bool`	यह नियंत्रित करता है कि मुद्रित पाठ अपारदर्शी है या पारदर्शी: `true` — मुद्रित पाठ की पृष्ठभूमि वर्तमान रंग का उपयोग करके भरी जाती है। `false` — पाठ पारदर्शी रूप से खींचा जाता है और पृष्ठभूमि नहीं भरी जाती है।
`format`	`const char*`	एक फॉर्मेट स्ट्रिंग जो स्क्रीन पर प्रिंट होने वाली चीज़ों को नियंत्रित करती है (उदाहरण के लिए, `“Score: %d”`)।
`…`		एक या एक से अधिक अतिरिक्त मान जिन्हें अल्पविराम से अलग करके प्रारूप स्ट्रिंग में डाला जाता है।

Return Values

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

Notes

x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके बदला जा सकता है।
मुद्रित पाठ स्क्रीन फ़ॉन्ट का उपयोग करता है।
मुद्रित पाठ पेन रंग का उपयोग करता है।
फॉर्मेट स्ट्रिंग का उपयोग करते समय, पास किए गए मानों की संख्या और प्रकार स्ट्रिंग में फॉर्मेट स्पेसिफायर से मेल खाना चाहिए।

Examples

// Print "Center" at the center of the screen
Brain.Screen.printAt(220, 120, "Center");

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें सफेद अक्षरों में "सेंटर" लिखा है, स्क्रीन के बीचोंबीच में।

clearScreen #

ब्रेन स्क्रीन से सभी चित्र और टेक्स्ट मिटा देता है और कर्सर की स्थिति को पंक्ति 1, कॉलम 1 पर रीसेट कर देता है।

Available Functions

1 — स्क्रीन को पूरी तरह से काला कर देता है।
void clearScreen();

2 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके स्क्रीन साफ़ करता है।
void clearScreen(
    const color& color );

3 — हेक्साडेसिमल रंग मान का उपयोग करके स्क्रीन साफ़ करता है।
void clearScreen(
    const char* color );

4 — ह्यू वैल्यू का उपयोग करके स्क्रीन साफ़ करता है।
void clearScreen(
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`color`	`const color&`	Clears the screen using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	एक स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके स्क्रीन को साफ़ करता है (उदाहरण के लिए, `“#000000”`)।
`hue`	`int`	यह स्क्रीन को `0`–`359`सीमा में एक पूर्णांक ह्यू मान का उपयोग करके साफ़ करता है, जो एक रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है।

पैरामीटर

प्रकार

विवरण

color

const color&

Clears the screen using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

This can also use a custom color object.

color

const char*

एक स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके स्क्रीन को साफ़ करता है (उदाहरण के लिए, “#000000”)।

hue

int

यह स्क्रीन को 0–359सीमा में एक पूर्णांक ह्यू मान का उपयोग करके साफ़ करता है, जो एक रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है।

Return Values

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

Notes

hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

Examples

// Clear screen after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen();

// Clear screen to blue after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen(blue);

V5 ब्रेन स्क्रीन का स्क्रीनशॉट जिसमें पूरा प्रिंट करने योग्य क्षेत्र चमकीले नीले रंग में है।

setFont #

V5 ब्रेन स्क्रीन पर प्रदर्शित होने वाले टेक्स्ट के लिए उपयोग किए जाने वाले फ़ॉन्ट को सेट करता है।

यह स्क्रीन टेक्स्ट फ़ंक्शन जैसे print का उपयोग करते समय बाद के टेक्स्ट आउटपुट पर लागू फ़ॉन्ट को नियंत्रित करता है।

Available Functions

void setFont(
  fontType font );

Parameters

पैरामीटर	प्रकार	विवरण
`font`	`fontType`	Sets the font to one of the following: `mono12` `mono15` `mono20` `mono30` `mono40` `mono60` `prop20` `prop30` `prop40` `prop60` `fontType::cjk16` — Can print Chinese, Japanese, and Korean characters. Simplified Chinese — Can be seen up to column 28. Traditional Chinese — Can be seen up to column 28. Japanese (Kanji) — Can be seen up to column 28. Korean (Hangul) — Can be seen up to column 30. These options are shown below.

पैरामीटर

प्रकार

विवरण

font

fontType

Sets the font to one of the following:

mono12
mono15
mono20
mono30
mono40
mono60
prop20
prop30
prop40
prop60
fontType::cjk16 — Can print Chinese, Japanese, and Korean characters.
- Simplified Chinese — Can be seen up to column 28.
- Traditional Chinese — Can be seen up to column 28.
- Japanese (Kanji) — Can be seen up to column 28.
- Korean (Hangul) — Can be seen up to column 30.

These options are shown below.

`mono12`	`mono15`	`mono20`
`mono30`	`mono40`	`mono60`
`prop20`	`prop30`	`prop40`
`prop60`	`fontType::cjk16`

Return Values

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

Examples

// Print larger text
Brain.Screen.setFont(mono40);
Brain.Screen.print("VEX");

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें ऊपरी बाएँ कोने में डिफ़ॉल्ट फ़ॉन्ट से बड़े फ़ॉन्ट में VEX लिखा हुआ सफेद टेक्स्ट दिखाई दे रहा है।

// Print in Chinese
Brain.Screen.setFont(fontType::cjk16);
Brain.Screen.print("VEX机器人");

वी5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें ऊपरी बाएँ कोने में चीनी फ़ॉन्ट में "VEX机器人" लिखा हुआ है।

setPenWidth #

खींची गई रेखाओं और आकृतियों की रूपरेखा की मोटाई निर्धारित करता है।

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

पैरामीटर	प्रकार	विवरण
`width`	`uint32_t`	पेन की चौड़ाई, पिक्सल में, 0 से 32 तक।

Return Values

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

Notes

पेन की चौड़ाई ड्राइंग फ़ंक्शन जैसे drawLine, drawRectangle, और drawCircle पर लागू होती है।

Examples

// Draw a rectangle with a pen width of 10
Brain.Screen.setPenWidth(10);
Brain.Screen.drawRectangle(50, 50, 130, 60);

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें स्क्रीन के ऊपरी बाएँ भाग में मोटी सीमाओं वाला एक आयत छपा हुआ है।

setPenColor #

टेक्स्ट, पिक्सल, लाइनों और आकृतियों की रूपरेखा का रंग निर्धारित करता है।

Available Functions

1 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके पेन का रंग सेट करता है।
void setPenColor(
    const color& color );

2 — हेक्साडेसिमल रंग मान का उपयोग करके पेन का रंग सेट करता है।
void setPenColor(
    const char* color );

3 — ह्यू वैल्यू का उपयोग करके पेन का रंग सेट करता है।
void setPenColor(
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`color`	`const color&`	पेन का रंग `color` ऑब्जेक्ट का उपयोग करके सेट करता है। पूर्वनिर्धारित रंगों में शामिल हैं: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके पेन का रंग सेट करता है (उदाहरण के लिए, `“#FF0000”`)।
`hue`	`int`	पेन का रंग `0`–`359`सीमा में एक पूर्णांक ह्यू मान का उपयोग करके सेट करता है, जो रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है (उदाहरण के लिए, `0` लाल है, `120` हरा है, और `240` नीला है)।

पैरामीटर

प्रकार

विवरण

color

const color&

पेन का रंग color ऑब्जेक्ट का उपयोग करके सेट करता है। पूर्वनिर्धारित रंगों में शामिल हैं:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके पेन का रंग सेट करता है (उदाहरण के लिए, “#FF0000”)।

hue

int

पेन का रंग 0–359सीमा में एक पूर्णांक ह्यू मान का उपयोग करके सेट करता है, जो रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है (उदाहरण के लिए, 0 लाल है, 120 हरा है, और 240 नीला है)।

Return Values

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

Notes

किसी प्रोजेक्ट की शुरुआत में डिफ़ॉल्ट पेन का रंग white होता है।
पेन के रंग का उपयोग आकृतियों की रूपरेखा (जैसे drawCircle या drawRectangle के साथ), पाठ और संख्यात्मक आउटपुट ( print और printAt के साथ), और drawPixel के साथ खींचे गए व्यक्तिगत पिक्सेल के लिए किया जाता है।
hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

Examples

// Draw a rectangle with orange borders
Brain.Screen.setPenColor(orange);
Brain.Screen.drawRectangle(50, 50, 130, 60);

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें स्क्रीन के ऊपरी बाएँ भाग में नारंगी रंग से बना एक आयत दिखाया गया है।

setFillColor #

आकृतियों को बनाते समय उपयोग किए जाने वाले भरने के रंग को निर्धारित करता है।

Available Functions

1 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके फिल रंग सेट करता है।
void setFillColor(
    const color& color );

2 — हेक्साडेसिमल रंग मान का उपयोग करके फिल रंग सेट करता है।
void setFillColor(
    const char* color );

3 — ह्यू वैल्यू का उपयोग करके फिल कलर सेट करता है।
void setFillColor(
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`color`	`const color&`	यह फ़ंक्शन `color` ऑब्जेक्ट का उपयोग करके फिल कलर सेट करता है। पूर्वनिर्धारित रंगों में शामिल हैं: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके फिल रंग सेट करता है (उदाहरण के लिए, `“#00FF00”`)।
`hue`	`int`	`0`–`359`सीमा में एक पूर्णांक ह्यू मान का उपयोग करके फिल रंग सेट करता है, जो एक रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है (उदाहरण के लिए, `0` लाल है, `120` हरा है, और `240` नीला है)।

पैरामीटर

प्रकार

विवरण

color

const color&

यह फ़ंक्शन color ऑब्जेक्ट का उपयोग करके फिल कलर सेट करता है। पूर्वनिर्धारित रंगों में शामिल हैं:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

स्ट्रिंग के रूप में दर्शाए गए हेक्साडेसिमल रंग मान का उपयोग करके फिल रंग सेट करता है (उदाहरण के लिए, “#00FF00”)।

hue

int

0–359सीमा में एक पूर्णांक ह्यू मान का उपयोग करके फिल रंग सेट करता है, जो एक रंग चक्र के चारों ओर डिग्री का प्रतिनिधित्व करता है (उदाहरण के लिए, 0 लाल है, 120 हरा है, और 240 नीला है)।

Return Values

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

Notes

किसी प्रोजेक्ट की शुरुआत में डिफ़ॉल्ट फिल कलर black होता है।
फिल कलर का उपयोग आकृतियों के आंतरिक भाग के लिए किया जाता है (जैसे कि drawCircle या drawRectangle के साथ)।
फिल कलर का उपयोग प्रिंटेड टेक्स्ट के लिए बैकग्राउंड कलर के रूप में किया जाता है (जैसे कि print और printAt के साथ)।
- यदि transparent उपयोग मुद्रित पाठ के साथ किया जाता है, तो पृष्ठभूमि black होगी।
hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

Examples

// Draw a rectangle filled with purple
  Brain.Screen.setFillColor(purple);
  Brain.Screen.drawRectangle(50, 100, 130, 60);

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट जिसमें स्क्रीन के निचले बाएँ भाग में बैंगनी रंग से भरा एक आयत दिखाई दे रहा है।

setOrigin #

ब्रेन स्क्रीन पर ड्राइंग और कोऑर्डिनेट-आधारित प्रिंटिंग के लिए उपयोग किए जाने वाले मूल बिंदु को निर्धारित करता है।

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int32_t`	ब्रेन स्क्रीन के ऊपरी-बाएँ कोने के सापेक्ष मूल बिंदु की x-स्थिति 0 से 479 तक।
`y`	`int32_t`	ब्रेन स्क्रीन के ऊपरी-बाएँ कोने के सापेक्ष मूल बिंदु की y-स्थिति 0 से 239 तक।

Return Values

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

Notes

डिफ़ॉल्ट मूल बिंदु स्क्रीन के ऊपरी-बाएँ कोने पर स्थित निर्देशांक (0, 0) है।
मूल बिंदु निर्देशांक कार्यों जैसे drawLine, drawRectangle, drawCircle, और printAt पर लागू होता है।
मूल तत्व तब तक प्रभावी रहता है जब तक इसे दोबारा नहीं बदला जाता या प्रोजेक्ट को रीसेट नहीं किया जाता।

setClipRegion #

स्क्रीन पर एक आयताकार क्षेत्र को परिभाषित करता है जहां सभी चित्र और पाठ सीमित रहेंगे। इस क्षेत्र के बाहर की कोई भी सामग्री प्रदर्शित नहीं होगी।

Available Functions

void setClipRegion(
  int x,
  int y,
  int width,
  int height );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int`	क्लिप क्षेत्र के ऊपरी-बाएँ कोने का x-निर्देशांक, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दिया गया है।
`y`	`int`	क्लिप क्षेत्र के ऊपरी-बाएँ कोने का y-निर्देशांक, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दिया गया है।
`width`	`int`	क्लिप क्षेत्र की चौड़ाई पिक्सल में, जो 0 से 479 तक के पूर्णांक के रूप में दी गई है।
`height`	`int`	क्लिप क्षेत्र की ऊंचाई पिक्सल में, जो 0 से 239 तक के पूर्णांक के रूप में दी गई है।

Return Values

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

Notes

ड्राइंग फ़ंक्शन तब भी निष्पादित होते हैं, भले ही वे क्लिप क्षेत्र के बाहर हों, लेकिन केवल क्षेत्र के अंदर का भाग ही दिखाई देता है।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके बदला जा सकता है।
क्लिप क्षेत्र केवल वर्तमान थ्रेड पर लागू होता है।
एक नया क्लिप क्षेत्र सेट करने से वर्तमान थ्रेड के लिए पहले से सेट किया गया कोई भी क्लिप क्षेत्र बदल जाता है।

Examples

// Restrict text and drawings to a specific region
Brain.Screen.setClipRegion(0, 0, 120, 120);
Brain.Screen.drawRectangle(60, 60, 100, 100, red);
Brain.Screen.printAt(60, 60, "Cut off!");

वी5 ब्रेन की स्क्रीन का एक स्क्रीनशॉट जिसमें सफेद अक्षरों में "कट ऑफ" लिखा है और उसके ठीक नीचे ऊपरी बाएँ चतुर्थांश में एक ठोस लाल वर्ग है, जो क्लिप क्षेत्र के भीतर मुद्रित सामग्री को दर्शाता है।

drawPixel #

चयनित x और y पिक्सेल स्थानों पर V5 ब्रेन स्क्रीन पर एक पिक्सेल बनाता है।

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int`	वह x-निर्देशांक जहाँ पिक्सेल बनाया जाएगा, 0 से 479 तक के पूर्णांक के रूप में दिया गया है।
`y`	`int`	पिक्सेल को जिस y-निर्देशांक पर बनाया जाएगा, उसे 0 से 239 तक के पूर्णांक के रूप में दिया जाता है।

Return Values

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

Notes

पिक्सेल वर्तमान पेन रंग का उपयोग करके खींचे जाते हैं setPenColor।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके सेट किया जा सकता है।
यदि निर्दिष्ट पिक्सेल स्थान स्क्रीन की सीमाओं के बाहर है, तो पिक्सेल को नहीं दर्शाया जाएगा।

Examples

// Draw the pixels marking the corners of a square
Brain.Screen.drawPixel(250, 100);
Brain.Screen.drawPixel(275, 100);
Brain.Screen.drawPixel(250, 125);
Brain.Screen.drawPixel(275, 125);

drawLine #

V5 ब्रेन स्क्रीन पर दो बिंदुओं को जोड़ने वाली एक सीधी रेखा खींचता है।

Available Functions

void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );

Parameters

पैरामीटर	प्रकार	विवरण
`x1`	`int`	रेखा का प्रारंभिक x-निर्देशांक, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दिया गया है।
`y1`	`int`	रेखा का प्रारंभिक y-निर्देशांक, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दिया गया है।
`x2`	`int`	रेखा का अंतिम x-निर्देशांक, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दिया गया है।
`y2`	`int`	रेखा का अंतिम y-निर्देशांक, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दिया गया है।

Return Values

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

Notes

रेखाएँ वर्तमान पेन रंग का उपयोग करके खींची जाती हैं जो setPenColor के साथ सेट की गई है।
रेखा की चौड़ाई वर्तमान पेन चौड़ाई द्वारा निर्धारित की जाती है जो setPenWidth के साथ सेट की जाती है।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके सेट किया जा सकता है।
यदि रेखा का कोई भी भाग स्क्रीन की सीमाओं से बाहर स्थित है, तो केवल दृश्यमान भाग ही खींचा जाता है।

Examples

// Draw a line from the top left to bottom right of the screen
Brain.Screen.drawLine(0, 0, 479, 239);

V5 ब्रेन स्क्रीन का एक स्क्रीनशॉट ऊपरी बाएँ कोने से निचले दाएँ कोने तक केंद्र एक पतली विकर्ण रेखा दिखाता है।

drawRectangle #

यह निर्दिष्ट स्थिति और आकार पर V5 ब्रेन स्क्रीन पर एक आयत बनाता है।

Available Functions

1 — वर्तमान में कॉन्फ़िगर किए गए भरने का रंग का उपयोग करके एक आयत बनाता है और भरता है।
void drawRectangle(
    int x,
    int y,
    int width,
    int height );

2 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके एक आयत बनाता और भरता है।
void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const color&  color );

3 — हेक्साडेसिमल रंग मान का उपयोग करके एक आयत बनाता और भरता है।
void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const char*   color );

4 — ह्यू वैल्यू का उपयोग करके एक आयत बनाता और भरता है।
void drawRectangle(
    int x,
    int y,
    int width,
    int height,
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int`	आयत के ऊपरी-बाएँ कोने का x-निर्देशांक, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दिया गया है।
`y`	`int`	आयत के ऊपरी-बाएँ कोने का y-निर्देशांक, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दिया गया है।
`width`	`int`	आयत की चौड़ाई, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दी गई है।
`height`	`int`	आयत की ऊँचाई, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दी गई है।
`color`	`const color&`	यह फ़ंक्शन `color` ऑब्जेक्ट का उपयोग करके आयत को भरता है। पूर्वनिर्धारित रंगों में शामिल हैं: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` यह कस्टम रंग ऑब्जेक्ट का भी उपयोग कर सकता है।
`color`	`const char*`	हेक्साडेसिमल रंग मान का उपयोग करके आयत को भरता है (उदाहरण के लिए, `“#FF0000”`)।
`hue`	`int`	आयत को `0`–`359` सीमा में रंग मान का उपयोग करके भरता है।

Return Values

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

Notes

आयत की रूपरेखा वर्तमान पेन रंग का उपयोग करके खींची जाती है जिसे setPenColor के साथ सेट किया गया है।
रूपरेखा की मोटाई वर्तमान पेन की चौड़ाई द्वारा निर्धारित की जाती है जिसे setPenWidth के साथ सेट किया गया है।
जब कोई color पैरामीटर प्रदान नहीं किया जाता है, तो आयत के आंतरिक भाग को setFillColor के साथ सेट किए गए वर्तमान फिल रंग का उपयोग करके भरा जाता है।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके बदला जा सकता है।
यदि आयत का कोई भी भाग स्क्रीन की सीमाओं से बाहर स्थित है, तो केवल दृश्यमान भाग ही चित्रित किया जाता है।
hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

Examples

// Draw a rectangle on the screen
Brain.Screen.drawRectangle(50, 50, 130, 60);

V5 ब्रेन की का एक स्क्रीनशॉट ऊपरी बाएँ चतुर्थांश में पतली सफेद सीमा वाला एक आयत दिखाता है।

drawCircle #

यह निर्दिष्ट स्थिति और त्रिज्या पर V5 ब्रेन स्क्रीन पर एक वृत्त बनाता है।

Available Functions

1 — वर्तमान में कॉन्फ़िगर किए गए भरने का रंग का उपयोग करके एक वृत्त बनाता है और भरता है।
void drawCircle(
    int x,
    int y,
    int radius );

2 — पूर्वनिर्धारित या कस्टम रंग ऑब्जेक्ट का उपयोग करके एक वृत्त बनाता और भरता है।
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const color&  color );

3 — हेक्साडेसिमल रंग मान का उपयोग करके एक वृत्त बनाता है और भरता है।
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const char*   color );

4 — ह्यू वैल्यू का उपयोग करके एक वृत्त बनाता और भरता है।
void drawCircle(
    int x,
    int y,
    int radius,
    int hue );

Parameters

पैरामीटर	प्रकार	विवरण
`x`	`int`	वृत्त के केंद्र का x-निर्देशांक, जो 0 से 479 तक की पूर्णांक संख्या के रूप में दिया गया है।
`y`	`int`	वृत्त के केंद्र का y-निर्देशांक, जो 0 से 239 तक की पूर्णांक संख्या के रूप में दिया गया है।
`radius`	`int`	वृत्त की त्रिज्या, जो 0 से 239 पिक्सल तक की पूर्णांक संख्या के रूप में दी गई है।
`color`	`const color&`	यह फ़ंक्शन `color` ऑब्जेक्ट का उपयोग करके वृत्त को भरता है। पूर्वनिर्धारित रंगों में शामिल हैं: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` यह कस्टम रंग ऑब्जेक्ट का भी उपयोग कर सकता है।
`color`	`const char*`	वृत्त को हेक्साडेसिमल रंग मान का उपयोग करके भरता है (उदाहरण के लिए, `“#FF0000”`)।
`hue`	`int`	`0`–`359` सीमा में रंग मान का उपयोग करके वृत्त को भरता है।

Return Values

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

Notes

सर्कल की रूपरेखा वर्तमान पेन रंग का उपयोग करके खींची जाती है जिसे setPenColor के साथ सेट किया गया है।
रूपरेखा की मोटाई वर्तमान पेन की चौड़ाई द्वारा निर्धारित की जाती है जिसे setPenWidth के साथ सेट किया गया है।
जब कोई color पैरामीटर प्रदान नहीं किया जाता है, तो वृत्त के आंतरिक भाग को setFillColor के साथ सेट किए गए वर्तमान फिल रंग का उपयोग करके भरा जाता है।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके बदला जा सकता है।
hue पैरामीटर मान एक गोलाकार रंग चक्र पर आधारित है, जैसा कि नीचे दिखाया गया है, जहां मान चक्र के चारों ओर डिग्री का प्रतिनिधित्व करते हैं (उदाहरण के लिए, लाल 0° के पास, हरा 120° के पास और नीला 240° के पास)।

Examples

// Draw a circle on the screen
Brain.Screen.drawCircle(240, 120, 40);

V5 ब्रेन का एक स्क्रीनशॉट बीच में पतली सफेद सीमा वाला एक वृत्त दिखाता है।

drawImageFromFile #

एसडी कार्ड पर संग्रहीत एक छवि फ़ाइल का उपयोग करके वी5 ब्रेन स्क्रीन पर एक छवि बनाता है।

Available Functions

bool drawImageFromFile(
  const char* name,
  int x,
  int y );

Parameters

पैरामीटर	प्रकार	विवरण
`name`	`const char*`	एसडी कार्ड पर मौजूद इमेज का फ़ाइलनाम। फ़ाइल में `.bmp` `.png` ( होना चाहिए।
`x`	`int`	छवि के बाएं किनारे को जिस x-निर्देशांक (0 से 479 पिक्सल के बीच) पर खींचा जाएगा।
`y`	`int`	छवि के ऊपरी किनारे को जिस y-निर्देशांक (0 से 239 पिक्सल के बीच) पर खींचा जाएगा।

Return Values

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

true — छवि सफलतापूर्वक लोड हो गई और स्क्रीन पर प्रदर्शित हो गई।
false — छवि प्रदर्शित नहीं हो सकी (उदाहरण के लिए, यदि फ़ाइल मौजूद नहीं है या अमान्य है)।

Notes

समर्थित छवि प्रारूप .bmp और .png हैं।
छवि फ़ाइल का आकार 512 KB से अधिक नहीं होना चाहिए।
- फ़ाइल का आकार कम करने के लिए 8-बिट RLE एन्कोडिंग की अनुशंसा की जाती है।
समर्थित छवि के अधिकतम आयाम ब्रेन स्क्रीन के आकार के बराबर हैं (लगभग 479 x 239 पिक्सल)।
x और y निर्देशांक वर्तमान स्क्रीन मूल के सापेक्ष हैं, जिसे setOrigin का उपयोग करके बदला जा सकता है।

Examples

// Draw a bmp file on the Brain's screen at coordinate 0, 0
Brain.Screen.drawImageFromFile("test_image.bmp", 0, 0);

render #

ब्रेन की स्क्रीन के लिए डबल बफरिंग सक्षम करता है। एक बार कॉल किए जाने पर, प्रोजेक्ट के बाकी हिस्से के लिए कोई भी ड्राइंग फ़ंक्शन (जैसे टेक्स्ट, आकार या चित्र) तुरंत दिखाई नहीं देंगे। इसके बजाय, अपडेट केवल तभी दिखाई देंगे जब render का पुनः उपयोग किया जाएगा। यह स्क्रीन अपडेट को अधिक सुचारू और नियंत्रित बनाता है, लेकिन इसका मतलब है कि render का उपयोग किए जाने तक कुछ भी दिखाई नहीं देगा।

Available Functions

1 — डबल बफरिंग को सक्षम करता है या बैक बफर को स्क्रीन पर रेंडर करता है।
bool render();

2 — वर्टिकल सिंक व्यवहार और वैकल्पिक शेड्यूलर निष्पादन पर नियंत्रण के साथ बैक बफर को स्क्रीन पर रेंडर करता है।
bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

पैरामीटर	प्रकार	विवरण
`bVsyncWait`	`bool`	`true` — विज़ुअल टियरिंग को कम करने के लिए रेंडरिंग से पहले स्क्रीन के वर्टिकल रिफ्रेश होने का इंतज़ार करें। `false` — रेंडरिंग से पहले स्क्रीन के वर्टिकल रिफ्रेश होने का इंतज़ार न करें।
`bRunScheduler`	`bool`	वैकल्पिक। `true` (डिफ़ॉल्ट) — रेंडरिंग की प्रतीक्षा करते समय पृष्ठभूमि कार्यों को चलने दें। `false` — रेंडरिंग की प्रतीक्षा करते समय पृष्ठभूमि कार्यों को चलने की अनुमति न दें।

पैरामीटर

प्रकार

विवरण

bVsyncWait

bool

true — विज़ुअल टियरिंग को कम करने के लिए रेंडरिंग से पहले स्क्रीन के वर्टिकल रिफ्रेश होने का इंतज़ार करें।
false — रेंडरिंग से पहले स्क्रीन के वर्टिकल रिफ्रेश होने का इंतज़ार न करें।

bRunScheduler

bool

वैकल्पिक।

true (डिफ़ॉल्ट) — रेंडरिंग की प्रतीक्षा करते समय पृष्ठभूमि कार्यों को चलने दें।
false — रेंडरिंग की प्रतीक्षा करते समय पृष्ठभूमि कार्यों को चलने की अनुमति न दें।

Return Values

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

true — चित्र स्क्रीन पर सफलतापूर्वक प्रदर्शित हुए।
false — चित्र स्क्रीन पर प्रदर्शित नहीं हो सके।

Notes

render को कॉल करने पर प्रोजेक्ट के बाकी हिस्सों के लिए render का उपयोग करना आवश्यक होगा।

Examples

Brain.Screen.render();

// Draw text to the back buffer
Brain.Screen.print("Render later...");

// Wait for a screen press to render drawings
while (!Brain.Screen.pressing()) {
  wait(20, msec);
}
Brain.Screen.render();

pressing #

यह रिपोर्ट करता है कि क्या V5 ब्रेन स्क्रीन को वर्तमान में दबाया जा रहा है।

Available Functions

bool pressing();

Parameters

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

Return Values

यह एक बूलियन मान लौटाता है जो स्क्रीन की वर्तमान दबी हुई स्थिति को दर्शाता है:true — स्क्रीन वर्तमान में दबी हुई है। या false — स्क्रीन दबी हुई नहीं है।

Examples

// Change the screen's color after it's pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.setFillColor(green);
Brain.Screen.drawRectangle(0, 0, 479, 239);

// Display different messages after the screen is pressed
while (!Brain.Screen.pressing()) {
  wait(5, msec);
}
Brain.Screen.print("First message!");
Brain.Screen.newLine();

// Lift finger to press the screen again
while (Brain.Screen.pressing()) {
  wait(5, msec);
}
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}
Brain.Screen.print("Second message!");
Brain.Screen.newLine();

xPosition #

V5 ब्रेन स्क्रीन पर अंतिम बार दबाए गए बटन का x-निर्देशांक लौटाता है।

Available Functions

int32_t xPosition();

Parameters

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

Return Values

यह int32_t लौटाता है जो अंतिम स्क्रीन प्रेस के x-निर्देशांक को 0 से 479 पिक्सल में दर्शाता है।

Examples

// Display a circle where the screen is pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.drawCircle(Brain.Screen.xPosition(), Brain.Screen.yPosition(), 20, white);

yPosition #

V5 ब्रेन स्क्रीन पर अंतिम बार दबाए गए बटन का y-निर्देशांक लौटाता है।

Available Functions

int32_t yPosition();

Parameters

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

Return Values

यह int32_t लौटाता है जो अंतिम स्क्रीन प्रेस के y-निर्देशांक को 0 से 239 पिक्सल में दर्शाता है।

Examples

// Display a circle where the screen is pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.drawCircle(Brain.Screen.xPosition(), Brain.Screen.yPosition(), 20, white);

pressed #

V5 ब्रेन स्क्रीन दबाए जाने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

Available Functions

1 — स्क्रीन दबाए जाने पर एक फ़ंक्शन को कॉल करता है।
void pressed(
    void (*callback)(void)
);

2 — स्क्रीन दबाए जाने पर एक फ़ंक्शन को कॉल करता है और कॉलबैक फ़ंक्शन को उपयोगकर्ता-परिभाषित तर्क पास करता है।
void pressed(
    void (*callback)(void*),
    void* arg );

Parameters

पैरामीटर	प्रकार	विवरण
`callback`	`void (*)(void)`	स्क्रीन दबाने पर कॉल होने वाला एक फंक्शन।
`callback`	`void ()(void)`	एक फंक्शन जिसे स्क्रीन दबाने पर कॉल किया जाता है और जो उपयोगकर्ता द्वारा परिभाषित तर्क प्राप्त करता है।
`arg`	`void*`	एक उपयोगकर्ता-परिभाषित मान जो स्क्रीन दबाए जाने पर कॉलबैक फ़ंक्शन को पास किया जाता है।

Return Values

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

Notes

ब्रेन स्क्रीन को दबाए जाने पर हर बार कॉलबैक फ़ंक्शन निष्पादित होता है।
एक समय में केवल एक ही कॉलबैक फ़ंक्शन पंजीकृत किया जा सकता है; pressed दोबारा दबाने पर पिछला कॉलबैक बदल जाता है।
कॉलबैक फ़ंक्शन को void लौटाना चाहिए।

Examples

कॉलबैक फ़ंक्शन को परिभाषित करें ( int main() के बाहर)
// Tracks how many times the screen is pressed.
void onScreenPressed(void* arg) {
  int* count = (int*)arg;
  (*count)++;

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Pressed %d times", *count);
}
कॉलबैक को int main() के अंदर पंजीकृत करें
int main() {
  int pressCount = 0;

  // Register the callback and pass a value to update.
  Brain.Screen.pressed(onScreenPressed, &pressCount);

  while (true) {
    wait(20, msec);
  }
}

released #

V5 ब्रेन स्क्रीन को दबाए रखने के बाद छोड़े जाने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

Available Functions

1 — दबाए जाने के बाद स्क्रीन छोड़े जाने पर एक फ़ंक्शन को कॉल करता है।
void released(
    void (*callback)(void)
);

2 — दबाए जाने के बाद स्क्रीन छोड़े जाने पर एक फ़ंक्शन को कॉल करता है और कॉलबैक फ़ंक्शन को उपयोगकर्ता-परिभाषित तर्क पास करता है।
void released(
    void (*callback)(void*),
    void* arg );

Parameters

पैरामीटर	प्रकार	विवरण
`callback`	`void (*)(void)`	एक फंक्शन जिसे स्क्रीन को दबाए रखने के बाद छोड़े जाने पर कॉल किया जाता है।
`callback`	`void ()(void)`	एक फंक्शन जिसे स्क्रीन को दबाए रखने के बाद छोड़े जाने पर कॉल किया जाता है और जो उपयोगकर्ता द्वारा परिभाषित तर्क प्राप्त करता है।
`arg`	`void*`	एक उपयोगकर्ता-परिभाषित मान जो दबाए रखने के बाद स्क्रीन को छोड़े जाने पर कॉलबैक फ़ंक्शन को पास किया जाता है।

Return Values

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

Notes

ब्रेन स्क्रीन को दबाने के बाद जब भी उसे छोड़ा जाता है, तो कॉलबैक फ़ंक्शन निष्पादित होता है।
एक समय में केवल एक ही कॉलबैक फ़ंक्शन पंजीकृत किया जा सकता है; released को दोबारा कॉल करने से पिछला कॉलबैक बदल जाता है।
कॉलबैक फ़ंक्शन को void लौटाना चाहिए।

Examples

कॉलबैक फ़ंक्शन को परिभाषित करें ( int main() के बाहर)
// Tracks how many times the screen is released.
void onScreenReleased(void* arg) {
  int* count = (int*)arg;
  (*count)++;

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Released %d times", *count);
}
कॉलबैक को int main() के अंदर पंजीकृत करें
int main() {
  int releaseCount = 0;

  // Register the callback and pass a value to update.
  Brain.Screen.released(onScreenReleased, &releaseCount);

  while (true) {
    wait(20, msec);
  }
}