Pygame 1.9 - pixelcopy

pygame.pixelcopy




pygame

pygame.pixelcopy

सामान्य पिक्सेल सरणी कॉपी के लिए pygame मॉड्यूल

pygame.pixelcopy मॉड्यूल में सरणी संरचना इंटरफ़ेस का निर्यात करने वाली सतहों और वस्तुओं के बीच प्रतिलिपि बनाने के लिए कार्य शामिल हैं। यह pygame.surfarray लिए बैकएंड है, NumPy समर्थन जोड़ रहा है। लेकिन पिक्सेलस्कोपी अधिक सामान्य है, और प्रत्यक्ष उपयोग के लिए इरादा है।

सरणी संरचना इंटरफ़ेस एक सरणी के डेटा को मानक तरीके से उजागर करता है। इसे NumPy में पेश किया गया था। पायथन 2.7 और इसके बाद के संस्करण में इसे नए बफर प्रोटोकॉल द्वारा बदल दिया गया है, हालांकि बफर प्रोटोकॉल अभी भी प्रगति पर है। दूसरी ओर सरणी संरचना इंटरफ़ेस, स्थिर है और पहले पायथन संस्करणों के साथ काम करता है। तो अब के लिए सरणी संरचना इंटरफ़ेस predominate तरीका है pygame सरणी आत्मनिरीक्षण संभालता है।

Pygame 1.9.2 में नया।

pygame.pixelcopy.surface_to_array(array, surface, kind='P', opaque=255, clear=0) -> None

सरणी ऑब्जेक्ट में सतह पिक्सेल कॉपी करें

सतह_तो_अरे फ़ंक्शन एक सतह वस्तु से 2 डी या 3 डी सरणी में पिक्सेल की प्रतिलिपि बनाता है। तर्क kind और लक्ष्य सरणी आयाम के आधार पर, एक प्रतिलिपि कच्चे पिक्सेल मूल्य, RGB, एक रंग घटक टुकड़ा या colorkey अल्फा पारदर्शिता मूल्य हो सकता है। मान्यता प्राप्त kind मान एकल वर्ण कोड 'P', 'R', 'G', 'B', 'A' और 'C' हैं। तरह-तरह के केस असंवेदनशील होते हैं, इसलिए 'पी' 'पी' के बराबर होता है। लक्ष्य के पहले दो आयाम सतह का आकार (w, h) होना चाहिए।

डिफ़ॉल्ट 'P' तरह का कोड एक सीधा सरणी में एक सीधा कच्चा पूर्णांक पिक्सेल (मैप्ड) मान कॉपी और एक 3 डी सरणी आकार (w, h, 3) के लिए एक 'RGB' पिक्सेल घटक (unmapped) कॉपी करता है। 8 बिट कोलरमैप सतह के लिए इसका मतलब है कि टेबल इंडेक्स को 2 डी सरणी में कॉपी किया जाता है, न कि टेबल वैल्यू पर। एक 2 डी सरणी के आइटम का आकार कम से कम उतना बड़ा होना चाहिए जितना कि सतह के पिक्सेल बाइट का आकार। 3D सरणी का आइटम आकार कम से कम एक बाइट होना चाहिए।

'R', 'G', 'B', और 'A' की नकल के लिए unmapped सतह पिक्सेल के एकल रंग घटक को लक्ष्य 2D सरणी में कॉपी किया जाता है। स्रोत अल्फा के साथ तरह 'ए' और सतहों के लिए (सतह को SRCALPHA ध्वज के साथ बनाया गया था), एक कोर्कॉर्ली ( Surface.set_colorkey() साथ सेट) है, या एक कंबल अल्फा है ( Surface.set_alpha() साथ सेट) तब अल्फा मान एक एसडीएल सतह के लिए अपेक्षित हैं। यदि किसी सतह का कोई स्पष्ट अल्फ़ा मान नहीं है, तो लक्ष्य सरणी वैकल्पिक opaque सतह_to_array तर्क (डिफ़ॉल्ट 255: पारदर्शी नहीं) के मूल्य से भर जाती है।

प्रतिलिपि प्रकार 'सी' कोलॉर्के के साथ एक स्रोत सतह की अल्फा कॉपी के लिए एक विशेष मामला है। 'ए' रंग घटक की नकल के विपरीत, clear तर्क मूल्य का उपयोग कोलोर्के मैचों, opaque अन्यथा के लिए किया जाता है। डिफ़ॉल्ट रूप से, एक मैच में अल्फा 0 (पूरी तरह से पारदर्शी) होता है, जबकि बाकी सब कुछ अल्फा 255 (पूरी तरह से अपारदर्शी) होता है। यह pygame.surfarray.array_colorkey() का अधिक सामान्य कार्यान्वयन है।

सतह_to_array के लिए विशिष्ट, गलत आकृति या आइटम आकार के साथ लक्ष्य सरणियों के लिए एक ValueError उठाया जाता है। एक TypeError गलत तरह के कोड के लिए उठाया जाता है। सतह विशिष्ट समस्याएं, जैसे ताला लगाना, एक pygame.error उठाना।

pygame.pixelcopy.array_to_surface(<surface>, <array>) -> None

किसी सतह पर एक सरणी ऑब्जेक्ट की प्रतिलिपि बनाएँ

pygame.surfarray.blit_array() देखें।

pygame.pixelcopy.map_array(<array>, <array>, <surface>) -> None

सतह प्रारूप का उपयोग करके किसी अन्य सरणी में सरणी की प्रतिलिपि बनाएँ

रंग तत्व मानों की एक सरणी को मैप करें - (<सतह> के प्रारूप के अनुसार पिक्सल के एक सरणी के लिए - (डब्ल्यू, एच, ..., 3) -।

pygame.pixelcopy.pygame.pixelcopy.make_surface(array) -> Surface

एक सरणी को एक नई सतह पर कॉपी करें

एक नया सरफेस बनाएं जो एरे के डेटा और फॉर्मेट से मिलता जुलता हो। सरणी किसी भी आकार पूर्णांक मानों के साथ 2D या 3D हो सकती है।