Manuali i përdorimit të kamerës së mikroskopit EXCELITAS TECHNOLOGIES pco.convert

Informacione të Përgjithshme
Pco.convert ofron funksione të ndryshme për konvertimin e ngjyrave dhe pseudo ngjyrave. Është e rëndësishme të ndiqni udhëzimet e dhëna në manualin e përdorimit për performancë optimale.

Konvertoni përshkrimin e funksionit API
Convert API ofron një sërë funksionesh për manipulimin e të dhënave të ngjyrave dhe imazheve. Më poshtë janë disa funksione kryesore:

- PCO_ConvertCreate: Krijo një shembull të ri konvertimi.
- PCO_ConvertDelete: Fshi një shembull konvertimi.
- PCO_ConvertGet: Merrni cilësimet e konvertimit.

Konvertimi i ngjyrave dhe pseudo ngjyrave
Pco.convert mbështet si konvertimin bardh e zi, ashtu edhe konvertimin e ngjyrave. Ndiqni udhëzimet specifike të dhëna në manual për çdo lloj konvertimi.

FAQ

Pyetje: Si mund të kryej një konvertim ngjyrash duke përdorur pco.convert?
- Përgjigje: Për të kryer një konvertim ngjyrash, përdorni funksionin PCO_ConvertGet me parametrat e duhur siç përshkruhet në manualin e përdoruesit.
Pyetje: A mund të fshij një shembull konvertimi?
- Përgjigje: Po, mund të fshini një shembull konvertimi duke përdorur funksionin PCO_ConvertDelete.

manual përdorimi
pco.konvertoj

Excelitas PCO GmbH ju kërkon të lexoni dhe ndiqni me kujdes udhëzimet në këtë dokument. Për çdo pyetje apo koment, ju lutemi mos ngurroni të na kontaktoni në çdo kohë.

telefonit: + 49 (0) 9441 2005 50

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

pco.konvertoj
manuali i përdorimit 1.52.0
Lëshuar në maj 2024
©E drejta e autorit Excelitas PCO GmbH

Kjo punë është e licencuar sipas licencës ndërkombëtare Creative Commons Attribution-NoDerivatives 4.0. për të view një kopje të kësaj licence, vizitoni http://creativecommons.org/licenses/by-nd/4.0/ ose dërgoni një letër në Creative Commons, PO Box 1866, Mountain View, CA 94042, SHBA.

Gjeneral

Ky përshkrim i konvertimit SDK mund të përdoret për të zbatuar rutinat e konvertimit PCO në aplikacione të pronarit, të cilat përdoren për të kontrolluar kamerat PCO. Ndalohet përdorimi i rutinave të konvertimit me kamera të palëve të treta.
Të pco.konvertoj sdk përbëhet nga dy pjesë: Funksionet e konvertimit LUT pco.conv.dll dhe funksionet e dialogut pco_cdlg.dll .
Funksionet e konvertimit përdoren për konvertimin e zonave të të dhënave, b/w dhe ngjyra, me një rezolucion prej më shumë se 8 bit për pixel ose në zona të të dhënave b/w me një rezolucion prej 8 bit për pixel ose zona të të dhënave me ngjyra me një rezolucion prej 24 (32) bit për pixel. DLL gjithashtu përfshin funksione për të krijuar dhe plotësuar objekte të ndryshme të konvertimit.
Pjesa e dytë e API përmban funksionet e dialogut. Dialogët janë dialogë të thjeshtë GUI që i mundësojnë përdoruesit të vendosë parametrat e objekteve të konvertimit. Funksionet e dialogut përfshihen në pco_cdlg.dll dhe bazohen në disa funksione të pco.conv.dll.
Në pco.sdk për kamerat pco ekzistojnë dy samples, të cilat përdorin konvertimin sdk. Njëra është Test_cvDlg sample dhe tjetra është sc2_demo. Ju lutemi hidhini një sy atyre samples në mënyrë që të 'shihni' funksionet e konvertimit sdk në veprim.

B/W dhe konvertimi pseudo i ngjyrave
Algoritmi i konvertimit i përdorur në funksionin b/w bazohet në rutinën e thjeshtë të mëposhtme

pos është variabli numërues
dataout është zona e të dhënave dalëse
datain është zona e të dhënave hyrëse

lutbw është një zonë e të dhënave me madhësi 2n që përmban LUT, ku n = rezolucioni i zonës hyrëse në bit për pixel

Në funksionin pseudongjyrësh, rutina bazë për t'u kthyer në një zonë të dhënash RGB është:

pos është ndryshorja e numëruesit të hyrjes
pout është ndryshorja e numëruesit të daljes

dataout është zona e të dhënave dalëse
datain është zona e të dhënave hyrëse
lutbw është një zonë e të dhënave me madhësi 2n që përmban LUT, ku n = rezolucioni i zonës hyrëse në bit për pixel

lutred, lutgreen, lutblue janë zona të dhënash me madhësi 2n që përmbajnë LUT, ku n = rezolucioni i zonës së daljes në bit për pixel.

Konvertimi i ngjyrave

Sensorët e ngjyrave CCD të përdorur në kamerat me ngjyra PCO kanë filtra për ngjyrat e kuqe, jeshile dhe blu. Çdo piksel ka një lloj filtri, kështu që fillimisht nuk merrni informacione të plota me ngjyra për çdo piksel. Përkundrazi, çdo piksel jep një vlerë me një gamë dinamike prej 12 bitësh për ngjyrën që kalon filtrin.

Të gjitha kamerat me ngjyra në PCO punojnë me mozaikimin e filtrit DE Bayer. Modeli i filtrit të ngjyrave të atyre sensorëve të imazhit me ngjyra mund të reduktohet në një matricë 2×2. Vetë sensori i imazhit mund të shihet si një matricë e atyre matricave 2×2.
Supozoni këtë model ngjyrash

Vetë ngjyra është vetëm një interpretim i matricës. Ky interpretim do të bëhet nga i ashtuquajturi algoritëm demosaicking. Pco_conv.dll punon me një metodë të veçantë të pronarit.

Konvertoni përshkrimin e funksionit API

PCO_ConvertCreate

Përshkrimi
Krijon një objekt të ri konvertimi bazuar në strukturën PCO_SensorInfo. Doreza e krijuar e konvertimit do të përdoret gjatë konvertimit. Ju lutemi telefononi PCO_ConvertDelete përpara se aplikacioni të dalë dhe të shkarkojë konvertimin dll.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	TRAJTO*	Tregoni në një dorezë e cila do të marrë objektin e krijuar të konvertimit
strSensor	PCO_SensorInfo*	Treguesi për një strukturë informacioni sensor. Ju lutemi mos harroni të vendosni parametrin wSize.
iConvertType	ndër	Ndryshore për të përcaktuar llojin e konvertimit, ose b/w, ngjyra, pseudo ngjyra ose ngjyra 16

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_ConvertDelete

Përshkrimi
Fshin një objekt konvertimi të krijuar më parë. Është e detyrueshme të telefononi këtë funksion përpara se të mbyllni aplikacionin.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kod gabimi ndryshe.

PCO_ConvertGet

Përshkrimi
Merr të gjitha vlerat e një objekti konvertimi të krijuar më parë.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrConvert	PCO_Convert*	Treguesi në një strukturë të konvertimit të pco

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kod gabimi ndryshe.

PCO_ConvertSet

Përshkrimi
Vendos vlerat e nevojshme për një objekt konvertimi të krijuar më parë.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrConvert	PCO_Convert*	Treguesi në një strukturë të konvertimit të pco

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_ConvertGetDisplay

Përshkrimi
Merr strukturën PCO_Display

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrDisplay	Ekrani_PCO*	Treguesi drejt një strukture ekrani pco

Vlera e kthimit

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrDisplay	Ekrani_PCO*	Treguesi drejt një strukture ekrani pco

PCO_ConvertSetDisplay

Përshkrimi
Vendos strukturën PCO_Display

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrDisplay	Ekrani_PCO*	Treguesi drejt një strukture ekrani pco

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_ConvertSetBayer

Përshkrimi
Vendos vlerat e strukturës Bayer të një objekti konvertimi të krijuar më parë. Përdorni këtë funksion për të ndryshuar parametrat e modelit Bayer.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrBayer	PCO_Bayer*	Tregoni në një strukturë PCO Bayer

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_ConvertSetFilter

Përshkrimi
Vendos vlerat e strukturës së filtrit të një objekti konvertimi të krijuar më parë.

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
parafiltër	PCO_Filter*	Tregoni në një strukturë filtri pco

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_ConvertSetSensorInfo

Përshkrimi
Vendos strukturën PCO_SensorInfo për një objekt konvertimi të krijuar më parë

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pstrSensorInfo	PCO_SensorInfo*	Treguesi për një strukturë informacioni sensor. Ju lutemi mos harroni të vendosni parametrin wSize

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_SetPseudoLut

Përshkrimi
Ngarkoni tre tabelat me ngjyra pseudolute të komplotit

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
pseudo_lut	qymyr i pa firmosur *	Treguesi në vlerat e ngjyrave pseudo lut (ngjyrat R, G, B: 256 * 3 byte ose 4 bytes)
inumcolors	ndër	Vendoseni ose në 3 për R, G, B ose 4 për R, G, B, A

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_LoadPseudoLut

Përshkrimi
Ngarkon një tabelë pseudo të kërkimit të ngjyrave në objektin e konvertimit. Ky funksion mund të përdoret për të ngarkuar disa nga tabelat pseudo kërkimore të paracaktuara ose të krijuara vetë.

Prototip

Parametri

Emri Përshkrimi i llojit
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
format	ndër	0	lt1, 1	lt2, 2	lt3, 3	lt4
fileemri	karake*	Emri i file për të ngarkuar

Vlera e kthimit

Emri Përshkrimi i llojit
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
format	ndër	0	lt1, 1	lt2, 2	lt3, 3	lt4
fileemri	karake*	Emri i file për të ngarkuar

PCO_Convert16TO8

Përshkrimi
Konvertoni të dhënat e figurës në b16 në të dhëna 8 bit në b8 (shkallë gri)

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
modaliteti	ndër	Parametri i modalitetit
icolmode	ndër	Parametri i modalitetit të ngjyrës
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
b16	fjale*	Tregoni në imazhin e papërpunuar
b8	byte*	Treguesi në imazhin 8bit b/w të konvertuar

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_Convert16TO24

Përshkrimi
Konvertoni të dhënat e figurës në b16 në të dhëna 24 bit në b24 (shkallë gri)

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
modaliteti	ndër	Parametri i modalitetit

Emri	Lloji	Përshkrimi
icolmode	ndër	Parametri i modalitetit të ngjyrës
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
b16	fjale*	Tregoni në imazhin e papërpunuar
b24	byte*	Treguesi në imazhin e konvertuar me ngjyra 24 bit

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_Convert16TOCOL

Përshkrimi
Konvertoni të dhënat e figurës në b16 në të dhëna RGB në b8 (ngjyra)

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
modaliteti	ndër	Parametri i modalitetit
icolmode	ndër	Parametri i modalitetit të ngjyrës
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
b16	fjale*	Tregoni në imazhin e papërpunuar
b8	byte*	Treguesi në imazhin e konvertuar me ngjyra 24 bit

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_Convert16TOPSEUDO

Përshkrimi
Konvertoni të dhënat e figurës në b16 në të dhëna pseudo ngjyrash në b8 (ngjyra)

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
modaliteti	ndër	Parametri i modalitetit
icolmode	ndër	Parametri i modalitetit të ngjyrës
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
b16	fjale*	Tregoni në imazhin e papërpunuar
b8	byte*	Treguesi në imazhin pseudo ngjyrash të konvertuar 24-bit

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_Convert16TOCOL16

Përshkrimi
Konvertoni të dhënat e figurës në b16 në të dhëna RGB në b16 (ngjyra)

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
modaliteti	ndër	Parametri i modalitetit

Emri	Lloji	Përshkrimi
icolmode	ndër	Parametri i modalitetit të ngjyrës
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
b16 in	fjale*	Tregoni në imazhin e papërpunuar
b16 jashtë	fjale*	Treguesi në imazhin e konvertuar me ngjyra 48 bit

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_GetWhiteBalance

Përshkrimi
Merr vlerat e bardha të balancuara për ngjyrën_tempand dhe nuancën

Prototip

Parametri

Emri	Lloji	Përshkrimi
ph	DREJTN	Trajto me një objekt konvertimi të krijuar më parë
ngjyra_temp	int*	int pointer për të marrë temperaturën e llogaritur të ngjyrës
nuancë	int*	int pointer për të marrë vlerën e llogaritur të nuancës
modaliteti	ndër	Parametri i modalitetit
gjerësia	ndër	Gjerësia e imazhit për t'u konvertuar
lartësia	ndër	Lartësia e figurës për t'u konvertuar
gb12	FJALË*	Treguesi te grupi i të dhënave të figurës së papërpunuar
x_min	ndër	Drejtkëndësh për të vendosur rajonin e imazhit që do të përdoret për llogaritje
y_min	ndër	Drejtkëndësh për të vendosur rajonin e imazhit që do të përdoret për llogaritje
x_max	ndër	Drejtkëndësh për të vendosur rajonin e imazhit që do të përdoret për llogaritje
y_max	ndër	Drejtkëndësh për të vendosur rajonin e imazhit që do të përdoret për llogaritje

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_GetMaxLimit

Përshkrimi
GetMaxLimit merr vlerat RGB për një temperaturë dhe nuancë të caktuar. Vlera maksimale brenda dialogut të kontrollit të konvertimit nuk duhet të kalojë vlerën më të madhe të vlerave RGB, p.sh. në rast se R është vlera më e madhe, vlera maksimale mund të rritet derisa vlera R të arrijë rezolucionin e bitit (4095). I njëjti kusht duhet të plotësohet për zvogëlimin e vlerës maksimale, p.sh. në rast se B është vlera më e ulët, vlera maksimale mund të ulet derisa vlera B të arrijë vlerën min.

Prototip

Parametri

Emri	Lloji	Përshkrimi
r_max	noton*	Tregoni në një lundrues që merr vlerën maksimale të kuqe
g_max	noton*	Tregoni në një float që merr vlerën maksimale të gjelbër
b_max	noton*	Tregoni në një lundrues që merr vlerën maksimale blu
temp	noton	Temperatura e ngjyrës
nuancë	noton	Vendosja e nuancës
output_bits	ndër	Rezolucioni bit i imazhit të konvertuar (zakonisht 8)

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_GetColorValues

Përshkrimi
Merr temperaturën dhe nuancën e ngjyrës për vlerat maksimale të dhëna R,G,B.
GetColorValuesis përdoret vetëm në pco.kamera . Llogarit temperaturën dhe nuancën e ngjyrës bazuar në vlerat Rmax, Gmax, Bmax të ngjyrës së vjetër lut. Vlerat e llogaritura përdoren për të konvertuar imazhet e vjetra b16 dhe tif16 me rutinat e reja të konvertimit.

Prototip

Parametri

Emri	Lloji	Përshkrimi
pfColorTemp	noton*	Tregoni në një notues për marrjen e temperaturës së ngjyrës
pfColorTemp	noton*	Tregoni në një notues për marrjen e nuancës së ngjyrës
iRedMax	ndër	Numër i plotë për të vendosur vlerën maksimale aktuale për të kuqe
iGreenMax	ndër	Numër i plotë për të vendosur vlerën aktuale maksimale për të gjelbër.
iBlueMax	ndër	Numër i plotë për të vendosur vlerën aktuale maksimale për blunë

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_WhiteBalanceToDisplayStruct

Përshkrimi
Llogarit balancën e bardhë dhe vendos vlerat në strDisplaystruct duke ruajtur kufijtë. Merr Strukturën str Display nga konvertuesi Handle brenda

Prototip

Parametri

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

PCO_GetVersionInfoPCO_CONV

Përshkrimi
Kthen informacionin e versionit në lidhje me dll.

Prototip

Parametri

Vlera e kthimit

Emri	Lloji	Përshkrimi
Mesazhi i gabimit	ndër	0 në rast suksesi, kodi i gabimit ndryshe.

Zbatimi tipik

Ky zbatim tipik hap pas hapi tregon trajtimin bazë

Deklaratat
Vendosni të gjithë parametrat 'madhësia' e bufferit në vlerat e pritura:
Vendosni parametrat e informacionit të sensorit dhe krijoni objektin e konvertimit
Hapni opsionalisht një dialog konvertimi
Vendosni vlerën min dhe maksimale në intervalin e dëshiruar dhe vendosni ato në objektin e konvertimit
Kryeni konvertimin dhe vendosni të dhënat në dialog nëse dialogu është i hapur
Mbyllni dialogun e konvertimit të hapur sipas dëshirës
Mbyllni objektin e konvertimit:

Shikoni Test_cvDlg sample në pco.sdk sample dosje. Duke filluar me v1.20, diapazoni i vlerës së nuancës negative është dyfishuar.

adresa postare: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Gjermani
telefoni: +49 (0) 9441 2005 0
e-mail: pco@excelitas.com
web: www.excelitas.com/pco

Dokumentet / Burimet

EXCELITAS TECHNOLOGIES pco.convert Kamera me mikroskop [pdf] Manuali i Përdoruesit
pco.convert Kamera me mikroskop, pco.convert, Kamera me mikroskop, kamera

Referencat

Manuali i Përdoruesit

EXCELITAS TECHNOLOGIES pco.convert Kamera me mikroskop

Udhëzimet e përdorimit të produktit

Gjeneral

Konvertoni përshkrimin e funksionit API

Zbatimi tipik

Dokumentet / Burimet

Referencat

Lini një koment

Anulo përgjigjen