EXCELITAS TECHNOLOGIES pco.convert 顯微鏡相機使用手冊

本作品根據 Creative Commons Attribution-NoDerivatives 4.0 International License 獲得許可。到 view 此許可證的副本，請訪問 http://creativecommons.org/licenses/by-nd/4.0/ 或致函 Creative Commons, PO Box 1866, Mountain View，加利福尼亞州 94042，美國。

一般的

此轉換 SDK 描述可用於在專有應用程式中實現 PCO 轉換例程，用於控制 PCO 相機。禁止將轉換例程與第三方相機一起使用。
這 pco轉換 sdk由兩部分組成： LUT轉換函數 pco轉換.dll 和對話框功能 pco_cdlg.dll .
轉換函數用於將解析度超過 8 位元/像素的黑白和彩色資料區域轉換為解析度為 8 位元/像素的黑白資料區域或解析度為 24 位元的彩色資料區域。 DLL 還包括建立和填充各種轉換物件的函數。
API 的第二部分包含對話方塊函數。這些對話框是簡單的 GUI 對話框，使用戶能夠設定轉換物件的參數。對話框功能包含在 pco_cdlg.dll 並基於 pco.conv.dll 的一些功能。
在 pco.sdk 對於 pco 相機，有兩個 samples，它使用convert sdk。一個是 Test_cvDlg sample 另一個是 sc2_demo。請看一下那些amp檔案以便「查看」正在運行的轉換 SDK 函數。

黑白和偽彩色轉換
黑白函數中使用的轉換演算法基於以下簡單例程

在哪裡

pos 是計數器變數
dataout是輸出資料區
datain是輸入資料區

lutbw 是包含 LUT 的大小為 2n 的資料區域，其中 n = 輸入區域的解析度（以每像素位數為單位）

在偽彩色函數中，轉換為 RGB 資料區域的基本例程是：

在哪裡

pos 是輸入計數器變數
pout 是輸出計數器變數

dataout是輸出資料區
datain是輸入資料區
lutbw 是包含 LUT 的大小為 2n 的資料區域，其中 n = 輸入區域的解析度（以每像素位數為單位）

lutred、lutgreen、lutblue 是包含 LUT 的大小為 2n 的資料區域，其中 n = 輸出區域的解析度（以每像素位元為單位）。

顏色轉換

PCO 彩色相機中使用的 CCD 顏色感測器具有紅色、綠色和藍色濾光片。每個像素都有一種類型的濾鏡，因此最初您無法獲得每個像素的完整顏色資訊。相反，每個像素都會為通過濾鏡的顏色提供一個動態範圍為 12 位元的值。

PCO 的所有彩色相機均採用拜耳濾鏡 DE 鑲嵌技術。這些彩色影像感測器的濾色器圖案可以縮小到2×2矩陣。影像感測器本身可以看作是這些 2×2 矩陣的矩陣。
假設這個顏色圖案

顏色本身只是矩陣的一種解釋。這種解釋將透過所謂的去馬賽克演算法來完成。 pco_conv.dll 使用特殊的專有方法工作。

轉換API函數說明

PCO_ConvertCreate

描述
基於 PCO_SensorInfo 結構建立一個新的轉換物件。建立的轉換句柄將在轉換過程中使用。請在應用程式退出並卸載轉換 dll 之前呼叫 PCO_ConvertDelete。

原型

範圍

姓名	類型	描述
ph	處理*	指向將接收建立的轉換物件的句柄的指針
感應器	PCO_感測器資訊*	指向感測器資訊結構的指標。請不要忘記設定 wSize 參數。
iConvertType	整數	用於確定轉換類型的變量，黑白、彩色、偽彩色或彩色 16

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertDelete

描述
刪除先前建立的轉換物件。在關閉應用程式之前必須呼叫此函數。

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertGet

描述
取得先前建立的轉換物件的所有值。

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr轉換	PCO_轉換*	指向 pco 轉換結構的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertSet

描述
為先前建立的轉換對象設定必要的值。

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr轉換	PCO_轉換*	指向 pco 轉換結構的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertGetDisplay

描述
取得PCO_Display結構

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr顯示	PCO_顯示*	指向 pco 顯示結構的指針

傳回值

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr顯示	PCO_顯示*	指向 pco 顯示結構的指針

PCO_ConvertSetDisplay

描述
設定 PCO_Display 結構

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr顯示	PCO_顯示*	指向 pco 顯示結構的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertSetBayer

描述
設定先前建立的轉換物件的拜耳結構值。使用此功能可以變更拜耳模式參數。

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
拜耳	PCO_拜耳*	指向 PCO Bayer 結構的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertSetFilter

描述
設定先前建立的轉換物件的過濾器結構值。

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
預過濾器	PCO_過濾器*	指向 pco 濾波器結構的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_ConvertSetSensorInfo

描述
為先前建立的轉換物件設定 PCO_SensorInfo 結構

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
pstr感測器資訊	PCO_感測器資訊*	指向感測器資訊結構的指標。請不要忘記設定 wSize 參數

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_SetPseudoLut

描述
載入繪圖的三個pseudolut顏色表

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
偽_lut	無符號的字符 *	指向偽 lut 顏色值的指標（R、G、B 顏色：256 * 3 個位元組或 4 個位元組）
顏色數	整數	R、G、B 設定為 3 或 R、G、B、A 設定為 4

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_LoadPseudoLut

描述
將偽顏色查找表載入到轉換物件。此函數可用於載入一些預先定義的或自行建立的偽查找表。

原型

範圍

姓名類型描述
ph	處理	先前建立的轉換物件的句柄
格式	整數	0	LT1, 1	LT2, 2	LT3, 3	LT4
file姓名	字元*	名稱 file 載入

傳回值

姓名類型描述
ph	處理	先前建立的轉換物件的句柄
格式	整數	0	LT1, 1	LT2, 2	LT3, 3	LT4
file姓名	字元*	名稱 file 載入

PCO_Convert16TO8

描述
將b16中的圖片資料轉換為b8中的8bit資料（灰階）

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
模式	整數	模式參數
圖示模式	整數	色彩模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
b16	單字*	指向原始影像的指針
b8	位元組*	指向轉換後的 8 位黑白影像的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_Convert16TO24

描述
將b16中的圖片資料轉換為b24中的24bit資料（灰階）

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
模式	整數	模式參數

姓名	類型	描述
圖示模式	整數	色彩模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
b16	單字*	指向原始影像的指針
b24	位元組*	指向轉換後的 24 位元彩色影像的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_Convert16TOCOL

描述
將b16中的圖片資料轉換為b8中的RGB資料（顏色）

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
模式	整數	模式參數
圖示模式	整數	色彩模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
b16	單字*	指向原始影像的指針
b8	位元組*	指向轉換後的 24 位元彩色影像的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_Convert16TOPSEUDO

描述
將b16中的圖片資料轉換為b8中的偽彩色資料（彩色）

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
模式	整數	模式參數
圖示模式	整數	色彩模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
b16	單字*	指向原始影像的指針
b8	位元組*	指向轉換後的24位元偽彩色影像的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_Convert16TOCOL16

描述
將b16中的圖片資料轉換為b16中的RGB資料（顏色）

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
模式	整數	模式參數

姓名	類型	描述
圖示模式	整數	色彩模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
b16英吋	單字*	指向原始影像的指針
b16輸出	單字*	指向轉換後的 48 位元彩色影像的指針

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_GetWhiteBalance

描述
取得 color_tempand 色調的白平衡值

原型

範圍

姓名	類型	描述
ph	處理	先前建立的轉換物件的句柄
顏色溫度	int*	int指標取得計算出的色溫
著色	int*	int 指標取得計算出的色調值
模式	整數	模式參數
寬度	整數	要轉換的影像的寬度
高度	整數	要轉換的影像的高度
國標12	單字*	指向原始圖片資料數組的指針
x_最小值	整數	矩形設定用於計算的影像區域
y_min	整數	矩形設定用於計算的影像區域
最大x	整數	矩形設定用於計算的影像區域
y 最大值	整數	矩形設定用於計算的影像區域

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_GetMaxLimit

描述
GetMaxLimit 取得給定溫度和色調的 RGB 值。轉換控制對話方塊中的最大值不得超過 RGB 值的最大值，例如，如果 R 是最大值，則最大值可以增加，直到 R 值達到位元解析度 (4095)。減小最大值必須滿足相同的條件，例如，如果B 是最小值，則最大值可以減小，直到B 值達到最小值。

原型

範圍

姓名	類型	描述
最大	漂浮*	指向接收最大紅色值的浮點數的指針
最大克重	漂浮*	指向接收最大綠色值的浮點的指針
最大b值	漂浮*	指向接收最大藍色值的浮點的指針
溫度	漂浮	色溫
著色	漂浮	色調設定
輸出位元	整數	轉換後影像的位元解析度（通常為 8）

傳回值

姓名	類型	描述
錯誤訊息	整數	0 表示成功，否則回傳錯誤代碼。

PCO_GetColorValues

描述
取得給定 R、G、B 最大值的色溫和色調。
GetColorValue僅用於 pco.camware 。它根據舊顏色 lut 的 Rmax、Gmax、Bmax 值計算色溫和色調。計算出的值用於使用新的轉換例程轉換舊的 b16 和 tif16 影像。

原型

範圍

姓名	類型	描述
pf色溫	漂浮*	指向用於接收色溫的浮點的指針
pf色溫	漂浮*	指向用於接收色調的浮點的指針
紅馬克斯	整數	設定紅色目前最大值的整數
愛綠麥克斯	整數	用於設定綠色目前最大值的整數。
愛藍麥克斯	整數	設定藍色目前最大值的整數