EXCELITAS TECHNOLOGIES pco.convert микроскопска камера
Спецификации
- Име на продукта: pco. преобразувам
- Версия: 1.52.0
- Лиценз: Creative Commons Attribution-Без производни 4.0 Международен лиценз
- Производител: Excelitas PCO GmbH
- Адрес: Donaupark 11, 93309 Kelheim, Германия
- Контакт: +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.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 г
©Авторско право 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 камери. Забранено е използването на програмите за конвертиране с камери на трети страни.
- The pco.convert sdk се състои от две части: Функциите за преобразуване на LUT pco.conv.dll и диалоговите функции pco_cdlg.dll .
Функциите за преобразуване се използват за преобразуване на области с данни, черно-бели и цветни, с разделителна способност над 8 бита на пиксел или в черно-бели области с данни с разделителна способност 8 бита на пиксел или цветни области с данни с разделителна способност 24 (32) бита на пиксел. DLL също включва функции за създаване и попълване на различни обекти за конвертиране. - Втората част на API съдържа диалоговите функции. Диалоговите прозорци са прости диалогови прозорци с GUI, които позволяват на потребителя да зададе параметрите на конвертираните обекти. Диалоговите функции са включени в pco_cdlg.dll и се основават на някои функции на pco.conv.dll.
- В pco.sdk за pco камери има две sampфайлове, които използват конвертиращия sdk. Единият е Test_cvDlg sample, а другият е sc2_demo. Моля, разгледайте тези sampфайлове, за да „видите“ функциите за конвертиране на sdk в действие.
Ч/Б и псевдоцветно преобразуване
Алгоритъмът за преобразуване, използван във функцията b/w, се основава на следната проста рутина
където
- pos е променливата на брояча
- dataout е областта на изходните данни
- datatain е областта за входни данни
- lutbw е област с данни с размер 2n, съдържаща LUT, където n = разделителна способност на входната област в битове на пиксел
В псевдоцветната функция основната процедура за преобразуване в RGB област с данни е:
където
- pos е променливата на входния брояч
- pout е променливата на изходния брояч
- dataout е областта на изходните данни
- datatain е областта за входни данни
- lutbw е област с данни с размер 2n, съдържаща LUT, където n = разделителна способност на входната област в битове на пиксел
- lutred, lutgreen, lutblue са области с данни с размер 2n, съдържащи LUT, където n = разделителна способност на изходната област в бит на пиксел.
Преобразуване на цветовете
- CCD цветните сензори, използвани в PCO цветните камери, имат филтри за цветовете червено, зелено и синьо. Всеки пиксел има един тип филтър, поради което първоначално не получавате пълна информация за цвета за всеки пиксел. По-скоро всеки пиксел доставя стойност с динамичен диапазон от 12 бита за цвета, който преминава филтъра.
- Всички цветни камери в PCO работят с Bayer-filter DE mosaicking. Моделът на цветния филтър на тези сензори за цветно изображение може да бъде намален до 2×2 матрица. Самият сензор за изображения може да се разглежда като матрица от тези 2×2 матрици.
- Да предположим, че този цветен модел
Самият цвят е само интерпретация на матрицата. Това тълкуване ще бъде направено чрез така наречения алгоритъм за демозайка. pco_conv.dll работи със специален патентован метод.
Описание на функцията за конвертиране на API
PCO_ConvertCreate
Описание
Създава нов обект за конвертиране въз основа на структурата PCO_SensorInfo. Създаденият манипулатор за конвертиране ще бъде използван по време на конвертирането. Моля, извикайте PCO_ConvertDelete, преди приложението да излезе и да разтовари преобразуваната dll.
Прототип
Параметър
| Име | Тип | Описание |
| ph | ДРЪЖКА* | Указател към манипулатор, който ще получи създадения обект за конвертиране |
| strSensor | PCO_SensorInfo* | Указател към информационна структура на сензор. Моля, не забравяйте да зададете параметъра wSize. |
| iConvertType | вътр | Променлива за определяне на типа преобразуване, или черно-бяло, цветно, псевдо цвят или цвят 16 |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_ConvertDelete
Описание
Изтрива предварително създаден обект за конвертиране. Извикването на тази функция е задължително преди затваряне на приложението.
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Код на грешка в противен случай. |
PCO_ConvertGet
Описание
Получава всички стойности на предварително създаден обект за конвертиране.
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrConvert | PCO_Convert* | Указател към структура за преобразуване на pco |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Код на грешка в противен случай. |
PCO_ConvertSet
Описание
Задава необходимите стойности за предварително създаден обект за конвертиране.
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrConvert | PCO_Convert* | Указател към структура за преобразуване на pco |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_ConvertGetDisplay
Описание
Получава структурата PCO_Display
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrDisplay | PCO_Дисплей* | Указател към pco структура на дисплея |
Върната стойност
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrDisplay | PCO_Дисплей* | Указател към pco структура на дисплея |
PCO_ConvertSetDisplay
Описание
Задава структурата на PCO_Display
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrDisplay | PCO_Дисплей* | Указател към pco структура на дисплея |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_ConvertSetBayer
Описание
Задава стойностите на структурата на Bayer на предварително създаден обект за конвертиране. Използвайте тази функция, за да промените параметрите на модела на Bayer.
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrBayer | PCO_Bayer* | Указател към структура на PCO Bayer |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_ConvertSetFilter
Описание
Задава стойностите на структурата на филтъра на предварително създаден обект за конвертиране.
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| префилтър | PCO_Филтър* | Указател към pco филтърна структура |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_ConvertSetSensorInfo
Описание
Задава структурата PCO_SensorInfo за предварително създаден обект за конвертиране
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pstrSensorInfo | PCO_SensorInfo* | Указател към информационна структура на сензор. Моля, не забравяйте да зададете параметъра wSize |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_SetPseudoLut
Описание
Заредете трите таблици с цветове псевдолут на чертежа
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| pseudo_lut | неподписан знак * | Указател към стойностите на псевдолут цвят (цветове R,G,B: 256 * 3 байта или 4 байта) |
| inumcolors | вътр | Задайте 3 за R,G,B или 4 за R,G,B,A |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
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 в случай на успех, Errorcode в противен случай. |
PCO_Convert16TO24
Описание
Конвертиране на данни за картина в b16 в 24-битови данни в b24 (нива на сивото)
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| режим | вътр | Параметър на режима |
| Име | Тип | Описание |
| icolmode | вътр | Параметър на цветовия режим |
| ширина | вътр | Ширина на изображението за конвертиране |
| височина | вътр | Височина на изображението за конвертиране |
| b16 | дума* | Указател към необработеното изображение |
| b24 | байт* | Указател към конвертирано 24-битово цветно изображение |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_Convert16TOCOL
Описание
Преобразуване на данни за картина в b16 в RGB данни в b8 (цвят)
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| режим | вътр | Параметър на режима |
| icolmode | вътр | Параметър на цветовия режим |
| ширина | вътр | Ширина на изображението за конвертиране |
| височина | вътр | Височина на изображението за конвертиране |
| b16 | дума* | Указател към необработеното изображение |
| b8 | байт* | Указател към конвертирано 24-битово цветно изображение |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_Convert16TOPSEUDO
Описание
Конвертиране на данни за картина в b16 в псевдо цветни данни в b8 (цвят)
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| режим | вътр | Параметър на режима |
| icolmode | вътр | Параметър на цветовия режим |
| ширина | вътр | Ширина на изображението за конвертиране |
| височина | вътр | Височина на изображението за конвертиране |
| b16 | дума* | Указател към необработеното изображение |
| b8 | байт* | Указател към конвертирано 24-битово псевдо цветно изображение |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_Convert16TOCOL16
Описание
Преобразуване на данни за картина в b16 в RGB данни в b16 (цвят)
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| режим | вътр | Параметър на режима |
| Име | Тип | Описание |
| icolmode | вътр | Параметър на цветовия режим |
| ширина | вътр | Ширина на изображението за конвертиране |
| височина | вътр | Височина на изображението за конвертиране |
| b16in | дума* | Указател към необработеното изображение |
| b16out | дума* | Указател към конвертирано 48-битово цветно изображение |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_GetWhiteBalance
Описание
Получава балансирани стойности на бялото за color_tempand нюанс
Прототип
Параметър
| Име | Тип | Описание |
| ph | Дръжка | Манипулатор към предварително създаден обект за конвертиране |
| цветна_темп | int* | int указател за получаване на изчислената цветова температура |
| нюанс | int* | int указател, за да получите изчислената стойност на нюанса |
| режим | вътр | Параметър на режима |
| ширина | вътр | Ширина на изображението за конвертиране |
| височина | вътр | Височина на изображението за конвертиране |
| gb12 | ДУМА* | Указател към масив от данни за необработена картина |
| x_мин | вътр | Правоъгълник за задаване на областта на изображението, която да се използва за изчисление |
| y_min | вътр | Правоъгълник за задаване на областта на изображението, която да се използва за изчисление |
| x_макс | вътр | Правоъгълник за задаване на областта на изображението, която да се използва за изчисление |
| y_max | вътр | Правоъгълник за задаване на областта на изображението, която да се използва за изчисление |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_GetMaxLimit
Описание
GetMaxLimit получава RGB стойностите за дадена температура и нюанс. Максималната стойност в диалоговия прозорец за управление на преобразуването не трябва да надвишава най-голямата стойност от RGB стойностите, например в случай, че R е най-голямата стойност, максималната стойност може да се увеличи, докато R стойността достигне битовата разделителна способност (4095). Същото условие трябва да бъде изпълнено за намаляване на максималната стойност, например в случай, че B е най-ниската стойност, максималната стойност може да намалява, докато стойността B достигне минималната стойност.
Прототип
Параметър
| Име | Тип | Описание |
| r_max | плавам* | Указател към плаващ елемент, получаващ максималната червена стойност |
| g_макс | плавам* | Указател към float, получаващ максималната зелена стойност |
| b_макс | плавам* | Указател към float, получаващ максималната синя стойност |
| темп | плавам | Цветна температура |
| нюанс | плавам | Настройка на нюанса |
| изходни_битове | вътр | Битова разделителна способност на конвертираното изображение (обикновено 8) |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_GetColorValues
Описание
Получава цветова температура и нюанс за дадени максимални стойности на R, G, B.
GetColorValue се използва само в pco.camware . Той изчислява цветовата температура и нюанса въз основа на стойностите на Rmax, Gmax, Bmax на стария цвят lut. Изчислените стойности се използват за конвертиране на стари b16 и tif16 изображения с новите програми за конвертиране.
Прототип
Параметър
| Име | Тип | Описание |
| pfColorTemp | плавам* | Указател към поплавък за получаване на цветната температура |
| pfColorTemp | плавам* | Указател към поплавък за получаване на цветовия нюанс |
| iRedMax | вътр | Цяло число за задаване на текущата максимална стойност за червено |
| iGreenMax | вътр | Цяло число за задаване на текущата максимална стойност за зелено. |
| iBlueMax | вътр | Цяло число за задаване на текущата максимална стойност за синьо |
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_WhiteBalanceToDisplayStruct
Описание
Изчислява баланса на бялото и задава стойностите на strDisplaystruct, като запазва ограниченията. Получава struct str Display от вътрешно манипулатора за конвертиране
Прототип
Параметър
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
PCO_GetVersionInfoPCO_CONV
Описание
Връща информация за версията на dll.
Прототип
Параметър
Върната стойност
| Име | Тип | Описание |
| Съобщение за грешка | вътр | 0 в случай на успех, Errorcode в противен случай. |
Типично изпълнение
Това типично изпълнение стъпка по стъпка показва основното боравене
- Декларации
- Задайте всички параметри за „размер на буфера“ на очакваните стойности:
- Задайте параметрите на информацията за сензора и създайте преобразуващия обект
- По желание отворете диалогов прозорец за конвертиране
- Задайте минималната и максималната стойност на желания диапазон и ги задайте на конвертиращия обект
- Направете конвертирането и задайте данните в диалоговия прозорец, ако диалоговият прозорец е отворен
- Затворете опционално отворения диалогов прозорец за конвертиране
- Затворете конвертирания обект:
Вижте Test_cvDlg sample в pco.sdk sample папка. Започвайки с v1.20, обхватът на стойността на отрицателния нюанс е удвоен.
- пощенски адрес: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Германия
- телефон: +49 (0) 9441 2005 0
- имейл: pco@excelitas.com
- web: www.excelitas.com/pco
Документи / Ресурси
 |
EXCELITAS TECHNOLOGIES pco.convert микроскопска камера [pdf] Ръководство за потребителя pco.convert микроскопска камера, pco.convert, микроскопска камера, камера |
