👩🏾‍🎤 🍜 👨🏿‍⚖️ संपादक विंडो, स्क्रिप्ट करने योग्य वस्तु और कस्टम संपादक के साथ एकता संपादक का विस्तार 🛵 🙍🏼 🍴

सभी को नमस्कार! मेरा नाम ग्रिशा है और मैं CGDevs का संस्थापक हूं। आज मैं संपादक एक्सटेंशन के बारे में बात करना चाहता हूं और अपनी एक परियोजना के बारे में बात करना चाहता हूं, जिसे मैंने ओपनसोर्स में पोस्ट करने का फैसला किया है।

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

संपादक की क्षमताओं का विस्तार करने के लिए यूनिटी 3 डी के पास एक विस्तृत पर्याप्त टूलबॉक्स है। EditorWindow जैसी कक्षाओं के लिए धन्यवाद, साथ ही कस्टम इंस्पेक्टर , प्रॉपर्टी ड्रावर और ट्री व्यू (+ यूआईईएलएस को जल्द ही दिखाई देना चाहिए) की कार्यक्षमता के लिए, यूनिट के शीर्ष पर जटिलता की डिग्री के अपने फ्रेमवर्क का निर्माण करना आसान है।

आज हम उन दृष्टिकोणों में से एक के बारे में बात करेंगे जो मैंने अपने समाधान को विकसित करने और कुछ दिलचस्प समस्याओं के बारे में बताया था, जिनका मुझे सामना करना पड़ा था।

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

संपादक एक्सटेंशन विकसित करते समय, इस सिद्धांत का पालन करने की कोशिश करना महत्वपूर्ण है कि एकता डेवलपर्स एक्सटेंशन का उपयोग करेंगे, इसलिए इंटरफेस स्पष्ट, देशी होना चाहिए और एकता वर्कफ़्लो में एकीकृत होना चाहिए।

चलो दिलचस्प कार्यों के बारे में बात करते हैं।

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

एकता में कई शैलियों हैं जो खिड़की के रंगों को प्रभावित करती हैं।

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

एक निश्चित रंग

GUI.color = BgColor; GUI.DrawTexture(new Rect(Vector2.zero, maxSize), EditorGUIUtility.whiteTexture); GUI.color = Color.white;

संक्षेप में, हमने पूरी विंडो में BgColor रंग बनावट को आकर्षित किया।

ग्रिड को ड्रा और मूव करें

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

स्क्रीन निर्देशांक के लिए विंडो निर्देशांक परिवर्तित करना

 public Vector2 GUIToGrid(Vector3 vec) { Vector2 newVec = ( new Vector2(vec.x, -vec.y) - new Vector2(_ParentWindow.position.width / 2, -_ParentWindow.position.height / 2)) * _Zoom + new Vector2(_Offset.x, -_Offset.y); return newVec.RoundCoordsToInt(); } public Vector2 GridToGUI(Vector3 vec) { return (new Vector2(vec.x - _Offset.x, -vec.y - _Offset.y) ) / _Zoom + new Vector2(_ParentWindow.position.width / 2, _ParentWindow.position.height / 2); }

जहाँ _ParentWindow वह विंडो है जिसमें हम ग्रिड खींचने जा रहे हैं, _Offset ग्रिड की वर्तमान स्थिति है, और _Zoom सन्निकटन की डिग्री है।

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

ड्राइंग ड्राइंग

 void DrawLODLines(int level) { var gridColor = SkinManager.Instance.CurrentSkin.GridColor; var step0 = (int) Mathf.Pow(10, level); int halfCount = step0 * CELLS_IN_LINE_COUNT / 2 * 10; var length = halfCount * DEFAULT_CELL_SIZE; int offsetX = ((int) (_Offset.x / DEFAULT_CELL_SIZE)) / (step0 * step0) * step0; int offsetY = ((int) (_Offset.y / DEFAULT_CELL_SIZE)) / (step0 * step0) * step0; for (int i = -halfCount; i <= halfCount; i += step0) { Handles.color = new Color(gridColor.r, gridColor.g, gridColor.b, 0.3f); Handles.DrawLine( GridToGUI(new Vector2(-length + offsetX * DEFAULT_CELL_SIZE, (i + offsetY) * DEFAULT_CELL_SIZE)), GridToGUI(new Vector2(length + offsetX * DEFAULT_CELL_SIZE, (i + offsetY) * DEFAULT_CELL_SIZE)) ); Handles.DrawLine( GridToGUI(new Vector2((i + offsetX) * DEFAULT_CELL_SIZE, -length + offsetY * DEFAULT_CELL_SIZE)), GridToGUI(new Vector2((i + offsetX) * DEFAULT_CELL_SIZE, length + offsetY * DEFAULT_CELL_SIZE)) ); } offsetX = (offsetX / (10 * step0)) * 10 * step0; offsetY = (offsetY / (10 * step0)) * 10 * step0; ; for (int i = -halfCount; i <= halfCount; i += step0 * 10) { Handles.color = new Color(gridColor.r, gridColor.g, gridColor.b, 1); Handles.DrawLine( GridToGUI(new Vector2(-length + offsetX * DEFAULT_CELL_SIZE, (i + offsetY) * DEFAULT_CELL_SIZE)), GridToGUI(new Vector2(length + offsetX * DEFAULT_CELL_SIZE, (i + offsetY) * DEFAULT_CELL_SIZE)) ); Handles.DrawLine( GridToGUI(new Vector2((i + offsetX) * DEFAULT_CELL_SIZE, -length + offsetY * DEFAULT_CELL_SIZE)), GridToGUI(new Vector2((i + offsetX) * DEFAULT_CELL_SIZE, length + offsetY * DEFAULT_CELL_SIZE)) ); } }

लगभग सब कुछ ग्रिड के लिए तैयार है। उनका आंदोलन बहुत सरलता से वर्णित है। _Offset अनिवार्य रूप से वर्तमान "कैमरा" स्थिति है।

ग्रिड आंदोलन

  public void Move(Vector3 dv) { var x = _Offset.x + dv.x * _Zoom; var y = _Offset.y + dv.y * _Zoom; _Offset.x = x; _Offset.y = y; }

प्रोजेक्ट में ही, आप सामान्य रूप से विंडो कोड से खुद को परिचित कर सकते हैं और देख सकते हैं कि विंडो में बटन कैसे जोड़े जा सकते हैं।

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

अपार्टमेंट वर्ग का हिस्सा

  public class Apartment : ScriptableObject { #region fields public float Height; public bool IsGenerateOutside; public Material OutsideMaterial; public Texture PlanImage; [SerializeField] private List<Room> _Rooms; [SerializeField] private Rect _Dimensions; private Vector2[] _DimensionsPoints = new Vector2[4]; #endregion

संपादक में, यह वर्तमान संस्करण में ऐसा दिखता है:

यहाँ, बेशक, CustomEditor पहले ही लागू किया जा चुका है, लेकिन फिर भी, आप देख सकते हैं कि संपादक में _Dimensions, Height, IsGenerateOutside, OutsideMaterial और PlanImage जैसे पैरामीटर प्रदर्शित किए जाते हैं।

सभी सार्वजनिक फ़ील्ड और [SerializeField] से चिह्नित फ़ील्ड क्रमबद्ध हैं (जो इस मामले में एक फ़ाइल में सहेजे गए हैं)। यदि आपको चित्र सहेजने की आवश्यकता है, तो यह बहुत मदद करता है, लेकिन ScriptableObject के साथ काम करते समय, और सभी संपादक संसाधनों के साथ, आपको यह याद रखना होगा कि फ़ाइलों की स्थिति को बचाने के लिए AssetDatabase.SaveAssets () विधि को कॉल करना बेहतर है। अन्यथा, परिवर्तन सहेजे नहीं जाएंगे। यदि आप प्रोजेक्ट को हाथ से नहीं बचाते हैं।

अब हम आंशिक रूप से अपार्टमेंटकस्टम इंस्पेक्टर वर्ग का विश्लेषण करते हैं, और यह कैसे काम करता है।

क्लास अपार्टमेंटकस्टम इंस्पेक्टर

  [CustomEditor(typeof(Apartment))] public class ApartmentCustomInspector : Editor { private Apartment _ThisApartment; private Rect _Dimensions; private void OnEnable() { _ThisApartment = (Apartment) target; _Dimensions = _ThisApartment.Dimensions; } public override void OnInspectorGUI() { TopButtons(); _ThisApartment.Height = EditorGUILayout.FloatField("Height (cm)", _ThisApartment.Height); var dimensions = EditorGUILayout.Vector2Field("Dimensions (cm)", _Dimensions.size).RoundCoordsToInt(); _ThisApartment.PlanImage = (Texture) EditorGUILayout.ObjectField(_ThisApartment.PlanImage, typeof(Texture), false); _ThisApartment.IsGenerateOutside = EditorGUILayout.Toggle("Generate outside (Directional Light)", _ThisApartment.IsGenerateOutside); if (_ThisApartment.IsGenerateOutside) _ThisApartment.OutsideMaterial = (Material) EditorGUILayout.ObjectField( "Outside Material", _ThisApartment.OutsideMaterial, typeof(Material), false); GenerateButton(); var dimensionsRect = new Rect(-dimensions.x / 2, -dimensions.y / 2, dimensions.x, dimensions.y); _Dimensions = dimensionsRect; _ThisApartment.Dimensions = _Dimensions; } private void TopButtons() { GUILayout.BeginHorizontal(); CreateNewBlueprint(); OpenBlueprint(); GUILayout.EndHorizontal(); } private void CreateNewBlueprint() { if (GUILayout.Button( "Create new" )) { var manager = ApartmentsManager.Instance; manager.SelectApartment(manager.CreateOrGetApartment("New Apartment" + GUID.Generate())); } } private void OpenBlueprint() { if (GUILayout.Button( "Open in Builder" )) { ApartmentsManager.Instance.SelectApartment(_ThisApartment); ApartmentBuilderWindow.Create(); } } private void GenerateButton() { if (GUILayout.Button( "Generate Mesh" )) { MeshBuilder.GenerateApartmentMesh(_ThisApartment); } } }

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

आवश्यक फ़ील्ड और बटन तब मैन्युअल रूप से तैयार किए जाते हैं। EditorGUILayout वर्ग के पास इकाई द्वारा समर्थित कई प्रकार के फ़ील्ड प्रकारों के लिए कई कार्यान्वयन हैं। लेकिन एकता में बटन प्रतिपादन GUILayout वर्ग में लागू किया गया है। इस मामले में बटन दबाने का कार्य कैसे काम करता है। OnInspectorGUI - प्रत्येक उपयोगकर्ता इनपुट माउस इवेंट (माउस आंदोलन, संपादक विंडो के अंदर माउस क्लिक, आदि) पर निष्पादित होता है। यदि उपयोगकर्ता बॉक्स में बटन पर क्लिक करता है, तो विधि सही हो जाती है और विधियों के तरीके हैं जो आपके द्वारा वर्णित 'अगर' के अंदर हैं। एक। एक उदाहरण के लिए:

मेष पीढ़ी बटन

 private void GenerateButton() { if (GUILayout.Button( "Generate Mesh" )) { MeshBuilder.GenerateApartmentMesh(_ThisApartment); } }

जब आप जनरेट मेश बटन पर क्लिक करते हैं, तो स्टेटिक मेथड को कहा जाता है, जो एक विशिष्ट लेआउट के मेश को जेनरेट करने के लिए जिम्मेदार होता है।

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

किसी ऑब्जेक्ट का चयन करने के लिए, आपको बस Selection.activeObject = MyAwesomeUnityObject लिखना होगा। और सबसे अच्छी बात यह है कि यह ScriptableObject के साथ काम करता है। इस परियोजना में, वह ड्राइंग के साथ एक खिड़की में एक ड्राइंग और कमरे का चयन करने के लिए जिम्मेदार है।

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

संपादक विंडो, स्क्रिप्ट करने योग्य वस्तु और कस्टम संपादक के साथ एकता संपादक का विस्तार

More articles: