स्वार एसडीके या कैसे जल्दी से एक एआर एप्लिकेशन बनाने के लिए

संवर्धित वास्तविकता अनुप्रयोग तेजी से लोकप्रिय हो रहे हैं। जल्दी या बाद में, रूस में किसी ने निश्चित रूप से इस तरह के एप्लिकेशन बनाने के लिए एक एसडीके जारी किया होगा। और इसलिए, ऐसा हुआ - रूसी कंपनी Sectar ने .NET प्लेटफ़ॉर्म पर इस तरह के एप्लिकेशन बनाने के लिए अपने Swarp SDK उत्पाद को जारी किया। इसके बाद, मैं Swarp का वर्णन करूंगा और आपको दिखाऊंगा कि कैसे जल्दी और आसानी से अपना AR एप्लिकेशन बनाएं।

सिंहावलोकन

उत्पाद डाउनलोड करने और स्थापित करने के बाद (लेखन के समय, संस्करण 1.0.249.925 प्रासंगिक है), आप 5 उपनिर्देशिका देख सकते हैं:

• बिन - यहाँ सभी स्वार एसडीके विधानसभाएं हैं, साथ ही प्रबंधित ओग्रे (मोगरे) इंजन के पुस्तकालय भी हैं, जिसका उपयोग प्रतिपादन के लिए किया जाता है।
• डॉक्स - में (लाइसेंस एग्रीमेंट और रिलीज़नोट्स के अलावा) एक बहुत ही दिलचस्प फ़ाइल "Documentation.chm" शामिल है। इसमें स्वार्प के लिए सभी दस्तावेज शामिल हैं, जिसमें कक्षाओं का विवरण और एक ट्यूटोरियल शामिल है। वैसे, सभी दस्तावेज रूसी में हैं और MSDN की शैली में बने हैं, जो सिद्धांत रूप में .NET पर डेवलपर की धारणा को सुविधाजनक बनाना चाहिए।
• उदाहरण एक फ़ोल्डर है जिसमें सेक्टर्स डेवलपर्स द्वारा लिखित उदाहरण हैं। एसडीके के इस संस्करण में, 3 उदाहरण हैं जो मोगरे पर आधारित एक रेंडरिंग सिस्टम के साथ एक मान्यता प्रणाली के साथ काम करते हुए प्रदर्शित होते हैं - एक .net रैपर Ogre3D, साथ ही एक मार्कर के साथ डायनेमिक 3 डी मॉडल को जोड़ने के लिए एक तंत्र। सभी उदाहरण दृश्य स्टूडियो 2010 के लिए समाधान हैं।
• ट्रैक करने योग्य - इसमें कई स्वार एसडीके मार्कर शामिल हैं। आगे देखते हुए, मैं कह सकता हूँ कि आप SquareMarkerCreator उपयोगिता का उपयोग करके अपने आप मार्कर बना सकते हैं।
• उपयोगिताएँ - SquareMarkerCreator, HID, और लाइसेंस व्यूअर उपयोगिताएँ यहाँ पाई जा सकती हैं। अंतिम दो का उपयोग उत्पाद को पंजीकृत करने और इंस्टॉल किए गए लाइसेंस को देखने के लिए किया जाता है, इसलिए मैं उन पर ज्यादा ध्यान नहीं देता। यदि कोई इच्छुक है, तो आप उनके बारे में दस्तावेज में पढ़ सकते हैं। लेकिन SquareMarkerCreator के बारे में मैं अलग से बताऊंगा।

मार्कर

स्वार एसडीके एक अजीब मार्कर प्रणाली का उपयोग करता है। मार्कर एक्सट्रैक्टेबल के साथ एक्सएमएल फाइल के रूप में प्रस्तुत किया जाता है। मानक मार्करों में से एक की सामग्री नीचे दी गई है।

एक मार्कर कागज पर कैसा दिखता है:

और इसकी सामग्री .trackable फ़ाइल में:

<?xml version="1.0" encoding="utf-8"?> <Trackable Type="Sectar Square Marker" Description="Marker with square detection element" Version="1.0" Company="Sectar"> <SquareMarker MarkerSize="500" FrameWidth="80" CellsCount="4" FrameMargin="15" CellMargin="5" CellsType="Circle"> <Code>111100010101</Code> </SquareMarker> </Trackable> 

बहुत से लोगों के मन में एक सवाल होगा: किसी .trackable फ़ाइल को एक सामान्य .jpg या .png में परिवर्तित कैसे करें? यह सरल है: SquareMarkerCreator.exe उपयोगिता बचाव के लिए आती है।

मार्कर उपयोगिता (SquareMarkerCreator)

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

किसी XML प्रारूप से एक मार्कर को एक ग्राफिक में बदलने के लिए, आपको "XML से डाउनलोड करें" बटन पर क्लिक करके मार्कर को लोड करना होगा, और फिर "सहेजें छवि" बटन पर क्लिक करके मार्कर को एक .EMF फ़ाइल में सहेजें।

नमस्कार विश्व! स्वर एसडीके पर

अपने एआर एप्लिकेशन को लिखने का प्रयास करने का समय आ गया है। मैं एक OgreSimpleSceneExample उदाहरण को पार्स करना चाहता हूं जो पहले कैमरे का उपयोग करेगा और एक 3 डी मॉडल को प्रस्तुत करने के लिए मोगरे का उपयोग करेगा।

कंसोल Win32 एप्लिकेशन की परियोजना बनाते हैं। और संदर्भ में प्रयुक्त असेंबली जोड़ें:

और कोड में हम इस्तेमाल किए गए नामस्थानों के लिंक जोड़ते हैं:

 using System; using System.Collections.Generic; using System.Drawing; using System.Windows.Forms; using Mogre; using Swarp.Examples.OgreSimpleSceneExample.Properties; using Swarp.SDK.Management; using Swarp.SDK.Ogre3DRendering; using Swarp.SDK.Rendering; using Swarp.SDK.Target.SquareMarkerTracking; using Swarp.SDK.Tracking; using Swarp.SDK.DirectShowInput; 

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

 static class Program { /// <summary> ///   . /// </summary> private static AugmentedRealityManager _arManager; /// <summary> ///  . /// </summary> private static ITrackable _houseTrackable; /// <summary> /// The main entry point for the application. /// </summary> [STAThread] public static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); } } 

अब हमारे पास आवेदन के लिए एक प्रवेश बिंदु है। सवाल उठता है - आगे क्या करना है? आगे, मैं Swarp SDK प्रलेखन से एक चित्र दूंगा:

तस्वीर में, लाल फ्रेम उन कार्यों को उजागर करता है जो डेवलपर को निष्पादित करना होगा।
वर्तमान स्तर पर, आपको कैमरे को इनिशियलाइज़ करने की आवश्यकता है। ऐसा करने के लिए, CameraManager वर्ग का उपयोग करें:

 //     . var camera = CameraManager.Instance.GetFirstWorkedCamera(); //     ,      . if (camera == null) { MessageBox.Show(Resources.CameraNotFoundString, Resources.WarningString, MessageBoxButtons.OK, MessageBoxIcon.Warning); return; } var displayParameters = new DisplayParameters(30, new Size(800, 600)); //       ,    . camera.DisplayParameters = camera.IsSupportedDisplayParameters(displayParameters) ? displayParameters : camera.GetSupportedDisplayParameters()[0]; 

फिर आपको यह निर्दिष्ट करने की आवश्यकता है कि एप्लिकेशन में कौन से मार्कर का उपयोग किया जाएगा। यह इस प्रकार किया जाता है:

 var tracker = new SquareMarkerTracker(1); //  1  .      . _houseTrackable = new SquareMarker("House Marker", "Trackable\\5.trackable"); tracker.TrackableObjects.Add(_houseTrackable); 

इस प्रकार, हम संकेत देते हैं कि ट्रैक करने योग्य \ 5. ट्रैक करने योग्य मार्कर मार्कर ट्रैकिंग सिस्टम द्वारा खोजा जाएगा।

और अब हमें मोगरे-आधारित प्रतिपादन प्रणाली को आरंभीकृत करने की आवश्यकता है:

 //  ,      . var ogreSimpleSceneForm = new Form { Size = new Size(1066, 600), Text = Resources.SwarpSDKExampleString, Icon = Resources.Swarp, }; //  . // plugins.cfg -       Ogre3D. // ogre.cfg -     ,    Ogre3D. // ogre.log - -,       Ogre3D. //       , //          . var renderer = new Ogre3DRenderSystem(ogreSimpleSceneForm.Handle, "OgreConfig\\plugins.cfg", "OgreConfig\\ogre.cfg", "OgreConfig\\ogre.log") { SizeMode = SizeMode.Autosize }; //     . //        // (3D ,   ..,    Ogre3D  ). renderer.LoadResources("OgreConfig\\resources.cfg"); //  .  . var houseScene = new Ogre3DScene(renderer.Root, "House Scene"); renderer.Scenes.Add(houseScene); LoadScene(houseScene.SceneManager); 

Managed Ogre के साथ काम करना Ogre3DRenderingSystem वर्ग में समझाया जाता है, जो कि डेवलपर के जीवन को बहुत सरल करता है, क्योंकि यह अधिकांश नियमित संचालन करता है। सामान्य तौर पर, मोगरे एक अलग और बहुत बड़ा विषय है, इसलिए यदि किसी को दिलचस्पी है, तो लेख के अंत में मोगरे विकि के लिए एक लिंक है।

स्वरूप SDK डेवलपर को केवल Ogre तक सीमित नहीं करता है। सिद्धांत रूप में, एक डेवलपर दूसरे रेंडरर को एकीकृत कर सकता है। ऐसा करने के लिए, रेंडरर और सीन से विरासत में मिलने वाली दो कक्षाएं बनाएं।

आइए हमारे आवेदन पर वापस जाएं। Ogre3DRenderSystem कंस्ट्रक्टर को कॉल करते समय , 4 पैरामीटर निर्दिष्ट किए जाते हैं: मोगरे के साथ काम करने वाले फॉर्म या नियंत्रण का तरीका, ओग्रे कॉन्फ़िगरेशन फ़ाइलों के लिए पथ जो रेंडरिंग सिस्टम के प्लग-इन और सेटिंग्स का वर्णन करता है, और लॉग फ़ाइल का पथ।

आगे ओग्रे संसाधन हैं। 3 डी मॉडल डाउनलोड करने के लिए, यह आवश्यक है कि संसाधन कॉन्फ़िगरेशन फ़ाइल में उनके संदर्भ दिए जाएं। उदाहरण के लिए, मेरी संसाधन कॉन्फ़िगरेशन फ़ाइल इस तरह दिखती है:

 # Resource locations to be added to the 'boostrap' path # This also contains the minimum you need to use the Ogre example framework [Bootstrap] # Resource locations to be added to the default path [General] FileSystem= FileSystem=Resources Zip=Resources/House.zip 

केवल एक House.zip मॉडल यहां डाउनलोड किया गया है, जो ज़िप संग्रह में स्थित है।
तब LoadScene विधि कहा जाता है । यह एक मोगरे दृश्य बनाने और उसमें एक मॉडल जोड़ने के लिए आवश्यक है। आप मोगरे विकि में इसके बारे में अधिक पढ़ सकते हैं। विधि नीचे वर्णित है:

 private static void LoadScene(SceneManager sceneManager) { //     Mogre,    , //   .. . http://www.ogre3d.org/tikiwiki/Mogre+Tutorials. //  ,     . var houseNode = sceneManager.RootSceneNode.CreateChildSceneNode("HouseNode"); //    (   ). var houseEntity = sceneManager.CreateEntity("House", "House.mesh"); houseNode.AttachObject(houseEntity); houseNode.Scale(6.0f, 6.0f, 6.0f); } 

अब सब कुछ प्रबंधक को आरंभ करने और चलाने के लिए तैयार है:

 //    . _arManager = new AugmentedRealityManager(camera, trackers, renderer); //  . //      . camera.Start(); //    . //     . _arManager.Start(); ogreSimpleSceneForm.Show(); while (ogreSimpleSceneForm.Created) { //         , //     ,      . UpdateScenes(); //   . // ,       , //      . _arManager.Renderer.RenderFrame(); //      . Application.DoEvents(); } //       . _arManager.Dispose(); renderer.Dispose(); camera.Dispose(); 

एक महत्वपूर्ण बिंदु: संवर्धित वास्तविकता प्रक्रिया शुरू करने से पहले, आपको कैमरे से कब्जा सक्षम करने की आवश्यकता है।

UpdateScenes विधि अंतरिक्ष में मार्कर की स्थिति के अनुसार मॉडल (यदि ट्रैकर द्वारा पाया जाता है) को उन्मुख करता है:

 private static void UpdateScenes() { //     , //     ,       . var foundTrackableObjects = new List<ITrackable>(_arManager.Trackers[0].LastDetectedObjects); //      . foreach (var scene in _arManager.Renderer.Scenes) { //       ,   . if (foundTrackableObjects.Contains(_houseTrackable)) { //    ,    . scene.Visible = true; //    . var trackablePose =_arManager.Trackers[0].GetPose(_houseTrackable); //       . scene.OrientScene(trackablePose); } else { scene.Visible = false; } } } 

इस प्रकार, हमें पहला एआर-एप्लिकेशन मिला, एक प्रकार का "हैलो, वर्ल्ड!" संवर्धित वास्तविकता की दुनिया में। मुझे जो कुछ मिला उसका स्क्रीनशॉट लिया:

और स्वार एसडीके का एक छोटा सा वीडियो एक्शन में:


अच्छा घर है, है ना?

निष्कर्ष में

यहां, ऐसा लगता है, और वह सब जो आपके एआर-एप्लिकेशन को बनाने के लिए आवश्यक है। एसडीके प्रलेखन को पढ़ने और यह कैसे काम करता है, इसे समझने में मुझे लगभग 2 घंटे लगे।

मुझे उम्मीद है कि यह लेख उन लोगों की मदद करता है जो स्वरा को समझना चाहते हैं। निम्नलिखित लेखों में, हम एप्लिकेशन को अधिक गंभीरता से और अधिक जटिल लिखने की कोशिश करेंगे। पढ़ने के लिए धन्यवाद।

संदर्भ

डेवलपर्स साइट: www.sectar.com
एसडीके डाउनलोड लिंक: स्वार एसडीके
प्रबंधित ओग्रे: मोगरे विकी

UPD: एक वीडियो पोस्ट किया।
UPD 2: खेतों से समाचार: संप्रदाय ने एक नया अपडेट किया। पुराने संस्करण में, ट्रायल मोड को सक्रिय करने में त्रुटि हुई थी। यह तय लग रहा है। पोस्ट ने डाउनलोड लिंक को सही कर दिया है।