# sys.ddcci 库模块帮助文档

## sys 成员列表 <a id="sys" href="#sys">&#x23;</a>

### sys.ddcci() <a id="sys.ddcci" href="#sys.ddcci">&#x23;</a>
[返回对象:SysDdcciObject](#SysDdcciObject)

### sys.ddcci(hpm,description) <a id="sys.ddcci" href="#sys.ddcci">&#x23;</a>
创建显示器控制对象，  
@hpm 为物理显示器句柄,  
@description 为显示器描述，可选参数

## sys.ddcci 成员列表 <a id="sys.ddcci" href="#sys.ddcci">&#x23;</a>

DDC/CI（Display Data Channel Command Interface）  
用于控制显示器，不是所有显示器都支持 DDC/CI

创建显示器控制对象

### sys.ddcci.each() <a id="sys.ddcci.each" href="#sys.ddcci.each">&#x23;</a>

```aardio
for ddcci in sys.ddcci.each() {  
	/*遍历所有物理显示器，  
ddcci 为控制该显示器的 sys.ddcci 对象*/  
}  

[返回对象:SysDdcciObject](#SysDdcciObject)
```

### sys.ddcci.getPhysicalMonitors <a id="sys.ddcci.getPhysicalMonitors" href="#sys.ddcci.getPhysicalMonitors">&#x23;</a>
返回所有物理显示器句柄数组

### sys.ddcci.getPhysicalMonitors() <a id="sys.ddcci.getPhysicalMonitors" href="#sys.ddcci.getPhysicalMonitors">&#x23;</a>
返回所有物理显示器句柄数组

### sys.ddcci.getPhysicalMonitors(hMonitor) <a id="sys.ddcci.getPhysicalMonitors" href="#sys.ddcci.getPhysicalMonitors">&#x23;</a>
返回 @hMonitor 指定句柄的显示器指向的物理显示器句柄数组,  
注意参数 @hMonitor 指定显示器句柄，并非物理显示器句柄

## SysDdcciObject 成员列表 <a id="SysDdcciObject" href="#SysDdcciObject">&#x23;</a>

### SysDdcciObject.capabilities <a id="SysDdcciObject.capabilities" href="#SysDdcciObject.capabilities">&#x23;</a>
返回描述显示器支持功能的表对象

### SysDdcciObject.description <a id="SysDdcciObject.description" href="#SysDdcciObject.description">&#x23;</a>
显示器描述

### SysDdcciObject.destroy() <a id="SysDdcciObject.destroy" href="#SysDdcciObject.destroy">&#x23;</a>
释放对象，  
如果没有调用此函数，则回收对象时自动调用。

### SysDdcciObject.getBrightness() <a id="SysDdcciObject.getBrightness" href="#SysDdcciObject.getBrightness">&#x23;</a>
获取亮度，返回3个值：  
当前亮度，最小值，最大值

### SysDdcciObject.getColorTemperature() <a id="SysDdcciObject.getColorTemperature" href="#SysDdcciObject.getColorTemperature">&#x23;</a>
获取色温

### SysDdcciObject.getContrast() <a id="SysDdcciObject.getContrast" href="#SysDdcciObject.getContrast">&#x23;</a>
获取对比度，返回3个值：  
当前亮度，最小值，最大值

### SysDdcciObject.getFeature(vcpCode) <a id="SysDdcciObject.getFeature" href="#SysDdcciObject.getFeature">&#x23;</a>
读取设置值  
@vcpCode 为控制代码

### SysDdcciObject.getInputSource() <a id="SysDdcciObject.getInputSource" href="#SysDdcciObject.getInputSource">&#x23;</a>
获取输入源

### SysDdcciObject.getPowerMode() <a id="SysDdcciObject.getPowerMode" href="#SysDdcciObject.getPowerMode">&#x23;</a>
获取电源状态

### SysDdcciObject.hasFeature(vcpCode) <a id="SysDdcciObject.hasFeature" href="#SysDdcciObject.hasFeature">&#x23;</a>
是否支持 @vcpCode 指定的控制代码  
支持则返回包含可设置值的数组,数组可能为空,  
否则返回 null

### SysDdcciObject.reset() <a id="SysDdcciObject.reset" href="#SysDdcciObject.reset">&#x23;</a>
重置设置

### SysDdcciObject.resetColor() <a id="SysDdcciObject.resetColor" href="#SysDdcciObject.resetColor">&#x23;</a>
重置颜色设置

### SysDdcciObject.save() <a id="SysDdcciObject.save" href="#SysDdcciObject.save">&#x23;</a>
保存设置

### SysDdcciObject.setBrightness(value) <a id="SysDdcciObject.setBrightness" href="#SysDdcciObject.setBrightness">&#x23;</a>
设置亮度

### SysDdcciObject.setColorTemperature(value) <a id="SysDdcciObject.setColorTemperature" href="#SysDdcciObject.setColorTemperature">&#x23;</a>
设置色温

### SysDdcciObject.setContrast(value) <a id="SysDdcciObject.setContrast" href="#SysDdcciObject.setContrast">&#x23;</a>
设置对比度

### SysDdcciObject.setFeature(vcpCode,value) <a id="SysDdcciObject.setFeature" href="#SysDdcciObject.setFeature">&#x23;</a>
写入设置值  
@vcpCode 为控制代码,@value 为新的设置值

### SysDdcciObject.setInputSource(inputSource) <a id="SysDdcciObject.setInputSource" href="#SysDdcciObject.setInputSource">&#x23;</a>
修改输入源,  
@inputSource 用数值指定输入源

### SysDdcciObject.setPowerMode(mode) <a id="SysDdcciObject.setPowerMode" href="#SysDdcciObject.setPowerMode">&#x23;</a>
修改电源状态,  
@mode 为1表示打开屏幕，  
@mode 为 5 或 4 表示关闭屏幕
