RuntimeCompiledCPlusPlus

Support development of Runtime Compiled C++ through Github Sponsors or our Patreon

Runtime Compiled C++ sample code

• Wiki: https://github.com/RuntimeCompiledCPlusPlus/RuntimeCompiledCPlusPlus/wiki
• Blog: https://www.enkisoftware.com/devlog-rcc++ (Old Blog at: http://runtimecompiledcplusplus.blogspot.com/)
• Group: http://groups.google.com/group/runtimecompiledcplusplus
• Code: https://github.com/RuntimeCompiledCPlusPlus/RuntimeCompiledCPlusPlus
• Rapid Development with RCC++ Talk
• Runtime Compiled C++ Dear ImGui and DX11 Tutorial Videos
• GameAIPro: Runtime Compiled C++ for Rapid AI Development article
• Further examples:
  • https://github.com/juliettef/RCCpp-DearImGui-GLFW-example (Cross platform)
  • https://github.com/dougbinks/RCCpp_DX11_Example (Windows only)

Runtime-Compiled C++ (RCC++) is a way to reliably make major changes to your C++ code at runtime and see the results immediately. It's aimed at games development but could be useful in any industry where turnaround times are a bottleneck.

RCC++ is primarily designed to shorten iteration times in development - developers can build their project, run it, make changes during runtime and see the results almost immediately. If needed, shipping code can disable runtime compilation in a number of ways. RCC++ is not intended as a method to allow end users of a shipped binary to compile modifications, though with some work it can be used this way.

Getting & running the sample code

This repository now uses a submodule for GLFW.

Clone with:

git clone --recursive https://github.com/RuntimeCompiledCPlusPlus/RuntimeCompiledCPlusPlus

or update with:

git submodule update --init --recursive

Create project files and build using CMake:

1. Create a folder called build in the Aurora directory.
2. Change to the Aurora/build directory
3. Run cmake ..
4. Either build your project with make/Visual Studio/XCode or run cmake --build . (the . means build in the current directory).

Features

• Cross platform, supporting MSVC on Windows, Clang and GCC or any compiler which understands GCC options on Linux and Mac OSX, and relatively easy to port to new compilers and platforms.
• Simple in memory serialization so you can preserve object state in a safe way between compiles.
• Error protection so that when you make a mistake during programming which would normally crash your application you can correct and recover.
• Undo and Redo which allows you to quickly swap between changes at runtime, great for testing whether a subtle code change helps.
• Control over optimization levels so you can switch one file into debug, add a break point and see the state in more clarity than when it's fully optimized.

Supported OS / Compilers:

• Linux, Windows, Mac OS X suported through cmake files (many thanks to user join_the_fun from reddit)
• MinGW is not supported in this repository, but a port exists here: https://github.com/BobSmun/RuntimeCompiledCPlusPlus/tree/MinGWw64_Support

Building the project is now via CMake only, but it should be relatively simple to add the RuntimeCompiled and RuntimeObjectSytem to your favourite build system after reading the Aurora/CMakeLists.txt file.

Linux requires the following dependencies installed for the SimpleTest project:

• libfreetype6-dev
• Dependencies for GLFW
• g++, if you're already doing C++ development you should have this

For cmake, create a folder called build in the Aurora directory and run cmake from there followed by make: on Linux run "mkdir build && cd build && cmake .. && make" from Aurora dir.

License (zlib)

Copyright (c) 2010-2020 Matthew Jack and Doug Binks

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.