编写3DMAX插件到发布上线全流程

一，账号问题

二，我的钱

四，插件下载与安装

五，CGtools客户端

六，模型素材问题

七，云渲染：常见问题

八，CGgogo项目交易

九，常见问题

十，开发教程

站点通知

编写3DMAX插件到发布上线全流程

本教程，为初级新手开发者教程，帮助开发者了解从编写MAX脚本，到TK发布上线，到拖拽使用全流程。

本教程，针对以下用户适用：

之前没有写过3DMAX脚本
想了解下整个流程
已经加入了TK开发者，想了解下如何发布工具
有兴趣继续看下去的人

本章节容所讲的学习路径：

3DMAX脚本编写 > 认证开发者 > 上传发布代码 > 调试测试代码 > 素材上传 > 代码更新 > 正式发布上线 > 用户拖拽使用

一，3DMAX脚本编写

1，进入3DMAX脚本编写

使用MAX自带脚本编辑器即可，不需要安装大型开发软件。
打开任意版本的3DMAX；
打开菜单 > MaxScript > NewScript（新建脚本文件）。

2，新建脚本文件后，打开是个空白文档。注意：

你的界面，可能和我不同，因为我设置了代码高亮。
如果你也想代码高亮，可以看看图夫以前写的教程：http://www.v5cg.com/thread-4845-1-1.html ，很简单的，照着做就行了。
设置了代码高亮，就是黑底的，代码是彩色的显示效果，不设置代码高亮，就是白底黑字。
如果觉得麻烦，这一步是可以跳过的，什么样的界面无所谓！！

3，正式编写代码：

程序员开始人生编程，写最简单的一句代码，一般都是写 hello word，世界你好啥的。
不过这里，你可以写你好他好大家好，当然，你可以像我一样，写一句： messagebox "这只是消息弹窗！"

4，运行代码：

代码已经写好了，就这么简单！
但是，写好代码，就只是文字字母而矣，要运行起来，才是程序，才有功能！
快快运行一下，看看自己写的是个啥。
快捷键是 ctrl E。
如果写错了，会报错，先不管报啥错，你只要知道，凡是报错了，就是自己写错了就行了。

5，运行结果

弹出来一个对话窗！
如果你已经走到了这一步，很幸运，你已经成功了！
可以把这一天记录下来，这是你成为3DMAX脚本开发者的第一步。
如果没走到这一步，那就认真回去看上面的步骤，重来！

6，增加功能

在前面的几个步骤了，非常开心的入门了。
但是，好像功能太简单了点：“我要成为超级开发者，我要写超级工具箱。。。我想，我想要一键渲染，我想要点一个按纽就渲染成图，我想要点一下就建好模型...”
不要急，一口吃不了个大胖子，一步步来。
先写个工具界面，加两个按纽吧。
把代码重写一下：

rollout gongju "工具界面窗口" width:200 height:100
(
button anniu1 "按纽1" pos:[5,10] width:190 height:30
button anniu2 "按纽2" pos:[5,45] width:190 height:30
)
CreateDialog gongju

7，写好之后，再按 ctrl E 运行一下。

再次恭喜你，一个面板上，两个按纽，你也会写了！
但是，写3个按纽，4个按纽，5个按纽，你会吗？你改改，自己写试试！

8，代码与界面的对应关系

rollout 是界面固定标识
gongju 是定义给程序看的主界面的名字，后面绿色双引号里的文字，是显示给人看的名字
button 是按纽的意思， anniu1 ，是给按纽1取的，给程序看的名字，后面引号里的中文，“按纽1”是给人看的名字
按纽2同上
如果要写按纽3，按纽4，自己按规则写就是了，试下吧
还有，点击按纽好像啥反应也没有啊？不会渲染，不会建模呀？什么鬼？？？
那可不，因为现在的按纽，只是个样子放在那，还没叫他们做事呢！
还没有给它们写上代码，点击的时候要他们干嘛呢！
接下来，给这个按纽加上真正的命令。

9，增加按纽事件

on anniu1 pressed do : 按纽1，按下的时候，去干点啥。。。
去干点啥？如果要干很多事，最好用括号括起来，注意，代码都用英文，不要出现中文括号了。。。
按纽2，要干点啥，你自己写，要么就先空着，往下学习。

10，按纽1点击后，弹出消息对话框。

好了，走到这一点，MAX脚本编写部分，演示结束。恭喜你已经入门了！
可以将代码发布到TK上去测试了！

二，工具发布

1，成为开发者

在工具发布前，必须先成为TK开发者，才能上传代码，发布工具；
认证成为开发者：http://tk.v5cg.com/help/98.html ；
从来没写过代码，我能认证吗？也可以的！没有经验，但想加入TK做开发的人，可以认证成为实习开发者；
实习期为30天，如果不能转正式开发者，以后还想继续在TK学习发布，可以再次申请加入。

2，进入工具发布：

成为TK开发者之后；
登录TK；
在右上角菜单 > 发布工具。

3，认真填写工具信息

工具名称：让用户找到，并能记住你的工具的名字。
工具图标：可以是动态图，但一定要做个漂亮的ICON，美观，让用户方便识别并记住。
软件分类：默认是3DMAX。
常用功能：你的工具是什么功能，就选什么项，可以多选。

4，上传代码

在TK有多种方式发布代码，在这里，只需要使用最简单的第一种，粘贴代码到这里即可。
将之前在3DMAX中编写好的代码，复制粘贴到这里即可。

rollout gongju "工具界面窗口" width:200 height:100
(
    button anniu1 "按纽1" pos:[5,10] width:190 height:30
    button anniu2 "按纽2" pos:[5,45] width:190 height:30

on anniu1 pressed do(
    messagebox "这是弹出来的消息1" title:"这是弹出来的消息头部标题！"
)

on anniu2 pressed do(
--    这里写你，按下按纽2时，想要干的事情的代码
)
)
CreateDialog gongju

5，设置工具价格

免费；
付费，周、月、年、永久；
是否可以让用户试用；

6，工具介绍

详细描述你的工具的功能和介绍；
工具的使用流程；
操作演示（加入开发者群，里面有专用的录制GIF动态图工具）；
视频教程；
以及其它的必要说明等；
标签：方便用户搜索的关键词；

7，确定发布

所有的选项先不管，以后慢慢了解即可。
同意 > 确定。

8，完成发布

提交成功，发布完成；
就这么简单，工具就在TK上面发布完成了。

9，后台管理

发布完成后，可以进入开发者后台，查看刚发布的工具，和所有发布过的工具。
最新发布的工具，需要进行审核，才能上线供用户使用。
待审核的工具：http://tk.v5cg.com/Developer/onConfirm.html

10，未上架状态

点击待审核的工具，进入到刚刚发布的这个工具的页面；
特别注意这个工具的网址，后面有个数字ID：1707，也就是这个工具的ID后，后面会用到；
对于开发者来说，即使工具还未审核上线，也是可以进行调试，可以直接使用的；
接下来，进行工具调试，看看能不能拖到MAX中使用。

三，工具调试

1，登录TK客户端

没有TK客户端的，先下载安装一下：http://tk.v5cg.com/toolkit ；
登录后，在TK客户端的最后一栏：【开发】；
【开发】栏，只有成为开发者之后，才可以看到这个功能；
在开发栏里，会列所所有该开发者发布过的工具，比如第一个，是刚刚发布的【我的工具】；
双击【我的工具】，弹出工具介绍。

2，测试使用

先不管三七二一，直接把工具从【开发】栏里，拖到MAX中运行。
如果出现了上图效果。恭喜你，一切顺利成功了！
恭喜你，会编写代码，并且成功发布到TK上面。
现在，只需通过管理员的审核，就可以供所有用户添加使用了。

四，完善功能

1，新的功能需求：

前面的功能太简单了点吧，就一个界面，两个按纽，啥功能都没有，如果就这样发布上线，一定会被有户笑话吧。
再说了，没有功能的工具，也不可能会通过审核上线啊。
那么，我们改进一下功能，我想要，在点击第二个按纽的时候，打开一张图片，可以吗？

2，修改代码

因为要让按纽二点击时，打开一个图片，需要两个动作（两个步骤）
步骤一：给按纽二，增加打开图片的功能
步骤二：做一个图片展示的窗口，要不然，图片没有东西来打开展示啊，是吧。
（当然，也可以用PS打开，可以用画图工具打开，可以用ACDSEE打开，不过这里，演示用MAX自己的窗口打开一张图片，因此，要定义一个图片窗口）
写代码的时候，可以先单独写一个窗口 rollout img ，然后，在按纽2里面，增加弹出rollout img窗口，并展示图片的功能。如上图所示。
这里要特别注意：打开图片的时候，用到了 tksucai + @“1707......”
tksucai ，是TK内置素材路径函数，先不用管这么多，先照着写
1707，是工具ID，前面工具发布的时候获得的
tksucai + 1707...的意思就是，在TK工具的素材里面，找到第1707个工具素材里面的...
tksucai的具体含义和使用方法，详见开发手册：http://tk.v5cg.com/help/99.html

3，运行测试

改完上面的代码后，先不管这么多，ctrl E，先运行测试下，看看效果。
咦，弹窗是有了，但是V5CG.JPG图片没有显示出来呀？
那是因为。图片路径里面使用的是tksucai，这是TK专用的调用方式，要在TK客户端里才能用的。

五，上传素材到CG云盘

1，打开CG云盘，上传工具素材

开发栏里面，工具右下角的小三角形，双击；
或者TK客户端最下面，点击CG云盘图标；
进入CG云盘 > 【开发者专栏】；
会看到每个工具，都有对应的云盘文件夹；
双击可以进入对应的工具云盘，用来存放该工具的素材。

2，上传素材

进入对应的工具云盘后；
将用到的图片，直接拖拽放到CG云盘中；
或点击左上角的【上传】功能，上传 v5cg.jpg 图片。

3，同步素材

素材上传后，表示开发者已经将该工具的相关素材上传了。
但是，如果你想使用的话，还得下载。因为你使用的时候，你也是用户状态，你的电脑里，还没有对应的素材，所有，要再下载一次，才能正常使用。
双击打开工具介绍，下面有个【更新素材】。

4，素材同步后

显示正常状态。这时素材已经下载同步到你电脑上了。
这时，虽然图片已经同步到你电脑上了，但是如果在MAX中运行，仍然是出不来的。
因为，刚才写的代码，还没更新发布上去呀。

六，更新代码

4，编辑工具

回到开发者后台，编辑工具。

5，粘贴新代码。

更新代码之后就完成了代码更新。
以下是全部代码。如果你复制来测试体验的话，记得改下ID号，每个工具都有自己专属的ID号，切记！

rollout img "pictrue windows - 打开图片窗口" width:964 height:298
(
    bitmap pictrue "图片" pos:[2,2] width:960 height:294
)

rollout gongju "工具界面窗口" width:200 height:100
(
    button anniu1 "按纽1" pos:[5,10] width:190 height:30
    button anniu2 "按纽2" pos:[5,45] width:190 height:30

    on anniu1 pressed do(
    messagebox "这是弹出来的消息1" title:"这是弹出来的消息头部标题！"
)

on anniu2 pressed do(
    CreateDialog img
    img.pictrue.fileName=tksucai+@"1707\V5CG.jpg" --外部图像文件
)
)
CreateDialog gongju