मल्टीकाड .NET एपीआई पर कस्टम कैड प्राइमेटिव बनाना

पारंपरिक .NET API .dwg अनुरूप सीएडी सिस्टम की मुख्य कमियों में से एक है। .NET पर कस्टम एंटिटीज बनाने में असमर्थता। कस्टम आदिम C ++ में बनाए गए हैं। .NET में उनके उपयोग के लिए आपको C ++ / CLI में प्रबंधित रैपर बनाने की आवश्यकता है।

MultiCAD .NET तकनीक आपको प्रबंधित कोड से परे जाने के बिना कस्टम आदिम बनाने की अनुमति देती है। सी ++ में मध्यवर्ती वस्तुओं की कमी के अलावा, मल्टीकाड .NET .NET के लिए मानक तंत्र का अधिकतम उपयोग करता है, परिणामस्वरूप सीएडी प्रोग्रामर के लिए कई संचालन की आवश्यकता नहीं है: आपको मैन्युअल रूप से क्रमांकन का वर्णन करने की आवश्यकता नहीं है, आप एक COM ऑब्जेक्ट आदि बनाए बिना निरीक्षक में गुण प्रदर्शित कर सकते हैं। ।

MultiCAD .NET के प्रदर्शन के रूप में, हम SDK के साथ शामिल CustomObjects नमूना अनुप्रयोग को देखेंगे। यह उदाहरण एक कस्टम आदिम बनाता है, जो अंदर के पाठ के साथ एक आयताकार फ्रेम है:



हमारे परीक्षण आदिम युक्त चित्र किसी भी .dwg संगत CAD प्रणाली में खोले जा सकते हैं। आदिम को बदलने के लिए, आपको विधानसभा को प्रिमिटिव के कोड से डाउनलोड करना होगा, और उसी असेंबली को सभी सहायक सीएडी सिस्टमों में पुनःसंयोजन के बिना लोड किया गया है। प्रौद्योगिकी नैनोकार्ड के लिए मूल है, ऑटोकैड में एक मॉड्यूल को लोड करने के लिए, एक ऑब्जेक्ट एनबलर की आवश्यकता होती है। देखें कि यह कट के नीचे कैसे काम करता है।

उपयोगकर्ता आदिम वर्ग

एक नया आदिम प्रकार बनाने के लिए, आपको मैककस्टमबेस से विरासत में मिली एक कक्षा को लिखना होगा, जो सभी उपयोगकर्ता आदिमों के लिए आधार वर्ग है। इसके अलावा, घोषित वर्ग के लिए दो विशेषताओं का उपयोग किया जाना चाहिए:

1. [CustomEntity] विशेषता वर्ग के प्रकार को इंगित करती है, इसका GUID, नाम जो कि ड्राइंग डेटाबेस और स्थानीय नाम में ऐसी सभी वस्तुओं के लिए उपयोग किया जाएगा,
2. [Serializable] विशेषता, .NET फ्रेमवर्क में मानक क्रमांकन तंत्र का उपयोग करने के लिए।

[CustomEntity(typeof(TextInBox), "1C925FA1-842B-49CD-924F-4ABF9717DB62", "TextInBox", "TextInBox Sample Entity")] [Serializable] public class TextInBox : McCustomBase { // First and second vertices of the box private Point3d _pnt1 = new Point3d(50, 50, 0); private Point3d _pnt2 = new Point3d(150, 100, 0); // Text inside the box private String _text = "Text field"; } 

अब हम मैककॉस्टबेस बेस क्लास विधियों को फिर से परिभाषित करते हैं जिनका उपयोग ज्यामिति को प्रदर्शित करने के लिए किया जाएगा, ऑब्जेक्ट को ड्राइंग में डालें, ऑब्जेक्ट का चयन करें और ट्रांसफॉर्म करें।

ज्यामिति प्रदर्शन

ऑब्जेक्ट प्रदर्शित करने के लिए, OnDraw () विधि का उपयोग किया जाता है। ज्योमेट्रीब्यूटल क्लास का एक ऑब्जेक्ट इस पद्धति के एक पैरामीटर के रूप में कार्य करता है, जो वास्तव में, उपयोगकर्ता आदिम को प्रस्तुत करने के लिए उपयोग किया जाएगा।

 public override void OnDraw(GeometryBuilder dc) { dc.Clear(); // Set the color to ByObject value dc.Color = McDbEntity.ByObject; // Draw box with choosen coordinates dc.DrawPolyline(new Point3d[] { _pnt1, new Point3d(_pnt1.X, _pnt2.Y, 0), _pnt2, new Point3d(_pnt2.X, _pnt1.Y, 0), _pnt1}); // Set text height dc.TextHeight = 2.5 * DbEntity.Scale; // Set text color dc.Color = Color.Blue; // Draw text at the box center dc.DrawMText(new Point3d((_pnt2.X + _pnt1.X) / 2.0, (_pnt2.Y + _pnt1.Y) / 2.0, 0), Vector3d.XAxis, Text, HorizTextAlign.Center, VertTextAlign.Center); } 

निर्देशांक के एक ड्राइंग, इंटरएक्टिव इनपुट में एक वस्तु जोड़ना

ड्राइंग में एक कस्टम ऑब्जेक्ट जोड़ने के लिए, PlaceObject () विधि का उपयोग किया जाता है, जो हमारे मामले में, डेटाबेस में ऑब्जेक्ट जोड़ने के वास्तविक संचालन के अलावा, ऑब्जेक्ट निर्देशांक के इंटरैक्टिव इनपुट के लिए उपयोग किया जाएगा। MultiCAD .NET में इंटरेक्टिव इनपुट के लिए, InputJig वर्ग उस कार्यक्षमता के लिए जिम्मेदार है जिसकी हमें आवश्यकता है:

• public InputResult GetPoint(string promt) - उपयोगकर्ता द्वारा चयनित ड्राइंग में वह बिंदु प्राप्त करता है, जिसमें संकेतों को प्रदर्शित करने की क्षमता होती है;
• public void ExcludeObject(McObjectId ObjectId) - ड्राइंग में किसी बिंदु को निर्दिष्ट करते समय निर्दिष्ट ऑब्जेक्ट को बाइंडिंग से बाहर करता है। हमारे मामले में, हम अपने आप को बंधन से बचने के लिए अपनी वस्तु को बंधन से बाहर कर देंगे।
• public EventHandler MouseMove - एक माउस गति घटना के लिए एक हैंडलर। हम माउस को स्थानांतरित करते समय वस्तु को अंतःक्रियात्मक रूप से फिर से परिभाषित करने के लिए इसका उपयोग करेंगे।

PlaceObject() पद्धति का कार्यान्वयन इस तरह दिखेगा:

 public override hresult PlaceObject(PlaceFlags lInsertType) { InputJig jig = new InputJig(); // Get the first box point from the jig InputResult res = jig.GetPoint("Select first point:"); if (res.Result != InputResult.ResultCode.Normal) return hresult.e_Fail; _pnt1 = res.Point; // Add the object to the database DbEntity.AddToCurrentDocument(); // Exclude the object from snap points jig.ExcludeObject(ID); // Monitoring mouse moving and interactive entity redrawing jig.MouseMove = (s, a) => {TryModify(); _pnt2 = a.Point; DbEntity.Update(); }; // Get the second box point from the jig res = jig.GetPoint("Select second point:"); if (res.Result != InputResult.ResultCode.Normal) { DbEntity.Erase(); return hresult.e_Fail; } _pnt2 = res.Point; return hresult.s_Ok; } 

किसी वस्तु का संपादन और रूपांतरण

ऑब्जेक्ट को संशोधित करने और पाठ स्ट्रिंग को संपादित करने की क्षमता जोड़ें। ऐसा करने के लिए, आपको मैककॉस्टबेस बेस क्लास में निहित निम्न विधियों को ओवरराइड करना होगा:

• public virtual List OnGetGripPoints() - किसी ऑब्जेक्ट के लिए हैंडल की एक सूची प्राप्त करता है;
• public virtual void OnMoveGripPoints(List indexes, Vector3d offset, bool isStretch) - संभाल आंदोलन संभाल;
• public virtual void OnTransform(Matrix3d tfm) - परिभाषित करता है कि ऑब्जेक्ट को कैसे बदलना चाहिए;
• public virtual hresult OnEdit(Point3d pnt, EditFlags lInsertType) - किसी वस्तु को संपादित करने की प्रक्रिया को परिभाषित करता है;

हैंडल एक मार्कर के साथ चिह्नित विशेष बिंदु हैं, जिनका उपयोग ऑब्जेक्ट को बदलने के लिए किया जाता है। उपयोगकर्ता द्वारा निर्दिष्ट फ्रेम के कोने बिंदुओं पर हैंडल प्रदर्शित करें:

 public override List OnGetGripPoints() { List arr = new List(); arr.Add(_pnt1); arr.Add(_pnt2); return arr; } 

अब, आरेखण में एक ऑब्जेक्ट का चयन करने के बाद, पेन को दिए गए बिंदुओं पर प्रदर्शित किया जाएगा:



OnMoveGripPoints () हैंडलर विधि को परिभाषित करके ड्रैग और ड्रॉप हैंडल का उपयोग करके डिफाइनिंग कॉर्नर पॉइंट को स्थानांतरित करने की क्षमता जोड़ें:

 public override void OnMoveGripPoints(List indexes, Vector3d offset, bool isStretch) { if (!TryModify()) return; if (indexes.Count == 2) { _pnt1 += offset; _pnt2 += offset; } else if (indexes.Count == 1) { if (indexes[0] == 0) _pnt1 += offset; else _pnt2 += offset; } } 

यहाँ इंडेक्स पैरामीटर में हैंडल नंबरों की एक सूची है, ऑफ़सेट हैंडल मूवमेंट वेक्टर है।

फिर हम ऑनट्रांसफॉर्म () विधि को परिभाषित करते हैं ताकि ऑब्जेक्ट को परिवर्तित करते समय, नए निर्देशांक की गणना कोने के दोनों बिंदुओं के लिए की जाए:

 public override void OnTransform(Matrix3d tfm) { //Save Undo state and set the object status to "Changed" if (!TryModify()) return; _pnt1 = _pnt1.TransformBy(tfm); _pnt2 = _pnt2.TransformBy(tfm); } 

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

 public override hresult OnEdit(Point3d pnt, EditFlags lInsertType) { TextInBox_Form frm = new TextInBox_Form(); frm.textBox1.Text = Text; frm.ShowDialog(); Text = frm.textBox1.Text; return hresult.s_Ok; } 

संपत्ति निरीक्षक में वस्तु गुण जोड़ना

MultiCAD .NET API ऑब्जेक्ट गुण निरीक्षक के लिए कस्टम ऑब्जेक्ट गुण जोड़ने की क्षमता प्रदान करता है, भले ही वह प्लेटफ़ॉर्म जहां .dwg फ़ाइल खोली जाएगी, चाहे वह ऑटोकैड हो या नैनो कार्ड। यह वस्तु की संबंधित सार्वजनिक संपत्ति के लिए निम्नलिखित विशेषताओं को जोड़कर किया जाता है:

• DisplayNameAttribute - उस संपत्ति का नाम परिभाषित करता है जिसे निरीक्षक में प्रदर्शित किया जाएगा;
• DescriptionAttribute - संपत्ति का विवरण सेट करता है;
• CategoryAttribute - उस श्रेणी के नाम को परिभाषित करता है जिसमें यह संपत्ति प्रदर्शित की जाएगी।

हम यह अवसर लेंगे और टेक्स्ट प्रॉपर्टी को ऑब्जेक्ट प्रॉपर्टी पैलेट में जोड़ देंगे:

 [DisplayName(" ")] [Description(" ")] [Category(" ")] public String Text { get { return _text; } set { //Save Undo state and set the object status to "Changed" if (!TryModify()) return; // Set new text value _text = value; } } 

उसके बाद, वस्तु निरीक्षक में हमारी वस्तु के पाठ स्ट्रिंग का मूल्य प्रदर्शित किया जाएगा:



इसलिए, हमने आदिम का पहला संस्करण बनाया, जिसे .dwg प्रारूप की एक ड्राइंग में डाला जा सकता है और CAD उपयोगकर्ताओं के लिए कई तरीकों से संपादित किया जा सकता है। लेकिन जीवन अभी भी खड़ा नहीं है, और आदिम की कार्यक्षमता को बढ़ाना होगा। निम्नलिखित लेखों में से एक में, हम आदिम के दूसरे संस्करण पर विचार करेंगे, जहां हम नए फ़ील्ड जोड़ेंगे, और आपको बताएंगे कि मल्टीकाडनेट एपीआई द्वारा प्राइमिटिव्स के संस्करणों के साथ काम करने के लिए क्या विकल्प दिए गए हैं।

लेख की चर्चा हमारे मंच पर भी उपलब्ध है: forum.nanocad.ru/index.php?showtopic=6504 ।

लेख का अंग्रेजी में अनुवाद: मल्टीकाड .NET एपीआई के साथ सीएडी में कस्टम इकाइयाँ बनाना ।