EXCELITAS TECHNOLOGIES pco.convert Microscope Camera
Specificazioni
- Nome di u produttu: pc. cunvertisce
- Versione: 1.52.0
- Licenza: Creative Commons Attribution-NoDerivatives 4.0Licenza Internaziunale
- Produttore: Excelitas PCO GmbH
- Indirizzu: Donaupark 11, 93309 Kelheim, Germania
- Cuntattu: +49 (0) 9441 2005 50
- E-mail: pco@excelitas.com
- Websitu: www.excelitas.com/product-category/pco
Istruzzioni per l'usu di u produttu
Informazione generale
U pco.convert offre diverse funzioni per a cunversione di culore è pseudocolore. Hè impurtante di seguità l'istruzzioni furnite in u manuale d'utilizatore per un rendiment ottimali.
Cunvertite a Descrizione di a Funzione API
L'API Converti furnisce un inseme di funzioni per manipulà i dati di culore è di l'imaghjini. Quì sottu sò alcune funzioni chjave:
-
- PCO_ConvertCreate: Crea una nova istanza di cunversione.
- PCO_ConvertDelete: Sguassà una istanza di cunversione.
- PCO_ConvertGet: Ottene paràmetri di cunversione.
Cunversione di culore è pseudocolore
U pco.convert sustegnu tramindui cunversione neru è biancu oltri cunversione culore. Segui l'istruzzioni specifiche furnite in u manuale per ogni tipu di cunversione.
FAQ
- Q: Cumu fà una cunversione di culore cù pco.convert?
- A: Per fà una cunversione di culore, utilizate a funzione PCO_ConvertGet cù i paràmetri appropritati cum'è delineatu in u manuale d'utilizatore.
- Q: Puderaghju sguassà una istanza di cunversione?
- A: Iè, pudete sguassà una istanza di cunversione cù a funzione PCO_ConvertDelete.
manuale d'usu
pco.cunvertisce
Excelitas PCO GmbH vi dumanda di leghje attentamente è seguità l'istruzzioni in stu documentu. Per qualsiasi dumande o cumenti, sentite liberu di cuntattateci in ogni mumentu.
- telefonu: + 49 (0) 9441 2005 50
- fax: + 49 (0) 9441 2005 20
- indirizzu postale: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germania
- email: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.cunvertisce
manuale d'uso 1.52.0
Sorti in maghju 2024
©Copyright Excelitas PCO GmbH
Stu travagliu hè licenziatu sottu a Creative Commons Attribution-NoDerivatives 4.0 International License. À view una copia di sta licenza, visita http://creativecommons.org/licenses/by-nd/4.0/ o mandate una lettera à Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
Generale
- Questa descrizzione di u SDK di cunversione pò esse aduprata per implementà e rutine di cunversione PCO in applicazioni proprietarie, chì sò aduprate per cuntrullà e camere PCO. Hè pruibitu d'utilizà e rutina di cunvertisce cù camere di terze parti.
- U pco.cunvertisce sdk hè custituitu di duie parti: E funzioni di cunversione LUT pco.conv.dll è e funzioni di dialogu pco_cdlg.dll .
E funzioni di cunversione sò aduprate per cunvertisce zoni di dati, b/n è culore, cù una risuluzione di più di 8 bit per pixel à e zone di dati b/w cù una risuluzione di 8 bit per pixel o zoni di dati di culore cù una risoluzione di 24 (32) bit per pixel. A DLL include ancu funzioni per creà è riempie i diversi oggetti cunvertiti. - A seconda parte di l'API cuntene e funzioni di dialogu. I dialoghi sò dialoghi GUI simplici chì permettenu à l'utilizatore per stabilisce i paràmetri di l'uggetti cunvertiti. E funzioni di dialogu sò incluse in u pco_cdlg.dll è sò basati nantu à alcune funzioni di u pco.conv.dll.
- In u pco.sdk per pco cameras ci sò dui samples, chì facenu usu di u cunvertitu sdk. Unu hè u Test_cvDlg sample è l'altru hè u sc2_demo. Per piacè fate un ochju à quelli samples in ordine per 'vede' e funzioni sdk di cunversione in azzione.
Cunversione B/N è pseudocolore
L'algoritmu di cunversione utilizatu in a funzione b/w hè basatu annantu à a seguente rutina simplice
induve
- pos hè a variabile contatore
- dataout hè l'area di dati di output
- datain hè l'area di dati di input
- lutbw hè una zona di dati di dimensione 2n chì cuntene a LUT, induve n = risoluzione di l'area di input in bit per pixel
In a funzione pseudocolor, a rutina basica per cunvertisce in una zona di dati RGB hè:
induve
- pos hè a variabile di u contatore di input
- pout hè a variabile di u contatore di output
- dataout hè l'area di dati di output
- datain hè l'area di dati di input
- lutbw hè una zona di dati di dimensione 2n chì cuntene a LUT, induve n = risoluzione di l'area di input in bit per pixel
- lutred, lutgreen, lutblue sò spazii di dati di dimensione 2n chì cuntenenu a LUT, induve n = risoluzione di l'area di output in bit per pixel.
Cunversione di culore
- I sensori di culore CCD utilizati in e camere di culore PCO anu filtri per i culori rossi, verdi è blu. Ogni píxel hà un tipu di filtru, cusì urigginariamente ùn avete micca infurmazione di culore cumpletu per ogni pixel. Piuttostu, ogni pixel furnisce un valore cù una gamma dinamica di 12 bits per u culore chì passa u filtru.
- Tutte e camere di culore in PCO travaglianu cù u mosaicing DE Bayer-filter. U mudellu di filtru di culore di quelli sensori di l'imagine di culore pò esse ridutta à una matrice 2 × 2. U sensoru di l'imaghjini stessu pò esse vistu cum'è una matrice di quelli matrici 2 × 2.
- Suppone chì stu mudellu di culore
U culore stessu hè solu una interpretazione di a matrice. Questa interpretazione serà fatta da un algoritmu chjamatu demosaicking. U pco_conv.dll travaglia cù un metudu propiu particulare.
Cunvertite a Descrizione di a Funzione API
PCO_ConvertCreate
Descrizzione
Crea un novu oggettu cunvertitu basatu annantu à a struttura PCO_SensorInfo. U manicu di cunversione creatu serà utilizatu durante a cunversione. Per piacè chjamate PCO_ConvertDelete prima chì l'applicazione esce è scarica a dll di cunversione.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANICO* | Puntatore à un manicu chì riceverà l'ughjettu cunvertitu creatu |
| strSensor | PCO_SensorInfo* | Puntatore à una struttura d'infurmazione di sensori. Per piacè ùn vi scurdate di stabilisce u paràmetru wSize. |
| iConvertType | int | Variabile per determinà u tipu di cunversione, sia b/n, culore, pseudocolore o culore 16 |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_ConvertDelete
Descrizzione
Elimina un oggettu di cunversione creatu prima. Hè ubligatoriu per chjamà sta funzione prima di chjude l'applicazione.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, codice Errore altrimenti. |
PCO_ConvertGet
Descrizzione
Ottiene tutti i valori di un oggettu di cunversione creatu prima.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrConvertite | PCO_Convertisce* | Puntatore à una struttura di cunversione pco |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, codice Errore altrimenti. |
PCO_ConvertSet
Descrizzione
Pone i valori necessarii per un oggettu di cunversione creatu prima.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrConvertite | PCO_Convertisce* | Puntatore à una struttura di cunversione pco |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_ConvertGetDisplay
Descrizzione
Ottene a struttura PCO_Display
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrDisplay | PCO_Display* | Puntatore à una struttura di visualizazione pco |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrDisplay | PCO_Display* | Puntatore à una struttura di visualizazione pco |
PCO_ConvertSetDisplay
Descrizzione
Stabilisce a struttura PCO_Display
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrDisplay | PCO_Display* | Puntatore à una struttura di visualizazione pco |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_ConvertSetBayer
Descrizzione
Stabilisce i valori di struttura Bayer di un oggettu cunvertitu creatu prima. Aduprate queste funzioni per cambià i paràmetri di u mudellu Bayer.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrBayer | PCO_Bayer* | Puntatore à una struttura PCO Bayer |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_ConvertSetFilter
Descrizzione
Stabilisce i valori di a struttura di filtru di un oggettu cunvertitu creatu prima.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| prefiltru | PCO_Filter* | Puntatore à una struttura di filtru pco |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_ConvertSetSensorInfo
Descrizzione
Stabilisce a struttura PCO_SensorInfo per un oggettu di cunversione creatu prima
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pstrSensorInfo | PCO_SensorInfo* | Puntatore à una struttura d'infurmazione di sensori. Per piacè ùn vi scurdate di stabilisce u paràmetru wSize |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_SetPseudoLut
Descrizzione
Caricà e trè tavule di culore pseudolut di a trama
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| pseudo_lut | char signatu * | Puntatore à i valori di culore di pseudolut (colori R, G, B: 256 * 3 bytes, o 4 bytes) |
| inumcolors | int | Impostate à 3 per R,G,B o 4 per R,G,B,A |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_LoadPseudoLut
Descrizzione
Carica una pseudo tabella di ricerca di culore à l'ughjettu cunvertitu. Questa funzione pò esse usata per carricà alcune di e pseudotavule di ricerca predefinite o autocreate.
Prototipu
Parametru
| Nome Descrizzione di u tipu | ||||||
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima | ||||
| furmatu | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenomu | char* | Nome di u file à carica | ||||
Riturnà u valore
| Nome Descrizzione di u tipu | ||||||
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima | ||||
| furmatu | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenomu | char* | Nome di u file à carica | ||||
PCO_Convert16TO8
Descrizzione
Cunvertisce dati di stampa in b16 in dati 8bit in b8 (scala di grigi)
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| modu | int | Parametru di modu |
| icolmode | int | Parametru di modalità di culore |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| b16 | parolla * | Puntatore à l'imaghjini prima |
| b8 | byte* | Puntatore à l'immagine cunvertita 8bit b/n |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_Convert16TO24
Descrizzione
Cunvertisce dati di stampa in b16 in dati 24bit in b24 (scala di grigi)
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| modu | int | Parametru di modu |
| Nome | Tipu | Descrizzione |
| icolmode | int | Parametru di modalità di culore |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| b16 | parolla * | Puntatore à l'imaghjini prima |
| b24 | byte* | Puntatore à l'imaghjini di culore cunvertiti di 24 bit |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_Convert16TOCOL
Descrizzione
Cunvertisce dati di stampa in b16 in dati RGB in b8 (culore)
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| modu | int | Parametru di modu |
| icolmode | int | Parametru di modalità di culore |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| b16 | parolla * | Puntatore à l'imaghjini prima |
| b8 | byte* | Puntatore à l'imaghjini di culore cunvertiti di 24 bit |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_Convert16TOPSEUDO
Descrizzione
Cunvertite i dati di l'immagine in b16 in pseudo dati di culore in b8 (culore)
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| modu | int | Parametru di modu |
| icolmode | int | Parametru di modalità di culore |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| b16 | parolla * | Puntatore à l'imaghjini prima |
| b8 | byte* | Puntatore à l'imaghjini pseudocolori di 24 bit cunvertiti |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_Convert16TOCOL16
Descrizzione
Cunvertisce dati di stampa in b16 in dati RGB in b16 (culore)
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| modu | int | Parametru di modu |
| Nome | Tipu | Descrizzione |
| icolmode | int | Parametru di modalità di culore |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| b16in | parolla * | Puntatore à l'imaghjini prima |
| b16 fora | parolla * | Puntatore à l'imaghjini di culore cunvertiti di 48 bit |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_GetWhiteBalance
Descrizzione
Ottiene valori di equilibriu biancu per color_tempand tint
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| ph | MANU | Maneggiate à un oggettu di cunversione creatu prima |
| culore_temp | int* | int pointer per ottene a temperatura di culore calculata |
| tinta | int* | int pointer per ottene u valore di tinta calculatu |
| modu | int | Parametru di modu |
| larghezza | int | Larghezza di l'imagine da cunvertisce |
| altezza | int | Altezza di l'imagine per cunvertisce |
| gb12 | PAROLA* | Puntatore à una matrice di dati di stampa cruda |
| x_min | int | Rectangle per stabilisce a regione di l'imaghjini da esse aduprata per u calculu |
| y_min | int | Rectangle per stabilisce a regione di l'imaghjini da esse aduprata per u calculu |
| x_max | int | Rectangle per stabilisce a regione di l'imaghjini da esse aduprata per u calculu |
| y_max | int | Rectangle per stabilisce a regione di l'imaghjini da esse aduprata per u calculu |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_GetMaxLimit
Descrizzione
GetMaxLimit riceve i valori RGB per una determinata temperatura è tinta. U valore massimu in u dialogu di cuntrollu di cunversione ùn deve micca superà u valore più grande di i valori RGB, per esempiu, in casu R hè u valore più grande, u valore massimu pò aumentà finu à chì u valore R tocca a risoluzione di bit (4095). A stessa cundizione deve esse cumpletata per diminuisce u valore massimu, per esempiu, in casu B hè u valore più bassu, u valore massimu pò diminuisce finu à chì u valore B tocca u valore min.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| r_max | float* | Puntatore à un float chì riceve u valore rossu massimu |
| g_max | float* | Puntatore à un float chì riceve u valore massimu di verde |
| b_max | float* | Puntatore à un float chì riceve u valore massimu blu |
| temp | float | Temperature di culore |
| tinta | float | Impostazione di tinta |
| output_bits | int | Risoluzione di bit di l'imaghjini cunvertiti (di solitu 8) |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_GetColorValues
Descrizzione
Ottene a temperatura di u culore è a tinta per i valori R, G, B max dati.
GetColorValues hè utilizatu solu in pco.camware . Calcula a temperatura di u culore è a tinta in basa di i valori Rmax, Gmax, Bmax di l'antica lut di culore. I valori calculati sò usati per cunvertisce vechji b16 è tif16 imagine cù e novi rutine di cunversione.
Prototipu
Parametru
| Nome | Tipu | Descrizzione |
| pfColorTemp | float* | Puntatore à un float per riceve a temperatura di u culore |
| pfColorTemp | float* | Puntatore à un float per riceve a tinta di culore |
| iRedMax | int | Integer per stabilisce u valore massimu attuale per u rossu |
| iGreenMax | int | Integer per stabilisce u valore massimu attuale per u verde. |
| iBlueMax | int | Integer per stabilisce u valore massimu attuale per u blu |
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_WhiteBalanceToDisplayStruct
Descrizzione
Calcule u bilanciu biancu è stabilisce i valori à u strDisplaystruct mantenendu i limiti. Ottiene a struct str Display da a cunversione Handle internamente
Prototipu
Parametru
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
PCO_GetVersionInfoPCO_CONV
Descrizzione
Ritorna l'infurmazioni di versione nantu à a dll.
Prototipu
Parametru
Riturnà u valore
| Nome | Tipu | Descrizzione |
| ErrorMessage | int | 0 in casu di successu, Errorcode altrimenti. |
Implementazione tipica
Questa implementazione tipica passu per passu mostra a gestione basica
- Dichjarazioni
- Pone tutti i paràmetri di "taglia" di u buffer à i valori previsti:
- Definite i paràmetri di l'infurmazioni di u sensoru è creanu l'ughjettu cunvertitu
- Opzionalmente apre un dialogu di cunversione
- Pone u valore min è max à l'intervallu desideratu è mette à l'ughjettu cunvertitu
- Fate a cunversione è stabilisce i dati à u dialogu se u dialogu hè apertu
- Chiudi u dialogu di cunversione opzionale apertu
- Chiudi l'ughjettu cunvertitu:
Vede u Test_cvDlg sample in u pco.sdk sampu cartulare. Partendu cù v1.20, a gamma di u valore di tintu negativu hè stata radduppiata.
- indirizzu postale: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germania
- telefonu: +49 (0) 9441 2005 0
- e-mail: pco@excelitas.com
- web: www.excelitas.com/pco
Documenti / Risorse
 |
EXCELITAS TECHNOLOGIES pco.convert Microscope Camera [pdfManuale d'usu pco.convert Microscope Camera, pco.convert, Microscope Camera, Camera |
