數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)(適用于GX系列千兆網(wǎng)攝像機(jī))
聲明：您必須遵守我們的協(xié)議，如果您下載了該資源行為將被視為對(duì)《電天下賬號(hào)管理規(guī)范》全部?jī)?nèi)容的認(rèn)可，本網(wǎng)站資源來(lái)自原創(chuàng)，僅供用于學(xué)習(xí)和交流，請(qǐng)勿用于商業(yè)用途。如有侵權(quán)、不妥之處，請(qǐng)舉報(bào)本資源，我們將及時(shí)審核處理！
數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)(適用于GX系列千兆網(wǎng)攝像機(jī))
數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)(適用于GX系列千兆網(wǎng)攝像機(jī))
文本預(yù)覽
大恒圖像系列數(shù)字?jǐn)z像機(jī)
數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)
（適用于GX系列千兆網(wǎng)攝像機(jī)）
2009 年 2 月版本手冊(cè)中所提及的其它軟硬件產(chǎn)品的商標(biāo)與名稱，都屬于相應(yīng)
公司所有。
本手冊(cè)的版權(quán)屬于中國(guó)大恒（集團(tuán)）有限公司 北京圖像視覺(jué)技
術(shù)分公司所有。未得到本公司的正式許可，任何組織或個(gè)人均不得
以任何手段和形式對(duì)本手冊(cè)內(nèi)容進(jìn)行復(fù)制或傳播。
本手冊(cè)的內(nèi)容若有任何修改，恕不另行通知。
? 2007 中國(guó)大恒（集團(tuán)）有限公司北京圖像視覺(jué)技術(shù)分公司 版權(quán)所有
網(wǎng)站：http://www.daheng-image.com
銷售信箱：sales@daheng-image.com
銷售熱線：010-82828878轉(zhuǎn)8021
支持信箱：support@daheng-image.com
支持熱線：010-82828878轉(zhuǎn)8006前 言
首先感謝您選用大恒圖像產(chǎn)品，數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)是我公
司提供的應(yīng)用程序接口函數(shù)。它基本上概括了數(shù)字?jǐn)z像機(jī)應(yīng)用程序
編程中涉及的各個(gè)方面，通過(guò)應(yīng)用接口庫(kù)，用戶可以很好地了解數(shù)
字?jǐn)z像機(jī)的運(yùn)行機(jī)制，并在此基礎(chǔ)上進(jìn)行應(yīng)用程序的開(kāi)發(fā)。
數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)按照模塊分為應(yīng)用功能模塊和擴(kuò)充功能
模塊。其中應(yīng)用功能模塊包括數(shù)字?jǐn)z像機(jī)的控制、采集圖像到內(nèi)存、
錯(cuò)誤處理等功能，擴(kuò)充功能模塊包括圖像數(shù)據(jù)的轉(zhuǎn)換等功能。
本手冊(cè)按功能對(duì)接口庫(kù)中的函數(shù)進(jìn)行了劃分，對(duì)于每一個(gè)功能
部分的函數(shù)都具體給出了它們的函數(shù)原型、參數(shù)定義、說(shuō)明、示例
等信息。
手冊(cè)為用戶進(jìn)行數(shù)字?jǐn)z像機(jī)的二次開(kāi)發(fā)提供了詳細(xì)的說(shuō)明，如
果用戶在使用過(guò)程中發(fā)現(xiàn)錯(cuò)誤和紕漏，請(qǐng)與我公司的銷售或技術(shù)服
務(wù)部門聯(lián)系，以便我們及時(shí)改進(jìn)。目錄
目錄
1概述......................................................................................................1
1.1功能................................................ 2
1.2文件................................................ 2
1.2.1應(yīng)用功能模塊...................................... 2
1.2.2擴(kuò)充功能模塊...................................... 3
1.3開(kāi)發(fā)工具............................................ 3
1.4應(yīng)用程序的發(fā)布...................................... 4
2說(shuō)明......................................................................................................5
2.1 應(yīng)用功能 ........................................... 5
2.1.1 定義 ............................................. 5
2.1.2函數(shù)說(shuō)明......................................... 28
2.2擴(kuò)充功能........................................... 46
2.2.1 定義 ............................................ 46
2.2.2 函數(shù)說(shuō)明 ........................................ 49
3. 函數(shù)返回值......................................................................................58
3.1函數(shù)返回值代碼表................................... 58
4 GX攝像機(jī)功能接口..........................................................................61
4.1 GX攝像機(jī)接口列表................................... 61
4.2 GX攝像機(jī)新增功能接口開(kāi)發(fā)說(shuō)明....................... 65
4.2.1 查找設(shè)備 ........................................ 65
4.2.2 判斷設(shè)備IP是否有效............................... 66
4.2.3 設(shè)置/修改指定設(shè)備IP.............................. 66
4.2.4 設(shè)置自動(dòng)曝光..................................... 68
4.2.5 設(shè)置自動(dòng)增益..................................... 70目錄
4.2.6 查詢可用加密區(qū)................................... 72
4.2.7 讀用戶加密區(qū)..................................... 74
4.2.8 寫(xiě)用戶加密區(qū)..................................... 76
4.2.9 修改加密密碼..................................... 78
4.2.10設(shè)置啟動(dòng)參數(shù)組.................................. 80
4.2.11設(shè)置保存參數(shù)組.................................. 82
4.2.12設(shè)置加載參數(shù)組.................................. 84
4.2.13區(qū)域自動(dòng)增益控制................................ 86
4.2.14區(qū)域自動(dòng)曝光控制................................ 88
4.2.15區(qū)域AOI控制..................................... 90
4.2.16區(qū)域期望灰度值.................................. 94
4.2.17異步復(fù)位采集.................................... 95
4.3 GX新增參數(shù)獲取功能開(kāi)發(fā)使用說(shuō)明..................... 96
4.3.1 采集模式、外觸發(fā)極性............................ 96
4.3.2 快門速度、自動(dòng)曝光狀態(tài).......................... 98
4.3.3 增益調(diào)節(jié)、自動(dòng)增益狀態(tài).......................... 99
4.3.4 紅通道、藍(lán)通道................................. 100
4.3.5 快門速度單位................................... 101
4.3.6 綠通道 ........................................ 102
4.3.7 閃光燈開(kāi)關(guān)、閃光燈極性......................... 103
4.3.8 攝像機(jī)IP、MAC，網(wǎng)卡IP、MAC..................... 104
4.3.9 獲取啟動(dòng)參數(shù)組號(hào)............................... 106
4.3.10 獲取保存參數(shù)組號(hào)............................... 107目錄
4.3.11 獲取加載參數(shù)組號(hào)............................... 108
4.3.12區(qū)域自動(dòng)增益控制參數(shù)讀取....................... 109
4.3.13區(qū)域自動(dòng)曝光控制參數(shù)讀取....................... 110
4.3.14區(qū)域AOI控制參數(shù)讀取............................ 111
4.3.15區(qū)域期望灰度值讀取............................. 112
4.4 DH-ITS-GX測(cè)速功能................................. 112
4.4.1 測(cè)速功能開(kāi)關(guān).................................... 113
4.4.2 測(cè)速觸發(fā)源 ..................................... 117
4.4.3 觸發(fā)源極性 ..................................... 119
4.4.4 超時(shí)時(shí)間 ....................................... 121
4.4.5 獲取測(cè)速信息.................................... 125
5.更新歷史..........................................................................................128概述
1 概述
在 Microsoft 的 32 位 Windows 操作系統(tǒng)中，數(shù)字?jǐn)z像機(jī)應(yīng)用
接口庫(kù)直接操作數(shù)字?jǐn)z像機(jī)，并提供給用戶一個(gè)簡(jiǎn)單明確的應(yīng)用接
口。用戶在編制自己的應(yīng)用程序時(shí)，可以直接調(diào)用這些庫(kù)函數(shù)來(lái)實(shí)
現(xiàn)指定的功能。
數(shù)字?jǐn)z像機(jī)工作流程如下：
開(kāi)始（初始化指定設(shè)備，申請(qǐng)資源）
參數(shù)設(shè)置（分辨率、圖像窗口、曝光、增益等）
采集圖像到內(nèi)存（采集、停止、讀取、存儲(chǔ)）
結(jié)束（釋放其資源）
1概述
對(duì)于GX千兆網(wǎng)攝像機(jī)，在開(kāi)始初始化設(shè)備之前，需要保證攝像
數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)
（適用于GX系列千兆網(wǎng)攝像機(jī)）
2009 年 2 月版本手冊(cè)中所提及的其它軟硬件產(chǎn)品的商標(biāo)與名稱，都屬于相應(yīng)
公司所有。
本手冊(cè)的版權(quán)屬于中國(guó)大恒（集團(tuán)）有限公司 北京圖像視覺(jué)技
術(shù)分公司所有。未得到本公司的正式許可，任何組織或個(gè)人均不得
以任何手段和形式對(duì)本手冊(cè)內(nèi)容進(jìn)行復(fù)制或傳播。
本手冊(cè)的內(nèi)容若有任何修改，恕不另行通知。
? 2007 中國(guó)大恒（集團(tuán)）有限公司北京圖像視覺(jué)技術(shù)分公司 版權(quán)所有
網(wǎng)站：http://www.daheng-image.com
銷售信箱：sales@daheng-image.com
銷售熱線：010-82828878轉(zhuǎn)8021
支持信箱：support@daheng-image.com
支持熱線：010-82828878轉(zhuǎn)8006前 言
首先感謝您選用大恒圖像產(chǎn)品，數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)是我公
司提供的應(yīng)用程序接口函數(shù)。它基本上概括了數(shù)字?jǐn)z像機(jī)應(yīng)用程序
編程中涉及的各個(gè)方面，通過(guò)應(yīng)用接口庫(kù)，用戶可以很好地了解數(shù)
字?jǐn)z像機(jī)的運(yùn)行機(jī)制，并在此基礎(chǔ)上進(jìn)行應(yīng)用程序的開(kāi)發(fā)。
數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)按照模塊分為應(yīng)用功能模塊和擴(kuò)充功能
模塊。其中應(yīng)用功能模塊包括數(shù)字?jǐn)z像機(jī)的控制、采集圖像到內(nèi)存、
錯(cuò)誤處理等功能，擴(kuò)充功能模塊包括圖像數(shù)據(jù)的轉(zhuǎn)換等功能。
本手冊(cè)按功能對(duì)接口庫(kù)中的函數(shù)進(jìn)行了劃分，對(duì)于每一個(gè)功能
部分的函數(shù)都具體給出了它們的函數(shù)原型、參數(shù)定義、說(shuō)明、示例
等信息。
手冊(cè)為用戶進(jìn)行數(shù)字?jǐn)z像機(jī)的二次開(kāi)發(fā)提供了詳細(xì)的說(shuō)明，如
果用戶在使用過(guò)程中發(fā)現(xiàn)錯(cuò)誤和紕漏，請(qǐng)與我公司的銷售或技術(shù)服
務(wù)部門聯(lián)系，以便我們及時(shí)改進(jìn)。目錄
目錄
1概述......................................................................................................1
1.1功能................................................ 2
1.2文件................................................ 2
1.2.1應(yīng)用功能模塊...................................... 2
1.2.2擴(kuò)充功能模塊...................................... 3
1.3開(kāi)發(fā)工具............................................ 3
1.4應(yīng)用程序的發(fā)布...................................... 4
2說(shuō)明......................................................................................................5
2.1 應(yīng)用功能 ........................................... 5
2.1.1 定義 ............................................. 5
2.1.2函數(shù)說(shuō)明......................................... 28
2.2擴(kuò)充功能........................................... 46
2.2.1 定義 ............................................ 46
2.2.2 函數(shù)說(shuō)明 ........................................ 49
3. 函數(shù)返回值......................................................................................58
3.1函數(shù)返回值代碼表................................... 58
4 GX攝像機(jī)功能接口..........................................................................61
4.1 GX攝像機(jī)接口列表................................... 61
4.2 GX攝像機(jī)新增功能接口開(kāi)發(fā)說(shuō)明....................... 65
4.2.1 查找設(shè)備 ........................................ 65
4.2.2 判斷設(shè)備IP是否有效............................... 66
4.2.3 設(shè)置/修改指定設(shè)備IP.............................. 66
4.2.4 設(shè)置自動(dòng)曝光..................................... 68
4.2.5 設(shè)置自動(dòng)增益..................................... 70目錄
4.2.6 查詢可用加密區(qū)................................... 72
4.2.7 讀用戶加密區(qū)..................................... 74
4.2.8 寫(xiě)用戶加密區(qū)..................................... 76
4.2.9 修改加密密碼..................................... 78
4.2.10設(shè)置啟動(dòng)參數(shù)組.................................. 80
4.2.11設(shè)置保存參數(shù)組.................................. 82
4.2.12設(shè)置加載參數(shù)組.................................. 84
4.2.13區(qū)域自動(dòng)增益控制................................ 86
4.2.14區(qū)域自動(dòng)曝光控制................................ 88
4.2.15區(qū)域AOI控制..................................... 90
4.2.16區(qū)域期望灰度值.................................. 94
4.2.17異步復(fù)位采集.................................... 95
4.3 GX新增參數(shù)獲取功能開(kāi)發(fā)使用說(shuō)明..................... 96
4.3.1 采集模式、外觸發(fā)極性............................ 96
4.3.2 快門速度、自動(dòng)曝光狀態(tài).......................... 98
4.3.3 增益調(diào)節(jié)、自動(dòng)增益狀態(tài).......................... 99
4.3.4 紅通道、藍(lán)通道................................. 100
4.3.5 快門速度單位................................... 101
4.3.6 綠通道 ........................................ 102
4.3.7 閃光燈開(kāi)關(guān)、閃光燈極性......................... 103
4.3.8 攝像機(jī)IP、MAC，網(wǎng)卡IP、MAC..................... 104
4.3.9 獲取啟動(dòng)參數(shù)組號(hào)............................... 106
4.3.10 獲取保存參數(shù)組號(hào)............................... 107目錄
4.3.11 獲取加載參數(shù)組號(hào)............................... 108
4.3.12區(qū)域自動(dòng)增益控制參數(shù)讀取....................... 109
4.3.13區(qū)域自動(dòng)曝光控制參數(shù)讀取....................... 110
4.3.14區(qū)域AOI控制參數(shù)讀取............................ 111
4.3.15區(qū)域期望灰度值讀取............................. 112
4.4 DH-ITS-GX測(cè)速功能................................. 112
4.4.1 測(cè)速功能開(kāi)關(guān).................................... 113
4.4.2 測(cè)速觸發(fā)源 ..................................... 117
4.4.3 觸發(fā)源極性 ..................................... 119
4.4.4 超時(shí)時(shí)間 ....................................... 121
4.4.5 獲取測(cè)速信息.................................... 125
5.更新歷史..........................................................................................128概述
1 概述
在 Microsoft 的 32 位 Windows 操作系統(tǒng)中，數(shù)字?jǐn)z像機(jī)應(yīng)用
接口庫(kù)直接操作數(shù)字?jǐn)z像機(jī)，并提供給用戶一個(gè)簡(jiǎn)單明確的應(yīng)用接
口。用戶在編制自己的應(yīng)用程序時(shí)，可以直接調(diào)用這些庫(kù)函數(shù)來(lái)實(shí)
現(xiàn)指定的功能。
數(shù)字?jǐn)z像機(jī)工作流程如下：
開(kāi)始（初始化指定設(shè)備，申請(qǐng)資源）
參數(shù)設(shè)置（分辨率、圖像窗口、曝光、增益等）
采集圖像到內(nèi)存（采集、停止、讀取、存儲(chǔ)）
結(jié)束（釋放其資源）
1概述
對(duì)于GX千兆網(wǎng)攝像機(jī)，在開(kāi)始初始化設(shè)備之前，需要保證攝像
AIGC尊敬的用戶您好！針對(duì)您查詢的"數(shù)字?jǐn)z像機(jī)軟件開(kāi)發(fā)說(shuō)明書(shū)(適用于GX系列千兆網(wǎng)攝像機(jī))", 這是一份詳細(xì)的技術(shù)文檔，專為 gx 系列采用千兆網(wǎng)絡(luò)技術(shù)的數(shù)字?jǐn)z像機(jī)設(shè)計(jì)。該說(shuō)明書(shū)主要包括以下幾個(gè)方面內(nèi)容：
1. **產(chǎn)品概述**：對(duì)GX系列千兆網(wǎng)攝像機(jī)的基本特性、功能模塊以及網(wǎng)絡(luò)通信協(xié)議（如IP傳輸?shù)龋┻M(jìn)行介紹，幫助開(kāi)發(fā)者了解設(shè)備的工作原理和網(wǎng)絡(luò)架構(gòu)。
2. **軟件環(huán)境要求**：明確指出用于開(kāi)發(fā)和調(diào)試攝像機(jī)軟件所需的硬件平臺(tái)、操作系統(tǒng)環(huán)境及所需的相關(guān)軟件工具配置說(shuō)明。
3. **API接口文檔**：提供攝像機(jī)內(nèi)部可供軟件調(diào)用的各種接口函數(shù)或命令集，包括但不限于視頻采集、圖像處理、網(wǎng)絡(luò)通信控制、參數(shù)設(shè)置等功能的具體實(shí)現(xiàn)方法和使用示例。
4. **軟件安裝與配置指南**：指導(dǎo)如何在目標(biāo)平臺(tái)上正確安裝并配置攝像機(jī)固件和配套軟件，確保其與攝像機(jī)硬件的有效對(duì)接。
5. **功能模塊開(kāi)發(fā)流程**：闡述各個(gè)功能模塊的開(kāi)發(fā)步驟、測(cè)試要點(diǎn)以及異常處理策略，幫助開(kāi)發(fā)者按部就班地完成軟件定制工作。
6. **示例代碼與應(yīng)用案例**：提供一些關(guān)鍵功能模塊的源碼片段或者完整應(yīng)用實(shí)例，以便開(kāi)發(fā)者參考學(xué)習(xí)和快速上手。
總之，這份軟件開(kāi)發(fā)說(shuō)明書(shū)是針對(duì)GX系列千兆網(wǎng)攝像機(jī)的專業(yè)開(kāi)發(fā)者編寫(xiě)，旨在為其提供從零開(kāi)始到成品軟件開(kāi)發(fā)全過(guò)程中的全方位支持和指導(dǎo)。通過(guò)閱讀和遵循其中的各項(xiàng)規(guī)定，您可以順利進(jìn)行相關(guān)軟件的定制和優(yōu)化工作。如有任何疑問(wèn)，請(qǐng)隨時(shí)咨詢我們的技術(shù)支持團(tuán)隊(duì)。
