Visual Studio Code

CPCtelera offers trasnparent basic integration with Visual Studio Code.  All examples and projects that your create using cpct_mkproject command line tool will have .vscode/ subfolder included, with a tasks.json predefined file.  This file will let you compile your code just by pressing [Ctrl]+[Shift]+[B] and it will parse all errors and warnings so that you can find them in the Problems tab, and navigate them with direct clics.

In order to use this integration you have to do nothing special.  Just open your Visual Studio Code IDE and open your CPCtelera project folder inside it.  On *Nix systems you may easily do it from the command line just by writting

code myproject/

Beyond that, the file also defines tasks for cleaning previously compiled objects (tasks clean and cleanall) and a task for launching WinAPE and automatically execute your game (task run).  You can easily run this tasks by launching command palette ([Ctrl]+[Shift]+[P]) and typing in there “task clean”, “task cleanall” or “task run” (Beware: these commands must not be preceded by the search symbol “>”).

You may also modify this file to suit your needs.

Most of the time, you will prefer using keyboard shortcuts for usual tasks like clean or run instead of commands.  If this is your case, you need to define new keyboard shortcuts in your environment in order to run these tasks.  Just follow these simple steps if this is your case,

[
   {
      "key": "ctrl+shift+r",
      "command": "workbench.action.tasks.runTask",
      "args": "run"
   }
,  {
      "key": "ctrl+shift+c",
      "command": "workbench.action.tasks.runTask",
      "args": "clean"
   }
,  {
      "key": "ctrl+shift+alt+c",
      "command": "workbench.action.tasks.runTask",
      "args": "cleanall"
   }
]

These will give you three shortcuts for these basic tasks,

• [Ctrl]+[Shift]+[R]: Run your game in WinAPE
• [Ctrl]+[Shift]+[C]: Clean your previously compiled objects
• [Ctrl]+[Shift]+[Alt]+[C]: Clean your previously compiled objects and your previously generated game and content.  It cleans all generated stuff.

The file is quite self-explanatory, so that it will be really easy for you to add new shortcuts for your specific needs.

Visual Studio Code has great and fast intellisense plugins that you probably will want to use.  And you will also probably want intellisense to autocomplete CPCtelera function, macro and variable names.  For that to work with CPCtelera, just follow these steps,

{
    "configurations": [
        {
            "name": "Mac",
            "includePath": [
                "${workspaceRoot}",
                "/usr/include",
                "/usr/local/include"
                "/INSERT/YOUR/PATH/TO/cpctelera/cpctelera/src"
            ],
            "defines": [],
            "browse": {
                "path": [
                    "/usr/include",
                    "/usr/local/include"
                    "/INSERT/YOUR/PATH/TO/cpctelera/cpctelera/src"
                ],
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": ""
            },
            "intelliSenseMode": "clang-x64"
        },
        {
            "name": "Linux",
            "includePath": [
                "${workspaceRoot}",
                "/usr/include/c++/7.1.1",
                "/usr/include/c++/7.1.1/x86_64-pc-linux-gnu",
                "/usr/local/include",
                "/usr/lib/clang/4.0.0/include",
                "/usr/include",
                "/INSERT/YOUR/PATH/TO/cpctelera/cpctelera/src"
            ],
            "defines": [],
            "browse": {
                "path": [
                    "/INSERT/YOUR/PATH/TO/cpctelera/cpctelera/src",
                    "/usr/include/c++/7.1.1",
                    "/usr/include/c++/7.1.1/x86_64-pc-linux-gnu",
                    "/usr/local/include",
                    "/usr/lib/clang/4.0.0/include",
                    "/usr/include"
                ],
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": ""
            },
            "intelliSenseMode": "clang-x64"
        },
        {
            "name": "Win32",
            "includePath": [
                "${workspaceRoot}",
                "C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/include"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE"
            ],
            "browse": {
                "path": [
                    "C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/include/*"
                ],
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": ""
            },
            "intelliSenseMode": "msvc-x64"
        }
    ]
}

And that’s it.  With that, intellisense will help you autocomplete CPCtelera names of functions, macros and variables, hopefully making your life easier.