EXCELITAS TECHNOLOGIES pco.convert Microscoopcamera Gebruikershandleiding

Algemene informatie
De pco.convert biedt verschillende functies voor kleur- en pseudokleurconversie. Het is belangrijk om de instructies in de gebruikershandleiding te volgen voor optimale prestaties.

Converteer API-functiebeschrijving
De Convert API biedt een set functies voor het manipuleren van kleur- en afbeeldingsgegevens. Hieronder staan enkele belangrijke functies:

- PCO_ConvertCreate: Maak een nieuw conversie-exemplaar.
- PCO_ConverterenVerwijderen: Een conversie-instantie verwijderen.
- PCO_ConvertGet: Conversie-instellingen ophalen.

Kleur- en pseudokleurconversie
De pco.convert ondersteunt zowel zwart-witconversie als kleurconversie. Volg de specifieke instructies in de handleiding voor elk type conversie.

Veelgestelde vragen

V: Hoe voer ik een kleurconversie uit met pco.convert?
- A: Om een kleurconversie uit te voeren, gebruikt u de functie PCO_ConvertGet met de juiste parameters zoals beschreven in de gebruikershandleiding.
V: Kan ik een conversie-instantie verwijderen?
- A: Ja, u kunt een conversie-instantie verwijderen met de functie PCO_ConvertDelete.

gebruikershandleiding
pco.convert

Excelitas PCO GmbH vraagt u de instructies in dit document aandachtig te lezen en op te volgen. Voor vragen of opmerkingen kunt u altijd contact met ons opnemen.

telefoon: + 49 (0) 9441 2005 50

fax: + 49 (0) 9441 2005 20
postadres: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Duitsland
e-mailadres: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
gebruikershandleiding 1.52.0
Uitgebracht mei 2024
©Copyright Excelitas PCO GmbH

Dit werk valt onder de Creative Commons Naamsvermelding-GeenAfgeleideWerken 4.0 Internationaal-licentie. Naar view een kopie van deze licentie, bezoek http://creativecommons.org/licenses/by-nd/4.0/ of stuur een brief naar Creative Commons, Postbus 1866, Mountain View, CA 94042, VS.

Algemeen

Deze convert SDK-beschrijving kan worden gebruikt om de PCO convert-routines te implementeren in propriëtaire applicaties, die worden gebruikt om PCO-camera's te besturen. Het is verboden om de convert-routines te gebruiken met camera's van derden.
De pco.convert sdk bestaat uit twee delen: De LUT-conversiefuncties pco.conv.dll en de dialoogfuncties pco_cdlg.dll .
De conversiefuncties worden gebruikt om datagebieden, z/w en kleur, met een resolutie van meer dan 8 bit per pixel te converteren naar z/w datagebieden met een resolutie van 8 bit per pixel of kleur datagebieden met een resolutie van 24 (32) bit per pixel. De DLL bevat ook functies om de verschillende converteerobjecten te maken en te vullen.
Het tweede deel van de API bevat de dialoogfuncties. De dialogen zijn eenvoudige GUI-dialogen waarmee de gebruiker de parameters van de convert-objecten kan instellen. De dialoogfuncties zijn opgenomen in de pco_cdlg.dll en zijn gebaseerd op enkele functies van pco.conv.dll.
In de pco.sdk voor pco-camera's bestaan er twee samples, die gebruik maken van de convert sdk. Een daarvan is de Test_cvDlg sample en de andere is de sc2_demo. Kijk eens naar die samples om de convert sdk-functies in actie te 'zien'.

Zwart-wit en pseudo-kleurconversie
Het conversiealgoritme dat in de z/w-functie wordt gebruikt, is gebaseerd op de volgende eenvoudige routine

waar

pos is de tellervariabele
dataout is het uitvoergegevensgebied
datain is het invoergegevensgebied

lutbw is een datagebied van grootte 2n dat de LUT bevat, waarbij n = resolutie van het invoergebied in bits per pixel

In de pseudocolor-functie is de basisroutine voor het converteren naar een RGB-gegevensgebied:

waar

pos is de invoertellervariabele
pout is de output-tellervariabele

dataout is het uitvoergegevensgebied
datain is het invoergegevensgebied
lutbw is een datagebied van grootte 2n dat de LUT bevat, waarbij n = resolutie van het invoergebied in bits per pixel

lutred, lutgreen, lutblue zijn datagebieden van grootte 2n die de LUT bevatten, waarbij n = resolutie van het uitvoergebied in bits per pixel.

Kleurconversie

CCD-kleurensensoren die worden gebruikt in PCO-kleurencamera's hebben filters voor de kleuren rood, groen en blauw. Elke pixel heeft één type filter, dus oorspronkelijk krijgt u niet de volledige kleurinformatie voor elke pixel. In plaats daarvan levert elke pixel een waarde met een dynamisch bereik van 12 bits voor de kleur die het filter passeert.

Alle kleurencamera's bij PCO werken met het Bayer-filter DE mozaïek. Het kleurenfilterpatroon van die kleurenbeeldsensoren kan worden teruggebracht tot een 2×2 matrix. De beeldsensor zelf kan worden gezien als een matrix van die 2×2 matrixen.
Stel dat dit kleurenpatroon

De kleur zelf is slechts een interpretatie van de matrix. Deze interpretatie wordt gedaan door een zogenaamd demosaicing-algoritme. De pco_conv.dll werkt met een speciale propriëtaire methode.

Converteer API-functiebeschrijving

PCO_ConverterenCreëren

Beschrijving
Maakt een nieuw convert-object op basis van de PCO_SensorInfo-structuur. De gemaakte convert-handle wordt gebruikt tijdens de conversie. Roep PCO_ConvertDelete aan voordat de toepassing wordt afgesloten en de convert-dll wordt verwijderd.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HENDEL*	Wijzer naar een handvat dat het gemaakte convert-object zal ontvangen
strSensor	PCO_SensorInfo*	Pointer naar een sensorinformatiestructuur. Vergeet niet de wSize-parameter in te stellen.
iConvertType	int	Variabele om het conversietype te bepalen, z/w, kleur, pseudokleur of kleur 16

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_ConverterenVerwijderen

Beschrijving
Verwijdert een eerder gemaakt convert-object. Het is verplicht om deze functie aan te roepen voordat de toepassing wordt gesloten.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 indien succesvol, anders foutcode.

PCO_ConvertGet

Beschrijving
Haalt alle waarden op van een eerder gemaakt convert-object.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrConvert	PCO_Converteren*	Aanwijzer naar een pco convert-structuur

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 indien succesvol, anders foutcode.

PCO_ConvertSet

Beschrijving
Stelt de benodigde waarden in voor een eerder gemaakt convert-object.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrConvert	PCO_Converteren*	Aanwijzer naar een pco convert-structuur

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_ConvertGetDisplay

Beschrijving
Haalt de PCO_Display-structuur op

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrWeergave	PCO_Weergave*	Aanwijzer naar een pco-weergavestructuur

Retourwaarde

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrWeergave	PCO_Weergave*	Aanwijzer naar een pco-weergavestructuur

PCO_ConvertSetWeergave

Beschrijving
Stelt de PCO_Display-structuur in

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrWeergave	PCO_Weergave*	Aanwijzer naar een pco-weergavestructuur

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_ConvertSetBayer

Beschrijving
Stelt de Bayer-structuurwaarden in van een eerder gemaakt convert-object. Gebruik deze functies om de Bayer-patroonparameters te wijzigen.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrBayer	PCO_Bayer*	Wijzer naar een PCO Bayer-structuur

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_ConvertSetFilter

Beschrijving
Hiermee stelt u de filterstructuurwaarden in van een eerder gemaakt convert-object.

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
voorfilter	PCO_Filter*	Aanwijzer naar een pco-filterstructuur

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_ConvertSetSensorInfo

Beschrijving
Stelt de PCO_SensorInfo-structuur in voor een eerder gemaakt convert-object

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pstrSensorInfo	PCO_SensorInfo*	Pointer naar een sensorinformatiestructuur. Vergeet niet de wSize-parameter in te stellen

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_SetPseudoLut

Beschrijving
Laad de drie pseudolut-kleurentabellen van het plot

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
pseudo_lut	Ongetekend char *	Aanwijzer naar pseudo-lut-kleurwaarden (R,G,B-kleuren: 256 * 3 bytes of 4 bytes)
inumkleuren	int	Stel in op 3 voor R,G,B of 4 voor R,G,B,A

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_LoadPseudoLut

Beschrijving
Laadt een pseudo-kleuropzoektabel naar het convert-object. Deze functie kan worden gebruikt om enkele van de vooraf gedefinieerde of zelf gemaakte pseudo-opzoektabellen te laden.

Prototype

Parameter

Naam Typebeschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
formaat	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenaam	teken*	Naam van de file laden

Retourwaarde

Naam Typebeschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
formaat	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenaam	teken*	Naam van de file laden

PCO_Convert16TO8

Beschrijving
Converteer afbeeldingsgegevens in b16 naar 8-bitsgegevens in b8 (grijswaarden)

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
modus	int	Modusparameter
icoonmode	int	Kleurmodusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
b16	woord*	Wijzer naar de ruwe afbeelding
b8	byte*	Aanwijzer naar geconverteerde 8-bits z/w-afbeelding

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_Convert16TO24

Beschrijving
Converteer afbeeldingsgegevens in b16 naar 24-bitsgegevens in b24 (grijswaarden)

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
modus	int	Modusparameter

Naam	Type	Beschrijving
icoonmode	int	Kleurmodusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
b16	woord*	Wijzer naar de ruwe afbeelding
b24	byte*	Aanwijzer naar geconverteerde 24-bits kleurenafbeelding

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_Convert16TOCOL

Beschrijving
Converteer afbeeldingsgegevens in b16 naar RGB-gegevens in b8 (kleur)

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
modus	int	Modusparameter
icoonmode	int	Kleurmodusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
b16	woord*	Wijzer naar de ruwe afbeelding
b8	byte*	Aanwijzer naar geconverteerde 24-bits kleurenafbeelding

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_Convert16TOPSEUDO

Beschrijving
Converteer afbeeldingsgegevens in b16 naar pseudo-kleurgegevens in b8 (kleur)

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
modus	int	Modusparameter
icoonmode	int	Kleurmodusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
b16	woord*	Wijzer naar de ruwe afbeelding
b8	byte*	Aanwijzer naar geconverteerde 24-bits pseudo-kleurenafbeelding

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_Convert16TOCOL16

Beschrijving
Converteer afbeeldingsgegevens in b16 naar RGB-gegevens in b16 (kleur)

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
modus	int	Modusparameter

Naam	Type	Beschrijving
icoonmode	int	Kleurmodusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
b16in	woord*	Wijzer naar de ruwe afbeelding
b16uit	woord*	Aanwijzer naar geconverteerde 48-bits kleurenafbeelding

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_GetWhiteBalance

Beschrijving
Haalt witbalanswaarden op voor color_tem en tint

Prototype

Parameter

Naam	Type	Beschrijving
ph	HANDVAT	Verwerken naar een eerder gemaakt conversieobject
kleur_temp	int*	int-pointer om de berekende kleurtemperatuur te verkrijgen
tint	int*	int-pointer om de berekende tintwaarde te verkrijgen
modus	int	Modusparameter
breedte	int	Breedte van de afbeelding die moet worden geconverteerd
hoogte	int	Hoogte van de afbeelding die moet worden geconverteerd
gb12	WOORD*	Aanwijzer naar ruwe afbeeldingsgegevensarray
x_min	int	Rechthoek om het beeldgebied in te stellen dat voor de berekening moet worden gebruikt
j_min	int	Rechthoek om het beeldgebied in te stellen dat voor de berekening moet worden gebruikt
x_max	int	Rechthoek om het beeldgebied in te stellen dat voor de berekening moet worden gebruikt
y_max	int	Rechthoek om het beeldgebied in te stellen dat voor de berekening moet worden gebruikt

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_GetMaxLimit

Beschrijving
GetMaxLimit haalt de RGB-waarden op voor een bepaalde temperatuur en tint. De maximale waarde in het dialoogvenster Convert Control mag de grootste waarde van de RGB-waarden niet overschrijden, bijvoorbeeld in het geval dat R de grootste waarde is, kan de maximale waarde toenemen totdat de R-waarde de bitresolutie (4095) bereikt. Dezelfde voorwaarde moet worden vervuld voor het verlagen van de maximale waarde, bijvoorbeeld in het geval dat B de laagste waarde is, kan de maximale waarde afnemen totdat de B-waarde de minimale waarde bereikt.

Prototype

Parameter

Naam	Type	Beschrijving
r_max	vlot*	Wijzer naar een vlotter die de maximale rode waarde ontvangt
g_max	vlot*	Wijzer naar een vlotter die de maximale groene waarde ontvangt
b_max	vlot*	Wijzer naar een vlotter die de maximale blauwe waarde ontvangt
temperatuur	vlot	Kleurtemperatuur
tint	vlot	Tintinstelling
uitvoerbits	int	Bitresolutie van de geconverteerde afbeelding (meestal 8)

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_Kleurwaarden ophalen

Beschrijving
Geeft de kleurtemperatuur en tint weer voor de opgegeven maximale R,G,B-waarden.
GetColorValue wordt alleen gebruikt in pco.camware . Het berekent de kleurtemperatuur en tint op basis van de Rmax,Gmax,Bmax waarden van de oude kleur lut. De berekende waarden worden gebruikt om oude b16 en tif16 afbeeldingen te converteren met de nieuwe convert routines.

Prototype

Parameter

Naam	Type	Beschrijving
pfKleurTemp	vlot*	Wijzer naar een vlotter voor het ontvangen van de kleurtemperatuur
pfKleurTemp	vlot*	Wijzer naar een vlotter voor het ontvangen van de kleurtint
iRedMax	int	Geheel getal om de huidige maximale waarde voor rood in te stellen
iGreenMax	int	Geheel getal om de huidige maximale waarde voor groen in te stellen.
iBlueMax	int	Geheel getal om de huidige maximale waarde voor blauw in te stellen

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_WitbalansToDisplayStruct

Beschrijving
Berekent de witbalans en stelt de waarden in op de strDisplaystruct terwijl de limieten behouden blijven. Haalt de struct str Display op van de convert Handle internally

Prototype

Parameter

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

PCO_GetVersionInfoPCO_CONV

Beschrijving
Geeft versie-informatie over de dll.

Prototype

Parameter

Retourwaarde

Naam	Type	Beschrijving
Foutbericht	int	0 in geval van succes, anders Errorcode.

Typische implementatie

Deze typische stapsgewijze implementatie toont de basishandelingen

Verklaringen
Stel alle buffergrootteparameters in op de verwachte waarden:
Stel de sensorinfoparameters in en maak het conversieobject aan
Optioneel een conversiedialoog openen
Stel de minimum- en maximumwaarde in op het gewenste bereik en stel ze in op het conversieobject
Voer de conversie uit en stel de gegevens in op het dialoogvenster als het dialoogvenster open is
Sluit het optioneel geopende conversiedialoogvenster
Sluit het convert-object: