自娱自乐航空米

支 持 本 站: 捐赠服务器等运维费用，需要您的支持！

我不是一个程序员，也不懂python开发语言，
纯粹出于兴趣看了看这方面的资料，写个简单的入门资料，
希望能够抛砖引玉，期待今后不断有更多优秀的python 插件出现。

资源：
1. 本家的开发说明，作为入门很好。本文根据这篇作成。
http://www.xpluginsdk.org/downloads/Using%20Python%20with%20the%20PythonInterface%20Plugin.pdf

2. 本家提供的样例程序，一切还都是看代码吧，这是最好的学习方法。http://www.xpluginsdk.org/downloads/PythonScripts.zip

----------------------------------------------------

首先，你应该安装了PythonInterface吧，如果不知道的话，
在这个下载页面里有最新的版本，你一定要下载适合你机器的Python版本的PythonInterface.zip，
并安装到plugins目录下。PythonInterface对应的插件都放在PythonScripts目录下面。

源程序文件的扩展名应为.py，比如"helloworld.py"，
文件放到/Resources/plugins/PythonScipts目录下面。

支 持 本 站: 捐赠服务器等运维费用，需要您的支持！

一个最基本的程序框架如下，

class PythonInterface: 

   def XPluginStart(self):

    self.Name = "Template"

    self.Sig = "SandyBarbour.Python.Template"

    self.Desc = "A test script for the Python Interface."

    return self.Name, self.Sig, self.Desc

 

   def XPluginStop(self):

     pass

 def XPluginEnable(self):

return 1
 def XPluginDisable(self):

pass
 def XPluginReceiveMessage(self, inFromWho, inMessage, inParam):

pass

也就是要定义一个PythonInterface类，
由XPluginStart方法来启动该插件，由XPluginStop来关闭该插件，
由XPluginEnable和XPluginDisable来管理enable和disable该插件，
由XPluginReceiveMessage来接受系统发来的消息并处理。
pass的意思好像是什么都不做。

下面是可以在画面上显示窗口，显示框和文字所需要的函数，
from XPLMDisplay import *
XPLMCreateWindow() －－ 生成窗口
XPLMDestroyWindow() －－ 删除窗口
XPLMGetWindowGeometry() －－ 得到窗口的位置信息

from XPLMGraphics import *
XPLMDrawTranslucentDarkBox() －－ 显示一个半透明的灰色显示框
XPLMDrawString() －－ 显示字符串

生成窗口的例子如下，一般放到XPluginStart中，
self.WindowId = XPLMCreateWindow(self, 50, 600, 300, 400, 1, self.DrawWindowCB, self.KeyCB, self.MouseClickCB, 0)
并在XPluginStop中删除这个窗口，self.WindowId 为窗口id，
XPLMDestroyWindow(self, self.WindowId)。
self.DrawWindowCB, self.KeyCB, self.MouseClickCB分别指向窗口，键盘和鼠标的回调函数。

描画窗口需要定义函数DrawWindowCallback，
def DrawWindowCallback(self, inWindowID, inRefcon):
pass
可以在这个函数中使用
XPLMGetWindowGeometry(inWindowID, lLeft, lTop, lRight, lBottom)
得到窗口的坐标；
使用
gResult = XPLMDrawTranslucentDarkBox(left, top, right, bottom)
在指定的位置上显示半透明显示框；
还可以使用指定的颜色，位置和字体
gResult = XPLMDrawString(colour, left + 5, top - 20, Desc, 0, xplmFont_Basic)
来显示文本。

接受鼠标操作使用需要定义MouseClickCallback回调函数，
def MouseClickCallback(self, inWindowID, x, y, inMouse, inRefcon):
pass
鼠标是否按下可以通过inMouse的值来判断，如下所示：
if ((inMouse == xplm_MouseDown) or (inMouse == xplm_MouseUp)):
self.Clicked = 1 - self.Clicked

类似的，键盘操作需要KeyCallback函数，
def KeyCallback(self, inWindowID, inKey, inFlags, inVirtualKey, inRefcon, losingFocus):
pass

最基本的函数就是这些了，让我们看一下这个helloworld的程序，
它在画面上显示一个框，当按下鼠标是显示"I'm a plugin 1"文字，
送开鼠标后会显示"Hello World1"文字。

----------------------------------------------------------------------

from XPLMDisplay import *

from XPLMGraphics import *
class PythonInterface:

defXPluginStart(self):

self.Name = "Template"

self.Sig = "SandyBarbour.Python.Template"

self.Desc = "A test script for the Python Interface."

self.Clicked = 0

self.DrawWindowCB = self.DrawWindowCallback

self.KeyCB = self.KeyCallback

self.MouseClickCB = self.MouseClickCallback

self.WindowId = XPLMCreateWindow(self, 50, 600, 300, 400, 1, self.DrawWindowCB, self.KeyCB, self.MouseClickCB, 0)

return self.Name, self.Sig, self.Desc
 defXPluginStop(self):

XPLMDestroyWindow(self, self.WindowId)

pass
 defXPluginEnable(self):

return1



def XPluginDisable(self):

pass
 def XPluginReceiveMessage(self, inFromWho, inMessage, inParam):

pass
 def DrawWindowCallback(self, inWindowID, inRefcon):

lLeft = []; lTop = []; lRight = []; lBottom = []
 XPLMGetWindowGeometry(inWindowID, lLeft, lTop, lRight, lBottom)

left = int(lLeft[0]); top = int(lTop[0]); right = int(lRight[0]); bottom = int(lBottom[0])
 gResult = XPLMDrawTranslucentDarkBox(left, top, right, bottom)

colour = 1.0, 1.0, 1.0
 if self.Clicked:

Desc = "I'm a plugin 1"

else:

Desc = "Hello World1"



gResult = XPLMDrawString(colour, left + 5, top - 20, Desc, 0, xplmFont_Basic)

pass
 def KeyCallback(self, inWindowID, inKey, inFlags, inVirtualKey, inRefcon, losingFocus):

pass



def MouseClickCallback(self, inWindowID, x, y, inMouse, inRefcon):

if ((inMouse == xplm_MouseDown) or (inMouse == xplm_MouseUp)):

self.Clicked = 1- self.Clicked

return1

----------------------------------------------------------------------

完

支 持 本 站: 捐赠服务器等运维费用，需要您的支持！