راهنمای کاربر دوربین میکروسکوپ EXCELITAS TECHNOLOGIES pco.convert

اطلاعات عمومی
pco.convert عملکردهای مختلفی را برای تبدیل رنگ و شبه رنگ ارائه می دهد. پیروی از دستورالعمل های ارائه شده در دفترچه راهنمای کاربر برای عملکرد بهینه بسیار مهم است.

تبدیل توضیحات تابع API
Convert API مجموعه ای از توابع را برای دستکاری داده های رنگ و تصویر فراهم می کند. در زیر برخی از عملکردهای کلیدی آورده شده است:

- PCO_ConvertCreate: یک نمونه تبدیل جدید ایجاد کنید.
- PCO_ConvertDelete: یک نمونه تبدیل را حذف کنید.
- PCO_ConvertGet: تنظیمات تبدیل را دریافت کنید.

تبدیل رنگ و شبه رنگ
pco.convert از تبدیل سیاه و سفید و همچنین تبدیل رنگ پشتیبانی می کند. دستورالعمل های خاص ارائه شده در دفترچه راهنما را برای هر نوع تبدیل دنبال کنید.

سوالات متداول

س: چگونه با استفاده از pco.convert تبدیل رنگ را انجام دهم؟
- A: برای انجام یک تبدیل رنگ، از تابع PCO_ConvertGet با پارامترهای مناسب همانطور که در دفترچه راهنمای کاربر ذکر شده است استفاده کنید.
س: آیا می توانم یک نمونه تبدیل را حذف کنم؟
- پاسخ: بله، می توانید یک نمونه تبدیل را با استفاده از تابع PCO_ConvertDelete حذف کنید.

راهنمای کاربر
pco.convert

Excelitas PCO GmbH از شما می خواهد که دستورالعمل های این سند را به دقت بخوانید و دنبال کنید. برای هر گونه سوال یا نظر، لطفا در هر زمان با ما تماس بگیرید.

تلفن: + 49 (0) 9441 2005 50

نمابر: + 49 (0) 9441 2005 20
آدرس پستی: Excelitas PCO GmbH Donaupark 11 93309 Kelheim، آلمان
ایمیل: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
راهنمای کاربر 1.52.0
مه 2024 منتشر شد
©Copyright Excelitas PCO GmbH

این اثر تحت مجوز Creative Commons Attribution-NoDerivatives 4.0 International مجوز دارد. به view یک کپی از این مجوز، مراجعه کنید http://creativecommons.org/licenses/by-nd/4.0/ یا نامه ای به Creative Commons، صندوق پستی 1866، Mountain ارسال کنید View, CA 94042, USA.

ژنرال

این توضیح SDK تبدیل را می توان برای پیاده سازی روال تبدیل PCO در برنامه های اختصاصی، که برای کنترل دوربین های PCO استفاده می شود، استفاده کرد. استفاده از روال تبدیل با دوربین های شخص ثالث ممنوع است.
را pco.convert sdk از دو بخش تشکیل شده است: توابع تبدیل LUT pco.conv.dll و توابع گفتگو pco_cdlg.dll .
توابع تبدیل برای تبدیل مناطق داده، b/w و رنگ، با وضوح بیش از 8 بیت در هر پیکسل به مناطق داده b/w با وضوح 8 بیت در پیکسل یا مناطق داده رنگی با وضوح 24 استفاده می شود. (32) بیت در هر پیکسل. DLL همچنین شامل توابعی برای ایجاد و پر کردن اشیاء تبدیل مختلف است.
بخش دوم API شامل توابع محاوره ای است. دیالوگ ها گفتگوهای ساده رابط کاربری گرافیکی هستند که کاربر را قادر می سازد تا پارامترهای اشیاء تبدیل را تنظیم کند. توابع محاوره ای در pco_cdlg.dll و بر اساس برخی از عملکردهای pco.conv.dll هستند.
در pco.sdk برای دوربین های pco دو دوربین وجود داردamples، که از تبدیل sdk استفاده می کنند. یکی Test_cvDlg s استample و دیگری sc2_demo است. لطفاً به آن ها نگاهی بیندازیدamples به منظور «دیدن» توابع تبدیل sdk در عمل.

تبدیل B/W و شبه رنگ
الگوریتم تبدیل مورد استفاده در تابع b/w بر اساس روال ساده زیر است

کجا

pos متغیر شمارنده است
dataout ناحیه داده خروجی است
datain ناحیه داده ورودی است

lutbw یک منطقه داده با اندازه 2n است که حاوی LUT است، که در آن n = وضوح ناحیه ورودی بر حسب بیت در پیکسل است.

در تابع شبه رنگ، روال اصلی برای تبدیل به یک ناحیه داده RGB عبارت است از:

کجا

pos متغیر شمارنده ورودی است
pout متغیر شمارنده خروجی است

dataout ناحیه داده خروجی است
datain ناحیه داده ورودی است
lutbw یک منطقه داده با اندازه 2n است که حاوی LUT است، که در آن n = وضوح ناحیه ورودی بر حسب بیت در پیکسل است.

lutred، lutgreen، lutblue مناطق داده ای با اندازه 2n هستند که حاوی LUT هستند، جایی که n = وضوح منطقه خروجی بر حسب بیت در پیکسل است.

تبدیل رنگ

سنسورهای رنگی CCD که در دوربین های رنگی PCO استفاده می شوند دارای فیلترهایی برای رنگ های قرمز، سبز و آبی هستند. هر پیکسل یک نوع فیلتر دارد، بنابراین در اصل اطلاعات رنگی کامل برای هر پیکسل دریافت نمی کنید. در عوض هر پیکسل مقداری با محدوده دینامیکی 12 بیت برای رنگی که از فیلتر عبور می کند ارائه می دهد.

همه دوربین‌های رنگی در PCO با موزاییک‌سازی Bayer-filter DE کار می‌کنند. الگوی فیلتر رنگ آن حسگرهای تصویر رنگی را می توان به ماتریس 2×2 کاهش داد. خود سنسور تصویر را می توان به عنوان ماتریسی از آن ماتریس های 2×2 دید.
این الگوی رنگی را فرض کنید

خود رنگ فقط تفسیری از ماتریس است. این تفسیر توسط یک الگوریتم به اصطلاح demosaicking انجام خواهد شد. pco_conv.dll با یک روش اختصاصی خاص کار می کند.

تبدیل توضیحات تابع API

PCO_ConvertCreate

توضیحات
یک شی تبدیل جدید بر اساس ساختار PCO_SensorInfo ایجاد می کند. دستگیره تبدیل ایجاد شده در طول تبدیل استفاده خواهد شد. لطفاً قبل از خروج برنامه و تخلیه dll تبدیل، با PCO_ConvertDelete تماس بگیرید.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	دسته*	اشاره گر به دسته ای که شی تبدیل ایجاد شده را دریافت می کند
strSensor	PCO_SensorInfo*	اشاره گر به ساختار اطلاعات حسگر. لطفا فراموش نکنید که پارامتر wSize را تنظیم کنید.
iConvertType	بین المللی	متغیر برای تعیین نوع تبدیل، یا b/w، رنگ، شبه رنگ یا رنگ 16

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertDelete

توضیحات
یک شی تبدیل قبلا ایجاد شده را حذف می کند. فراخوانی این تابع قبل از بستن برنامه الزامی است.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertGet

توضیحات
تمام مقادیر یک شی تبدیل قبلا ایجاد شده را دریافت می کند.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrConvert	PCO_Convert*	اشاره گر به ساختار تبدیل pco

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertSet

توضیحات
مقادیر لازم را برای یک شی تبدیل قبلا ایجاد شده تنظیم می کند.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrConvert	PCO_Convert*	اشاره گر به ساختار تبدیل pco

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertGetDisplay

توضیحات
ساختار PCO_Display را دریافت می کند

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrDisplay	PCO_Display*	اشاره گر به ساختار نمایشگر کامپیوتر شخصی

ارزش برگشتی

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrDisplay	PCO_Display*	اشاره گر به ساختار نمایشگر کامپیوتر شخصی

PCO_ConvertSetDisplay

توضیحات
ساختار PCO_Display را تنظیم می کند

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrDisplay	PCO_Display*	اشاره گر به ساختار نمایشگر کامپیوتر شخصی

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertSetBayer

توضیحات
مقادیر ساختار Bayer یک شی تبدیل قبلا ایجاد شده را تنظیم می کند. از این توابع برای تغییر پارامترهای الگوی Bayer استفاده کنید.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrBayer	PCO_Bayer*	اشاره به ساختار PCO Bayer

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertSetFilter

توضیحات
مقادیر ساختار فیلتر یک شی تبدیل قبلا ایجاد شده را تنظیم می کند.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
مقدمه	PCO_Filter*	اشاره گر به ساختار فیلتر pco

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_ConvertSetSensorInfo

توضیحات
ساختار PCO_SensorInfo را برای یک شی تبدیل قبلا ایجاد شده تنظیم می کند

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
pstrSensorInfo	PCO_SensorInfo*	اشاره گر به ساختار اطلاعات حسگر. لطفا فراموش نکنید که پارامتر wSize را تنظیم کنید

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_SetPseudoLut

توضیحات
سه جدول رنگ شبه نمودار را بارگیری کنید

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
شبه_لوت	کاراکتر بدون امضا *	اشاره گر به مقادیر رنگ شبه lut (رنگ های R، G، B: 256 * 3 بایت، یا 4 بایت)
inumcolors	بین المللی	روی 3 برای R,G,B یا 4 برای R,G,B,A تنظیم کنید

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_LoadPseudoLut

توضیحات
یک جدول جستجوی شبه رنگ را در شی تبدیل بار می کند. این تابع را می توان برای بارگیری برخی از جداول شبه جستجوی از پیش تعریف شده یا ایجاد شده توسط خود استفاده کرد.

نمونه اولیه

پارامتر

نام توضیحات را تایپ کنید
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
قالب	بین المللی	0	lt1، 1	lt2، 2	lt3، 3	lt4
fileنام	کاراکتر*	نام از file برای بارگیری

ارزش برگشتی

نام توضیحات را تایپ کنید
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
قالب	بین المللی	0	lt1، 1	lt2، 2	lt3، 3	lt4
fileنام	کاراکتر*	نام از file برای بارگیری

PCO_Convert16TO8

توضیحات
تبدیل داده های تصویر در b16 به داده های 8 بیتی در b8 (مقیاس خاکستری)

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
حالت	بین المللی	پارامتر حالت
icolmode	بین المللی	پارامتر حالت رنگ
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
b16	کلمه*	اشاره به تصویر خام
b8	بایت*	اشاره گر به تصویر 8bit b/w تبدیل شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_Convert16TO24

توضیحات
تبدیل داده های تصویر در b16 به داده های 24 بیتی در b24 (مقیاس خاکستری)

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
حالت	بین المللی	پارامتر حالت

نام	تایپ کنید	توضیحات
icolmode	بین المللی	پارامتر حالت رنگ
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
b16	کلمه*	اشاره به تصویر خام
b24	بایت*	اشاره گر به تصویر رنگی 24 بیتی تبدیل شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_Convert16TOCOL

توضیحات
تبدیل داده های تصویر در b16 به داده های RGB در b8 (رنگی)

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
حالت	بین المللی	پارامتر حالت
icolmode	بین المللی	پارامتر حالت رنگ
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
b16	کلمه*	اشاره به تصویر خام
b8	بایت*	اشاره گر به تصویر رنگی 24 بیتی تبدیل شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_Convert16TOPSEUDO

توضیحات
تبدیل داده های تصویر در b16 به داده های شبه رنگ در b8 (رنگی)

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
حالت	بین المللی	پارامتر حالت
icolmode	بین المللی	پارامتر حالت رنگ
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
b16	کلمه*	اشاره به تصویر خام
b8	بایت*	اشاره گر به تصویر شبه رنگی 24 بیتی تبدیل شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_Convert16TOCOL16

توضیحات
تبدیل داده های تصویر در b16 به داده های RGB در b16 (رنگی)

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
حالت	بین المللی	پارامتر حالت

نام	تایپ کنید	توضیحات
icolmode	بین المللی	پارامتر حالت رنگ
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
b16in	کلمه*	اشاره به تصویر خام
b16 خارج	کلمه*	اشاره گر به تصویر رنگی 48 بیتی تبدیل شده است

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_GetWhiteBalance

توضیحات
مقادیر متوازن سفید را برای رنگ color_tempand دریافت می کند

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
ph	رسیدگی	دسته به یک شی تبدیل که قبلا ایجاد شده است
color_temp	درون*	اشاره گر int برای دریافت دمای رنگ محاسبه شده
رنگ	درون*	اشاره گر int برای بدست آوردن مقدار رنگ محاسبه شده
حالت	بین المللی	پارامتر حالت
عرض	بین المللی	عرض تصویر برای تبدیل
ارتفاع	بین المللی	ارتفاع تصویر برای تبدیل
gb12	کلمه*	نشانگر به آرایه داده تصویر خام
x_min	بین المللی	مستطیل برای تنظیم منطقه تصویر مورد استفاده برای محاسبه
y_min	بین المللی	مستطیل برای تنظیم منطقه تصویر مورد استفاده برای محاسبه
x_max	بین المللی	مستطیل برای تنظیم منطقه تصویر مورد استفاده برای محاسبه
y_max	بین المللی	مستطیل برای تنظیم منطقه تصویر مورد استفاده برای محاسبه

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_GetMaxLimit

توضیحات
GetMaxLimit مقادیر RGB را برای یک دما و رنگ مشخص دریافت می کند. حداکثر مقدار در گفتگوی کنترل تبدیل نباید از بزرگترین مقدار مقادیر RGB تجاوز کند، به عنوان مثال در صورتی که R بزرگترین مقدار باشد، مقدار حداکثر می تواند تا زمانی که مقدار R به وضوح بیت (4095) برسد، افزایش یابد. برای کاهش مقدار حداکثر باید شرایط یکسانی رعایت شود، به عنوان مثال اگر B کمترین مقدار باشد، حداکثر مقدار می تواند کاهش یابد تا مقدار B به مقدار حداقل برسد.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
r_max	شناور*	اشاره گر به شناوری که حداکثر مقدار قرمز را دریافت می کند
g_max	شناور*	اشاره گر به شناوری که حداکثر مقدار سبز را دریافت می کند
b_max	شناور*	اشاره گر به شناوری که حداکثر مقدار آبی را دریافت می کند
دما	شناور	دمای رنگ
رنگ	شناور	تنظیم رنگ
بیت های خروجی	بین المللی	وضوح بیت تصویر تبدیل شده (معمولا 8)

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_GetColorValues

توضیحات
دمای رنگ و رنگ را برای مقادیر حداکثر R، G، B دریافت می کند.
GetColorValuesis فقط در pco.camware . دمای رنگ و رنگ را بر اساس مقادیر Rmax، Gmax، Bmax لوت رنگ قدیمی محاسبه می کند. مقادیر محاسبه شده برای تبدیل تصاویر قدیمی b16 و tif16 با روال های تبدیل جدید استفاده می شود.

نمونه اولیه

پارامتر

نام	تایپ کنید	توضیحات
pfColorTemp	شناور*	برای دریافت دمای رنگ به یک شناور اشاره کنید
pfColorTemp	شناور*	برای دریافت ته رنگ به یک شناور اشاره کنید
iRedMax	بین المللی	عدد صحیح برای تنظیم مقدار حداکثر فعلی برای قرمز
iGreenMax	بین المللی	عدد صحیح برای تنظیم مقدار حداکثر فعلی برای رنگ سبز.
iBlueMax	بین المللی	عدد صحیح برای تنظیم مقدار حداکثر فعلی برای آبی

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_WhiteBalanceToDisplayStruct

توضیحات
تعادل رنگ سفید را محاسبه می کند و مقادیر را با حفظ محدودیت ها روی strDisplaystruct قرار می دهد. struct str Display را از Convert Handle به صورت داخلی دریافت می کند

نمونه اولیه

پارامتر

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

PCO_GetVersionInfoPCO_CONV

توضیحات
اطلاعات نسخه مربوط به dll را برمی گرداند.

نمونه اولیه

پارامتر

ارزش برگشتی

نام	تایپ کنید	توضیحات
پیام خطا	بین المللی	0 در صورت موفقیت، کد خطا در غیر این صورت.

پیاده سازی معمولی

این پیاده سازی گام به گام معمولی مدیریت اولیه را نشان می دهد

اعلامیه ها
همه پارامترهای "اندازه" بافر را روی مقادیر مورد انتظار تنظیم کنید:
پارامترهای اطلاعات سنسور را تنظیم کنید و شی تبدیل را ایجاد کنید
به صورت اختیاری یک گفتگوی تبدیل را باز کنید
مقدار min و max را روی محدوده مورد نظر قرار دهید و آنها را روی شی تبدیل قرار دهید
تبدیل را انجام دهید و در صورت باز بودن دیالوگ، داده ها را روی دیالوگ تنظیم کنید
گفتگوی تبدیل که به صورت اختیاری باز شده را ببندید
شی تبدیل را ببندید: