पीडीएफ दस्तावेजों को प्रदर्शित करने के लिए मोनोटॉक ओपनसोर्स पुस्तकालय

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


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

• UIWebView निस्संदेह एक अच्छी बात है, लेकिन केवल डेमो प्रोजेक्ट के लिए उपयुक्त है। यद्यपि नियंत्रण विभिन्न दस्तावेज़ प्रारूपों का एक गुच्छा प्रदर्शित कर सकता है, प्रदर्शन की गुणवत्ता बहुत कुछ दस्तावेज़ की सामग्री पर निर्भर करती है। Word दस्तावेज़, Excel अंतरात्मा की आवाज़ के बिना काट देता है, और कुछ PDF दस्तावेज़ एक इनर एक्सेप्शन की रिपोर्टिंग नहीं करते हैं।
  
• QLPreviewController - नाम से देखते हुए, दस्तावेज़ों के प्रारंभिक प्रदर्शन के लिए अभिप्रेत चीज का उपयोग MacOS में किया जाता है। इसमें UIWebView जैसे MS Office दस्तावेज़ों की समस्याएं हैं। पीडीएफ के लिए, यह सब कुछ खोलता है (अच्छी तरह से, मान लें - 99%), लेकिन यह दृश्य समायोजन और नई सुविधाओं में खराब होने के अधीन नहीं है, अर्थात। आम तौर पर इसे अपने कार्यक्रम में एकीकृत करने से काम नहीं चलेगा।
  
• पीडीएफ दस्तावेजों को प्रदर्शित करने के लिए थर्ड-पार्टी ऑब्जेक्टिव-सी लाइब्रेरी शक्तिशाली लाइब्रेरी हैं जो आईओएस पर पीडीएफ दर्शक द्वारा आवश्यक लगभग सभी सुविधाओं को लागू करती हैं। लेकिन, फिर से, अनुकूलन के साथ एक समस्या है, उनकी बहुत अधिक लागत (> 500 EUR) और मोनोटच में उपयोग के लिए रैपर बनाने की आवश्यकता है, और बहुत सारी खुली कक्षाओं के साथ एक पुस्तकालय के लिए, यह सबसे तुच्छ कार्य नहीं है।
  

अंत में, मैंने धैर्य (कॉफी के बहुत सारे) पर स्टॉक करने का फैसला किया, और अपनी उत्कृष्ट कृति बाइक लिखने के लिए आगे बढ़ा। पुस्तकालय बनाने से पहले, मैंने इसकी विशेषताओं की एक सूची को परिभाषित किया:

• पन्ने पलटने के दो विकल्प।
• ऑटो पेज स्केलिंग।
• गुणवत्ता पृष्ठ प्रदर्शन।
• विस्तृत पृष्ठ स्केलिंग।
• बुकमार्क।
• नोट्स।
• थंबनेल।
• विकल्प सेट करना।
• लिंक की परिभाषा।
• खोजें।
• किसी दस्तावेज़ की सामग्री या संरचना की परिभाषा।
• केवल कोको टच वर्गों का उपयोग करें।
• 100 एमबी से अधिक के "बड़े" दस्तावेजों का प्रदर्शन।

बेशक, उसके पास समय नहीं था या वह अपने सभी विचारों को महसूस नहीं कर सकता था, शायद उसके हाथ किसी दिन बाद में पहुंचेंगे। लिंक की परिभाषा और दस्तावेज़ की सामग्री, साथ ही दस्तावेज़ में खोज, अभी तक लागू नहीं हुई है।

पेज टर्निंग

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



मैंने क्षैतिज और ऊर्ध्वाधर पृष्ठ मोड़ लागू किए। वास्तविक स्क्रॉलिंग तब होती है जब आप वर्तमान दृश्य को बाईं या ऊपर (आगे स्क्रॉल करने के लिए) और दाईं ओर या नीचे (वापस स्क्रॉल करने के लिए) खींचते हैं।

एल्गोरिथ्म सरल है। यह सारा व्यवसाय UIScrollViewController के उत्तराधिकारी DocumentViewController में लागू किया गया है। मैं दृश्य को संग्रहीत करने के लिए एक सूची (सरणी नहीं) का उपयोग करता हूं। वर्तमान दृश्य को स्थानांतरित करते समय (जब अगला पृष्ठ पहला या अंतिम नहीं होता है), एक नया दृश्य बनाया जाता है और सूची में जोड़ा जाता है, वांछित पीडीएफ पृष्ठ को नए दृश्य में लोड किया जाता है, और अप्रयुक्त दृश्य (सूची में पहला) सूची से हटा दिया जाता है। इसके अलावा, SrollView.Position को केंद्रीय प्रदर्शन स्थिति में स्थानांतरित कर दिया जाता है, अर्थात। दृश्य सूची में दूसरा।

public virtual void OpenDocumentPage(int pageNumber) { if (PDFDocument.DocumentHasLoaded && (pageNumber != PDFDocument.CurrentPageNumber)) { if ((pageNumber < 1) || (pageNumber > PDFDocument.PageCount)) { return; } // Set current page PDFDocument.CurrentPageNumber = pageNumber; // Calc min, max page int minValue; int maxValue; if (PDFDocument.PageCount <= MaxPageViewsCount) { minValue = 1; maxValue = PDFDocument.PageCount; } else { minValue = PDFDocument.CurrentPageNumber - 1; maxValue = PDFDocument.CurrentPageNumber + 1; if (minValue < 1) { minValue++; maxValue++; } else if (maxValue > PDFDocument.PageCount) { minValue--; maxValue--; } } // Create/update page views for displayed pages var unusedPageViews = new List<PageView>(mPageViews); RectangleF viewRect = GetScrollViewSubViewFrame(); for (int i = minValue, j = 0; i <= maxValue; i++,j++) { PageView pageView = mPageViews.FirstOrDefault(v => v.PageNumber == i); if (pageView == null) { pageView = new PageView(viewRect, i); mScrollView.AddSubview(pageView); mPageViews.Add(pageView); } else { pageView.Frame = viewRect; pageView.PageNumber = i; pageView.ZoomReset(); unusedPageViews.Remove(pageView); } viewRect = CalcFrameForNextPage(viewRect); if (i == PDFDocument.CurrentPageNumber) { mCurrentPageView = pageView; } } // Clear unused page views foreach (var view in unusedPageViews) { view.RemoveFromSuperview(); mPageViews.Remove(view); } // Update scroll view content offset UpdateScrollViewContentOffset(); } } 

पृष्ठ का उच्च-गुणवत्ता वाला प्रदर्शन और स्केलिंग

पृष्ठ को प्रदर्शित करने के दृश्य में वास्तव में तीन दृश्य हैं:

• PageView (UIScrollView से विरासत में मिला) DocumentViewController में जोड़ा गया है।
• PageContentView (UIView से विरासत में मिला) PageView में जोड़ा गया है।
• ThumbView (UIPageView से विरासत में मिला) PageView में जोड़ा गया है।

पेज को स्केल करने के लिए पहले व्यू की जरूरत होती है, दूसरी - पेज की हाई-क्वालिटी डिस्प्ले के लिए, तीसरी - पेज की अस्थायी इमेज के लिए जरूरी होती है।

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

वास्तव में स्वयं पीडीएफ पृष्ठ प्रदर्शित करना बहुत सरल है:

 private void Draw(CGContext context) { if (!PDFDocument.DocumentHasLoaded) { return; } // Draw page context.SetFillColor(1.0f, 1.0f, 1.0f, 1.0f); using (CGPDFPage pdfPage = PDFDocument.GetPage(mPageNumber)) { context.TranslateCTM(0, Bounds.Height); context.ScaleCTM(1.0f, -1.0f); context.ConcatCTM(pdfPage.GetDrawingTransform(CGPDFBox.Crop, Bounds, 0, true)); context.SetRenderingIntent(CGColorRenderingIntent.Default); context.InterpolationQuality = CGInterpolationQuality.Default; context.DrawPDFPage(pdfPage); } } 

बुकमार्क और नोट्स

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

दरअसल, दोनों मैनेजर एक-दूसरे के समान हैं। उनके पास डेटा लोड करने, सहेजने और हटाने के तरीके हैं। अधिकांश विधियाँ आभासी हैं। डॉक्यूमेंट क्रमशः DocumentBookmark और DocumentNote के डेटा ऑब्जेक्ट पर काम करते हैं।

क्योंकि, मोनोटॉक में जेनेरिक प्रकारों जैसी कोई अद्भुत चीज नहीं है, प्रबंधकों को सक्रिय करने का तंत्र, मुझे वास्तव में पसंद नहीं है। मैंने एक ObjectActivator वर्ग बनाया, जिसमें एप्लिकेशन स्टार्टअप पर प्रबंधकों को त्वरित करने के तरीके हैं। तदनुसार, प्रबंधक वर्गों की विरासत के मामले में, नए उदाहरणों को ऑब्जेक्टएक्टीवेटर के साथ पंजीकृत होना चाहिए:

 public class MyObjectsActivator : ObjectsActivator { /// <summary> /// Returns DocumentNoteManager instance /// </summary> /// <returns></returns> protected override DocumentNoteManager CreateDocumentNoteManager() { return new MyDocumentNoteManager(); } /// <summary> /// Returns DocumentBookmarkManager instance /// </summary> /// <returns></returns> protected override DocumentBookmarkManager CreateDocumentBookmarkManager() { return new MyDocumentBookmarkManager(); } } 

पेज थंबनेल

पृष्ठ थंबनेल प्रदर्शित करने के लिए, उसी दृष्टिकोण का उपयोग स्वयं पृष्ठों को प्रदर्शित करने के लिए किया जाता है, इस अपवाद के साथ कि थंबनेल के मामले में, एक समय में एक से अधिक पृष्ठ प्रदर्शित होते हैं और नए दृश्य बनाने के लिए थोड़ा अलग एल्गोरिथ्म। इसके अलावा, थंबनेल के लिए स्क्रॉल दृश्य सामग्री क्षेत्र की चौड़ाई सभी पृष्ठ थंबनेल प्लस पैडिंग की चौड़ाई का योग है।

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

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

परिणाम

सामान्य तौर पर, यह सब, यदि आपके प्रश्न / टिप्पणी / सुझाव हैं, तो टिप्पणियों में लिखें, मैं खुशी के साथ जवाब दूंगा (हमेशा नहीं)।


GitHub पुस्तकालय के स्रोत: github.com/AlexanderMac/mTouch-PDFReader