LibGDX पर ट्यूटोरियल का अनुवाद - भाग 3 (दृश्य 2 डी पैकेज)

यह libGDX ट्यूटोरियल ट्रांसलेशन श्रृंखला का तीसरा लेख है।
पहला लेख यहाँ है।
दूसरा लेख यहाँ है।

scene2d

दृश्य 2 डी पैकेज एक द्वि-आयामी दृश्य के लिए एक ग्राफ को लागू करने के लिए एक वर्ग है, जो पदानुक्रम से संबंधित अभिनेताओं के एक समूह के प्रबंधन के लिए उपयोगी हो सकता है (एक अभिनेता कुछ इकाई है जिसे खींचा जा सकता है और जो इनपुट घटनाओं को संभाल सकता है - लगभग। अनुवादक) यह पैकेज अभिभावक अभिनेता के सापेक्ष समन्वय प्रणाली में अभिनेताओं को घुमाने और स्केल करने की क्षमता के साथ नियंत्रण को संभालने के लिए समर्थन प्रदान करता है। यह पैकेज कुछ निश्चित अंतराल पर अभिनेताओं के कार्यों को नियंत्रित करने के लिए एक रूपरेखा भी प्रदान करता है। दृश्य 2d.ui पैकेज उन अभिनेताओं को प्रदान करता है जो ग्राफिकल यूजर इंटरफेस बनाने में उपयोगी हो सकते हैं।

पैकेज से महत्वपूर्ण कक्षाएं

स्टेज क्लास में एक "रूट" समूह होता है जहाँ एप्लिकेशन अपने अभिनेताओं को जोड़ सकता है। स्टेज क्लास का अपना कैमरा और खुद का स्प्राइट पैकर (SpriteBatch) है। कैमरा देखने का क्षेत्र स्क्रीन आकार के बराबर सेट है। जब स्टेज क्लास प्रदान की जाती है, तो SpriteBatch रूट समूह को प्रस्तुत करता है। हालाँकि, चरण InputProcessor इंटरफ़ेस को लागू करता है और रूट समूह को इनपुट ईवेंट भेजता है।

समूह वर्ग एक ऐसा अभिनेता है जिसमें अन्य कलाकार शामिल हो सकते हैं। समूह का रोटेशन और स्केलिंग उसकी सहायक कंपनियों के अनुसार परिलक्षित होता है। समूह वर्ग उपयुक्त बाल कलाकारों के लिए ड्राइंग और इनपुट घटनाओं को दर्शाता है। यह इनपुट घटनाओं के निर्देशांक को रूपांतरित करता है ताकि बच्चे इन निर्देशांक को अपने समन्वय प्रणाली में प्राप्त करें।

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

स्टेज क्लास सेटअप

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

स्टेज क्लास में एक्ट नाम की एक विधि होती है, जो अंतिम फ्रेम तैयार होने में लगने वाले समय को लेती है। इस विधि को कॉल करने से अन्य अभिनेताओं की एक्ट विधि को कॉल किया जाता है, जो अभिनेताओं को कुछ निश्चित अंतराल पर कुछ क्रियाएं करने की अनुमति देता है। स्टेज क्लास पर एक्ट विधि को कॉल करना वैकल्पिक है।

private Stage stage; public void create () { stage = new Stage(0, 0, true); } public void resize (int width, int height) { stage.setViewport(width, height, true); } public void render () { Gdx.gl.glClear(GL10.GL_COLOR_BUFFER_BIT); stage.act(Gdx.graphics.getDeltaTime()); stage.draw(); } public void dispose() { stage.dispose(); } 

अभिनेता

एब्सट्रैक्ट क्लास एक्टर को बढ़ाएं और दृश्य ग्राफ में ड्रॉइंग, निर्धारण, क्लिक और हैंडलिंग नियंत्रण के तरीकों को लागू करें।

ड्राइंग

जब स्टेज क्लास के लिए पेंट विधि को बुलाया जाता है, तो यह रूट समूह के लिए पेंट विधि को आमंत्रित करता है। बदले में, रूट समूह बाल कलाकारों पर ड्राइंग विधियों को बुलाता है। एक अभिनेता को आकर्षित करने के लिए, ड्रा () विधि लागू करें:

 TextureRegion region; public void draw (SpriteBatch batch, float parentAlpha) { batch.setColor(1, 1, 1, parentAlpha); batch.draw(region, x, y, width, height); } 

स्प्राइटबैच, जो मूल अभिनेता (रूट समूह) द्वारा पहले से कॉन्फ़िगर किए गए अभिनेता को रूट समूह के निचले बाएं कोने के सापेक्ष अभिनेता को सही ढंग से प्रदर्शित करने के लिए प्राप्त करता है। ये ऐसे पैरामीटर हैं जैसे अभिनेता का स्थान, उसका आकार, स्केलिंग की जानकारी, रोटेशन। यह अभिनेता को सही जगह पर खींचना बहुत आसान बनाता है। उपरोक्त कोड में, पैरामीटर x, y, चौड़ाई, ऊंचाई अभिनेता वर्ग के सार्वजनिक क्षेत्र हैं।

यदि किसी विशिष्ट अभिनेता के लिए दृश्यमान पैरामीटर गलत पर सेट है, तो रूट समूह उस पर ड्रा () विधि नहीं कहेगा।

मूलपाठ पैरामीटर, जिसे ड्रा () विधि से पारित किया जाता है, मूल घटक का रंग पारदर्शिता मूल्य है। इस पैरामीटर को देखते हुए, मूल समूह और बाल कलाकार पारभासी (पारभासी) हो सकते हैं।

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

 private ShapeRenderer renderer; public void draw (SpriteBatch batch, float parentAlpha) { batch.end(); renderer.setProjectionMatrix(batch.getProjectionMatrix()); renderer.setTransformMatrix(batch.getTransformMatrix()); renderer.translate(x, y, 0); renderer.begin(ShapeType.Rectangle); renderer.rect(0, 0, width, height); renderer.end(); batch.begin(); } 

परिभाषा पर क्लिक करें

जब आप स्टेज () वर्ग पर हिट () विधि को कॉल करते हैं, तो वह रूट समूह पर हिट () विधि को कॉल करता है। मूल समूह बाल कलाकारों पर हिट () विधि कहता है। पहला रिटर्न वैल्यू टाइप एक्टर का है और स्टेज क्लास का रिटर्न रिजल्ट होगा। (अर्थात्, हम अभिनेताओं के पदानुक्रम को नीचे जाते हैं, और जैसे ही कोई भी अभिनेता "सोचता है" कि वे उस पर क्लिक करते हैं, वह खुद लौटता है, और स्टेज का वर्ग इस अभिनेता को वापस कर देता है। - लगभग। अनुवादक) क्लिक को रोकने के लिए, अभिनेता के साथ हिट () विधि लागू करें:

 public Actor hit (float x, float y) { return x > 0 && x < width && y > 0 && y < height ? this : null; } 

हिट () विधि उस अभिनेता को वापस करती है जिसे क्लिक किया गया था, या अन्यथा शून्य। निर्देशांक अभिनेता के समन्वय प्रणाली के सापेक्ष लिया जाता है। उपरोक्त कोड एक विशिष्ट कार्यान्वयन दिखाता है जब हम एक अभिनेता को वापस करते हैं यदि हम उस बिंदु पर क्लिक करते हैं जो अभिनेता की आयत में आता है।

टच इवेंट हैंडलिंग

नियंत्रण को संभालने के लिए, टचडाउन (), टचड्रेग्ड (), और टचअप () विधियों को लागू करें:

 public boolean touchDown (float x, float y, int pointer) { return true; } public void touchDragged (float x, float y, int pointer) { } public void touchUp (float x, float y, int pointer) { } 

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

ग्रुप क्लास के लिए टचडाउन () विधि चाइल्ड एक्टर्स को टचडाउन संदेश भेजती है। यदि यह विधि ओवरराइड हो जाती है, तो आपको आधार विधि को सुपर () टचडाउन () कहना चाहिए, अन्यथा अभिनेताओं को दबाने के बारे में कोई घटना नहीं मिलेगी।

क्लिकों को संसाधित करने के लिए एक अतिरिक्त विधि भी है जिसे ओवरराइड किया जा सकता है, यह टचमेड () विधि है। इसे केवल डेस्कटॉप पीसी पर ही कॉल किया जा सकता है और माउस ले जाने पर इसे कॉल किया जाता है।

हिट () विधि के समान, निर्देशांक जो नियंत्रण हैंडलर विधियों को पारित किए जाते हैं, अभिनेता के समन्वय प्रणाली में दिए गए हैं।

यदि किसी अभिनेता के लिए टाउचेबल फ़ील्ड को गलत पर सेट किया गया है, तो समूह वर्ग इस अभिनेता के लिए नियंत्रण को संभालने के तरीकों को नहीं कहेगा।

कीबोर्ड नियंत्रण को संभालने के लिए, जो केवल एक डेस्कटॉप पीसी पर हो सकता है, कीडाउन (), कीयूप और कीटाइप () विधियों को ओवरराइड करें। उन्हें केवल तभी बुलाया जा सकता है जब अभिनेता को कीबोर्ड इनपुट फ़ोकस प्राप्त हो। यह फोकस स्टेज क्लास के कीबोर्डफोकस () पद्धति को कॉल करके प्राप्त और रीसेट किया जा सकता है।

माउस स्क्रॉलिंग को संभालने के लिए, जो केवल एक डेस्कटॉप पीसी पर हो सकता है, स्क्रॉल () विधि को ओवरराइड कर सकता है। यह तभी ट्रिगर होगा जब अभिनेता के पास स्क्रॉल करने के लिए फोकस होगा। इस फ़ोकस को सेट और रीसेट करना स्टेज क्लास के स्क्रॉलफोकस विधि का उपयोग करके किया जाता है।

जोड़: एक उदाहरण के साथ एक परियोजना