EXCELITAS TECHNOLOGIES pco.convert Mikroskopická kamera
Špecifikácie
- Názov produktu: pco. konvertovať
- Verzia: 1.52.0
- Licencia: Medzinárodná licencia Creative Commons Attribution-NoDerivatives 4.0
- Výrobca: Excelitas PCO GmbH
- Adresa: Donaupark 11, 93309 Kelheim, Nemecko
- Kontakt: +49 (0) 9441 2005 50
- Email: pco@excelitas.com
- Webmiesto: www.excelitas.com/product-category/pco
Návod na použitie produktu
Všeobecné informácie
Pco.convert ponúka rôzne funkcie na konverziu farieb a pseudo farieb. Pre optimálny výkon je dôležité dodržiavať pokyny uvedené v používateľskej príručke.
Popis funkcie Convert API
Rozhranie Convert API poskytuje sadu funkcií na manipuláciu s údajmi farieb a obrázkov. Nižšie sú uvedené niektoré kľúčové funkcie:
-
- PCO_ConvertCreate: Vytvorte novú inštanciu konverzie.
- PCO_ConvertDelete: Odstráňte inštanciu konverzie.
- PCO_ConvertGet: Získajte nastavenia konverzie.
Konverzia farieb a pseudofarebná konverzia
Pco.convert podporuje čiernobielu konverziu, ako aj konverziu farieb. Postupujte podľa špecifických pokynov uvedených v príručke pre každý typ konverzie.
FAQ
- Otázka: Ako vykonám konverziu farieb pomocou pco.convert?
- Odpoveď: Ak chcete vykonať konverziu farieb, použite funkciu PCO_ConvertGet s príslušnými parametrami, ako je uvedené v používateľskej príručke.
- Otázka: Môžem odstrániť inštanciu konverzie?
- Odpoveď: Áno, inštanciu konverzie môžete vymazať pomocou funkcie PCO_ConvertDelete.
užívateľskú príručku
pco.convert
Excelitas PCO GmbH vás žiada, aby ste si pozorne prečítali a dodržiavali pokyny v tomto dokumente. V prípade akýchkoľvek otázok alebo pripomienok nás neváhajte kedykoľvek kontaktovať.
- telefón: + 49 (0) 9441 2005 50
- fax: + 49 (0) 9441 2005 20
- poštová adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Nemecko
- email: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
užívateľská príručka 1.52.0
Vydané v máji 2024
©Copyright Excelitas PCO GmbH
Toto dielo je licencované pod medzinárodnou licenciou Creative Commons Attribution-NoDerivatives 4.0. Komu view kópiu tejto licencie, navštívte http://creativecommons.org/licenses/by-nd/4.0/ alebo pošlite list na adresu Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
generál
- Tento popis SDK pre prevod možno použiť na implementáciu postupov prevodu PCO v proprietárnych aplikáciách, ktoré sa používajú na ovládanie kamier PCO. Je zakázané používať konvertovacie rutiny s fotoaparátmi tretích strán.
- The pco.convert sdk sa skladá z dvoch častí: Konverzné funkcie LUT pco.conv.dll a dialógové funkcie pco_cdlg.dll .
Konverzné funkcie sa používajú na konverziu dátových oblastí, čiernobielych a farebných, s rozlíšením viac ako 8 bitov na pixel buď na čiernobiele dátové oblasti s rozlíšením 8 bitov na pixel alebo farebné dátové oblasti s rozlíšením 24. (32) bitov na pixel. DLL tiež obsahuje funkcie na vytváranie a vypĺňanie rôznych konvertovaných objektov. - Druhá časť API obsahuje dialógové funkcie. Dialógové okná sú jednoduché GUI dialógy, ktoré umožňujú užívateľovi nastaviť parametre konvertovaných objektov. Dialógové funkcie sú zahrnuté v pco_cdlg.dll a sú založené na niektorých funkciách súboru pco.conv.dll.
- V pco.sdk pre kamery pco existujú dve samplesov, ktoré využívajú prevod sdk. Jedným z nich je Test_cvDlg sample a druhý je sc2_demo. Prosím, pozrite sa na tie samples, aby ste videli konvertované sdk funkcie v akcii.
Č/B a Pseudofarebná konverzia
Algoritmus prevodu použitý v čiernobielej funkcii je založený na nasledujúcej jednoduchej rutine
kde
- pos je premenná počítadla
- dataout je oblasť výstupných údajov
- datain je oblasť vstupných údajov
- lutbw je dátová oblasť veľkosti 2n obsahujúca LUT, kde n = rozlíšenie vstupnej oblasti v bitoch na pixel
Vo funkcii pseudocolor je základná rutina na konverziu na dátovú oblasť RGB:
kde
- pos je vstupná premenná počítadla
- pút je výstupná premenná počítadla
- dataout je oblasť výstupných údajov
- datain je oblasť vstupných údajov
- lutbw je dátová oblasť veľkosti 2n obsahujúca LUT, kde n = rozlíšenie vstupnej oblasti v bitoch na pixel
- lutred, lutgreen, lutblue sú dátové oblasti veľkosti 2n obsahujúce LUT, kde n = rozlíšenie výstupnej oblasti v bitoch na pixel.
Konverzia farieb
- CCD farebné snímače používané vo farebných kamerách PCO majú filtre pre červenú, zelenú a modrú farbu. Každý pixel má jeden typ filtra, takže pôvodne nezískate úplné farebné informácie pre každý pixel. Každý pixel skôr poskytuje hodnotu s dynamickým rozsahom 12 bitov pre farbu, ktorá prejde filtrom.
- Všetky farebné kamery na PCO pracujú s mozaikou Bayer-filter DE. Vzor farebného filtra týchto farebných obrazových snímačov možno zmenšiť na maticu 2×2. Samotný obrazový snímač možno považovať za maticu týchto matíc 2×2.
- Predpokladajme, že tento farebný vzor
Samotná farba je len interpretáciou matrice. Túto interpretáciu vykoná takzvaný algoritmus demosaicking. Súbor pco_conv.dll pracuje so špeciálnou proprietárnou metódou.
Popis funkcie Convert API
PCO_ConvertCreate
Popis
Vytvorí nový konvertovaný objekt založený na štruktúre PCO_SensorInfo. Vytvorený konvertor sa použije počas konverzie. Zavolajte PCO_ConvertDelete predtým, ako sa aplikácia ukončí a uvoľní konvertor dll.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | RUKOJEŤ* | Ukazovateľ na rukoväť, ktorá prijme vytvorený konvertovaný objekt |
| strSensor | PCO_SensorInfo* | Ukazovateľ na informačnú štruktúru senzora. Prosím, nezabudnite nastaviť parameter wSize. |
| iConvertType | int | Premenná na určenie typu prevodu, čiernobiela, farba, pseudo farba alebo farba 16 |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_ConvertDelete
Popis
Odstráni predtým vytvorený objekt konverzie. Túto funkciu je povinné zavolať pred zatvorením aplikácie.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, inak kód chyby. |
PCO_ConvertGet
Popis
Získa všetky hodnoty predtým vytvoreného konvertovaného objektu.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrConvert | PCO_Convert* | Ukazovateľ na štruktúru prevodu pco |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, inak kód chyby. |
PCO_ConvertSet
Popis
Nastaví potrebné hodnoty pre predtým vytvorený objekt konverzie.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrConvert | PCO_Convert* | Ukazovateľ na štruktúru prevodu pco |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_ConvertGetDisplay
Popis
Získa štruktúru PCO_Display
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrDisplay | PCO_Display* | Ukazovateľ na štruktúru zobrazenia pco |
Návratová hodnota
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrDisplay | PCO_Display* | Ukazovateľ na štruktúru zobrazenia pco |
PCO_ConvertSetDisplay
Popis
Nastavuje štruktúru PCO_Display
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrDisplay | PCO_Display* | Ukazovateľ na štruktúru zobrazenia pco |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_ConvertSetBayer
Popis
Nastaví hodnoty Bayerovej štruktúry predtým vytvoreného konvertovaného objektu. Tieto funkcie použite na zmenu parametrov Bayerovho vzoru.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrBayer | PCO_Bayer* | Ukazovateľ na štruktúru PCO Bayer |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_ConvertSetFilter
Popis
Nastavuje hodnoty štruktúry filtra predtým vytvoreného konvertovaného objektu.
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| predfilter | PCO_Filter* | Ukazovateľ na štruktúru filtra pco |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_ConvertSetSensorInfo
Popis
Nastaví štruktúru PCO_SensorInfo pre predtým vytvorený objekt konverzie
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pstrSensorInfo | PCO_SensorInfo* | Ukazovateľ na informačnú štruktúru senzora. Prosím, nezabudnite nastaviť parameter wSize |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_SetPseudoLut
Popis
Načítajte tri pseudolutové farebné tabuľky grafu
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| pseudo_lut | nepodpísaný znak * | Ukazovateľ na hodnoty farieb pseudo lut (farby R, G, B: 256 * 3 bajty alebo 4 bajty) |
| inumcolors | int | Nastavte buď na 3 pre R,G,B alebo 4 pre R,G,B,A |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_LoadPseudoLut
Popis
Načíta vyhľadávaciu tabuľku pseudo farieb do konvertovaného objektu. Túto funkciu možno použiť na načítanie niektorých preddefinovaných alebo samostatne vytvorených pseudovyhľadávacích tabuliek.
Prototyp
Parameter
| Meno Popis typu | ||||||
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie | ||||
| formát | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filemeno | char* | Názov file načítať | ||||
Návratová hodnota
| Meno Popis typu | ||||||
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie | ||||
| formát | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filemeno | char* | Názov file načítať | ||||
PCO_Convert16TO8
Popis
Prevod obrazových údajov v b16 na 8bitové údaje v b8 (odtiene šedej)
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| režim | int | Parameter režimu |
| icolmode | int | Parameter farebného režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| b16 | slovo* | Ukazovateľ na nespracovaný obrázok |
| b8 | bajt* | Ukazovateľ na skonvertovaný 8bitový čiernobiely obrázok |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_Convert16TO24
Popis
Prevod obrazových údajov v b16 na 24bitové údaje v b24 (odtiene šedej)
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| režim | int | Parameter režimu |
| Meno | Typ | Popis |
| icolmode | int | Parameter farebného režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| b16 | slovo* | Ukazovateľ na nespracovaný obrázok |
| b24 | bajt* | Ukazovateľ na konvertovaný 24-bitový farebný obrázok |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_Convert16TOCOL
Popis
Konvertujte obrazové dáta v b16 na RGB dáta v b8 (farebne)
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| režim | int | Parameter režimu |
| icolmode | int | Parameter farebného režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| b16 | slovo* | Ukazovateľ na nespracovaný obrázok |
| b8 | bajt* | Ukazovateľ na konvertovaný 24-bitový farebný obrázok |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_Convert16TOPSEUDO
Popis
Prevod obrazových údajov v b16 na pseudofarebné údaje v b8 (farba)
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| režim | int | Parameter režimu |
| icolmode | int | Parameter farebného režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| b16 | slovo* | Ukazovateľ na nespracovaný obrázok |
| b8 | bajt* | Ukazovateľ na konvertovaný 24bitový pseudo farebný obrázok |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_Convert16TOCOL16
Popis
Konvertujte obrazové dáta v b16 na RGB dáta v b16 (farebne)
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| režim | int | Parameter režimu |
| Meno | Typ | Popis |
| icolmode | int | Parameter farebného režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| b16in | slovo* | Ukazovateľ na nespracovaný obrázok |
| b16out | slovo* | Ukazovateľ na konvertovaný 48-bitový farebný obrázok |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_GetWhiteBalance
Popis
Získa vyvážené hodnoty bielej pre odtieň color_tempand
Prototyp
Parameter
| Meno | Typ | Popis |
| ph | HANDLE | Rukoväť na predtým vytvorený objekt konverzie |
| color_temp | int* | int, aby ste získali vypočítanú farebnú teplotu |
| odtieň | int* | int, aby ste získali vypočítanú hodnotu odtieňa |
| režim | int | Parameter režimu |
| šírka | int | Šírka obrázka na konverziu |
| výška | int | Výška obrázka na konverziu |
| gb12 | SLOVO* | Ukazovateľ na pole nespracovaných údajov obrázka |
| x_min | int | Obdĺžnik na nastavenie oblasti obrázka, ktorá sa má použiť na výpočet |
| y_min | int | Obdĺžnik na nastavenie oblasti obrázka, ktorá sa má použiť na výpočet |
| x_max | int | Obdĺžnik na nastavenie oblasti obrázka, ktorá sa má použiť na výpočet |
| y_max | int | Obdĺžnik na nastavenie oblasti obrázka, ktorá sa má použiť na výpočet |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_GetMaxLimit
Popis
GetMaxLimit získa hodnoty RGB pre danú teplotu a odtieň. Maximálna hodnota v dialógovom okne prevodu nesmie presiahnuť najväčšiu hodnotu hodnôt RGB, napr. v prípade, že R je najväčšia hodnota, maximálna hodnota sa môže zvyšovať, kým hodnota R nedosiahne bitové rozlíšenie (4095). Rovnaká podmienka musí byť splnená pre zníženie maximálnej hodnoty, napr. v prípade, že B je najnižšia hodnota, môže maximálna hodnota klesať, kým hodnota B nedosiahne minimálnu hodnotu.
Prototyp
Parameter
| Meno | Typ | Popis |
| r_max | plávať* | Ukazovateľ na plavák prijímajúci maximálnu červenú hodnotu |
| g_max | plávať* | Ukazovateľ na plavák prijímajúci maximálnu zelenú hodnotu |
| b_max | plávať* | Ukazovateľ na plavák prijímajúci maximálnu modrú hodnotu |
| tepl | plávať | Teplota farby |
| odtieň | plávať | Nastavenie odtieňa |
| výstupné_bity | int | Bitové rozlíšenie konvertovaného obrázka (zvyčajne 8) |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_GetColorValues
Popis
Získa teplotu farby a odtieň pre dané maximálne hodnoty R, G, B.
GetColorValuesis sa používa iba v pco.camware . Vypočítava farebnú teplotu a odtieň na základe hodnôt Rmax,Gmax,Bmax starého farebného lut. Vypočítané hodnoty sa použijú na konverziu starých obrazov b16 a tif16 pomocou nových prevádzacích rutín.
Prototyp
Parameter
| Meno | Typ | Popis |
| pfColorTemp | plávať* | Ukazovateľ na plavák na príjem farebnej teploty |
| pfColorTemp | plávať* | Ukazovateľ na plavák na získanie farebného odtieňa |
| iRedMax | int | Celé číslo na nastavenie aktuálnej maximálnej hodnoty pre červenú |
| iGreenMax | int | Celé číslo na nastavenie aktuálnej maximálnej hodnoty pre zelenú. |
| iBlueMax | int | Celé číslo na nastavenie aktuálnej maximálnej hodnoty modrej |
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_WhiteBalanceToDisplayStruct
Popis
Vypočíta vyváženie bielej a nastaví hodnoty na strDisplaystruct pri zachovaní limitov. Získa štruktúru str Display z interného prevodníka Handle
Prototyp
Parameter
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
PCO_GetVersionInfoPCO_CONV
Popis
Vráti informácie o verzii dll.
Prototyp
Parameter
Návratová hodnota
| Meno | Typ | Popis |
| ErrorMessage | int | 0 v prípade úspechu, Errorcode inak. |
Typická implementácia
Táto typická implementácia krok za krokom ukazuje základnú manipuláciu
- vyhlásenia
- Nastavte všetky parametre „veľkosť“ vyrovnávacej pamäte na očakávané hodnoty:
- Nastavte parametre informácií o senzore a vytvorte objekt konverzie
- Voliteľne otvorte dialógové okno konverzie
- Nastavte minimálnu a maximálnu hodnotu na požadovaný rozsah a nastavte ich na objekt konverzie
- Vykonajte konverziu a nastavte údaje do dialógového okna, ak je dialógové okno otvorené
- Zatvorte voliteľne otvorené dialógové okno konverzie
- Zatvorte objekt konverzie:
Pozrite si Test_cvDlg sample v pco.sdk sample priečinok. Počnúc verziou 1.20 sa rozsah zápornej hodnoty odtieňa zdvojnásobil.
- poštová adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Nemecko
- telefón: +49 (0) 9441 2005 0
- e-mail: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumenty / zdroje
 |
EXCELITAS TECHNOLOGIES pco.convert Mikroskopická kamera [pdfPoužívateľská príručka pco.convert Microscope Camera, pco.convert, Microscope Camera, Camera |
