🏎️ 🍷 👩🏿‍🎨 मुरब्बा में ढांचा (भाग 3) 🆚 💆🏽 🙉

आज हम इस श्रृंखला में लेखों के भाग 1 में शुरू किए गए, मुरब्बा फ्रेमवर्क के विकास का वर्णन जारी रखेंगे, जिसमें ग्राफिक संसाधनों के साथ काम में सुधार होगा, साथ ही साथ ध्वनि और छवि समूहों के साथ काम को जोड़ा जाएगा, जिसके साथ हम अनुप्रयोगों का स्थानीयकरण प्रदान करेंगे।

सबसे पहले, हम ग्राफिक संसाधनों को Sprite.cpp में कैसे लोड करते हैं, इस पर एक नज़र डालें:

Sprite.cpp

void Sprite::addImage(const char*res, int state) { img = Iw2DCreateImage(res); }

जाहिर है, अगर एक ही छवि का बार-बार उपयोग किया जाता है, तो हम इसे कई बार मेमोरी में लोड कर देंगे क्योंकि हम स्प्राइट बनाते हैं। इस तरह से काम करने से, हम मोबाइल प्लेटफार्मों पर हमारे लिए उपलब्ध रैम की मात्रा को जल्दी से समाप्त कर देंगे। हमें एक संसाधन प्रबंधक की आवश्यकता होती है जो हमें कई बार लोड किए गए संसाधनों का उपयोग करने की अनुमति देता है।

ResourceManager.h

 #ifndef _RESOURCEMANAGER_H_ #define _RESOURCEMANAGER_H_ #include <map> #include <string> #include "s3e.h" #include "IwResManager.h" #include "IwSound.h" #include "ResourceHolder.h" using namespace std; class ResourceManager { private: map<string, ResourceHolder*> res; public: ResourceManager(): res() {} void init(); void release(); ResourceHolder* load(const char* name, int loc); typedef map<string, ResourceHolder*>::iterator RIter; typedef pair<string, ResourceHolder*> RPair; }; extern ResourceManager rm; #endif // _RESOURCEMANAGER_H_

ResourceManager.cpp

 #include "ResourceManager.h" #include "Locale.h" ResourceManager rm; void ResourceManager::init() { IwResManagerInit(); } void ResourceManager::release() { for (RIter p = res.begin(); p != res.end(); ++p) { delete p->second; } res.clear(); IwResManagerTerminate(); } ResourceHolder* ResourceManager::load(const char* name, int loc) { ResourceHolder* r = NULL; string nm(name); RIter p = res.find(nm); if (p == res.end()) { r = new ResourceHolder(name, loc); res.insert(RPair(nm, r)); } else { r = p->second; } return r; }

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

ResourceHolder.h

 #ifndef _RESOURCEHOLDER_H_ #define _RESOURCEHOLDER_H_ #include <string> #include "s3e.h" #include "Iw2D.h" #include "IwResManager.h" using namespace std; class ResourceHolder { private: string name; int loc; CIw2DImage* data; public: ResourceHolder(const char* name, int loc); ~ResourceHolder() {unload();} void load(); void unload(); CIw2DImage* getData(); }; #endif // _RESOURCEHOLDER_H_ </spoiler> <spoiler title="ResourceHolder.cpp"> <source lang="cpp"> #include "ResourceHolder.h" #include "Locale.h" ResourceHolder::ResourceHolder(const char* name, int loc): name(name) , loc(loc) , data(NULL) { } void ResourceHolder::load() { if (data == NULL) { CIwResGroup* resGroup; const char* groupName = Locale::getGroupName(loc); if (groupName != NULL) { resGroup = IwGetResManager()->GetGroupNamed(groupName); IwGetResManager()->SetCurrentGroup(resGroup); data = Iw2DCreateImageResource(name.c_str()); } else { data = Iw2DCreateImage(name.c_str()); } } } void ResourceHolder::unload() { if (data != NULL) { delete data; data = NULL; } } CIw2DImage* ResourceHolder::getData() { load(); return data; }

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

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

locale_ru.group

 CIwResGroup { name "locale_ru" "./locale_ru/play.png" "./locale_ru/setup.png" "./locale_ru/musicoff.png" "./locale_ru/musicon.png" "./locale_ru/soundoff.png" "./locale_ru/soundon.png" }

समूहों की बात करते हुए, दो महत्वपूर्ण सिफारिशें की जानी चाहिए:

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

हम निम्नलिखित कोड का उपयोग करके डिवाइस क्रॉस-प्लेटफॉर्म पर वर्तमान लोकेल निर्धारित कर सकते हैं।

Locale.h

 #ifndef _LOCALE_H_ #define _LOCALE_H_ enum ELocale { elNothing = 0x0, elImage = 0x1, elSound = 0x2, elEnImage = 0x5, elRuImage = 0x9, elEnSound = 0x6, elRuSound = 0xA }; class Locale { public: static int getCurrentImageLocale(); static int getCurrentSoundLocale(); static int getCommonImageLocale() {return elImage;} static int getCommonSoundLocale() {return elSound;} static const char* getGroupName(int locale); }; #endif // _LOCALE_H_

Locale.cpp

 #include "Locale.h" #include "s3e.h" const char* Locale::getGroupName(int locale) { switch (locale) { case elImage: return "images"; case elEnSound: case elRuSound: case elSound: return "sounds"; case elEnImage: return "locale_en"; case elRuImage: return "locale_ru"; default: return NULL; } } int Locale::getCurrentImageLocale() { int32 lang = s3eDeviceGetInt(S3E_DEVICE_LANGUAGE); switch (lang) { case S3E_DEVICE_LANGUAGE_RUSSIAN: return elRuImage; default: return elEnImage; } } int Locale::getCurrentSoundLocale() { int32 lang = s3eDeviceGetInt(S3E_DEVICE_LANGUAGE); switch (lang) { case S3E_DEVICE_LANGUAGE_RUSSIAN: return elRuSound; default: return elEnSound; } }

यह हमारी परियोजना के लिए ध्वनि के साथ काम करने के लिए समर्थन जोड़ने के लिए बनी हुई है। हम दो उप-प्रणालियों का उपयोग करेंगे:

S3E ऑडियो - पार्श्व संगीत खेलने के लिए (कई कोडेक्स और स्टीरियो का समर्थन करता है)
S3E साउंड - ध्वनि प्रभाव खेलने के लिए (एक साथ कई ध्वनियों को चलाने की क्षमता का समर्थन करता है)

इन उप-प्रणालियों के साथ काम करने के सिद्धांतों को इस लेख में अच्छी तरह से वर्णित किया गया है और मैं उन पर विस्तार से ध्यान नहीं दूंगा। मैं केवल उन परिवर्तनों का वर्णन करूंगा जिन्हें परियोजना के लिए किए जाने की आवश्यकता है।

एप्लिकेशन सेटिंग फ़ाइल में, हम एक पैरामीटर जोड़ते हैं जो एक साथ बजने वाली ध्वनियों की संख्या को नियंत्रित करता है।

app.icf

 [SOUND] MaxChannels=16

प्रोजेक्ट फ़ाइल में निम्न विवरण जोड़ें।

mf.mkb

 #!/usr/bin/env mkb options { module_path="$MARMALADE_ROOT/examples" } subprojects { iw2d iwresmanager SoundEngine } ... files { ... [Data] (data) locale_en.group locale_ru.group sounds.group } assets { (data) background.png sprite.png music.mp3 (data-ram/data-gles1, data) locale_en.group.bin locale_ru.group.bin sounds.group.bin }

ध्वनि संसाधन समूह का वर्णन इस प्रकार होगा।

sounds.group

 CIwResGroup { name "sounds" "./sounds/menubutton.wav" "./sounds/sound.wav" CIwSoundSpec { name "menubutton" data "menubutton" vol 0.9 loop false } CIwSoundSpec { name "sound" data "sound" vol 0.9 loop false } CIwSoundGroup { name "sound_effects" maxPolyphony 8 killOldest true addSpec "menubutton" addSpec "sound" } }

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

ResourceManager.cpp

 void ResourceManager::init() { IwResManagerInit(); #ifdef IW_BUILD_RESOURCES IwGetResManager()->AddHandler(new CIwResHandlerWAV); #endif IwGetResManager()->LoadGroup("sounds.group"); if (Locale::getCurrentImageLocale() == elEnImage) { IwGetResManager()->LoadGroup("locale_en.group"); } if (Locale::getCurrentImageLocale() == elRuImage) { IwGetResManager()->LoadGroup("locale_ru.group"); } } void ResourceManager::release() { for (RIter p = res.begin(); p != res.end(); ++p) { delete p->second; } res.clear(); IwResManagerTerminate(); IwSoundTerminate(); }

Main.cpp में, ध्वनि सबसिस्टम के लिए अपडेट विधि में कॉल जोड़ना न भूलें:

main.cpp

 #include "Main.h" #include "s3e.h" #include "Iw2D.h" #include "IwGx.h" #include "IwSound.h" #include "ResourceManager.h" #include "TouchPad.h" #include "Desktop.h" #include "Scene.h" #include "Background.h" #include "Sprite.h" void init() { // Initialise Mamrlade graphics system and Iw2D module IwGxInit(); Iw2DInit(); // Init IwSound IwSoundInit(); // Set the default background clear colour IwGxSetColClear(0x0, 0x0, 0x0, 0); // Initialise the resource manager rm.init(); touchPad.init(); desktop.init(); } void release() { desktop.release(); touchPad.release(); // Shut down the resource manager rm.release(); Iw2DTerminate(); IwGxTerminate(); } int main() { init(); { Scene scene; new Background(&scene, "background.png", 1, elNothing); new Sprite(&scene, "sprite.png", 122, 100, 2, elNothing); desktop.setScene(&scene); int32 duration = 1000 / 25; // Main Game Loop while (!desktop.isQuitMessageReceived()) { // Update keyboard system s3eKeyboardUpdate(); // Update Iw Sound Manager IwGetSoundManager()->Update(); // Update touchPad.update(); uint64 timestamp = s3eTimerGetMs(); desktop.update(timestamp); // Clear the screen IwGxClear(IW_GX_COLOUR_BUFFER_F | IW_GX_DEPTH_BUFFER_F); touchPad.clear(); // Refresh desktop.refresh(); // Show the surface Iw2DSurfaceShow(); // Yield to the opearting system s3eDeviceYield(duration); } } release(); return 0; }

संसाधन समूह वर्णन से संकलित किए जाते हैं जब लोडग्रेग विधि को डीबगर के अंतर्गत चलाया जाता है। यदि हमने कुछ गलत किया है, तो हमें एक त्रुटि संदेश मिलता है:

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

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

app.icf

 [S3E] DataDirIsRAM=1

परिणामस्वरूप, डेटा निर्देशिका, जिसमें पहले केवल पढ़ने के लिए संसाधन फ़ाइलें होती हैं, लेखन योग्य हो जाती हैं। यह सुविधा क्रॉस-प्लेटफ़ॉर्म है और हम iOS और एंड्रॉइड दोनों पर एप्लिकेशन सेटिंग्स को स्टोर करने के लिए फाइलें बना सकते हैं। मैं संग्रहीत डेटा प्रबंधक के कार्यान्वयन को नहीं दूंगा, क्योंकि यह तुच्छ है। जो लोग स्वतंत्र रूप से यहां देख सकते हैं ।

यह ध्यान दिया जाना चाहिए कि DataDirIsRAM ध्वज सेट करने के बाद, Marmalade डेटा-gles1 निर्देशिका को डेटा-रैम से डेटा में संकलित समूह संसाधनों से युक्त करता है। यह डिबगर के तहत किसी भी तरह से काम को प्रभावित नहीं करता है, क्योंकि समूह लोड होने पर निर्देशिका स्वचालित रूप से बनाई जाती है, लेकिन यह इस तथ्य को जन्म दे सकता है कि मोबाइल डिवाइस (एंड्रॉइड या आईफोन) के लिए वितरण किट गलत तरीके से अप्रासंगिक संसाधनों के साथ बनाया जा सकता है। इसे होने से रोकने के लिए, आपको प्रोजेक्ट की mkb फ़ाइल में एक साधारण बदलाव करने की आवश्यकता है:

  ... - (data-ram/data-gles1, data) + (data-ram/data-gles1, data/data-gles1) locale_en.group.bin locale_ru.group.bin sounds.group.bin

मैं मुझे इस ओर इशारा करने के लिए मेज़ोमिश को धन्यवाद देना चाहता हूं।

अगले लेख में, हम फ्रेमवर्क के विकास को पूरा करेंगे और एक छोटे डेमो एप्लिकेशन का निर्माण करेंगे।

निम्नलिखित सामग्री का उपयोग मुरब्बा फ्रेमवर्क के विकास में किया गया था

मुरब्बा में ढांचा (भाग 3)

More articles: