ImageEmbedder

পাবলিক চূড়ান্ত ক্লাস ImageEmbedder

ইমেজ এম্বেডিং নিষ্কাশন সঞ্চালন.

API ঐচ্ছিক, কিন্তু দৃঢ়ভাবে সুপারিশকৃত, TFLite মডেল মেটাডেটা সহ একটি TFLite মডেল আশা করে। .

API একটি ইমেজ ইনপুট টেনসর এবং এক বা একাধিক আউটপুট টেনসর সহ মডেলগুলিকে সমর্থন করে। আরো নির্দিষ্ট হতে, এখানে প্রয়োজনীয়তা আছে.

  • ইনপুট ইমেজ টেনসর ( kTfLiteUInt8 / kTfLiteFloat32 )
    • আকারের ইমেজ ইনপুট [batch x height x width x channels]
    • ব্যাচ অনুমান সমর্থিত নয় ( batch 1 হতে হবে)।
    • শুধুমাত্র RGB ইনপুট সমর্থিত ( channels 3 হতে হবে)।
    • টাইপ kTfLiteFloat32 হলে, ইনপুট স্বাভাবিককরণের জন্য মেটাডেটার সাথে স্বাভাবিককরণ বিকল্পগুলি সংযুক্ত করা প্রয়োজন।
  • আকৃতি [1 x N] সহ কমপক্ষে একটি আউটপুট টেনসর ( kTfLiteUInt8 / kTfLiteFloat32 ) যেখানে উৎপাদিত এমবেডিংগুলিতে N হল মাত্রার সংখ্যা।

নেস্টেড ক্লাস

ক্লাস ImageEmbedder.ImageEmbedderOptions সেট আপ এবং ImageEmbedder এর জন্য বিকল্প।

পাবলিক পদ্ধতি

স্ট্যাটিক ডবল
কোসাইন সাদৃশ্য ( এম্বেডিং u, এম্বেডিং v)
দুটি Embedding বস্তুর মধ্যে কোসাইন সাদৃশ্য গণনা করার জন্য ইউটিলিটি ফাংশন।
স্ট্যাটিক ইমেজ এমবেডার
createFromBuffer (প্রসঙ্গ প্রসঙ্গ, বাইটবাফার মডেলবাফার)
একটি মডেল বাফার এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।
স্ট্যাটিক ইমেজ এমবেডার
createFromFile (প্রসঙ্গ প্রসঙ্গ, স্ট্রিং মডেলপথ)
একটি মডেল ফাইল এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।
স্ট্যাটিক ইমেজ এমবেডার
createFromFile (প্রসঙ্গ প্রসঙ্গ, ফাইল মডেল ফাইল )
একটি মডেল ফাইল এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।
স্ট্যাটিক ইমেজ এমবেডার
createFromOptions (প্রসঙ্গ প্রসঙ্গ, ImageEmbedder.ImageEmbedderOptions বিকল্প)
একটি ImageEmbedder.ImageEmbedderOptions উদাহরণ থেকে একটি ImageEmbedder দৃষ্টান্ত তৈরি করে।
ইমেজ এমবেডার ফলাফল
এম্বেড ( MPImage image, ImageProcessingOptions imageProcessing Options)
প্রদত্ত একক চিত্রে এমবেডিং নিষ্কাশন সম্পাদন করে।
ইমেজ এমবেডার ফলাফল
এম্বেড ( এমপিইমেজ ইমেজ)
ডিফল্ট ইমেজ প্রসেসিং বিকল্পগুলির সাথে প্রদত্ত একক চিত্রে এমবেডিং নিষ্কাশন সম্পাদন করে, যেমন
অকার্যকর
embedAsync ( MPImage image, ImageProcessingOptions imageProcessing Options, long timestampMs)
এমবেডিং এক্সট্রাকশন সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায় এবং ফলাফলগুলি ImageEmbedder.ImageEmbedderOptions এ দেওয়া OutputHandler.ResultListener এর মাধ্যমে পাওয়া যাবে।
অকার্যকর
এমবেডঅ্যাসিঙ্ক ( এমপিইমেজ ইমেজ, লং টাইমস্ট্যাম্প এমএস)
ডিফল্ট ইমেজ প্রক্রিয়াকরণ বিকল্পগুলির সাথে এমবেডিং নিষ্কাশন সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায়, যেমন
ইমেজ এমবেডার ফলাফল
এম্বেডফরভিডিও ( MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)
প্রদত্ত ভিডিও ফ্রেমে এমবেডিং নিষ্কাশন সম্পাদন করে।
ইমেজ এমবেডার ফলাফল
এমবেডফরভিডিও ( এমপিইমেজ ইমেজ, লং টাইমস্ট্যাম্প)
প্রদত্ত ভিডিও ফ্রেমে ডিফল্ট চিত্র প্রক্রিয়াকরণ বিকল্পগুলির সাথে এমবেডিং নিষ্কাশন সম্পাদন করে, যেমন

উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতি

পাবলিক পদ্ধতি

পাবলিক স্ট্যাটিক ডাবল কোসাইন সাদৃশ্য ( এম্বেডিং u, এম্বেডিং v)

দুটি Embedding বস্তুর মধ্যে কোসাইন সাদৃশ্য গণনা করার জন্য ইউটিলিটি ফাংশন।

পরামিতি
u
v
নিক্ষেপ করে
অবৈধ আর্গুমেন্ট ব্যতিক্রম যদি এমবেডিংগুলি বিভিন্ন ধরণের হয় (ফ্লোট বনাম কোয়ান্টাইজড), বিভিন্ন আকারের হয়, বা L2-নর্ম 0 থাকে।

পাবলিক স্ট্যাটিক ইমেজ এমবেডার createFromBuffer (প্রসঙ্গ প্রসঙ্গ, বাইটবাফার মডেলবাফার)

একটি মডেল বাফার এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context)
মডেলবাফার একটি সরাসরি ByteBuffer বা এমবেডিং মডেলের একটি ERROR(/MappedByteBuffer)
নিক্ষেপ করে
ImageEmbedder তৈরির সময় যদি কোনো ত্রুটি থাকে।

পাবলিক স্ট্যাটিক ইমেজ এমবেডার createFromFile (প্রসঙ্গ প্রসঙ্গ, স্ট্রিং মডেলপথ)

একটি মডেল ফাইল এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context)
মডেলপথ সম্পদে এমবেডিং মডেলের পথ।
নিক্ষেপ করে
ImageEmbedder তৈরির সময় যদি কোনো ত্রুটি থাকে।

পাবলিক স্ট্যাটিক ইমেজ এমবেডার createFromFile (প্রসঙ্গ প্রসঙ্গ, ফাইল মডেলফাইল)

একটি মডেল ফাইল এবং ডিফল্ট ImageEmbedder.ImageEmbedderOptions থেকে একটি ImageEmbedder উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context)
মডেল ফাইল এমবেডিং মডেল File উদাহরণ।
নিক্ষেপ করে
IO ব্যতিক্রম tflite মডেল ফাইল খোলার সময় যদি একটি I/O ত্রুটি ঘটে।
ImageEmbedder তৈরির সময় যদি কোনো ত্রুটি থাকে।

পাবলিক স্ট্যাটিক ImageEmbedder createFromOptions (প্রসঙ্গ প্রসঙ্গ, ImageEmbedder.ImageEmbedderOptions বিকল্প)

একটি ImageEmbedder.ImageEmbedderOptions উদাহরণ থেকে একটি ImageEmbedder দৃষ্টান্ত তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context)
বিকল্প একটি ImageEmbedder.ImageEmbedderOptions উদাহরণ।
নিক্ষেপ করে
ImageEmbedder তৈরির সময় যদি কোনো ত্রুটি থাকে।

সর্বজনীন ImageEmbedderResult এম্বেড ( MPImage image, ImageProcessingOptions imageProcessingOptions)

প্রদত্ত একক চিত্রে এমবেডিং নিষ্কাশন সম্পাদন করে। শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন যখন ImageEmbedder ERROR(/RunningMode.IMAGE) দিয়ে তৈরি করা হয়।

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

সর্বজনীন ImageEmbedderResult এম্বেড ( MPImage image)

ডিফল্ট ইমেজ প্রসেসিং অপশন সহ প্রদত্ত একক ইমেজে এমবেডিং এক্সট্রাকশন সঞ্চালন করে, অর্থাৎ সমগ্র ইমেজটিকে আগ্রহের অঞ্চল হিসেবে ব্যবহার করে এবং কোনো ঘূর্ণন প্রয়োগ ছাড়াই। শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন যখন ImageEmbedder ERROR(/RunningMode.IMAGE) দিয়ে তৈরি করা হয়।

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

সর্বজনীন অকার্যকর এমবেডঅ্যাসিঙ্ক ( MPImage ইমেজ, ImageProcessingOptions imageProcessingOptions, long timestampMs)

এমবেডিং এক্সট্রাকশন সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায় এবং ফলাফলগুলি ImageEmbedder.ImageEmbedderOptions এ দেওয়া OutputHandler.ResultListener এর মাধ্যমে পাওয়া যাবে। ERROR(/RunningMode.LIVE_STREAM) দিয়ে ImageEmbedder তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

অবজেক্ট ডিটেক্টরে ইনপুট ইমেজ কখন পাঠানো হয় তা নির্দেশ করার জন্য এটি একটি টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

পাবলিক ভ্যাইড এমবেডঅ্যাসিঙ্ক ( এমপিইমেজ ইমেজ, লং টাইমস্ট্যাম্পএম)

ডিফল্ট ইমেজ প্রসেসিং বিকল্পগুলির সাথে এমবেডিং নিষ্কাশন করতে লাইভ ইমেজ ডেটা পাঠায়, অর্থাত্‍ সমগ্র ছবিটিকে আগ্রহের অঞ্চল হিসাবে ব্যবহার করে এবং কোনও ঘূর্ণন প্রয়োগ ছাড়াই, এবং ফলাফলগুলি ImageEmbedder.ImageEmbedderOptions এ প্রদত্ত OutputHandler.ResultListener এর মাধ্যমে পাওয়া যাবে। ERROR(/RunningMode.LIVE_STREAM) দিয়ে ImageEmbedder তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

অবজেক্ট ডিটেক্টরে ইনপুট ইমেজ কখন পাঠানো হয় তা নির্দেশ করার জন্য এটি একটি টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

সর্বজনীন ImageEmbedderResult embedForVideo ( MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

প্রদত্ত ভিডিও ফ্রেমে এমবেডিং নিষ্কাশন সম্পাদন করে। শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন যখন ImageEmbedder ERROR(/RunningMode.VIDEO) দিয়ে তৈরি করা হয়।

ভিডিও ফ্রেমের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

সর্বজনীন ImageEmbedderResult embedForVideo ( MPImage image, long timestampMs)

প্রদত্ত ভিডিও ফ্রেমে ডিফল্ট ইমেজ প্রসেসিং বিকল্পের সাথে এমবেডিং এক্সট্রাকশন সঞ্চালন করে, যেমন সমগ্র ইমেজটিকে আগ্রহের অঞ্চল হিসেবে ব্যবহার করে এবং কোনো ঘূর্ণন প্রয়োগ ছাড়াই। শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন যখন ImageEmbedder ERROR(/RunningMode.VIDEO) দিয়ে তৈরি করা হয়।

ভিডিও ফ্রেমের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ImageEmbedder নিম্নলিখিত রঙ স্পেস প্রকার সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।