EXCELITAS TECHNOLOGIES pco.convert Microscope Camera
Specifikacije
- Naziv proizvoda: pco. pretvoriti
- Verzija: 1.52.0
- Licenca: Creative Commons Attribution-NoDerivatives 4.0Međunarodna licenca
- Proizvođač: Excelitas PCO GmbH
- Adresa: Donaupark 11, 93309 Kelheim, Njemačka
- Kontakt: +49 (0) 9441 2005 50
- Email: pco@excelitas.com
- Webstranica: www.excelitas.com/product-category/pco
Upute za upotrebu proizvoda
Opće informacije
pco.convert nudi različite funkcije za konverziju boja i pseudo boja. Za optimalne performanse važno je slijediti upute u korisničkom priručniku.
Pretvori opis funkcije API-ja
Convert API pruža skup funkcija za manipulaciju podacima o bojama i slikama. Ispod su neke ključne funkcije:
-
- PCO_ConvertCreate: Kreirajte novu instancu konverzije.
- PCO_ConvertDelete: Izbrišite instancu konverzije.
- PCO_ConvertGet: Preuzmite postavke konverzije.
Boja i pseudo konverzija boja
pco.convert podržava i crno-bijelu konverziju, kao i konverziju boja. Slijedite posebne upute u priručniku za svaku vrstu konverzije.
FAQ
- P: Kako da izvršim konverziju boja pomoću pco.convert?
- O: Za izvođenje konverzije boja koristite funkciju PCO_ConvertGet s odgovarajućim parametrima kako je navedeno u korisničkom priručniku.
- P: Mogu li izbrisati instancu konverzije?
- O: Da, možete izbrisati instancu konverzije pomoću funkcije PCO_ConvertDelete.
uputstvo za upotrebu
pco.convert
Excelitas PCO GmbH vas moli da pažljivo pročitate i slijedite upute u ovom dokumentu. Za bilo kakva pitanja ili komentare, slobodno nas kontaktirajte u bilo koje vrijeme.
- telefon: + 49 (0) 9441 2005 50
- faks: + 49 (0) 9441 2005 20
- poštanska adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Njemačka
- email: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
korisnički priručnik 1.52.0
Objavljeno maja 2024
©Autorska prava Excelitas PCO GmbH
Ovo djelo je licencirano pod međunarodnom licencom Creative Commons Attribution-NoDrivatives 4.0. To view kopiju ove licence, posjetite http://creativecommons.org/licenses/by-nd/4.0/ ili pošaljite pismo Creative Commons, PO Box 1866, Mountain View, CA 94042, SAD.
Generale
- Ovaj opis SDK za konverziju može se koristiti za implementaciju rutina PCO konverzije u vlasničke aplikacije, koje se koriste za kontrolu PCO kamera. Zabranjeno je koristiti rutine konverzije sa kamerama trećih strana.
- The pco.convert sdk se sastoji od dva dijela: LUT funkcije konverzije pco.conv.dll i funkcije dijaloga pco_cdlg.dll .
Funkcije konverzije se koriste za pretvaranje područja podataka, crno-belih i boja, s rezolucijom većom od 8 bita po pikselu u crno-bijela područja podataka s rezolucijom od 8 bita po pikselu ili područja podataka u boji s rezolucijom od 24 (32) bita po pikselu. DLL također uključuje funkcije za kreiranje i popunjavanje različitih konvertiranih objekata. - Drugi dio API-ja sadrži funkcije dijaloga. Dijalozi su jednostavni GUI dijalozi koji omogućavaju korisniku da postavi parametre konvertiranih objekata. Funkcije dijaloga su uključene u pco_cdlg.dll i zasnivaju se na nekim funkcijama pco.conv.dll.
- U pco.sdk za pco kamere postoje dva samples, koji koriste konverziju sdk. Jedan je Test_cvDlg sample a drugi je sc2_demo. Molimo pogledajte te samples kako biste 'vidjeli' funkcije convert sdk u akciji.
Č/B i pseudo konverzija boja
Algoritam konverzije koji se koristi u crno-beloj funkciji zasniva se na sljedećoj jednostavnoj rutini
gdje
- pos je varijabla brojača
- dataout je područje izlaznih podataka
- data je područje ulaznih podataka
- lutbw je područje podataka veličine 2n koje sadrži LUT, gdje je n = rezolucija ulaznog područja u bitovima po pikselu
U pseudocolor funkciji osnovna rutina za pretvaranje u RGB područje podataka je:
gdje
- pos je varijabla ulaznog brojača
- pout je varijabla izlaznog brojača
- dataout je područje izlaznih podataka
- data je područje ulaznih podataka
- lutbw je područje podataka veličine 2n koje sadrži LUT, gdje je n = rezolucija ulaznog područja u bitovima po pikselu
- lutred, lutgreen, lutblue su područja podataka veličine 2n koja sadrže LUT, gdje je n = rezolucija izlaznog područja u bitu po pikselu.
Konverzija boja
- CCD senzori boja koji se koriste u PCO kamerama u boji imaju filtere za crvene, zelene i plave boje. Svaki piksel ima jednu vrstu filtera, tako da prvobitno ne dobijate informacije o punoj boji za svaki piksel. Umjesto toga, svaki piksel daje vrijednost s dinamičkim rasponom od 12 bita za boju koja prolazi kroz filter.
- Sve kamere u boji u PCO rade sa Bayer-filter DE mozaikom. Obrazac filtera boja tih senzora slike u boji može se svesti na matricu 2×2. Sam senzor slike se može posmatrati kao matrica tih 2×2 matrica.
- Pretpostavimo ovaj uzorak boja
Sama boja je samo interpretacija matrice. Ova interpretacija će se obaviti takozvanim algoritmom za demozaičenje. Pco_conv.dll radi sa posebnom vlasničkom metodom.
Pretvori opis funkcije API-ja
PCO_ConvertCreate
Opis
Kreira novi objekt pretvaranja na temelju strukture PCO_SensorInfo. Kreirana ručka za pretvaranje će se koristiti tokom konverzije. Pozovite PCO_ConvertDelete prije nego što aplikacija izađe i isprazni konvertirani dll.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA* | Pokazivač na rukohvat koji će primiti kreirani objekt pretvaranja |
| strSensor | PCO_SensorInfo* | Pokazivač na informacijsku strukturu senzora. Molimo ne zaboravite postaviti parametar wSize. |
| iConvertType | int | Varijabla za određivanje vrste konverzije, bilo c/b, boja, pseudo boja ili boja 16 |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_ConvertDelete
Opis
Briše prethodno kreirani objekt pretvaranja. Obavezno je pozvati ovu funkciju prije zatvaranja aplikacije.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, kod greške u suprotnom. |
PCO_ConvertGet
Opis
Dobiva sve vrijednosti prethodno kreiranog objekta konverzije.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrConvert | PCO_Pretvori* | Pokazivač na strukturu pco konverzije |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, kod greške u suprotnom. |
PCO_ConvertSet
Opis
Postavlja potrebne vrijednosti za prethodno kreirani objekt pretvaranja.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrConvert | PCO_Pretvori* | Pokazivač na strukturu pco konverzije |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_ConvertGetDisplay
Opis
Dobiva strukturu PCO_Display
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrDisplay | PCO_Display* | Pokazivač na strukturu pco prikaza |
Povratna vrijednost
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrDisplay | PCO_Display* | Pokazivač na strukturu pco prikaza |
PCO_ConvertSetDisplay
Opis
Postavlja strukturu PCO_Display
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrDisplay | PCO_Display* | Pokazivač na strukturu pco prikaza |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_ConvertSetBayer
Opis
Postavlja vrijednosti Bayerove strukture prethodno kreiranog objekta konverzije. Koristite ove funkcije za promjenu parametara Bayerovog uzorka.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrBayer | PCO_Bayer* | Pokazivač na PCO Bayer strukturu |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_ConvertSetFilter
Opis
Postavlja vrijednosti strukture filtera prethodno kreiranog objekta konverzije.
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| predfilter | PCO_Filter* | Pokazivač na strukturu pco filtera |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_ConvertSetSensorInfo
Opis
Postavlja strukturu PCO_SensorInfo za prethodno kreirani objekt pretvaranja
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pstrSensorInfo | PCO_SensorInfo* | Pokazivač na informacijsku strukturu senzora. Molimo ne zaboravite postaviti parametar wSize |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_SetPseudoLut
Opis
Učitajte tri pseudolut tabele boja dijagrama
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| pseudo_lut | nepotpisani znak * | Pokazivač na pseudo lut vrijednosti boje (R,G,B boje: 256 * 3 bajta, ili 4 bajta) |
| inumcolors | int | Postavite na 3 za R,G,B ili 4 za R,G,B,A |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_LoadPseudoLut
Opis
Učitava tabelu traženja pseudo boja u objekat za konverziju. Ova funkcija se može koristiti za učitavanje nekih od unaprijed definiranih ili samostalno kreiranih pseudo tabela pretraživanja.
Prototip
Parametar
| Ime Tip Opis | ||||||
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju | ||||
| formatu | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| fileime | char* | Ime file učitati | ||||
Povratna vrijednost
| Ime Tip Opis | ||||||
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju | ||||
| formatu | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| fileime | char* | Ime file učitati | ||||
PCO_Pretvori16TO8
Opis
Pretvorite podatke slike u b16 u 8-bitne podatke u b8 (siva skala)
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| način rada | int | Parametar načina rada |
| icolmode | int | Parametar načina rada u boji |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| b16 | riječ* | Pokazivač na sirovu sliku |
| b8 | bajt* | Pokazivač na konvertovanu 8-bitnu crno-belu sliku |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_Pretvori16TO24
Opis
Pretvorite podatke slike u b16 u 24-bitne podatke u b24 (siva skala)
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| način rada | int | Parametar načina rada |
| Ime | Tip | Opis |
| icolmode | int | Parametar načina rada u boji |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| b16 | riječ* | Pokazivač na sirovu sliku |
| b24 | bajt* | Pokazivač na konvertovanu 24-bitnu sliku u boji |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_Pretvori16TOCOL
Opis
Pretvorite podatke slike u b16 u RGB podatke u b8 (boja)
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| način rada | int | Parametar načina rada |
| icolmode | int | Parametar načina rada u boji |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| b16 | riječ* | Pokazivač na sirovu sliku |
| b8 | bajt* | Pokazivač na konvertovanu 24-bitnu sliku u boji |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_Convert16TOPSEUDO
Opis
Pretvorite podatke slike u b16 u pseudo podatke o boji u b8 (boja)
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| način rada | int | Parametar načina rada |
| icolmode | int | Parametar načina rada u boji |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| b16 | riječ* | Pokazivač na sirovu sliku |
| b8 | bajt* | Pokazivač na konvertovanu 24-bitnu sliku u pseudo boji |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_Pretvori16TOCOL16
Opis
Pretvorite podatke slike u b16 u RGB podatke u b16 (boja)
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| način rada | int | Parametar načina rada |
| Ime | Tip | Opis |
| icolmode | int | Parametar načina rada u boji |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| b16in | riječ* | Pokazivač na sirovu sliku |
| b16out | riječ* | Pokazivač na konvertovanu 48-bitnu sliku u boji |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_GetWhiteBalance
Opis
Dobiva vrijednosti izbalansirane bijele boje za nijansu color_tempand
Prototip
Parametar
| Ime | Tip | Opis |
| ph | RUČKA | Rukovati prethodno kreiranom objektu za konverziju |
| color_temp | int* | int pokazivač da dobijete izračunatu temperaturu boje |
| nijansa | int* | int pokazivač da dobijete izračunatu vrijednost nijanse |
| način rada | int | Parametar načina rada |
| širina | int | Širina slike koju treba pretvoriti |
| visina | int | Visina slike koju treba pretvoriti |
| gb12 | RIJEČ* | Pokazivač na niz podataka neobrađenih slika |
| x_min | int | Pravougaonik za postavljanje područja slike koja će se koristiti za izračunavanje |
| y_min | int | Pravougaonik za postavljanje područja slike koja će se koristiti za izračunavanje |
| x_max | int | Pravougaonik za postavljanje područja slike koja će se koristiti za izračunavanje |
| y_max | int | Pravougaonik za postavljanje područja slike koja će se koristiti za izračunavanje |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_GetMaxLimit
Opis
GetMaxLimit dobija RGB vrijednosti za datu temperaturu i nijansu. Maksimalna vrijednost unutar kontrolnog dijaloga konverzije ne smije premašiti najveću vrijednost RGB vrijednosti, npr. u slučaju da je R najveća vrijednost, maksimalna vrijednost se može povećati sve dok vrijednost R ne dosegne bitnu rezoluciju (4095). Isti uslov mora biti ispunjen za smanjenje maksimalne vrijednosti, npr. u slučaju da je B najniža vrijednost, maksimalna vrijednost se može smanjiti sve dok vrijednost B ne dostigne minimalnu vrijednost.
Prototip
Parametar
| Ime | Tip | Opis |
| r_max | plutati* | Pokazivač na float koji prima maksimalnu crvenu vrijednost |
| g_max | plutati* | Pokazivač na float koji prima maksimalnu zelenu vrijednost |
| b_max | plutati* | Pokazivač na float koji prima maksimalnu plavu vrijednost |
| temp | float | Temperatura boje |
| nijansa | float | Podešavanje nijansi |
| izlazni_bitovi | int | Bitna rezolucija konvertirane slike (obično 8) |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_GetColorValues
Opis
Dobiva temperaturu boje i nijansu za date maksimalne vrijednosti R,G,B.
GetColorValuesis se koristi samo u pco.camware . Izračunava temperaturu boje i nijansu na osnovu vrijednosti Rmax,Gmax,Bmax stare lut boje. Izračunate vrijednosti se koriste za pretvaranje starih b16 i tif16 slika s novim rutinama za konverziju.
Prototip
Parametar
| Ime | Tip | Opis |
| pfColorTemp | plutati* | Pokazivač na plovak za primanje temperature boje |
| pfColorTemp | plutati* | Pokazivač na plovak za primanje nijanse boje |
| iRedMax | int | Integer za postavljanje trenutne maksimalne vrijednosti za crvenu |
| iGreenMax | int | Integer za postavljanje trenutne maksimalne vrijednosti za zelenu. |
| iBlueMax | int | Integer za postavljanje trenutne maksimalne vrijednosti za plavo |
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_WhiteBalanceToDisplayStruct
Opis
Izračunava balans bijele boje i postavlja vrijednosti na strDisplaystruct uz zadržavanje ograničenja. Dobiva strukturu str Display iz ručice pretvarača interno
Prototip
Parametar
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
PCO_GetVersionInfoPCO_CONV
Opis
Vraća informacije o verziji dll-a.
Prototip
Parametar
Povratna vrijednost
| Ime | Tip | Opis |
| ErrorMessage | int | 0 u slučaju uspjeha, Errcode u suprotnom. |
Tipična implementacija
Ova tipična implementacija korak po korak pokazuje osnovno rukovanje
- Deklaracije
- Postavite sve parametre 'veličine' bafera na očekivane vrijednosti:
- Postavite informacije o senzoru i kreirajte objekt za konverziju
- Po želji otvorite dijalog za konverziju
- Postavite minimalnu i maksimalnu vrijednost na željeni raspon i postavite ih na objekt pretvaranja
- Izvršite konverziju i postavite podatke u dijalog ako je dijalog otvoren
- Zatvorite opciono otvoreni dijalog za konverziju
- Zatvorite objekat konvertovanja:
Pogledajte Test_cvDlg sample u pco.sdk sample folder. Počevši od v1.20, raspon vrijednosti negativne nijanse je udvostručen.
- poštanska adresa: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Njemačka
- telefon: +49 (0) 9441 2005 0
- e-mail: pco@excelitas.com
- web: www.excelitas.com/pco
Dokumenti / Resursi
 |
EXCELITAS TECHNOLOGIES pco.convert Microscope Camera [pdf] Korisnički priručnik pco.convert Mikroskopska kamera, pco.convert, Mikroskopska kamera, Kamera |
