EXCELITAS TECHNOLOGIES pco.convert Mikroskoopkamera
Spesifikasies
- Produk Naam: PCO. omskep
- Weergawe: 1.52.0
- Lisensie: Creative Commons Erkenning-Geen Afgeleides 4.0 Internasionale Lisensie
- Vervaardiger: Excelitas PCO GmbH
- Adres: Donaupark 11, 93309 Kelheim, Duitsland
- Kontak: +49 (0) 9441 2005 50
- E-pos: pco@excelitas.com
- Webwebwerf: www.excelitas.com/product-category/pco
Produkgebruiksinstruksies
Algemene inligting
Die pco.convert bied verskeie funksies vir kleur- en pseudokleuromskakeling. Dit is belangrik om die instruksies in die gebruikershandleiding te volg vir optimale werkverrigting.
Skakel API-funksiebeskrywing
Die Convert API bied 'n stel funksies vir die manipulering van kleur- en beelddata. Hieronder is 'n paar sleutelfunksies:
-
- PCO_ConvertCreate: Skep 'n nuwe omskakelingsinstansie.
- PCO_ConvertDelete: Vee 'n omskakelingsinstansie uit.
- PCO_ConvertGet: Kry omskakeling-instellings.
Kleur en Pseudo Kleur Omskakeling
Die pco.convert ondersteun beide swart en wit omskakeling sowel as kleur omskakeling. Volg die spesifieke instruksies wat in die handleiding vir elke tipe omskakeling verskaf word.
Gereelde vrae
- V: Hoe voer ek 'n kleuromskakeling uit met behulp van pco.convert?
- A: Om 'n kleuromskakeling uit te voer, gebruik die PCO_ConvertGet-funksie met die toepaslike parameters soos uiteengesit in die gebruikershandleiding.
- V: Kan ek 'n omskakelingsinstansie uitvee?
- A: Ja, jy kan 'n omskakelingsinstansie uitvee deur die PCO_ConvertDelete-funksie te gebruik.
gebruikershandleiding
pco.convert
Excelitas PCO GmbH vra u om die instruksies in hierdie dokument noukeurig te lees en te volg. Vir enige vrae of kommentaar, kontak ons asseblief enige tyd.
- telefoon: + 49 (0) 9441 2005 50
- faks: + 49 (0) 9441 2005 20
- posadres: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Duitsland
- e-pos: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
gebruikershandleiding 1.52.0
Vrygestel Mei 2024
© Kopiereg Excelitas PCO GmbH
Hierdie werk is gelisensieer onder die Creative Commons Attribution-NoDerivatives 4.0 International License. Om view 'n afskrif van hierdie lisensie, besoek http://creativecommons.org/licenses/by-nd/4.0/ of stuur 'n brief aan Creative Commons, Posbus 1866, Berg View, CA 94042, VSA.
Algemeen
- Hierdie omskakeling SDK-beskrywing kan gebruik word om die PCO-omskakelroetines in eie toepassings te implementeer, wat gebruik word om PCO-kameras te beheer. Dit is verbode om die omskakelingsroetines met derdeparty-kameras te gebruik.
- Die pco.convert sdk bestaan uit twee dele: Die LUT-omskakelingsfunksies pco.conv.dll en die dialoogfunksies pco_cdlg.dll .
Die omskakelingsfunksies word gebruik om dataareas, s/w en kleur, met 'n resolusie van meer as 8 bis per pixel om te skakel na óf s/w dataareas met 'n resolusie van 8 bis per pixel óf kleurdataareas met 'n resolusie van 24 (32) bis per pixel. Die DLL bevat ook funksies om die verskillende omskakelingsobjekte te skep en te vul. - Die tweede deel van die API bevat die dialoogfunksies. Die dialoogvensters is eenvoudige GUI-dialoogvensters wat die gebruiker in staat stel om die parameters van die omskakelingsobjekte in te stel. Die dialoogfunksies is ingesluit in die pco_cdlg.dll en is gebaseer op sommige funksies van die pco.conv.dll.
- In die pco.sdk vir PCO-kameras bestaan daar twee samples, wat gebruik maak van die convert sdk. Een is die Test_cvDlg sample en die ander is die sc2_demo. Kyk asseblief na daardie samples om die convert sdk-funksies in aksie te 'sien'.
S/W En Pseudo Kleur Omskakeling
Die omskakelingsalgoritme wat in die s/w-funksie gebruik word, is gebaseer op die volgende eenvoudige roetine
waar
- pos is die teenveranderlike
- dataout is die uitsetdataarea
- datain is die invoerdataarea
- lutbw is 'n dataarea van grootte 2n wat die LUT bevat, waar n = resolusie van die invoerarea in bisse per pixel
In die pseudokleurfunksie is die basiese roetine om na 'n RGB-dataarea om te skakel:
waar
- pos is die inset teller veranderlike
- pout is die uitset teller veranderlike
- dataout is die uitsetdataarea
- datain is die invoerdataarea
- lutbw is 'n dataarea van grootte 2n wat die LUT bevat, waar n = resolusie van die invoerarea in bisse per pixel
- lutred, lutgreen, lutblue is dataareas van grootte 2n wat die LUT bevat, waar n = resolusie van die uitsetarea in bis per pixel.
Kleur Omskakeling
- CCD-kleursensors wat in PCO-kleurkameras gebruik word, het filters vir die kleure rooi, groen en blou. Elke pixel het een tipe filter, dus oorspronklik kry jy nie volkleurinligting vir elke pixel nie. Elke pixel lewer eerder 'n waarde met 'n dinamiese reeks van 12 bisse vir die kleur wat die filter deurlaat.
- Alle kleurkameras by PCO werk met die Bayer-filter DE-mosaïek. Die kleurfilterpatroon van daardie kleurbeeldsensors kan tot 'n 2×2-matriks verminder word. Die beeldsensor self kan gesien word as 'n matriks van daardie 2×2 matrikse.
- Gestel hierdie kleurpatroon
Die kleur self is slegs 'n interpretasie van die matriks. Hierdie interpretasie sal gedoen word deur 'n sogenaamde demosaicking-algoritme. Die pco_conv.dll werk met 'n spesiale eie metode.
Skakel API-funksiebeskrywing
PCO_ConvertCreate
Beskrywing
Skep 'n nuwe omskakelingsobjek gebaseer op die PCO_SensorInfo-struktuur. Die geskepte omskakelhandvatsel sal tydens die omskakeling gebruik word. Bel asseblief PCO_ConvertDelete voor die toepassing verlaat en die convert dll aflaai.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANTEER* | Wys na 'n handvatsel wat die geskepte omskepte voorwerp sal ontvang |
strSensor | PCO_SensorInfo* | Wys na 'n sensorinligtingstruktuur. Moet asseblief nie vergeet om die wSize-parameter in te stel nie. |
iConvertType | int | Veranderlik om die omskakelingstipe te bepaal, hetsy s/w, kleur, pseudokleur of kleur 16 |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertDelete
Beskrywing
Vee 'n voorheen geskep omskakelingsobjek uit. Dit is verpligtend om hierdie funksie te roep voordat die toepassing gesluit word.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertGet
Beskrywing
Kry al die waardes van 'n voorheen geskep omskep voorwerp.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstr Skakel | PCO_Convert* | Wyser na 'n PCO-omskakelingstruktuur |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertSet
Beskrywing
Stel die nodige waardes vir 'n voorheen geskep omskakelingsobjek.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstr Skakel | PCO_Convert* | Wyser na 'n PCO-omskakelingstruktuur |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertGetDisplay
Beskrywing
Kry die PCO_Display-struktuur
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstr Vertoon | PCO_Vertoon* | Wys na 'n PCO-vertoonstruktuur |
Retourwaarde
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstr Vertoon | PCO_Vertoon* | Wys na 'n PCO-vertoonstruktuur |
PCO_ConvertSetDisplay
Beskrywing
Stel die PCO_Display-struktuur
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstr Vertoon | PCO_Vertoon* | Wys na 'n PCO-vertoonstruktuur |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertSetBayer
Beskrywing
Stel die Bayer-struktuurwaardes van 'n voorheen geskepte omskakelingsobjek. Gebruik hierdie funksies om die Bayer-patroonparameters te verander.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstrBayer | PCO_Bayer* | Wys na 'n PCO Bayer-struktuur |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertSetFilter
Beskrywing
Stel die filterstruktuurwaardes van 'n voorheen geskep omskakelingsobjek.
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
sorteer | PCO_Filter* | Wys na 'n PCO-filterstruktuur |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_ConvertSetSensorInfo
Beskrywing
Stel die PCO_SensorInfo-struktuur vir 'n voorheen geskepde omskakelingsobjek
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pstrSensorInfo | PCO_SensorInfo* | Wys na 'n sensorinligtingstruktuur. Moet asseblief nie vergeet om die wSize-parameter in te stel nie |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_SetPseudoLut
Beskrywing
Laai die drie pseudolut-kleurtabelle van plot
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
pseudo_lut | ongetekende char * | Wyser na pseudo lut kleurwaardes (R,G,B kleure: 256 * 3 grepe, of 4 grepe) |
inumkleure | int | Stel op óf 3 vir R,G,B of 4 vir R,G,B,A |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_LoadPseudoLut
Beskrywing
Laai 'n pseudo-kleur-opsoektabel na die omskepte voorwerp. Hierdie funksie kan gebruik word om sommige van die vooraf gedefinieerde of selfgeskepte pseudo-opsoektabelle te laai.
Prototipe
Parameter
Naam Tipe Beskrywing | ||||||
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp | ||||
formaat | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
filenaam | char* | Naam van die file te laai |
Retourwaarde
Naam Tipe Beskrywing | ||||||
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp | ||||
formaat | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
filenaam | char* | Naam van die file te laai |
PCO_Convert16TO8
Beskrywing
Omskep prentdata in b16 na 8bit data in b8 (grysskaal)
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
modus | int | Modus parameter |
icolmode | int | Kleurmodusparameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
b16 | woord* | Wys na die rou beeld |
b8 | greep* | Wyser na omgeskakelde 8bit s/w-beeld |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_Convert16TO24
Beskrywing
Omskep prentdata in b16 na 24bit data in b24 (grysskaal)
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
modus | int | Modus parameter |
Naam | Tik | Beskrywing |
icolmode | int | Kleurmodusparameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
b16 | woord* | Wys na die rou beeld |
b24 | greep* | Wyser na omgeskakelde 24bis-kleurbeeld |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_Convert16TOCOL
Beskrywing
Omskep prentdata in b16 na RGB-data in b8 (kleur)
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
modus | int | Modus parameter |
icolmode | int | Kleurmodusparameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
b16 | woord* | Wys na die rou beeld |
b8 | greep* | Wyser na omgeskakelde 24bis-kleurbeeld |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_Convert16TOPSEUDO
Beskrywing
Skakel prentdata in b16 om na pseudokleurdata in b8 (kleur)
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
modus | int | Modus parameter |
icolmode | int | Kleurmodusparameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
b16 | woord* | Wys na die rou beeld |
b8 | greep* | Wyser na omgeskakelde 24bit pseudokleurbeeld |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_Convert16TOCOL16
Beskrywing
Omskep prentdata in b16 na RGB-data in b16 (kleur)
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
modus | int | Modus parameter |
Naam | Tik | Beskrywing |
icolmode | int | Kleurmodusparameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
b16in | woord* | Wys na die rou beeld |
b16 uit | woord* | Wyser na omgeskakelde 48bis-kleurbeeld |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_GetWhiteBalance
Beskrywing
Kry wit gebalanseerde waardes vir color_tempand tint
Prototipe
Parameter
Naam | Tik | Beskrywing |
ph | HANDGREEP | Hanteer na 'n voorheen geskep omskep voorwerp |
kleur_temp | int* | int wyser om die berekende kleurtemperatuur te kry |
tint | int* | int-wyser om die berekende tintwaarde te kry |
modus | int | Modus parameter |
breedte | int | Breedte van die beeld om te omskep |
hoogte | int | Hoogte van die beeld om te omskep |
gb12 | WOORD* | Wyser na rou prentjie data skikking |
x_min | int | Reghoek om die beeldstreek te stel wat vir berekening gebruik moet word |
j_min | int | Reghoek om die beeldstreek te stel wat vir berekening gebruik moet word |
x_maks | int | Reghoek om die beeldstreek te stel wat vir berekening gebruik moet word |
y_max | int | Reghoek om die beeldstreek te stel wat vir berekening gebruik moet word |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_GetMaxLimit
Beskrywing
GetMaxLimit kry die RGB-waardes vir 'n gegewe temperatuur en tint. Die maksimum waarde binne die omskakelbeheerdialoog moet nie die grootste waarde van die RGB-waardes oorskry nie, bv. indien R die grootste waarde is, kan die maksimum waarde toeneem totdat die R-waarde die bisresolusie (4095) tref. Dieselfde voorwaarde moet nagekom word vir die vermindering van die maksimum waarde, bv. indien B die laagste waarde is, kan die maksimum waarde afneem totdat die B-waarde die minimum waarde tref.
Prototipe
Parameter
Naam | Tik | Beskrywing |
r_maks | dryf* | Wys na 'n vlotter wat die maksimum rooi waarde ontvang |
g_maks | dryf* | Wys na 'n vlotter wat die maksimum groenwaarde ontvang |
b_maks | dryf* | Wys na 'n drywer wat die maksimum blou waarde ontvang |
temp | dryf | Kleur temperatuur |
tint | dryf | Tint instelling |
uitset_bisse | int | Bietjie-resolusie van die omgeskakelde beeld (gewoonlik 8) |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_GetColorValues
Beskrywing
Kry kleurtemperatuur en tint vir gegewe R,G,B maksimum waardes.
GetColorValuesis word slegs gebruik in pco.camware . Dit bereken die kleurtemperatuur en tint gebaseer op die Rmax,Gmax,Bmax waardes van die ou kleur lut. Die berekende waardes word gebruik om ou b16- en tif16-beelde met die nuwe omskakelroetines om te skakel.
Prototipe
Parameter
Naam | Tik | Beskrywing |
pfKleurTemp | dryf* | Wys na 'n vlotter om die kleurtemperatuur te ontvang |
pfKleurTemp | dryf* | Wys na 'n vlotter om die kleurtint te ontvang |
iRedMax | int | Heelgetal om die huidige maksimum waarde vir rooi te stel |
iGreenMax | int | Heelgetal om die huidige maksimum waarde vir groen te stel. |
iBlueMax | int | Heelgetal om die huidige maksimum waarde vir blou te stel |
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_WhiteBalanceToDisplayStruct
Beskrywing
Bereken die witbalans en stel die waardes op die strDisplaystruct terwyl die limiete gehandhaaf word. Kry die struct str Display van die convert Handle intern
Prototipe
Parameter
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
PCO_GetVersionInfoPCO_CONV
Beskrywing
Wys weergawe-inligting oor die dll.
Prototipe
Parameter
Retourwaarde
Naam | Tik | Beskrywing |
Foutboodskap | int | 0 in geval van sukses, Foutkode anders. |
Tipiese implementering
Hierdie tipiese stap vir stap implementering wys die basiese hantering
- Verklarings
- Stel alle buffer 'grootte' parameters op die verwagte waardes:
- Stel die sensorinligtingparameters in en skep die omskakelingsobjek
- Maak opsioneel 'n omskakeldialoog oop
- Stel die min en maksimum waarde op die verlangde reeks en stel dit op die omskakelingsobjek
- Doen die omskakeling en stel die data na die dialoog as dialoog oop is
- Maak die opsioneel oopgemaakte omskakeldialoog toe
- Maak die omskakelingsvoorwerp toe:
Sien die Test_cvDlg sample in die pco.sdk sampdie gids. Vanaf v1.20 is die omvang van die negatiewe tintwaarde verdubbel.
- posadres: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Duitsland
- telefoon: +49 (0) 9441 2005 0
- e-pos: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumente / Hulpbronne
![]() |
EXCELITAS TECHNOLOGIES pco.convert Mikroskoopkamera [pdfGebruikershandleiding pco.convert Mikroskoopkamera, pco.convert, Mikroskoopkamera, Kamera |