EXCELITAS TECHNOLOGIES pco.convert Notendahandbók fyrir smásjá myndavél

Almennar upplýsingar
Pco.convert býður upp á ýmsar aðgerðir fyrir lita- og gervilitabreytingar. Mikilvægt er að fylgja leiðbeiningunum í notendahandbókinni til að ná sem bestum árangri.

Umbreyta API aðgerðalýsingu
Umbreyta API býður upp á safn aðgerða til að vinna með lita- og myndgögn. Hér að neðan eru nokkrar lykilaðgerðir:

- PCO_ConvertCreate: Búðu til nýtt viðskiptatilvik.
- PCO_ConvertDelete: Eyða umbreytingartilviki.
- PCO_ConvertGet: Fáðu viðskiptastillingar.

Lita- og gervilitabreyting
Pco.convert styður bæði svart og hvítt umbreytingu sem og litabreytingu. Fylgdu sérstökum leiðbeiningum í handbókinni fyrir hverja tegund umbreytinga.

Algengar spurningar

Sp.: Hvernig framkvæmi ég litabreytingu með pco.convert?
- A: Til að framkvæma litabreytingu, notaðu PCO_ConvertGet aðgerðina með viðeigandi breytum eins og lýst er í notendahandbókinni.
Sp.: Get ég eytt viðskiptatilviki?
- A: Já, þú getur eytt viðskiptatilviki með PCO_ConvertDelete aðgerðinni.

notendahandbók
pco.convert

Excelitas PCO GmbH biður þig um að lesa vandlega og fylgja leiðbeiningunum í þessu skjali. Fyrir allar spurningar eða athugasemdir skaltu ekki hika við að hafa samband við okkur hvenær sem er.

síma: + 49 (0) 9441 2005 50

fax: + 49 (0) 9441 2005 20
póstfang: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Þýskalandi
netfang: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
notendahandbók 1.52.0
Gefið út maí 2024
© Höfundarréttur Excelitas PCO GmbH

Þetta verk er með leyfi samkvæmt Creative Commons Attribution-NoDerivatives 4.0 International License. Til view afrit af þessu leyfi, heimsækja http://creativecommons.org/licenses/by-nd/4.0/ eða sendu bréf til Creative Commons, Pósthólf 1866, Mountain View, CA 94042, Bandaríkjunum.

Almennt

Þessa umbreyta SDK lýsingu er hægt að nota til að innleiða PCO umbreytingarrútínuna í sérforritum, sem eru notuð til að stjórna PCO myndavélum. Það er bannað að nota umbreytingarrútínuna með myndavélum þriðja aðila.
The pco.convert sdk samanstendur af tveimur hlutum: LUT umbreytingaraðgerðirnar pco.conv.dll og gluggaaðgerðirnar pco_cdlg.dll .
Umbreytingaraðgerðirnar eru notaðar til að umbreyta gagnasvæðum, svart/hvítt og lit, með upplausn sem er meira en 8 bita á pixla í annað hvort svart/hvítt gagnasvæði með 8 bita upplausn á pixla eða litgagnasvæði með 24 upplausn (32) bitar á pixla. DLL inniheldur einnig aðgerðir til að búa til og fylla hina ýmsu umbreyta hluti.
Seinni hluti API inniheldur gluggaaðgerðirnar. Gluggarnir eru einfaldar GUI gluggar sem gera notandanum kleift að stilla færibreytur umbreyta hlutanna. Valmyndaraðgerðirnar eru innifaldar í pco_cdlg.dll og eru byggðar á sumum aðgerðum pco.conv.dll.
Í pco.sdk fyrir PCO myndavélar eru til tvær samples, sem nýta sér convert sdk. Eitt er Test_cvDlg sample og hitt er sc2_demoið. Endilega kíkið á þær samples til að 'sjá' umbreyta sdk aðgerðirnar í aðgerð.

S/H og gervilitabreyting
Umreikningsreikniritið sem notað er í s/h fallinu er byggt á eftirfarandi einföldu venju

hvar

pos er teljarabreytan
dataout er úttaksgagnasvæðið
datain er inntaksgagnasvæðið

lutbw er gagnasvæði af stærð 2n sem inniheldur LUT, þar sem n = upplausn inntakssvæðisins í bitum á pixla

Í gervilitaaðgerðinni er grunnvenjan til að breyta í RGB gagnasvæði:

hvar

pos er inntaksteljarabreytan
pout er úttaksteljarabreytan

dataout er úttaksgagnasvæðið
datain er inntaksgagnasvæðið
lutbw er gagnasvæði af stærð 2n sem inniheldur LUT, þar sem n = upplausn inntakssvæðisins í bitum á pixla

lutred, lutgreen, lutblue eru gagnasvæði af stærð 2n sem innihalda LUT, þar sem n = upplausn úttakssvæðisins í bitum á pixla.

Color Conversion

CCD litskynjarar sem notaðir eru í PCO litamyndavélum eru með síur fyrir litina rauða, græna og bláa. Hver pixel hefur eina tegund af síu, þannig að upphaflega færðu ekki upplýsingar í fullum lit fyrir hvern pixla. Frekar skilar hver pixla gildi með 12 bita kraftsviði fyrir litinn sem fer framhjá síunni.

Allar litamyndavélar hjá PCO vinna með Bayer-filter DE mósaík. Hægt er að minnka litasíumynstur þessara litamyndflaga í 2×2 fylki. Hægt er að líta á myndflöguna sjálfa sem fylki af þessum 2×2 fylkjum.
Segjum sem svo að þetta litamynstur

Liturinn sjálfur er aðeins túlkun á fylkinu. Þessi túlkun verður gerð með svokölluðu demosaicking algrími. Pco_conv.dll vinnur með sérstakri einkaréttaraðferð.

Umbreyta API aðgerðalýsingu

PCO_ConvertCreate

Lýsing
Býr til nýjan umbreyta hlut byggt á PCO_SensorInfo uppbyggingu. Hið stofnaða umbreytingarhandfang verður notað við umbreytinguna. Vinsamlegast hringdu í PCO_ConvertDelete áður en forritið hættir og afhleður convert dll.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HANDLEIÐ*	Bendi á handfang sem mun taka á móti skapaða umbreyta hlutnum
strSensor	PCO_SensorInfo*	Bendir á upplýsingaskipan skynjara. Vinsamlegast ekki gleyma að stilla wSize færibreytuna.
iConvertType	int	Breytilegt til að ákvarða umbreytingartegundina, annað hvort svart/hvítt, litur, gervilitur eða litur 16

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_ConvertDelete

Lýsing
Eyðir áður búið til umbreyta hlut. Það er skylda að kalla á þessa aðgerð áður en forritinu er lokað.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, villukóði annars.

PCO_ConvertGet

Lýsing
Fær öll gildi áður búið til umbreyta hlut.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstrBreyta	PCO_Convert*	Bendir á pco umbreyta uppbyggingu

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, villukóði annars.

PCO_ConvertSet

Lýsing
Setur nauðsynleg gildi fyrir áður búinn til umbreyta hlut.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstrBreyta	PCO_Convert*	Bendir á pco umbreyta uppbyggingu

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_ConvertGetDisplay

Lýsing
Fær PCO_Display uppbyggingu

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstr Skjár	PCO_Display*	Bendir á pco skjáskipulag

Skilagildi

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstr Skjár	PCO_Display*	Bendir á pco skjáskipulag

PCO_ConvertSetDisplay

Lýsing
Stillir PCO_Display uppbyggingu

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstr Skjár	PCO_Display*	Bendir á pco skjáskipulag

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_ConvertSetBayer

Lýsing
Stillir Bayer uppbyggingu gildi áður búið til umbreyta hlut. Notaðu þessa aðgerð til að breyta Bayer mynsturbreytum.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstrBayer	PCO_Bayer*	Bendir á PCO Bayer uppbyggingu

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_ConvertSetFilter

Lýsing
Stillir síubyggingargildi áður stofnaðs umbreytingarhluts.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
forfilter	PCO_Filter*	Bendir á pco síu uppbyggingu

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_ConvertSetSensorInfo

Lýsing
Stillir PCO_SensorInfo uppbyggingu fyrir áður búinn til umbreyta hlut

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
pstrSensorInfo	PCO_SensorInfo*	Bendir á upplýsingaskipan skynjara. Vinsamlegast ekki gleyma að stilla wSize færibreytuna

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_SetPseudoLut

Lýsing
Hladdu þremur pseudolut litatöflum af söguþræði

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
gervi_lút	óundirritað bleikja *	Bendir á gervi lut litagildi (R,G,B litir: 256 * 3 bæti, eða 4 bæti)
inumcolors	int	Stilltu annað hvort 3 fyrir R,G,B eða 4 fyrir R,G,B,A

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_LoadPseudoLut

Lýsing
Hleður gervilitaupplitstöflu í umbreyta hlutinn. Þessi aðgerð er hægt að nota til að hlaða sumum af fyrirfram skilgreindum eða sjálfbúnum gerviuppflettitöflum.

Frumgerð

Parameter

Nafn Tegund Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
sniði	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenafn	bleikja*	Nafn á file að hlaða

Skilagildi

Nafn Tegund Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
sniði	int	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenafn	bleikja*	Nafn á file að hlaða

PCO_Convert16TO8

Lýsing
Umbreyttu myndgögnum í b16 í 8bita gögn í b8 (grátóna)

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
ham	int	Mode færibreyta
icolmode	int	Litastillingarbreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
b16	orð*	Bendi á hráu myndina
b8	bæti*	Bendir á breytta 8bita svarthvít mynd

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_Convert16TO24

Lýsing
Umbreyttu myndgögnum í b16 í 24bita gögn í b24 (grátóna)

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
ham	int	Mode færibreyta

Nafn	Tegund	Lýsing
icolmode	int	Litastillingarbreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
b16	orð*	Bendi á hráu myndina
b24	bæti*	Bendir á breytta 24bita litamynd

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_Convert16TOCOL

Lýsing
Umbreyttu myndgögnum í b16 í RGB gögn í b8 (lit)

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
ham	int	Mode færibreyta
icolmode	int	Litastillingarbreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
b16	orð*	Bendi á hráu myndina
b8	bæti*	Bendir á breytta 24bita litamynd

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_Convert16TOPSEUDO

Lýsing
Umbreyttu myndgögnum í b16 í gervilitagögn í b8 (litur)

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
ham	int	Mode færibreyta
icolmode	int	Litastillingarbreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
b16	orð*	Bendi á hráu myndina
b8	bæti*	Bendir á breytta 24bita gervilitamynd

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_Convert16TOCOL16

Lýsing
Umbreyttu myndgögnum í b16 í RGB gögn í b16 (lit)

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
ham	int	Mode færibreyta

Nafn	Tegund	Lýsing
icolmode	int	Litastillingarbreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
b16in	orð*	Bendi á hráu myndina
b16 út	orð*	Bendir á breytta 48bita litamynd

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_GetWhiteBalance

Lýsing
Fær hvítjöfnuð gildi fyrir color_tempand tint

Frumgerð

Parameter

Nafn	Tegund	Lýsing
ph	HÖND	Meðhöndla að áður búið til umbreyta hlut
litur_hiti	int*	int bendill til að fá útreiknað litahitastig
blær	int*	int bendill til að fá útreiknað litargildi
ham	int	Mode færibreyta
breidd	int	Breidd myndarinnar sem á að breyta
hæð	int	Hæð myndarinnar sem á að breyta
gb12	ORÐ*	Bendir á hrámyndagagnafylki
x_min	int	Rétthyrningur til að stilla myndsvæðið sem á að nota við útreikning
á_mín	int	Rétthyrningur til að stilla myndsvæðið sem á að nota við útreikning
x_max	int	Rétthyrningur til að stilla myndsvæðið sem á að nota við útreikning
y_max	int	Rétthyrningur til að stilla myndsvæðið sem á að nota við útreikning

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_GetMaxLimit

Lýsing
GetMaxLimit fær RGB gildi fyrir tiltekið hitastig og blær. Hámarksgildið í umbreyta stjórnglugganum má ekki fara yfir stærsta gildi RGB-gildanna, td ef R er stærsta gildið getur hámarksgildið hækkað þar til R gildið nær bitaupplausninni (4095). Sama skilyrði verður að vera uppfyllt til að lækka hámarksgildið, td ef B er lægsta gildið getur hámarksgildið lækkað þar til B gildið nær lágmarksgildinu.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
r_max	fljóta*	Bendir á flot sem fær hámarks rauða gildið
g_max	fljóta*	Bendir á flot sem fær hámarks græna gildi
b_max	fljóta*	Bendir á flot sem fær hámarks bláa gildið
hitastig	fljóta	Litahiti
blær	fljóta	Litastilling
úttaksbitar	int	Bitaupplausn breyttrar myndar (venjulega 8)

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_GetColorValues

Lýsing
Fær litahitastig og blær fyrir gefin R,G,B max gildi.
GetColorValuesis aðeins notað í pco.camware . Það reiknar út litahitastig og blær út frá Rmax,Gmax,Bmax gildum gamla lit lut. Reiknuð gildi eru notuð til að umbreyta gömlum b16 og tif16 myndum með nýju umbreytingarrútínunni.

Frumgerð

Parameter

Nafn	Tegund	Lýsing
pfColorTemp	fljóta*	Bendi á flot til að taka á móti litahitanum
pfColorTemp	fljóta*	Bendi á flot til að taka á móti litblæ
iRedMax	int	Heiltala til að stilla núverandi hámarksgildi fyrir rautt
iGreenMax	int	Heiltala til að stilla núverandi hámarksgildi fyrir grænt.
iBlueMax	int	Heiltala til að stilla núverandi hámarksgildi fyrir blátt

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_WhiteBalanceToDisplayStruct

Lýsing
Reiknar hvítjöfnunina og setur gildin á strDisplaystruct á meðan mörkunum er haldið. Fær struct str Display frá convert Handle innbyrðis

Frumgerð

Parameter

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

PCO_GetVersionInfoPCO_CONV

Lýsing
Skilar útgáfuupplýsingum um dll.

Frumgerð

Parameter

Skilagildi

Nafn	Tegund	Lýsing
ErrorMessage	int	0 ef vel tekst til, annars villukóði.

Dæmigerð útfærsla

Þessi dæmigerða skref fyrir skref útfærslu sýnir grunnmeðhöndlunina

Yfirlýsingar
Stilltu allar biðminni „stærð“ færibreytur á væntanleg gildi:
Stilltu skynjaraupplýsingarnar og búðu til umbreyta hlutinn
Opnaðu valfrjálst umbreytingarglugga
Stilltu lágmarks- og hámarksgildin á viðkomandi svið og stilltu þau á umbreyta hlutinn
Gerðu umbreytinguna og stilltu gögnin á gluggann ef svarglugginn er opinn
Lokaðu valfrjálst opnaði umbreytingarglugganum
Lokaðu umbreyta hlutnum: