EXCELITAS TECHNOLOGIES pco.convert Mikroskopkamera
Spesifikasjoner
- Produktnavn: pco. konvertere
- Versjon: 1.52.0
- Lisens: Creative Commons Attribution-NoDerivatives 4.0International License
- Produsent: Excelitas PCO GmbH
- Adresse: Donaupark 11, 93309 Kelheim, Tyskland
- Kontakt: +49 (0) 9441 2005 50
- E-post: pco@excelitas.com
- Webnettsted: www.excelitas.com/product-category/pco
Produktbruksinstruksjoner
Generell informasjon
Pco.convert tilbyr ulike funksjoner for farge- og pseudofargekonvertering. Det er viktig å følge instruksjonene i brukerhåndboken for optimal ytelse.
Konverter API-funksjonsbeskrivelse
Convert API gir et sett med funksjoner for å manipulere farge- og bildedata. Nedenfor er noen nøkkelfunksjoner:
-
- PCO_ConvertCreate: Opprett en ny konverteringsforekomst.
- PCO_ConvertDelete: Slett en konverteringsforekomst.
- PCO_ConvertGet: Få konverteringsinnstillinger.
Farge- og pseudofargekonvertering
Pco.convert støtter både svart-hvitt-konvertering så vel som fargekonvertering. Følg de spesifikke instruksjonene i håndboken for hver type konvertering.
FAQ
- Spørsmål: Hvordan utfører jeg en fargekonvertering ved å bruke pco.convert?
- A: For å utføre en fargekonvertering, bruk PCO_ConvertGet-funksjonen med de riktige parameterne som beskrevet i brukerhåndboken.
- Spørsmål: Kan jeg slette en konverteringsforekomst?
- A: Ja, du kan slette en konverteringsforekomst ved å bruke PCO_ConvertDelete-funksjonen.
brukerhåndbok
pco.convert
Excelitas PCO GmbH ber deg om å lese og følge instruksjonene i dette dokumentet nøye. For spørsmål eller kommentarer, vennligst kontakt oss når som helst.
- telefon: + 49 (0) 9441 2005 50
- fax: + 49 (0) 9441 2005 20
- postadresse: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Tyskland
- e-post: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
brukerhåndbok 1.52.0
Utgitt mai 2024
©Copyright Excelitas PCO GmbH
Dette verket er lisensiert under Creative Commons Attribution-NoDerivatives 4.0 International License. Til view en kopi av denne lisensen, besøk http://creativecommons.org/licenses/by-nd/4.0/ eller send et brev til Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
General
- Denne konverterings-SDK-beskrivelsen kan brukes til å implementere PCO-konverteringsrutinene i proprietære applikasjoner, som brukes til å kontrollere PCO-kameraer. Det er forbudt å bruke konverteringsrutinene med tredjepartskameraer.
- De pco.convert sdk består av to deler: LUT-konverteringsfunksjonene pco.conv.dll og dialogfunksjonene pco_cdlg.dll .
Konverteringsfunksjonene brukes til å konvertere dataområder, svart/hvitt og farger, med en oppløsning på mer enn 8 bit per piksel til enten svart/hvitt dataområder med en oppløsning på 8 bit per piksel eller fargedataområder med en oppløsning på 24 (32) bit per piksel. DLL-en inkluderer også funksjoner for å lage og fylle de forskjellige konvertereobjektene. - Den andre delen av API-en inneholder dialogfunksjonene. Dialogene er enkle GUI-dialoger som gjør det mulig for brukeren å angi parameterne til konvertereobjektene. Dialogfunksjonene er inkludert i pco_cdlg.dll og er basert på noen funksjoner i pco.conv.dll.
- I pco.sdk for PCO-kameraer finnes det to samples, som gjør bruk av convert sdk. Den ene er Test_cvDlg-eneample og den andre er sc2_demoen. Vennligst ta en titt på disse samples for å "se" convert sdk-funksjonene i aksjon.
Konvertering av svart/hvitt og pseudofarge
Konverteringsalgoritmen som brukes i s/h-funksjonen er basert på følgende enkle rutine
hvor
- pos er tellervariabelen
- dataout er utdataområdet
- datain er inndataområdet
- lutbw er et dataområde av størrelse 2n som inneholder LUT, der n = oppløsning av inngangsområdet i biter per piksel
I pseudofargefunksjonen er den grunnleggende rutinen for å konvertere til et RGB-dataområde:
hvor
- pos er inndatatellervariabelen
- pout er utgangstellervariabelen
- dataout er utdataområdet
- datain er inndataområdet
- lutbw er et dataområde av størrelse 2n som inneholder LUT, der n = oppløsning av inngangsområdet i biter per piksel
- lutred, lutgreen, lutblue er dataområder av størrelse 2n som inneholder LUT, hvor n = oppløsning av utdataområdet i bit per piksel.
Fargekonvertering
- CCD-fargesensorer som brukes i PCO-fargekameraer har filtre for fargene rød, grønn og blå. Hver piksel har en type filter, dermed får du opprinnelig ikke fullfargeinformasjon for hver piksel. Hver piksel leverer snarere en verdi med et dynamisk område på 12 biter for fargen som passerer filteret.
- Alle fargekameraer hos PCO fungerer med Bayer-filter DE mosaikk. Fargefiltermønsteret til disse fargebildesensorene kan reduseres til en 2×2-matrise. Selve bildesensoren kan sees på som en matrise av disse 2×2-matrisene.
- Anta dette fargemønsteret
Fargen i seg selv er kun en tolkning av matrisen. Denne tolkningen vil bli gjort ved hjelp av en såkalt demosaicking-algoritme. Pco_conv.dll fungerer med en spesiell proprietær metode.
Konverter API-funksjonsbeskrivelse
PCO_ConvertCreate
Beskrivelse
Oppretter et nytt konverteringsobjekt basert på PCO_SensorInfo-strukturen. Det opprettede konverteringshåndtaket vil bli brukt under konverteringen. Ring PCO_ConvertDelete før programmet avsluttes og laster av konverterings-dll.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK* | Peker til et håndtak som vil motta det opprettede konverteringsobjektet |
| strSensor | PCO_SensorInfo* | Peker til en sensorinformasjonsstruktur. Ikke glem å stille inn parameteren wSize. |
| iConvertType | int | Variabel for å bestemme konverteringstypen, enten s/h, farge, pseudofarge eller farge 16 |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertDelete
Beskrivelse
Sletter et tidligere opprettet konverteringsobjekt. Det er obligatorisk å kalle opp denne funksjonen før du lukker applikasjonen.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertGet
Beskrivelse
Henter alle verdiene til et tidligere opprettet konverteringsobjekt.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstrKonverter | PCO_Convert* | Peker til en PCO-konverteringsstruktur |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertSet
Beskrivelse
Angir nødvendige verdier for et tidligere opprettet konverteringsobjekt.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstrKonverter | PCO_Convert* | Peker til en PCO-konverteringsstruktur |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertGetDisplay
Beskrivelse
Henter PCO_Display-strukturen
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstr Display | PCO_Display* | Peker til en pco-skjermstruktur |
Returverdi
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstr Display | PCO_Display* | Peker til en pco-skjermstruktur |
PCO_ConvertSetDisplay
Beskrivelse
Setter PCO_Display-strukturen
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstr Display | PCO_Display* | Peker til en pco-skjermstruktur |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertSetBayer
Beskrivelse
Angir Bayer-strukturverdiene til et tidligere opprettet konverteringsobjekt. Bruk denne funksjonen til å endre Bayer-mønsterparametrene.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstrBayer | PCO_Bayer* | Peker til en PCO Bayer-struktur |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertSetFilter
Beskrivelse
Angir filterstrukturverdiene til et tidligere opprettet konverteringsobjekt.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| forfilter | PCO_Filter* | Peker til en pco-filterstruktur |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_ConvertSetSensorInfo
Beskrivelse
Angir PCO_SensorInfo-strukturen for et tidligere opprettet konverteringsobjekt
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pstrSensorInfo | PCO_SensorInfo* | Peker til en sensorinformasjonsstruktur. Ikke glem å stille inn parameteren wSize |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_SetPseudoLut
Beskrivelse
Last inn de tre pseudolut-fargetabellene for plottet
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| pseudo_lut | usignert røye * | Peker til pseudo lut fargeverdier (R,G,B farger: 256 * 3 byte, eller 4 byte) |
| inumcolors | int | Sett til enten 3 for R,G,B eller 4 for R,G,B,A |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_LoadPseudoLut
Beskrivelse
Laster en pseudofargeoppslagstabell til det konverterte objektet. Denne funksjonen kan brukes til å laste noen av de forhåndsdefinerte eller selvlagde pseudo-oppslagstabellene.
Prototype
Parameter
| Navn Type Beskrivelse | ||||||
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenavn | røye* | Navnet på file å laste | ||||
Returverdi
| Navn Type Beskrivelse | ||||||
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenavn | røye* | Navnet på file å laste | ||||
PCO_Convert16TO8
Beskrivelse
Konverter bildedata i b16 til 8bit data i b8 (gråtoner)
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| modus | int | Modusparameter |
| icolmode | int | Fargemodusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| b16 | ord* | Peker til råbildet |
| b8 | byte* | Peker til konvertert 8bit s/h-bilde |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_Convert16TO24
Beskrivelse
Konverter bildedata i b16 til 24bit data i b24 (gråtoner)
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| modus | int | Modusparameter |
| Navn | Type | Beskrivelse |
| icolmode | int | Fargemodusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| b16 | ord* | Peker til råbildet |
| b24 | byte* | Peker til konvertert 24-bits fargebilde |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_Convert16TOCOL
Beskrivelse
Konverter bildedata i b16 til RGB-data i b8 (farge)
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| modus | int | Modusparameter |
| icolmode | int | Fargemodusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| b16 | ord* | Peker til råbildet |
| b8 | byte* | Peker til konvertert 24-bits fargebilde |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_Convert16TOPSEUDO
Beskrivelse
Konverter bildedata i b16 til pseudofargedata i b8 (farge)
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| modus | int | Modusparameter |
| icolmode | int | Fargemodusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| b16 | ord* | Peker til råbildet |
| b8 | byte* | Peker til konvertert 24-bits pseudofargebilde |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_Convert16TOCOL16
Beskrivelse
Konverter bildedata i b16 til RGB-data i b16 (farge)
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| modus | int | Modusparameter |
| Navn | Type | Beskrivelse |
| icolmode | int | Fargemodusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| b16in | ord* | Peker til råbildet |
| b16 ut | ord* | Peker til konvertert 48-bits fargebilde |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_GetWhiteBalance
Beskrivelse
Får hvitbalanserte verdier for color_tempand tint
Prototype
Parameter
| Navn | Type | Beskrivelse |
| ph | HÅNDTAK | Håndter til et tidligere opprettet konverteringsobjekt |
| farge_temp | int* | int-peker for å få den beregnede fargetemperaturen |
| fargetone | int* | int-peker for å få den beregnede fargetoneverdien |
| modus | int | Modusparameter |
| bredde | int | Bredden på bildet som skal konverteres |
| høyde | int | Høyden på bildet som skal konverteres |
| gb12 | ORD* | Peker til råbildedataarray |
| x_min | int | Rektangel for å angi bildeområdet som skal brukes til beregning |
| å_min | int | Rektangel for å angi bildeområdet som skal brukes til beregning |
| x_max | int | Rektangel for å angi bildeområdet som skal brukes til beregning |
| y_max | int | Rektangel for å angi bildeområdet som skal brukes til beregning |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_GetMaxLimit
Beskrivelse
GetMaxLimit får RGB-verdiene for en gitt temperatur og fargetone. Maksverdien i konverteringskontrolldialogen må ikke overstige den største verdien av RGB-verdiene, f.eks. hvis R er den største verdien, kan maksverdien øke til R-verdien treffer bitoppløsningen (4095). Samme betingelse må være oppfylt for å redusere maksverdien, f.eks. hvis B er den laveste verdien, kan maksverdien reduseres til B-verdien treffer min-verdien.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| r_max | flyte* | Peker til en flottør som mottar den maksimale røde verdien |
| g_maks | flyte* | Peker til en flottør som mottar den maksimale grønne verdien |
| b_max | flyte* | Peker til en flottør som mottar den maksimale blå verdien |
| temp | flyte | Fargetemperatur |
| fargetone | flyte | Fargeinnstilling |
| output_bits | int | Bitoppløsning for det konverterte bildet (vanligvis 8) |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_GetColorValues
Beskrivelse
Får fargetemperatur og fargetone for gitte R,G,B max verdier.
GetColorValuesis brukes kun i pco.camware . Den beregner fargetemperaturen og fargetonen basert på Rmax,Gmax,Bmax-verdiene til den gamle fargen lut. De beregnede verdiene brukes til å konvertere gamle b16- og tif16-bilder med de nye konverteringsrutinene.
Prototype
Parameter
| Navn | Type | Beskrivelse |
| pfColorTemp | flyte* | Peker til en flottør for å motta fargetemperaturen |
| pfColorTemp | flyte* | Peker til en flottør for å motta fargetonen |
| iRedMax | int | Heltall for å angi gjeldende maksverdi for rødt |
| iGreenMax | int | Heltall for å angi gjeldende maksverdi for grønn. |
| iBlueMax | int | Heltall for å angi gjeldende maksverdi for blått |
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_WhiteBalanceToDisplayStruct
Beskrivelse
Beregner hvitbalansen og setter verdiene til strDisplaystruct mens grensene opprettholdes. Henter struct str Display fra konverterhåndtaket internt
Prototype
Parameter
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
PCO_GetVersionInfoPCO_CONV
Beskrivelse
Returnerer versjonsinformasjon om dll-en.
Prototype
Parameter
Returverdi
| Navn | Type | Beskrivelse |
| Feilmelding | int | 0 ved suksess, ellers feilkode. |
Typisk gjennomføring
Denne typiske trinnvise implementeringen viser den grunnleggende håndteringen
- Erklæringer
- Sett alle buffer 'størrelse' parametere til de forventede verdiene:
- Still inn sensorinfoparameterne og lag konverteringsobjektet
- Åpne eventuelt en konverteringsdialog
- Sett min og maks verdi til ønsket område og sett dem til konverteringsobjektet
- Utfør konverteringen og sett dataene til dialogen hvis dialogboksen er åpen
- Lukk den valgfritt åpnede konverteringsdialogen
- Lukk konverteringsobjektet:
Se Test_cvDlg sample i pco.sdk sample mappe. Fra og med v1.20 har området for den negative fargetoneverdien blitt doblet.
- postadresse: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Tyskland
- telefon: +49 (0) 9441 2005 0
- e-post: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumenter / Ressurser
 |
EXCELITAS TECHNOLOGIES pco.convert Mikroskopkamera [pdfBrukerhåndbok pco.convert Mikroskopkamera, pco.convert, Mikroskopkamera, Kamera |
