सारांश
इस लेख में बताया गया है कि किसी शेल्फ आइटम को कैसे संपादित या अनुकूलित किया जाए, साथ ही यदि आवश्यक हो तो उसे हटाने की प्रक्रिया भी बताई गई है।
यदि आप पहली बार शेल्फ आइटम सेट अप करना चाह रहे हैं, तो कृपया Q100401 में दिए गए चरणों और जानकारी का पालन करें: आसानी से सुलभ कस्टम पायथन स्क्रिप्ट प्रदान करने के लिए Katana में शेल्फ आइटम कैसे बनाएं ।
शेल्फ आइटम संपादित करना
एक शेल्फ आइटम को बनाने के बाद Katana में शेल्फ आइटम पायथन स्क्रिप्ट तक पहुंच कर संपादित किया जा सकता है, या अपने .katana और संबंधित शेल्फ, ShelvesNodeSpecific या ShelvesScenegraph निर्देशिका पर नेविगेट करके, और वहां स्क्रिप्ट का पता लगाकर संपादित किया जा सकता है।
1. Katana में अपनी स्क्रिप्ट तक पहुंचने के लिए, अपना शेल्फ एक्शन खोलें, वांछित शेल्फ आइटम का चयन करें और ' स्रोत देखें ' पर राइट क्लिक करें:
इससे शेल्फ आइटम पायथन स्क्रिप्ट एक टेक्स्ट एडिटर में खुल जाएगी जैसे:
2. Katana के बाहर अपनी स्क्रिप्ट तक पहुँचने के लिए, अपने .katana/Shelves , .katana/ShelvesNodeSpecific या .katana/ShelvesScenegraph फ़ोल्डर पर जाएँ, और संबंधित .py फ़ाइल का पता लगाएँ।
यह उन निर्देशिकाओं में से किसी एक के उप-फ़ोल्डर में होगा, जिसका नाम आपके शेल्फ़ आइटम के नाम पर रखा गया है। वहाँ से आप फ़ाइल को मनचाहे पायथन एडिटर में खोल सकते हैं।
शेल्फ आइटम स्क्रिप्ट के डॉकस्ट्रिंग्स
यदि आपने Q100401: आसानी से सुलभ कस्टम पायथन स्क्रिप्ट प्रदान करने के लिए Katana में शेल्फ आइटम कैसे बनाएं में वर्णित प्रक्रिया का उपयोग करके शेल्फ आइटम स्क्रिप्ट बनाई है, तो इसमें डिफ़ॉल्ट रूप से एक डॉकस्ट्रिंग होगी जो इस तरह दिखाई देगी:
""" NAME: <the name of the script to show in the UI> ICON: <the filename of icon to use in the UI>
KEYBOARD_SHORTCUT: <the keyboard shortcut to use in the UI to run the Shelf Item Script> SCOPE: <names of types of nodes to target by node-specific shelf items> <description> """
इसमें आपकी स्क्रिप्ट के बारे में नीचे दी गई विस्तृत जानकारी दी गई है:
- NAME वह नाम है जो आपका स्क्रिप्ट आइटम शेल्फ़ एक्शन में प्रदर्शित करता है
- ICON आपके द्वारा चुने गए आइकन का छवि स्थान है। (नीचे विस्तार से चर्चा की गई है)
- KEYBOARD_SHORTCUT वह शॉर्टकट है जिसके साथ आपका स्क्रिप्ट आइटम चलाया जा सकता है
- SCOPE का उपयोग विशिष्ट नोड प्रकारों को परिभाषित करने के लिए किया जाता है जिन पर शेल्फ आइटम लागू होता है
- <विवरण> शेल्फ़ आइटम के लिए आपकी सहायता टूलटिप है
नोट: अपने कस्टम शेल्फ़ आइटम के लिए कीबोर्ड शॉर्टकट सेट करते समय, आप Katana में पहले से मौजूद शॉर्टकट का उपयोग नहीं कर पाएँगे। एक चेतावनी दिखाई देगी, और Katana के डिफ़ॉल्ट कीबोर्ड शॉर्टकट की सूची कीबोर्ड शॉर्टकट संसाधन में देखी जा सकती है।
शेल्फ आइटम स्क्रिप्ट का संपादन
यह दिखाने के लिए कि उपरोक्त डॉकस्ट्रिंग का उपयोग कैसे किया जा सकता है, नीचे दी गई शेल्फ आइटम स्क्रिप्ट को एक रिक्त .py फ़ाइल में कॉपी करें, और इसे .katana/Shelves/Custom_Shelves/ निर्देशिका में सहेजें:
"""
NAME: Float Selected
ICON: Icons\Scenegraph\locator32.png
KEYBOARD_SHORTCUT: T
SCOPE: none
Float Selected Nodes via Keyboard Shortcut
"""
# Get list of selected nodes
nodeList = NodegraphAPI.GetAllSelectedNodes()
# Find Nodegraph tab and float nodes
nodegraphTab = UI4.App.Tabs.FindTopTab('Node Graph')
if nodegraphTab:
nodegraphTab.floatNodes(nodeList)
स्क्रिप्ट को सहेजने के बाद, Katana शेल्फ एक्शन मेनू के भीतर ' जोड़ें -> शेल्फ पुनः लोड करें' के माध्यम से शेल्फ को पुनः लोड करें।
आपका शेल्फ आइटम कस्टम कीबोर्ड शॉर्टकट, आइकन और सहायता टूलटिप के साथ 'फ्लोट चयनित' के रूप में प्रदर्शित होना चाहिए:
शेल्फ आइटम स्क्रिप्ट की कार्यक्षमता, कीबोर्ड शॉर्टकट (T) के साथ ट्रिगर करने पर या शेल्फ एक्शन मेनू से शेल्फ आइटम का चयन करके, वर्तमान में चयनित किसी भी नोड को फ्लोट करने के लिए है।
फ्लोटेड नोड्स आपके कर्सर का तब तक अनुसरण करेंगे जब तक आप उन्हें छोड़ने के लिए बायाँ-क्लिक नहीं करते, जिससे आपको चयनित नोड्स या बैकड्रॉप्स को मैन्युअल रूप से क्लिक करने और खींचने की आवश्यकता नहीं होगी।
समान पायथन फ़ंक्शनों को एक साथ रखने के बारे में अधिक जानकारी डेवलपर गाइड डेवलपर गाइड में उदाहरण स्क्रिप्ट में पाई जा सकती है।
अपना शेल्फ आइटम आइकन चुनना
शेल्फ एक्शन मेनू में प्रदर्शित अपने शेल्फ आइटम के आइकन को बदलने के लिए, आप निम्न स्थान से Katana के डिफ़ॉल्ट आइकन में से एक चुन सकते हैं: $KATANA_HOME\bin\python\UI4\Resources\Icons
अपने शेल्फ़ आइटम के लिए Katana में उपलब्ध आइकन में से किसी एक का उपयोग करने के लिए, आपको Katana के डिफ़ॉल्ट संसाधन खोज पथ के बाद आइकन का पथ निर्दिष्ट करना होगा। Katana का डिफ़ॉल्ट संसाधन खोज पथ $KATANA_HOME\bin\python\UI4\Resources है। उदाहरण के लिए:
आइकन: Icons\Scenegraph\locator32.png
नोट: यदि आप अन्य कस्टम आइकन का उपयोग करना चाहते हैं, तो आपको पायथन स्क्रिप्ट के ICON अनुभाग में पूर्ण आइकन पथ जोड़ना होगा।
एक शेल्फ हटाना
अगर आप शेल्फ़ एक्शन से किसी शेल्फ़ को हटाना चाहते हैं, तो आप अपने .katana\Shelves फ़ोल्डर से शेल्फ़ फ़ोल्डर को हटाकर ऐसा कर सकते हैं। अगर आपने Katana खोल रखा है और बदलाव देखना चाहते हैं या ड्रॉप-डाउन शेल्फ़ से शेल्फ़ हटाना चाहते हैं, तो Reload Shelf पर क्लिक करें, और .katana/shelf फ़ाइलों में किए गए सभी बदलाव आपके Katana सीन पर अपडेट हो जाएँगे।
नोट: यदि आप शेल्फ का नाम बदलना चाहते हैं, तो यह आपकी .katana/shelf फ़ाइल का पता लगाकर और फिर फ़ोल्डर [कस्टम फ़ोल्डर] का नाम बदलकर किया जा सकता है।
शेल्फ आइटम हटाना
यदि आप किसी शेल्फ़ आइटम को हटाना चाहते हैं, तो शेल्फ़ आइटम स्क्रिप्ट वाली पायथन फ़ाइल को हटाकर या शेल्फ़ एक्शन पॉप-अप मेनू का उपयोग करके ऐसा किया जा सकता है। Katana से सेल्फ़ आइटम हटाने के लिए:
शेल्फ एक्शन मेनू पर जाएं और उस शेल्फ आइटम पर राइट क्लिक करें जिसे आप हटाना चाहते हैं, फिर 'हटाएं... ' चुनें।
दबाने पर, एक पॉप-अप विंडो आपसे हटाने की पुष्टि करने के लिए कहेगी। शेल्फ आइटम हटाने के लिए डिलीट पर क्लिक करें।
नोट: जैसा कि ऊपर पॉप-अप विंडो में दिखाया गया है, Katana शेल्फ आइटम स्क्रिप्ट को नहीं हटाएगा, बल्कि इसके बजाय एक्सटेंशन ' .bak ' जोड़ देगा, इसलिए स्क्रिप्ट अब Katana में लोड नहीं होगी।
इसे बैकअप फ़ाइल के रूप में सहेजा जाएगा, ताकि आवश्यकता पड़ने पर इसे पुनर्स्थापित किया जा सके।
यदि आप इसे अपने शेल्फ में वापस जोड़ना चाहते हैं, तो इसके स्थान पर जाएं और ' .bak ' एक्सटेंशन को हटा दें और शेल्फ आइटम स्क्रिप्ट लोड हो जाएगी और प्रयोग करने योग्य हो जाएगी।
नोट: .bak को हटाने के बाद, शेल्फ एक्शन पर जाएं और 'Add->Reload... ' का उपयोग करें ताकि Katana आपके सत्र में प्रदर्शन के लिए सभी उपलब्ध शेल्फ आइटम को पुनः लोड कर दे।
अग्रिम पठन
Katana में शेल्फ़ आइटम स्क्रिप्ट के अवलोकन के लिए, कृपया शेल्फ़ आइटम स्क्रिप्ट उपयोगकर्ता मार्गदर्शिका देखें।
यदि आप पहली बार शेल्फ आइटम सेट अप कर रहे हैं, तो कृपया Q100401 देखें: आसानी से सुलभ कस्टम पायथन स्क्रिप्ट प्रदान करने के लिए Katana में शेल्फ आइटम कैसे बनाएं ।
हम चाहते हैं कि खेद व्यक्त करते हैं
कृपया हमें बताएँ कि