ऑडियो प्लगइन्स बनाना, भाग 2

श्रृंखला में सभी पोस्ट:

भाग 1. परिचय और सेटअप

भाग 2. कोड सीखना

भाग 3. वीएसटी और एयू

भाग 4. डिजिटल विरूपण

भाग 5. प्रीसेट और जीयूआई

भाग 6. सिग्नल संश्लेषण

भाग 7. मिडी संदेश प्राप्त करना

भाग 8. आभासी कीबोर्ड

भाग 9. लिफाफे

भाग 10. जीयूआई में सुधार

भाग 11. फ़िल्टर

भाग 12. कम आवृत्ति वाला थरथरानवाला

भाग 13. नया स्वरूप

भाग 14. पॉलीफोनी 1

भाग 15. पॉलीफोनी 2

भाग 16. एंटीलियासिंग

---

आइए हमारे परीक्षण परियोजना पर करीब से नज़र डालें। सबसे महत्वपूर्ण फाइलें हैं संसाधन ।h , MyFirstPlugin.h और MyFirstPlugin.cpp । फिलहाल, प्लगइन एक साधारण वॉल्यूम नियंत्रण है।

सीखने का कोड

लगातार, झंडे, और छवि स्रोत

नाविक में संसाधन खोलें। इस फ़ाइल में प्लगइन्स का नाम, इसका संस्करण, विशिष्ट आईडी और GUI के लिए छवि स्रोतों के लिंक जैसे स्थिरांक शामिल हैं। 23-26 पंक्तियों में, आप एक विशिष्ट आईडी निर्दिष्ट कर सकते हैं:

// 4 chars, single quotes. At least one capital letter #define PLUG_UNIQUE_ID 'Ipef' // make sure this is not the same as BUNDLE_MFR #define PLUG_MFR_ID 'Acme'
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

प्लगइन्स की सामान्य कैटलॉगिंग के लिए आईडी महत्वपूर्ण है। आप इसे यहाँ रजिस्टर कर सकते हैं । लाइनें 56 और आगे वॉल्यूम घुंडी के लिए छवि के लिए आईडी और पथ निर्धारित करें जिसे आप प्लगइन शुरू करते समय देखते हैं:

 // Unique IDs for each image resource. #define KNOB_ID 101 // Image resource locations for this plug. #define KNOB_FN "resources/img/knob.png"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

नाविक और खुले संसाधन में खोजें → img → knob.png यह साठ विभिन्न कलम पदों के साथ एक प्रेत है, आकार में प्रत्येक 48 से 48 पिक्सेल। जब आप प्लगइन शुरू करते हैं और घुंडी को घुमाते हैं, तो हैंडल की छवि घूमती नहीं है। कार्यक्रम केवल इस स्प्राइट का संगत हिस्सा दिखाता है।

यह स्पिन क्यों नहीं करता है? कल्पना कीजिए कि कलम में कुछ निशान हैं और एक छाया डाली है। फिर, रोटेशन के दौरान, छाया भी स्पिन होगी। यह वास्तव में नहीं होता है, जैसा कि आप (मुझे आशा है) जानते हैं।



नीचे संसाधन में। आप प्लगइन विंडो का आकार निर्धारित कर सकते हैं:

 #define GUI_WIDTH 300 #define GUI_HEIGHT 300
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

मूल्यों के साथ चारों ओर खेलते हैं और प्लगइन चलाते हैं।

प्लगइन वर्ग इंटरफ़ेस

MyFirstPlugin.h खोलें। इसमें प्लगइन वर्ग के लिए इंटरफ़ेस है। public



भाग में एक निर्माणकर्ता, एक विध्वंसक और वर्ग के तीन सदस्य कार्य शामिल हैं:

• नमूना दर में परिवर्तन होने पर Reset
  
  
  
  को कहा जाता है।
• OnParamChange
  
  
  
  को कहा जाता है जब प्लगइन पैरामीटर बदले जाते हैं, उदाहरण के लिए, जब हम घुंडी को घुमाते हैं।
• ProcessDoubleReplacing
  
  
  
  प्लगइन का बहुत मूल है। यह उस में है कि आने वाले ऑडियो का प्रसंस्करण किया जाता है।

private



भाग में, केवल एक double



चर है जो वर्तमान वॉल्यूम मान संग्रहीत करता है।

कार्यान्वयन

हम दिलचस्प हिस्से को पास करते हैं! MyFirstPlugin.cpp खोलें। तुरंत हमें enum



प्रकार के साथ एक दिलचस्प रिसीवर दिखाई देता है:

 enum EParams { kGain = 0, kNumParams };
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

kGain = 0



सेट करके और kNumParams



बाद kNumParams



डालकर, kNumParams



प्लग-इन पैरामीटर (इस मामले में 1) की संख्या बन जाता है।

निम्नलिखित enum



रिसोर्स में वर्णित स्थिरांक का उपयोग करता है। प्लगइन विंडो में हैंडल निर्देशांक सेट करता है:

 enum ELayout { kWidth = GUI_WIDTH, kHeight = GUI_HEIGHT, kGainX = 100, kGainY = 100, kKnobFrames = 60 };
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

यह knob.png में फ़्रेम की संख्या 60 तक सेट करता है।

अगला, कंस्ट्रक्टर का कार्यान्वयन शुरू होता है। प्लगइन विशेषताओं सेट कर रहे हैं:

 //arguments are: name, defaultVal, minVal, maxVal, step, label GetParam(kGain)->InitDouble("Gain", 50., 0., 100.0, 0.01, "%");
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जीयूआई में अब तक, न तो कोई मान और न ही प्रतिशत चिह्न दिखाई देता है, लेकिन मान 0



से 100



तक भिन्न हो सकता है। डिफ़ॉल्ट मान 50



। आप देख सकते हैं कि मानों का उन्नयन वृत्त पर समान नहीं है। यह SetShape(2.)



कारण है। यदि आप इसे SetShape(1.)



प्रतिस्थापित करते हैं, तो मूल्यों का वितरण रैखिक होगा। यह SetShape



जो SetShape



व्यवहार को परिभाषित करता है।

इसके बाद, डिजाइनर वांछित आकार का एक ग्राफिक संदर्भ बनाता है और पृष्ठभूमि का लाल रंग सेट करता है:

 IGraphics* pGraphics = MakeGraphics(this, kWidth, kHeight); pGraphics->AttachPanelBackground(&COLOR_RED);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

उसके बाद, knob.png लोड किया जाता है, एक छवि के साथ एक नया IKnobMultiControl बनाया और GUI से जुड़ा हुआ है। IKnobMultiControl



इंटरफ़ेस हैंडल के लिए एक वर्ग है।

ध्यान दें कि कैसे kKnobFrames पैरामीटर स्प्राइट में फ्रेम की संख्या को इंगित करने के लिए पारित किया गया है:

 IBitmap knob = pGraphics->LoadIBitmap(KNOB_ID, KNOB_FN, kKnobFrames); pGraphics->AttachControl(new IKnobMultiControl(this, kGainX, kGainY, kGain, &knob));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अंत में, डिजाइनर ग्राफिक्स संदर्भ को बांधता है और प्लगइन के लिए एक डिफ़ॉल्ट प्रीसेट बनाता है:

 MakeDefaultPreset((char *) "-", kNumPrograms);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

OnParamChange



(फ़ाइल के अंत में) पर OnParamChange



नज़र डालें। IMutexLock



स्ट्रीमिंग सुरक्षा प्रदान करता है, एक अवधारणा जिसे हम बाद में चर्चा करेंगे। बाकी सब कुछ विकल्पों का एक सेट है जिसके आधार पर पैरामीटर में परिवर्तन होता है:

 case kGain: mGain = GetParam(kGain)->Value() / 100.; break;
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जैसा कि हम याद करते हैं, kGain



0 से 100 में बदलता है। इसलिए मान को 100 से विभाजित करने के बाद, हम mGain



वर्ग private



सदस्य private



0 से 1 private



मान प्रदान करते हैं।



इसलिए, हमने GUI और बाइंडिंग पैरामीटर जैसे mGain



बनाने की प्रक्रिया पर थोड़ा ध्यान mGain



। आइए अब एक नज़र डालते हैं कि प्लगइन आने वाले ऑडियो को कैसे संभालता है। हमारे मामले में, एक ऑडियो स्ट्रीम एक double



डेटा प्रकार द्वारा दर्शाए गए नमूनों का एक क्रम है, जिनमें से प्रत्येक में एक निश्चित समय पर संकेत आयाम शामिल हैं।

ProcessDoubleReplacing



फ़ंक्शन के लिए दिया गया पहला पैरामीटर double** inputs



। double



का एक क्रम double*



का उपयोग करके पारित किया जा सकता है। लेकिन प्लगइन दो चैनलों (स्टीरियो) या इससे भी अधिक की प्रक्रिया करता है, इसलिए हमें नमूनों के कई दृश्यों की आवश्यकता होती है, और हम इसे double**



साथ संवाद करते हैं। फ़ंक्शन की पहली दो पंक्तियाँ यह दर्शाती हैं:

 double* in1 = inputs[0]; double* in2 = inputs[1];
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

in1



नमूनों (बाएं चैनल) के पहले अनुक्रम को इंगित करता है, in2



सही चैनल के नमूने इंगित करता है। आउटपुट बफर के लिए समान कार्य करने के बाद, हम इनपुट और आउटपुट बफर के तत्वों पर पुनरावृति कर सकते हैं:

 for (int s = 0; s < nFrames; ++s, ++in1, ++in2, ++out1, ++out2) { *out1 = *in1 * mGain; *out2 = *in2 * mGain; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

प्रत्येक नमूने के लिए, हम एक इनपुट मूल्य लेते हैं, इसे mGain



द्वारा गुणा करें और इसे आउटपुट बफर पर लिखें। nFrames



हमें बताता है कि प्रति चैनल कितने नमूने उपलब्ध हैं ताकि हम बफ़र्स की लंबाई जान सकें।

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











Reset



फ़ंक्शन में ब्रेकपॉइंट सेट Reset



। दाईं ओर नमूना दर बदलें और परिवर्तन लागू करें। डीबगर Reset



फ़ंक्शन में कोड निष्पादन को बाधित करेगा। नीचे दाईं ओर, जहां lldb



काम करता है, टाइप करें print GetSampleRate()



।







कृपया ध्यान दें कि आप डिबगर से किसी भी फ़ंक्शन को कॉल कर सकते हैं और सही मान देख सकते हैं। जब आप इसे देखते हैं तो ऊपरी बाईं ओर स्थित स्टॉप पर क्लिक करें और जारी रखने का निर्णय लें।

अब कोड से एक प्लगइन बनाने और इसे होस्ट पर अपलोड करने का समय है। यह अगली पोस्ट का विषय होगा।

इस बीच,

अतिरिक्त पढ़ने

कुछ अंतरालों को भरने के लिए, मैं इन स्लाइडों को आविष्कारशील श्री ओली लार्किन द्वारा पढ़ने की सलाह देता हूं। उनमें WDL-OL के बारे में कुछ महत्वपूर्ण स्पष्टीकरण हैं।



मूल लेख:

martin-finke.de/blog/articles/audio-plugins-003-examining-the-code