TECHNOLEGAU EXCELITAS pco.convert Llawlyfr Defnyddiwr Camera Microsgop

Gwybodaeth Gyffredinol
Mae'r pco.convert yn cynnig swyddogaethau amrywiol ar gyfer trosi lliw lliw a ffug. Mae'n bwysig dilyn y cyfarwyddiadau a ddarperir yn y llawlyfr defnyddiwr ar gyfer perfformiad gorau posibl.

Trosi Disgrifiad Swyddogaeth API
Mae'r API Convert yn darparu set o swyddogaethau ar gyfer trin data lliw a delwedd. Isod mae rhai swyddogaethau allweddol:

- PCO_ConvertCreate: Creu enghraifft trosi newydd.
- PCO_Trosi Dileu: Dileu enghraifft trosi.
- PCO_ConvertGet: Cael gosodiadau trosi.

Lliw a Throsi Lliw Ffug
Mae'r pco.convert yn cefnogi trosi du a gwyn yn ogystal â throsi lliw. Dilynwch y cyfarwyddiadau penodol a ddarperir yn y llawlyfr ar gyfer pob math o drawsnewidiad.

FAQ

C: Sut mae perfformio trosi lliw gan ddefnyddio pco.convert?
- A: I berfformio trosi lliw, defnyddiwch y swyddogaeth PCO_ConvertGet gyda'r paramedrau priodol fel yr amlinellir yn y llawlyfr defnyddiwr.
C: A allaf ddileu enghraifft trosi?
- A: Gallwch, gallwch ddileu enghraifft trosi gan ddefnyddio'r swyddogaeth PCO_ConvertDelete.

llawlyfr defnyddiwr
pco.convert

Mae Excelitas PCO GmbH yn gofyn ichi ddarllen a dilyn y cyfarwyddiadau yn y ddogfen hon yn ofalus. Am unrhyw gwestiynau neu sylwadau, mae croeso i chi gysylltu â ni unrhyw bryd.

ffôn: + 49 (0) 9441 2005 50

ffacs: + 49 (0) 9441 2005 20
cyfeiriad post: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, yr Almaen
e-bost: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
llawlyfr defnyddiwr 1.52.0
Rhyddhawyd Mai 2024
©Hawlfraint Excelitas PCO GmbH

Mae'r gwaith hwn wedi'i drwyddedu o dan Drwydded Ryngwladol Creative Commons Attribution-NoDerivatives 4.0. I view copi o'r drwydded hon, ymwelwch http://creativecommons.org/licenses/by-nd/4.0/ neu anfon llythyr i Creative Commons, PO Box 1866, Mountain View, CA 94042, UDA.

Cyffredinol

Gellir defnyddio'r disgrifiad SDK trosi hwn i weithredu'r arferion trosi PCO mewn cymwysiadau perchnogol, a ddefnyddir i reoli camerâu PCO. Gwaherddir defnyddio'r arferion trosi gyda chamerâu trydydd parti.
Mae'r pco.convert Mae sdk yn cynnwys dwy ran: Y swyddogaethau trosi LUT pco.conv.dll a'r swyddogaethau deialog pco_cdlg.dll .
Defnyddir y swyddogaethau trosi i drosi ardaloedd data, b/w a lliw, gyda chydraniad o fwy nag 8 did y picsel i naill ai ardaloedd data b/w gyda chydraniad o 8 did y picsel neu ardaloedd data lliw gyda chydraniad o 24 (32) did y picsel. Mae'r DLL hefyd yn cynnwys swyddogaethau i greu a llenwi'r gwahanol wrthrychau trosi.
Mae ail ran yr API yn cynnwys y swyddogaethau deialog. Mae'r deialogau yn ddeialogau GUI syml sy'n galluogi'r defnyddiwr i osod paramedrau'r gwrthrychau trosi. Mae'r swyddogaethau deialog wedi'u cynnwys yn y pco_cdlg.dll ac maent yn seiliedig ar rai o swyddogaethau'r pco.conv.dll.
Yn y pco.sdk ar gyfer camerâu pco mae dwy samples, sy'n gwneud defnydd o'r sdk trosi. Un yw y Test_cvDlg sample a'r llall yw'r sc2_demo. Cymerwch olwg ar y rhai samples er mwyn 'gweld' y swyddogaethau trosi sdk ar waith.

B/W A Throsi Lliw Ffug
Mae'r algorithm trosi a ddefnyddir yn y ffwythiant b/w yn seiliedig ar y drefn syml ganlynol

lle

pos yw'r newidyn cownter
dataout yw'r maes data allbwn
datain yw'r maes data mewnbwn

Mae lutbw yn ardal ddata o faint 2n sy'n cynnwys yr LUT, lle mae n = cydraniad yr ardal fewnbwn mewn darnau fesul picsel

Yn y swyddogaeth ffug-liw, y drefn sylfaenol i'w throsi i ardal ddata RGB yw:

lle

pos yw'r newidyn rhifydd mewnbwn
pout yw'r newidyn rhifydd allbwn

dataout yw'r maes data allbwn
datain yw'r maes data mewnbwn
Mae lutbw yn ardal ddata o faint 2n sy'n cynnwys yr LUT, lle mae n = cydraniad yr ardal fewnbwn mewn darnau fesul picsel

mae lutred, lutgreen, lutblue yn feysydd data maint 2n sy'n cynnwys yr LUT, lle mae n = cydraniad yr ardal allbwn mewn did y picsel.

Trosi Lliw

Mae gan synwyryddion lliw CCD a ddefnyddir mewn camerâu lliw PCO hidlwyr ar gyfer y lliwiau coch, gwyrdd a glas. Mae gan bob picsel un math o hidlydd, felly yn wreiddiol nid ydych yn cael gwybodaeth lliw llawn ar gyfer pob picsel. Yn hytrach, mae pob picsel yn darparu gwerth gydag ystod ddeinamig o 12 did ar gyfer y lliw sy'n pasio'r hidlydd.

Mae'r holl gamerâu lliw yn PCO yn gweithio gyda'r mosaigiad Bayer-filter DE. Gellir lleihau patrwm hidlo lliw y synwyryddion delwedd lliw hynny i fatrics 2 × 2. Gellir gweld y synhwyrydd delwedd ei hun fel matrics o'r matricsau 2 × 2 hynny.
Tybiwch y patrwm lliw hwn

Dim ond dehongliad o'r matrics yw'r lliw ei hun. Bydd y dehongliad hwn yn cael ei wneud gan yr hyn a elwir yn algorithm demosacking. Mae'r pco_conv.dll yn gweithio gyda dull perchnogol arbennig.

Trosi Disgrifiad Swyddogaeth API

PCO_ConvertCreate

Disgrifiad
Yn creu gwrthrych trosi newydd yn seiliedig ar strwythur PCO_SensorInfo. Bydd y ddolen trosi a grëwyd yn cael ei defnyddio yn ystod y trawsnewid. Ffoniwch PCO_ConvertDelete cyn i'r cais adael a dadlwytho'r dll trosi.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	TRIN*	Pwyntiwch at ddolen a fydd yn derbyn y gwrthrych trosi a grëwyd
strSensor	PCO_SensorInfo*	Pwyntiwr at strwythur gwybodaeth synhwyrydd. Peidiwch ag anghofio gosod y paramedr wSize.
iConvertTip	int	Amrywiol i bennu'r math o drawsnewidiad, naill ai b/w, lliw, lliw ffug neu liw 16

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_ConvertDelete

Disgrifiad
Yn dileu gwrthrych trosi a grëwyd yn flaenorol. Mae'n orfodol galw'r swyddogaeth hon cyn cau'r cais.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, cod Gwall fel arall.

PCO_ConvertGet

Disgrifiad
Yn cael holl werthoedd gwrthrych trosi a grëwyd yn flaenorol.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstrTrosi	PCO_Trosi*	Pwyntiwr at strwythur trosi pco

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, cod Gwall fel arall.

PCO_ConvertSet

Disgrifiad
Yn gosod gwerthoedd angenrheidiol ar gyfer gwrthrych trosi a grëwyd yn flaenorol.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstrTrosi	PCO_Trosi*	Pwyntiwr at strwythur trosi pco

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_ConvertGetDisplay

Disgrifiad
Yn cael y strwythur PCO_Display

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstrArddangos	PCO_Arddangos*	Pwyntiwr at strwythur arddangos pco

Gwerth dychwelyd

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstrArddangos	PCO_Arddangos*	Pwyntiwr at strwythur arddangos pco

PCO_ConvertSetDisplay

Disgrifiad
Yn gosod y strwythur PCO_Display

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstrArddangos	PCO_Arddangos*	Pwyntiwr at strwythur arddangos pco

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_ConvertSetBayer

Disgrifiad
Yn gosod gwerthoedd strwythur Bayer gwrthrych trawsnewid a grëwyd yn flaenorol. Defnyddiwch y swyddogaethau hyn i newid paramedrau patrwm Bayer.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstBayer	PCO_Bayer*	Pwyntiwr at strwythur PCO Bayer

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_ConvertSetFilter

Disgrifiad
Yn gosod gwerthoedd strwythur hidlo gwrthrych trosi a grëwyd yn flaenorol.

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
prefilter	PCO_Filter*	Pwyntiwr at strwythur hidlydd pco

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_ConvertSetSensorInfo

Disgrifiad
Yn gosod y strwythur PCO_SensorInfo ar gyfer gwrthrych trosi a grëwyd yn flaenorol

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
pstSensorInfo	PCO_SensorInfo*	Pwyntiwr at strwythur gwybodaeth synhwyrydd. Peidiwch ag anghofio gosod y paramedr wSize

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_SetPseudoLut

Disgrifiad
Llwythwch y tri tabl lliw pseudolut o blot

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
ffug_lut	torgoch heb ei arwyddo *	Pwyntiwr at werthoedd lliw ffug-liw (lliwiau R, G, B: 256 * 3 beit, neu 4 beit)
lliwiau inum	int	Gosod i naill ai 3 ar gyfer R, G, B neu 4 ar gyfer R, G, B, A

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_LoadPseudoLut

Disgrifiad
Yn llwytho tabl chwilio lliw ffug i'r gwrthrych trosi. Gellir defnyddio'r swyddogaeth hon i lwytho rhai o'r tablau chwilio ffug rhagddiffiniedig neu hunan-greu.

Prototeip

Paramedr

Enw Disgrifiad Math
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
fformat	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
fileenw	torgoch*	Enw'r file i lwytho

Gwerth dychwelyd

Enw Disgrifiad Math
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
fformat	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
fileenw	torgoch*	Enw'r file i lwytho

PCO_Convert16TO8

Disgrifiad
Trosi data llun mewn data b16 i ddata 8bit mewn b8 (graddfa lwyd)

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
modd	int	Modd paramedr
icomod	int	Paramedr modd lliw
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
b16	gair *	Pwyntiwr at y ddelwedd amrwd
b8	beit*	Pwyntydd i ddelwedd 8bit b/w wedi'i throsi

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_Convert16TO24

Disgrifiad
Trosi data llun mewn data b16 i ddata 24bit mewn b24 (graddfa lwyd)

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
modd	int	Modd paramedr

Enw	Math	Disgrifiad
icomod	int	Paramedr modd lliw
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
b16	gair *	Pwyntiwr at y ddelwedd amrwd
b24	beit*	Pwyntydd i ddelwedd lliw 24-did wedi'i throsi

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_Convert16TOCOL

Disgrifiad
Trosi data llun yn b16 i ddata RGB yn b8 (lliw)

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
modd	int	Modd paramedr
icomod	int	Paramedr modd lliw
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
b16	gair *	Pwyntiwr at y ddelwedd amrwd
b8	beit*	Pwyntydd i ddelwedd lliw 24-did wedi'i throsi

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_Convert16TOPSEUDO

Disgrifiad
Trosi data llun yn b16 i ddata lliw ffug yn b8 (lliw)

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
modd	int	Modd paramedr
icomod	int	Paramedr modd lliw
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
b16	gair *	Pwyntiwr at y ddelwedd amrwd
b8	beit*	Pwyntydd i ddelwedd lliw ffug 24bit wedi'i drosi

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_Convert16TOCOL16

Disgrifiad
Trosi data llun yn b16 i ddata RGB yn b16 (lliw)

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
modd	int	Modd paramedr

Enw	Math	Disgrifiad
icomod	int	Paramedr modd lliw
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
b16in	gair *	Pwyntiwr at y ddelwedd amrwd
b16 allan	gair *	Pwyntydd i ddelwedd lliw 48-did wedi'i throsi

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_GetWhiteBalance

Disgrifiad
Yn cael gwerthoedd gwyn cytbwys ar gyfer lliw lliw_tempand

Prototeip

Paramedr

Enw	Math	Disgrifiad
ph	Trin	Trin i wrthrych trosi a grëwyd yn flaenorol
lliw_temp	int*	pwyntydd int i gael y tymheredd lliw wedi'i gyfrifo
arlliw	int*	pwyntydd int i gael y gwerth arlliw wedi'i gyfrifo
modd	int	Modd paramedr
lled	int	Lled y ddelwedd i'w throsi
uchder	int	Uchder y ddelwedd i'w throsi
gb12	GAIR*	Pwyntydd at arae data llun amrwd
x_mun	int	Petryal i osod y rhanbarth delwedd i'w ddefnyddio ar gyfer cyfrifo
y_min	int	Petryal i osod y rhanbarth delwedd i'w ddefnyddio ar gyfer cyfrifo
x_uchafswm	int	Petryal i osod y rhanbarth delwedd i'w ddefnyddio ar gyfer cyfrifo
y_max	int	Petryal i osod y rhanbarth delwedd i'w ddefnyddio ar gyfer cyfrifo

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_GetMaxLimit

Disgrifiad
Mae GetMaxLimit yn cael y gwerthoedd RGB ar gyfer tymheredd ac arlliw penodol. Ni ddylai'r gwerth uchaf yn yr ymgom rheoli trosi fod yn fwy na gwerth mwyaf y gwerthoedd RGB, ee rhag ofn mai R yw'r gwerth mwyaf, gall y gwerth uchaf gynyddu nes bod y gwerth R yn cyrraedd cydraniad did (4095). Rhaid bodloni'r un amod ar gyfer lleihau'r gwerth uchaf, ee rhag ofn mai B yw'r gwerth isaf, gall y gwerth uchaf leihau nes bod gwerth B yn cyrraedd y gwerth isaf.

Prototeip

Paramedr

Enw	Math	Disgrifiad
r_max	arnofio*	Pwyntiwr at fflôt sy'n derbyn y gwerth coch mwyaf
g_max	arnofio*	Pwyntiwr at fflôt sy'n derbyn y gwerth gwyrdd mwyaf
b_max	arnofio*	Pwyntiwr at fflôt sy'n derbyn y gwerth glas mwyaf
tymmorol	arnofio	Tymheredd lliw
arlliw	arnofio	Gosodiad arlliw
allbwn_darnau	int	Cydraniad did y ddelwedd wedi'i throsi (8 fel arfer)

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_GetColorValues

Disgrifiad
Yn cael tymheredd lliw ac arlliw ar gyfer gwerthoedd uchaf R, G, B a roddir.
GetColorValuesis a ddefnyddir yn unig pco.camware . Mae'n cyfrifo'r tymheredd lliw a'r arlliw yn seiliedig ar werthoedd Rmax, Gmax, Bmax yr hen lut lliw. Defnyddir y gwerthoedd a gyfrifwyd i drosi hen ddelweddau b16 a tif16 gyda'r arferion trosi newydd.

Prototeip

Paramedr

Enw	Math	Disgrifiad
pfColorTemp	arnofio*	Pwyntiwch at fflôt ar gyfer derbyn y tymheredd lliw
pfColorTemp	arnofio*	Pwyntiwch at fflôt ar gyfer derbyn yr arlliw lliw
iRedMax	int	Cyfanrif i osod y gwerth uchaf cyfredol ar gyfer coch
iGreenMax	int	Cyfanrif i osod y gwerth uchaf cyfredol ar gyfer gwyrdd.
iBlueMax	int	Cyfanrif i osod y gwerth uchaf cyfredol ar gyfer glas

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_WhiteBalanceToDisplayStruct

Disgrifiad
Yn cyfrifo'r cydbwysedd gwyn ac yn gosod y gwerthoedd i'r strDisplaystruct tra'n cynnal y terfynau. Yn cael y struct str Arddangos o'r Handle trosi yn fewnol

Prototeip

Paramedr

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

PCO_GetVersionInfoPCO_CONV

Disgrifiad
Yn dychwelyd gwybodaeth fersiwn am y dll.

Prototeip

Paramedr

Gwerth dychwelyd

Enw	Math	Disgrifiad
Neges Gwall	int	0 rhag ofn y bydd llwyddiant, Errorcode fel arall.

Gweithredu Nodweddiadol

Mae'r gweithredu cam wrth gam nodweddiadol hwn yn dangos y driniaeth sylfaenol

Datganiadau
Gosodwch yr holl baramedrau 'maint' byffer i'r gwerthoedd disgwyliedig:
Gosodwch baramedrau gwybodaeth y synhwyrydd a chreu'r gwrthrych trosi
Agorwch ddeialog trosi yn ddewisol
Gosodwch y gwerth isaf ac uchaf i'r ystod a ddymunir a'u gosod i'r gwrthrych trosi
Gwnewch y trosi a gosodwch y data i'r ymgom os yw deialog ar agor
Caewch y deialog trosi a agorwyd yn ddewisol
Caewch y gwrthrych trosi: