Pygame 1.9 - cursors

pygame.cursors




pygame

pygame.cursors

pygame मॉड्यूल कर्सर संसाधनों के लिए

Pygame सिस्टम हार्डवेयर कर्सर पर नियंत्रण प्रदान करता है। Pygame केवल सिस्टम के लिए काले और सफेद कर्सर का समर्थन करता है। आप pygame.mouse अंदर फ़ंक्शन के साथ कर्सर को नियंत्रित करते हैं।

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

मॉड्यूल में कई मानक कर्सर शामिल हैं। pygame.mouse.set_cursor() फ़ंक्शन कई तर्क लेता है। उन सभी तर्कों को एक एकल में संग्रहीत किया गया है जिन्हें आप इस तरह से कॉल कर सकते हैं:

>>> pygame.mouse.set_cursor(*pygame.cursors.arrow)

इस मॉड्यूल में स्वरूपित स्ट्रिंग्स के रूप में कुछ कर्सर भी हैं। इससे पहले कि आप उनका उपयोग कर सकें, आपको pygame.cursors.compile() फ़ंक्शन में इन्हें पास करना होगा। उदाहरण कॉल इस तरह दिखाई देगी:

>>> cursor = pygame.cursors.compile(pygame.cursors.textmarker_strings)
>>> pygame.mouse.set_cursor(*cursor)

निम्नलिखित चर कर्सर बिटमैप हैं जिनका उपयोग कर्सर के रूप में किया जा सकता है:

  • pygame.cursors.arrow
  • pygame.cursors.diamond
  • pygame.cursors.broken_x
  • pygame.cursors.tri_left
  • pygame.cursors.tri_right

निम्नलिखित तारों को pygame.cursors.compile() साथ कर्सर बिटमैप में परिवर्तित किया जा सकता है:

  • pygame.cursors.thickarrow_strings
  • pygame.cursors.sizer_x_strings
  • pygame.cursors.sizer_y_strings
  • pygame.cursors.sizer_xy_strings

pygame.cursors.compile(strings, black='X', white='.', xor='o') -> data, mask

सरल तारों से बाइनरी कर्सर डेटा बनाएं

सिस्टम कर्सर के लिए बाइनरी कर्सर डेटा बनाने के लिए स्ट्रिंग्स के एक अनुक्रम का उपयोग किया जा सकता है। रिटर्न मान pygame.mouse.set_cursor() द्वारा आवश्यक समान प्रारूप हैं।

यदि आप अपने स्वयं के कर्सर स्ट्रिंग्स बना रहे हैं, तो आप काले और सफेद पिक्सेल का प्रतिनिधित्व करने वाले किसी भी मूल्य का उपयोग कर सकते हैं। कुछ सिस्टम आपको सिस्टम रंग के लिए एक विशेष टॉगल रंग सेट करने की अनुमति देते हैं, इसे एक्सोर रंग भी कहा जाता है। यदि सिस्टम xor कर्सर का समर्थन नहीं करता है, तो वह रंग बस काला होगा।

स्ट्रिंग्स की चौड़ाई सभी के बराबर होनी चाहिए और 8 से विभाज्य होनी चाहिए। कर्सर स्ट्रिंग्स का एक उदाहरण इस तरह दिखता है

thickarrow_strings = (               #sized 24x24
  "XX                      ",
  "XXX                     ",
  "XXXX                    ",
  "XX.XX                   ",
  "XX..XX                  ",
  "XX...XX                 ",
  "XX....XX                ",
  "XX.....XX               ",
  "XX......XX              ",
  "XX.......XX             ",
  "XX........XX            ",
  "XX........XXX           ",
  "XX......XXXXX           ",
  "XX.XXX..XX              ",
  "XXXX XX..XX             ",
  "XX   XX..XX             ",
  "     XX..XX             ",
  "      XX..XX            ",
  "      XX..XX            ",
  "       XXXX             ",
  "       XX               ",
  "                        ",
  "                        ",
  "                        ")

pygame.cursors.load_xbm(cursorfile) -> cursor_args
pygame.cursors.load_xbm(cursorfile, maskfile) -> cursor_args

XBM फ़ाइल से कर्सर डेटा लोड करें

यह XBM फ़ाइलों के एक सरल सबसेट के लिए कर्सर लोड करता है। XBM फाइलें पारंपरिक रूप से UNIX सिस्टम पर कर्सर को स्टोर करने के लिए उपयोग की जाती हैं, वे सरल चित्रों का प्रतिनिधित्व करने के लिए उपयोग किए जाने वाले ASCII प्रारूप हैं।

कभी-कभी काले और सफेद रंग के मूल्यों को दो अलग-अलग XBM फ़ाइलों में विभाजित किया जाएगा। आप दो छवियों को एक कर्सर में लोड करने के लिए एक दूसरा मास्कफाइल तर्क पारित कर सकते हैं।

कर्सोफाइल और मास्कफाइल तर्क या तो फ़ाइल नाम या फ़ाइल की तरह ऑब्जेक्ट को रीडलाइन विधि से किया जा सकता है।

रिटर्न मान कर्सर_ शब्द सीधे pygame.mouse.set_cursor() फ़ंक्शन में पास किया जा सकता है।