EXCELITAS TECHNOLOGIES pco.convert Càmera de microscopi
Especificacions
- Nom del producte: pco. convertir
- Versió: 1.52.0
- Llicència: Creative Commons Reconeixement-Sense Derivades 4.0 Llicència Internacional
- Fabricant: Excelitas PCO GmbH
- Adreça: Donaupark 11, 93309 Kelheim, Alemanya
- Contacte: +49 (0) 9441 2005 50
- Correu electrònic: pco@excelitas.com
- Weblloc: www.excelitas.com/product-category/pco
Instruccions d'ús del producte
Informació general
El pco.convert ofereix diverses funcions per a la conversió de color i pseudocolor. És important seguir les instruccions proporcionades al manual d'usuari per obtenir un rendiment òptim.
Converteix la descripció de la funció de l'API
L'API Convert proporciona un conjunt de funcions per manipular dades de color i imatges. A continuació es mostren algunes funcions clau:
-
- PCO_ConvertCreate: Creeu una instància de conversió nova.
- PCO_ConvertDelete: Suprimiu una instància de conversió.
- PCO_ConvertGet: Obteniu la configuració de conversió.
Conversió de color i pseudocolor
El pco.convert admet tant la conversió en blanc i negre com la conversió de color. Seguiu les instruccions específiques proporcionades al manual per a cada tipus de conversió.
Preguntes freqüents
- P: Com puc fer una conversió de color amb pco.convert?
- R: Per realitzar una conversió de color, utilitzeu la funció PCO_ConvertGet amb els paràmetres adequats tal com s'indica al manual d'usuari.
- P: Puc suprimir una instància de conversió?
- R: Sí, podeu suprimir una instància de conversió mitjançant la funció PCO_ConvertDelete.
manual d'usuari
pco.convert
Excelitas PCO GmbH us demana que llegiu i seguiu atentament les instruccions d'aquest document. Per a qualsevol pregunta o comentari, no dubteu a posar-vos en contacte amb nosaltres en qualsevol moment.
- telèfon: + 49 (0) 9441 2005 50
- fax: + 49 (0) 9441 2005 20
- adreça postal: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Alemanya
- correu electrònic: pco@excelitas.com
- web: www.excelitas.com/product-category/pco
pco.convert
manual d'usuari 1.52.0
Publicat el maig de 2024
©Dret d'autor Excelitas PCO GmbH
Aquesta obra està subjecta a la llicència internacional Creative Commons Attribution-SenseDerivatives 4.0. A view una còpia d'aquesta llicència, visiteu http://creativecommons.org/licenses/by-nd/4.0/ o enviar una carta a Creative Commons, PO Box 1866, Mountain View, CA 94042, EUA.
General
- Aquesta descripció del SDK de conversió es pot utilitzar per implementar les rutines de conversió PCO en aplicacions pròpies, que s'utilitzen per controlar les càmeres PCO. Està prohibit utilitzar les rutines de conversió amb càmeres de tercers.
- El pco.convert sdk consta de dues parts: Les funcions de conversió LUT pco.conv.dll i les funcions de diàleg pco_cdlg.dll .
Les funcions de conversió s'utilitzen per convertir àrees de dades, b/n i color, amb una resolució de més de 8 bits per píxel a àrees de dades en b/n amb una resolució de 8 bits per píxel o àrees de dades de color amb una resolució de 24 (32) bits per píxel. La DLL també inclou funcions per crear i omplir els diferents objectes de conversió. - La segona part de l'API conté les funcions de diàleg. Els diàlegs són senzills diàlegs GUI que permeten a l'usuari establir els paràmetres dels objectes convertits. Les funcions de diàleg s'inclouen al fitxer pco_cdlg.dll i es basen en algunes funcions del pco.conv.dll.
- En el pco.sdk per a les càmeres pco existeixen dos samples, que fan ús del convertidor sdk. Un és el Test_cvDlg sample i l'altre és el sc2_demo. Si us plau, fes una ullada a aquests sampfitxers per "veure" les funcions SDK de conversió en acció.
Conversió en B/N i pseudocolor
L'algorisme de conversió utilitzat a la funció b/n es basa en la següent rutina senzilla
on
- pos és la variable del comptador
- dataout és l'àrea de dades de sortida
- datain és l'àrea de dades d'entrada
- lutbw és una àrea de dades de mida 2n que conté la LUT, on n = resolució de l'àrea d'entrada en bits per píxel
A la funció pseudocolor, la rutina bàsica per convertir a una àrea de dades RGB és:
on
- pos és la variable del comptador d'entrada
- pout és la variable del comptador de sortida
- dataout és l'àrea de dades de sortida
- datain és l'àrea de dades d'entrada
- lutbw és una àrea de dades de mida 2n que conté la LUT, on n = resolució de l'àrea d'entrada en bits per píxel
- lutred, lutgreen, lutblue són àrees de dades de mida 2n que contenen la LUT, on n = resolució de l'àrea de sortida en bit per píxel.
Conversió de color
- Els sensors de color CCD utilitzats a les càmeres de color PCO tenen filtres per als colors vermell, verd i blau. Cada píxel té un tipus de filtre, de manera que originalment no obteniu informació a tot color per a cada píxel. Més aviat cada píxel ofereix un valor amb un rang dinàmic de 12 bits per al color que passa el filtre.
- Totes les càmeres en color de PCO funcionen amb el mosaic DE filtre Bayer. El patró de filtre de color d'aquests sensors d'imatge en color es pot reduir a una matriu de 2×2. El sensor d'imatge en si es pot veure com una matriu d'aquestes matrius 2×2.
- Suposem aquest patró de color
El color en si és només una interpretació de la matriu. Aquesta interpretació es farà mitjançant un algorisme anomenat demosaicking. El pco_conv.dll funciona amb un mètode propietari especial.
Converteix la descripció de la funció de l'API
PCO_ConvertCreate
Descripció
Crea un objecte de conversió nou basat en l'estructura PCO_SensorInfo. El controlador de conversió creat s'utilitzarà durant la conversió. Truqueu a PCO_ConvertDelete abans que l'aplicació surti i descarregui el fitxer dll de conversió.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | MANEJA* | Apuntador a un identificador que rebrà l'objecte de conversió creat |
| strSensor | PCO_SensorInfo* | Apuntador a una estructura d'informació del sensor. No us oblideu d'establir el paràmetre wSize. |
| iConvertType | int | Variable per determinar el tipus de conversió, ja sigui b/n, color, pseudocolor o color 16 |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertDelete
Descripció
Suprimeix un objecte de conversió creat anteriorment. És obligatori cridar aquesta funció abans de tancar l'aplicació.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertGet
Descripció
Obté tots els valors d'un objecte de conversió creat anteriorment.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrConvert | PCO_Convert* | Apuntador a una estructura de conversió de PCO |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertSet
Descripció
Estableix els valors necessaris per a un objecte de conversió creat prèviament.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrConvert | PCO_Convert* | Apuntador a una estructura de conversió de PCO |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertGetDisplay
Descripció
Obté l'estructura PCO_Display
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrDisplay | PCO_Display* | Apuntador a una estructura de visualització de PC |
Valor de retorn
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrDisplay | PCO_Display* | Apuntador a una estructura de visualització de PC |
PCO_ConvertSetDisplay
Descripció
Estableix l'estructura PCO_Display
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrDisplay | PCO_Display* | Apuntador a una estructura de visualització de PC |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertSetBayer
Descripció
Estableix els valors de l'estructura Bayer d'un objecte de conversió creat anteriorment. Utilitzeu aquestes funcions per canviar els paràmetres del patró Bayer.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrBayer | PCO_Bayer* | Apuntador a una estructura de PCO Bayer |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertSetFilter
Descripció
Estableix els valors de l'estructura del filtre d'un objecte de conversió creat anteriorment.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| prefiltre | PCO_Filter* | Apuntador a una estructura de filtre PCO |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_ConvertSetSensorInfo
Descripció
Estableix l'estructura PCO_SensorInfo per a un objecte de conversió creat prèviament
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pstrSensorInfo | PCO_SensorInfo* | Apuntador a una estructura d'informació del sensor. No us oblideu d'establir el paràmetre wSize |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_SetPseudoLut
Descripció
Carregueu les tres taules de colors pseudolut de la trama
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| pseudo_lut | unsigned char * | Punter als valors de color pseudo lut (colors R, G, B: 256 * 3 bytes o 4 bytes) |
| inumcolors | int | Establiu a 3 per a R,G,B o 4 per a R,G,B,A |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_LoadPseudoLut
Descripció
Carrega una taula de cerca de pseudocolors a l'objecte de conversió. Aquesta funció es pot utilitzar per carregar algunes de les pseudotaules de cerca predefinides o creades per si mateix.
Prototip
Paràmetre
| Nom Tipus Descripció | ||||||
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenom | char* | Nom de la file carregar | ||||
Valor de retorn
| Nom Tipus Descripció | ||||||
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment | ||||
| format | int | 0 | lt1, 1 | lt2, 2 | lt3, 3 | lt4 |
| filenom | char* | Nom de la file carregar | ||||
PCO_Convert16TO8
Descripció
Converteix dades d'imatge en b16 a dades de 8 bits en b8 (escala de grisos)
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| mode | int | Paràmetre de mode |
| icolmode | int | Paràmetre del mode de color |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| b16 | paraula* | Punter a la imatge en brut |
| b8 | byte* | Punter a la imatge convertida de 8 bits en b/n |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_Convert16TO24
Descripció
Converteix dades d'imatge en b16 a dades de 24 bits en b24 (escala de grisos)
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| mode | int | Paràmetre de mode |
| Nom | Tipus | Descripció |
| icolmode | int | Paràmetre del mode de color |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| b16 | paraula* | Punter a la imatge en brut |
| b24 | byte* | Punter a la imatge de color convertida de 24 bits |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_Convert16TOCOL
Descripció
Converteix dades d'imatge en b16 a dades RGB en b8 (color)
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| mode | int | Paràmetre de mode |
| icolmode | int | Paràmetre del mode de color |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| b16 | paraula* | Punter a la imatge en brut |
| b8 | byte* | Punter a la imatge de color convertida de 24 bits |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_Convert16TOPSEUDO
Descripció
Converteix dades d'imatge en b16 a dades de pseudocolor en b8 (color)
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| mode | int | Paràmetre de mode |
| icolmode | int | Paràmetre del mode de color |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| b16 | paraula* | Punter a la imatge en brut |
| b8 | byte* | Punter a una imatge de pseudocolor de 24 bits convertida |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_Convert16TOCOL16
Descripció
Converteix dades d'imatge en b16 a dades RGB en b16 (color)
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| mode | int | Paràmetre de mode |
| Nom | Tipus | Descripció |
| icolmode | int | Paràmetre del mode de color |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| b16in | paraula* | Punter a la imatge en brut |
| b16 fora | paraula* | Punter a la imatge de color convertida de 48 bits |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_GetWhiteBalance
Descripció
Obté valors d'equilibri de blancs per a color_tempand tint
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| ph | Mànec | Manejar a un objecte de conversió creat anteriorment |
| color_temp | int* | int punter per obtenir la temperatura de color calculada |
| tint | int* | int punter per obtenir el valor de tint calculat |
| mode | int | Paràmetre de mode |
| amplada | int | Amplada de la imatge a convertir |
| alçada | int | Alçada de la imatge a convertir |
| gb12 | PARAULA* | Punter a la matriu de dades d'imatge en brut |
| x_min | int | Rectangle per definir la regió de la imatge que s'utilitzarà per al càlcul |
| i_min | int | Rectangle per definir la regió de la imatge que s'utilitzarà per al càlcul |
| x_màx | int | Rectangle per definir la regió de la imatge que s'utilitzarà per al càlcul |
| y_màx | int | Rectangle per definir la regió de la imatge que s'utilitzarà per al càlcul |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_GetMaxLimit
Descripció
GetMaxLimit obté els valors RGB per a una temperatura i un tint determinats. El valor màxim dins del diàleg de control de conversió no ha de superar el valor més gran dels valors RGB, per exemple, si R és el valor més gran, el valor màxim pot augmentar fins que el valor R arribi a la resolució de bits (4095). S'ha de complir la mateixa condició per disminuir el valor màxim, per exemple, si B és el valor més baix, el valor màxim pot disminuir fins que el valor B arribi al valor mínim.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| r_màx | flotar* | Apuntador a un flotant que rep el valor vermell màxim |
| g_màx | flotar* | Apuntador a un flotador que rep el valor verd màxim |
| b_màx | flotar* | Apuntador a un flotador que rep el valor blau màxim |
| temp | flotar | Temperatura de color |
| tint | flotar | Configuració de tint |
| bits_sortida | int | Resolució de bits de la imatge convertida (normalment 8) |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_GetColorValues
Descripció
Obté la temperatura de color i el tint per a valors màxims R, G i B determinats.
GetColorValues només s'utilitza a pco.camware . Calcula la temperatura de color i el tint en funció dels valors Rmax, Gmax, Bmax de l'antiga lut de color. Els valors calculats s'utilitzen per convertir imatges antigues b16 i tif16 amb les noves rutines de conversió.
Prototip
Paràmetre
| Nom | Tipus | Descripció |
| pfColorTemp | flotar* | Apuntador a un flotador per rebre la temperatura de color |
| pfColorTemp | flotar* | Apuntador a un flotador per rebre el to de color |
| iRedMax | int | Enter per establir el valor màxim actual del vermell |
| iGreenMax | int | Enter per establir el valor màxim actual del verd. |
| iBlueMax | int | Enter per establir el valor màxim actual del blau |
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_WhiteBalanceToDisplayStruct
Descripció
Calcula el balanç de blancs i estableix els valors a strDisplaystruct mantenint els límits. Obté la struct str Mostra internament de l'handle de conversió
Prototip
Paràmetre
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
PCO_GetVersionInfoPCO_CONV
Descripció
Retorna informació de la versió sobre el dll.
Prototip
Paràmetre
Valor de retorn
| Nom | Tipus | Descripció |
| Missatge d'error | int | 0 en cas d'èxit, codi d'error en cas contrari. |
Implementació típica
Aquesta implementació típica pas a pas mostra el maneig bàsic
- Declaracions
- Estableix tots els paràmetres de "mida" de la memòria intermèdia amb els valors esperats:
- Establiu els paràmetres d'informació del sensor i creeu l'objecte de conversió
- Opcionalment, obre un diàleg de conversió
- Establiu el valor mínim i màxim a l'interval desitjat i configureu-los a l'objecte de conversió
- Feu la conversió i configureu les dades al diàleg si el diàleg està obert
- Tanqueu el diàleg de conversió obert opcionalment
- Tanqueu l'objecte de conversió:
Vegeu el Test_cvDlg sampli al pco.sdk sample carpeta. A partir de la v1.20, l'interval del valor de tint negatiu s'ha duplicat.
- adreça postal: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Alemanya
- telèfon: +49 (0) 9441 2005 0
- correu electrònic: pco@excelitas.com
- web: www.excelitas.com/pco
Documents/Recursos
 |
EXCELITAS TECHNOLOGIES pco.convert Càmera de microscopi [pdfManual d'usuari pco.convert Càmera de microscopi, pco.convert, Càmera de microscopi, càmera |
