EXCELITAS TECHNOLOGIES pco.convert Instrukcja obsługi kamery mikroskopowej

Informacje ogólne
Pco.convert oferuje różne funkcje konwersji kolorów i pseudo kolorów. Ważne jest, aby postępować zgodnie z instrukcjami podanymi w instrukcji użytkownika, aby uzyskać optymalną wydajność.

Konwertuj opis funkcji API
Interfejs API Convert udostępnia zestaw funkcji do manipulowania danymi kolorów i obrazów. Poniżej przedstawiono kilka kluczowych funkcji:

- PCO_ConvertUtwórz: Utwórz nową instancję konwersji.
- PCO_ConvertUsuń: Usuń wystąpienie konwersji.
- PCO_ConvertPobierz: Pobierz ustawienia konwersji.

Konwersja kolorów i pseudokolorów
Pco.convert obsługuje zarówno konwersję czarno-białą, jak i konwersję kolorową. Postępuj zgodnie ze szczegółowymi instrukcjami podanymi w instrukcji dla każdego typu konwersji.

Często zadawane pytania

P: Jak przeprowadzić konwersję kolorów za pomocą pco.convert?
- A: Aby wykonać konwersję kolorów, należy użyć funkcji PCO_ConvertGet z odpowiednimi parametrami opisanymi w instrukcji użytkownika.
P: Czy mogę usunąć instancję konwersji?
- O: Tak, możesz usunąć wystąpienie konwersji za pomocą funkcji PCO_ConvertDelete.

instrukcja obsługi
pco.convert

Excelitas PCO GmbH prosi o uważne przeczytanie i przestrzeganie instrukcji zawartych w tym dokumencie. W przypadku jakichkolwiek pytań lub komentarzy, prosimy o kontakt z nami w każdej chwili.

telefon: +49 (0) 9441 2005 50

faks: +49 (0) 9441 2005 20
adres pocztowy: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Niemcy
e-mail: pco@excelitas.com
web: www.excelitas.com/product-category/pco

pco.convert
instrukcja obsługi 1.52.0
Wydano w maju 2024 r.
©Copyright Excelitas PCO GmbH

Ten utwór objęty jest licencją Creative Commons Uznanie autorstwa-Bez utworów zależnych 4.0 Międzynarodowe. Do view kopię tej licencji, odwiedź http://creativecommons.org/licenses/by-nd/4.0/ lub wyślij list na adres Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Ogólny

Ten opis SDK konwersji może być użyty do implementacji procedur konwersji PCO w zastrzeżonych aplikacjach, które są używane do sterowania kamerami PCO. Zabrania się używania procedur konwersji z kamerami innych firm.
Ten pco.convert sdk składa się z dwóch części: funkcji konwersji LUT pco.conv.dll i funkcje dialogowe pco_cdlg.dll .
Funkcje konwersji służą do konwersji obszarów danych, czarno-białych i kolorowych, o rozdzielczości większej niż 8 bitów na piksel, albo do czarno-białych obszarów danych o rozdzielczości 8 bitów na piksel, albo do kolorowych obszarów danych o rozdzielczości 24 (32) bitów na piksel. Biblioteka DLL zawiera również funkcje do tworzenia i wypełniania różnych obiektów konwersji.
Druga część API zawiera funkcje dialogowe. Dialogi to proste dialogi GUI, które umożliwiają użytkownikowi ustawienie parametrów obiektów konwersji. Funkcje dialogowe są zawarte w pco_cdlg.dll i opierają się na niektórych funkcjach pliku pco.conv.dll.
W pco.sdk dla kamer pco istnieją dwa samples, które korzystają z konwersji SDK. Jednym z nich jest Test_cvDlg sample, a drugi to sc2_demo. Proszę spojrzeć na te samples, aby „zobaczyć” funkcje konwersji SDK w działaniu.

Konwersja czarno-biała i pseudokolorowa
Algorytm konwersji używany w funkcji czarno-białej opiera się na następującej prostej procedurze

Gdzie

pos jest zmienną licznika
dataout to obszar danych wyjściowych
datain to obszar danych wejściowych

lutbw to obszar danych o rozmiarze 2n zawierający LUT, gdzie n = rozdzielczość obszaru wejściowego w bitach na piksel

W funkcji pseudokoloru podstawową procedurą konwersji na obszar danych RGB jest:

Gdzie

pos jest zmienną licznika wejściowego
pout jest zmienną licznika wyjściowego

dataout to obszar danych wyjściowych
datain to obszar danych wejściowych
lutbw to obszar danych o rozmiarze 2n zawierający LUT, gdzie n = rozdzielczość obszaru wejściowego w bitach na piksel

lutred, lutgreen, lutblue to obszary danych o rozmiarze 2n zawierające LUT, gdzie n = rozdzielczość obszaru wyjściowego w bitach na piksel.

Konwersja kolorów

Czujniki koloru CCD stosowane w kamerach kolorowych PCO są wyposażone w filtry kolorów czerwonego, zielonego i niebieskiego. Każdy piksel ma jeden typ filtra, dlatego początkowo nie otrzymujesz pełnej informacji o kolorze dla każdego piksela. Raczej każdy piksel dostarcza wartość z 12-bitowym zakresem dynamicznym dla koloru, który przechodzi przez filtr.

Wszystkie kamery kolorowe w PCO pracują z mozaikowaniem DE z filtrem Bayera. Wzór filtra kolorów tych kolorowych czujników obrazu można zredukować do matrycy 2×2. Sam czujnik obrazu można postrzegać jako matrycę tych matryc 2×2.
Załóżmy, że ten wzór kolorów

Sam kolor jest jedynie interpretacją matrycy. Interpretacja ta zostanie dokonana za pomocą tzw. algorytmu demozaikowania. Plik pco_conv.dll działa w oparciu o specjalną, zastrzeżoną metodę.

Konwertuj opis funkcji API

PCO_ConvertUtwórz

Opis
Tworzy nowy obiekt konwersji w oparciu o strukturę PCO_SensorInfo. Utworzony uchwyt konwersji zostanie użyty podczas konwersji. Proszę wywołać PCO_ConvertDelete zanim aplikacja zakończy działanie i wyładuje bibliotekę DLL konwersji.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT*	Wskaźnik do uchwytu, który otrzyma utworzony obiekt konwersji
strCzujnik	Informacje o czujniku PCO_*	Wskaźnik do struktury informacji czujnika. Nie zapomnij ustawić parametru wSize.
iConvertType	wewnątrz	Zmienna określająca typ konwersji, czarno-biały, kolorowy, pseudokolorowy lub kolorowy 16

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_ConvertUsuń

Opis
Usuwa wcześniej utworzony obiekt convert. Wywołanie tej funkcji jest obowiązkowe przed zamknięciem aplikacji.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym razie kod błędu.

PCO_ConvertGet

Opis
Pobiera wszystkie wartości wcześniej utworzonego obiektu konwersji.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
Konwertuj	Konwersja PCO*	Wskaźnik do struktury konwersji pco

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym razie kod błędu.

Zestaw PCO_Convert

Opis
Ustawia wymagane wartości dla wcześniej utworzonego obiektu konwersji.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
Konwertuj	Konwersja PCO*	Wskaźnik do struktury konwersji pco

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_ConvertGetDisplay

Opis
Pobiera strukturę PCO_Display

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
Wyświetlanie pstr	PCO_Wyświetlacz*	Wskaźnik do struktury wyświetlania pco

Wartość zwracana

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
Wyświetlanie pstr	PCO_Wyświetlacz*	Wskaźnik do struktury wyświetlania pco

PCO_ConvertSetDisplay

Opis
Ustawia strukturę PCO_Display

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
Wyświetlanie pstr	PCO_Wyświetlacz*	Wskaźnik do struktury wyświetlania pco

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_ConvertSetBayer

Opis
Ustawia wartości struktury Bayera wcześniej utworzonego obiektu konwersji. Użyj tej funkcji, aby zmienić parametry wzorca Bayera.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
pstrBayer	PCO_Bayer*	Wskaźnik do struktury PCO Bayer

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

Filtr zestawu PCO_ConvertSet

Opis
Ustawia wartości struktury filtru wcześniej utworzonego obiektu konwersji.

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
filtr wstępny	Filtr PCO*	Wskaźnik do struktury filtra pco

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_ConvertSetInfo czujnika

Opis
Ustawia strukturę PCO_SensorInfo dla wcześniej utworzonego obiektu konwersji

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
pstrSensorInfo	Informacje o czujniku PCO_*	Wskaźnik do struktury informacji czujnika. Nie zapomnij ustawić parametru wSize

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_SetPseudoLut

Opis
Załaduj trzy tabele kolorów pseudolut wykresu

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
pseudo_lut	unsigned char *	Wskaźnik do wartości kolorów pseudo lut (kolory R, G, B: 256 * 3 bajty lub 4 bajty)
inumkolory	wewnątrz	Ustaw na 3 dla R, G, B lub 4 dla R, G, B, A

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_LoadPseudoLut

Opis
Ładuje pseudotabelę wyszukiwania kolorów do obiektu konwertowanego. Ta funkcja może być używana do ładowania niektórych wstępnie zdefiniowanych lub samodzielnie utworzonych pseudotabel wyszukiwania.

Prototyp

Parametr

Nazwa Opis typu
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
format	wewnątrz	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenazwa	zwęglać*	Nazwa file załadować

Wartość zwracana

Nazwa Opis typu
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
format	wewnątrz	0	lt1, 1	lt2, 2	lt3, 3	lt4
filenazwa	zwęglać*	Nazwa file załadować

PCO_Konwertuj16TO8

Opis
Konwertuj dane obrazu w b16 na dane 8-bitowe w b8 (skala szarości)

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
tryb	wewnątrz	Parametr trybu
ikolmodowy	wewnątrz	Parametr trybu koloru
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
b16	słowo*	Wskaźnik do surowego obrazu
b8	bajt*	Wskaźnik do przekonwertowanego obrazu 8-bitowego w czerni i bieli

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_Konwertuj16TO24

Opis
Konwertuj dane obrazu w b16 na dane 24-bitowe w b24 (skala szarości)

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
tryb	wewnątrz	Parametr trybu

Nazwa	Typ	Opis
ikolmodowy	wewnątrz	Parametr trybu koloru
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
b16	słowo*	Wskaźnik do surowego obrazu
b24	bajt*	Wskaźnik do przekonwertowanego obrazu w 24-bitowym kolorze

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_Convert16TOCOL

Opis
Konwertuj dane obrazu w b16 na dane RGB w b8 (kolor)

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
tryb	wewnątrz	Parametr trybu
ikolmodowy	wewnątrz	Parametr trybu koloru
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
b16	słowo*	Wskaźnik do surowego obrazu
b8	bajt*	Wskaźnik do przekonwertowanego obrazu w 24-bitowym kolorze

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_Convert16TOPSEUDO

Opis
Konwertuj dane obrazu w b16 na dane pseudokolorowe w b8 (kolor)

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
tryb	wewnątrz	Parametr trybu
ikolmodowy	wewnątrz	Parametr trybu koloru
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
b16	słowo*	Wskaźnik do surowego obrazu
b8	bajt*	Wskaźnik do przekonwertowanego 24-bitowego pseudokolorowego obrazu

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_Konwertuj16TOCOL16

Opis
Konwertuj dane obrazu w b16 na dane RGB w b16 (kolor)

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
tryb	wewnątrz	Parametr trybu

Nazwa	Typ	Opis
ikolmodowy	wewnątrz	Parametr trybu koloru
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
b16in	słowo*	Wskaźnik do surowego obrazu
b16wyjście	słowo*	Wskaźnik do przekonwertowanego obrazu w 48-bitowym kolorze

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_GetWhiteBalance

Opis
Pobiera wartości balansu bieli dla temperatury koloru i odcienia

Prototyp

Parametr

Nazwa	Typ	Opis
ph	UCHWYT	Uchwyt do wcześniej utworzonego obiektu konwersji
temperatura_koloru	int*	wskaźnik int do uzyskania obliczonej temperatury barwowej
odcień	int*	wskaźnik int do uzyskania obliczonej wartości odcienia
tryb	wewnątrz	Parametr trybu
szerokość	wewnątrz	Szerokość obrazu do konwersji
wysokość	wewnątrz	Wysokość obrazu do konwersji
gb12	SŁOWO*	Wskaźnik do tablicy danych surowego obrazu
x_min	wewnątrz	Prostokąt służący do ustawiania obszaru obrazu, który ma zostać użyty do obliczeń
y_min	wewnątrz	Prostokąt służący do ustawiania obszaru obrazu, który ma zostać użyty do obliczeń
x_max	wewnątrz	Prostokąt służący do ustawiania obszaru obrazu, który ma zostać użyty do obliczeń
y_maks	wewnątrz	Prostokąt służący do ustawiania obszaru obrazu, który ma zostać użyty do obliczeń

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_GetMaxLimit

Opis
GetMaxLimit pobiera wartości RGB dla danej temperatury i odcienia. Maksymalna wartość w oknie dialogowym sterowania konwersją nie może przekraczać największej wartości wartości RGB, np. w przypadku, gdy R jest największą wartością, maksymalna wartość może rosnąć, aż wartość R osiągnie rozdzielczość bitową (4095). Aby zmniejszyć wartość maksymalną, należy spełnić ten sam warunek, np. w przypadku, gdy B jest wartością najniższą, wartość maksymalna może się zmniejszać, aż wartość B osiągnie wartość minimalną.

Prototyp

Parametr

Nazwa	Typ	Opis
r_max	platforma*	Wskaźnik do obiektu float otrzymującego maksymalną wartość czerwoną
g_max	platforma*	Wskaźnik do obiektu float otrzymującego maksymalną wartość zieloną
b_maks.	platforma*	Wskaźnik do obiektu float otrzymującego maksymalną wartość niebieską
tymczasowy	platforma	Temperatura barwowa
odcień	platforma	Ustawienie odcienia
bity_wyjściowe	wewnątrz	Rozdzielczość bitowa konwertowanego obrazu (zwykle 8)

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_GetColorValues

Opis
Pobiera temperaturę barwową i odcień dla podanych wartości maksymalnych R, G, B.
Funkcja GetColorValue jest używana tylko w pco.camware . Oblicza temperaturę barwową i odcień na podstawie wartości Rmax, Gmax, Bmax starego lut kolorów. Obliczone wartości są używane do konwersji starych obrazów b16 i tif16 za pomocą nowych procedur konwersji.

Prototyp

Parametr

Nazwa	Typ	Opis
Temperatura koloru pf	platforma*	Wskaźnik do obiektu float w celu otrzymania temperatury barwowej
Temperatura koloru pf	platforma*	Wskaźnik do obiektu float w celu otrzymania odcienia koloru
iRedMax	wewnątrz	Liczba całkowita ustawiająca bieżącą maksymalną wartość dla koloru czerwonego
iZielonyMax	wewnątrz	Liczba całkowita ustawiająca bieżącą maksymalną wartość koloru zielonego.
iBlueMax	wewnątrz	Liczba całkowita ustawiająca bieżącą maksymalną wartość dla koloru niebieskiego

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_WhiteBalanceToDisplayStruct

Opis
Oblicza balans bieli i ustawia wartości dla strDisplaystruct, zachowując jednocześnie limity. Pobiera strukturę str Display z uchwytu convert wewnętrznie

Prototyp

Parametr

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

PCO_GetVersionInfoPCO_CONV

Opis
Zwraca informacje o wersji biblioteki DLL.

Prototyp

Parametr

Wartość zwracana

Nazwa	Typ	Opis
Komunikat o błędzie	wewnątrz	0 w przypadku powodzenia, w przeciwnym wypadku kod błędu.

Typowa implementacja

Ta typowa implementacja krok po kroku pokazuje podstawową obsługę

Deklaracje
Ustaw wszystkie parametry „rozmiaru” bufora na oczekiwane wartości:
Ustaw parametry informacji o czujniku i utwórz obiekt konwersji
Opcjonalnie otwórz okno dialogowe konwersji
Ustaw wartość minimalną i maksymalną na żądany zakres i ustaw je na obiekt konwersji
Wykonaj konwersję i ustaw dane w oknie dialogowym, jeśli jest otwarte
Zamknij opcjonalnie otwarte okno dialogowe konwersji
Zamknij obiekt konwersji:

Zobacz plik Test_cvDlgample w pco.sdk sampfolder le. Począwszy od wersji 1.20, zakres ujemnej wartości zabarwienia został podwojony.

adres pocztowy: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Niemcy
telefon: +49 (0) 9441 2005 0
e-mail: pco@excelitas.com
web: www.excelitas.com/pco

Dokumenty / Zasoby

TECHNOLOGIE EXCELITAS pco.convert Kamera mikroskopowa [plik PDF] Instrukcja obsługi
pco.convert Kamera mikroskopowa, pco.convert, Kamera mikroskopowa, Kamera

Odniesienia

Instrukcja obsługi

TECHNOLOGIE EXCELITAS pco.convert Kamera mikroskopowa

Instrukcje użytkowania produktu

Ogólny

Konwertuj opis funkcji API

Typowa implementacja

Dokumenty / Zasoby

Odniesienia

Zostaw komentarz

Anuluj odpowiedź