EXCELITAS TECHNOLOGIES pco.convert Microscope Camera User Manual

Ĝenerala Informo
La pco.convert ofertas diversajn funkciojn por kolora kaj pseŭdokolora konvertiĝo. Gravas sekvi la instrukciojn provizitajn en la uzantmanlibro por optimuma rendimento.

Konverti API-funkcia Priskribo
La Konverti API disponigas aron da funkcioj por manipuli kolorajn kaj bildajn datumojn. Malsupre estas kelkaj ŝlosilaj funkcioj:

- PCO_ConvertCreate: Kreu novan konvertan kazon.
- PCO_ConvertDelete: Forigu konvertan kazon.
- PCO_ConvertGet: Akiru konvertajn agordojn.

Koloro kaj Pseŭdo Koloro-Konvertiĝo
La pco.convert subtenas ambaŭ nigran kaj blankan konvertiĝon kaj ankaŭ kolorkonverton. Sekvu la specifajn instrukciojn provizitajn en la manlibro por ĉiu tipo de konvertiĝo.

Oftaj Demandoj

Q: Kiel mi plenumas kolorkonverton per pco.convert?
- R: Por fari kolorkonverton, uzu la funkcion PCO_ConvertGet kun la taŭgaj parametroj kiel skizite en la uzantmanlibro.
Q: Ĉu mi povas forigi konvertan kazon?
- R: Jes, vi povas forigi konvertan kazon per la funkcio PCO_ConvertDelete.

uzantmanlibro
pco.convert

Excelitas PCO GmbH petas vin zorge legi kaj sekvi la instrukciojn en ĉi tiu dokumento. Por ajnaj demandoj aŭ komentoj, bonvolu kontakti nin iam ajn.

telefono: + 49 (0) 9441 2005 50

fakso: + 49 (0) 9441 2005 20
poŝta adreso: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germanujo
retpoŝto: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
uzula manlibro 1.52.0
Eldonita majo 2024
©Kopirajto Excelitas PCO GmbH

Ĉi tiu verko estas permesita laŭ la Krea Komunaĵo Atribuite-SenDerivaĵoj 4.0 Internacia Licenco. Al view kopion de ĉi tiu permesilo, vizitu http://creativecommons.org/licenses/by-nd/4.0/ aŭ sendu leteron al Krea Komunaĵo, Poŝtkesto 1866, Monto View, CA 94042, Usono.

Generalo

Ĉi tiu konvertita SDK-priskribo povas esti uzata por efektivigi la PCO-konvertitajn rutinojn en proprietaj aplikoj, kiuj estas uzataj por kontroli PCO-fotilojn. Estas malpermesite uzi la konvertitajn rutinojn kun triaj fotiloj.
La pco.convert sdk konsistas el du partoj: La LUT-konvertaj funkcioj pco.conv.dll kaj la dialogfunkcioj pco_cdlg.dll .
La konvertaj funkcioj estas uzataj por konverti datenareojn, b/w kaj koloron, kun rezolucio de pli ol 8 bitoj per pikselo al aŭ b/w datumareoj kun rezolucio de 8 bitoj per pikselo aŭ koloraj datumareoj kun rezolucio de 24 (32) bitoj por pikselo. La DLL ankaŭ inkluzivas funkciojn por krei kaj plenigi la diversajn konvertitajn objektojn.
La dua parto de la API enhavas la dialogfunkciojn. La dialogoj estas simplaj GUI-dialogoj, kiuj ebligas al la uzanto agordi la parametrojn de la konvertitaj objektoj. La dialogfunkcioj estas inkluzivitaj en la pco_cdlg.dll kaj baziĝas sur iuj funkcioj de la pco.conv.dll.
En la pco.sdk por pco fotiloj ekzistas du samples, kiuj uzas la convert sdk. Unu estas la Test_cvDlg sample kaj la alia estas la sc2_demo. Bonvolu rigardi tiujn samples por 'vidi' la konvertitajn sdk-funkciojn en ago.

B/W Kaj Pseŭdo Kolora Konvertiĝo
La konverta algoritmo uzita en la b/w funkcio baziĝas sur la sekva simpla rutino

kie

pos estas la nombrilo variablo
dataout estas la eliga datuma areo
datain estas la eniga datuma areo

lutbw estas datenareo de grandeco 2n enhavanta la LUT, kie n = rezolucio de la eniga areo en bitoj per pikselo

En la pseŭdokolorfunkcio la baza rutino por konverti al RGB-datenareo estas:

kie

pos estas la eniga nombrilo variablo
pout estas la eliga nombrilo variablo

dataout estas la eliga datuma areo
datain estas la eniga datuma areo
lutbw estas datenareo de grandeco 2n enhavanta la LUT, kie n = rezolucio de la eniga areo en bitoj per pikselo

lutred, lutgreen, lutblue estas datenareoj de grandeco 2n enhavanta la LUT, kie n = rezolucio de la produktaĵareo en bito per pikselo.

Kolora Konvertiĝo

CCD-kolorsensiloj uzitaj en PCO-kolorfotiloj havas filtrilojn por la koloroj ruĝa, verda, kaj blua. Ĉiu pikselo havas unu specon de filtrilo, tial origine vi ne ricevas plenajn kolorinformojn por ĉiu pikselo. Prefere ĉiu pikselo liveras valoron kun dinamika gamo de 12 bitoj por la koloro kiu pasas la filtrilon.

Ĉiuj kolorfotiloj ĉe PCO funkcias kun la Bayer-filtrilo DE mozaikaĵo. La kolorfiltrilpadrono de tiuj kolorbildsensiloj povas esti reduktita al 2×2 matrico. La bildsensilo mem povas esti vidita kiel matrico de tiuj 2×2 matricoj.
Supozu ĉi tiun koloran ŝablonon

La koloro mem estas nur interpreto de la matrico. Ĉi tiu interpreto estos farita per tiel nomata demosaicking-algoritmo. La pco_conv.dll funkcias kun speciala proprieta metodo.

Konverti API-funkcia Priskribo

PCO_ConvertCreate

Priskribo
Kreas novan konvertan objekton bazitan sur la strukturo PCO_SensorInfo. La kreita konvertito tenilo estos uzata dum la konvertiĝo. Bonvolu telefoni al PCO_ConvertDelete antaŭ ol la aplikaĵo eliras kaj malŝarĝas la konvertitan dll.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	TENIGO*	Montrilo al tenilo, kiu ricevos la kreitan konvertitan objekton
strSensor	PCO_SensorInfo*	Montrilo al sensila informstrukturo. Bonvolu ne forgesi agordi la parametron wSize.
iConvertType	int	Variablo por determini la konvertan tipon, ĉu b/w, koloro, pseŭdokoloro aŭ koloro 16

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertDelete

Priskribo
Forigas antaŭe kreitan konvertan objekton. Estas devige voki ĉi tiun funkcion antaŭ fermi la aplikaĵon.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertGet

Priskribo
Akiras ĉiujn valorojn de antaŭe kreita konvertobjekto.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrConvert	PCO_Konverti*	Montrilo al pco-konverti strukturo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertSet

Priskribo
Agordas necesajn valorojn por antaŭe kreita konvertobjekto.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrConvert	PCO_Konverti*	Montrilo al pco-konverti strukturo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertGetDisplay

Priskribo
Akiras la strukturon PCO_Display

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrVidigu	PCO_Display*	Montrilo al pco-montra strukturo

Revena valoro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrVidigu	PCO_Display*	Montrilo al pco-montra strukturo

PCO_ConvertSetDisplay

Priskribo
Agordas la strukturon PCO_Display

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrVidigu	PCO_Display*	Montrilo al pco-montra strukturo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertSetBayer

Priskribo
Agordas la Bayer-strukturvalorojn de antaŭe kreita konvertobjekto. Uzu ĉi tiujn funkciojn por ŝanĝi la parametrojn de la ŝablono de Bayer.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrBayer	PCO_Bayer*	Montrilo al strukturo de PCO Bayer

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertSetFilter

Priskribo
Agordas la filtrilstrukturvalorojn de antaŭe kreita konvertobjekto.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
antaŭfiltrilo	PCO_Filtrilo*	Montrilo al pco-filtrila strukturo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_ConvertSetSensorInfo

Priskribo
Fiksas la strukturon PCO_SensorInfo por antaŭe kreita konvertobjekto

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pstrSensorInfo	PCO_SensorInfo*	Montrilo al sensila informstrukturo. Bonvolu ne forgesi agordi la parametron wSize

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_SetPseudoLut

Priskribo
Ŝarĝu la tri pseŭdolutajn kolorajn tabelojn de intrigo

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
pseudo_lut	sennoma signo *	Montrilo al pseŭdolutaj kolorvaloroj (R, G, B-koloroj: 256 * 3 bajtoj, aŭ 4 bajtoj)
inumkoloroj	int	Agordu al aŭ 3 por R, G, B aŭ 4 por R, G, B, A

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_LoadPseudoLut

Priskribo
Ŝargas pseŭdokoloran serĉtabelon al la konvertita objekto. Ĉi tiu funkcio povas esti uzata por ŝargi iujn el la antaŭdifinitaj aŭ memkreitaj pseŭdo-serĉaj tabeloj.

Prototipo

Parametro

Nomo Tipo Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
formato	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenomo	char*	Nomo de la file ŝarĝi

Revena valoro

Nomo Tipo Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
formato	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenomo	char*	Nomo de la file ŝarĝi

PCO_Convert16TO8

Priskribo
Konvertu bildajn datumojn en b16 al 8bitaj datumoj en b8 (grizskalo)

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
reĝimo	int	Reĝima parametro
ikolmode	int	Parametro de kolorreĝimo
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
b16	vorto*	Montrilo al la kruda bildo
b8	bajto*	Montrilo al konvertita 8bit b/w bildo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_Convert16TO24

Priskribo
Konvertu bildajn datumojn en b16 al 24bitaj datumoj en b24 (grizskalo)

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
reĝimo	int	Reĝima parametro

Nomo	Tajpu	Priskribo
ikolmode	int	Parametro de kolorreĝimo
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
b16	vorto*	Montrilo al la kruda bildo
b24	bajto*	Montrilo al konvertita 24-bita kolorbildo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_Convert16TOCOL

Priskribo
Konvertu bildajn datumojn en b16 al RGB-datumoj en b8 (koloro)

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
reĝimo	int	Reĝima parametro
ikolmode	int	Parametro de kolorreĝimo
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
b16	vorto*	Montrilo al la kruda bildo
b8	bajto*	Montrilo al konvertita 24-bita kolorbildo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_Convert16TOPSEUDO

Priskribo
Konverti bildajn datumojn en b16 al pseŭdokoloraj datumoj en b8 (koloro)

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
reĝimo	int	Reĝima parametro
ikolmode	int	Parametro de kolorreĝimo
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
b16	vorto*	Montrilo al la kruda bildo
b8	bajto*	Montrilo al transformita pseŭdokolora bildo de 24 bitoj

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_Convert16TOCOL16

Priskribo
Konvertu bildajn datumojn en b16 al RGB-datumoj en b16 (koloro)

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
reĝimo	int	Reĝima parametro

Nomo	Tajpu	Priskribo
ikolmode	int	Parametro de kolorreĝimo
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
b16in	vorto*	Montrilo al la kruda bildo
b16 eksteren	vorto*	Montrilo al konvertita 48-bita kolorbildo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_GetWhiteBalance

Priskribo
Akiras blankbalancajn valorojn por color_tempand tint

Prototipo

Parametro

Nomo	Tajpu	Priskribo
ph	MANO	Pritraktu al antaŭe kreita konvertobjekto
koloro_temp	int*	int-montrilo por akiri la kalkulitan kolortemperaturon
nuanco	int*	int-montrilo por akiri la kalkulitan nuancan valoron
reĝimo	int	Reĝima parametro
larĝo	int	Larĝo de la bildo por konverti
alteco	int	Alteco de la bildo por konverti
gb12	VORTO*	Montrilo al kruda bilda datumo
x_min	int	Rektangulo por agordi la bildregionon por esti uzata por kalkulo
y_min	int	Rektangulo por agordi la bildregionon por esti uzata por kalkulo
x_max	int	Rektangulo por agordi la bildregionon por esti uzata por kalkulo
y_max	int	Rektangulo por agordi la bildregionon por esti uzata por kalkulo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_GetMaxLimit

Priskribo
GetMaxLimit ricevas la RGB-valorojn por donita temp kaj nuanco. La maksimuma valoro ene de la konvertkontrola dialogo ne devas superi la plej grandan valoron de la RGB-valoroj, ekz. se R estas la plej granda valoro, la maksimuma valoro povas pliiĝi ĝis la R-valoro trafas la bitan rezolucion (4095). La sama kondiĉo devas esti plenumita por malpliigi la maksimuman valoron, ekz. se B estas la plej malalta valoro, la maksimuma valoro povas malpliiĝi ĝis la B-valoro trafas la mininvaloron.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
r_max	flosi*	Montrilo al flosilo ricevanta la maksimuman ruĝan valoron
g_max	flosi*	Montrilo al flosilo ricevanta la maksimuman verdan valoron
b_max	flosi*	Montrilo al flosilo ricevanta la maksimuman bluan valoron
temp	flosi	Kolora temperaturo
nuanco	flosi	Agordo de nuanco
eligo_bitoj	int	Bita rezolucio de la konvertita bildo (kutime 8)

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_GetColorValues

Priskribo
Akiras kolortemperaturon kaj nuancon por donitaj R, G, B maksimumaj valoroj.
GetColorValuesis uzata nur en pco.camware . Ĝi kalkulas la kolortemperaturon kaj nuancon surbaze de la Rmax, Gmax, Bmax valoroj de la malnova kolorlut. La kalkulitaj valoroj estas uzataj por konverti malnovajn bildojn de b16 kaj tif16 kun la novaj konvertitaj rutinoj.

Prototipo

Parametro

Nomo	Tajpu	Priskribo
pfColorTemp	flosi*	Montrilo al flosilo por ricevi la kolortemperaturon
pfColorTemp	flosi*	Montrilo al flosilo por ricevi la kolornuancon
iRedMax	int	Entjero por agordi la nunan maksimuman valoron por ruĝa
iGreenMax	int	Entjero por agordi la nunan maksimuman valoron por verda.
iBlueMax	int	Entjero por agordi la nunan maksimuman valoron por bluo

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_WhiteBalanceToDisplayStruct

Priskribo
Kalkulas la blankekvilibron kaj metas la valorojn al la strDisplaystruct konservante la limojn. Akiras la struct str Montru de la konvertita Tenilo interne

Prototipo

Parametro

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

PCO_GetVersionInfoPCO_CONV

Priskribo
Resendas informojn pri versio pri la dll.

Prototipo

Parametro

Revena valoro

Nomo	Tajpu	Priskribo
EraraMesaĝo	int	0 en kazo de sukceso, Erarkodo alie.

Tipa Efektivigo

Ĉi tiu tipa efektivigo paŝo post paŝo montras la bazan uzadon

Deklaroj
Agordu ĉiujn bufrajn "grandecon" parametrojn al la atendataj valoroj:
Fiksu la sensilajn informojn parametrojn kaj kreu la konvertan objekton
Laŭvole malfermu konvertan dialogon
Agordu la min kaj maksimuman valoron al la dezirata gamo kaj agordu ilin al la konvertita objekto
Faru la konvertiĝon kaj agordu la datumojn al la dialogo se dialogo estas malfermita
Fermu la laŭvole malfermitan konverti dialogon
Fermu la konvertan objekton: