EXCELITAS TECHNOLOGIES pco.convert Microscope Camera
Спецификации
- Име на производ: pco. конвертирате
- Верзија: 1.52.0
- Лиценца: Creative Commons Attribution-NoDerivatives 4.0International License
- Производител: Excelitas PCO GmbH
- Адреса: Донаупарк 11, 93309 Келхајм, Германија
- Контакт: +49 (0) 9441 2005 50
- Е-пошта: pco@excelitas.com
- Webсајт: www.excelitas.com/product-category/pco
Упатство за употреба на производот
Општи информации
Pco.convert нуди различни функции за конверзија на бои и псевдо бои. Важно е да ги следите упатствата дадени во упатството за употреба за оптимални перформанси.
Конвертирај опис на функцијата API
Convert API обезбедува збир на функции за манипулирање со податоци за боја и слика. Подолу се дадени неколку клучни функции:
-
- PCO_ConvertCreate: Создадете нов пример за конверзија.
- PCO_ConvertDelete: Избришете пример за конверзија.
- PCO_ConvertGet: Добијте поставки за конверзија.
Конверзија на бои и псевдо бои
Pco.convert поддржува и црно-бело конверзија, како и конверзија на бои. Следете ги специфичните упатства дадени во прирачникот за секој тип на конверзија.
Најчесто поставувани прашања
- П: Како да извршам конверзија на бои користејќи pco.convert?
- О: За да извршите конверзија на бои, користете ја функцијата PCO_ConvertGet со соодветните параметри како што е наведено во упатството за употреба.
- П: Може ли да избришам пример за конверзија?
- О: Да, можете да избришете пример за конверзија користејќи ја функцијата PCO_ConvertDelete.
упатство за употреба
pco.конвертирај
Excelitas PCO GmbH ве замолува внимателно да ги прочитате и следите упатствата во овој документ. За какви било прашања или коментари, ве молиме слободно контактирајте не во секое време.
- телефон: + 49 (0) 9441 2005 50
- факс: + 49 (0) 9441 2005 20
- поштенска адреса: Excelitas PCO GmbH Donaupark 11 93309 Келхајм, Германија
- е-пошта: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.конвертирај
упатство за употреба 1.52.0
Објавено во мај 2024 година
©Авторски права Excelitas PCO GmbH
Ова дело е лиценцирано под меѓународна лиценца Creative Commons Attribution-NoDerivatives 4.0. До view копија од оваа лиценца, посетете http://creativecommons.org/licenses/by-nd/4.0/ или испратете писмо до Creative Commons, PO Box 1866, Mountain View, CA 94042, САД.
Општо
- Овој опис на SDK за конвертирање може да се користи за имплементација на рутините за конвертирање PCO во сопствени апликации, кои се користат за контрола на камерите PCO. Забрането е користење на рутините за конвертирање со камери од трети страни.
- На pco.конвертирај sdk се состои од два дела: Функциите за конверзија LUT pco.conv.dll и функциите за дијалог pco_cdlg.dll .
Функциите за конверзија се користат за конвертирање на податочни области, b/w и боја, со резолуција од повеќе од 8 бита по пиксел или во b/w податочни области со резолуција од 8 bit по пиксел или во обоени податочни области со резолуција од 24 (32) бит по пиксел. DLL исто така вклучува функции за креирање и пополнување на различни објекти за конвертирање. - Вториот дел од API ги содржи функциите за дијалог. Дијалозите се едноставни дијалози за GUI кои му овозможуваат на корисникот да ги постави параметрите на објектите за конвертирање. Функциите за дијалог се вклучени во pco_cdlg.dll и се базираат на некои функции на pco.conv.dll.
- Во pco.sdk за pco камери постојат две сamples, кои користат конвертирање sdk. Еден од нив е Test_cvDlg sample а другото е 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 DE. Шемата за филтер за боја на тие сензори за слика во боја може да се намали на матрица 2×2. Самиот сензор за слика може да се гледа како матрица од тие матрици 2×2.
- Да претпоставиме дека оваа шема на боја
Самата боја е само интерпретација на матрицата. Оваа интерпретација ќе биде направена со таканаречен алгоритам за демозаикување. Pco_conv.dll работи со посебен неслободен метод.
Конвертирај опис на функцијата API
PCO_ConvertCreate
Опис
Создава нов објект за конвертирање врз основа на структурата PCO_SensorInfo. Создадената рачка за конвертирање ќе се користи за време на конверзијата. Ве молиме јавете се на PCO_ConvertDelete пред апликацијата да излезе и да го истовари конвертираниот dll.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАЧКА* | Покажувач на рачка која ќе го прими создадениот објект за конвертирање |
| strСензор | PCO_SensorInfo* | Покажувач кон информациска структура на сензорот. Ве молиме не заборавајте да го поставите параметарот wSize. |
| iConvertType | инт | Променлива за одредување на типот на конверзија, или b/w, боја, псевдо-боја или боја 16 |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertDelete
Опис
Бришење на претходно креиран објект за конвертирање. Задолжително е да ја повикате оваа функција пред да ја затворите апликацијата.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertGet
Опис
Ги добива сите вредности на претходно креираниот објект за конвертирање.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrКонвертирај | PCO_Convert* | Покажувач кон структура за конвертирање на компјутер |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertSet
Опис
Ги поставува потребните вредности за претходно креиран објект за конвертирање.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrКонвертирај | PCO_Convert* | Покажувач кон структура за конвертирање на компјутер |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertGetDisplay
Опис
Ја добива структурата PCO_Display
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrЕкран | PCO_Display* | Покажувач на структура на приказ на компјутер |
Повратна вредност
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrЕкран | PCO_Display* | Покажувач на структура на приказ на компјутер |
PCO_ConvertSetDisplay
Опис
Ја поставува структурата PCO_Display
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrЕкран | PCO_Display* | Покажувач на структура на приказ на компјутер |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertSetBayer
Опис
Ги поставува вредностите на структурата на Bayer на претходно креиран објект за конвертирање. Користете ги овие функции за да ги промените параметрите на шаблонот на Баер.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| pstrBayer | PCO_Bayer* | Покажува кон структура на PCO Bayer |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_ConvertSetFilter
Опис
Ги поставува вредностите на структурата на филтерот на претходно креираниот објект за конвертирање.
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| префилтер | PCO_Filter* | Покажува кон структурата на филтер за компјутер |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 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 | бајт* | Покажувач на конвертирана 8-битна б/в слика |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 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
Опис
Добива избалансирани вредности на белата боја за боја_темпа и нијанса
Прототип
Параметар
| Име | Тип | Опис |
| ph | РАКО | Рачка на претходно креиран објект за конвертирање |
| боја_темп | инт* | 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 на старата боја lut. Пресметаните вредности се користат за конвертирање на стари b16 и tif16 слики со новите рутини за конвертирање.
Прототип
Параметар
| Име | Тип | Опис |
| pfColorTemp | плови* | Покажувач на плови за примање на температурата на бојата |
| pfColorTemp | плови* | Покажувач на плови за примање на нијанса на боја |
| iRedMax | инт | Цел број за да ја поставите моменталната максимална вредност за црвено |
| iGreenMax | инт | Цел број за да ја поставите моменталната максимална вредност за зелената боја. |
| iBlueMax | инт | Цел број за да ја поставите моменталната максимална вредност за сино |
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_WhiteBalanceToDisplayStruct
Опис
Го пресметува балансот на белата боја и ги поставува вредностите на strDisplaystruct додека ги одржува границите. Внатрешно ја добива структурата str Приказ од рачката за конвертирање
Прототип
Параметар
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
PCO_GetVersionInfoPCO_CONV
Опис
Ги враќа информациите за верзијата за dll.
Прототип
Параметар
Повратна вредност
| Име | Тип | Опис |
| Порака за грешка | инт | 0 во случај на успех, код за грешка во спротивно. |
Типична имплементација
Оваа типична имплементација чекор по чекор го покажува основното ракување
- Декларации
- Поставете ги сите параметри „големина“ на баферот на очекуваните вредности:
- Поставете ги параметрите за информации за сензорот и креирајте го објектот за конвертирање
- Изборно отворете дијалог за конвертирање
- Поставете ги минималните и максималните вредности на саканиот опсег и поставете ги на објектот за конвертирање
- Направете конвертирање и поставете ги податоците во дијалогот ако дијалогот е отворен
- Затворете го опционално отворениот дијалог за конвертирање
- Затворете го објектот за конвертирање:
Видете ги Test_cvDlg sampле во пцо.сдк сampпапката le. Почнувајќи од v1.20, опсегот на вредноста на негативната нијанса е двојно зголемен.
- поштенска адреса: Excelitas PCO GmbH Donaupark 11 93309 Келхајм, Германија
- телефон: +49 (0) 9441 2005 0
- е-пошта: pco@excelitas.com
- web: www.excelitas.com/pco
Документи / ресурси
 |
EXCELITAS TECHNOLOGIES pco.convert Microscope Camera [pdf] Упатство за користење pco.convert Microscope Camera, pco.convert, Microscope Camera, Camera |
