युक्तियाँ और चालें 1: विलंबित फ़ंक्शन कॉल (फ़ंक्टर प्रबंधक)

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

इसलिए, इस तरह के और इसी तरह के उद्देश्यों के लिए, मेरे सहयोगी ने एक सार्वभौमिक प्रणाली विकसित की, जिसे उन्होंने फ़न्टर मैनेजर कहा (शायद ऐसी प्रणालियों के नाम के लिए एक अच्छी तरह से स्थापित अन्य शब्द है, मुझे नहीं पता, मुझे खुशी होगी अगर वे मुझे बताएंगे)।

प्रारंभ में, कोड C ++ में लिखा गया था, और हमारे पिछले प्रोजेक्ट्स में उपयोग किया गया था, अब हमारे पास C # में एक प्रोजेक्ट है, इसलिए मैं C # में एक कार्यान्वयन दूंगा। कटौती के तहत एक संक्षिप्त अवधारणा और कार्यान्वयन कोड (C #)।

functor

एक फ़नकार एक क्लासिक है जो यह याद रखता है कि कितना समय लगता है और किस फ़ंक्शन को कॉल करना है।

तो, वास्तव में अंतिम संस्कार के होते हैं:
गाइड - एक अद्वितीय पहचानकर्ता जो एक फ़नकार बनाते समय उत्पन्न होता है। इस पहचानकर्ता की आवश्यकता है ताकि आप यदि आवश्यक हो तो फ़नकार को हटा सकें।
_deltaTime एक आंतरिक टाइमर है। यह उस समय को रिकॉर्ड करता है जिसके बाद फ़ंक्शन कॉल होना चाहिए।
_func - एक फ़ंक्शन के लिए एक संकेतक जिसका कोड टाइमर समाप्त होने के बाद निष्पादित किया जाना चाहिए। फ़ंक्शन एक मान लौटाता है - किस अवधि (सेकंड में) के बाद फ़नकार को विधि कॉल दोहराना पड़ता है। यदि फ़ंक्शन 0.0f मान लौटाता है, तो फ़ंक्टर को पीटा जाता है।
_funcArg फ़ंक्शन तर्क है। आप किसी ऑब्जेक्ट या किसी अन्य आवश्यक जानकारी के लिए यहां एक पॉइंटर पास कर सकते हैं।

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

फैन कोड:

public delegate float Func(object funcArg); public class HOFunctor { float _deltaTime = 0; Func _func = null; object _funcArg = null; Guid _id = Guid.Empty; public HOFunctor(float deltaTime, Func func, object funcArg) { _id = Guid.NewGuid(); _deltaTime = deltaTime; _func = func; _funcArg = funcArg; } public HOFunctor(float deltaTime, Func func) : this(deltaTime, func, null) { } public bool Process(float deltaTime) { if (_func != null) { _deltaTime -= deltaTime; if (_deltaTime <= 0) { _deltaTime = _func(_funcArg); } } return _deltaTime > 0; } public Guid ID { get { return _id; } } } 

फ़नकार प्रबंधक

एक फ़नकार प्रबंधक एक वर्ग है, एक सिंगलटन है, जो फ़ंक्शनलर्स की एक सूची संग्रहीत करता है (वास्तव में 2 सूचियाँ हैं, जो उस पर अधिक हैं)।

तो, प्रबंधक में 2 सूचियाँ हैं, जिनमें से एक इस समय सक्रिय है, और दूसरा नए जोड़े गए फंक्शनलर्स से भरा है, जिनमें सक्रिय सूची के निष्पादन के समय जोड़े गए हैं। एक चर _currentIndex भी है, यह निर्धारित किया जाता है कि वर्तमान में कौन सी सूची सक्रिय है।

अधिकांश विधियां भी सहज हैं (AddFunctor (...) - सूची में एक फ़ंक्‍टर जोड़ता है, RemoveFunctor () - सूची से निकालता है)। केवल समझाने योग्य मूल्य ProcessFunctors (फ्लोट डेल्टा) विधि है। वर्तमान सूची को लिया जाता है, प्रत्येक फ़ंक्टर को प्रक्रिया विधि कहा जाता है, ताकि यह समय को गिना जाए और यदि आवश्यक हो, तो इसे निष्पादित किया जाता है, यदि फ़नकार एक गैर-शून्य मान लौटाता है (यानी वह समय जिसके बाद इसे फिर से बुलाया जाना चाहिए), इसे नई सूची में जोड़ा जाता है। अंत में, सक्रिय सूची साफ़ हो जाती है।

प्रबंधक कोड:

 public class HOFunctorMgr { #region Private fields private static HOFunctorMgr _instance = null; protected Dictionary<Guid, HOFunctor>[] _functors = { new Dictionary<Guid, HOFunctor>(), new Dictionary<Guid, HOFunctor>() }; int _currentIndex = 0; private HOFunctorMgr() { } #endregion public static HOFunctorMgr Instance { get { if (_instance == null) { _instance = new HOFunctorMgr(); } return _instance; } } #region Public methods public Guid AddFunctor(float deltaTime, Func func, object funcArg) { return AddFunctor(new HOFunctor(deltaTime, func, funcArg)); } public Guid AddFunctor(float deltaTime, Func func) { return AddFunctor(new HOFunctor(deltaTime, func, null)); } public Guid AddFunctor(HOFunctor functor) { if (functor != null && !_functors[_currentIndex].ContainsKey(functor.ID)) { _functors[_currentIndex].Add(functor.ID, functor); return functor.ID; } return Guid.Empty; } public void ProcessFunctors(float delta) { int indexToProcess = _currentIndex; _currentIndex ^= 1; foreach (HOFunctor f in _functors[indexToProcess].Values) { if (f.Process(delta)) { AddFunctor(f); } } _functors[indexToProcess].Clear(); } public void RemoveFunctor(Guid id) { if (_functors[0].ContainsKey(id)) { _functors[0].Remove(id); } if (_functors[1].ContainsKey(id)) { _functors[1].Remove(id); } } #endregion } 

परियोजना एकीकरण

परियोजना में एकीकरण 1 लाइन द्वारा किया जाता है। एक चुनौती जोड़ने की जरूरत है

HOFunctorMgr.Instance.ProcessFunctors (डेल्टा);

गेम लूप में, स्वाभाविक रूप से पहले प्रोजेक्ट में प्रबंधक फ़ंक्टर क्लास को जोड़ना। मेरे मामले में (NeoAxis इंजन) यह गेम विंडो का संरक्षित ओवरराइड void OnTick (फ्लोट डेल्टा) विधि है।

डेल्टा समय है, सेकंड में, पिछली कॉल से समाप्त।

सब कुछ इतना सरल है।

उपयोग के उदाहरण

एकल कॉल:

 GameEntities.HOFunctorMgr.Instance.AddFunctor(2.0f, arg => { HidePuzzleWindow(); return 0.0f; }, null ); 

2 सेकंड के बाद, HidePuzzleWindow () कहा जाता है और पहेली विंडो गायब हो जाती है।

एकाधिक कॉल:

 ... int k = 5; HOFunctorMgr.Instance.AddFunctor(5, arg => { GameMap.Instance.AddScreenMessage(string.Format("{0}", arg)); if (k-- >= 0) { return 5; } return 0; }, "test"); 

हर बार 5 सेकंड के अंतराल के साथ, शब्द परीक्षण को प्रदर्शित करते हुए, एक फ़नकार को 5 बार आमंत्रित किया जाता है। अंतराल, वैसे, बदला जा सकता है।

एक स्थिर विधि को बुलाओ:

 static float MyMethod(object arg) { if (arg != null) { ... } return 0; } HOFunctorMgr.Instance.AddFunctor(10, MyMethod, someObject); 

10 सेकंड के बाद, स्थिर MyMethod विधि को कहा जाता है और कुछ तर्क के रूप में इसे पास किया जाता है।

उपयोग के बारे में

आप अपनी परियोजनाओं में, गैर-वाणिज्यिक और वाणिज्यिक दोनों में कोड को संशोधित और / या उपयोग कर सकते हैं।

पूर्ण वर्ग कोड

NeoAxis के लिए क्लास कोड, नेमस्पेस तेज किया।

 using System; using System.Collections.Generic; using System.Text; namespace GameEntities { public delegate float Func(object funcArg); public class HOFunctor { float _deltaTime = 0; Func _func = null; object _funcArg = null; Guid _id = Guid.Empty; public HOFunctor(float deltaTime, Func func, object funcArg) { _id = Guid.NewGuid(); _deltaTime = deltaTime; _func = func; _funcArg = funcArg; } public HOFunctor(float deltaTime, Func func) : this(deltaTime, func, null) { } public bool Process(float deltaTime) { if (_func != null) { _deltaTime -= deltaTime; if (_deltaTime <= 0) { _deltaTime = _func(_funcArg); } } return _deltaTime > 0; } public Guid ID { get { return _id; } } } public class HOFunctorMgr { #region Private fields private static HOFunctorMgr _instance = null; protected Dictionary<Guid, HOFunctor>[] _functors = { new Dictionary<Guid, HOFunctor>(), new Dictionary<Guid, HOFunctor>() }; int _currentIndex = 0; private HOFunctorMgr() { } #endregion public static HOFunctorMgr Instance { get { if (_instance == null) { _instance = new HOFunctorMgr(); } return _instance; } } #region Public methods public Guid AddFunctor(float deltaTime, Func func, object funcArg) { return AddFunctor(new HOFunctor(deltaTime, func, funcArg)); } public Guid AddFunctor(float deltaTime, Func func) { return AddFunctor(new HOFunctor(deltaTime, func, null)); } public Guid AddFunctor(HOFunctor functor) { if (functor != null && !_functors[_currentIndex].ContainsKey(functor.ID)) { _functors[_currentIndex].Add(functor.ID, functor); return functor.ID; } return Guid.Empty; } public void ProcessFunctors(float delta) { int indexToProcess = _currentIndex; _currentIndex ^= 1; foreach (HOFunctor f in _functors[indexToProcess].Values) { if (f.Process(delta)) { AddFunctor(f); } } _functors[indexToProcess].Clear(); } public void RemoveFunctor(Guid id) { if (_functors[0].ContainsKey(id)) { _functors[0].Remove(id); } if (_functors[1].ContainsKey(id)) { _functors[1].Remove(id); } } #endregion } }