EXCELITAS TECHNOLOGIES pco.convert mikroskopska kamera
Specifikacije
- Ime izdelka: pco. pretvoriti
- Različica: 1.52.0
- Licenca: Creative Commons Attribution-Brez izpeljank 4.0 Mednarodna licenca
- Proizvajalec: Excelitas PCO GmbH
- Naslov: Donaupark 11, 93309 Kelheim, Nemčija
- Kontakt: +49 (0) 9441 2005 50
- E-pošta: pco@excelitas.com
- Webspletno mesto: www.excelitas.com/product-category/pco
Navodila za uporabo izdelka
Splošne informacije
pco.convert ponuja različne funkcije za pretvorbo barv in psevdo barv. Za optimalno delovanje je pomembno, da sledite navodilom v uporabniškem priročniku.
Opis funkcije Convert API
Convert API ponuja nabor funkcij za manipulacijo barvnih in slikovnih podatkov. Spodaj je nekaj ključnih funkcij:
-
- PCO_ConvertCreate: Ustvarite nov primerek konverzije.
- PCO_ConvertDelete: Izbrišite primerek konverzije.
- PCO_ConvertGet: Pridobite nastavitve pretvorbe.
Pretvorba barv in psevdo barv
pco.convert podpira tako črno-belo kot tudi barvno pretvorbo. Sledite posebnim navodilom v priročniku za vsako vrsto pretvorbe.
pogosta vprašanja
- V: Kako izvedem barvno pretvorbo z uporabo pco.convert?
- O: Če želite izvesti barvno pretvorbo, uporabite funkcijo PCO_ConvertGet z ustreznimi parametri, kot je opisano v uporabniškem priročniku.
- V: Ali lahko izbrišem primerek konverzije?
- O: Da, primerek pretvorbe lahko izbrišete s funkcijo PCO_ConvertDelete.
uporabniški priročnik
pco.convert
Excelitas PCO GmbH vas prosi, da natančno preberete in upoštevate navodila v tem dokumentu. Za kakršna koli vprašanja ali komentarje nas lahko kadar koli kontaktirate.
- telefon: + 49 (0) 9441 2005 50
- faks: + 49 (0) 9441 2005 20
- poštni naslov: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Nemčija
- e-pošta: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
uporabniški priročnik 1.52.0
Izdano maja 2024
©Avtorske pravice Excelitas PCO GmbH
To delo je licencirano pod mednarodno licenco Creative Commons Attribution-NoDerivatives 4.0. Za view kopijo te licence obiščite http://creativecommons.org/licenses/by-nd/4.0/ ali pošljite pismo na Creative Commons, PO Box 1866, Mountain View, CA 94042, ZDA.
Splošno
- Ta opis SDK za pretvorbo je mogoče uporabiti za izvajanje rutin pretvorbe PCO v lastniških aplikacijah, ki se uporabljajo za nadzor kamer PCO. Prepovedana je uporaba pretvorbenih rutin s kamerami tretjih oseb.
- The pco.convert sdk je sestavljen iz dveh delov: funkcije pretvorbe LUT pco.conv.dll in pogovorne funkcije pco_cdlg.dll .
Funkcije pretvorbe se uporabljajo za pretvorbo podatkovnih območij, črno-belih in barvnih, z ločljivostjo nad 8 bitov na slikovno piko, v črno-bela podatkovna področja z ločljivostjo 8 bitov na slikovno piko ali barvna podatkovna območja z ločljivostjo 24. (32) bitov na slikovno piko. DLL vključuje tudi funkcije za ustvarjanje in polnjenje različnih pretvorbenih objektov. - Drugi del API-ja vsebuje pogovorne funkcije. Pogovorna okna so preprosta pogovorna okna GUI, ki uporabniku omogočajo nastavitev parametrov pretvorbenih predmetov. Funkcije pogovornega okna so vključene v pco_cdlg.dll in temeljijo na nekaterih funkcijah pco.conv.dll.
- V pco.sdk za pco kamere obstajata dve sampdatoteke, ki uporabljajo pretvornik sdk. Ena je Test_cvDlg sample in drugi je sc2_demo. Prosim, poglejte tiste sampdatotek, da bi 'videli' funkcije pretvorbe sdk v akciji.
Č/B in psevdo barvna pretvorba
Algoritem pretvorbe, uporabljen v funkciji črno-belo, temelji na naslednji preprosti rutini
kjer
- pos je spremenljivka števca
- dataout je območje izhodnih podatkov
- datain je območje vhodnih podatkov
- lutbw je podatkovno območje velikosti 2n, ki vsebuje LUT, kjer je n = ločljivost vhodnega območja v bitih na slikovno piko
V funkciji psevdobarve je osnovna rutina za pretvorbo v podatkovno območje RGB:
kjer
- pos je vhodna spremenljivka števca
- pout je spremenljivka izhodnega števca
- dataout je območje izhodnih podatkov
- datain je območje vhodnih podatkov
- lutbw je podatkovno območje velikosti 2n, ki vsebuje LUT, kjer je n = ločljivost vhodnega območja v bitih na slikovno piko
- lutred, lutgreen, lutblue so podatkovna področja velikosti 2n, ki vsebujejo LUT, kjer je n = ločljivost izhodnega območja v bitu na slikovno piko.
Pretvorba barv
- Barvni senzorji CCD, ki se uporabljajo v barvnih kamerah PCO, imajo filtre za rdeče, zelene in modre barve. Vsaka slikovna pika ima eno vrsto filtra, zato prvotno ne dobite informacij o vseh barvah za vsako slikovno piko. Namesto tega vsaka slikovna pika zagotavlja vrednost z dinamičnim razponom 12 bitov za barvo, ki gre skozi filter.
- Vse barvne kamere pri PCO delujejo z Bayerjevim filtrom DE mozaicking. Vzorec barvnega filtra teh barvnih slikovnih senzorjev je mogoče zmanjšati na matriko 2×2. Sam slikovni senzor je mogoče videti kot matriko teh matrik 2×2.
- Recimo ta barvni vzorec
Sama barva je le interpretacija matrice. To interpretacijo bo izvedel tako imenovani algoritem demosaicking. Pco_conv.dll deluje s posebno lastniško metodo.
Opis funkcije Convert API
PCO_ConvertCreate
Opis
Ustvari nov objekt za pretvorbo na podlagi strukture PCO_SensorInfo. Ustvarjeni ročaj za pretvorbo bo uporabljen med pretvorbo. Pokličite PCO_ConvertDelete, preden se aplikacija zapre in razloži pretvorbo dll.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | ROČAJ* | Kazalec na ročaj, ki bo prejel ustvarjeni objekt pretvorbe |
| strSensor | PCO_SensorInfo* | Kazalec na informacijsko strukturo senzorja. Ne pozabite nastaviti parametra wSize. |
| iConvertType | int | Spremenljivka za določanje vrste pretvorbe, bodisi črno-bela, barvna, psevdobarvna ali barvna 16 |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_ConvertDelete
Opis
Izbriše predhodno ustvarjen pretvorbeni objekt. To funkcijo je obvezno priklicati pred zaprtjem aplikacije.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer koda napake. |
PCO_ConvertGet
Opis
Pridobi vse vrednosti predhodno ustvarjenega predmeta pretvorbe.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrConvert | PCO_Convert* | Kazalec na strukturo pretvorbe pco |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer koda napake. |
PCO_ConvertSet
Opis
Nastavi potrebne vrednosti za predhodno ustvarjen objekt pretvorbe.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrConvert | PCO_Convert* | Kazalec na strukturo pretvorbe pco |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_ConvertGetDisplay
Opis
Pridobi strukturo PCO_Display
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrDisplay | PCO_Display* | Kazalec na strukturo zaslona pco |
Povratna vrednost
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrDisplay | PCO_Display* | Kazalec na strukturo zaslona pco |
PCO_ConvertSetDisplay
Opis
Nastavi strukturo PCO_Display
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrDisplay | PCO_Display* | Kazalec na strukturo zaslona pco |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_ConvertSetBayer
Opis
Nastavi vrednosti Bayerjeve strukture predhodno ustvarjenega pretvorbenega predmeta. S to funkcijo spremenite parametre Bayerjevega vzorca.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrBayer | PCO_Bayer* | Kazalec na strukturo PCO Bayer |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_ConvertSetFilter
Opis
Nastavi vrednosti strukture filtra predhodno ustvarjenega predmeta pretvorbe.
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| predfilter | PCO_Filter* | Kazalec na strukturo filtra pco |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_ConvertSetSensorInfo
Opis
Nastavi strukturo PCO_SensorInfo za predhodno ustvarjen pretvorbeni objekt
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| pstrSensorInfo | PCO_SensorInfo* | Kazalec na informacijsko strukturo senzorja. Ne pozabite nastaviti parametra wSize |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_SetPseudoLut
Opis
Naložite tri psevdolut barvne tabele risbe
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| psevdo_lut | nepodpisani znak * | Kazalec na barvne vrednosti psevdo lut (barve R, G, B: 256 * 3 bajtov ali 4 bajtov) |
| inumcolors | int | Nastavite na 3 za R, G, B ali 4 za R, G, B, A |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_LoadPseudoLut
Opis
Naloži tabelo za iskanje psevdo barv v objekt za pretvorbo. To funkcijo lahko uporabite za nalaganje nekaterih vnaprej določenih ali samoizdelanih psevdo iskalnih tabel.
Prototip
Parameter
| Ime Vrsta Opis | ||||||
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| fileime | char * | Ime file naložiti | ||||
Povratna vrednost
| Ime Vrsta Opis | ||||||
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| fileime | char * | Ime file naložiti | ||||
PCO_Convert16TO8
Opis
Pretvori slikovne podatke v b16 v 8-bitne podatke v b8 (sivine)
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| način | int | Parameter načina |
| icolmode | int | Parameter barvnega načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| b16 | beseda* | Kazalec na neobdelano sliko |
| b8 | bajt* | Kazalec na pretvorjeno 8-bitno črno-belo sliko |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_Convert16TO24
Opis
Pretvori slikovne podatke v b16 v 24-bitne podatke v b24 (sivine)
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| način | int | Parameter načina |
| Ime | Vrsta | Opis |
| icolmode | int | Parameter barvnega načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| b16 | beseda* | Kazalec na neobdelano sliko |
| b24 | bajt* | Kazalec na pretvorjeno 24-bitno barvno sliko |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_Convert16TOCOL
Opis
Pretvori slikovne podatke v b16 v podatke RGB v b8 (barva)
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| način | int | Parameter načina |
| icolmode | int | Parameter barvnega načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| b16 | beseda* | Kazalec na neobdelano sliko |
| b8 | bajt* | Kazalec na pretvorjeno 24-bitno barvno sliko |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_Convert16TOPSEUDO
Opis
Pretvori slikovne podatke v b16 v psevdo barvne podatke v b8 (barva)
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| način | int | Parameter načina |
| icolmode | int | Parameter barvnega načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| b16 | beseda* | Kazalec na neobdelano sliko |
| b8 | bajt* | Kazalec na pretvorjeno 24-bitno psevdo barvno sliko |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_Convert16TOCOL16
Opis
Pretvori slikovne podatke v b16 v podatke RGB v b16 (barva)
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| način | int | Parameter načina |
| Ime | Vrsta | Opis |
| icolmode | int | Parameter barvnega načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| b16in | beseda* | Kazalec na neobdelano sliko |
| b16out | beseda* | Kazalec na pretvorjeno 48-bitno barvno sliko |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_GetWhiteBalance
Opis
Pridobi vrednosti uravnotežene beline za color_tempand odtenek
Prototip
Parameter
| Ime | Vrsta | Opis |
| ph | Ročaj | Ročaj predhodno ustvarjenega predmeta pretvorbe |
| barvna_temp | int* | int kazalec za pridobitev izračunane barvne temperature |
| odtenek | int* | int kazalec za pridobitev izračunane vrednosti odtenka |
| način | int | Parameter načina |
| širina | int | Širina slike za pretvorbo |
| višina | int | Višina slike za pretvorbo |
| gb12 | BESEDA* | Kazalec na niz neobdelanih slikovnih podatkov |
| x_min | int | Pravokotnik za nastavitev območja slike, ki bo uporabljeno za izračun |
| y_min | int | Pravokotnik za nastavitev območja slike, ki bo uporabljeno za izračun |
| x_max | int | Pravokotnik za nastavitev območja slike, ki bo uporabljeno za izračun |
| y_max | int | Pravokotnik za nastavitev območja slike, ki bo uporabljeno za izračun |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_GetMaxLimit
Opis
GetMaxLimit pridobi vrednosti RGB za dano temperaturo in ton. Največja vrednost v pogovornem oknu za nadzor pretvorbe ne sme preseči največje vrednosti vrednosti RGB, npr. v primeru, da je R največja vrednost, se lahko največja vrednost poveča, dokler vrednost R ne doseže bitne ločljivosti (4095). Isti pogoj mora biti izpolnjen za zmanjšanje največje vrednosti, npr. v primeru, da je B najnižja vrednost, se lahko največja vrednost zmanjša, dokler vrednost B ne doseže minimalne vrednosti.
Prototip
Parameter
| Ime | Vrsta | Opis |
| r_max | lebdi* | Kazalec na plavajočo vrednost, ki prejme največjo rdečo vrednost |
| g_max | lebdi* | Kazalec na lebdečo vrednost, ki prejme največjo zeleno vrednost |
| b_max | lebdi* | Kazalec na lebdečo vrednost, ki prejme največjo modro vrednost |
| temp | lebdi | Barvna temperatura |
| odtenek | lebdi | Nastavitev odtenka |
| izhodni_biti | int | Bitna ločljivost pretvorjene slike (običajno 8) |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_GetColorValues
Opis
Pridobi barvno temperaturo in ton za podane največje vrednosti R, G, B.
GetColorValue se uporablja samo v pco.camware . Izračuna barvno temperaturo in ton na podlagi vrednosti Rmax, Gmax, Bmax stare barve lut. Izračunane vrednosti se uporabijo za pretvorbo starih slik b16 in tif16 z novimi rutinami za pretvorbo.
Prototip
Parameter
| Ime | Vrsta | Opis |
| pfColorTemp | lebdi* | Kazalec na lebdeče za sprejem barvne temperature |
| pfColorTemp | lebdi* | Kazalec na plovec za sprejem barvnega odtenka |
| iRedMax | int | Celo število za nastavitev trenutne največje vrednosti za rdečo |
| iGreenMax | int | Celo število za nastavitev trenutne največje vrednosti za zeleno. |
| iBlueMax | int | Celo število za nastavitev trenutne največje vrednosti za modro |
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_WhiteBalanceToDisplayStruct
Opis
Izračuna ravnovesje beline in nastavi vrednosti na strDisplaystruct, pri tem pa ohrani omejitve. Pridobi struct str Display iz interne ročice za pretvorbo
Prototip
Parameter
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
PCO_GetVersionInfoPCO_CONV
Opis
Vrne informacije o različici dll.
Prototip
Parameter
Povratna vrednost
| Ime | Vrsta | Opis |
| ErrorMessage | int | 0 v primeru uspeha, sicer Errorcode. |
Tipična izvedba
Ta tipična izvedba po korakih prikazuje osnovno rokovanje
- Izjave
- Nastavite vse parametre 'velikosti' medpomnilnika na pričakovane vrednosti:
- Nastavite parametre informacij o senzorju in ustvarite objekt za pretvorbo
- Po želji odprite pogovorno okno za pretvorbo
- Nastavite najmanjšo in največjo vrednost na želeni obseg in ju nastavite na predmet pretvorbe
- Izvedite pretvorbo in nastavite podatke v pogovorno okno, če je pogovorno okno odprto
- Zaprite izbirno odprto pogovorno okno za pretvorbo
- Zaprite objekt za pretvorbo:
Glejte Test_cvDlg sample v pco.sdk sample mapo. Začenši z različico 1.20 je obseg vrednosti negativnega odtenka podvojen.
- poštni naslov: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Nemčija
- telefon: +49 (0) 9441 2005 0
- e-pošta: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumenti / Viri
 |
EXCELITAS TECHNOLOGIES pco.convert mikroskopska kamera [pdfUporabniški priročnik pco.convert mikroskopska kamera, pco.convert, mikroskopska kamera, kamera |
