---++!! !PainterAppDev __description__: 鍦?D涓栫晫涓敤鐢荤瑪缁樺埗鍥炬鍜岃创鍥撅細鍙互鍦ㄥ彲鎹㈣创鍥剧殑3D妯″瀷涓婄粯鍒讹紝鍙互鐢ㄥ閮ㄥ浘鐗囷紝鐢靛奖锛孎lash鏂囦欢鍋氭ā鍨嬭创鍥 %TOC{title="Contents:"}% %STARTINCLUDE% ---++ Painter app for Paraworld | *Title* | Painter app for Paraworld | | *Author(s)* | LiXizhi | | *Date* | 2008/1/28 | | *File* | script/kids/3DMapSystemUI/Painter/app_main.lua | ---+++ Description [API] @param params: is a table of following optional field. if table is nil the current parameter is used. Map3DSystem.App.Commands.Call("File.Painter", { painter_width = 320, imagesize = 256, OnCloseCallBack = nil, OnSaveCallBack = nil, LoadFromTexture = "Texture/whitedot.png", }); db registration insert script INSERT INTO apps VALUES (NULL, 'Painter_GUID', 'Painter', '1.0.0', 'http://www.paraengine.com/apps/Painter_v1.zip', 'YourCompany', 'enUS', 'script/kids/3DMapSystemUI/Painter/IP.xml', '', 'script/kids/3DMapSystemUI/Painter/app_main.lua', 'Map3DSystem.App.Painter.MSGProc', 1); %T% __Sample Code__ <verbatim> NPL.load("(gl)script/kids/3DMapSystemUI/Painter/app_main.lua"); </verbatim> ---+++ Member Functions ---++++ !Map3DSystem.App.Painter.OnConnection requires create class commonlib.setfield("Map3DSystem.App.Painter", {}); ------------------------------------------- event handlers ------------------------------------------- OnConnection method is the obvious point to place your UI (menus, mainbars, tool buttons) through which the user will communicate to the app. This method is also the place to put your validation code if you are licensing the add-in. You would normally do this before putting up the UI. If the user is not a valid user, you would not want to put the UI into the IDE. * _param_ __app__ : the object representing the current application in the IDE. * _param_ __connectMode__ : type of Map3DSystem.App.ConnectMode. __syntax__ <verbatim>function Map3DSystem.App.Painter.OnConnection(app, connectMode)</verbatim> __parameters__ | *app* | the object representing the current application in the IDE. | | *connectMode* | | ---++++ !Map3DSystem.App.Painter.OnDisconnection Receives notification that the Add-in is being unloaded. __syntax__ <verbatim>function Map3DSystem.App.Painter.OnDisconnection(app, disconnectMode)</verbatim> __parameters__ | *app* | | | *disconnectMode* | | ---++++ !Map3DSystem.App.Painter.OnQueryStatus This is called when the command's availability is updated When the user clicks a command (menu or mainbar button), the QueryStatus event is fired. The QueryStatus event returns the current status of the specified named command, whether it is enabled, disabled, or hidden in the CommandStatus parameter, which is passed to the msg by reference (or returned in the event handler). * _param_ __commandName__ : The name of the command to determine state for. Usually in the string format "Category.SubCate.Name". * _param_ __statusWanted__ : what status of the command is queried. it is of type Map3DSystem.App.CommandStatusWanted * _return_ ____ : returns according to statusWanted. it may return an integer by adding values in Map3DSystem.App.CommandStatus. __syntax__ <verbatim>function Map3DSystem.App.Painter.OnQueryStatus(app, commandName, statusWanted)</verbatim> __parameters__ | *app* | | | *commandName* | The name of the command to determine state for. Usually in the string format "Category.SubCate.Name". | | *statusWanted* | | | *return* | returns according to statusWanted. it may return an integer by adding values in Map3DSystem.App.CommandStatus. | ---++++ !Map3DSystem.App.Painter.OnExec This is called when the command is invoked.The Exec is fired after the QueryStatus event is fired, assuming that the return to the statusOption parameter of QueryStatus is supported and enabled. This is the event where you place the actual code for handling the response to the user click on the command. * _param_ __commandName__ : The name of the command to determine state for. Usually in the string format "Category.SubCate.Name". __syntax__ <verbatim>function Map3DSystem.App.Painter.OnExec(app, commandName, params)</verbatim> __parameters__ | *app* | | | *commandName* | The name of the command to determine state for. Usually in the string format "Category.SubCate.Name". | | *params* | | ---++++ !Map3DSystem.App.Painter.OnRenderBox Change and render the 3D world with mcml data that is usually retrieved from the current user's profile page for this application. __syntax__ <verbatim>function Map3DSystem.App.Painter.OnRenderBox(mcmlData)</verbatim> __parameters__ | *mcmlData* | | ---++++ !Map3DSystem.App.Painter.Navigate called when the user wants to nagivate to the 3D world location relavent to this application __syntax__ <verbatim>function Map3DSystem.App.Painter.Navigate()</verbatim> ---++++ !Map3DSystem.App.Painter.GotoHomepage called when user clicks to check out the homepage of this application. Homepage usually includes: developer info, support, developer worlds information, app global news, app updates, all community user rating, active users, trade, currency transfer, etc. __syntax__ <verbatim>function Map3DSystem.App.Painter.GotoHomepage()</verbatim> ---++++ !Map3DSystem.App.Painter.DoQuickAction called when user clicks the quick action for this application. __syntax__ <verbatim>function Map3DSystem.App.Painter.DoQuickAction()</verbatim> ---++++ !Map3DSystem.App.Painter.MSGProc ------------------------------------------- client world database function helpers. ------------------------------------------- ------------------------------------------ all related messages ------------------------------------------ ----------------------------------------------------- APPS can be invoked in many ways: Through app Manager mainbar or menu command or buttons Command Line 3D World installed apps ----------------------------------------------------- __syntax__ <verbatim>function Map3DSystem.App.Painter.MSGProc(window, msg)</verbatim> __parameters__ | *window* | | | *msg* | | ---++ Painter App wrapper. | *Title* | Painter App wrapper. | | *Author(s)* | LiXizhi | | *Date* | 2008/1/28 | | *File* | script/kids/3DMapSystemUI/Painter/Painter.lua | ---+++ Description %T% __Sample Code__ <verbatim> NPL.load("(gl)script/kids/3DMapSystemUI/Painter/Painter.lua"); Map3DSystem.App.Painter.PainterAppWnd.ShowWnd(app); Map3DSystem.App.Painter.PainterAppWnd.Show(bShow, _parent, parentWindow) </verbatim> ---+++ Member Functions ---++++ !Map3DSystem.App.Painter.PainterAppWnd.ShowWnd common control library NPL.load("(gl)script/ide/common_control.lua"); NPL.load("(gl)script/kids/3DMapSystemUI/Painter/PainterManager.lua"); commonlib.setfield("Map3DSystem.App.Painter.PainterAppWnd", {}); display the main inventory window for the current user. __syntax__ <verbatim>function Map3DSystem.App.Painter.PainterAppWnd.ShowWnd(_app)</verbatim> __parameters__ | *app* | | ---++++ !Map3DSystem.App.Painter.PainterAppWnd.Show * _param_ __bShow__ : boolean to show or hide. if nil, it will toggle current setting. * _param_ ____ :_parent: parent window inside which the content is displayed. it can be nil. __syntax__ <verbatim>function Map3DSystem.App.Painter.PainterAppWnd.Show(bShow,_parent,parentWindow)</verbatim> __parameters__ | *bShow* | boolean to show or hide. if nil, it will toggle current setting. | | *parent* | | | *parentWindow* | | | *Title* | | | *Author(s)* | Leio, revised 2008.1.29 by LiXizhi, revised 2008.6.15 by LiXizhi | | *Date* | 2007/11/7 | | *File* | script/kids/3DMapSystemUI/Painter/PainterManager.lua | ---+++ Description ---+++ Member Functions ---++++ !PainterManager.ShowPainter show or hide the kids painter control * _param_ __alignment__ :, left, top: can be nil. default to "_lt",0,0 __syntax__ <verbatim>function PainterManager.ShowPainter(bShow, alignment, left, top,_parentWnd)</verbatim> __parameters__ | *bShow* | | | *alignment* | , left, top: can be nil. default to "_lt",0,0 | | *left* | | | *top* | | | *parentWnd* | | ---++++ !Map3DSystem.UI.PainterManager.OnClose this function should be called when window is closed. __syntax__ <verbatim>function Map3DSystem.UI.PainterManager.OnClose()</verbatim> ---++++ !PainterManager.SelectEraser select a eraser __syntax__ <verbatim>function PainterManager.SelectEraser()</verbatim> ---++++ !PainterManager.ScalePainter set the painter width to scale times the current size. __syntax__ <verbatim>function PainterManager.ScalePainter(scale)</verbatim> __parameters__ | *scale* | | ---++++ !PainterManager.LoadFromTexture load the painter with a given image __syntax__ <verbatim>function PainterManager.LoadFromTexture(filename)</verbatim> __parameters__ | *filename* | | ---++++ !PainterManager.OnClickSave called when user click the save button __syntax__ <verbatim>function PainterManager.OnClickSave()</verbatim> ---++++ !PainterManager.SaveAs save file to disk. undo operations will not be valid any more. __syntax__ <verbatim>function PainterManager.SaveAs(filename)</verbatim> __parameters__ | *filename* | | ---++++ !PainterManager.SetCurrentPen set the current pen all parameters can be nil * _param_ __color__ : e.g."255 0 0" * _param_ __width__ : in pixel such as 1,4,8 * _param_ __texture__ : if this is "", no texture will be used. __syntax__ <verbatim>function PainterManager.SetCurrentPen(color, width, texture)</verbatim> __parameters__ | *color* | e.g."255 0 0" | | *width* | | | *texture* | if this is "", no texture will be used. | ---++++ !PainterManager.GetImagePosition get the image position from the screen space mouse position __syntax__ <verbatim>function PainterManager.GetImagePosition(screen_x, screen_y)</verbatim> __parameters__ | *screen* | | | *x* | | | *screen* | | | *y* | | ---++++ !PainterManager.SmoothPath filterweight[0] = 0.4, filterweight[1] = 0.4 __syntax__ <verbatim>function PainterManager.SmoothPath(filterweight)</verbatim> __parameters__ | *filterweight* | | %STOPINCLUDE%
E
dit
|
A
ttach
|
P
rint version
|
H
istory
: r1
|
B
acklinks
|
V
iew topic
|
Ra
w
edit
|
M
ore topic actions
Topic revision: r1 - 2008-02-29
-
LiXizhi
Home
Site map
CCWeb web
HaqiTeen web
Main web
ParaEngine web
TWiki web
Main Web
Users
Groups
Index
Search
Changes
Notifications
RSS Feed
Statistics
导航页WebTopMenu
Preferences
开发指南
Getting Started
ParacraftSDK
NPL
MCML
NPL Reference Manual
美术Mod
Account
Log In
English
简体中文
簡體中文
E
dit
A
ttach
Copyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback