एसडीएल 2.0 सबक चक्र: पाठ 3 - एसडीएल एक्सटेंशन लाइब्रेरी

अनुवादक से:

मैं मूल रूप से यहाँ उपलब्ध Twinklebear से ट्यूटोरियल के अनुवादों की परित्यक्त श्रंखला को जारी रखता हूँ, जो कि InvalidPointer श्रृंखला के पिछले पाठों के अनुवादक की अनुमति के साथ है। सूची में अनुवाद की एक श्रृंखला के पहले दो पाठ उनके लेखकीय हैं। अनुवाद आंशिक रूप से स्वतंत्र है और इसमें अनुवादक से मामूली संशोधन या परिवर्धन हो सकता है।

सबक की सूची:

• पाठ 1. हैलो वर्ल्ड!
• पाठ 2. मुख्य रूप से सब कुछ सामान न करें
• पाठ 3. एसडीएल एक्सटेंशन लाइब्रेरी
• पाठ 4. इवेंट हैंडलिंग
• पाठ 5-6 - जारी रखा जाए

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

इस बिंदु तक, हमने केवल बीएमपी छवियों का उपयोग किया है, क्योंकि यह एसडीएल 2 कोर लाइब्रेरी द्वारा समर्थित एकमात्र छवि प्रकार है, और यह बहुत सुविधाजनक नहीं है। सौभाग्य से, कई एसडीएल एक्सटेंशन लाइब्रेरी हैं जो उपयोगी सुविधाओं को जोड़ते हैं, उदाहरण के लिए, SDL_image आपको कई प्रकार की छवियां लोड करने की अनुमति देता है, SDL_ttf टीटीएफ फोंट का उपयोग करने के लिए पाठ प्रदान करने के लिए समर्थन जोड़ता है, निम्न-स्तरीय समर्थन के लिए SDL_net और मल्टी-चैनल ऑडियो आउटपुट के लिए SDL_mixer।

एक्सटेंशन स्थापित करें

इस ट्यूटोरियल में हम केवल SDL_image का उपयोग करेंगे, हालांकि, अन्य एक्सटेंशन के लिए इंस्टॉलेशन प्रक्रिया अलग नहीं है, और, सामान्य तौर पर, एसडीएल 2 को स्थापित करने के लिए लगभग उसी के साथ मेल खाता है।

• विंडोज (MinGW या विजुअल स्टूडियो): एक्सटेंशन प्रोजेक्ट पेज से डाउनलोड की गई एक्सटेंशन फाइलों को SDL2 वाले फोल्डर में रखें। इसके अलावा, आपको SDL2_image, zlib और अन्य .dll फ़ाइलों (उदाहरण के लिए, libpng) को अपनी निष्पादन योग्य फ़ाइल (या C: \ Windows \ system32 - लगभग प्रति। ) के साथ फ़ोल्डर में कॉपी करने की आवश्यकता है ताकि आवेदन शुरू होने पर वे लोड हो जाएं।
• लिनक्स : अपने इन-हाउस पैकेज मैनेजर का उपयोग करके एक्सटेंशन इंस्टॉल करें, या स्रोत से निर्माण करें। यदि आपके पास लिनक्स है - तो सबसे अधिक संभावना है कि आप पहले से ही जानते हैं कि यह कैसे करना है।
• Mac : आधिकारिक वेबसाइट से .dmg डाउनलोड करें और Readme में दिए गए निर्देशों का पालन करें।

इसके अलावा, एक्सटेंशन का उपयोग करने के लिए, आपको उपयोग की गई हेडर फ़ाइलों और प्लग-इन पुस्तकालयों की सूची को अपडेट करना होगा, ठीक उसी तरह जैसे कि यह SDL2 के लिए किया गया था।

एक्सटेंशन के साथ काम करना शुरू करने से पहले, आपको SDL2 / SDL_image.h> फ़ाइल, या वांछित एक्सटेंशन के नाम से संबंधित फ़ाइल को कनेक्ट करने की आवश्यकता है, SDL के हेडर फ़ाइल के बाद ही .c और .cl फ़ाइलों का उपयोग करके।

प्रारंभिक SDL_image (वैकल्पिक)

पहली बार जब आप प्रत्येक प्रकार की छवि को लोड करते हैं, तो SDL_image स्वचालित रूप से इस प्रकार के लिए आवश्यक सबसिस्टम को प्रारंभ करता है, हालाँकि, इससे थोड़ी देरी होगी। इससे बचने के लिए, आप IMG_Init फ़ंक्शन का उपयोग करके आवश्यक सबसिस्टम को प्री-इनिशियलाइज़ कर सकते हैं। IMG_Init इस समय सभी उपतंत्रों की एक सूची के साथ एक बिटमास्क लौटाता है, जिसे इस समय सफलतापूर्वक आरम्भ कर दिया गया है, इसलिए कॉल की सफलता को सत्यापित करने के लिए, आपको यह जाँचने की आवश्यकता है कि आरंभ के लिए संकेतित सभी उपप्रणालियों के लिए बिट्स सेट किए गए हैं, उदाहरण के लिए, बिटवाइज़ I. परिणाम के लिए एक मुखौटा लागू करने के लिए, इस पाठ के लिए, हमें केवल एक उपतंत्र की आवश्यकता है। पीएनजी। SDL_Init के बाद इस ऑपरेशन को अंजाम देना महत्वपूर्ण है।

if ((IMG_Init(IMG_INIT_PNG) & IMG_INIT_PNG) != IMG_INIT_PNG) { logSDLError(std::cout, "IMG_Init"); SDL_Quit(); return 1; } 

आयाम सेट करें

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

लेकिन पहले, चलो खिड़की के आकार के लिए स्थिरांक के ठीक नीचे टाइल के आकार के लिए एक स्थिर सेट करते हैं।

 const int SCREEN_WIDTH = 640; const int SCREEN_HEIGHT = 480; //     const int TILE_SIZE = 40; 

SDL_image का उपयोग करके छवियां अपलोड करना

SDL_image आपको कई प्रकार की छवियों को लोड करने की अनुमति देता है, साथ ही तुरंत उन्हें IML_LoadTexture फ़ंक्शन के साथ SDL_Texture में परिवर्तित करता है। यह फ़ंक्शन पिछले पाठ से लोडटेक्स्टचर फ़ंक्शन के लगभग सभी कोड को बदल देता है, अब केवल IMG_LoadTexture को कॉल करें, जांचें कि क्या लोडिंग के दौरान कोई त्रुटि थी, और फ़ंक्शन से बाहर निकलें। चूंकि फ़ंक्शन SDG_image में परिभाषित IMG_GetError SDL_GetError के पर्याय से अधिक कुछ नहीं है, हम उनमें से किसी का भी उपयोग कर त्रुटि संदेश प्रदर्शित कर सकते हैं।

 /** *       * @param file    * @param ren ,        * @return  ,  nullptr   . */ SDL_Texture* loadTexture(const std::string &file, SDL_Renderer *ren) { SDL_Texture *texture = IMG_LoadTexture(ren, file.c_str()); if (!texture) { std::cout << IMG_GetError(); //    SDL_GetError() } return texture; } 

प्रतिपादन के लिए ऊंचाई और चौड़ाई निर्दिष्ट करें

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

 /** *  SDL_Texture  SDL_Renderer   x, y,   * @param tex    * @param ren  * @param x  * @param y * @param w     * @param h */ void renderTexture(SDL_Texture *tex, SDL_Renderer *ren, int x, int y, int w, int h) { SDL_Rect dst; dst.x = x; dst.y = y; dst.w = w; dst.h = h; SDL_RenderCopy(ren, tex, NULL, &dst); } /** *  SDL_Texture  SDL_Renderer   x, y,   * @param tex  * @param ren  * @param x  * @param y */ void renderTexture(SDL_Texture *tex, SDL_Renderer *ren, int x, int y) { int w, h; SDL_QueryTexture(tex, NULL, NULL, &w, &h); renderTexture(tex, ren, x, y, w, h); } 

लोड हो रहा है बनावट

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

हम इन चित्रों का उपयोग करेंगे:

पृष्ठभूमि भरने के लिए टाइल:



अग्रभूमि की छवि (जैसा कि उस पर लिखा गया है, एक पारदर्शी पृष्ठभूमि के साथ, साथ ही फिर से इमोटिकॉन्स के साथ जो कि हैबर नियमों का उल्लंघन करते हैं):



चित्र अपलोड करना:

 SDL_Texture *background = loadTexture("background.png", renderer); SDL_Texture *image = loadTexture("image.png", renderer); //  if (!background || !image) { //  ,      cleanup(),   PS   ,     ,  ,    . SDL_DestroyTexture(background); SDL_DestroyTexture(image); SDL_DestroyRenderer(renderer); SDL_DestroyWindow(window); IMG_Quit(); SDL_Quit(); return 1; } 

टाइलिंग पृष्ठभूमि

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

हम यह पता लगा सकते हैं कि टाइल के आकार से खिड़की की चौड़ाई को विभाजित करके चौड़ाई में कितनी टाइलें आवश्यक हैं, और इसी तरह ऊंचाई के लिए।

 //   ,      //  :     ceil(float(SCREEN_WIDTH) / TILE_SIZE),    ,       ,      ; ,        ,     . int xTiles = SCREEN_WIDTH / TILE_SIZE; int yTiles = SCREEN_HEIGHT / TILE_SIZE; //   for (int i = 0; i < xTiles * yTiles; ++i) { int x = i % xTiles; int y = i / xTiles; renderTexture(background, renderer, x * TILE_SIZE, y * TILE_SIZE, TILE_SIZE, TILE_SIZE); } 

अग्रभूमि छवि खींचना

पहले की तरह, अग्रभूमि छवि को खिड़की के बीच में रखा गया है।

 int iW, iH; SDL_QueryTexture(image, NULL, NULL, &iW, &iH); int x = SCREEN_WIDTH / 2 - iW / 2; int y = SCREEN_HEIGHT / 2 - iH / 2; renderTexture(image, renderer, x, y); 

यह केवल परिणाम को खिड़की पर प्रदर्शित करने और सेकंड के एक जोड़े का इंतजार करने के लिए बना रहता है, ठीक दूसरे पाठ की तरह।

 SDL_RenderPresent(renderer); SDL_Delay(2000); 

सफाई

संसाधनों की रिहाई पाठ 2 के समान है (और पहले से ही ऊपर देखा गया है जब एक छवि लोड करने में त्रुटि को संसाधित करते हुए), अतिरिक्त कॉल IMG_Quit को छोड़कर।

 SDL_DestroyTexture(background); SDL_DestroyTexture(image); SDL_DestroyRenderer(renderer); SDL_DestroyWindow(window); IMG_Quit(); SDL_Quit(); 

सफल संकलन और लॉन्च के बाद, अगर आपने सब कुछ सही ढंग से किया, तो खिड़की कुछ इस तरह दिखाई देगी:

तीसरे पाठ का अंत

तो अगला पाठ समाप्त हुआ। पाठ 4 में देखें: हैंडलिंग इवेंट्स।