EXCELITAS TECHNOLOGIES pco.convert Mikroskooppikameran käyttöopas

Yleistä tietoa
pco.convert tarjoaa erilaisia toimintoja värien ja pseudovärien muuntamiseen. On tärkeää noudattaa käyttöohjeessa olevia ohjeita parhaan mahdollisen suorituskyvyn saavuttamiseksi.

Muunna API-funktion kuvaus
Convert API tarjoaa joukon toimintoja väri- ja kuvatietojen käsittelyyn. Alla on joitain keskeisiä toimintoja:

- PCO_ConvertCreate: Luo uusi konversioinstanssi.
- PCO_ConvertDelete: Poista konversioinstanssi.
- PCO_ConvertGet: Hanki tulosasetukset.

Väri ja pseudovärimuunnos
pco.convert tukee sekä mustavalkomuunnoksia että värimuunnoksia. Noudata kunkin muunnostyypin ohjekirjassa annettuja ohjeita.

FAQ

K: Kuinka suoritan värimuunnos pco.convertilla?
- V: Suorita värimuunnos käyttämällä PCO_ConvertGet-toimintoa asianmukaisilla parametreilla, kuten käyttöoppaassa on kuvattu.
K: Voinko poistaa muunnosesiintymän?
- V: Kyllä, voit poistaa muunnosesiintymän käyttämällä PCO_ConvertDelete-toimintoa.

käyttöopas
pco.convert

Excelitas PCO GmbH pyytää sinua lukemaan huolellisesti tämän asiakirjan ohjeet ja noudattamaan niitä. Jos sinulla on kysyttävää tai kommentteja, ota meihin yhteyttä milloin tahansa.

puhelin: + 49 (0) 9441 2005 50

faksi: + 49 (0) 9441 2005 20
postiosoite: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Saksa
sähköposti: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
käyttöohje 1.52.0
Julkaistu toukokuussa 2024
©Tekijänoikeus Excelitas PCO GmbH

Tämä teos on lisensoitu Creative Commons Attribution-NoDerivatives 4.0 International License -lisenssillä. Vastaanottaja view kopio tästä lisenssistä, vieraile http://creativecommons.org/licenses/by-nd/4.0/ tai lähetä kirje osoitteeseen Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Kenraali

Tätä muunnos-SDK-kuvausta voidaan käyttää PCO-muunnosrutiinien toteuttamiseen patentoiduissa sovelluksissa, joita käytetään PCO-kameroiden ohjaamiseen. Muunnosrutiinien käyttö kolmansien osapuolien kameroiden kanssa on kielletty.
The pco.convert sdk koostuu kahdesta osasta: LUT-muunnosfunktiot pco.conv.dll ja dialogitoiminnot pco_cdlg.dll .
Muunnostoimintoja käytetään muuntamaan data-alueet, mustavalko- ja värialueet, joiden resoluutio on yli 8 bittiä pikseliä kohden, joko mustavalko-tietoalueiksi, joiden resoluutio on 8 bittiä pikseliä kohden, tai väritietoalueiksi, joiden resoluutio on 24 (32) bittiä pikseliä kohden. DLL sisältää myös toimintoja eri muunnosobjektien luomiseen ja täyttämiseen.
API:n toinen osa sisältää dialogitoiminnot. Valintaikkunat ovat yksinkertaisia GUI-valintaikkunoita, joiden avulla käyttäjä voi asettaa muunnosobjektien parametrit. Dialogitoiminnot sisältyvät pco_cdlg.dll ja ne perustuvat joihinkin pco.conv.dll-tiedoston toimintoihin.
Vuonna pco.sdk pco-kameroita varten on olemassa kaksi kameraaamples, jotka käyttävät convert sdk:tä. Yksi on Test_cvDlg sample ja toinen on sc2_demo. Ole hyvä ja katso ne samples voidakseen "nähdä" convert sdk -toiminnot toiminnassa.

Mustavalko- ja pseudovärien muunnos
Mustavalko-funktiossa käytetty muunnosalgoritmi perustuu seuraavaan yksinkertaiseen rutiiniin

jossa

pos on laskurimuuttuja
dataout on lähtötietoalue
datain on syöttödata-alue

lutbw on koon 2n tietoalue, joka sisältää LUT:n, jossa n = syöttöalueen resoluutio bitteinä pikseliä kohden

Pseudocolor-funktiossa RGB-tietoalueeksi muuntamisen perusrutiini on:

jossa

pos on tulolaskurin muuttuja
pout on lähtölaskurin muuttuja

dataout on lähtötietoalue
datain on syöttödata-alue
lutbw on koon 2n tietoalue, joka sisältää LUT:n, jossa n = syöttöalueen resoluutio bitteinä pikseliä kohden

lutred, lutgreen, lutblue ovat koon 2n tietoalueita, jotka sisältävät LUT:n, missä n = tulostusalueen resoluutio bitteinä pikseliä kohden.

Värin muuntaminen

PCO-värikameroissa käytetyissä CCD-väriantureissa on suodattimet punaiselle, vihreälle ja siniselle väreille. Jokaisella pikselillä on yksi suodatintyyppi, joten alun perin et saa täydellistä väritietoa jokaisesta pikselistä. Pikemminkin jokainen pikseli antaa arvon, jonka dynaaminen alue on 12 bittiä suodattimen läpäisevälle värille.

Kaikki PCO:n värikamerat toimivat Bayer-filter DE -mosaiikoinnin kanssa. Näiden värikuva-anturien värisuodatinkuvio voidaan pienentää 2 × 2 -matriisiksi. Itse kuva-anturi voidaan nähdä näiden 2 × 2 matriisin matriisina.
Oletetaan, että tämä värikuvio

Itse väri on vain tulkinta matriisista. Tämä tulkinta tehdään niin sanotulla demosaicking-algoritmilla. pco_conv.dll toimii erityisellä menetelmällä.

Muunna API-funktion kuvaus

PCO_ConvertCreate

Kuvaus
Luo uuden muunnosobjektin PCO_SensorInfo-rakenteen perusteella. Luotua muunnoskahvaa käytetään muuntamisen aikana. Soita PCO_ConvertDelete ennen kuin sovellus sulkeutuu ja lataa convert dll:n.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA*	Osoita kahvaan, joka vastaanottaa luodun muunnosobjektin
strAnturi	PCO_SensorInfo*	Osoitin anturin tietorakenteeseen. Älä unohda asettaa wSize-parametria.
iConvertType	int	Muuttuja, jolla määritetään muunnostyyppi, joko mustavalko, väri, näennäisväri tai väri 16

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_ConvertDelete

Kuvaus
Poistaa aiemmin luodun muunnosobjektin. Tämä toiminto on kutsuttava ennen sovelluksen sulkemista.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, virhekoodi muussa tapauksessa.

PCO_ConvertGet

Kuvaus
Hakee kaikki aiemmin luodun muunnosobjektin arvot.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrConvert	PCO_Convert*	Osoitin pco-muunnosrakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, virhekoodi muussa tapauksessa.

PCO_ConvertSet

Kuvaus
Asettaa tarvittavat arvot aiemmin luodulle muunnosobjektille.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrConvert	PCO_Convert*	Osoitin pco-muunnosrakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_ConvertGetDisplay

Kuvaus
Saa rakenteen PCO_Display

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrDisplay	PCO_Display*	Osoitin pco-näyttörakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrDisplay	PCO_Display*	Osoitin pco-näyttörakenteeseen

PCO_ConvertSetDisplay

Kuvaus
Asettaa PCO_Display-rakenteen

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrDisplay	PCO_Display*	Osoitin pco-näyttörakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_ConvertSetBayer

Kuvaus
Asettaa aiemmin luodun muunnosobjektin Bayer-rakenteen arvot. Käytä näitä toimintoja muuttaaksesi Bayer-kuvion parametreja.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrBayer	PCO_Bayer*	Osoitin PCO Bayer -rakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_ConvertSetFilter

Kuvaus
Asettaa aiemmin luodun muunnosobjektin suodatinrakenteen arvot.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
esisuodatin	PCO_Filter*	Osoitin pco-suodatinrakenteeseen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_ConvertSetSensorInfo

Kuvaus
Asettaa PCO_SensorInfo-rakenteen aiemmin luodulle muunnosobjektille

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pstrSensorInfo	PCO_SensorInfo*	Osoitin anturin tietorakenteeseen. Älä unohda asettaa wSize-parametria

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_SetPseudoLut

Kuvaus
Lataa juonen kolme pseudolut-väritaulukkoa

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
pseudo_lut	allekirjoittamaton merkki *	Osoitin pseudo lut -väriarvoihin (R,G,B-värit: 256 * 3 tavua tai 4 tavua)
inumcolors	int	Aseta joko 3 R,G,B:lle tai 4 R,G,B,A:lle

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_LoadPseudoLut

Kuvaus
Lataa pseudovärien hakutaulukon muunnettavaan objektiin. Tätä toimintoa voidaan käyttää joidenkin ennalta määritettyjen tai itse luotujen pseudohakutaulukoiden lataamiseen.

Prototyyppi

Parametri

Nimi Tyyppi Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
muoto	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenimi	hiiltyä*	Nimi file ladata

Palautusarvo

Nimi Tyyppi Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
muoto	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenimi	hiiltyä*	Nimi file ladata

PCO_Convert16TO8

Kuvaus
Muunna b16-kuvatiedot 8-bittisiksi tiedoiksi b8-muodossa (harmaasävy)

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
tila	int	Mode-parametri
icolmode	int	Väritilan parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
b16	sana*	Osoitin raakakuvaan
b8	tavu*	Osoitin muunnetuksi 8-bittiseksi mustavalkokuvaksi

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_Convert16TO24

Kuvaus
Muunna b16-kuvatiedot 24-bittisiksi tiedoiksi b24-muodossa (harmaasävy)

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
tila	int	Mode-parametri

Nimi	Tyyppi	Kuvaus
icolmode	int	Väritilan parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
b16	sana*	Osoitin raakakuvaan
b24	tavu*	Osoitin muunnetuksi 24-bittiseksi värikuvaksi

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_Convert16TOCOL

Kuvaus
Muunna kuvatiedot b16:ssa RGB-tiedoiksi b8:ssa (väri)

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
tila	int	Mode-parametri
icolmode	int	Väritilan parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
b16	sana*	Osoitin raakakuvaan
b8	tavu*	Osoitin muunnetuksi 24-bittiseksi värikuvaksi

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_Convert16TOPSEUDO

Kuvaus
Muunna kuvatiedot b16:ssa pseudoväritietoiksi b8:ssa (väri)

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
tila	int	Mode-parametri
icolmode	int	Väritilan parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
b16	sana*	Osoitin raakakuvaan
b8	tavu*	Osoitin muunnetuksi 24-bittiseksi pseudovärikuvaksi

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_Convert16TOCOL16

Kuvaus
Muunna kuvatiedot b16:ssa RGB-tiedoiksi b16:ssa (väri)

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
tila	int	Mode-parametri

Nimi	Tyyppi	Kuvaus
icolmode	int	Väritilan parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
b16 tuumaa	sana*	Osoitin raakakuvaan
b16out	sana*	Osoitin muunnetuksi 48-bittiseksi värikuvaksi

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_GetWhiteBalance

Kuvaus
Saa valkotasapainoiset arvot color_tempand tint -asetukselle

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
ph	KAHVA	Käsittele aiemmin luotua muunnosobjektia
värilämpötila	int*	int-osoitin saadaksesi lasketun värilämpötilan
sävy	int*	int-osoitin saadaksesi lasketun sävyn arvon
tila	int	Mode-parametri
leveys	int	Muunnettavan kuvan leveys
korkeus	int	Muunnettavan kuvan korkeus
gb12	SANA*	Osoitin raakakuvadatajonoon
x_min	int	Suorakulmio määrittääksesi laskennassa käytettävän kuvan alueen
y_min	int	Suorakulmio määrittääksesi laskennassa käytettävän kuvan alueen
x_max	int	Suorakulmio määrittääksesi laskennassa käytettävän kuvan alueen
y_max	int	Suorakulmio määrittääksesi laskennassa käytettävän kuvan alueen

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_GetMaxLimit

Kuvaus
GetMaxLimit saa RGB-arvot tietylle lämpötilalle ja sävylle. Maksimiarvo muunnosohjausikkunassa ei saa ylittää RGB-arvojen suurinta arvoa, esim. jos R on suurin arvo, maksimiarvo voi nousta, kunnes R-arvo saavuttaa bittiresoluution (4095). Saman ehdon on täytyttävä maksimiarvon alentamiseen, esim. jos B on pienin arvo, maksimiarvo voi laskea, kunnes B-arvo saavuttaa minimiarvon.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
r_max	kellua*	Osoitin kellukkeeseen, joka saa punaisen maksimiarvon
g_max	kellua*	Osoitin kellukkeeseen, joka saa vihreän maksimiarvon
b_max	kellua*	Osoitin kellukkeeseen, joka saa sinisen maksimiarvon
temp	kellua	Värilämpötila
sävy	kellua	Sävyasetus
output_bits	int	Muunnetun kuvan bittiresoluutio (yleensä 8)

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_GetColorValues

Kuvaus
Hakee värilämpötilan ja sävyn tietyille R,G,B max -arvoille.
GetColorValuesis käytetään vain pco.camware . Se laskee värilämpötilan ja sävyn vanhan värin lut Rmax, Gmax, Bmax arvojen perusteella. Laskettuja arvoja käytetään vanhojen b16- ja tif16-kuvien muuntamiseen uusilla muunnosrutiineilla.

Prototyyppi

Parametri

Nimi	Tyyppi	Kuvaus
pfColorTemp	kellua*	Osoita kelluvaa värilämpötilan vastaanottamista varten
pfColorTemp	kellua*	Osoitin kellukkeeseen värisävyn vastaanottamiseksi
iRedMax	int	Kokonaisluku määrittää punaisen nykyisen maksimiarvon
iGreenMax	int	Kokonaisluku asettaa vihreän nykyisen enimmäisarvon.
iBlueMax	int	Kokonaisluku määrittää sinisen nykyisen maksimiarvon

Palautusarvo

Nimi	Tyyppi	Kuvaus
Virheviesti	int	0 onnistuessa, Virhekoodi muussa tapauksessa.

PCO_WhiteBalanceToDisplayStruct

Kuvaus
Laskee valkotasapainon ja asettaa arvot strDisplaystruct-rakenteeseen säilyttäen samalla rajat. Hakee struct str Displayn muunnoskahvasta sisäisesti

Prototyyppi