README - 31 जनवरी 2019

WebM VP8/VP9 कोडेक SDK में आपका स्वागत है!

एप्लिकेशन/लाइब्रेरी संकलित करना: उपयोग की जाने वाली बिल्ड प्रणाली autotools के समान है। बिल्डिंग में आम तौर पर आपकी वांछित बिल्ड विकल्पों के साथ "कॉन्फ़िगर" करना और फिर GNU make का उपयोग करके एप्लिकेशन बनाना शामिल है।

1. पूर्वापेक्षाएँ

* सभी x86 लक्ष्यों के लिए Yasm[1] असेंबलर स्थापित होना आवश्यक है[2]।

* सभी Windows बिल्ड के लिए Cygwin[3] स्थापित होना आवश्यक है।
* दस्तावेज़ीकरण बनाने के लिए Doxygen[4] की आवश्यकता है। यदि आपके पास यह पैकेज नहीं है, तो install-docs विकल्प अक्षम कर दिया जाएगा।
* यूनिट परीक्षणों के लिए डेटा डाउनलोड करने के लिए curl[5] और sha1sum की आवश्यकता है। sha1sum GNU coreutils के माध्यम से प्रदान किया जाता है, जो कई *nix प्लेटफार्मों के साथ-साथ MinGW और Cygwin पर डिफ़ॉल्ट रूप से स्थापित होता है। यदि coreutils उपलब्ध नहीं है, तो sha1sum का एक संगत संस्करण स्रोत से बनाया जा सकता है[6]। यदि यूनिट परीक्षण नहीं चलाए जा रहे हैं तो ये आवश्यकताएँ वैकल्पिक हैं।

[1]: http://www.tortall.net/projects/yasm
[2]: Visual Studio के लिए, आधार yasm बाइनरी (vsyasm नहीं) Visual Studio के PATH में होनी चाहिए। VS2017 के लिए, yasm-<version>-<arch>.exe का नाम बदलकर yasm.exe करना और इसे यहाँ रखना पर्याप्त है:
     Program Files (x86)/Microsoft Visual Studio/2017/<level>/Common7/Tools/
[3]: http://www.cygwin.com
[4]: http://www.doxygen.org
[5]: http://curl.haxx.se
[6]: http://www.microbrew.org/tools/md5sha1sum/

2. आउट-ऑफ-ट्री बिल्ड आउट ऑफ ट्री बिल्ड एप्लिकेशन बनाने की एक समर्थित विधि है। आउट ऑफ ट्री बिल्ड के लिए, स्रोत ट्री को संकलन के दौरान उत्पन्न ऑब्जेक्ट फ़ाइलों से अलग रखा जाता है। उदाहरण के लिए:

$ mkdir build
$ cd build
$ ../libvpx/configure <options>
$ make

3. कॉन्फ़िगरेशन विकल्प 'configure' स्क्रिप्ट कई विकल्पों का समर्थन करती है। --help विकल्प का उपयोग समर्थित विकल्पों की सूची प्राप्त करने के लिए किया जा सकता है: $ ../libvpx/configure --help

4. कंपाइलर विश्लेषक कंपाइलरों ने सैनिटाइज़र जोड़े हैं जो बाइनरी को पता गणना, मेमोरी उपयोग, थ्रेडिंग, अपरिभाषित व्यवहार और अन्य सामान्य त्रुटियों के बारे में जानकारी के साथ इंस्ट्रूमेंट करते हैं। libvpx को इनमें से कुछ सुविधाओं के साथ बनाने को सरल बनाने के लिए, कॉन्फ़िगर चलाने से पहले tools/set_analyzer_env.sh का उपयोग करें। यह बिल्डिंग के लिए कंपाइलर और आवश्यक फ़्लैग्स सेट करेगा, साथ ही बाइनरी का परीक्षण करते समय विश्लेषक द्वारा पढ़े जाने वाले पर्यावरण चर भी सेट करेगा। $ source ../libvpx/tools/set_analyzer_env.sh address

5. क्रॉस डेवलपमेंट क्रॉस डेवलपमेंट के लिए, सबसे उल्लेखनीय विकल्प --target विकल्प है। समर्थित लक्ष्यों की सबसे अद्यतित सूची configure स्क्रिप्ट के --help आउटपुट के नीचे पाई जा सकती है। इस लेखन के समय, उपलब्ध लक्ष्यों की सूची है:

arm64-android-gcc

arm64-darwin-gcc
arm64-linux-gcc
arm64-win64-gcc
arm64-win64-vs15
armv7-android-gcc
armv7-darwin-gcc
armv7-linux-rvct
armv7-linux-gcc
armv7-none-rvct
armv7-win32-gcc
armv7-win32-vs14
armv7-win32-vs15
armv7s-darwin-gcc
armv8-linux-gcc
mips32-linux-gcc
mips64-linux-gcc
ppc64le-linux-gcc
sparc-solaris-gcc
x86-android-gcc
x86-darwin8-gcc
x86-darwin8-icc
x86-darwin9-gcc
x86-darwin9-icc
x86-darwin10-gcc
x86-darwin11-gcc
x86-darwin12-gcc
x86-darwin13-gcc
x86-darwin14-gcc
x86-darwin15-gcc
x86-darwin16-gcc
x86-darwin17-gcc
x86-iphonesimulator-gcc
x86-linux-gcc
x86-linux-icc
x86-os2-gcc
x86-solaris-gcc
x86-win32-gcc
x86-win32-vs14
x86-win32-vs15
x86_64-android-gcc
x86_64-darwin9-gcc
x86_64-darwin10-gcc
x86_64-darwin11-gcc
x86_64-darwin12-gcc
x86_64-darwin13-gcc
x86_64-darwin14-gcc
x86_64-darwin15-gcc
x86_64-darwin16-gcc
x86_64-darwin17-gcc
x86_64-iphonesimulator-gcc
x86_64-linux-gcc
x86_64-linux-icc
x86_64-solaris-gcc
x86_64-win64-gcc
x86_64-win64-vs14
x86_64-win64-vs15
generic-gnu

generic-gnu लक्ष्य, CROSS पर्यावरण चर के साथ, उन आर्किटेक्चर को क्रॉस कंपाइल करने के लिए उपयोग किया जा सकता है जो स्पष्ट रूप से सूचीबद्ध नहीं हैं, यदि टूलचेन एक क्रॉस GNU (gcc/binutils) टूलचेन है। अन्य POSIX टूलचेन भी संभवतः काम करेंगी। उदाहरण के लिए, mipsel-linux-uclibc टूलचेन का उपयोग करके बनाने के लिए, निम्नलिखित कमांड का उपयोग किया जा सकता है (ध्यान दें, POSIX SH सिंटैक्स, अपने शेल के अनुसार अनुकूलित करें):

$ CROSS=mipsel-linux-uclibc- ../libvpx/configure

इसके अलावा, आह्वान किए जाने वाले निष्पादन योग्य को पर्यावरण चर निर्दिष्ट करके ओवरराइड किया जा सकता है: CC, AR, LD, AS, STRIP, NM। इन निष्पादन योग्यों को CFLAGS, LDFLAGS, और ASFLAGS के साथ अतिरिक्त फ़्लैग्स पास किए जा सकते हैं।

6. कॉन्फ़िगरेशन त्रुटियाँ यदि कॉन्फ़िगरेशन चरण विफल होता है, तो पहला कदम त्रुटि लॉग को देखना है। यह डिफ़ॉल्ट रूप से config.log होता है। इससे यह अच्छा संकेत मिलना चाहिए कि क्या गलत हुआ। यदि नहीं, तो सहायता के लिए हमसे संपर्क करें।

VP8/VP9 परीक्षण वेक्टर: परीक्षण वेक्टर को कॉन्फ़िगर चलाने के बाद बिल्ड सिस्टम का उपयोग करके डाउनलोड और सत्यापित किया जा सकता है। एक वैकल्पिक निर्देशिका निर्दिष्ट करने के लिए LIBVPX_TEST_DATA_PATH पर्यावरण चर का उपयोग किया जा सकता है।

$ ./configure --enable-unit-tests $ LIBVPX_TEST_DATA_PATH=../libvpx-test-data make testdata

कोड शैली: इस परियोजना द्वारा उपयोग की जाने वाली कोडिंग शैली को रिपॉजिटरी के रूट में .clang-format फ़ाइल में निहित कॉन्फ़िगरेशन का उपयोग करके clang-format के साथ लागू किया जाता है।

समीक्षा के लिए बदलाव करने से पहले आप अपने कोड को इस प्रकार फ़ॉर्मेट कर सकते हैं:

संशोधित .c, .h और .cc फ़ाइलों पर clang-format लागू करें

$ clang-format -i --style=file
$(git diff --name-only --diff-filter=ACMR '.[hc]' '.cc')

यदि आपके स्थानीय फ़ॉर्मेटिंग और समीक्षा प्रणाली के बीच कोई अंतर है, तो इसे उत्पन्न करने के लिए उपयोग किए गए संस्करण के लिए .clang-format फ़ाइल देखें।

यह भी देखें: http://clang.llvm.org/docs/ClangFormat.html

समर्थन यह लाइब्रेरी एक ओपन सोर्स प्रोजेक्ट है जो अपने समुदाय द्वारा समर्थित है। कृपया सहायता के लिए [email protected] पर ईमेल करें।