EXCELITAS TECHNOLOGIES pco.convert mikroskoobikaamera kasutusjuhend

Üldteave
Pco.convert pakub erinevaid funktsioone värvide ja pseudovärvide teisendamiseks. Optimaalse jõudluse tagamiseks on oluline järgida kasutusjuhendis toodud juhiseid.

Teisenda API funktsiooni kirjeldus
Convert API pakub funktsioonide komplekti värvi- ja pildiandmetega manipuleerimiseks. Allpool on mõned põhifunktsioonid:

- PCO_ConvertCreate: Looge uus konversioonieksemplar.
- PCO_ConvertDelete: Konversiooni eksemplari kustutamine.
- PCO_ConvertGet: Hangi konversiooniseaded.

Värv ja pseudovärvi teisendus
Pco.convert toetab nii mustvalgete kui ka värvide teisendamist. Järgige juhendis iga konversioonitüübi jaoks antud juhiseid.

KKK

K: Kuidas ma saan pco.convert abil värvi teisendada?
- V: Värvide teisendamiseks kasutage funktsiooni PCO_ConvertGet koos sobivate parameetritega, nagu on kirjeldatud kasutusjuhendis.
K: Kas ma saan konversioonieksemplari kustutada?
- V: Jah, saate konversioonieksemplari kustutada funktsiooni PCO_ConvertDelete abil.

kasutusjuhend
pco.convert

Excelitas PCO GmbH palub teil selles dokumendis olevad juhised hoolikalt läbi lugeda ja järgida. Küsimuste või kommentaaride korral võtke meiega igal ajal ühendust.

telefon: + 49 (0) 9441 2005 50

faks: + 49 (0) 9441 2005 20
postiaadress: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Saksamaa
email: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
kasutusjuhend 1.52.0
Välja antud mai 2024
©Autoriõigus Excelitas PCO GmbH

See teos on litsentsitud Creative Commonsi Attribution-NoDerivatives 4.0 rahvusvahelise litsentsi alusel. To view selle litsentsi koopia, külastage http://creativecommons.org/licenses/by-nd/4.0/ või saatke kiri aadressile Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Kindral

Seda teisendus-SDK kirjeldust saab kasutada PCO teisendamise rutiinide rakendamiseks patenteeritud rakendustes, mida kasutatakse PCO kaamerate juhtimiseks. Teisendusrutiinide kasutamine kolmandate osapoolte kaameratega on keelatud.
The pco.convert sdk koosneb kahest osast: LUT teisendusfunktsioonid pco.conv.dll ja dialoogifunktsioonid pco_cdlg.dll .
Teisendusfunktsioone kasutatakse üle 8 biti piksli eraldusvõimega andmealade, mustvalgete ja värviliste andmepiirkondade teisendamiseks kas mustvalgeteks andmepiirkondadeks eraldusvõimega 8 bitti piksli kohta või värvilisteks andmealadeks eraldusvõimega 24 (32) bitti piksli kohta. DLL sisaldab ka funktsioone erinevate teisendusobjektide loomiseks ja täitmiseks.
API teine osa sisaldab dialoogifunktsioone. Dialoogid on lihtsad GUI-dialoogid, mis võimaldavad kasutajal määrata teisendatavate objektide parameetreid. Dialoogifunktsioonid on lisatud pco_cdlg.dll ja põhinevad mõnel faili pco.conv.dll funktsioonil.
Aastal pco.sdk pco kaamerate jaoks on kaks kaameratamples, mis kasutavad convert sdk. Üks on Test_cvDlg sample ja teine on sc2_demo. Palun vaadake neid samples, et "näha" sdk konverteerimise funktsioone töös.

Mustvalge ja pseudovärvi teisendus
Mustvalge funktsioonis kasutatav teisendusalgoritm põhineb järgmisel lihtsal rutiinil

kus

pos on loenduri muutuja
dataout on väljundandmete ala
datain on sisendandmete ala

lutbw on andmeala suurusega 2n, mis sisaldab LUT-d, kus n = sisendala eraldusvõime bittides piksli kohta

Funktsioonis pseudocolor on põhirutiin RGB-andmealaks teisendamiseks:

kus

pos on sisendloenduri muutuja
pout on väljundi loenduri muutuja

dataout on väljundandmete ala
datain on sisendandmete ala
lutbw on andmeala suurusega 2n, mis sisaldab LUT-d, kus n = sisendala eraldusvõime bittides piksli kohta

lutred, lutgreen, lutblue on LUT-d sisaldavad andmepiirkonnad suurusega 2n, kus n = väljundpiirkonna eraldusvõime bitti piksli kohta.

Värvi teisendamine

PCO värvikaamerates kasutatavatel CCD-värvianduritel on filtrid punase, rohelise ja sinise värvi jaoks. Igal pikslil on ühte tüüpi filter, seega ei saa te algselt iga piksli kohta täielikku värviteavet. Pigem annab iga piksel filtrit läbiva värvi jaoks väärtuse, mille dünaamiline ulatus on 12 bitti.

Kõik PCO värvikaamerad töötavad Bayeri filtriga DE mosaiikiga. Nende värviliste pildiandurite värvifiltri mustrit saab taandada 2 × 2 maatriksiks. Pildiandurit ennast võib vaadelda kui nende 2 × 2 maatriksite maatriksit.
Oletame, et see värvimuster

Värv ise on vaid maatriksi tõlgendus. See tõlgendus tehakse nn demosaickingu algoritmi abil. Pco_conv.dll töötab spetsiaalse patenteeritud meetodiga.

Teisenda API funktsiooni kirjeldus

PCO_ConvertCreate

Kirjeldus
Loob uue teisendusobjekti PCO_SensorInfo struktuuri alusel. Loodud teisenduskäepidet kasutatakse teisendamise ajal. Helistage PCO_ConvertDelete'ile, enne kui rakendus väljub ja konverteeriva dll-i maha laadib.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	HANDLE*	Osutage käepidemele, mis võtab vastu loodud teisendusobjekti
strSensor	PCO_SensorInfo*	Osuti anduri teabestruktuurile. Ärge unustage määrata parameetrit wSize.
iConvertType	int	Muutuja konversioonitüübi määramiseks, kas must/valge, värv, pseudovärv või värv 16

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertDelete

Kirjeldus
Kustutab eelnevalt loodud teisendusobjekti. Enne rakenduse sulgemist on selle funktsiooni kutsumine kohustuslik.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertGet

Kirjeldus
Hangi kõik eelnevalt loodud teisendusobjekti väärtused.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrConvert	PCO_Convert*	Osuti pco teisendusstruktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertSet

Kirjeldus
Määrab eelnevalt loodud teisendusobjekti jaoks vajalikud väärtused.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrConvert	PCO_Convert*	Osuti pco teisendusstruktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertGetDisplay

Kirjeldus
Saab PCO_Display struktuuri

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrDisplay	PCO_Display*	Osuti pco kuvastruktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrDisplay	PCO_Display*	Osuti pco kuvastruktuurile

PCO_ConvertSetDisplay

Kirjeldus
Määrab PCO_Display struktuuri

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrDisplay	PCO_Display*	Osuti pco kuvastruktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertSetBayer

Kirjeldus
Määrab varem loodud teisendusobjekti Bayeri struktuuri väärtused. Kasutage seda funktsiooni Bayeri mustri parameetrite muutmiseks.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrBayer	PCO_Bayer*	Osuti PCO Bayeri struktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertSetFilter

Kirjeldus
Määrab eelnevalt loodud teisendusobjekti filtri struktuuri väärtused.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
eelfilter	PCO_Filter*	Osuti pco-filtri struktuurile

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_ConvertSetSensorInfo

Kirjeldus
Määrab varem loodud teisendusobjekti PCO_SensorInfo struktuuri

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pstrSensorInfo	PCO_SensorInfo*	Osuti anduri teabestruktuurile. Ärge unustage määrata parameetrit wSize

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_SetPseudoLut

Kirjeldus
Laadige süžee kolm pseudolutvärvitabelit

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
pseudo_lut	allkirjastamata märk *	Kursor pseudo lut värviväärtustele (R, G, B värvid: 256 * 3 baiti või 4 baiti)
inumcolors	int	Määrake väärtuseks 3 R,G,B jaoks või 4 R,G,B,A jaoks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_LoadPseudoLut

Kirjeldus
Laadib teisendatavale objektile pseudovärviotsingu tabeli. Seda funktsiooni saab kasutada mõne eelmääratletud või ise loodud pseudootsingu tabeli laadimiseks.

Prototüüp

Parameeter

Nimi Tüüp Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
vormingus	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenimi	süsi*	nimi file laadida

Tagastusväärtus

Nimi Tüüp Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
vormingus	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenimi	süsi*	nimi file laadida

PCO_Convert16TO8

Kirjeldus
Pildiandmete teisendamine b16-vormingus 8-bitisteks andmeteks b8-s (halltoonides)

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
režiimis	int	Režiimi parameeter
icolmode	int	Värvirežiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
b16	sõna*	Kursor töötlemata pildile
b8	bait*	Kursor teisendatud 8-bitisele mustvalgele kujutisele

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_Convert16TO24

Kirjeldus
Pildiandmete teisendamine b16-vormingus 24-bitisteks andmeteks b24-s (halltoonides)

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
režiimis	int	Režiimi parameeter

Nimi	Tüüp	Kirjeldus
icolmode	int	Värvirežiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
b16	sõna*	Kursor töötlemata pildile
b24	bait*	Kursor teisendatud 24-bitiseks värvipildiks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_Convert16TOCOL

Kirjeldus
Teisendage b16-vormingus pildiandmed RGB-andmeteks b8-s (värvilised)

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
režiimis	int	Režiimi parameeter
icolmode	int	Värvirežiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
b16	sõna*	Kursor töötlemata pildile
b8	bait*	Kursor teisendatud 24-bitiseks värvipildiks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_Convert16TOPSEUDO

Kirjeldus
Pildiandmete teisendamine b16-s pseudovärviandmeteks b8-s (värviline)

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
režiimis	int	Režiimi parameeter
icolmode	int	Värvirežiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
b16	sõna*	Kursor töötlemata pildile
b8	bait*	Kursor teisendatud 24-bitiseks pseudovärvipildiks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_Convert16TOCOL16

Kirjeldus
Teisendage b16-vormingus pildiandmed RGB-andmeteks b16-s (värvilised)

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
režiimis	int	Režiimi parameeter

Nimi	Tüüp	Kirjeldus
icolmode	int	Värvirežiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
b16 tolli	sõna*	Kursor töötlemata pildile
b16out	sõna*	Kursor teisendatud 48-bitiseks värvipildiks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_GetWhiteBalance

Kirjeldus
Hangi valge tasakaalustatud väärtused jaoks color_tempand tint

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
ph	Hoolitseme	Käepide varem loodud teisendusobjektiks
värvi_temp	int*	int, et saada arvutatud värvitemperatuur
tooni	int*	int osuti, et saada arvutatud tooni väärtus
režiimis	int	Režiimi parameeter
laius	int	Teisendatava pildi laius
kõrgus	int	Teisendatava pildi kõrgus
GB12	WORD*	Kursor töötlemata pildi andmemassiivile
x_min	int	Ristkülik arvutamisel kasutatava pildipiirkonna määramiseks
y_min	int	Ristkülik arvutamisel kasutatava pildipiirkonna määramiseks
x_max	int	Ristkülik arvutamisel kasutatava pildipiirkonna määramiseks
y_max	int	Ristkülik arvutamisel kasutatava pildipiirkonna määramiseks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_GetMaxLimit

Kirjeldus
GetMaxLimit saab RGB väärtused antud temp ja tooni jaoks. Maksimaalne väärtus teisendusjuhtimise dialoogis ei tohi ületada RGB väärtuste suurimat väärtust, nt kui R on suurim väärtus, võib maksimaalne väärtus suureneda, kuni R väärtus jõuab biti eraldusvõimeni (4095). Maksimaalse väärtuse vähendamiseks peab olema täidetud sama tingimus, nt kui B on madalaim väärtus, võib max väärtus väheneda, kuni B väärtus jõuab miinimumväärtuseni.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
r_max	hõljuk*	Osuti ujukile, mis saab maksimaalse punase väärtuse
g_max	hõljuk*	Osuti ujukile, mis saab maksimaalse rohelise väärtuse
b_max	hõljuk*	Osuti ujukile, mis saab maksimaalse sinise väärtuse
temp	ujuk	Värvitemperatuur
tooni	ujuk	Tooni seadmine
väljundbitid	int	Teisendatud pildi bitieraldusvõime (tavaliselt 8)

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_GetColorValues

Kirjeldus
Hangib värvitemperatuuri ja tooni antud R,G,B max väärtuste jaoks.
GetColorValuesist kasutatakse ainult pco.camware . See arvutab värvitemperatuuri ja tooni vana värvi lut Rmax, Gmax, Bmax väärtuste põhjal. Arvutatud väärtusi kasutatakse vanade b16 ja tif16 kujutiste teisendamiseks uute teisendusrutiinidega.

Prototüüp

Parameeter

Nimi	Tüüp	Kirjeldus
pfColorTemp	hõljuk*	Osuti värvitemperatuuri saamiseks ujukile
pfColorTemp	hõljuk*	Osuti värvitooni saamiseks ujukile
iRedMax	int	Täisarv punase praeguse maksimumväärtuse määramiseks
iGreenMax	int	Täisarv rohelise praeguse maksimaalse väärtuse määramiseks.
iBlueMax	int	Täisarv sinise praeguse maksimaalse väärtuse määramiseks

Tagastusväärtus

Nimi	Tüüp	Kirjeldus
Veateade	int	Edu korral 0, muidu veakood.

PCO_WhiteBalanceToDisplayStruct

Kirjeldus
Arvutab valge tasakaalu ja seab väärtused strDisplaystructile, säilitades samas piirid. Hangib sisemiselt teisenduskäepidemest struct str Display

Prototüüp