Cocos Creator TS代码智能提示

最新推荐文章于 2024-07-29 22:14:57 发布

置顶大掌教

最新推荐文章于 2024-07-29 22:14:57 发布

阅读量7.5k

点赞数

分类专栏： Cocos Creator 文章标签： cocos creator 智能提示 typescript 3d

本文链接：https://blog.csdn.net/dawn_moon/article/details/90676743

版权

Cocos Creator 专栏收录该内容

9 篇文章 3 订阅

订阅专栏

Cocos Creator支持JS和TS两种脚本，在这里我强烈建议使用TS来做脚本开发。有几个比较重要的原因：

TS本身是JS的超集，完全兼容js
TS有静态语言特性，代码易于阅读和维护
近乎完美的智能提示，而JS的代码提示几乎没有

在Creator里面写TS，要实现代码智能提示，需要手动添加申明文件，步骤如下：
点击菜单 开发者->VS Code 工作流->更新VS Code智能提示数据。

点这个菜单，实际上就是把引擎目录下的模板文件creator.d.ts拷贝到了你的项目目录下，这个模板文件是引擎开发组写好了放在引擎目录下的，每个版本都有对应的实现。

在Creator的新版本预发布的阶段，通常这个声明文件很不完善，这就导致很多接口提示没有，写代码就会爆红，对于有强迫症的同学来说，可能总是会想办法把爆红的提示去掉。

找到引擎安装目录，打开文件夹resources\utils\api，可以看到有一个creator.d.ts文件，这个文件就是操作Creator编辑器的时候拷贝到项目目录下的。我们只要修改了这个文件，所有项目都可以更新。

修改智能提示有两种方式，一种是修改引擎的creator.d.ts，另一种是自己新建一个自己的声明文件，例如我的捕鱼里面就是自己定义了一个global.d.ts。

在1.93版本的时候，我把shader相关的隐藏接口全部写在这个声明文件里面，代码如下

declare module cc {
    /**
     * 实现WebGL program的类，用来做shader编程
     */
    export class GLProgram{
        /**
         * 实现WebGL program的类，用来做shader编程
         */
        constructor();
        /**
         * 使用顶点shader字符串和片段shader字符串初始化cc.GLProgram
         * @param vertShaderStr 顶点shader字符串
         * @param fragShaderStr 片段shader字符串
         */
        initWithString(vertShaderStr: string, fragShaderStr: string): boolean;

        /**
         * It will add a new attribute to the shader
         * @param attributeName 
         * @param index 
         */
        addAttribute(attributeName: number, index: number);
        /**
         * Initializes the cc.GLProgram with a vertex and fragment with string
         * @param vertShaderStr 
         * @param fragShaderStr 
         */
        initWithVertexShaderByteArray(vertShaderStr: string, fragShaderStr: string):boolean;

        /**
         * 连接 glprogram
         */
        link(): boolean;
        
        /**
         * 这个函数创建4个统一变量即uniform 
         *  cc.macro.UNIFORM_PMATRIX
         *  cc.macro.UNIFORM_MVMATRIX
         *  cc.macro.UNIFORM_MVPMATRIX
         *  cc.macro.UNIFORM_SAMPLER
        */
        updateUniforms();

        /**
         * it will call gl.useProgram()
         */
        use();

        /**
         * calls retrieves the named uniform location for this shader program.
         * @param name 
         */
        getUniformLocationForName(name: string): number;

        /**
         * calls glUniform1f only if the values are different than the previous call for this same shader program.
         * @param location 
         * @param f1 
         */
        setUniformLocationWith1f(location, f1);

        /**
         * calls glUniform2f only if the values are different than the previous call for this same shader program.
         * @param location 
         * @param f1 
         * @param f2 
         */
        setUniformLocationWith2f(location,f1,f2)
    }

    export class GLProgramState{

        static getOrCreateWithGLProgram(program:GLProgram):any;
    }
}