परिचय
Pet एक छोटा एनिमेटेड किरदार है, जो फ़्रेम बदलने से चलता हुआ दिखता है। इसे भेजने पर आपका pet समुदाय की Pets गैलरी में शामिल हो सकता है, जहाँ दूसरे लोग भी इसे अपने प्रोजेक्ट में इस्तेमाल कर सकते हैं।
भेजने के दो तरीके हैं। सबसे आसान है Petdex का URL देना। दूसरा है अपनी स्प्राइटशीट और sprite.json को GitHub पर रखना और उसका लिंक भेजना। आप मौजूदा Petdex pet भेज सकते हैं या अपना नया किरदार बना सकते हैं। दोनों तरीकों के लिए PicoPixel में साइन इन करना होगा।
शुरू करने से पहले
- app.picopixel.io खोलें।
- Google या GitHub OAuth से साइन इन करें। अभी नहीं करेंगे तो भेजने से पहले ऐप साइन इन करने को कहेगा।
- बाएँ साइडबार में सबसे नीचे अपने खाते पर क्लिक करें।
- Your account चुनें।
- Submit Sprite खोलें।
यहाँ नीचे दिए गए दोनों विकल्प मिलेंगे।
कोई भी pet भेजने के लिए खाते में साइन इन होना ज़रूरी है।
Petdex से भेजें
Petdex एक अलग वेबसाइट है जहाँ pet ढूँढ सकते हैं, बना सकते हैं और होस्ट कर सकते हैं। हर pet का साझा करने योग्य URL ऐसा होता है: https://petdex.crafter.run/pets/<pet-id>।
- Petdex पर pet चुनें या बनाएँ और उसका URL कॉपी करें।
- Submit Sprite स्क्रीन में Submit via Petdex चुनें।
- Petdex URL फ़ील्ड में लिंक पेस्ट करें।
- ज़रूरी अतिरिक्त जानकारी हो तो Notes में लिखें। यह वैकल्पिक है।
- फ़ॉर्म भेजें।
यह सबसे तेज़ तरीका है और ऐप में RECOMMENDED तथा FASTEST के रूप में दिखता है। आपको केवल pet का URL देना है।
GitHub से भेजें
अपनी फ़ाइलें खुद होस्ट करते हैं तो यह तरीका चुनें:
- स्प्राइटशीट इमेज और उससे मेल खाती
sprite.jsonको सार्वजनिक GitHub रिपॉज़िटरी में रखें। - Submit Sprite स्क्रीन में Submit via GitHub चुनें।
- रिपॉज़िटरी का URL (
https://github.com/...) पेस्ट करें। - Credits / Author में निर्माता का नाम लिखें।
- Notes में वैकल्पिक जानकारी दें और फ़ॉर्म भेजें।
स्प्राइटशीट और sprite.json नीचे बताए फ़ॉर्मेट में होने चाहिए।
अपना नया pet बनाएँ
आप मौजूदा pet की जगह अपना मौलिक किरदार बना सकते हैं। OpenAI Codex जैसे AI टूल या AI इमेज जनरेटर से शुरुआत करके स्प्राइटशीट तैयार की जा सकती है।
स्प्राइटशीट एक PNG या WebP इमेज होती है। उसके फ़्रेम समान आकार की ग्रिड में रखे जाते हैं, जिसे atlas कहते हैं। हर पंक्ति में एक एनिमेशन रखें।
हर फ़्रेम की चौड़ाई और ऊँचाई बिल्कुल समान रखें। अलग आकार की कोशिकाओं वाली ग्रिड सही नहीं कटेगी और एनिमेशन उछल सकता है या बिगड़ सकता है।
sprite.json इस शीट की जानकारी देता है। इसके दो मुख्य हिस्से हैं:
- atlas: ग्रिड की बनावट —
columns,rows,frameWidthऔरframeHeight। - states: एनिमेशन की सूची। हर स्थिति में
id,label,row,framesऔर वैकल्पिकdurationMs,groupतथाcaptionहोते हैं।
आम स्थितियाँ हैं: idle, wave, jump, run-right, run-left, running, waiting, failed और review। स्प्राइट में कम से कम दो स्थितियाँ चाहिए, जैसे idle और एक चलने वाला एनिमेशन।
पहले समान आकार के फ़्रेम बनाएँ। उन्हें ग्रिड में इस तरह रखें कि हर पंक्ति में एक एनिमेशन हो। फिर ग्रिड और स्थितियों की जानकारी sprite.json में लिखें और Petdex या GitHub से भेजें।
स्थितियों, फ़्रेम और दोबारा इस्तेमाल के बारे में LVGL स्प्राइट गाइड में और पढ़ें।
भेजने के बाद क्या होता है?
PicoPixel टीम आपके pet की समीक्षा करती है। कोई बात स्पष्ट करनी हो तो आपसे संपर्क कर सकती है। स्वीकार होने पर pet Pets गैलरी में आपके नाम के साथ दिखाई देता है, जहाँ समुदाय के लोग उसे ढूँढ और इस्तेमाल कर सकते हैं।
आगे क्या पढ़ें
- LVGL स्प्राइट: स्थितियाँ और फ़्रेम कैसे काम करते हैं।
- इवेंट एडिटर: अपने डिज़ाइन में इंटरैक्शन जोड़ें।
- टेम्पलेट भेजें: अपना PicoPixel डिज़ाइन साझा करें।
- सामग्री की रिपोर्ट करें: किसी pet या टेम्पलेट में समस्या बताएँ।
- Pets गैलरी: समुदाय के pet देखें।
