{"id":2379,"date":"2022-09-23T11:01:23","date_gmt":"2022-09-23T11:01:23","guid":{"rendered":"https:\/\/3dcoat.com\/documentation\/?post_type=manual_documentation&p=2379"},"modified":"2025-05-31T10:52:53","modified_gmt":"2025-05-31T10:52:53","slug":"scripting-and-core-api","status":"publish","type":"manual_documentation","link":"https:\/\/3dcoat.com\/documentation\/manual\/scripting-and-core-api\/","title":{"rendered":"Scripting & Core API"},"content":{"rendered":"\n

Programming is the process of creating a set of instructions that tell a computer how to perform a task.
You can manage 3D\u0421oat features with the help of scripting.
Run or create new commands using scripting or compiling them by accessing the Core API<\/a>.<\/p>\n\n\n\n

The start is quite easy. Just use Scripts Menu<\/em> \u2192 Create your Script<\/em><\/strong> or Create a new Core API<\/abbr> script<\/em><\/strong>.<\/p>\n\n\n

\n
\"\"<\/figure>\n<\/div>\n\n\n

The new Python API<\/a> is compatible with the old one, so old scripts should work except for rooms.
In the new API, everything is based on python modules where the script is interpreted only at the first import, then the byte code is executed.
It became possible to write your own extensions that can interact with any other modules (with each other and with the room in).
We will publish documentation<\/a> and video tutorials a little later. <\/p>\n\n\n\n

Scripts Menu<\/strong><\/a><\/p>\n\n\n\n

\n\n\n\n

– Scripting<\/strong> is a series of commands that can be executed without compiling.
When we select a tool or execute a function, we execute a command already included in the program. Creating a script allows us to combine these commands to automatically execute a series of steps that speed up our work.<\/p>\n\n\n\n

– Core API<\/abbr><\/strong> (Application Programming Interface) is not just the scripting; the code you write runs at the full speed of compiled C++.
It is a powerful method to extend the 3DCoat’s functionality. You may automate the job or add principally new tools.<\/p>\n\n\n\n

– Python API<\/strong> is very similar to the C++ Core API, but has its own advantages and drawbacks.<\/p>\n\n\n\n

Scripting<\/a><\/h3>\n\n\n\n
\n\n\n\n
\n
3DCoat Scripting manual<\/a><\/div>\n<\/div>\n\n\n\n

AngelScript does not work on Apple Silicon and is deprecated.
At the beginning 3DCoat uses AngelScript<\/a>, which is a C++-like language. The script is a text file with commands executed in a personal order.<\/p>\n\n\n\n

That command can be known by recording it in memory by pressing over the function RMB+MMB simultaneously.
Opening a notepad and pasting it, we will obtain the text of the corresponding command.
It is helpful to view and edit it in Notepad++ (choose \u201cC\u201d syntax). Then run the script via the file menu \u201cScripts \/ Run Script\u201d.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Core API<\/a><\/h3>\n\n\n\n
\n\n\n\n
\n
Core API manual introduction<\/a><\/div>\n<\/div>\n\n\n\n

<\/p>\n\n\n\n

The Core API is a powerful method to extend the 3DCoat’s functionality. You may automate the job or add principally new tools.
This is not just the scripting; the code you write runs at the full speed of compiled C++.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Core API script is a compliable C++17 program that works on the full native C++ speed. This is far more than just a script; you may make even time-critical and multithreaded tasks and customize the 3DCoat in-depth, creating principally new functionality and tools.<\/p>\n\n\n\n

But the whole process is completely transparent for you. You don’t need to configure anything or manage complex project configurations. 3DCoat will lead you through the whole process with a simple wizard.<\/p>\n\n\n\n

* Core API works correctly for users with non-English user names, all the installing process is now super easy.<\/p>\n\n\n\n

* The CoreAPI compiling process changed essentially. Now only Visual Studio is <\/strong>used; no need for clang-cl. It simplifies usage because you need to install only one additional software, not two as before. The download and install process is completely automated.<\/p>\n\n\n\n

* Core API supports colored voxels as well.<\/p>\n\n\n\n

Python API<\/h3>\n\n\n\n
\n\n\n\n
\n
Python API manual introduction<\/a><\/div>\n<\/div>\n\n\n\n

Python is primarily an architectural solution and a standard for the CG industry Good python support will allow you to write almost any plugins and integrate into working pipelines with other software. <\/p>\n\n\n\n

The 3DCoat Python API is intended to trigger UI commands, operate over the scene, and create new tools. It is very similar to the C++ Core API, but has its own advantages and drawbacks.<\/p>\n\n\n\n