罗技G系列外设宏命令编程参考文档.docx

1、1 G-series Lua API 参考文档 V8.50 预览与概述 2 手册手册目录目录 手册目录. 2 内容预览. 3 参考文档. 4 标准 Lua 5.1 库. 40 附录 A. 41 3 内容预览内容预览 G-series Lua API 参考手册是一套使用 Lua 脚本编程语言描述并且为 G-series 系列游戏键盘提 供高级脚本功能。 该文档是在假设您已初步掌握 Lua 脚本编程语言使用方法的前提下进行的。如果您想了解 更多信息请访问 www.lua.org。 每项 G 系列 的配置文件都有一个默认的 Lua 脚本与其绑定，并且您可以根据您的喜好随意编辑 或者自定义。该脚本借助

2、并使用一个名为 OnEvent 的事件句柄。用户可以通过检查此句柄中触 发的各种事件以执行用户所希望的动作。 4 参考文档参考文档 方法列表方法列表 OnEvent. 5 GetMKeyState. 7 SetMKeyState . 8 Sleep . 9 OutputLogMessage. 10 GetRunningTime. 11 GetDate . 12 ClearLog. 13 PressKey . 14 ReleaseKey. 15 PressAndReleaseKey. 16 IsModifierPressed. 17 PressMouseButton. 18 ReleaseMou

3、seButton . 19 PressAndReleaseMouseButton. 20 IsMouseButtonPressed . 21 MoveMouseTo . 22 MoveMouseWheel . 23 MoveMouseRelative. 24 MoveMouseToVirtual . 25 GetMousePosition. 26 OutputLCDMessage. 27 ClearLCD. 28 PlayMacro. 29 AbortMacro. 30 IsKeyLockOn . 31 SetBacklightColor. 32 OutputDebugMessage . 33

4、 SetMouseDPITable. 34 SetMouseDPITableIndex. 35 EnablePrimaryMouseButtonEvents. 36 G13 Programming. 37 5 OnEvent OnEvent() 方法为脚本提供了一系列事件句柄以方便用户对触发的事件进行操作，您可以使用 以下代码实现此方法。 function OnEvent(event, arg , family) end 参数列表参数列表 event 该字符串包含了用户所触发的事件名称。 arg 与事件标识符相对应的参数值。 family 触发硬件事件的设备族，如果您确定您的脚本不针对于特定硬

5、件则将其留空即 可。仅当您确定需要区分多个输入时使用此参数。 设备族特定设备特定设备 “kb”键盘设备 (G15, G11, G19, etc) “lhc”左手用控制器 (G13, etc) “mouse”受支持的鼠标 (G300, G400, etc) 返回值返回值 无返回值 备注信息备注信息 下方列表是事件标识符以及其对应参数值： 事件名事件名参数值参数值描述信息描述信息 PROFILE_ACTIVATED无配置文件被激活时，此事件 为脚本的第一个事件。 PROFILE_DEACTIVATED无配置文件被反激活时，此事件 为脚本的最后一个事件。 G_PRESSED1=G1 18=G18 n

6、 = Gn G Key 按下时 G_RELEASED1=G1 18=G18 n = Gn G Key 释放时 M_PRESSED1=M1 2=M2 3=M3 M Key 按下时 M_RELEASED1=M1M Key 释放时 6 2=M2 3=M3 “MOUSE_BUTTON_PRESSED”2=鼠标按键 2 3=鼠标按键 3 4=鼠标按键 4 鼠标按键被按下时 注意：鼠标左键 (1) 默认将不会 对此事件进行回应。您可以使用 EnablePrimaryMouseButtonEvents 方法将其覆盖。 “MOUSE_BUTTON_RELEASED”2=鼠标按键 2 3=鼠标按键 3 4=鼠标

7、按键 4 . 注意：鼠标左键 (1) 默认将不会 对此事件进行回应。您可以使用 EnablePrimaryMouseButtonEvents 方法将其覆盖。 代码示范代码示范 - 此事件作为主事件句柄 - 您必须首先实现该方法 function OnEvent(event, arg) if (event = PROFILE_ACTIVATED) then - 配置文件已被激活 end if (event = PROFILE_DEACTIVATED) then - 配置文件已被反激活 end if (event = G_PRESSED and arg = 1) then - G1 已被按下 en

8、d if (event = G_RELEASED and arg = 1) then - G1 已被释放 end if (event = M_PRESSED and arg = 1) then - M1 已被按下 end if (event = M_RELEASED and arg = 1) then - M1 已被释放 end if (event = MOUSE_BUTTON_PRESSED and arg = 6) then - 鼠标按键 6 已被按下 End if (event = MOUSE_BUTTON_RELEASED and arg = 6) then - 鼠标按键 6 已被释放

9、 end end 7 GetMKeyState GetMKeyState() 返回当前 M Key 状态值。 mkey GetMKeyState(family); 参数列表参数列表 family 当您希望区分多个输入设备时请使用该可选设备族属性，默认为 “kb”。 设备族设备族特定设备特定设备 “kb”键盘设备 (G15, G11, G19, etc) “lhc”左手用控制器 (G13, etc) 返回值返回值 mkey 1 = M1, 2 = M2, 3 = M3 备注信息备注信息 代码示范代码示范 - 获取当前 M Key 状态 current_mkey = GetMKeyState()

10、8 SetMKeyState SetMKeyState() 可以设置当前 M keys 激活状态。请注意：如果您紧接着该方法调用 GetMKeyState 方法将返回上次状态码。使用 OnEvent 句柄以确定当前操作是否完成。 mkey SetMKeyState(mkey, family); 参数列表参数列表 mkey 1 = M1, 2 = M2, 3 = M3 family 当您希望区分多个输入设备时请使用该可选设备族属性，默认为 “kb”。 设备族设备族特定设备特定设备 “kb”键盘设备 (G15, G11, G19, etc) “lhc”左手用控制器 (G13, etc) 返回值返回

11、值 无返回值 备注信息备注信息 代码示范代码示范 - 当 G1 被按下时设置当前 M Key 状态为 M1 function OnEvent(event, arg) if (event = G_PRESSED and arg = 1) then SetMkeyState(1); end end 9 Sleep Sleep() 方法将导致脚本暂停并等待所设置的时间后再继续执行。 Sleep( timeout ); 参数列表参数列表 timeout 以毫秒为单位的睡眠时间。 返回值返回值 nil 备注信息备注信息 脚本运行于主程序性能分析器不同的线程，所以脚本暂停时不会对其产生影响。 您可以使用此

12、功能模拟操作延时。 性能分析器将等待一秒以使脚本执行完毕，超过该时间脚本将被强制中断。请务必注 意不要进行长时间的延时。 代码示范代码示范 - 睡眠 20 毫秒 Sleep(20) 10 OutputLogMessage OutputLogMessage() 将输出日志消息至脚本编辑器的控制台操作窗中。 OutputLogMessage( . ); 参数列表参数列表 message 输出样式、包含格式化字符串的消息文本。 返回值返回值 nil 备注信息备注信息 string.format() 方法镜像。 您需要手动在末尾插入回车符 n 以结束该段文本。 代码示范代码示范 - 输出文本 Hell

13、o World OutputLogMessage(Hello World %dn, 2007) 11 GetRunningTime GetRunningTime() 方法将返回以毫秒为单位的执行脚本总时间。 elapsed GetRunningTime(); 参数列表参数列表 无 返回值返回值 elapsed 一个包含运行总毫秒时间的整数值。 备注信息备注信息 您可以使用此方法计算您脚本的运行时间。. 代码示范代码示范 - 显示脚本运行时间 OutputLogMessage(This script has been running for: %d ms, GetRunningTime() 12

14、 GetDate GetDate() 方法将获取已格式化的当前时间 date GetDate (format , time) 参数列表参数列表 format 可选的日期字符串格式。 time 可选的时间表。 返回值返回值 date 返回一个包含用户计算机当前日期以及时间（或参考时间）的字符串或时间表， 根据所给的字符串格式就行字符串格式化，如果您希望提供自有格式化字符串，该方法将 使用与 strftime() 相同的解析规则。特殊字符串 *t 将使 date() 方法返回一个时间表。 备注信息备注信息 os.date() 方法镜像。 Example - 显示当前日期与时间 OutputLogM

15、essage(Todays date/time is: %sn, GetDate() 13 ClearLog ClearLog() 方法将清空脚本编辑器控制台中的输出内容。 ClearLog() 参数列表参数列表 无 返回值返回值 nil 备注信息备注信息 无 代码示范代码示范 - 清空脚本编辑器日志 OutputLogMessage(This message will self destruct in 2 secondsn) Sleep(2000) ClearLog() 14 PressKey PressKey() 方法可被用于模拟键盘按键按下动作。请注意：如果您紧接着该方法调用 IsMod

16、ifierPressed 方法或 IsKeyLockOn 方法将返回上次状态码。您需要等待几毫秒使其结 束操作以确定当前操作是否完成。 PressKey( scancode ,scancode ); PressKey( keyname ,keyname ); 参数列表参数列表 scancode 特定数值扫描码对应的按键将被按下。 keyname 特定预定义键值对应的按键将被按下。 返回值返回值 nil 备注信息备注信息 如果提供了多个按键作为实际参数，所有按键将被模拟为同一时间按下。关于扫描 码或键值对应列表您可以参考附录 A。 代码示范代码示范 - 使用扫描码模拟键值 a 被按下 Press

17、Key(30) - 使用键值模拟键值 a 被按下 PressKey(a) - 模拟 a 与 b 同时按下 PressKey(a, b) 15 ReleaseKey ReleaseKey() 方法可被用于模拟键盘按键释放动作。 ReleaseKey( scancode ,scancode ); ReleaseKey( keyname ,keyname ); 参数列表参数列表 scancode 特定数值扫描码对应的按键将被释放。 keyname 特定数值键值对应的按键将被释放。 返回值返回值 nil 备注信息备注信息 如果提供了多个按键作为实际参数，所有按键将被模拟为同一时间释放。关于扫描 码或键

18、值对应列表您可以参考附录 A。 备注信息备注信息 - 使用扫描码模拟键值 a 被释放 ReleaseKey(30) - 使用键值模拟键值 a 被释放 ReleaseKey(a) - 模拟 a 与 b 同时释放 ReleaseKey(a, b) 16 PressAndReleaseKey PressAndReleaseKey() 方法可被用于模拟键盘按键按下动作并跟随按键释放动作。请注意：如 果您紧接着该方法调用 IsModifierPressed 方法或 IsKeyLockOn 方法将返回上次状态码。您 需要等待几毫秒使其结束操作以确定当前操作是否完成。 ReleaseKey( scancod

19、e ,scancode); ReleaseKey( keyname ,keyname ); Parameters scancode 特定数值扫描码对应的按键将被按下并随后被释放。 keyname 特定数值键值对应的按键将被按下并随后被释放。 返回值返回值 nil 备注信息备注信息 如果提供了多个按键作为实际参数，所有按键将被模拟为同一时间按下并随后释放。关于扫 描码或键值对应列表您可以参考附录 A。 Example - 使用扫描码模拟键值 a 被按下并随后被释放 PressAndReleaseKey(30) - 使用键值模拟键值 a 被按下并随后被释放 PressAndReleaseKey(a

20、) - 模拟 a 与 b 同时按下并随后释放 PressAndReleaseKey(a, b) 17 IsModifierPressed IsModifierPressed() 方法可用于确定某修饰键是否被按下。 boolean IsModifierPressed ( keyname ); 参数列表参数列表 keyname 特定预定义的修饰键键值是否被按下，该参数必须为下列表值之一： 修饰键修饰键描述信息描述信息 lalt, ralt, alt左侧、右侧或两侧 Alt 键 lshift, rshift, shift左侧、右侧或两侧 Shift 键 lctrl, rctrl, ctrl左侧、右侧

21、或两侧 Ctrl 键 返回值返回值 当修饰键被按下时将返回 true 反之则返回 false。 备注信息备注信息 无 代码示范代码示范 - 模拟按下特定修饰键 PressKey(lshift) if IsModifierPressed(shift) then OutputLogMessage(shift is pressed.n); end - 释放该修饰键 ReleaseKey(lshift) if not IsModifierPressed(shift) then OutputLogMessage(shift is not pressed.n); end 18 PressMouseButt

22、on PressMouseButton() 方法可被用于模拟鼠标按键被按下。请注意：如果您紧接着该方法调用 IsMouseButtonPressed 方法将返回上次状态码。您需要等待几毫秒使其结束操作以确定当 前操作是否完成。 PressMouseButton( button ) 参数列表参数列表 button 按键标识符，您可以使用下表中列出的值： 按键值按键值对应操作对应操作 1鼠标左键 2鼠标中键 3鼠标右键 4鼠标按键 X1 5鼠标按键 X2 返回值返回值 nil 备注信息备注信息 无 代码示范代码示范 - 模拟鼠标左键被按下 PressMouseButton(1) - 模拟鼠标右键被

23、按下 PressMouseButton(3) 19 ReleaseMouseButton ReleaseMouseButton() 方法可被用于模拟鼠标按键被释放。 ReleaseMouseButton( button ) 参数列表参数列表 button 按键标识符，您可以使用下表中列出的值： 按键值按键值对应操作对应操作 1鼠标左键 2鼠标中键 3鼠标右键 4鼠标按键 X1 5鼠标按键 X2 返回值返回值 nil 备注信息备注信息 无 代码示范代码示范 - 模拟鼠标左键单击（按下并释放） PressMouseButton(1) ReleaseMouseButton(1) 20 PressAn

24、dReleaseMouseButton PressAndReleaseMouseButton()方法可被用于模拟鼠标按键按下动作并跟随按键释放动作。请 注意：如果您紧接着该方法调用 IsMouseButtonPressed 方法将返回上次状态码。您需要等待几 毫秒使其结束操作以确定当前操作是否完成。 PressAndReleaseMouseButton( button ) 参数列表参数列表 button 按键标识符，您可以使用下表中列出的值： 按键值按键值对应操作对应操作 1鼠标左键 2鼠标中键 3鼠标右键 4鼠标按键 X1 5鼠标按键 X2 返回值返回值 nil 备注信息备注信息 无 代码示

25、范代码示范 - 模拟鼠标左键单击（按下并释放） PressAndReleaseMouseButton(1) 21 IsMouseButtonPressed IsMouseButtonPressed() 方法可用于确定某鼠标按键是否被按下。 boolean IsMouseButtonPressed( button ) 参数列表参数列表 button 按键标识符，您可以使用下表中列出的值： 按键值按键值对应操作对应操作 1鼠标左键 2鼠标中键 3鼠标右键 4鼠标按键 X1 5鼠标按键 X2 返回值返回值 当修饰键被按下时将返回 true 反之则返回 false。 备注信息备注信息 无 代码示范代码

26、示范 - 按下鼠标按键 PressMouseButton(1) if IsMouseButtonPressed(1) then OutputLogMessage(Left mouse button is pressed.n); end - 释放该鼠标按键 ReleaseMouseButton(1) if not IsMouseButtonPressed(1) then OutputLogMessage(Left mouse button is not pressed.n); end 22 MoveMouseTo MoveMouseTo() 方法可被用于移动鼠标指针至屏幕中的目标绝对坐标位置。请

27、注意：如果您紧接 着该方法调用 GetMousePosition 方法将返回上次状态码。您需要等待几毫秒使其结束操作以确 定当前操作是否完成。 MoveMouseTo( x, y, ) 参数列表参数列表 x 标准 x 极坐标介于 0（极左）至 65535（极右）。 Y 标准 y 极坐标介于 0（极左）至 65535（极右）。 返回值返回值 nil 备注信息备注信息 如果您接入了多个显示器请使用 MoveMouseToVirtual 方法代替。 代码示范代码示范 - 移动鼠标至左上角 MoveMouseTo(0, 0) - 移动鼠标至屏幕中央 MoveMouseTo(32767, 32767)

28、- 移动鼠标至右下角 MoveMouseTo(65535, 65535) 23 MoveMouseWheel MoveMouseWheel() 方法可被用于模拟鼠标滚轮滚动。 MoveMouseWheel( click ) Parameters click 鼠标滚轮滚动次数。 返回值返回值 nil 备注信息备注信息 如果您输入的为正数，那么将模拟向上滚动（远离用户），如果您输 入的为负数，那么将模拟向下滚动（面向用户）。 代码示范代码示范 - 模拟鼠标滚轮向上滚动 3 次 MoveMouseWheel(3) - 模拟鼠标滚轮向下滚动 1 次 MoveMouseWheel(-1) 24 Move

29、MouseRelative MoveMouseRelative() 方法可被用于模拟鼠标相对当前坐标的偏移量。请注意：如果您紧接 着该方法调用 GetMousePosition 方法将返回上次状态码。您需要等待几毫秒使其结束操作以 确定当前操作是否完成。 MoveMouseRelative( x, y, ) 参数列表参数列表 x 沿 x 轴方向移动 Y 沿 y 轴方向移动 返回值返回值 nil 备注信息备注信息 如果您输入的 x 轴偏移量为正数，那么将模拟向右 移动，如果您输入的 x 轴偏移量为负数，那么将模 拟向左移动。如果您输入的 y 轴偏移量为正数，那 么将模拟向下移动，如果您输入的 y

30、 轴偏移量为负 数，那么将模拟向上移动。 Example - 模拟鼠标相对当前坐标移动偏移量为 1 像素并重复 50 次 for i = 0, 50 do MoveMouseRelative(0, -1) Sleep(8) end 25 MoveMouseToVirtual MoveMouseToVirtual() 方法可被用于在多个屏幕中移动鼠标指针至当前屏幕中的目标绝对坐标 位置。请注意：如果您紧接着该方法调用 GetMousePosition 方法将返回上次状态码。您需要等 待几毫秒使其结束操作以确定当前操作是否完成。 MoveMouseToVirtual( x, y, ) Parame

31、ters x 标准 x 极坐标介于 0（极左）至 65535（极右）。 Y 标准 y 极坐标介于 0（极左）至 65535（极右）。 返回值返回值 nil 备注信息备注信息 如果您接入了多个显示器请使用 MoveMouseToVirtual 方法代替。 代码示范代码示范 - 移动鼠标至虚拟桌面中的左上角 MoveMouseToVirtual(0, 0) - 移动鼠标至虚拟桌面中的中央 MoveMouseToVirtual (32767, 32767) - 移动鼠标至虚拟桌面中的右下角 MoveMouseToVirtual (65535, 65535) 26 GetMousePosition G

32、etMousePosition() 方法可被用于获取鼠标指针当前相对标准坐标。 x,y GetMousePosition( ) 参数列表参数列表 无 返回值返回值 x 标准 x 极坐标介于 0（极左）至 65535（极右）。 Y 标准 y 极坐标介于 0（极左）至 65535（极右）。 备注信息备注信息 代码示例代码示例 - 获取当前鼠标指针坐标 x, y = GetMousePosition(); OutputLogMessage(Mouse is at %d, %dn, x, y); 27 OutputLCDMessage OutputLCDMessage() 方法可被用于向 LCD 添加

33、单行文本。 OutputLCDMessage( text ,timeout ) 参数列表参数列表 text 待显示字符串 timeout 超时时间为毫秒，等待超时后该消息将被删除。 返回值返回值 nil 备注信息备注信息 您可以一次向设备添加并显示至多四条文本信息，默认超时时间为 1 秒。 代码示范代码示范 - 使用默认超时显示文本 OutputLCDMessage(Hello world) - 显示文本并设置 2 秒超时时间 OutputLCDMessage(Hello world, 2000) 28 ClearLCD ClearLCD() 方法可用于清除由脚本输出在 LED 中的字符串。

34、ClearLCD( ) 参数列表参数列表 无 返回值返回值 nil 备注信息备注信息 代码示范代码示范 - 清理 LED 已显示内容并输出两条文本信息 ClearLCD () OutputLCDMessage(Hello world1) OutputLCDMessage(Hello world2) 29 PlayMacro PlayMacro() 方法可被用于播放已存在宏脚本。 PlayMacro( macroname ) 参数列表参数列表 macroname 您需要指定在当前配置文件中已存在的宏脚本名称。 返回值返回值 nil 备注信息备注信息 如果该方法在其他宏脚本播放时被调用则不会采取任

35、何操作。换而言之，在同一段时间内 仅可播放一个宏脚本而无法同时播放数个宏脚本。 然而如果调用并播放相同的一个宏脚本那么该宏脚本将被排入队列并在稍后播放。 代码示范代码示范 - 播放已存在宏脚本 PlayMacro(my macro); 30 AbortMacro AbortMacro() 方法可被用于中断当前任何已在播放的宏脚本。 AbortMacro( ) 参数列表参数列表 无 返回值返回值 nil 备注信息备注信息 在调用 PlayMacro 方法时播放宏脚本过程中按下的所有按键将被释放，然而由外部播放 的宏脚本仍将继续运行而不受影响。 Example - 播放宏脚本 PlayMacro(

36、my macro) - 等待 100 毫秒并将正在播放的宏脚本中断 AbortMacro() 31 IsKeyLockOn IsKeyLockOn() 方法可用于确定锁定键是否处于启用状态。 IsKeyLockOn( key ) 参数列表参数列表 key 键值名可参考下表： 键值键值对应操作对应操作 scrolllock滚动锁定 capslock大小写锁定 numlock数字键锁定 返回值返回值 当锁定键启用时将返回 true 反之则返回 false。 备注信息备注信息 无 代码示范代码示范 - 检查数字键锁定是否被启用，如果启用则将其关闭 if ( IsKeyLockOn(numlock )

37、 then PressAndReleaseKey(numlock); end 32 SetBacklightColor SetBacklightColor() 方法被用于设置自定义设备背光灯颜色（如果您的设备支持自定义背光 灯）。 SetBacklightColor(red, green, blue, family) 参数列表参数列表 red 红色阈值范围 (0 255)。 green 绿色阈值范围 (0 255)。 blue 蓝色阈值范围 (0 255)。 family 当您希望区分多个输入设备时请使用该可选设备族属性，默认为 “kb”。 设备族设备族特定设备特定设备 “kb”键盘设备 (G

38、15, G11, G19, etc) “lhc”左手用控制器 (G13, etc) 返回值返回值 nil 备注信息备注信息 无 备注信息备注信息 - 设置背光灯为红色 SetBacklightColor(255, 0, 0); - 为所有左手用控制器设备设置背光灯为蓝色 SetBacklightColor(0, 0, 255, “lhc”); 33 OutputDebugMessage OutputDebugMessage() 方法将发送日志消息至 Windows 脚本调试器。 OutputDebugMessage( . ); 参数列表参数列表 Message 输出样式、包含格式化字符串的消息

39、文本。 返回值返回值 nil 备注信息备注信息 string.format() 方法镜像。 您需要手动在末尾插入回车符 n 以结束该段文本。您可以使用类似 于 Dbg 查看器等工具查看这些输出的消息。 代码示范代码示范 - 输出文本 Hello World OutputDebugMessage(Hello World %dn, 2007) 34 SetMouseDPITable SetMouseDPITable() 方法可向已支持的游戏鼠标设置当前 DPI 表中的数值。 SetMouseDPITable(value1, value2, value3, index); 参数列表参数列表 DPI

40、Array DPI 数值数组 DPI Index 可选并从 1 开始的 DPI 索引值以直接应用该 DPI 数值。 返回值返回值 nil 备注信息备注信息 如果您不指定索引值，那么将使用首条 DPI 数值设为当前值，您最多 可以添加 16 条数值。 当您激活新配置文件时将使用该 DPI 设置覆盖上次状态。 Example - 设置 DPI 数值为 500, 1000, 1500, 2000, 2500 - 默认状态下，500 DPI 将被设为当前 DPI 数值 SetMouseDPITable(500, 1000, 1500, 2000, 2500) - 设置 DPI 数值为 500, 250

41、0 并设置第二个数值为当前 DPI 数值 SetMouseDPITable(500, 2500, 2) 35 SetMouseDPITableIndex SetMouseDPITableIndex() 方法可向已支持的游戏鼠标通过 DPI 表索引值设置 DPI。 SetMouseDPITableIndex(index); 参数列表参数列表 Index 基于 1 开始的 DPI 表索引值。 返回值返回值 nil 备注信息备注信息 如果未曾调用 SetMouseDPITable 方法则将使用鼠标中现有 DPI 表。您最多可以添加 16 条数值。 当您激活新配置文件时将使用该 DPI 设置覆盖上次状

42、态。 代码示范代码示范 - 设置初始 DPI 数值为 500, 1000, 1500, 2000, 2500 SetMouseDPITable(500, 1000, 1500, 2000, 2500) - 设置当前 DPI 为表中第三项 (1500 DPI) SetMouseDPITableIndex(3); 36 EnablePrimaryMouseButtonEvents EnablePrimaryMouseButtonEvents() 方法将启用鼠标按键 1 的事件报告。 EnablePrimaryMouseButtonEvents(enable); 参数列表参数列表 enable 1

43、或 true 以启用鼠标按键 1 事件报告 0 或 false 以禁用鼠标按键 1 事件报告 返回值返回值 nil 备注信息备注信息 出于性能上的原因考虑，鼠标左键按键默认将不对触发事件进行报告。 代码示范代码示范 - 启用鼠标按键 1 事件报告 EnablePrimaryMouseButtonEvents(true); - 禁用鼠标按键 1 事件报告 EnablePrimaryMouseButtonEvents(false); 37 G13 可编程按键可编程按键 G13 游戏面板具有一个可以模拟鼠标的摇杆，您可以为其分配一些鼠标功能。您可以通过在设置 窗口中的配置文件选项面板或通过 Lua

44、脚本语言控制由摇杆所模拟鼠标的移动速度。以下实例可 帮助您使用 Lua 方法控制鼠标运行状态： SetMouseSpeed () 参数列表参数列表 New mouse speed 鼠标绝对移动速度由 32 至 255。 返回值返回值 nil 备注信息备注信息 无 代码示范代码示范 - 设置鼠标移动速度至 128 SetMouseSpeed(128); GetMouseSpeed() 参数列表参数列表 Current mouse speed 当前鼠标的绝对移动速度。 返回值返回值 当前模拟鼠标的移动速度 备注信息备注信息 无 代码示范代码示范 - 获取鼠标移动速度 OutputLogMessag

45、e(The Mouse Speeed is: %dn”, GetMouseSpeed(); 38 IncrementMouseSpeed() 参数列表参数列表 Mouse speed increment 返回值返回值 nil 备注信息备注信息 加快鼠标速度最大值将被限制至 255。 代码示范代码示范 - 增加鼠标移动速度是 10 IncrementMouseSpeed(10); DecrementMouseSpeed() 参数列表参数列表 Mouse speed decrement 返回值返回值 nil 备注信息备注信息 降低鼠标速度最小值将被限制至 32。 代码示范代码示范 - 降低鼠标移动

46、速度至 10 DecrementMouseSpeed(10); 39 G13 鼠标不具备任何原生按键，例如左键、中键以及右键等。鼠标按键必须通过 Lua 进行编程。您 可以通过这个示例了解如何使用通用 Lua 代码实现鼠标按键触发操作： if event=G_PRESSED and arg=x then PressMouseButton( y ); end if event=G_RELEASED and arg=x then ReleaseMouseButton( y ); 40 标准标准 Lua 5.1 库库 以下函数为受支持的标准库函数： string.byte string.char s

47、tring.dump string.find string.format string.gmatch string.gsub string.len string.lower string.match string.rep string.reverse string.sub string.upper table.concat table.insert table.maxn table.remove table.sort math.abs math.acos math.asin math.atan math.atan2 math.ceil math.cos math.deg math.exp ma

48、th.floor math.fmod math.frexp math.huge math.ldexp math.log math.log10 math.max math.min math.modf math.pi math.pow math.rad math.random math.randomseed math.sin math.sinh math.sqrt math.tan math.tanh 41 附录附录 A 该表中所有键值以及扫描值可被用于 PressKey(), ReleaseKey(), IsModifierPressed() 方法。 键值键值扫描值（十六进制）扫描值（十六进制）

49、 escape0 x01 f10 x3b f20 x3c f30 x3d f40 x3e f50 x3f f60 x40 f70 x41 f80 x42 f90 x43 f100 x44 f110 x57 f120 x58 f130 x64 f140 x65 f150 x66 f160 x67 f170 x68 f180 x69 f190 x6a f200 x6b f210 x6c f220 x6d f230 x6e f240 x76 printscreen0 x137 scrolllock0 x46 pause0 x146 tilde0 x29 10 x02 20 x03 30 x04 40

50、 x05 50 x06 60 x07 70 x08 80 x09 90 x0a 00 x0b minus0 x0c equal0 x0d backspace0 x0e tab0 x0f q0 x10 w0 x11 e0 x12 r0 x13 t0 x14 y0 x15 42 u0 x16 I0 x17 o0 x18 p0 x19 lbracket0 x1a rbracket0 x1b backslash0 x2b capslock0 x3a a0 x1e s0 x1f d0 x20 f0 x21 g0 x22 h0 x23 j0 x24 k0 x25 l0 x26 semicolon0 x27