EXCELITAS TECHNOLOGIES pco.convert Microscope Kamera Manual Bikarhêner

Agahiyên Giştî
Pco.convert ji bo veguheztina reng û rengê pseudo fonksiyonên cihêreng pêşkêşî dike. Ji bo performansa çêtirîn girîng e ku meriv rêwerzên ku di manuala bikarhêner de hatine peyda kirin bişopînin.

Danasîna Fonksiyona API-ê biguherînin
Convert API komek fonksiyonan peyda dike ji bo manîpulekirina daneyên reng û wêneyê. Li jêr çend fonksiyonên sereke hene:

- PCO_ConvertCreate: Nimûneyek veguherînek nû çêbikin.
- PCO_ConvertDelete: Mînakek veguherînê jêbirin.
- PCO_ConvertGet: Mîhengên veguherînê bistînin.

Guhertina Reng û Pseudo Rengê
Pco.convert hem guheztina reş û spî hem jî guheztina rengîn piştgirî dike. Ji bo her cûre veguherînê rêwerzên taybetî yên ku di manualê de hatine peyda kirin bişopînin.

FAQ

Pirs: Ez çawa dikarim bi karanîna pco.convert veguheztina rengîn bikim?
- A: Ji bo veguhertina rengan, fonksiyona PCO_ConvertGet bi pîvanên guncan ên ku di manuala bikarhêner de hatî destnîşan kirin bikar bînin.
Pirs: Ez dikarim mînakek veguherînê jêbikim?
- A: Erê, hûn dikarin mînakek veguheztinê bi karanîna fonksiyona PCO_ConvertDelete jêbirin.

manual user
pco.convert

Excelitas PCO GmbH ji we daxwaz dike ku hûn rêwerzên vê belgeyê bi baldarî bixwînin û bişopînin. Ji bo her pirs an şîrove, ji kerema xwe di her kêliyê de bi me re têkilî daynin.

telefûn: + 49 (0) 9441 2005 50

faks: + 49 (0) 9441 2005 20
navnîşana postê: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Almanya
email: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
pirtûka bikarhêner 1.52.0
Gulan 2024 hate berdan
©Copyright Excelitas PCO GmbH

Ev xebat di bin Lîsansa Navneteweyî ya Creative Commons Attribution-NoDerivatives 4.0 de ye. Ber view kopiyek vê lîsansê, serdana http://creativecommons.org/licenses/by-nd/4.0/ an jî nameyekê bişînin Creative Commons, PO Box 1866, Çiyayê View, CA 94042, USA.

Giştî

Ev ravekirina SDK-ê ya veguherînê dikare were bikar anîn da ku rûtînên veguherîna PCO-yê di sepanên xwedan de, ku ji bo kontrolkirina kamerayên PCO-yê têne bikar anîn, were bikar anîn. Qedexe ye ku meriv rûtînên veguherînê bi kamerayên partiya sêyemîn re bikar bîne.
Ew pco.convert sdk ji du beşan pêk tê: Fonksiyonên veguherîna LUT pco.conv.dll û fonksiyonên diyalogê pco_cdlg.dll .
Fonksiyonên veguheztinê ji bo veguheztina deverên daneyê, b/w û rengîn, bi çareseriya ji 8 bit per pixel zêdetir ji bo deverên daneya b/w bi çareseriya 8 bit per pixel an deverên daneya rengîn ên bi çareseriya 24 têne bikar anîn. (32) bit per pixel. DLL di heman demê de fonksiyonên ji bo afirandina û dagirtina tiştên veguheztinê yên cihêreng vedihewîne.
Di beşa duyemîn a API-ê de fonksiyonên diyalogê hene. Danûstandin diyalogên GUI yên hêsan in ku destûrê didin bikarhêner ku pîvanên tiştên veguheztinê destnîşan bike. Fonksiyonên diyalogê di nav de hene pco_cdlg.dll û li ser hin fonksiyonên pco.conv.dll têne çêkirin.
Di pco.sdk ji bo kamerayên pco du s heneamples, ku veguherîna sdk bikar tînin. Yek Test_cvDlg s eample û ya din jî sc2_demo ye. Ji kerema xwe li wan s binêrinamples da ku hûn fonksiyonên sdk-ê di çalakiyê de veguherînin 'bibînin'.

B/W Û Veguherîna Rengê Pseudo
Algorîtmaya veguherînê ya ku di fonksiyona b/w de tê bikar anîn li ser rûtînek hêsan a jêrîn e

pos guherbara dijber e
dataout qada daneya derketinê ye
datain qada daneya têketinê ye

lutbw qadeke daneyê ya mezinahiya 2n ye ku LUT-ê vedihewîne, li wir n = çareseriya qada têketinê bi bit per pixel

Di fonksiyona pseudocolor de rûtina bingehîn a veguheztina qada daneya RGB ev e:

pos guherbara hejmartina têketinê ye
pout guhêrbara hejmarê ya derketinê ye

dataout qada daneya derketinê ye
datain qada daneya têketinê ye
lutbw qadeke daneyê ya mezinahiya 2n ye ku LUT-ê vedihewîne, li wir n = çareseriya qada têketinê bi bit per pixel

lutred, lutgreen, lutblue qadên daneyê yên mezinahiya 2n in ku LUT-ê vedihewîne, ku n = çareseriya qada derketinê bi bit per pixel.

Veguherîna Rengê

Sensorên rengê CCD ên ku di kamerayên rengîn ên PCO de têne bikar anîn ji bo rengên sor, kesk û şîn fîlter hene. Her pîxel xwedan celebek parzûnek e, bi vî rengî hûn bi eslê xwe ji bo her pixel agahdariya rengîn a tevahî nagirin. Belê her pixel ji bo rengê ku ji parzûnê derbas dibe nirxek bi rêzek dînamîkî ya 12 bit peyda dike.

Hemî kamerayên rengîn ên li PCO bi mozaîkkirina Bayer-filter DE re dixebitin. Nimûneya parzûna rengîn a wan senzorên wêneya rengîn dikare bi matrixek 2×2 were kêm kirin. Sensora wêneyê bixwe dikare wekî matrixek ji wan matrixên 2×2 were dîtin.
Bifikirin ku ev rengê rengê

Reng bixwe tenê şirovekirina matrixê ye. Ev şîrove dê ji hêla algorîtmayek demosaicking ve tê gotin. Pco_conv.dll bi rêbazek xwedan taybetmendiyê dixebite.

Danasîna Fonksiyona API-ê biguherînin

PCO_ConvertCreate

Terîf
Li ser bingeha avahiya PCO_SensorInfo veguheztinek nû diafirîne. Destûra veguherînê ya hatî afirandin dê di dema veguheztinê de were bikar anîn. Ji kerema xwe berî ku serîlêdan derkeve û dll-ya veguherînê dakêşîne, telefonê PCO_ConvertDelete bikin.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK*	Nîşanek berbi destekek ku dê tiştê veguhertina hatî afirandin werbigire
strSensor	PCO_SensorInfo*	Nîşana avahiyek agahdariya sensor. Ji kerema xwe ji bîr nekin ku pîvana wSize saz bikin.
iConvertType	int	Guherbar ji bo destnîşankirina celebê veguherînê, an b/w, reng, rengê pseudo an reng 16

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_ConvertDelete

Terîf
Tiştek veguhertina berê hatî afirandin jêdibe. Berî girtina serîlêdanê pêdivî ye ku meriv vê fonksiyonê bang bike.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di doza serketinê de, koda çewtiyê wekî din.

PCO_ConvertGet

Terîf
Hemî nirxên hêmanek veguherînê ya berê hatî afirandin digire.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrConvert	PCO_Convert*	Nîşanek ji avahiyek veguherîna pco re

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di doza serketinê de, koda çewtiyê wekî din.

PCO_ConvertSet

Terîf
Nirxên pêwîst ji bo tiştek veguherînê ya berê hatî afirandin destnîşan dike.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrConvert	PCO_Convert*	Nîşanek ji avahiyek veguherîna pco re

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_ConvertGetDisplay

Terîf
Struktura PCO_Display digire

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrDisplay	PCO_Display*	Nîşanek avahiyek nîşana pco-yê nîşan bide

Nirxa vegerê

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrDisplay	PCO_Display*	Nîşanek avahiyek nîşana pco-yê nîşan bide

PCO_ConvertSetDisplay

Terîf
Struktura PCO_Display saz dike

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrDisplay	PCO_Display*	Nîşanek avahiyek nîşana pco-yê nîşan bide

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_ConvertSetBayer

Terîf
Nirxên strukturên Bayer ên hêmanek veguherînê ya berê hatî afirandin destnîşan dike. Vê fonksiyonê bikar bînin ku pîvanên nimûneya Bayer biguherînin.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrBayer	PCO_Bayer*	Nîşana avahiyek PCO Bayer bikin

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_ConvertSetFilter

Terîf
Nirxên avahiya parzûnê ya hêmanek veguherînê ya ku berê hatî afirandin destnîşan dike.

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
prefilter	PCO_Parz*	Nîşana avahiyek parzûna pco bikin

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_ConvertSetSensorInfo

Terîf
Struktura PCO_SensorInfo ji bo veguhezek berê hatî afirandin saz dike

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pstrSensorInfo	PCO_SensorInfo*	Nîşana avahiyek agahdariya sensor. Ji kerema xwe ji bîr nekin ku pîvana wSize saz bikin

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_SetPseudoLut

Terîf
Sê tabloyên rengê pseudolut ên komployê bar bikin

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
pseudo_lut	char bê îmza *	Nîşana nirxên rengê pseudo lut (rengên R,G,B: 256 * 3 bytes, an 4 bytes)
inumcolors	int	Ji bo R,G,B an jî 3 ji bo R,G,B,A 4 saz bikin

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_LoadPseudoLut

Terîf
Tabloyek lêgerîna rengê pseudo li tiştê veguherînê bar dike. Ev fonksiyon dikare were bikar anîn da ku hin tabloyên lêgerîna pseudo-ya ku ji berê ve hatine destnîşan kirin an bixwe hatine afirandin bar bikin.

Prototype

Parametre

Nav Cureyê Danasîn
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
çap	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenav	char*	Navê file barkirin

Nirxa vegerê

Nav Cureyê Danasîn
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
çap	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenav	char*	Navê file barkirin

PCO_Convert16TO8

Terîf
Daneyên wêneyê di b16-ê de bi daneya 8 bit-ê di b8-ê de veguherînin (renga gewr)

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
awa	int	Parametreya modê
icolmode	int	Parametreya moda rengîn
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
b16	bêje*	Nîşana wêneyê xav bikin
b8	byte*	Nîşanek ji bo wêneya b/w ya 8 bit veguherî

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_Convert16TO24

Terîf
Daneyên wêneyê di b16-ê de bi daneya 24 bit-ê di b24-ê de veguherînin (renga gewr)

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
awa	int	Parametreya modê

Nav	Awa	Terîf
icolmode	int	Parametreya moda rengîn
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
b16	bêje*	Nîşana wêneyê xav bikin
b24	byte*	Nîşanek ji bo wêneya rengîn a 24 bit veguherî

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_Convert16TOCOL

Terîf
Daneyên wêneyê di b16 de veguherînin daneya RGB di b8 de (reng)

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
awa	int	Parametreya modê
icolmode	int	Parametreya moda rengîn
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
b16	bêje*	Nîşana wêneyê xav bikin
b8	byte*	Nîşanek ji bo wêneya rengîn a 24 bit veguherî

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_Convert16TOPSEUDO

Terîf
Daneyên wêneyê di b16 de veguherînin daneyên pseudo rengîn ên di b8 (reng)

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
awa	int	Parametreya modê
icolmode	int	Parametreya moda rengîn
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
b16	bêje*	Nîşana wêneyê xav bikin
b8	byte*	Nîşanek ji bo 24bit wêneya pseudo rengîn veguherî

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_Convert16TOCOL16

Terîf
Daneyên wêneyê di b16 de veguherînin daneya RGB di b16 de (reng)

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
awa	int	Parametreya modê

Nav	Awa	Terîf
icolmode	int	Parametreya moda rengîn
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
b16in	bêje*	Nîşana wêneyê xav bikin
b16 der	bêje*	Nîşanek ji bo wêneya rengîn a 48 bit veguherî

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_GetWhiteBalance

Terîf
Nirxên hevseng ên spî ji bo reng_tempandê digire

Prototype

Parametre

Nav	Awa	Terîf
ph	DESTIK	Bi hêmanek veguherînê ya ku berê hatî afirandin bi dest bixe
color_temp	int*	nîşana int ji bo ku germahiya rengê hesabkirî bistînin
tint	int*	nîşankera int da ku nirxa tîrêjê ya hesabkirî bistînin
awa	int	Parametreya modê
berî	int	Firehiya wêneyê ji bo veguherînê
bilindî	int	Bilindahiya wêneyê ji bo veguhertinê
gb12	BÊJE*	Nîşana rêza daneya wêneya xav
x_min	int	Rectangle ji bo danîna herêma wêneyê ku ji bo hesabkirinê were bikar anîn
y_min	int	Rectangle ji bo danîna herêma wêneyê ku ji bo hesabkirinê were bikar anîn
x_max	int	Rectangle ji bo danîna herêma wêneyê ku ji bo hesabkirinê were bikar anîn
y_max	int	Rectangle ji bo danîna herêma wêneyê ku ji bo hesabkirinê were bikar anîn

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_GetMaxLimit

Terîf
GetMaxLimit nirxên RGB-ê ji bo germahî û rengek diyarkirî digire. Nirxa herî zêde di nav diyaloga kontrolê ya veguhertinê de divê ji nirxa herî mezin a nirxên RGB derbas nebe, mînakî heke R nirxa herî mezin be, nirxa herî zêde dikare zêde bibe heya ku nirxa R li çareseriya bitê (4095) bigire. Ji bo kêmkirina nirxa herî zêde divê heman şert were cîbicîkirin, bo nimûne eger B nirxa herî kêm be, nirxa herî zêde dikare kêm bibe heya ku nirxa B bigihîje nirxa min.

Prototype

Parametre

Nav	Awa	Terîf
r_max	avbazîn*	Nîşanek li floatek ku nirxa sor ya herî zêde digire
g_max	avbazîn*	Nîşanek li ser floatek ku nirxa kesk a herî zêde digire
b_max	avbazîn*	Nîşanek li ser floatek ku nirxa şîn a herî zêde digire
temp	avbazîn	Germahiya rengîn
tint	avbazîn	Sazkirina tintê
output_bits	int	Çareserkirina bit ya wêneya guhertî (bi gelemperî 8)

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_GetColorValues

Terîf
Ji bo nirxên herî zêde yên R,G,B, germahî û rengan distîne.
GetColorValuesis tenê tê bikar anîn pco.camware . Ew germahiya reng û rengan li ser bingeha nirxên Rmax, Gmax, Bmax yên lut rengê kevn hesab dike. Nirxên hesabkirî ji bo veguheztina wêneyên kevn ên b16 û tif16 bi rûtînên nûveguhertinê têne bikar anîn.

Prototype

Parametre

Nav	Awa	Terîf
pfColorTemp	avbazîn*	Ji bo wergirtina germahiya reng li ser floatekê nîşan bidin
pfColorTemp	avbazîn*	Ji bo wergirtina rengê reng li ser floatek nîşan bidin
iRedMax	int	Ji bo sorkirina nirxa herî zêde ya heyî ji bo sor
iGreenMax	int	Ji bo kesk nirxa herî zêde ya heyî destnîşan dike.
iBlueMax	int	Yekjimar ji bo danîna nirxa herî zêde ya heyî ji bo şîn

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_WhiteBalanceToDisplayStruct

Terîf
Hevsengiya spî hesab dike û dema ku sînoran diparêze nirxan li strDisplaystructê saz dike. Structura str Display ji Handle veguherîna hundurîn digire

Prototype

Parametre

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

PCO_GetVersionInfoPCO_CONV

Terîf
Agahdariya guhertoya li ser dll vedigerîne.

Prototype

Parametre

Nirxa vegerê

Nav	Awa	Terîf
ErrorMessage	int	0 di rewşeke serketî de, Errorcode wekî din.

Pêkanîna Tîpîk

Vê gav-gav bicîhkirina tîpîk rêwerziya bingehîn nîşan dide

Daxuyaniyên
Hemî pîvanên 'mezinê' yên tampon li gorî nirxên hêvîkirî bicîh bikin:
Parametreyên agahdariya sensor saz bikin û tiştê veguherînê biafirînin
Bi bijartî diyalogek veguherînê vekin
Nirxa min û herî zêde li rêza xwestinê bicîh bikin û wan li tiştê veguherînê bicîh bikin
Veguherînê bikin û heke diyalog vekirî be daneyan li ser diyalogê bicîh bikin
Diyaloga veguhertina vebijarkî ya vekirî bigire
Tişta veguherînê bigire: