EXCELITAS TECHNOLOGIES pco.convert Microscope Camera
Specifikācijas
- Produkta nosaukums: pco. konvertēt
- Versija: 1.52.0
- Licence: Creative Commons Attribution-No Derivatives 4.0 International License
- Ražotājs: Excelitas PCO GmbH
- Adrese: Donaupark 11, 93309 Kelheim, Vācija
- Sazināties: +49 (0) 9441 2005 50
- E-pasts: pco@excelitas.com
- Webvietne: www.excelitas.com/product-category/pco
Produkta lietošanas instrukcijas
Vispārīga informācija
Pco.convert piedāvā dažādas funkcijas krāsu un pseido krāsu konvertēšanai. Lai nodrošinātu optimālu veiktspēju, ir svarīgi ievērot lietotāja rokasgrāmatā sniegtos norādījumus.
Konvertēt API funkcijas aprakstu
Konvertēt API nodrošina funkciju kopumu, lai manipulētu ar krāsu un attēlu datiem. Tālāk ir norādītas dažas galvenās funkcijas:
-
- PCO_ConvertCreate: Izveidojiet jaunu reklāmguvuma gadījumu.
- PCO_ConvertDelete: Dzēst reklāmguvuma gadījumu.
- PCO_ConvertGet: Iegūstiet reklāmguvumu iestatījumus.
Krāsu un pseido krāsu konvertēšana
Pco.convert atbalsta gan melnbalto, gan krāsu konvertēšanu. Izpildiet norādījumus, kas sniegti rokasgrāmatā katram konversijas veidam.
FAQ
- J: Kā veikt krāsu konvertēšanu, izmantojot pco.convert?
- A: Lai veiktu krāsu konvertēšanu, izmantojiet funkciju PCO_ConvertGet ar atbilstošiem parametriem, kā norādīts lietotāja rokasgrāmatā.
- J: Vai es varu izdzēst reklāmguvuma gadījumu?
- A: Jā, varat dzēst reklāmguvuma gadījumu, izmantojot funkciju PCO_ConvertDelete.
lietotāja rokasgrāmata
pco.convert
Excelitas PCO GmbH lūdz rūpīgi izlasīt un ievērot šajā dokumentā sniegtos norādījumus. Ja jums ir kādi jautājumi vai komentāri, lūdzu, sazinieties ar mums jebkurā laikā.
- tālrunis: + 49 (0) 9441 2005 50
- fakss: + 49 (0) 9441 2005 20
- pasta adrese: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Vācija
- e-pasts: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
lietotāja rokasgrāmata 1.52.0
Izlaists 2024. gada maijā
©Autortiesības Excelitas PCO GmbH
Šis darbs ir licencēts saskaņā ar Creative Commons Attribution-NoDerivatives 4.0 starptautisko licenci. Uz view šīs licences kopiju, apmeklējiet http://creativecommons.org/licenses/by-nd/4.0/ vai nosūtiet vēstuli uz Creative Commons, PO Box 1866, Mountain View, CA 94042, ASV.
Ģenerālis
- Šo konvertēšanas SDK aprakstu var izmantot, lai ieviestu PCO konvertēšanas rutīnas patentētās lietojumprogrammās, kuras izmanto PCO kameru vadīšanai. Ir aizliegts izmantot konvertēšanas rutīnas ar trešo pušu kamerām.
- The pco.convert sdk sastāv no divām daļām: LUT konvertēšanas funkcijas pco.conv.dll un dialoga funkcijas pco_cdlg.dll .
Konversijas funkcijas tiek izmantotas, lai pārveidotu melnbaltu un krāsu datu apgabalus ar izšķirtspēju vairāk nekā 8 biti uz pikseļu melnbaltos datu apgabalos ar izšķirtspēju 8 biti uz pikseli vai krāsu datu apgabalus ar izšķirtspēju 24 biti. (32) biti pikselī. DLL ietver arī funkcijas, lai izveidotu un aizpildītu dažādus konvertēšanas objektus. - API otrajā daļā ir dialoga funkcijas. Dialoglodziņi ir vienkārši GUI dialoglodziņi, kas ļauj lietotājam iestatīt konvertējamo objektu parametrus. Dialoga funkcijas ir iekļautas pco_cdlg.dll un ir balstīti uz dažām pco.conv.dll funkcijām.
- In pco.sdk PCO kamerām pastāv divas samples, kas izmanto konvertēšanas sdk. Viens no tiem ir Test_cvDlg sample un otrs ir sc2_demo. Lūdzu, apskatiet tos samples, lai “redzētu” konvertēšanas sdk funkcijas darbībā.
B/W un pseido krāsu pārveidošana
B/w funkcijā izmantotais konversijas algoritms ir balstīts uz šādu vienkāršo rutīnu
kur
- pos ir skaitītāja mainīgais
- dataout ir izvaddatu apgabals
- datain ir ievades datu apgabals
- lutbw ir 2n izmēra datu apgabals, kas satur LUT, kur n = ievades apgabala izšķirtspēja bitos uz pikseļu
Pseidokrāsu funkcijā pamata rutīna, lai pārveidotu par RGB datu apgabalu, ir:
kur
- pos ir ievades skaitītāja mainīgais
- pout ir izejas skaitītāja mainīgais
- dataout ir izvaddatu apgabals
- datain ir ievades datu apgabals
- lutbw ir 2n izmēra datu apgabals, kas satur LUT, kur n = ievades apgabala izšķirtspēja bitos uz pikseļu
- lutred, lutgreen, lutblue ir datu apgabali ar izmēru 2n, kas satur LUT, kur n = izvades apgabala izšķirtspēja bitos uz pikseļu.
Krāsu konvertēšana
- CCD krāsu sensoriem, ko izmanto PCO krāsu kamerās, ir filtri sarkanai, zaļai un zilai krāsai. Katram pikselim ir viena veida filtrs, tāpēc sākotnēji jūs nesaņemat pilnu krāsu informāciju par katru pikseļu. Drīzāk katrs pikselis nodrošina vērtību ar 12 bitu dinamisko diapazonu krāsai, kas iztur filtru.
- Visas PCO krāsu kameras darbojas ar Bayer filtra DE mozaīku. Šo krāsu attēla sensoru krāsu filtra modeli var samazināt līdz 2 × 2 matricai. Pašu attēla sensoru var uzskatīt par šo 2 × 2 matricu matricu.
- Pieņemsim, ka šis krāsu modelis
Pati krāsa ir tikai matricas interpretācija. Šī interpretācija tiks veikta ar tā saukto demosaicking algoritmu. Pco_conv.dll darbojas ar īpašu patentētu metodi.
Konvertēt API funkcijas aprakstu
PCO_ConvertCreate
Apraksts
Izveido jaunu konvertēšanas objektu, pamatojoties uz PCO_SensorInfo struktūru. Izveidotais konvertēšanas rokturis tiks izmantots konvertēšanas laikā. Lūdzu, zvaniet PCO_ConvertDelete, pirms lietojumprogramma iziet un izlādē konvertēšanas dll.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKTURIS* | Norādiet uz turi, kas saņems izveidoto konvertēšanas objektu |
strSensors | PCO_SensorInfo* | Rādītājs uz sensora informācijas struktūru. Lūdzu, neaizmirstiet iestatīt parametru wSize. |
iConvertType | starpt | Mainīgais, lai noteiktu konversijas veidu — melnbalts, krāsa, pseido krāsa vai krāsa 16 |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertDelete
Apraksts
Dzēš iepriekš izveidotu konvertēšanas objektu. Pirms lietojumprogrammas aizvēršanas šī funkcija ir obligāti jāizsauc.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertGet
Apraksts
Iegūst visas iepriekš izveidotā konvertēšanas objekta vērtības.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrConvert | PCO_Convert* | Rādītājs uz PCO konvertēšanas struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertSet
Apraksts
Iestata nepieciešamās vērtības iepriekš izveidotam konvertēšanas objektam.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrConvert | PCO_Convert* | Rādītājs uz PCO konvertēšanas struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertGetDisplay
Apraksts
Iegūst PCO_Display struktūru
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrDisplejs | PCO_Display* | Rādītājs uz PCO displeja struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrDisplejs | PCO_Display* | Rādītājs uz PCO displeja struktūru |
PCO_ConvertSetDisplay
Apraksts
Iestata PCO_Display struktūru
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrDisplejs | PCO_Display* | Rādītājs uz PCO displeja struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertSetBayer
Apraksts
Iestata iepriekš izveidotā konvertēšanas objekta Bayer struktūras vērtības. Izmantojiet šīs funkcijas, lai mainītu Bayer modeļa parametrus.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrBayer | PCO_Bayer* | Rādītājs uz PCO Bayer struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertSetFilter
Apraksts
Iestata iepriekš izveidotā konvertēšanas objekta filtra struktūras vērtības.
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
priekšfiltrs | PCO_Filter* | Rādītājs uz PCO filtra struktūru |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_ConvertSetSensorInfo
Apraksts
Iestata PCO_SensorInfo struktūru iepriekš izveidotam konvertēšanas objektam
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pstrSensorInfo | PCO_SensorInfo* | Rādītājs uz sensora informācijas struktūru. Lūdzu, neaizmirstiet iestatīt parametru wSize |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_SetPseudoLut
Apraksts
Ielādējiet trīs sižeta pseidolu krāsu tabulas
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
pseido_lut | neparakstīta rakstzīme * | Rādītājs uz pseido lut krāsu vērtībām (R, G, B krāsas: 256 * 3 baiti vai 4 baiti) |
inumcolors | starpt | Iestatiet vai nu 3, lai R,G,B vai 4 R,G,B,A |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_LoadPseudoLut
Apraksts
Konvertējamam objektam tiek ielādēta pseido krāsu uzmeklēšanas tabula. Šo funkciju var izmantot, lai ielādētu dažas iepriekš definētas vai paša izveidotas pseidouzmeklēšanas tabulas.
Prototips
Parametrs
Vārds Veids Apraksts | ||||||
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu | ||||
formātā | starpt | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
filenosaukums | char* | Nosaukums file ielādēt |
Atdeves vērtība
Vārds Veids Apraksts | ||||||
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu | ||||
formātā | starpt | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
filenosaukums | char* | Nosaukums file ielādēt |
PCO_Convert16TO8
Apraksts
Konvertēt attēla datus b16 uz 8 bitu datiem b8 (pelēktoņu)
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
režīmā | starpt | Režīma parametrs |
icolmode | starpt | Krāsu režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
b16 | vārds* | Norādiet uz neapstrādātu attēlu |
b8 | baits* | Rādītājs uz pārveidotu 8 bitu melnbaltu attēlu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_Convert16TO24
Apraksts
Konvertēt attēla datus b16 uz 24 bitu datiem b24 (pelēktoņu)
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
režīmā | starpt | Režīma parametrs |
Vārds | Tips | Apraksts |
icolmode | starpt | Krāsu režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
b16 | vārds* | Norādiet uz neapstrādātu attēlu |
b24 | baits* | Rādītājs uz konvertētu 24 bitu krāsu attēlu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_Convert16TOCOL
Apraksts
Konvertēt attēla datus b16 uz RGB datiem b8 (krāsu)
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
režīmā | starpt | Režīma parametrs |
icolmode | starpt | Krāsu režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
b16 | vārds* | Norādiet uz neapstrādātu attēlu |
b8 | baits* | Rādītājs uz konvertētu 24 bitu krāsu attēlu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_Convert16TOPSEUDO
Apraksts
Pārvērst attēla datus b16 uz pseido krāsu datiem b8 (krāsu)
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
režīmā | starpt | Režīma parametrs |
icolmode | starpt | Krāsu režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
b16 | vārds* | Norādiet uz neapstrādātu attēlu |
b8 | baits* | Rādītājs uz pārveidotu 24 bitu pseido krāsu attēlu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_Convert16TOCOL16
Apraksts
Konvertēt attēla datus b16 uz RGB datiem b16 (krāsu)
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
režīmā | starpt | Režīma parametrs |
Vārds | Tips | Apraksts |
icolmode | starpt | Krāsu režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
b16 collas | vārds* | Norādiet uz neapstrādātu attēlu |
b16out | vārds* | Rādītājs uz konvertētu 48 bitu krāsu attēlu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_GetWhiteBalance
Apraksts
Iegūst baltās krāsas līdzsvarotās vērtības color_tempand tint
Prototips
Parametrs
Vārds | Tips | Apraksts |
ph | ROKASGRĀMATA | Rokturis uz iepriekš izveidotu konvertēšanas objektu |
krāsas_temp | int* | int rādītājs, lai iegūtu aprēķināto krāsu temperatūru |
nokrāsu | int* | int rādītājs, lai iegūtu aprēķināto nokrāsas vērtību |
režīmā | starpt | Režīma parametrs |
platums | starpt | Konvertējamā attēla platums |
augstums | starpt | Konvertējamā attēla augstums |
GB12 | VĀRDS* | Rādītājs uz neapstrādātu attēla datu masīvu |
x_min | starpt | Taisnstūris, lai iestatītu aprēķinos izmantojamo attēla apgabalu |
y_min | starpt | Taisnstūris, lai iestatītu aprēķinos izmantojamo attēla apgabalu |
x_max | starpt | Taisnstūris, lai iestatītu aprēķinos izmantojamo attēla apgabalu |
y_maks | starpt | Taisnstūris, lai iestatītu aprēķinos izmantojamo attēla apgabalu |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_GetMaxLimit
Apraksts
GetMaxLimit iegūst RGB vērtības noteiktai temperatūrai un nokrāsai. Maksimālā vērtība konvertēšanas vadības dialoglodziņā nedrīkst pārsniegt lielāko RGB vērtību vērtību, piemēram, ja R ir lielākā vērtība, maksimālā vērtība var palielināties, līdz R vērtība sasniedz bitu izšķirtspēju (4095). Tāds pats nosacījums ir jāizpilda, lai samazinātu maksimālo vērtību, piemēram, ja B ir mazākā vērtība, maksimālā vērtība var samazināties, līdz B vērtība sasniedz minimālo vērtību.
Prototips
Parametrs
Vārds | Tips | Apraksts |
r_maks | peldēt* | Norādiet uz pludiņu, kas saņem maksimālo sarkano vērtību |
g_max | peldēt* | Norādiet uz pludiņu, kas saņem maksimālo zaļo vērtību |
b_maks | peldēt* | Norādiet uz pludiņu, kas saņem maksimālo zilo vērtību |
temp | peldēt | Krāsu temperatūra |
nokrāsu | peldēt | Toņu iestatīšana |
izvades_biti | starpt | Konvertētā attēla bitu izšķirtspēja (parasti 8) |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_GetColorValues
Apraksts
Iegūst krāsu temperatūru un nokrāsu noteiktām R,G,B max vērtībām.
GetColorValuesis tiek izmantots tikai pco.camware . Tas aprēķina krāsu temperatūru un nokrāsu, pamatojoties uz vecās krāsas lut Rmax, Gmax, Bmax vērtībām. Aprēķinātās vērtības tiek izmantotas veco b16 un tif16 attēlu konvertēšanai ar jaunajām konvertēšanas rutīnām.
Prototips
Parametrs
Vārds | Tips | Apraksts |
pfColorTemp | peldēt* | Rādītājs uz pludiņu krāsu temperatūras uztveršanai |
pfColorTemp | peldēt* | Rādītājs uz pludiņu krāsas nokrāsas saņemšanai |
iRedMax | starpt | Vesels skaitlis, lai iestatītu pašreizējo maksimālo sarkanās krāsas vērtību |
iGreenMax | starpt | Vesels skaitlis, lai iestatītu pašreizējo maksimālo zaļās krāsas vērtību. |
iBlueMax | starpt | Vesels skaitlis, lai iestatītu pašreizējo maksimālo zilās krāsas vērtību |
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_WhiteBalanceToDisplayStruct
Apraksts
Aprēķina baltā balansu un iestata vērtības strDisplaystruct, vienlaikus saglabājot ierobežojumus. Iegūst struct str displeju no konvertēšanas roktura iekšēji
Prototips
Parametrs
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
PCO_GetVersionInfoPCO_CONV
Apraksts
Atgriež versijas informāciju par dll.
Prototips
Parametrs
Atdeves vērtība
Vārds | Tips | Apraksts |
Kļūdas ziņojums | starpt | 0 veiksmes gadījumā, kļūdas kods pretējā gadījumā. |
Tipiska ieviešana
Šī tipiskā soli pa solim ieviešana parāda pamata apstrādi
- Deklarācijas
- Iestatiet visiem bufera “size” parametriem paredzētās vērtības:
- Iestatiet sensora informācijas parametrus un izveidojiet konvertēšanas objektu
- Pēc izvēles atveriet konvertēšanas dialoglodziņu
- Iestatiet minimālo un maksimālo vērtību vajadzīgajā diapazonā un iestatiet tos konvertēšanas objektam
- Veiciet konvertēšanu un iestatiet datus dialoglodziņā, ja dialoglodziņš ir atvērts
- Aizveriet pēc izvēles atvērto konvertēšanas dialoglodziņu
- Aizveriet konvertēšanas objektu:
Skatiet Test_cvDlg sample in pco.sdk sample mape. Sākot ar versiju 1.20, negatīvās nokrāsas vērtības diapazons ir dubultots.
- pasta adrese: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Vācija
- telefons: +49 (0) 9441 2005 0
- e-pasts: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumenti / Resursi
![]() |
EXCELITAS TECHNOLOGIES pco.convert Microscope Camera [pdfLietotāja rokasgrāmata pco.convert Microscope Camera, pco.convert, Microscope Camera, Camera |