एनईएस के लिए गेम डिबगिंग: यह आज कैसे होता है

यदि आप कभी प्रोग्रामिंग में शामिल हुए हैं, तो आप बग की अवधारणा से परिचित हैं। यदि वे हमें परेशान नहीं करते हैं, तो विकास प्रक्रिया बहुत तेज और अधिक सुखद हो जाएगी। लेकिन ये कीड़े हमारे कोड, काम के समय और रचनात्मक प्रवाह को बर्बाद करने के लिए इंतजार कर रहे हैं। सौभाग्य से, रेट्रो-गेम प्रोग्रामर के कोड में भी बग को मारने के लिए कई उपकरण और रणनीतियाँ हैं।

डिबगिंग उपकरण

डिबग कोड का सबसे अच्छा तरीका डिबगर का उपयोग करना है। FCEUX और मेसेन एमुलेटर के कुछ संस्करणों में एक अंतर्निहित डिबगर है जो आपको कोड के स्वास्थ्य की जांच करने के लिए किसी भी समय कार्यक्रम को बाधित करने की अनुमति देता है।


FCEUX एमुलेटर डिबगर

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

हेक्स संपादक FCEUX

मान लें कि हमें किसी प्रकार के चर या सरणी का निरीक्षण करने की आवश्यकता है। लिंक करने वाले विकल्प (ld65) में निम्न पंक्ति जोड़ें: -Ln labels.txt

परियोजना को संकलित करने के बाद, labels.txt । labels.txt फ़ाइल इसके फ़ोल्डर में दिखाई देगी। बस इसे ग्रंथों को देखने के लिए किसी भी कार्यक्रम में खोलें और उस चर के नाम की तलाश करें जिसे हम निरीक्षण करना चाहते हैं।

( ध्यान दें: यदि आपने एक स्थिर चर घोषित किया है, तो यह इस सूची में शामिल नहीं होगा। इसलिए, static unsigned char playerX बजाय static unsigned char playerX उपयोग करें )


अब हम वांछित चर का पता जानते हैं, बुरा नहीं। चलिए इसे डिबगर में ढूंढते हैं। FCEUX एमुलेटर में ROM गेम चलाएं। डीबग मेनू में, हेक्स संपादक आइटम का चयन करें, और खुलने वाली विंडो में, Ctrl + G दबाएं और हमारे चर का पता दर्ज करें:


ठीक दबाएं, और कर्सर उस पते पर चला जाएगा जहां चर स्थित है। आइए इसे देखें:


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

अन्य उपयोगी FCEUX एमुलेटर डीबग मेनू टूल जैसे कि PPU व्यूअर, नेम टेबल व्यूअर इत्यादि देखें।

डिबगिंग प्रक्रिया को सरल बनाएं

और अगर हम किसी चर का अवलोकन करने के लिए हर बार डिबगर चलाना नहीं चाहते हैं? एक अधिक उन्नत तरीका एक प्रक्रिया लिखना है जो स्क्रीन पर मूल्य प्रदर्शित करता है। आइए Y अक्ष पर खिलाड़ी की स्थिति प्रदर्शित करने के लिए इंटरफ़ेस में स्कोर का उपयोग करें:


यह सही काम करता है!

रेट्रो-कोडर और nesdoug ब्लॉग के मालिक डग फ्रकर ने डिबगिंग उद्देश्यों के लिए ऑन-स्क्रीन विज़ुअलाइज़ेशन का उपयोग करने के लिए एक समान विधि बनाई है। नीचे दिखाई गई प्रक्रिया स्क्रीन पर एक ग्रे लाइन बनाती है जो स्पष्ट रूप से सीपीयू लोड की डिग्री प्रदर्शित करती है:

 // void gray_line(void); // For debugging. Insert at the end of the game loop, to see how much frame is left. // Will print a gray line on the screen. Distance to the bottom = how much is left. // No line, possibly means that you are in v-blank. _gray_line: lda <PPU_MASK_VAR and #$1f ;no color emphasis bits ora #1 ;yes gray bit sta PPU_MASK ldx #20 ;wait @loop2: dex bne @loop2 lda <PPU_MASK_VAR ;normal sta PPU_MASK rts 

आप इस प्रक्रिया को अपने कोड में कॉपी कर सकते हैं या प्रोजेक्ट में nesdoug.h लाइब्रेरी शामिल कर सकते हैं। खेल चक्र के पूरा होने के बाद प्रक्रिया को बुलाया जाना चाहिए, फिर स्क्रीन पर एक ग्रे बार प्रदर्शित किया जाएगा।


यह काम किया है, लेकिन ऐसा लगता है कि मेरे पास एक और बग है! हम बाद में उससे छुटकारा पा लेंगे। इस बीच, चलो आगे बढ़ते हैं।

मैक्रों की शक्ति

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

चलो कुछ प्रकार के मैक्रो बनाएं जो हमें सही समय पर संकेत देगा, उदाहरण के लिए, एक ध्वनि बजाएं या आवश्यक मूल्य के साथ एक शून्य पैलेट का चयन करें। हमारे पास कई मैक्रोज़ हैं जो शून्य पैलेट को लाल, नीले और यादृच्छिक रंगों में बदलते हैं, साथ ही साथ ध्वनि को पुन: प्रस्तुत करते हैं:


यह कैसे काम करता है? मान लीजिए कि आपने सफलतापूर्वक एक प्रोजेक्ट संकलित किया है, तो आप एमुलेटर को अपने गेम से शुरू करते हैं, स्टार्ट बटन पर क्लिक करें और ...


एक सफेद स्क्रीन के अलावा कुछ भी नहीं लगता है। इसके अलावा, कुछ एमुलेटर स्टेटस बार में "सीपीयू जाम!" रिपोर्ट कर सकते हैं। आगे क्या करना है?

सबसे पहले, आपको उस कोड को स्थानीय बनाना होगा जिसमें त्रुटि होती है। और यहाँ मेरी ध्वनि की मैक्रो खेल में आती है।

हमें पता है कि मुख्य मेनू काम कर रहा है। आइए देखें कि इसके बाद क्या होता है:

 playMainMenu(); player.lives = 9; points = 0; gameFlags = 0; while(current_level<7 && player.lives>0) { set_world(current_world); debugSound; playCurrentLevel(); } 

मुझे संदेह है कि जब set_world प्रक्रिया set_world जाती है तो खेल क्रैश हो जाता है। आइए इस कूबड़ की जाँच करें। मैं प्रक्रिया की जाँच के बाद अगली पंक्ति में स्थूल नाम दर्ज करता हूँ।

हम परियोजना शुरू करते हैं और ... मुझे एक आवाज़ सुनाई देती है! यही है, यह प्रक्रिया सफल थी, और हमें निम्नलिखित की जांच करने की आवश्यकता है: playCurrentLevel । आइए नीचे डिबग मैक्रो को स्थानांतरित करें:

 while(current_level<7 && player.lives>0) { set_world(); playCurrentLevel(): debugSound; } 

मैं फिर से प्रोजेक्ट शुरू करता हूं, लेकिन मुझे कोई आवाज नहीं सुनाई देती। इसका मतलब है कि प्रक्रिया पूरी नहीं हुई है, और इसके अंदर एक विफलता होती है।

ऐसे मामलों में, आपको प्रक्रिया कोड खोलना चाहिए और इस तकनीक को लागू करना जारी रखना चाहिए जब तक आप संभावित बग स्थान के लिए अपनी खोज को संकीर्ण नहीं कर सकते।

स्थितियों को जाँचने के लिए पैलेट-बदलने वाला मैक्रो भी उपयोगी हो सकता है। उदाहरण के लिए, हमारा कोड कई स्थितियों का जटिल परीक्षण करता है:

 if ( (getTile(objX, objY+16) || collide16() ) || (objsOX[i] && objY>objsOX[i])) { debugRed; objsSTATE[i]=THWOMP_SMASH; objY=objsY[i]-=4; objsFRM[i]=0; sfx_play(SFX_THWOMP_SLAM_DOWN,2); } 

यदि हम यहां पैलेट का रंग बदलते हैं, तो हम देखेंगे कि क्या शर्त संतुष्ट है:


यह मुर्गी ठीक लगती है। लेकिन अगर झंडा काम नहीं करता है, तो शर्तों में से एक पूरा नहीं होता है। इस मामले में, आपको उन सभी को अलग से जांचने की आवश्यकता है और फिर, शायद, आपको एक और बग मिलेगा।

परमाणु विकल्प

मुझे हाल ही में पता चला है कि मेरे खेल में एक भूत किसी तरह के संदिग्ध व्यवहार को प्रदर्शित करता है। समय-समय पर, उन्होंने खिलाड़ी पर हमला करने से इनकार कर दिया।

एक बग द्वारा हिट इस भूत को देखें - यह केवल तब हमला करता है जब चरित्र स्क्रीन के केंद्र के करीब होता है:


कोई फर्क नहीं पड़ता कि मैंने इस प्रक्रिया के कोड का कितना अध्ययन किया, मैं यह नहीं पता लगा सका कि बग कहाँ छिपा था, इसलिए मैंने चरम उपायों को लेने और आधुनिक विकास के माहौल में इस कोड के काम का परीक्षण करने का फैसला किया।

मुझे वह सब कुछ चाहिए जो मुझे चाहिए था: एक स्क्रीन मैप, मेटा-फाइल विशेषताओं के साथ एक सरणी, एक प्रक्रिया कोड, और बस उन्हें विजुअल स्टूडियो में सम्मिलित किया गया:


पीसी पर, कोड बिल्कुल उसी तरह काम करता था। जैसा कि यह पता चला, बग एक प्रक्रिया में छिपा हुआ था जिसने खिलाड़ी और दुश्मन के बीच बाधाओं को खोजने के लिए कैश को भर दिया था। सरणी गलत तरीके से भरी गई थी। मुझे यकीन है कि 0x80 के बजाय 0 होना चाहिए।


इसलिए, मैं यह जानने के लिए कि यह क्यों हो रहा है, कोड को डीबग करने की कोशिश करेगा।


यह मजाकिया है, लेकिन ऐसा लगता है कि मैं गलत अनुक्रम में कार्रवाई कर रहा था। चलो इसे ठीक करें और सरणी को फिर से जांचें!


ऐसा लगता है कि अब सरणी सही ढंग से आबादी है। यही है, मुझे बस cc65 कोड को ठीक करने और एनईएस परियोजना को फिर से संकलित करने की आवश्यकता है।


इसलिए, आधुनिक विकास उपकरण एल्गोरिदम को डिबग करने और बग को ठीक करने में मदद कर सकते हैं।

शांति से कीड़े से छुटकारा पाएं

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

रेट्रो-डिज़ाइन पेशेवरों से सीधे सुझाव प्राप्त करना चाहते हैं? हमारे कलह में आपका स्वागत है!

हमारा गेम यहां उपलब्ध है !