SDL 2.0 पाठ चक्र: पाठ 1

अनुवादक से: लेखों की एक श्रृंखला से प्रेरित होकर, मैंने एसडीएल में अपना हाथ आजमाने का फैसला किया। हां, यह दुर्भाग्यपूर्ण है, मैं रूसी में एसडीएल संस्करण 2.0 पर कोई समझदार सबक नहीं पा सका। इसने मुझे यहां उपलब्ध मूल में ट्विंकलबर ट्यूटोरियल की अद्भुत श्रृंखला का अनुवाद करने के लिए प्रेरित किया।

आपका स्वागत है!

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

यदि आपको उदाहरणों में कोड को पार्स करने में कठिनाई हो रही है, तो StackOverflow पर इस अद्भुत सूची में से किसी एक पुस्तक का उपयोग करें।

यदि आप पूर्ण स्रोत देखना चाहते हैं या पाठ के लिए संसाधन डाउनलोड करना चाहते हैं, तो यह सब GitHub पर प्राप्त किया जा सकता है । लेकिन नकल मत करो!

इस विकी पर पढ़ने के लिए SDL 2.0 प्रलेखन भी उपलब्ध है।

पाठ 1: हैलो वर्ल्ड!

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

SDL लॉन्च

पहला कदम आमतौर पर एसडीएल हेडर फ़ाइल को शामिल करना है।

#include <SDL2/SDL.h> 

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

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

 if (SDL_Init(SDL_INIT_EVERYTHING) != 0){ std::cout << "SDL_Init Error: " << SDL_GetError() << std::endl; return 1; } 

खिड़की खोलना

हमें एक विंडो की आवश्यकता है ताकि हम इसे रेंडर पर प्रदर्शित कर सकें। हम इसे SDL_CreateWindow फ़ंक्शन का उपयोग करके बना सकते हैं, जो विंडो पैरामीटर सेट करने के लिए विंडो, उसके निर्देशांक, ऊंचाई, चौड़ाई और कुछ झंडे का नाम लेता है। यह फ़ंक्शन SDL_Window * लौटाता है। यह पॉइंटर NULL होगा यदि विंडो बनाते समय कुछ गलत हो जाता है।

 SDL_Window *win = SDL_CreateWindow("Hello World!", 100, 100, 640, 480, SDL_WINDOW_SHOWN); if (win == nullptr){ std::cout << "SDL_CreateWindow Error: " << SDL_GetError() << std::endl; return 1; } 

रेंडरर क्रिएशन

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

 SDL_Renderer *ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC); if (ren == nullptr){ std::cout << "SDL_CreateRenderer Error: " << SDL_GetError() << std::endl; return 1; } 

बीएमपी छवि अपलोड

BMP छवि रेंडर करने के लिए, हमें पहले इसे मेमोरी में लोड करना होगा, और फिर रेंडरिंग डिवाइस में जिसे हम उपयोग करते हैं (इस मामले में, GPU)। हम SDL_LoadBMP का उपयोग करके छवि लोड कर सकते हैं। यह फ़ंक्शन SDL_Surface * लौटाता है, जिसे हम SDL_Texture में लोड कर सकते हैं ताकि इसे रेंडरर द्वारा उपयोग किया जा सके।

SDL_LoadBMP हमारी छवि के लिए पथ लेता है, जिसे आपको अपनी परियोजना की संरचना में फिट करने के लिए बदलना होगा, और यदि कोई त्रुटि हो तो SDL_Surface * या NULL लौटाता है।

 SDL_Surface *bmp = SDL_LoadBMP("../res/Lesson1/hello.bmp"); if (bmp == nullptr){ std::cout << "SDL_LoadBMP Error: " << SDL_GetError() << std::endl; return 1; } 

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

 SDL_Texture *tex = SDL_CreateTextureFromSurface(ren, bmp); SDL_FreeSurface(bmp); if (tex == nullptr){ std::cout << "SDL_CreateTextureFromSurface Error: " << SDL_GetError() << std::endl; return 1; } 

बनावट प्रतिपादन

स्क्रीन पर हमारी बनावट पाने के लिए बस इतना करना बाकी है! पहले हम रेंडरर को साफ करते हैं , उसके बाद हम बनावट को प्रस्तुत करते हैं , और फिर हम परिणाम को देखने के लिए अद्यतन स्क्रीन दिखाते हैं। चूंकि हम पूरी छवि को रेंडर करना चाहते हैं और स्क्रीन को फिट करने के लिए इसे खिंचाव बनाते हैं, इसलिए हम NULL को स्रोत के रूप में पास करेंगे और SDL_RenderCopy के लिए आयतों को लक्ष्य करेंगे। हम कार्यक्रम समाप्त होने तक परिणाम देखने के लिए कुछ समय के लिए खिड़की को खुला रखना चाहते हैं, इसलिए हम SDL_Delay कॉल जोड़ेंगे ।

 SDL_RenderClear(ren); SDL_RenderCopy(ren, tex, NULL, NULL); SDL_RenderPresent(ren); SDL_Delay(2000); 

कचरा संग्रह

बाहर निकलने से पहले, हमें विभिन्न SDL_DestroyX फ़ंक्शंस के साथ बनाई गई सभी वस्तुओं को नष्ट करना होगा और SDL को पूरा करना होगा।

 SDL_DestroyTexture(tex); SDL_DestroyRenderer(ren); SDL_DestroyWindow(win); SDL_Quit(); 

पाठ का अंत

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

जल्द ही आपको पाठ 2 में देखें : मुख्य रूप से सब कुछ धक्का न दें ।