EXCELITAS TECHNOLOGIES pco.convert Uživatelská příručka pro mikroskopickou kameru

Obecné informace
pco.convert nabízí různé funkce pro převod barev a pseudo barev. Pro optimální výkon je důležité dodržovat pokyny uvedené v uživatelské příručce.

Popis funkce Convert API
Rozhraní Convert API poskytuje sadu funkcí pro manipulaci s daty barev a obrázků. Níže jsou uvedeny některé klíčové funkce:

- PCO_ConvertCreate: Vytvořte novou instanci převodu.
- PCO_ConvertDelete: Odstraňte instanci konverze.
- PCO_ConvertGet: Získejte nastavení převodu.

Převod barev a pseudobarvy
pco.convert podporuje jak černobílý převod, tak převod barev. Postupujte podle konkrétních pokynů uvedených v příručce pro každý typ konverze.

FAQ

Otázka: Jak provedu převod barev pomocí pco.convert?
- Odpověď: Chcete-li provést převod barev, použijte funkci PCO_ConvertGet s příslušnými parametry, jak je uvedeno v uživatelské příručce.
Otázka: Mohu odstranit instanci konverze?
- Odpověď: Ano, instanci konverze můžete odstranit pomocí funkce PCO_ConvertDelete.

uživatelská příručka
pco.convert

Excelitas PCO GmbH vás žádá, abyste si pozorně přečetli a dodržovali pokyny v tomto dokumentu. V případě jakýchkoliv dotazů nebo připomínek nás neváhejte kdykoliv kontaktovat.

telefon: + 49 (0) 9441 2005 50

fax: + 49 (0) 9441 2005 20
poštovní adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Německo
e-mail: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
uživatelská příručka 1.52.0
Vydáno v květnu 2024
©Copyright Excelitas PCO GmbH

Toto dílo je licencováno pod mezinárodní licencí Creative Commons Attribution-NoDerivatives 4.0. Na view kopii této licence, navštivte http://creativecommons.org/licenses/by-nd/4.0/ nebo pošlete dopis na adresu Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Generál

Tento popis SDK pro převod lze použít k implementaci rutin převodu PCO v proprietárních aplikacích, které se používají k ovládání kamer PCO. Je zakázáno používat převodní rutiny s fotoaparáty třetích stran.
The pco.convert sdk se skládá ze dvou částí: Konverzní funkce LUT pco.conv.dll a dialogové funkce pco_cdlg.dll .
Konverzní funkce se používají k převodu datových oblastí, černobílých a barevných, s rozlišením vyšším než 8 bitů na pixel buď na černobílé datové oblasti s rozlišením 8 bitů na pixel, nebo barevné datové oblasti s rozlišením 24. (32) bitů na pixel. DLL také obsahuje funkce pro vytváření a vyplňování různých objektů převodu.
Druhá část API obsahuje dialogové funkce. Dialogy jsou jednoduché GUI dialogy, které umožňují uživateli nastavit parametry konvertovaných objektů. Dialogové funkce jsou součástí pco_cdlg.dll a jsou založeny na některých funkcích souboru pco.conv.dll.
V pco.sdk pro kamery pco existují dvě sampsoubory, které využívají převod sdk. Jedním z nich je Test_cvDlg sample a druhý je sc2_demo. Podívejte se prosím na ty sampsouborů, abyste viděli konvertované sdk funkce v akci.

Č/B a Pseudo převod barev
Algoritmus převodu použitý ve funkci č/b je založen na následující jednoduché rutině

kde

pos je proměnná čítače
dataout je oblast výstupních dat
datain je oblast vstupních dat

lutbw je datová oblast o velikosti 2n obsahující LUT, kde n = rozlišení vstupní oblasti v bitech na pixel

Ve funkci pseudocolor je základní rutina pro převod do datové oblasti RGB:

kde

pos je vstupní proměnná čítače
pout je výstupní proměnná čítače

dataout je oblast výstupních dat
datain je oblast vstupních dat
lutbw je datová oblast o velikosti 2n obsahující LUT, kde n = rozlišení vstupní oblasti v bitech na pixel

lutred, lutgreen, lutblue jsou datové oblasti o velikosti 2n obsahující LUT, kde n = rozlišení výstupní oblasti v bitech na pixel.

Konverze barev

Barevné snímače CCD používané v barevných kamerách PCO mají filtry pro barvy červenou, zelenou a modrou. Každý pixel má jeden typ filtru, takže původně nezískáte plnou barevnou informaci pro každý pixel. Každý pixel spíše poskytuje hodnotu s dynamickým rozsahem 12 bitů pro barvu, která projde filtrem.

Všechny barevné kamery na PCO pracují s mozaikou Bayer-filter DE. Vzor barevného filtru těchto barevných obrazových snímačů lze zmenšit na matici 2×2. Samotný obrazový snímač lze vidět jako matici oněch matic 2×2.
Předpokládejme tento barevný vzor

Samotná barva je pouze interpretací matrice. Tato interpretace bude provedena pomocí tzv. demosaicking algoritmu. Soubor pco_conv.dll pracuje se speciální proprietární metodou.

Popis funkce Convert API

PCO_ConvertCreate

Popis
Vytvoří nový objekt převodu na základě struktury PCO_SensorInfo. Vytvořený konvertor bude použit během převodu. Zavolejte prosím PCO_ConvertDelete před ukončením aplikace a uvolněním knihovny DLL pro převod.

Prototyp

Parametr

Jméno	Typ	Popis
ph	ZACHÁZET S*	Ukazatel na úchyt, který přijme vytvořený objekt převodu
strSensor	PCO_SensorInfo*	Ukazatel na informační strukturu senzoru. Nezapomeňte prosím nastavit parametr wSize.
iConvertType	int	Proměnná pro určení typu převodu, buď černobílá, barva, pseudo barva nebo barva 16

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_ConvertDelete

Popis
Odstraní dříve vytvořený objekt převodu. Tuto funkci je nutné zavolat před ukončením aplikace.

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, kód chyby jinak.

PCO_ConvertGet

Popis
Získá všechny hodnoty dříve vytvořeného objektu převodu.

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrConvert	PCO_Convert*	Ukazatel na strukturu převodu pco

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, kód chyby jinak.

PCO_ConvertSet

Popis
Nastaví potřebné hodnoty pro dříve vytvořený objekt převodu.

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrConvert	PCO_Convert*	Ukazatel na strukturu převodu pco

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_ConvertGetDisplay

Popis
Získá strukturu PCO_Display

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrDisplay	PCO_Display*	Ukazatel na strukturu displeje pco

Návratová hodnota

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrDisplay	PCO_Display*	Ukazatel na strukturu displeje pco

PCO_ConvertSetDisplay

Popis
Nastavuje strukturu PCO_Display

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrDisplay	PCO_Display*	Ukazatel na strukturu displeje pco

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_ConvertSetBayer

Popis
Nastaví hodnoty Bayerovy struktury dříve vytvořeného objektu převodu. Pomocí této funkce můžete změnit parametry Bayerova vzoru.

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrBayer	PCO_Bayer*	Ukazatel na strukturu PCO Bayer

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_ConvertSetFilter

Popis
Nastaví hodnoty struktury filtru dříve vytvořeného objektu převodu.

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
předfiltr	PCO_Filter*	Ukazatel na strukturu filtru pco

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_ConvertSetSensorInfo

Popis
Nastaví strukturu PCO_SensorInfo pro dříve vytvořený objekt převodu

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pstrSensorInfo	PCO_SensorInfo*	Ukazatel na informační strukturu senzoru. Nezapomeňte prosím nastavit parametr wSize

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_SetPseudoLut

Popis
Načtěte tři pseudolutové barevné tabulky grafu

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
pseudo_lut	nepodepsaný znak *	Hodnoty barev ukazatele na pseudo lut (barvy R, G, B: 256 * 3 bajty nebo 4 bajty)
inumcolors	int	Nastavte buď na 3 pro R,G,B nebo 4 pro R,G,B,A

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_LoadPseudoLut

Popis
Načte do konvertovaného objektu vyhledávací tabulku pseudo barev. Tuto funkci lze použít k načtení některých předdefinovaných nebo samostatně vytvořených pseudovyhledávacích tabulek.

Prototyp

Parametr

Jméno Popis typu
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
formát	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filejméno	char*	Název file načíst

Návratová hodnota

Jméno Popis typu
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
formát	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filejméno	char*	Název file načíst

PCO_Convert16TO8

Popis
Převod obrazových dat v b16 na 8bitová data v b8 (stupně šedi)

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
režimu	int	Parametr režimu
icolmode	int	Parametr barevného režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
b16	slovo*	Ukazatel na surový obrázek
b8	byte*	Ukazatel na převedený 8bitový černobílý obrázek

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_Convert16TO24

Popis
Převod obrazových dat v b16 na 24bitová data v b24 (stupně šedi)

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
režimu	int	Parametr režimu

Jméno	Typ	Popis
icolmode	int	Parametr barevného režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
b16	slovo*	Ukazatel na surový obrázek
b24	byte*	Ukazatel na převedený 24bitový barevný obrázek

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_Convert16TOCOL

Popis
Převod obrazových dat v b16 na data RGB v b8 (barva)

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
režimu	int	Parametr režimu
icolmode	int	Parametr barevného režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
b16	slovo*	Ukazatel na surový obrázek
b8	byte*	Ukazatel na převedený 24bitový barevný obrázek

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_Convert16TOPSEUDO

Popis
Převod obrazových dat v b16 na pseudobarevná data v b8 (barva)

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
režimu	int	Parametr režimu
icolmode	int	Parametr barevného režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
b16	slovo*	Ukazatel na surový obrázek
b8	byte*	Ukazatel na převedený 24bitový pseudobarevný obrázek

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_Convert16TOCOL16

Popis
Převod obrazových dat v b16 na data RGB v b16 (barva)

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
režimu	int	Parametr režimu

Jméno	Typ	Popis
icolmode	int	Parametr barevného režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
b16in	slovo*	Ukazatel na surový obrázek
b16out	slovo*	Ukazatel na převedený 48bitový barevný obrázek

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_GetWhiteBalance

Popis
Získá hodnoty vyvážené bílé pro odstín color_tempand

Prototyp

Parametr

Jméno	Typ	Popis
ph	RUKOJEŤ	Handle na dříve vytvořený objekt převodu
color_temp	int*	int, abyste získali vypočítanou barevnou teplotu
nádech	int*	int, abyste získali vypočítanou hodnotu odstínu
režimu	int	Parametr režimu
šířka	int	Šířka obrázku k převodu
výška	int	Výška obrázku k převodu
GB12	SLOVO*	Ukazatel na pole nezpracovaných obrazových dat
x_min	int	Obdélník pro nastavení oblasti obrázku, která se má použít pro výpočet
y_min	int	Obdélník pro nastavení oblasti obrázku, která se má použít pro výpočet
x_max	int	Obdélník pro nastavení oblasti obrázku, která se má použít pro výpočet
y_max	int	Obdélník pro nastavení oblasti obrázku, která se má použít pro výpočet

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_GetMaxLimit

Popis
GetMaxLimit získá hodnoty RGB pro danou teplotu a odstín. Maximální hodnota v dialogovém okně převodu nesmí překročit největší hodnotu hodnot RGB, např. v případě, že R je největší hodnota, může se maximální hodnota zvyšovat, dokud hodnota R nedosáhne bitového rozlišení (4095). Stejná podmínka musí být splněna pro snížení max. hodnoty, např. v případě, že B je nejnižší hodnota, může max. hodnota klesat, dokud hodnota B nedosáhne minimální hodnoty.

Prototyp

Parametr

Jméno	Typ	Popis
r_max	plovák*	Ukazatel na plovoucí objekt přijímající maximální červenou hodnotu
g_max	plovák*	Ukazatel na plovoucí objekt, který obdrží maximální zelenou hodnotu
b_max	plovák*	Ukazatel na plovoucí objekt přijímající maximální modrou hodnotu
tepl	plovák	Teplota barev
nádech	plovák	Nastavení odstínu
výstupní_bity	int	Bitové rozlišení převedeného obrázku (obvykle 8)

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_GetColorValues

Popis
Získá barevnou teplotu a odstín pro dané maximální hodnoty R,G,B.
GetColorValuesis se používá pouze v pco.camware . Vypočítá barevnou teplotu a odstín na základě hodnot Rmax,Gmax,Bmax starého barevného lut. Vypočtené hodnoty se použijí pro převod starých obrázků b16 a tif16 pomocí nových převodních rutin.

Prototyp

Parametr

Jméno	Typ	Popis
pfColorTemp	plovák*	Ukazatel na plovák pro příjem barevné teploty
pfColorTemp	plovák*	Ukazatel na plovák pro příjem barevného odstínu
iRedMax	int	Celé číslo pro nastavení aktuální maximální hodnoty pro červenou
iGreenMax	int	Celé číslo pro nastavení aktuální maximální hodnoty pro zelenou.
iBlueMax	int	Celé číslo pro nastavení aktuální maximální hodnoty pro modrou

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_WhiteBalanceToDisplayStruct

Popis
Vypočítá vyvážení bílé a nastaví hodnoty do strDisplaystruct při zachování limitů. Získá struct str Display z převést Handle interně

Prototyp

Parametr

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

PCO_GetVersionInfoPCO_CONV

Popis
Vrátí informace o verzi dll.

Prototyp

Parametr

Návratová hodnota

Jméno	Typ	Popis
ErrorMessage	int	0 v případě úspěchu, Errorcode jinak.

Typická implementace

Tato typická implementace krok za krokem ukazuje základní manipulaci

Prohlášení
Nastavte všechny parametry „velikost“ vyrovnávací paměti na očekávané hodnoty:
Nastavte parametry info senzoru a vytvořte objekt převodu
Volitelně otevřete dialogové okno převodu
Nastavte minimální a maximální hodnotu na požadovaný rozsah a nastavte je na objekt převodu
Proveďte převod a nastavte data do dialogu, pokud je dialog otevřený
Zavřete volitelně otevřený dialog převodu
Zavřete objekt převodu:

Viz Test_cvDlg sample v pco.sdk sampsložka le. Počínaje verzí 1.20 byl rozsah záporné hodnoty odstínu zdvojnásoben.

poštovní adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Německo
telefon: +49 (0) 9441 2005 0
e-mail: pco@excelitas.com
web: www.excelitas.com/pco

Dokumenty / zdroje

EXCELITAS TECHNOLOGIES pco.convert Mikroskopická kamera [pdfUživatelská příručka
pco.convert Mikroskopická kamera, pco.convert, Mikroskopická kamera, Kamera

Reference

Uživatelská příručka

EXCELITAS TECHNOLOGIES pco.convert Mikroskopická kamera

Návod k použití produktu

Generál

Popis funkce Convert API

Typická implementace

Dokumenty / zdroje

Reference

Zanechte komentář

Zrušit odpověď