From 0b90c448bfeb45721ed1ccd111ead557b5fd052f Mon Sep 17 00:00:00 2001 From: nsubiron Date: Wed, 4 Jul 2018 11:59:59 +0200 Subject: [PATCH] Replace Linux build system --- .gitignore | 9 +- .travis.yml | 17 +- CARLA.sublime-project | 149 -- CMakeLists.txt | 6 + Docs/build_system.md | 110 + Docs/how_to_build_on_linux.md | 95 +- Docs/img/modules.png | Bin 0 -> 52675 bytes Docs/index.md | 3 +- Doxyfile | 4 +- Makefile | 104 +- Rebuild.sh | 121 - Setup.sh | 227 -- Unreal/CarlaUE4/.gitignore | 1 + Unreal/CarlaUE4/CarlaUE4.uproject | 2 +- Unreal/CarlaUE4/Config/DefaultGame.ini | 2 +- Unreal/CarlaUE4/Plugins/Carla/Carla.uplugin | 2 +- .../Plugins/Carla/Source/Carla/Carla.Build.cs | 31 +- .../Source/Carla/Server/CarlaEncoder.cpp | 4 + .../Carla/Source/Carla/Server/CarlaEncoder.h | 4 + .../Carla/Source/Carla/Server/CarlaServer.cpp | 62 +- .../Carla/Source/Carla/Server/RPCServer.cpp | 91 + .../Carla/Source/Carla/Server/RPCServer.h | 35 + .../Carla/Source/Carla/Server/Server.cpp | 72 + .../Carla/Source/Carla/Server/Server.h | 52 + .../Carla/Walker/WalkerAIController.cpp | 18 +- .../Source/Carla/Walker/WalkerAIController.h | 21 +- Util/BuildTools/BuildCarlaUE4.sh | 147 ++ Util/BuildTools/BuildLibCarla.sh | 131 + Util/BuildTools/BuildPythonAPI.sh | 99 + Util/BuildTools/Check.sh | 131 + Util/BuildTools/Environment.sh | 47 + Util/BuildTools/Linux.mk | 57 + Util/BuildTools/Linux.mk.help | 77 + Package.sh => Util/BuildTools/Package.sh | 100 +- Util/BuildTools/Prettify.sh | 137 + Util/BuildTools/Setup.sh | 267 ++ Util/BuildTools/Vars.mk | 22 + Util/BuildTools/Windows.mk | 2 + Util/BuildTools/uncrustify.cfg | 2239 +++++++++++++++++ Util/CARLA.sublime-project | 138 + mkdocs.yml | 1 + 41 files changed, 4067 insertions(+), 770 deletions(-) delete mode 100644 CARLA.sublime-project create mode 100644 CMakeLists.txt create mode 100644 Docs/build_system.md create mode 100644 Docs/img/modules.png delete mode 100755 Rebuild.sh delete mode 100755 Setup.sh create mode 100644 Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.cpp create mode 100644 Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.h create mode 100644 Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.cpp create mode 100644 Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.h create mode 100755 Util/BuildTools/BuildCarlaUE4.sh create mode 100755 Util/BuildTools/BuildLibCarla.sh create mode 100755 Util/BuildTools/BuildPythonAPI.sh create mode 100755 Util/BuildTools/Check.sh create mode 100644 Util/BuildTools/Environment.sh create mode 100644 Util/BuildTools/Linux.mk create mode 100644 Util/BuildTools/Linux.mk.help rename Package.sh => Util/BuildTools/Package.sh (59%) create mode 100755 Util/BuildTools/Prettify.sh create mode 100755 Util/BuildTools/Setup.sh create mode 100644 Util/BuildTools/Vars.mk create mode 100644 Util/BuildTools/Windows.mk create mode 100644 Util/BuildTools/uncrustify.cfg create mode 100644 Util/CARLA.sublime-project diff --git a/.gitignore b/.gitignore index eeb82282e..d025fb378 100644 --- a/.gitignore +++ b/.gitignore @@ -1,31 +1,38 @@ +Build Dist Doxygen PythonClient/dist Util/Build +Install *.VC.db *.VC.opendb +*.a *.egg-info *.kdev4 *.log *.pb.cc *.pb.h +*.o *.pid *.pri *.pro *.py[cod] *.sln +*.so *.stackdump *.sublime-workspace *.workspace *CodeCompletionFolders.txt *CodeLitePreProcessor.txt .codelite +.gdb_history .tags* .vs __pycache__ _benchmarks_results _images* -_out +_out* _site core +profiler.csv diff --git a/.travis.yml b/.travis.yml index 34a70fe9c..3a2830407 100644 --- a/.travis.yml +++ b/.travis.yml @@ -17,14 +17,15 @@ script: matrix: include: - - env: TEST="CppCheck" - install: true - addons: - apt: - packages: - - cppcheck - script: - - cppcheck . -iBuild -i.pb.cc --error-exitcode=1 --enable=warning --inline-suppr --quiet + # CppCheck does not support C++17. + # - env: TEST="CppCheck" + # install: true + # addons: + # apt: + # packages: + # - cppcheck + # script: + # - cppcheck . -iBuild -i.pb.cc --error-exitcode=1 --enable=warning --inline-suppr --quiet - env: TEST="MkDocs" install: diff --git a/CARLA.sublime-project b/CARLA.sublime-project deleted file mode 100644 index 2eab9615d..000000000 --- a/CARLA.sublime-project +++ /dev/null @@ -1,149 +0,0 @@ -{ - "folders": - [ - { - "path": ".", - "folder_exclude_patterns": - [ - ".clang", - ".codelite", - ".kdev4", - ".vs", - ".vscode", - "Binaries", - "Build", - "DerivedDataCache", - "Dist", - "Doxygen", - "Intermediate", - "Saved", - "Unreal/CarlaUE4/Content*", - "__pycache__", - "_site" - ], - "file_exclude_patterns": - [ - "*.VC.db", - "*.VC.opendb", - "*.kdev4", - "*.pri", - "*.pro", - "*.py[cod]", - "*.sln", - "*.stackdump", - "*.sublime-workspace", - "*.uasset", - "*.umap", - "*.workspace", - "*CodeCompletionFolders.txt", - "*CodeLitePreProcessor.txt", - ".tags*", - "core" - ] - } - ], - "settings": - { - "ensure_newline_at_eof_on_save": true, - "tab_size": 2, - "translate_tabs_to_spaces": true, - "trim_trailing_white_space_on_save": true - }, - "build_systems": - [ - { - "name": "CARLA - Pylint", - "working_dir": "${project_path}", - "file_regex": "^\\[([^:]*):([0-9]+):?([0-9]+)?\\]:? (.*)$", - "shell_cmd": "pylint --disable=R,C --rcfile=PythonClient/.pylintrc PythonClient/carla PythonClient/*.py --msg-template='[{path}:{line:3d}:{column}]: {msg_id} {msg}'" - }, - { - "name": "CARLA - CppCheck", - "working_dir": "${project_path}", - "file_regex": "^\\[([^:]*):([0-9]+):?([0-9]+)?\\]:? (.*)$", - "shell_cmd": "cppcheck . -iBuild -i.pb.cc --error-exitcode=0 --enable=warning --quiet" - }, - { - "name": "CARLA - Rebuild script", - "working_dir": "${project_path}", - "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "linux": - { - "shell_cmd": "./Rebuild.sh" - }, - "windows": - { - "shell_cmd": "start Rebuild.bat" - } - }, - { - "name": "CARLA - make CarlaUE4", - "working_dir": "${project_path}/Unreal/CarlaUE4", - "file_regex": "Unreal\\/CarlaUE4\\/([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make CarlaUE4" - } - }, - { - "name": "CARLA - make CarlaUE4 ARGS=-clean", - "working_dir": "${project_path}/Unreal/CarlaUE4", - "file_regex": "Unreal\\/CarlaUE4\\/([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make CarlaUE4 ARGS=-clean" - } - }, - { - "name": "CARLA - make CarlaUE4Editor", - "working_dir": "${project_path}/Unreal/CarlaUE4", - "file_regex": "Unreal\\/CarlaUE4\\/([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make CarlaUE4Editor" - } - }, - { - "name": "CARLA - make CarlaUE4Editor ARGS=-clean", - "working_dir": "${project_path}/Unreal/CarlaUE4", - "file_regex": "Unreal\\/CarlaUE4\\/([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make CarlaUE4Editor ARGS=-clean" - } - }, - { - "name": "CARLA - make CarlaServer", - "working_dir": "${project_path}", - "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make" - } - }, - { - "name": "CARLA - check CarlaServer", - "working_dir": "${project_path}", - "file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make check" - } - }, - { - "name": "CARLA - clean CarlaServer", - "working_dir": "${project_path}", - "syntax": "Packages/Makefile/Make Output.sublime-syntax", - "linux": - { - "shell_cmd": "make clean" - } - } - ] -} diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 000000000..4721d53f3 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,6 @@ +cmake_minimum_required(VERSION 3.9.0) +project(CARLA) + +include("Build/CMakeLists.txt.in") + +add_subdirectory("LibCarla/cmake") diff --git a/Docs/build_system.md b/Docs/build_system.md new file mode 100644 index 000000000..a79226d23 --- /dev/null +++ b/Docs/build_system.md @@ -0,0 +1,110 @@ +

Build system

+ +> _This document is a work in progress, only the Linux build system is taken into account here._ + +The most challenging part of the setup is to compile all the dependencies and +modules to be compatible with a) Unreal Engine in the server-side, and b) Python +in the client-side. + +The goal is to be able to call Unreal Engine's functions from a separate Python +process. + +![modules](img/modules.png) + +In Linux, we compile CARLA and all the dependencies with clang-5.0 and C++17 +standard. We however link against different runtime C++ libraries depending on +where the code going to be used, since all the code that is going to be linked +with Unreal Engine needs to be compiled using `libc++`. + +#### Setup + +Command + +```sh +make setup +``` + +Get and compile dependencies + + * llvm-5.0 (libc++ and libc++abi) + * rpclib-2.2.1 (twice, with libstdc++ and libc++) + * boost-1.67 (headers only) + * googletest-1.8.0 (with libc++) + +#### LibCarla + +Compiled with CMake (minimum version required CMake 3.9). + +Command + +```sh +make LibCarla +``` + +Two configurations: + +| | Server | Client | +|-----------------|--------------|-----------| +| **Unit tests** | yes | no | +| **Requires** | rpclib, gtest, boost | rpclib, boost +| **std runtime** | LLVM's `libc++` | Default `libstdc++` | +| **Output** | headers and test exes | `libcarla_client.a` | +| **Required by** | Carla plugin | PythonAPI | + +#### CarlaUE4 and Carla plugin + +Both compiled at the same step with Unreal Engine 4.19 build tool. They require +the `UE4_ROOT` environment variable set. + +Command + +```sh +make CarlaUE4Editor +``` + +To launch Unreal Engine's Editor run + +```sh +make launch +``` + +#### PythonAPI + +Compiled using Python's `setuptools` ("setup.py"). Currently requires the +following to be installed in the machine: Python, libpython-dev, and +libboost-python-dev; both for Python 2.7 and 3.5. + +Command + +```sh +make PythonAPI +``` + +It creates two "egg" packages + + * `PythonAPI/dist/carla-0.9.0-py2.7-linux-x86_64.egg` + * `PythonAPI/dist/carla-0.9.0-py3.5-linux-x86_64.egg` + +This package can be directly imported into a Python script by adding it to the +system path + +```python +#!/usr/bin/env python + +import sys + +sys.path.append( + 'PythonAPI/dist/carla-0.9.0-py%d.%d-linux-x86_64.egg' % (sys.version_info.major, + sys.version_info.minor)) + +import carla + +# ... +``` + +or installed with `easy_install` + +```sh +easy_install2 --user --no-deps PythonAPI/dist/carla-0.9.0-py2.7-linux-x86_64.egg +easy_install3 --user --no-deps PythonAPI/dist/carla-0.9.0-py3.5-linux-x86_64.egg +``` diff --git a/Docs/how_to_build_on_linux.md b/Docs/how_to_build_on_linux.md index 5d880a3fd..360bbfcd6 100644 --- a/Docs/how_to_build_on_linux.md +++ b/Docs/how_to_build_on_linux.md @@ -5,15 +5,23 @@ Install the build tools and dependencies - $ sudo apt-get install build-essential clang-3.9 git cmake ninja-build python3-requests python-dev tzdata sed curl wget unzip autoconf libtool +``` +sudo add-apt-repository ppa:ubuntu-toolchain-r/test +sudo apt-get install build-essential clang-5.0 lld-5.0 g++-7 ninja-build python python-pip python3 python3-pip libboost-python-dev python-dev tzdata sed curl wget unzip autoconf libtool +pip2 install --user setuptools nose2 +pip3 install --user setuptools nose2 +``` To avoid compatibility issues between Unreal Engine and the CARLA dependencies, the best configuration is to compile everything with the same compiler version -and C++ runtime library. We use clang 3.9 and LLVM's libc++. You may need to -change your default clang version to compile Unreal +and C++ runtime library. We use clang 5.0 and LLVM's libc++. We recommend to +change your default clang version to compile Unreal Engine and the CARLA +dependencies - $ sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/lib/llvm-3.9/bin/clang++ 100 - $ sudo update-alternatives --install /usr/bin/clang clang /usr/lib/llvm-3.9/bin/clang 100 +```sh +sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/lib/llvm-5.0/bin/clang++ 101 +sudo update-alternatives --install /usr/bin/clang clang /usr/lib/llvm-5.0/bin/clang 101 +``` Build Unreal Engine ------------------- @@ -23,13 +31,15 @@ Build Unreal Engine need to add your GitHub username when you sign up at [www.unrealengine.com](https://www.unrealengine.com). -Download and compile Unreal Engine 4.18. Here we will assume you install it at -"~/UnrealEngine_4.18", but you can install it anywhere, just replace the path +Download and compile Unreal Engine 4.19. Here we will assume you install it at +`~/UnrealEngine_4.19", but you can install it anywhere, just replace the path where necessary. - $ git clone --depth=1 -b 4.18 https://github.com/EpicGames/UnrealEngine.git ~/UnrealEngine_4.18 - $ cd ~/UnrealEngine_4.18 - $ ./Setup.sh && ./GenerateProjectFiles.sh && make +```sh +git clone --depth=1 -b 4.19 https://github.com/EpicGames/UnrealEngine.git ~/UnrealEngine_4.19 +cd ~/UnrealEngine_4.19 +./Setup.sh && ./GenerateProjectFiles.sh && make +``` Check Unreal's documentation ["Building On Linux"](https://wiki.unrealengine.com/Building_On_Linux) if any of @@ -41,56 +51,47 @@ Build CARLA Clone or download the project from our [GitHub repository](https://github.com/carla-simulator/carla) - $ git clone https://github.com/carla-simulator/carla +```sh +git clone https://github.com/carla-simulator/carla +``` Note that the `master` branch contains the latest fixes and features, for the latest stable code may be best to switch to the latest release tag. -Run the setup script to download the content and build all dependencies. It -takes a while (you can speed up the process by parallelizing the script with the -`--jobs=8` flag) +Now you need to download the assets package, to do so we provide a handy script +that downloads and extracts the latest version (note that the package is >10GB, +this step might take some time depending on your connection) - $ ./Setup.sh +```sh +./Update.sh +``` -Once it's done it should print "Success" if everything went well. +For CARLA to find your Unreal Engine's installation folder you need to set the +following environment variable -To build CARLA, use the rebuild script. This script deletes all intermediate -files, rebuilds whole CARLA, and launches the editor. Use it too for making a -clean rebuild of CARLA +```sh +export UE4_ROOT=~/UnrealEngine_4.19 +``` - $ UE4_ROOT=~/UnrealEngine_4.18 ./Rebuild.sh +You can also add this variable to your `~/.bashrc` or `~/.profile`. -It looks at the environment variable `UE4_ROOT` to find the right version of -Unreal Engine. You can also add this variable to your "~/.bashrc" or similar. +Now that the environment is set up, you can run make to run different commands -Later, if you need to compile some changes without doing a full rebuild, you can -use the Makefile generated in the Unreal project folder - - $ cd Unreal/CarlaUE4 - $ make CarlaUE4Editor +```sh +make launch # Compiles CARLA and launches Unreal Engine's Editor. +make package # Compiles CARLA and creates a packaged version for distribution. +make help # Print all available commands. +``` Updating CARLA -------------- Every new release of CARLA we release a new package with the latest changes in -the CARLA assets. To download the latest version, run the "Update" script +the CARLA assets. To download the latest version and recompile CARLA, run - $ git pull - $ ./Update.sh - -Launching the editor --------------------- - -To open the editor once the project is already built - - $ cd Unreal/CarlaUE4 - $ ~/UnrealEngine_4.18/Engine/Binaries/Linux/UE4Editor "$PWD/CarlaUE4.uproject" - -Test (Optional) ---------------- - -A set of unit tests is available for testing the CarlaServer library (note that -these tests launch the python client, they require python3 and protobuf for -python3 installed, as well as ports 2000 and 4000 available) - - $ make check +```sh +make clean +git pull +./Update.sh +make launch +``` diff --git a/Docs/img/modules.png b/Docs/img/modules.png new file mode 100644 index 0000000000000000000000000000000000000000..4e9aff2cfbbea49c66e62287c1558c9c7079df2f GIT binary patch literal 52675 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 P@DE8@Qz`fKrMv$JNz<_8 literal 0 HcmV?d00001 diff --git a/Docs/index.md b/Docs/index.md index 49370fbcf..a7e682caf 100644 --- a/Docs/index.md +++ b/Docs/index.md @@ -21,7 +21,7 @@ * [General Structure](benchmark_structure.md) * [Creating Your Benchmark](benchmark_creating.md) * [Computed Performance Metrics](benchmark_metrics.md) - +

Advanced topics

* [CARLA settings](carla_settings.md) @@ -41,3 +41,4 @@ * [How to add assets](how_to_add_assets.md) * [CARLA design](carla_design.md) * [CarlaServer documentation](carla_server.md) + * [Build system](build_system.md) diff --git a/Doxyfile b/Doxyfile index 3940101b1..36409b425 100644 --- a/Doxyfile +++ b/Doxyfile @@ -11,7 +11,7 @@ CASE_SENSE_NAMES = YES SORT_BRIEF_DOCS = YES WARN_IF_UNDOCUMENTED = NO WARN_LOGFILE = Doxygen/warnings.log -INPUT = Unreal/CarlaUE4/Source Unreal/CarlaUE4/Plugins/Carla/Source Util/CarlaServer/source +INPUT = Unreal/CarlaUE4/Source Unreal/CarlaUE4/Plugins/Carla/Source LibCarla/source FILE_PATTERNS = *.cpp *.h *.hpp *.cc RECURSIVE = YES SOURCE_BROWSER = YES @@ -26,7 +26,7 @@ FORMULA_FONTSIZE = 12 GENERATE_LATEX = NO MACRO_EXPANSION = YES EXPAND_ONLY_PREDEF = YES -INCLUDE_PATH = Unreal/CarlaUE4/Source Unreal/CarlaUE4/Plugins/Carla/Source Util/CarlaServer/source Util/CarlaServer/include +INCLUDE_PATH = Unreal/CarlaUE4/Source Unreal/CarlaUE4/Plugins/Carla/Source LibCarla/source INCLUDE_FILE_PATTERNS = *.h *.hpp HIDE_UNDOC_RELATIONS = NO HAVE_DOT = YES diff --git a/Makefile b/Makefile index 1afd6ab56..5faab3686 100644 --- a/Makefile +++ b/Makefile @@ -1,104 +1,6 @@ -INSTALL_FOLDER=$(CURDIR)/Unreal/CarlaUE4/Plugins/Carla/CarlaServer -PYTHON_CLIENT_FOLDER=$(CURDIR)/PythonClient/test -BASE_BUILD_FOLDER=$(CURDIR)/Util/Build/carlaserver-build -MY_CMAKE_FOLDER=$(CURDIR)/Util/cmake -MY_CMAKE_FLAGS=-B"$(BUILD_FOLDER)" -DCMAKE_INSTALL_PREFIX="$(INSTALL_FOLDER)" - +include Util/BuildTools/Vars.mk ifeq ($(OS),Windows_NT) -BUILD_RULE=build_windows -CLEAN_RULE=clean_windows -CALL_CMAKE_RULE=call_cmake_windows -PROTOC_COMPILE=cmd.exe /k "cd Util & call Protoc.bat & exit" -PROTOC_CLEAN=cmd.exe /k "cd Util & call Protoc.bat --clean & exit" +include Util/BuildTools/Windows.mk else -BUILD_RULE=build_linux -CLEAN_RULE=clean_linux -CALL_CMAKE_RULE=call_cmake_linux -PROTOC_COMPILE=./Util/Protoc.sh -PROTOC_CLEAN=./Util/Protoc.sh --clean +include Util/BuildTools/Linux.mk endif - -default: release - -### Build ###################################################################### - -debug: BUILD_FOLDER=$(BASE_BUILD_FOLDER)/debug -debug: MY_CMAKE_FLAGS+=-DCMAKE_BUILD_TYPE=Debug -debug: $(BUILD_RULE) - -release: BUILD_FOLDER=$(BASE_BUILD_FOLDER)/release -release: MY_CMAKE_FLAGS+=-DCMAKE_BUILD_TYPE=Release -release: $(BUILD_RULE) - -vsproject: BUILD_FOLDER=$(BASE_BUILD_FOLDER)/visualstudio -vsproject: MY_CMAKE_FLAGS+=-DCMAKE_BUILD_TYPE=Release -vsproject: MY_CMAKE_FLAGS+=-G "Visual Studio 14 2015 Win64" -vsproject: call_cmake - -vsproject15: BUILD_FOLDER=$(BASE_BUILD_FOLDER)/visualstudio -vsproject15: MY_CMAKE_FLAGS+=-DCMAKE_BUILD_TYPE=Release -vsproject15: MY_CMAKE_FLAGS+=-G "Visual Studio 15 2017 Win64" -vsproject15: call_cmake - -build_linux: MY_CMAKE_FLAGS+=-G "Ninja" -build_linux: call_cmake - @cd $(BUILD_FOLDER) && ninja && ninja install - -build_windows: MY_CMAKE_FLAGS+=-G "NMake Makefiles" -build_windows: call_cmake - @cd $(BUILD_FOLDER) && nmake && nmake install - -call_cmake: protobuf $(CALL_CMAKE_RULE) - @cd $(BUILD_FOLDER) && cmake $(MY_CMAKE_FLAGS) "$(MY_CMAKE_FOLDER)" - -protobuf: - @$(PROTOC_COMPILE) - -call_cmake_linux: - @mkdir -p $(BUILD_FOLDER) - -call_cmake_windows: - -@mkdir "$(BUILD_FOLDER)" - -### Docs ####################################################################### - -docs: doxygen - -doxygen: - @doxygen - @echo "Documentation index at ./Doxygen/html/index.html" - -### Clean ###################################################################### - -clean: $(CLEAN_RULE) - @$(PROTOC_CLEAN) - -clean_linux: - @rm -Rf $(BASE_BUILD_FOLDER) $(INSTALL_FOLDER) Doxygen - -clean_windows: - -@rd /s /q "$(BASE_BUILD_FOLDER)" "$(INSTALL_FOLDER)" Doxygen - -### Test ####################################################################### - -check: debug launch_test_clients run_test_debug kill_test_clients - -check_release: release launch_test_clients run_test_release kill_test_clients - -run_test_debug: - @-LD_LIBRARY_PATH=$(INSTALL_FOLDER)/shared $(INSTALL_FOLDER)/bin/test_carlaserverd --gtest_shuffle $(GTEST_ARGS) - -run_test_release: - @-LD_LIBRARY_PATH=$(INSTALL_FOLDER)/shared $(INSTALL_FOLDER)/bin/test_carlaserver --gtest_shuffle $(GTEST_ARGS) - -launch_test_clients: - @echo "Launch echo client" - @python3 $(PYTHON_CLIENT_FOLDER)/test_client.py --echo -v -p 4000 --log echo_client.log & echo $$! > echo_client.pid - @echo "Launch carla client" - @python3 $(PYTHON_CLIENT_FOLDER)/test_client.py -v -p 2000 --log carla_client.log & echo $$! > carla_client.pid - -kill_test_clients: - @echo "Kill echo client" - @kill `cat echo_client.pid` && rm echo_client.pid - @echo "Kill carla client" - @kill `cat carla_client.pid` && rm carla_client.pid diff --git a/Rebuild.sh b/Rebuild.sh deleted file mode 100755 index 879e79483..000000000 --- a/Rebuild.sh +++ /dev/null @@ -1,121 +0,0 @@ -#!/bin/bash - -################################################################################ -# Updates CARLA content. -################################################################################ - -set -e - -DOC_STRING="Update CARLA content to the latest version, to be run after 'git pull'." - -USAGE_STRING="Usage: $0 [-h|--help] [--no-editor]" - -# ============================================================================== -# -- Parse arguments ----------------------------------------------------------- -# ============================================================================== - -LAUNCH_UE4_EDITOR=true - -OPTS=`getopt -o h --long help,no-editor -n 'parse-options' -- "$@"` - -if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi - -eval set -- "$OPTS" - -while true; do - case "$1" in - --no-editor ) - LAUNCH_UE4_EDITOR=false; - shift ;; - -h | --help ) - echo "$DOC_STRING" - echo "$USAGE_STRING" - exit 1 - ;; - * ) - break ;; - esac -done - -# ============================================================================== -# -- Set up environment -------------------------------------------------------- -# ============================================================================== - -SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" -pushd "$SCRIPT_DIR" >/dev/null - -UNREAL_PROJECT_FOLDER=./Unreal/CarlaUE4 -UE4_INTERMEDIATE_FOLDERS="Binaries Build Intermediate DerivedDataCache" - -function fatal_error { - echo -e "\033[0;31mERROR: $1\033[0m" - exit 1 -} - -function log { - echo -e "\033[0;33m$1\033[0m" -} - -if [ ! -d "${UE4_ROOT}" ]; then - fatal_error "UE4_ROOT is not defined, or points to a non-existant directory, please set this environment variable." -else - echo "Using Unreal Engine at '$UE4_ROOT'" -fi - -# ============================================================================== -# -- Make CarlaServer ---------------------------------------------------------- -# ============================================================================== - -log "Making CarlaServer..." -make clean && make debug && make release - -# ============================================================================== -# -- Clean up intermediate Unreal files ---------------------------------------- -# ============================================================================== - -pushd "$UNREAL_PROJECT_FOLDER" >/dev/null - -pushd "Plugins/Carla" >/dev/null - -log "Cleaning up CARLA Plugin..." -rm -Rf ${UE4_INTERMEDIATE_FOLDERS} - -popd > /dev/null - -log "Cleaning up CARLAUE4..." -rm -Rf ${UE4_INTERMEDIATE_FOLDERS} - -popd >/dev/null - -# ============================================================================== -# -- Build and launch Unreal project ------------------------------------------- -# ============================================================================== - -pushd "$UNREAL_PROJECT_FOLDER" >/dev/null - -# This command usually fails but normally we can continue anyway. -set +e -log "Generate Unreal project files..." -${UE4_ROOT}/GenerateProjectFiles.sh -project="${PWD}/CarlaUE4.uproject" -game -engine -makefiles -set -e - -log "Build CarlaUE4 project..." -make CarlaUE4Editor - -if $LAUNCH_UE4_EDITOR ; then - log "Launching UE4Editor..." - ${UE4_ROOT}/Engine/Binaries/Linux/UE4Editor "${PWD}/CarlaUE4.uproject" -else - echo "" - echo "****************" - echo "*** Success! ***" - echo "****************" -fi - -popd >/dev/null - -# ============================================================================== -# -- ...and we are done -------------------------------------------------------- -# ============================================================================== - -popd >/dev/null diff --git a/Setup.sh b/Setup.sh deleted file mode 100755 index 9a6a29e0d..000000000 --- a/Setup.sh +++ /dev/null @@ -1,227 +0,0 @@ -#! /bin/bash - -################################################################################ -# CARLA Setup.sh -# -# This script sets up the environment and dependencies for compiling CARLA on -# Linux. -# -# 1) Download CARLA Content if necessary. -# 2) Download and compile libc++. -# 3) Download other third-party libraries and compile them with libc++. -# -# Thanks to the people at https://github.com/Microsoft/AirSim for providing the -# important parts of this script. -################################################################################ - -set -e - -DOC_STRING="Download and compile CARLA content and dependencies." - -USAGE_STRING="Usage: $0 [-h|--help] [-s|--skip-download] [--jobs=N]" - -# ============================================================================== -# -- Parse arguments ----------------------------------------------------------- -# ============================================================================== - -UPDATE_SCRIPT_FLAGS= -NUMBER_OF_ASYNC_JOBS=1 - -OPTS=`getopt -o hs --long help,skip-download,jobs:: -n 'parse-options' -- "$@"` - -if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi - -eval set -- "$OPTS" - -while true; do - case "$1" in - -s | --skip-download ) - UPDATE_SCRIPT_FLAGS=--skip-download; - shift ;; - --jobs) - case "$2" in - "") NUMBER_OF_ASYNC_JOBS=4 ; shift 2 ;; - *) NUMBER_OF_ASYNC_JOBS=$2 ; shift 2 ;; - esac ;; - -h | --help ) - echo "$DOC_STRING" - echo "$USAGE_STRING" - exit 1 - ;; - * ) - break ;; - esac -done - -# ============================================================================== -# -- Set up environment -------------------------------------------------------- -# ============================================================================== - -SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" -pushd "$SCRIPT_DIR" >/dev/null - -# Require clang 3.9 -command -v clang++-3.9 >/dev/null 2>&1 || { - echo >&2 "clang 3.9 is required, but it's not installed."; - echo >&2 "make sure you build Unreal Engine with clang 3.9 too."; - exit 1; -} - -mkdir -p Util/Build -pushd Util/Build >/dev/null - -# ============================================================================== -# -- Get and compile libc++ ---------------------------------------------------- -# ============================================================================== - -# Get libc++ source -if [[ ! -d "llvm-source" ]]; then - echo "Retrieving libc++..." - git clone --depth=1 -b release_39 https://github.com/llvm-mirror/llvm.git llvm-source - git clone --depth=1 -b release_39 https://github.com/llvm-mirror/libcxx.git llvm-source/projects/libcxx - git clone --depth=1 -b release_39 https://github.com/llvm-mirror/libcxxabi.git llvm-source/projects/libcxxabi -else - echo "Folder llvm-source already exists, skipping git clone..." -fi - -# Build libc++ -rm -rf llvm-build -mkdir -p llvm-build - -pushd llvm-build >/dev/null - -export C_COMPILER=clang-3.9 -export COMPILER=clang++-3.9 - -cmake -DCMAKE_C_COMPILER=${C_COMPILER} -DCMAKE_CXX_COMPILER=${COMPILER} \ - -DLIBCXX_ENABLE_EXPERIMENTAL_LIBRARY=OFF -DLIBCXX_INSTALL_EXPERIMENTAL_LIBRARY=OFF \ - -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX="../llvm-install" \ - ../llvm-source - -make -j $NUMBER_OF_ASYNC_JOBS cxx - -#install libc++ locally in llvm-install folder -make -j $NUMBER_OF_ASYNC_JOBS install-libcxx install-libcxxabi - -popd >/dev/null - -# ============================================================================== -# -- Get Boost and compile it with libc++ -------------------------------------- -# ============================================================================== - -# Get boost source -if [[ ! -d "boost-source" ]]; then - echo "Retrieving boost..." - wget https://dl.bintray.com/boostorg/release/1.64.0/source/boost_1_64_0.tar.gz - tar -xvzf boost_1_64_0.tar.gz - rm boost_1_64_0.tar.gz - mv boost_1_64_0 boost-source -else - echo "Folder boost-source already exists, skipping download..." -fi - -pushd boost-source >/dev/null - -BOOST_TOOLSET="clang-3.9" -BOOST_CFLAGS="-fPIC -std=c++1y -stdlib=libc++ -I../llvm-install/include/c++/v1" -BOOST_LFLAGS="-stdlib=libc++ -L../llvm-install/lib" - -./bootstrap.sh \ - --with-toolset=clang \ - --prefix=../boost-install \ - --with-libraries=system -./b2 clean -./b2 toolset="${BOOST_TOOLSET}" cxxflags="${BOOST_CFLAGS}" linkflags="${BOOST_LFLAGS}" --prefix="../boost-install" -j $NUMBER_OF_ASYNC_JOBS stage release -./b2 install toolset="${BOOST_TOOLSET}" cxxflags="${BOOST_CFLAGS}" linkflags="${BOOST_LFLAGS}" --prefix="../boost-install" -j $NUMBER_OF_ASYNC_JOBS - -popd >/dev/null - -# ============================================================================== -# -- Get Protobuf and compile it with libc++ ----------------------------------- -# ============================================================================== - -# Get protobuf source -if [[ ! -d "protobuf-source" ]]; then - echo "Retrieving protobuf..." - git clone --depth=1 -b v3.3.0 --recurse-submodules https://github.com/google/protobuf.git protobuf-source -else - echo "Folder protobuf-source already exists, skipping git clone..." -fi - -pushd protobuf-source >/dev/null - -export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$PWD/../llvm-install/lib/" - -./autogen.sh -./configure \ - CC="clang-3.9" \ - CXX="clang++-3.9" \ - CXXFLAGS="-fPIC -stdlib=libc++ -I$PWD/../llvm-install/include/c++/v1" \ - LDFLAGS="-stdlib=libc++ -L$PWD/../llvm-install/lib/" \ - --prefix="$PWD/../protobuf-install" \ - --disable-shared -make -j $NUMBER_OF_ASYNC_JOBS -make -j $NUMBER_OF_ASYNC_JOBS install - -popd >/dev/null - -# ============================================================================== -# -- Get GTest and compile it with libc++ -------------------------------------- -# ============================================================================== - -# Get googletest source -if [[ ! -d "googletest-source" ]]; then - echo "Retrieving googletest..." - git clone --depth=1 -b release-1.8.0 https://github.com/google/googletest.git googletest-source -else - echo "Folder googletest-source already exists, skipping git clone..." -fi - -pushd googletest-source >/dev/null - -cmake -H. -B./build \ - -DCMAKE_C_COMPILER=${C_COMPILER} -DCMAKE_CXX_COMPILER=${COMPILER} \ - -DCMAKE_CXX_FLAGS="-stdlib=libc++ -I$PWD/../llvm-install/include/c++/v1 -Wl,-L$PWD/../llvm-install/lib" \ - -DCMAKE_INSTALL_PREFIX="../googletest-install" \ - -G "Ninja" - -pushd build >/dev/null -ninja -ninja install -popd >/dev/null - -popd >/dev/null - -# ============================================================================== -# -- Other CARLA files --------------------------------------------------------- -# ============================================================================== - -popd >/dev/null - -CARLA_SETTINGS_FILE="./Unreal/CarlaUE4/Config/CarlaSettings.ini" - -if [[ ! -f $CARLA_SETTINGS_FILE ]]; then - echo "Copying CarlaSettings.ini..." - sed -e 's/UseNetworking=true/UseNetworking=false/' ./Docs/Example.CarlaSettings.ini > $CARLA_SETTINGS_FILE -fi - -./Util/Protoc.sh - -# ============================================================================== -# -- Update CARLA Content ------------------------------------------------------ -# ============================================================================== - -echo -./Update.sh $UPDATE_SCRIPT_FLAGS - -# ============================================================================== -# -- ...and we are done -------------------------------------------------------- -# ============================================================================== - -popd >/dev/null - -set +x -echo "" -echo "****************" -echo "*** Success! ***" -echo "****************" diff --git a/Unreal/CarlaUE4/.gitignore b/Unreal/CarlaUE4/.gitignore index 32c3e361e..a8b3ead2a 100644 --- a/Unreal/CarlaUE4/.gitignore +++ b/Unreal/CarlaUE4/.gitignore @@ -7,6 +7,7 @@ Saved Plugins/Carla/Binaries Plugins/Carla/Build Plugins/Carla/CarlaServer +Plugins/Carla/CarlaDependencies Plugins/Carla/Debug Plugins/Carla/DerivedDataCache Plugins/Carla/Intermediate diff --git a/Unreal/CarlaUE4/CarlaUE4.uproject b/Unreal/CarlaUE4/CarlaUE4.uproject index 22c8354fb..c7b4426fb 100644 --- a/Unreal/CarlaUE4/CarlaUE4.uproject +++ b/Unreal/CarlaUE4/CarlaUE4.uproject @@ -1,6 +1,6 @@ { "FileVersion": 3, - "EngineAssociation": "4.18", + "EngineAssociation": "4.19", "Category": "", "Description": "", "Modules": [ diff --git a/Unreal/CarlaUE4/Config/DefaultGame.ini b/Unreal/CarlaUE4/Config/DefaultGame.ini index 8bb2e6084..72d4d8855 100644 --- a/Unreal/CarlaUE4/Config/DefaultGame.ini +++ b/Unreal/CarlaUE4/Config/DefaultGame.ini @@ -3,7 +3,7 @@ ProjectID=675BF8694238308FA9368292CC440350 ProjectName=CARLA UE4 CompanyName=CVC CopyrightNotice="Copyright (c) 2017 Computer Vision Center (CVC) at the Universitat Autonoma de Barcelona (UAB). This work is licensed under the terms of the MIT license. For a copy, see ." -ProjectVersion=0.8.4 +ProjectVersion=0.9.0 [/Script/UnrealEd.ProjectPackagingSettings] BuildConfiguration=PPBC_Development diff --git a/Unreal/CarlaUE4/Plugins/Carla/Carla.uplugin b/Unreal/CarlaUE4/Plugins/Carla/Carla.uplugin index 5db0a836f..83ccb0f10 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Carla.uplugin +++ b/Unreal/CarlaUE4/Plugins/Carla/Carla.uplugin @@ -1,7 +1,7 @@ { "FileVersion": 3, "Version": 1, - "VersionName": "0.8.4", + "VersionName": "0.9.0", "FriendlyName": "CARLA", "Description": "Open-source simulator for autonomous driving research.", "Category": "Science", diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Carla.Build.cs b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Carla.Build.cs index 16bc6715f..f9c74b603 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Carla.Build.cs +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Carla.Build.cs @@ -1,5 +1,6 @@ // Copyright 1998-2017 Epic Games, Inc. All Rights Reserved. +using System; using System.IO; using UnrealBuildTool; @@ -78,17 +79,7 @@ public class Carla : ModuleRules private void AddCarlaServerDependency(ReadOnlyTargetRules Target) { - string CarlaServerInstallPath = Path.GetFullPath(Path.Combine(ModuleDirectory, "../../CarlaServer")); - - string CarlaServerLib; - if (UseDebugLibs(Target)) - { - CarlaServerLib = "carlaserverd"; - } - else - { - CarlaServerLib = "carlaserver"; - } + string LibCarlaInstallPath = Path.GetFullPath(Path.Combine(ModuleDirectory, "../../CarlaDependencies")); ADelegate GetLibName = (string BaseName) => { if (IsWindows(Target)) @@ -104,23 +95,17 @@ public class Carla : ModuleRules // Link dependencies. if (IsWindows(Target)) { - // Auto-links boost libraries in folder. - PublicLibraryPaths.Add(Path.Combine(CarlaServerInstallPath, "lib")); - - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName("libprotobuf"))); - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName(CarlaServerLib))); + throw new NotImplementedException(); } else { - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName("c++abi"))); - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName("boost_system"))); - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName("protobuf"))); - PublicAdditionalLibraries.Add(Path.Combine(CarlaServerInstallPath, "lib", GetLibName(CarlaServerLib))); + PublicAdditionalLibraries.Add(Path.Combine(LibCarlaInstallPath, "lib", GetLibName("c++abi"))); + PublicAdditionalLibraries.Add(Path.Combine(LibCarlaInstallPath, "lib", GetLibName("rpc"))); } // Include path. - string CarlaServerIncludePath = Path.Combine(CarlaServerInstallPath, "include"); - PublicIncludePaths.Add(CarlaServerIncludePath); - PrivateIncludePaths.Add(CarlaServerIncludePath); + string LibCarlaIncludePath = Path.Combine(LibCarlaInstallPath, "include"); + PublicIncludePaths.Add(LibCarlaIncludePath); + PrivateIncludePaths.Add(LibCarlaIncludePath); } } diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.cpp b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.cpp index 77578cae0..751a9a44e 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.cpp +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.cpp @@ -4,6 +4,8 @@ // This work is licensed under the terms of the MIT license. // For a copy, see . +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + #include "Carla.h" #include "CarlaEncoder.h" @@ -221,3 +223,5 @@ void FCarlaEncoder::Visit(const UWalkerAgentComponent &Agent) ::Encode(Agent.GetBoundingBoxTransform(), Data.bounding_box.transform); ::Encode(Agent.GetBoundingBoxExtent() * TO_METERS, Data.bounding_box.extent); } + +#endif // CARLA_COMPILE_CARLASERVER_LEGACY diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.h b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.h index 0c523029c..659d32658 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.h +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaEncoder.h @@ -6,6 +6,8 @@ #pragma once +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + #include "Agent/AgentComponentVisitor.h" #include "Sensor/SensorDataView.h" @@ -74,3 +76,5 @@ private: carla_agent &Data; }; + +#endif // CARLA_COMPILE_CARLASERVER_LEGACY diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaServer.cpp b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaServer.cpp index 8488d31a6..879274281 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaServer.cpp +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/CarlaServer.cpp @@ -9,12 +9,15 @@ #include "Server/CarlaEncoder.h" -#include +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY +# include +#endif // CARLA_COMPILE_CARLASERVER_LEGACY // ============================================================================= // -- Static local methods ----------------------------------------------------- // ============================================================================= +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY static FCarlaServer::ErrorCode ParseErrorCode(const uint32 ErrorCode) { if (ErrorCode == CARLA_SERVER_SUCCESS) { @@ -25,6 +28,7 @@ static FCarlaServer::ErrorCode ParseErrorCode(const uint32 ErrorCode) return FCarlaServer::Error; } } +#endif // CARLA_COMPILE_CARLASERVER_LEGACY static int32 GetTimeOut(uint32 TimeOut, const bool bBlocking) { @@ -38,7 +42,12 @@ static int32 GetTimeOut(uint32 TimeOut, const bool bBlocking) FCarlaServer::FCarlaServer(const uint32 InWorldPort, const uint32 InTimeOut) : WorldPort(InWorldPort), TimeOut(InTimeOut), - Server(carla_make_server()) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + Server(carla_make_server()) +#else + Server(nullptr) +#endif // CARLA_COMPILE_CARLASERVER_LEGACY +{ check(Server != nullptr); } @@ -47,17 +56,26 @@ FCarlaServer::~FCarlaServer() #ifdef CARLA_SERVER_EXTRA_LOG UE_LOG(LogCarlaServer, Warning, TEXT("Destroying CarlaServer")); #endif // CARLA_SERVER_EXTRA_LOG +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY carla_free_server(Server); +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::Connect() { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY UE_LOG(LogCarlaServer, Log, TEXT("Waiting for the client to connect...")); return ParseErrorCode(carla_server_connect(Server, WorldPort, TimeOut)); +#else + UE_LOG(LogCarlaServer, Error, TEXT("CarlaServer no longer supported!!")); + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::ReadNewEpisode(FString &IniFile, const bool bBlocking) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + carla_request_new_episode values; auto ec = ParseErrorCode(carla_read_request_new_episode(Server, values, GetTimeOut(TimeOut, bBlocking))); if (Success == ec) { @@ -68,6 +86,10 @@ FCarlaServer::ErrorCode FCarlaServer::ReadNewEpisode(FString &IniFile, const boo #endif // CARLA_SERVER_EXTRA_LOG } return ec; + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::SendSceneDescription( @@ -76,6 +98,8 @@ FCarlaServer::ErrorCode FCarlaServer::SendSceneDescription( const TArray &SensorDescriptions, const bool bBlocking) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + carla_scene_description scene; // Encode map name. const auto MapNameBuffer = FCarlaEncoder::Encode(MapName); @@ -95,10 +119,16 @@ FCarlaServer::ErrorCode FCarlaServer::SendSceneDescription( UE_LOG(LogCarlaServer, Log, TEXT("Sending %d available start positions"), scene.number_of_player_start_spots); UE_LOG(LogCarlaServer, Log, TEXT("Sending %d sensor descriptions"), scene.number_of_sensors); return ParseErrorCode(carla_write_scene_description(Server, scene, GetTimeOut(TimeOut, bBlocking))); + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::ReadEpisodeStart(uint32 &StartPositionIndex, const bool bBlocking) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + carla_episode_start values; auto ec = ParseErrorCode(carla_read_episode_start(Server, values, GetTimeOut(TimeOut, bBlocking))); if (Success == ec) { @@ -106,17 +136,29 @@ FCarlaServer::ErrorCode FCarlaServer::ReadEpisodeStart(uint32 &StartPositionInde UE_LOG(LogCarlaServer, Log, TEXT("Episode start received: { StartIndex = %d }"), StartPositionIndex); } return ec; + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::SendEpisodeReady(const bool bBlocking) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + UE_LOG(LogCarlaServer, Log, TEXT("Ready to play, notifying client")); const carla_episode_ready values = {true}; return ParseErrorCode(carla_write_episode_ready(Server, values, GetTimeOut(TimeOut, bBlocking))); + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::ReadControl(FVehicleControl &Control, const bool bBlocking) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + carla_control values; auto ec = ParseErrorCode(carla_read_control(Server, values, GetTimeOut(TimeOut, bBlocking))); if (Success == ec) { @@ -137,13 +179,23 @@ FCarlaServer::ErrorCode FCarlaServer::ReadControl(FVehicleControl &Control, cons UE_LOG(LogCarlaServer, Warning, TEXT("No control received from the client this frame!")); } return ec; + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::SendSensorData(const FSensorDataView &Data) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + carla_sensor_data values; FCarlaEncoder::Encode(Data, values); return ParseErrorCode(carla_write_sensor_data(Server, values)); + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } FCarlaServer::ErrorCode FCarlaServer::SendMeasurements( @@ -151,6 +203,8 @@ FCarlaServer::ErrorCode FCarlaServer::SendMeasurements( const TArray &Agents, const bool bSendNonPlayerAgentsInfo) { +#ifdef CARLA_COMPILE_CARLASERVER_LEGACY + // Encode measurements. carla_measurements values; FCarlaEncoder::Encode(PlayerState, values); @@ -166,4 +220,8 @@ FCarlaServer::ErrorCode FCarlaServer::SendMeasurements( UE_LOG(LogCarlaServer, Log, TEXT("Sending data of %d agents"), values.number_of_non_player_agents); #endif // CARLA_SERVER_EXTRA_LOG return ParseErrorCode(carla_write_measurements(Server, values)); + +#else + return ErrorCode::Error; +#endif // CARLA_COMPILE_CARLASERVER_LEGACY } diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.cpp b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.cpp new file mode 100644 index 000000000..5871ec9aa --- /dev/null +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.cpp @@ -0,0 +1,91 @@ +// Copyright (c) 2017 Computer Vision Center (CVC) at the Universitat Autonoma +// de Barcelona (UAB). +// +// This work is licensed under the terms of the MIT license. +// For a copy, see . + +#include "Carla.h" +#include "Server.h" + +#include +#include +#include +#include +#include +#include +#include +#include + +static FVehicleControl MakeControl(const carla::rpc::VehicleControl &cControl) +{ + FVehicleControl Control; + Control.Throttle = cControl.throttle; + Control.Steer = cControl.steer; + Control.Brake = cControl.brake; + Control.bHandBrake = cControl.hand_brake; + Control.bReverse = cControl.reverse; + return Control; +} + +class FRPCServer::Pimpl +{ +public: + Pimpl(uint16_t port) : Server(port) {} + carla::rpc::Server Server; +}; + +FRPCServer::FRPCServer() : _Pimpl(nullptr) {} + +FRPCServer::~FRPCServer() {} + +void FRPCServer::Initialize(AServer &Server, uint16_t Port) +{ + UE_LOG(LogTemp, Error, TEXT("Initializing rpc-server at port %d"), Port); + + _Pimpl = std::make_unique(Port); + + namespace cr = carla::rpc; + + auto &srv = _Pimpl->Server; + + srv.BindAsync("ping", []() { return true; }); + + srv.BindAsync("version", []() { return std::string(carla::version()); }); + + srv.BindAsync("get_blueprints", []() { + return std::vector{ + cr::ActorBlueprint{"vehicle.mustang.red"}, + cr::ActorBlueprint{"vehicle.mustang.also_red"}, + cr::ActorBlueprint{"vehicle.mustang.still_red"} + }; + }); + + srv.BindSync("spawn_actor", [&]( + const cr::ActorBlueprint &blueprint, + const cr::Transform &transform) { + auto id = Server.SpawnAgent(transform); + return cr::Actor{static_cast(id), blueprint}; + }); + + srv.BindSync("apply_control_to_actor", [&]( + const cr::Actor &actor, + const cr::VehicleControl &control) { + Server.ApplyControl(actor.id, MakeControl(control)); + }); +} + +void FRPCServer::Run() +{ + _Pimpl->Server.AsyncRun(4); +} + +void FRPCServer::RunSome() +{ + using namespace std::chrono_literals; + _Pimpl->Server.SyncRunFor(20ms); +} + +void FRPCServer::Stop() +{ + _Pimpl->Server.Stop(); +} diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.h b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.h new file mode 100644 index 000000000..2ec8c71b6 --- /dev/null +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/RPCServer.h @@ -0,0 +1,35 @@ +// Copyright (c) 2017 Computer Vision Center (CVC) at the Universitat Autonoma +// de Barcelona (UAB). +// +// This work is licensed under the terms of the MIT license. +// For a copy, see . + +#pragma once + +#include "CoreMinimal.h" + +#include + +class AServer; + +class FRPCServer +{ +public: + + FRPCServer(); + + ~FRPCServer(); + + void Initialize(AServer &Server, uint16_t Port = 8080u); + + void Run(); + + void RunSome(); + + void Stop(); + +private: + + class Pimpl; + std::unique_ptr _Pimpl; +}; diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.cpp b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.cpp new file mode 100644 index 000000000..2a1ab6d95 --- /dev/null +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.cpp @@ -0,0 +1,72 @@ +// Copyright (c) 2017 Computer Vision Center (CVC) at the Universitat Autonoma +// de Barcelona (UAB). +// +// This work is licensed under the terms of the MIT license. +// For a copy, see . + +#include "Carla.h" +#include "Server.h" + + +// Sets default values +AServer::AServer() +{ + // Set this actor to call Tick() every frame. You can turn this off to improve performance if you don't need it. + PrimaryActorTick.bCanEverTick = true; + +} + +// Called when the game starts or when spawned +void AServer::BeginPlay() +{ + Super::BeginPlay(); + + _Server.Initialize(*this); + _Server.Run(); +} + +void AServer::EndPlay(EEndPlayReason::Type EndPlayReason) +{ + _Server.Stop(); +} + +// Called every frame +void AServer::Tick(float DeltaTime) +{ + Super::Tick(DeltaTime); + + _Server.RunSome(); +} + +int32 AServer::SpawnAgent(const FTransform &Transform) +{ + check(IsInGameThread()); + UE_LOG(LogTemp, Warning, TEXT("Spawning vehicle at %s"), *Transform.ToString()); + + static int32 COUNT = 0u; + ++COUNT; + + ACarlaWheeledVehicle *Vehicle; + SpawnVehicle(Transform, Vehicle); + if ((Vehicle != nullptr) && !Vehicle->IsPendingKill()) + { + // Vehicle->AIControllerClass = AWheeledVehicleAIController::StaticClass(); + Vehicle->SpawnDefaultController(); + _Agents.Add(COUNT, Vehicle); + return COUNT; + } + return -1; +} + +bool AServer::ApplyControl(int32 AgentId, const FVehicleControl &Control) +{ + UE_LOG(LogTemp, Log, TEXT("Applying control to vehicle %d: throttle = %f, steer = %f"), AgentId, Control.Throttle, Control.Steer); + if (!_Agents.Contains(AgentId)) + { + UE_LOG(LogTemp, Error, TEXT("Vehicle %d does not exist!"), AgentId); + return false; + } + auto *Vehicle = _Agents[AgentId]; + Vehicle->ApplyVehicleControl(Control); + return true; +} diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.h b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.h new file mode 100644 index 000000000..e8cd23755 --- /dev/null +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Server/Server.h @@ -0,0 +1,52 @@ +// Copyright (c) 2017 Computer Vision Center (CVC) at the Universitat Autonoma +// de Barcelona (UAB). +// +// This work is licensed under the terms of the MIT license. +// For a copy, see . + +#pragma once + +#include "Vehicle/CarlaWheeledVehicle.h" +#include "CoreMinimal.h" +#include "GameFramework/Actor.h" +#include "RPCServer.h" +#include "Vehicle/VehicleControl.h" +#include +#include +#include +#include "Server.generated.h" + +UCLASS() +class CARLA_API AServer : public AActor +{ + GENERATED_BODY() + +public: + // Sets default values for this actor's properties + AServer(); + +protected: + // Called when the game starts or when spawned + virtual void BeginPlay() override; + virtual void EndPlay(EEndPlayReason::Type EndPlayReason) override; + +public: + // Called every frame + virtual void Tick(float DeltaTime) override; + + UFUNCTION(BlueprintCallable) + int32 SpawnAgent(const FTransform &Transform); + + UFUNCTION(BlueprintCallable) + bool ApplyControl(int32 AgentId, const FVehicleControl &Control); + + UFUNCTION(BlueprintImplementableEvent) + void SpawnVehicle(const FTransform &SpawnTransform, ACarlaWheeledVehicle *&SpawnedCharacter); + +private: + + FRPCServer _Server; + + UPROPERTY(VisibleAnywhere) + TMap _Agents; +}; diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.cpp b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.cpp index 31f8aa246..69f0279f0 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.cpp +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.cpp @@ -155,7 +155,7 @@ AWalkerAIController::AWalkerAIController(const FObjectInitializer& ObjectInitial SightConfiguration->DetectionByAffiliation.bDetectEnemies = true; SightConfiguration->DetectionByAffiliation.bDetectNeutrals = true; SightConfiguration->DetectionByAffiliation.bDetectFriendlies = true; - + Perception->ConfigureSense(*SightConfiguration); Perception->SetDominantSense(SightConfiguration->GetSenseImplementation()); Perception->OnPerceptionUpdated.AddDynamic(this, &AWalkerAIController::SenseActors); @@ -163,7 +163,6 @@ AWalkerAIController::AWalkerAIController(const FObjectInitializer& ObjectInitial TimeInState=0.0f; } - void AWalkerAIController::Possess(APawn *aPawn) { Super::Possess(aPawn); @@ -175,12 +174,12 @@ void AWalkerAIController::Tick(float DeltaSeconds) { Super::Tick(DeltaSeconds); TimeInState+=DeltaSeconds; - if (Status != EWalkerStatus::RunOver) + if (Status != EWalkerStatus::RunOver) { - switch (GetMoveStatus()) + switch (GetMoveStatus()) { default: break; - case EPathFollowingStatus::Idle: + case EPathFollowingStatus::Idle: //case EPathFollowingStatus::Waiting: //<-- incomplete path LOG_AI_WALKER(Warning, "is stuck!"); ChangeStatus(EWalkerStatus::Stuck); @@ -191,7 +190,7 @@ void AWalkerAIController::Tick(float DeltaSeconds) TryResumeMovement(); } break; - + }; } } @@ -208,7 +207,7 @@ FPathFollowingRequestResult AWalkerAIController::MoveTo( ; #endif // CARLA_AI_WALKERS_EXTRA_LOG - + ChangeStatus(EWalkerStatus::Moving); return Super::MoveTo(MoveRequest, OutPath); } @@ -221,13 +220,12 @@ void AWalkerAIController::OnMoveCompleted( #ifdef CARLA_AI_WALKERS_EXTRA_LOG UE_LOG(LogCarla, Log, TEXT("Walker %s completed move at (%s)"), *GetPawn()->GetName(), - *GetPawn()->GetActorLocation().ToString()) -; + *GetPawn()->GetActorLocation().ToString()); #endif // CARLA_AI_WALKERS_EXTRA_LOG ChangeStatus(EWalkerStatus::MoveCompleted); } -void AWalkerAIController::SenseActors(TArray Actors) +void AWalkerAIController::SenseActors(const TArray &Actors) { const auto *aPawn = GetPawn(); if ((Status == EWalkerStatus::Moving) && diff --git a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.h b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.h index 986d22fde..5db79ee81 100644 --- a/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.h +++ b/Unreal/CarlaUE4/Plugins/Carla/Source/Carla/Walker/WalkerAIController.h @@ -35,16 +35,17 @@ public: virtual void Tick(float DeltaSeconds) override; - + virtual FPathFollowingRequestResult MoveTo( const FAIMoveRequest& MoveRequest, FNavPathSharedPtr* OutPath = nullptr) override; - virtual void OnMoveCompleted(FAIRequestID RequestID, const FPathFollowingResult &Result) override; - + virtual void OnMoveCompleted( + FAIRequestID RequestID, + const FPathFollowingResult &Result) override; UFUNCTION(BlueprintCallable) - void SenseActors(TArray Actors); + void SenseActors(const TArray &Actors); EWalkerStatus GetWalkerStatus() const { @@ -58,19 +59,27 @@ public: float GetTimeInState() const { return TimeInState; } private: + void ChangeStatus(EWalkerStatus status); + void TryResumeMovement(); - + void TryPauseMovement(bool bItWasRunOver = false); UFUNCTION() - void OnPawnTookDamage(AActor *DamagedActor, float Damage, const UDamageType *DamageType, AController *InstigatedBy, AActor *DamageCauser); + void OnPawnTookDamage( + AActor *DamagedActor, + float Damage, + const UDamageType *DamageType, + AController *InstigatedBy, + AActor *DamageCauser); UPROPERTY(Category = "Walker AI Controller", VisibleAnywhere) UAISenseConfig_Sight *SightConfiguration; UPROPERTY(VisibleAnywhere) EWalkerStatus Status = EWalkerStatus::Unknown; + /** Continous time in the same EWalkerStatus */ float TimeInState=0.0f; }; diff --git a/Util/BuildTools/BuildCarlaUE4.sh b/Util/BuildTools/BuildCarlaUE4.sh new file mode 100755 index 000000000..950aed19f --- /dev/null +++ b/Util/BuildTools/BuildCarlaUE4.sh @@ -0,0 +1,147 @@ +#! /bin/bash + +# ============================================================================== +# -- Set up environment -------------------------------------------------------- +# ============================================================================== + +source $(dirname "$0")/Environment.sh + +if [ ! -d "${UE4_ROOT}" ]; then + fatal_error "UE4_ROOT is not defined, or points to a non-existant directory, please set this environment variable." +else + log "Using Unreal Engine at '$UE4_ROOT'" +fi + +# ============================================================================== +# -- Parse arguments ----------------------------------------------------------- +# ============================================================================== + +DOC_STRING="Build and launch CarlaUE4." + +USAGE_STRING="Usage: $0 [-h|--help] [--build] [--rebuild] [--launch] [--clean] [--hard-clean]" + +REMOVE_INTERMEDIATE=false +HARD_CLEAN=false +BUILD_CARLAUE4=false +LAUNCH_UE4_EDITOR=false + +OPTS=`getopt -o h --long help,build,rebuild,launch,clean,hard-clean -n 'parse-options' -- "$@"` + +if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi + +eval set -- "$OPTS" + +while true; do + case "$1" in + --build ) + BUILD_CARLAUE4=true; + shift ;; + --rebuild ) + REMOVE_INTERMEDIATE=true; + BUILD_CARLAUE4=true; + shift ;; + --launch ) + LAUNCH_UE4_EDITOR=true; + shift ;; + --clean ) + REMOVE_INTERMEDIATE=true; + shift ;; + --hard-clean ) + REMOVE_INTERMEDIATE=true; + HARD_CLEAN=true; + shift ;; + -h | --help ) + echo "$DOC_STRING" + echo "$USAGE_STRING" + exit 1 + ;; + * ) + break ;; + esac +done + +if ! { ${REMOVE_INTERMEDIATE} || ${BUILD_CARLAUE4} || ${LAUNCH_UE4_EDITOR}; }; then + fatal_error "Nothing selected to be done." +fi + +pushd "${CARLAUE4_ROOT_FOLDER}" >/dev/null + +# ============================================================================== +# -- Clean CarlaUE4 ------------------------------------------------------------ +# ============================================================================== + +if ${REMOVE_INTERMEDIATE} ; then + + log "Cleaning intermediate files and folders." + + UE4_INTERMEDIATE_FOLDERS="Binaries Build Intermediate DerivedDataCache" + + rm -Rf ${UE4_INTERMEDIATE_FOLDERS} + + pushd "${CARLAUE4_PLUGIN_ROOT_FOLDER}" >/dev/null + + rm -Rf ${UE4_INTERMEDIATE_FOLDERS} + + popd >/dev/null + +fi + +if ${HARD_CLEAN} ; then + + if [ ! -f Makefile ]; then + fatal_error "The project wasn't built before!" + fi + + log "Doing a \"hard\" clean of the Unreal Engine project." + + make CarlaUE4Editor ARGS=-clean + +fi + +if ${REMOVE_INTERMEDIATE} ; then + + rm -f Makefile + +fi + +# ============================================================================== +# -- Build CarlaUE4 ------------------------------------------------------------ +# ============================================================================== + +if ${BUILD_CARLAUE4} ; then + + if [ ! -f Makefile ]; then + + # This command fails sometimes but normally we can continue anyway. + set +e + log "Generate Unreal project files." + ${UE4_ROOT}/GenerateProjectFiles.sh -project="${PWD}/CarlaUE4.uproject" -game -engine -makefiles + set -e + + fi + + log "Build CarlaUE4 project." + make CarlaUE4Editor + +fi + +# ============================================================================== +# -- Launch UE4Editor ---------------------------------------------------------- +# ============================================================================== + +if ${LAUNCH_UE4_EDITOR} ; then + + log "Launching UE4Editor..." + ${UE4_ROOT}/Engine/Binaries/Linux/UE4Editor "${PWD}/CarlaUE4.uproject" + +else + + log "Success!" + +fi + +# ============================================================================== +# -- ...and we are done -------------------------------------------------------- +# ============================================================================== + +popd >/dev/null diff --git a/Util/BuildTools/BuildLibCarla.sh b/Util/BuildTools/BuildLibCarla.sh new file mode 100755 index 000000000..49b73fcb3 --- /dev/null +++ b/Util/BuildTools/BuildLibCarla.sh @@ -0,0 +1,131 @@ +#! /bin/bash + +source $(dirname "$0")/Environment.sh + +# ============================================================================== +# -- Parse arguments ----------------------------------------------------------- +# ============================================================================== + +DOC_STRING="Build LibCarla." + +USAGE_STRING="Usage: $0 [-h|--help] [--rebuild] [--server] [--client] [--clean]" + +REMOVE_INTERMEDIATE=false +BUILD_SERVER=false +BUILD_CLIENT=false + +OPTS=`getopt -o h --long help,rebuild,server,client,clean -n 'parse-options' -- "$@"` + +if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi + +eval set -- "$OPTS" + +while true; do + case "$1" in + --rebuild ) + REMOVE_INTERMEDIATE=true; + BUILD_SERVER=true; + BUILD_CLIENT=true; + shift ;; + --server ) + BUILD_SERVER=true; + shift ;; + --client ) + BUILD_CLIENT=true; + shift ;; + --clean ) + REMOVE_INTERMEDIATE=true; + shift ;; + -h | --help ) + echo "$DOC_STRING" + echo "$USAGE_STRING" + exit 1 + ;; + * ) + break ;; + esac +done + +if ! { ${REMOVE_INTERMEDIATE} || ${BUILD_SERVER} || ${BUILD_CLIENT}; }; then + fatal_error "Nothing selected to be done." +fi + +# ============================================================================== +# -- Clean intermediate files -------------------------------------------------- +# ============================================================================== + +if ${REMOVE_INTERMEDIATE} ; then + + log "Cleaning intermediate files and folders." + + rm -Rf ${LIBCARLA_BUILD_SERVER_FOLDER} ${LIBCARLA_BUILD_CLIENT_FOLDER} + rm -Rf ${LIBCARLA_INSTALL_SERVER_FOLDER} ${LIBCARLA_INSTALL_CLIENT_FOLDER} + rm -f ${LIBCARLA_ROOT_FOLDER}/source/carla/Version.h + +fi + +# ============================================================================== +# -- Build Server configuration ------------------------------------------------ +# ============================================================================== + +if ${BUILD_SERVER} ; then + + log "Building LibCarla \"Server\" configuration." + + mkdir -p ${LIBCARLA_BUILD_SERVER_FOLDER} + pushd "${LIBCARLA_BUILD_SERVER_FOLDER}" >/dev/null + + if [ ! -f "build.ninja" ]; then + + cmake \ + -G "Ninja" \ + -DCMAKE_BUILD_TYPE=Server \ + -DCMAKE_TOOLCHAIN_FILE=${LIBCPP_TOOLCHAIN_FILE} \ + -DCMAKE_INSTALL_PREFIX=${LIBCARLA_INSTALL_SERVER_FOLDER} \ + ${CARLA_ROOT_FOLDER} + + fi + + ninja + + ninja install | grep -v "Up-to-date:" + + popd >/dev/null + +fi + +# ============================================================================== +# -- Build Client configuration ------------------------------------------------ +# ============================================================================== + +if ${BUILD_CLIENT} ; then + + log "Building LibCarla \"Client\" configuration." + + mkdir -p ${LIBCARLA_BUILD_CLIENT_FOLDER} + pushd "${LIBCARLA_BUILD_CLIENT_FOLDER}" >/dev/null + + if [ ! -f "build.ninja" ]; then + + cmake \ + -G "Ninja" \ + -DCMAKE_BUILD_TYPE=Client \ + -DCMAKE_TOOLCHAIN_FILE=${LIBSTDCPP_TOOLCHAIN_FILE} \ + -DCMAKE_INSTALL_PREFIX=${LIBCARLA_INSTALL_CLIENT_FOLDER} \ + ${CARLA_ROOT_FOLDER} + + fi + + ninja + + ninja install | grep -v "Up-to-date:" + + popd >/dev/null + +fi + +# ============================================================================== +# -- ...and we are done -------------------------------------------------------- +# ============================================================================== + +log "Success!" diff --git a/Util/BuildTools/BuildPythonAPI.sh b/Util/BuildTools/BuildPythonAPI.sh new file mode 100755 index 000000000..89671c58a --- /dev/null +++ b/Util/BuildTools/BuildPythonAPI.sh @@ -0,0 +1,99 @@ +#! /bin/bash + +source $(dirname "$0")/Environment.sh + +export CC=clang-5.0 +export CXX=clang++-5.0 + +# ============================================================================== +# -- Parse arguments ----------------------------------------------------------- +# ============================================================================== + +DOC_STRING="Build and package CARLA Python API." + +USAGE_STRING="Usage: $0 [-h|--help] [--rebuild] [--py2] [--py3] [--clean]" + +REMOVE_INTERMEDIATE=false +BUILD_FOR_PYTHON2=false +BUILD_FOR_PYTHON3=false + +OPTS=`getopt -o h --long help,rebuild,py2,py3,clean -n 'parse-options' -- "$@"` + +if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi + +eval set -- "$OPTS" + +while true; do + case "$1" in + --rebuild ) + REMOVE_INTERMEDIATE=true; + BUILD_FOR_PYTHON2=true; + BUILD_FOR_PYTHON3=true; + shift ;; + --py2 ) + BUILD_FOR_PYTHON2=true; + shift ;; + --py3 ) + BUILD_FOR_PYTHON3=true; + shift ;; + --clean ) + REMOVE_INTERMEDIATE=true; + shift ;; + -h | --help ) + echo "$DOC_STRING" + echo "$USAGE_STRING" + exit 1 + ;; + * ) + break ;; + esac +done + +if ! { ${REMOVE_INTERMEDIATE} || ${BUILD_FOR_PYTHON2} || ${BUILD_FOR_PYTHON3}; }; then + fatal_error "Nothing selected to be done." +fi + +pushd "${CARLA_PYTHONAPI_ROOT_FOLDER}" >/dev/null + +# ============================================================================== +# -- Clean intermediate files -------------------------------------------------- +# ============================================================================== + +if ${REMOVE_INTERMEDIATE} ; then + + log "Cleaning intermediate files and folders." + + rm -Rf build dist carla.egg-info source/carla.egg-info + + find source -name "*.so" -delete + find source -name "__pycache__" -type d -exec rm -r "{}" \; + +fi + +# ============================================================================== +# -- Build API ----------------------------------------------------------------- +# ============================================================================== + +if ${BUILD_FOR_PYTHON2} ; then + + log "Building Python API for Python 2." + + /usr/bin/env python2 setup.py bdist_egg + +fi + +if ${BUILD_FOR_PYTHON3} ; then + + log "Building Python API for Python 3." + + /usr/bin/env python3 setup.py bdist_egg + +fi + +# ============================================================================== +# -- ...and we are done -------------------------------------------------------- +# ============================================================================== + +popd >/dev/null + +log "Success!" diff --git a/Util/BuildTools/Check.sh b/Util/BuildTools/Check.sh new file mode 100755 index 000000000..db3609226 --- /dev/null +++ b/Util/BuildTools/Check.sh @@ -0,0 +1,131 @@ +#! /bin/bash + +source $(dirname "$0")/Environment.sh + +# ============================================================================== +# -- Parse arguments ----------------------------------------------------------- +# ============================================================================== + +DOC_STRING="Run unit tests." + +USAGE_STRING=$(cat <<- END +Usage: $0 [-h|--help] [--gdb] [--gtest_args=ARGS] + +Then either ran all the tests + + [--all] + +Or choose one or more of the following + + [--libcarla-release] [--libcarla-debug] + [--python-api-2] [--python-api-3] + [--benchmark] +END +) + +GDB= +GTEST_ARGS= +LIBCARLA_RELEASE=false +LIBCARLA_DEBUG=false +PYTHON_API_2=false +PYTHON_API_3=false + +OPTS=`getopt -o h --long help,gdb,gtest_args:,all,libcarla-release,libcarla-debug,python-api-2,python-api-3,benchmark -n 'parse-options' -- "$@"` + +if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi + +eval set -- "$OPTS" + +while true; do + case "$1" in + --gdb ) + GDB="gdb --args"; + shift ;; + --gtest_args ) + GTEST_ARGS="$2"; + shift ;; + --all ) + LIBCARLA_RELEASE=true; + LIBCARLA_DEBUG=true; + PYTHON_API_2=true; + PYTHON_API_3=true; + shift ;; + --libcarla-release ) + LIBCARLA_RELEASE=true; + shift ;; + --libcarla-debug ) + LIBCARLA_DEBUG=true; + shift ;; + --python-api-2 ) + PYTHON_API_2=true; + shift ;; + --python-api-3 ) + PYTHON_API_3=true; + shift ;; + --benchmark ) + LIBCARLA_RELEASE=true; + GTEST_ARGS="--gtest_filter=benchmark*"; + shift ;; + -h | --help ) + echo "$DOC_STRING" + echo -e "$USAGE_STRING" + exit 1 + ;; + * ) + break ;; + esac +done + +if ! { ${LIBCARLA_RELEASE} || ${LIBCARLA_DEBUG} || ${PYTHON_API_2} || ${PYTHON_API_3}; }; then + fatal_error "Nothing selected to be done." +fi + +# ============================================================================== +# -- Run LibCarla tests -------------------------------------------------------- +# ============================================================================== + +if ${LIBCARLA_DEBUG} ; then + + log "Running LibCarla unit tests debug." + + LD_LIBRARY_PATH=${LIBCARLA_INSTALL_SERVER_FOLDER}/lib ${GDB} ${LIBCARLA_INSTALL_SERVER_FOLDER}/test/libcarla_test_debug ${GTEST_ARGS} + +fi + +if ${LIBCARLA_RELEASE} ; then + + log "Running LibCarla unit tests release." + + LD_LIBRARY_PATH=${LIBCARLA_INSTALL_SERVER_FOLDER}/lib ${GDB} ${LIBCARLA_INSTALL_SERVER_FOLDER}/test/libcarla_test_release ${GTEST_ARGS} + +fi + +# ============================================================================== +# -- Run Python API tests ------------------------------------------------------ +# ============================================================================== + +pushd "${CARLA_PYTHONAPI_ROOT_FOLDER}/test" >/dev/null + +if ${PYTHON_API_2} ; then + + log "Running Python API for Python 2 unit tests." + + /usr/bin/env python2 -m nose2 + +fi + +if ${PYTHON_API_3} ; then + + log "Running Python API for Python 3 unit tests." + + /usr/bin/env python3 -m nose2 + +fi + +popd >/dev/null + +# ============================================================================== +# -- ...and we are done -------------------------------------------------------- +# ============================================================================== + +log "Success!" diff --git a/Util/BuildTools/Environment.sh b/Util/BuildTools/Environment.sh new file mode 100644 index 000000000..03a334009 --- /dev/null +++ b/Util/BuildTools/Environment.sh @@ -0,0 +1,47 @@ +#! /bin/bash + +# Sets the environment for other shell scripts. + +set -e + +CURDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )/../.." && pwd )" +source $(dirname "$0")/Vars.mk +unset CURDIR + +if [ -n "${CARLA_BUILD_NO_COLOR}" ]; then + + function log { + echo "`basename "$0"`: $1" + } + + function fatal_error { + echo -e >&2 "`basename "$0"`: ERROR: $1" + exit 2 + } + +else + + function log { + echo -e "\033[1;35m`basename "$0"`: $1\033[0m" + } + + function fatal_error { + echo -e >&2 "\033[0;31m`basename "$0"`: ERROR: $1\033[0m" + exit 2 + } + +fi + +function get_carla_version { + git describe --tags --dirty --always +} + +function copy_if_changed { + mkdir -p $(dirname $2) + rsync -cI --out-format="%n" $1 $2 +} + +function move_if_changed { + copy_if_changed $1 $2 + rm -f $1 +} diff --git a/Util/BuildTools/Linux.mk b/Util/BuildTools/Linux.mk new file mode 100644 index 000000000..a1100969e --- /dev/null +++ b/Util/BuildTools/Linux.mk @@ -0,0 +1,57 @@ +ARGS=--all + +default: help + +help: + @less ${CARLA_BUILD_TOOLS_FOLDER}/Linux.mk.help + +launch: LibCarla + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --build --launch + +launch-only: + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --launch + +package: CarlaUE4Editor PythonAPI + @${CARLA_BUILD_TOOLS_FOLDER}/Package.sh + +docs: + @doxygen + @echo "Documentation index at ./Doxygen/html/index.html" + +clean: + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --clean + @${CARLA_BUILD_TOOLS_FOLDER}/BuildPythonAPI.sh --clean + @${CARLA_BUILD_TOOLS_FOLDER}/BuildLibCarla.sh --clean + +rebuild: setup + @${CARLA_BUILD_TOOLS_FOLDER}/BuildLibCarla.sh --rebuild + @${CARLA_BUILD_TOOLS_FOLDER}/BuildPythonAPI.sh --rebuild + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --rebuild + +hard-clean: clean + @rm -Rf ${CARLA_BUILD_FOLDER} + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --hard-clean + +check: PythonAPI + @${CARLA_BUILD_TOOLS_FOLDER}/Check.sh $(ARGS) + +benchmark: LibCarla + @${CARLA_BUILD_TOOLS_FOLDER}/Check.sh --benchmark + @cat profiler.csv + +CarlaUE4Editor: LibCarla + @${CARLA_BUILD_TOOLS_FOLDER}/BuildCarlaUE4.sh --build + +.PHONY: PythonAPI +PythonAPI: LibCarla + @${CARLA_BUILD_TOOLS_FOLDER}/BuildPythonAPI.sh --py2 --py3 + +.PHONY: LibCarla +LibCarla: setup + @${CARLA_BUILD_TOOLS_FOLDER}/BuildLibCarla.sh --server --client + +setup: + @${CARLA_BUILD_TOOLS_FOLDER}/Setup.sh + +pretty: + @${CARLA_BUILD_TOOLS_FOLDER}/Prettify.sh $(ARGS) diff --git a/Util/BuildTools/Linux.mk.help b/Util/BuildTools/Linux.mk.help new file mode 100644 index 000000000..28f4d7627 --- /dev/null +++ b/Util/BuildTools/Linux.mk.help @@ -0,0 +1,77 @@ +Welcome to CARLA Simulator! +=========================== + +This Makefile will help you building the different CARLA utilities. + +Use the following commands: + + help: + + Display this help message. + + launch: + + Compile CarlaUE4 project and launch it in Unreal Engine's Editor. + + launch-only: + + Launch CarlaUE4 project in Unreal Engine's Editor, but skip building + step (assume the project is already built). + + package: + + Makes a packaged version of CARLA ready for distribution. + + docs: + + Build CARLA Doxygen documentation. + + clean: + + Remove intermediate build files. + + rebuild: + + Remove intermediate build files and rebuild the whole project. + + hard-clean: + + Remove intermediate build files and dependencies, and force a + recompilation of Unreal Engine's pre-compiled headers. Useful for + fixing "version.h has been modified since the precompiled header" + errors. Beware, recompilation takes a long time! + + +There are also some lower level commands for building individual modules helpful +for developers: + + check: + + Run unit test suites for LibCarla and PythonAPI. + + benchmark: + + Run the benchmark tests for LibCarla. + + CarlaUE4Editor: + + Build CarlaUE4 project, but do not launch the editor. + + PythonAPI: + + Build and package the Python API module for Python 2 and 3. + + LibCarla: + + Build the LibCarla library, both "Server" and "Client" configurations. + + setup: + + Run the setup step only. + + pretty: + + Prettify code files. Run uncrustify on C++ files or AutoPEP8 on Python + files. To prettify a single file, use: make pretty ARGS=-f/path/to/file. + + diff --git a/Package.sh b/Util/BuildTools/Package.sh similarity index 59% rename from Package.sh rename to Util/BuildTools/Package.sh index 155fd65d9..92155640d 100755 --- a/Package.sh +++ b/Util/BuildTools/Package.sh @@ -1,20 +1,15 @@ #! /bin/bash -################################################################################ -# Packages a CARLA build. -################################################################################ - -set -e - -DOC_STRING="Makes a packaged version of CARLA for distribution. -Please make sure to run Rebuild.sh before!" - -USAGE_STRING="Usage: $0 [-h|--help] [--no-packaging] [--no-zip] [--clean-intermediate]" +source $(dirname "$0")/Environment.sh # ============================================================================== # -- Parse arguments ----------------------------------------------------------- # ============================================================================== +DOC_STRING="Makes a packaged version of CARLA for distribution." + +USAGE_STRING="Usage: $0 [-h|--help] [--no-packaging] [--no-zip] [--clean-intermediate]" + DO_PACKAGE=true DO_COPY_FILES=true DO_TARBALL=true @@ -47,39 +42,21 @@ while true; do esac done -# ============================================================================== -# -- Set up environment -------------------------------------------------------- -# ============================================================================== - -SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" -pushd "$SCRIPT_DIR" >/dev/null - -REPOSITORY_TAG=`git describe --tags --dirty --always` - -echo "Packaging version '$REPOSITORY_TAG'." - -UNREAL_PROJECT_FOLDER=${PWD}/Unreal/CarlaUE4 -DIST_FOLDER=${PWD}/Dist -BUILD_FOLDER=${DIST_FOLDER}/${REPOSITORY_TAG} - -function fatal_error { - echo -e "\033[0;31mERROR: $1\033[0m" - exit 1 -} - -function log { - echo -e "\033[0;33m$1\033[0m" -} - # ============================================================================== # -- Package project ----------------------------------------------------------- # ============================================================================== +REPOSITORY_TAG=$(get_carla_version) + +BUILD_FOLDER=${CARLA_DIST_FOLDER}/${REPOSITORY_TAG} + +log "Packaging version '$REPOSITORY_TAG'." + if $DO_PACKAGE ; then - pushd "$UNREAL_PROJECT_FOLDER" >/dev/null + pushd "${CARLAUE4_ROOT_FOLDER}" >/dev/null - log "Packaging the project..." + log "Packaging the project." if [ ! -d "${UE4_ROOT}" ]; then fatal_error "UE4_ROOT is not defined, or points to a non-existant directory, please set this environment variable." @@ -105,34 +82,25 @@ if [[ ! -d ${BUILD_FOLDER}/LinuxNoEditor ]] ; then fi # ============================================================================== -# -- Copy files (Python server, README, etc) ----------------------------------- +# -- Copy files (Python API, README, etc) -------------------------------------- # ============================================================================== if $DO_COPY_FILES ; then DESTINATION=${BUILD_FOLDER}/LinuxNoEditor - log "Copying extra files..." + log "Adding extra files to package." - cp -v ./LICENSE ${DESTINATION}/LICENSE - cp -v ./CHANGELOG.md ${DESTINATION}/CHANGELOG - cp -v ./Docs/release_readme.md ${DESTINATION}/README - cp -v ./Docs/Example.CarlaSettings.ini ${DESTINATION}/Example.CarlaSettings.ini - cp -v ./Util/Docker/Release.Dockerfile ${DESTINATION}/Dockerfile + pushd ${CARLA_ROOT_FOLDER} >/dev/null - rsync -vhr --delete --delete-excluded \ - --exclude "*.egg-info" \ - --exclude "*.log" \ - --exclude "*.pyc" \ - --exclude ".*" \ - --exclude ".tags*" \ - --exclude "__pycache__" \ - --exclude "_benchmarks_results*" \ - --exclude "_images*" \ - --exclude "_out*" \ - PythonClient/ ${DESTINATION}/PythonClient + copy_if_changed "./LICENSE" "${DESTINATION}/LICENSE" + copy_if_changed "./CHANGELOG.md" "${DESTINATION}/CHANGELOG" + copy_if_changed "./Docs/release_readme.md" "${DESTINATION}/README" + copy_if_changed "./Docs/Example.CarlaSettings.ini" "${DESTINATION}/Example.CarlaSettings.ini" + copy_if_changed "./Util/Docker/Release.Dockerfile" "${DESTINATION}/Dockerfile" + copy_if_changed "./PythonAPI/dist/*.egg" "${DESTINATION}/PythonAPI" - echo + popd >/dev/null fi @@ -142,12 +110,12 @@ fi if $DO_TARBALL ; then - DESTINATION=${DIST_FOLDER}/CARLA_${REPOSITORY_TAG}.tar.gz + DESTINATION=${CARLA_DIST_FOLDER}/CARLA_${REPOSITORY_TAG}.tar.gz SOURCE=${BUILD_FOLDER}/LinuxNoEditor - pushd "$SOURCE" >/dev/null + pushd "${SOURCE}" >/dev/null - log "Packaging build..." + log "Packaging build." rm -f ./Manifest_NonUFSFiles_Linux.txt rm -Rf ./CarlaUE4/Saved @@ -165,7 +133,7 @@ fi if $DO_CLEAN_INTERMEDIATE ; then - log "Removing intermediate build..." + log "Removing intermediate build." rm -Rf ${BUILD_FOLDER} @@ -176,16 +144,10 @@ fi # ============================================================================== if $DO_TARBALL ; then - FINAL_PACKAGE=Dist/CARLA_${REPOSITORY_TAG}.tar.gz + FINAL_PACKAGE=${CARLA_DIST_FOLDER}/CARLA_${REPOSITORY_TAG}.tar.gz else - FINAL_PACKAGE=Dist/${REPOSITORY_TAG} + FINAL_PACKAGE=${BUILD_FOLDER} fi -echo -echo "Packaged version created at ${FINAL_PACKAGE}" -echo -echo "****************" -echo "*** Success! ***" -echo "****************" - -popd >/dev/null +log "Packaged version created at ${FINAL_PACKAGE}" +log "Success!" diff --git a/Util/BuildTools/Prettify.sh b/Util/BuildTools/Prettify.sh new file mode 100755 index 000000000..631e6e909 --- /dev/null +++ b/Util/BuildTools/Prettify.sh @@ -0,0 +1,137 @@ +#! /bin/bash + +# ============================================================================== +# -- Set up environment -------------------------------------------------------- +# ============================================================================== + +source $(dirname "$0")/Environment.sh + +# ============================================================================== +# -- Parse arguments ----------------------------------------------------------- +# ============================================================================== + +DOC_STRING="Prettify code files." + +USAGE_STRING="Usage: $0 [-h|--help] [--all] [-f path|--file=path]" + +PRETTIFY_ALL=false +PRETTIFY_FILE=false + +OPTS=`getopt -o hf: --long help,all,file: -n 'parse-options' -- "$@"` + +if [ $? != 0 ] ; then echo "$USAGE_STRING" ; exit 2 ; fi + +eval set -- "$OPTS" + +while true; do + case "$1" in + --all ) + PRETTIFY_ALL=true; + shift ;; + -f | --file ) + PRETTIFY_FILE="$2"; + shift ;; + -h | --help ) + echo "$DOC_STRING" + echo "$USAGE_STRING" + exit 1 + ;; + * ) + break ;; + esac +done + +if ! { ${PRETTIFY_ALL} || [ -n "${PRETTIFY_FILE}" ]; } ; then + fatal_error "Nothing selected to be done." +fi + +if ${PRETTIFY_ALL} ; then + PRETTIFY_FILE=false +elif [[ ! -f ${PRETTIFY_FILE} ]] ; then + pwd + fatal_error "\"${PRETTIFY_FILE}\" no such file." +fi + +# ============================================================================== +# -- Get latest version of uncrustify ------------------------------------------ +# ============================================================================== + +mkdir -p ${CARLA_BUILD_FOLDER} +pushd ${CARLA_BUILD_FOLDER} >/dev/null + +UNCRUSTIFY_BASENAME=uncrustify-0.67 + +UNCRUSTIFY=${PWD}/${UNCRUSTIFY_BASENAME}-install/bin/uncrustify + +if [[ -d "${UNCRUSTIFY_BASENAME}-install" ]] ; then + log "${UNCRUSTIFY_BASENAME} already installed." +else + rm -Rf ${UNCRUSTIFY_BASENAME}-source ${UNCRUSTIFY_BASENAME}-build + + log "Retrieving Uncrustify." + + git clone --depth=1 -b uncrustify-0.67 https://github.com/uncrustify/uncrustify.git ${UNCRUSTIFY_BASENAME}-source + + log "Building Uncrustify." + + mkdir -p ${UNCRUSTIFY_BASENAME}-build + + pushd ${UNCRUSTIFY_BASENAME}-build >/dev/null + + cmake -G "Ninja" \ + -DCMAKE_BUILD_TYPE=Release \ + -DCMAKE_INSTALL_PREFIX="../${UNCRUSTIFY_BASENAME}-install" \ + ../${UNCRUSTIFY_BASENAME}-source + + ninja + + ninja install + + popd >/dev/null + + rm -Rf ${UNCRUSTIFY_BASENAME}-source ${UNCRUSTIFY_BASENAME}-build + +fi + +command -v ${UNCRUSTIFY} >/dev/null 2>&1 || { + fatal_error "Failed to install Uncrustify!"; +} + +popd >/dev/null + +command -v autopep8 >/dev/null 2>&1 || { + log "Installing autopep8 for this user." + pip3 install --user autopep8 +} + +# ============================================================================== +# -- Run uncrustify and/or autopep8 -------------------------------------------- +# ============================================================================== + +UNCRUSTIFY_CONFIG=${CARLA_BUILD_TOOLS_FOLDER}/uncrustify.cfg +UNCRUSTIFY_COMMAND="${UNCRUSTIFY} -c ${UNCRUSTIFY_CONFIG} --no-backup --replace" + +AUTOPEP8_COMMAND="autopep8 --jobs 0 --in-place -a" + +if ${PRETTIFY_ALL} ; then + + find ${CARLA_ROOT_FOLDER} -iregex '.*\.\(py\)$' -exec ${AUTOPEP8_COMMAND} {} + + # find ${LIBCARLA_ROOT_FOLDER} -iregex '.*\.\(h\|cpp\)$' -exec ${UNCRUSTIFY_COMMAND} {} \; + +elif [[ -f ${PRETTIFY_FILE} ]] ; then + + if [[ ${PRETTIFY_FILE} == *.py ]] ; then + log "autopep8 ${PRETTIFY_FILE}" + ${AUTOPEP8_COMMAND} ${PRETTIFY_FILE} + else + log "uncrustify ${PRETTIFY_FILE}" + ${UNCRUSTIFY_COMMAND} ${PRETTIFY_FILE} + fi + +fi + +# ============================================================================== +# -- ...and we are done -------------------------------------------------------- +# ============================================================================== + +log "Success!" diff --git a/Util/BuildTools/Setup.sh b/Util/BuildTools/Setup.sh new file mode 100755 index 000000000..214e7daf0 --- /dev/null +++ b/Util/BuildTools/Setup.sh @@ -0,0 +1,267 @@ +#! /bin/bash + +# ============================================================================== +# -- Set up environment -------------------------------------------------------- +# ============================================================================== + +command -v /usr/bin/clang++-5.0 >/dev/null 2>&1 || { + echo >&2 "clang 5.0 is required, but it's not installed."; + echo >&2 "make sure you build Unreal Engine with clang 5.0 too."; + exit 1; +} + +export CC=/usr/bin/clang-5.0 +export CXX=/usr/bin/clang++-5.0 + +source $(dirname "$0")/Environment.sh + +mkdir -p ${CARLA_BUILD_FOLDER} +pushd ${CARLA_BUILD_FOLDER} >/dev/null + +# ============================================================================== +# -- Get and compile libc++ ---------------------------------------------------- +# ============================================================================== + +LLVM_BASENAME=llvm-5.0 + +LLVM_INCLUDE=${PWD}/${LLVM_BASENAME}-install/include/c++/v1 +LLVM_LIBPATH=${PWD}/${LLVM_BASENAME}-install/lib + +if [[ -d "${LLVM_BASENAME}-install" ]] ; then + log "${LLVM_BASENAME} already installed." +else + rm -Rf ${LLVM_BASENAME}-source ${LLVM_BASENAME}-build + + log "Retrieving libc++." + + git clone --depth=1 -b release_50 https://github.com/llvm-mirror/llvm.git ${LLVM_BASENAME}-source + git clone --depth=1 -b release_50 https://github.com/llvm-mirror/libcxx.git ${LLVM_BASENAME}-source/projects/libcxx + git clone --depth=1 -b release_50 https://github.com/llvm-mirror/libcxxabi.git ${LLVM_BASENAME}-source/projects/libcxxabi + + log "Compiling libc++." + + mkdir -p ${LLVM_BASENAME}-build + + pushd ${LLVM_BASENAME}-build >/dev/null + + cmake -G "Ninja" \ + -DLIBCXX_ENABLE_EXPERIMENTAL_LIBRARY=OFF -DLIBCXX_INSTALL_EXPERIMENTAL_LIBRARY=OFF \ + -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX="../${LLVM_BASENAME}-install" \ + ../${LLVM_BASENAME}-source + + ninja cxx + + ninja install-libcxx + + ninja install-libcxxabi + + popd >/dev/null + + # Workaround, it seems LLVM 5.0 does not install these files. + cp -v ${LLVM_BASENAME}-build/include/c++/v1/cxxabi.h ${LLVM_INCLUDE} + cp -v ${LLVM_BASENAME}-build/include/c++/v1/__cxxabi_config.h ${LLVM_INCLUDE} + + rm -Rf ${LLVM_BASENAME}-source ${LLVM_BASENAME}-build + +fi + +unset LLVM_BASENAME + +# ============================================================================== +# -- Get boost includes -------------------------------------------------------- +# ============================================================================== + +BOOST_BASENAME=boost-1.67.0 + +BOOST_INCLUDE=${PWD}/${BOOST_BASENAME}-install/include + +if [[ -d "${BOOST_BASENAME}-install" ]] ; then + log "${BOOST_BASENAME} already installed." +else + + log "Retrieving boost." + wget https://dl.bintray.com/boostorg/release/1.67.0/source/boost_1_67_0.tar.gz + log "Extracting boost." + tar -xzf boost_1_67_0.tar.gz + rm boost_1_67_0.tar.gz + mkdir -p ${BOOST_BASENAME}-install/include + mv boost_1_67_0/boost ${BOOST_BASENAME}-install/include/ + rm -Rf boost_1_67_0 + +fi + +unset BOOST_BASENAME + +# ============================================================================== +# -- Get rpclib and compile it with libc++ and libstdc++ ----------------------- +# ============================================================================== + +RPCLIB_BASENAME=rpclib-2.2.1 + +RPCLIB_LIBCXX_INCLUDE=${PWD}/${RPCLIB_BASENAME}-libcxx-install/include +RPCLIB_LIBCXX_LIBPATH=${PWD}/${RPCLIB_BASENAME}-libcxx-install/lib +RPCLIB_LIBSTDCXX_INCLUDE=${PWD}/${RPCLIB_BASENAME}-libstdcxx-install/include +RPCLIB_LIBSTDCXX_LIBPATH=${PWD}/${RPCLIB_BASENAME}-libstdcxx-install/lib + +if [[ -d "${RPCLIB_BASENAME}-libcxx-install" && -d "${RPCLIB_BASENAME}-libstdcxx-install" ]] ; then + log "${RPCLIB_BASENAME} already installed." +else + rm -Rf \ + ${RPCLIB_BASENAME}-source \ + ${RPCLIB_BASENAME}-libcxx-build ${RPCLIB_BASENAME}-libstdcxx-build \ + ${RPCLIB_BASENAME}-libcxx-install ${RPCLIB_BASENAME}-libstdcxx-install + + log "Retrieving rpclib." + + git clone --depth=1 -b v2.2.1 https://github.com/rpclib/rpclib.git ${RPCLIB_BASENAME}-source + + log "Building rpclib with libc++." + + mkdir -p ${RPCLIB_BASENAME}-libcxx-build + + pushd ${RPCLIB_BASENAME}-libcxx-build >/dev/null + + cmake -G "Ninja" \ + -DCMAKE_CXX_FLAGS="-fPIC -std=c++17 -stdlib=libc++ -I${LLVM_INCLUDE} -Wl,-L${LLVM_LIBPATH}" \ + -DCMAKE_INSTALL_PREFIX="../${RPCLIB_BASENAME}-libcxx-install" \ + ../${RPCLIB_BASENAME}-source + + ninja + + ninja install + + popd >/dev/null + + log "Building rpclib with libstdc++." + + mkdir -p ${RPCLIB_BASENAME}-libstdcxx-build + + pushd ${RPCLIB_BASENAME}-libstdcxx-build >/dev/null + + cmake -G "Ninja" \ + -DCMAKE_CXX_FLAGS="-fPIC -std=c++17" \ + -DCMAKE_INSTALL_PREFIX="../${RPCLIB_BASENAME}-libstdcxx-install" \ + ../${RPCLIB_BASENAME}-source + + ninja + + ninja install + + popd >/dev/null + + rm -Rf ${RPCLIB_BASENAME}-source ${RPCLIB_BASENAME}-libcxx-build ${RPCLIB_BASENAME}-libstdcxx-build + +fi + +unset RPCLIB_BASENAME + +# ============================================================================== +# -- Get GTest and compile it with libc++ -------------------------------------- +# ============================================================================== + +GTEST_BASENAME=googletest-1.8.0 + +GTEST_INCLUDE=${PWD}/${GTEST_BASENAME}-install/include +GTEST_LIBPATH=${PWD}/${GTEST_BASENAME}-install/lib + +if [[ -d "${GTEST_BASENAME}-install" ]] ; then + log "${GTEST_BASENAME} already installed." +else + rm -Rf ${GTEST_BASENAME}-source ${GTEST_BASENAME}-build + + log "Retrieving Google Test." + + git clone --depth=1 -b release-1.8.0 https://github.com/google/googletest.git ${GTEST_BASENAME}-source + + log "Building Google Test." + + mkdir -p ${GTEST_BASENAME}-build + + pushd ${GTEST_BASENAME}-build >/dev/null + + cmake -G "Ninja" \ + -DCMAKE_CXX_FLAGS="-std=c++17 -stdlib=libc++ -I${LLVM_INCLUDE} -Wl,-L${LLVM_LIBPATH}" \ + -DCMAKE_INSTALL_PREFIX="../${GTEST_BASENAME}-install" \ + ../${GTEST_BASENAME}-source + + ninja + + ninja install + + popd >/dev/null + + rm -Rf ${GTEST_BASENAME}-source ${GTEST_BASENAME}-build + +fi + +# ============================================================================== +# -- Generate CMake toolchains and config -------------------------------------- +# ============================================================================== + +log "Generating CMake configuration files." + +# -- LIBSTDCPP_TOOLCHAIN_FILE -------------------------------------------------- + +cat >${LIBSTDCPP_TOOLCHAIN_FILE}.gen <>${LIBCPP_TOOLCHAIN_FILE}.gen <${CMAKE_CONFIG_FILE}.gen </dev/null + +log "Success!" diff --git a/Util/BuildTools/Vars.mk b/Util/BuildTools/Vars.mk new file mode 100644 index 000000000..997f4ab8e --- /dev/null +++ b/Util/BuildTools/Vars.mk @@ -0,0 +1,22 @@ +# Here CURDIR is assumed to be the root folder of the project. + +CARLA_ROOT_FOLDER=${CURDIR} +CARLA_BUILD_FOLDER=${CURDIR}/Build +CARLA_DIST_FOLDER=${CURDIR}/Dist +CARLA_BUILD_TOOLS_FOLDER=${CURDIR}/Util/BuildTools + +CARLAUE4_ROOT_FOLDER=${CURDIR}/Unreal/CarlaUE4 +CARLAUE4_PLUGIN_ROOT_FOLDER=${CURDIR}/Unreal/CarlaUE4/Plugins/Carla +CARLA_PYTHONAPI_ROOT_FOLDER=${CURDIR}/PythonAPI + +LIBCARLA_ROOT_FOLDER=${CURDIR}/LibCarla +LIBCARLA_BUILD_SERVER_FOLDER=${CARLA_BUILD_FOLDER}/libcarla-server-build +LIBCARLA_BUILD_CLIENT_FOLDER=${CARLA_BUILD_FOLDER}/libcarla-client-build +LIBCARLA_INSTALL_SERVER_FOLDER=${CARLAUE4_PLUGIN_ROOT_FOLDER}/CarlaDependencies +LIBCARLA_INSTALL_CLIENT_FOLDER=${CARLA_PYTHONAPI_ROOT_FOLDER}/dependencies + +CARLAUE4_PLUGIN_DEPS_FOLDER=${CARLAUE4_PLUGIN_ROOT_FOLDER}/CarlaDependencies + +LIBSTDCPP_TOOLCHAIN_FILE=${CARLA_BUILD_FOLDER}/LibStdCppToolChain.cmake +LIBCPP_TOOLCHAIN_FILE=${CARLA_BUILD_FOLDER}/LibCppToolChain.cmake +CMAKE_CONFIG_FILE=${CARLA_BUILD_FOLDER}/CMakeLists.txt.in diff --git a/Util/BuildTools/Windows.mk b/Util/BuildTools/Windows.mk new file mode 100644 index 000000000..6fdd66328 --- /dev/null +++ b/Util/BuildTools/Windows.mk @@ -0,0 +1,2 @@ +default: + @echo "Not implemented!" diff --git a/Util/BuildTools/uncrustify.cfg b/Util/BuildTools/uncrustify.cfg new file mode 100644 index 000000000..926933119 --- /dev/null +++ b/Util/BuildTools/uncrustify.cfg @@ -0,0 +1,2239 @@ +# Uncrustify-0.67 + +# +# General options +# + +# The type of line endings. Default=Auto. +newlines = auto # auto/lf/crlf/cr + +# The original size of tabs in the input. Default=8. +input_tab_size = 2 # unsigned number + +# The size of tabs in the output (only used if align_with_tabs=true). Default=8. +output_tab_size = 2 # unsigned number + +# The ASCII value of the string escape char, usually 92 (\) or 94 (^). (Pawn). +string_escape_char = 92 # unsigned number + +# Alternate string escape char for Pawn. Only works right before the quote char. +string_escape_char2 = 0 # unsigned number + +# Replace tab characters found in string literals with the escape sequence \t instead. +string_replace_tab_chars = true # false/true + +# Allow interpreting '>=' and '>>=' as part of a template in 'void f(list>=val);'. +# If True, 'assert(x<0 && y>=3)' will be broken. Default=False +# Improvements to template detection may make this option obsolete. +tok_split_gte = false # false/true + +# Override the default ' *INDENT-OFF*' in comments for disabling processing of part of the file. +disable_processing_cmt = "" # string + +# Override the default ' *INDENT-ON*' in comments for enabling processing of part of the file. +enable_processing_cmt = "" # string + +# Enable parsing of digraphs. Default=False. +enable_digraphs = false # false/true + +# Control what to do with the UTF-8 BOM (recommend 'remove'). +utf8_bom = ignore # ignore/add/remove/force + +# If the file contains bytes with values between 128 and 255, but is not UTF-8, then output as UTF-8. +utf8_byte = false # false/true + +# Force the output encoding to UTF-8. +utf8_force = false # false/true + +# +# Spacing options +# + +# Add or remove space around arithmetic operator '+', '-', '/', '*', etc +# also '>>>' '<<' '>>' '%' '|'. +sp_arith = add # ignore/add/remove/force + +# Add or remove space around arithmetic operator '+' and '-'. Overrides sp_arith +sp_arith_additive = add # ignore/add/remove/force + +# Add or remove space around assignment operator '=', '+=', etc. +sp_assign = add # ignore/add/remove/force + +# Add or remove space around '=' in C++11 lambda capture specifications. Overrides sp_assign. +sp_cpp_lambda_assign = remove # ignore/add/remove/force + +# Add or remove space after the capture specification in C++11 lambda. +sp_cpp_lambda_paren = ignore # ignore/add/remove/force + +# Add or remove space around assignment operator '=' in a prototype. +sp_assign_default = ignore # ignore/add/remove/force + +# Add or remove space before assignment operator '=', '+=', etc. Overrides sp_assign. +sp_before_assign = ignore # ignore/add/remove/force + +# Add or remove space after assignment operator '=', '+=', etc. Overrides sp_assign. +sp_after_assign = ignore # ignore/add/remove/force + +# Add or remove space in 'NS_ENUM ('. +sp_enum_paren = ignore # ignore/add/remove/force + +# Add or remove space around assignment '=' in enum. +sp_enum_assign = add # ignore/add/remove/force + +# Add or remove space before assignment '=' in enum. Overrides sp_enum_assign. +sp_enum_before_assign = ignore # ignore/add/remove/force + +# Add or remove space after assignment '=' in enum. Overrides sp_enum_assign. +sp_enum_after_assign = ignore # ignore/add/remove/force + +# Add or remove space around assignment ':' in enum. +sp_enum_colon = ignore # ignore/add/remove/force + +# Add or remove space around preprocessor '##' concatenation operator. Default=Add. +sp_pp_concat = add # ignore/add/remove/force + +# Add or remove space after preprocessor '#' stringify operator. Also affects the '#@' charizing operator. +sp_pp_stringify = add # ignore/add/remove/force + +# Add or remove space before preprocessor '#' stringify operator as in '#define x(y) L#y'. +sp_before_pp_stringify = ignore # ignore/add/remove/force + +# Add or remove space around boolean operators '&&' and '||'. +sp_bool = force # ignore/add/remove/force + +# Add or remove space around compare operator '<', '>', '==', etc. +sp_compare = add # ignore/add/remove/force + +# Add or remove space inside '(' and ')'. +sp_inside_paren = remove # ignore/add/remove/force + +# Add or remove space between nested parens: '((' vs ') )'. +sp_paren_paren = remove # ignore/add/remove/force + +# Add or remove space between back-to-back parens: ')(' vs ') ('. +sp_cparen_oparen = ignore # ignore/add/remove/force + +# Whether to balance spaces inside nested parens. +sp_balance_nested_parens = false # false/true + +# Add or remove space between ')' and '{'. +sp_paren_brace = force # ignore/add/remove/force + +# Add or remove space before pointer star '*'. +sp_before_ptr_star = force # ignore/add/remove/force + +# Add or remove space before pointer star '*' that isn't followed by a variable name +# If set to 'ignore', sp_before_ptr_star is used instead. +sp_before_unnamed_ptr_star = force # ignore/add/remove/force + +# Add or remove space between pointer stars '*'. +sp_between_ptr_star = remove # ignore/add/remove/force + +# Add or remove space after pointer star '*', if followed by a word. +sp_after_ptr_star = remove # ignore/add/remove/force + +# Add or remove space after pointer caret '^', if followed by a word. +sp_after_ptr_block_caret = ignore # ignore/add/remove/force + +# Add or remove space after pointer star '*', if followed by a qualifier. +sp_after_ptr_star_qualifier = ignore # ignore/add/remove/force + +# Add or remove space after a pointer star '*', if followed by a func proto/def. +sp_after_ptr_star_func = ignore # ignore/add/remove/force + +# Add or remove space after a pointer star '*', if followed by an open paren (function types). +sp_ptr_star_paren = ignore # ignore/add/remove/force + +# Add or remove space before a pointer star '*', if followed by a func proto/def. +sp_before_ptr_star_func = force # ignore/add/remove/force + +# Add or remove space before a reference sign '&'. +sp_before_byref = force # ignore/add/remove/force + +# Add or remove space before a reference sign '&' that isn't followed by a variable name. +# If set to 'ignore', sp_before_byref is used instead. +sp_before_unnamed_byref = force # ignore/add/remove/force + +# Add or remove space after reference sign '&', if followed by a word. +sp_after_byref = remove # ignore/add/remove/force + +# Add or remove space after a reference sign '&', if followed by a func proto/def. +sp_after_byref_func = remove # ignore/add/remove/force + +# Add or remove space before a reference sign '&', if followed by a func proto/def. +sp_before_byref_func = force # ignore/add/remove/force + +# Add or remove space between type and word. Default=Force. +sp_after_type = force # ignore/add/remove/force + +# Add or remove space before the paren in the D constructs 'template Foo(' and 'class Foo('. +sp_before_template_paren = ignore # ignore/add/remove/force + +# Add or remove space in 'template <' vs 'template<'. +# If set to ignore, sp_before_angle is used. +sp_template_angle = force # ignore/add/remove/force + +# Add or remove space before '<>'. +sp_before_angle = remove # ignore/add/remove/force + +# Add or remove space inside '<' and '>'. +sp_inside_angle = remove # ignore/add/remove/force + +# Add or remove space between '<>' and ':'. +sp_angle_colon = ignore # ignore/add/remove/force + +# Add or remove space after '<>'. +sp_after_angle = ignore # ignore/add/remove/force + +# Add or remove space between '<>' and '(' as found in 'new List(foo);'. +sp_angle_paren = remove # ignore/add/remove/force + +# Add or remove space between '<>' and '()' as found in 'new List();'. +sp_angle_paren_empty = remove # ignore/add/remove/force + +# Add or remove space between '<>' and a word as in 'List m;' or 'template static ...'. +sp_angle_word = force # ignore/add/remove/force + +# Add or remove space between '>' and '>' in '>>' (template stuff). Default=Add. +sp_angle_shift = remove # ignore/add/remove/force + +# Permit removal of the space between '>>' in 'foo >' (C++11 only). Default=False. +# sp_angle_shift cannot remove the space without this option. +sp_permit_cpp11_shift = true # false/true + +# Add or remove space before '(' of 'if', 'for', 'switch', 'while', etc. +sp_before_sparen = force # ignore/add/remove/force + +# Add or remove space inside if-condition '(' and ')'. +sp_inside_sparen = remove # ignore/add/remove/force + +# Add or remove space before if-condition ')'. Overrides sp_inside_sparen. +sp_inside_sparen_close = ignore # ignore/add/remove/force + +# Add or remove space after if-condition '('. Overrides sp_inside_sparen. +sp_inside_sparen_open = ignore # ignore/add/remove/force + +# Add or remove space after ')' of 'if', 'for', 'switch', and 'while', etc. +sp_after_sparen = force # ignore/add/remove/force + +# Add or remove space between ')' and '{' of 'if', 'for', 'switch', and 'while', etc. +sp_sparen_brace = force # ignore/add/remove/force + +# Add or remove space between 'invariant' and '(' in the D language. +sp_invariant_paren = ignore # ignore/add/remove/force + +# Add or remove space after the ')' in 'invariant (C) c' in the D language. +sp_after_invariant_paren = ignore # ignore/add/remove/force + +# Add or remove space before empty statement ';' on 'if', 'for' and 'while'. +sp_special_semi = ignore # ignore/add/remove/force + +# Add or remove space before ';'. Default=Remove. +sp_before_semi = remove # ignore/add/remove/force + +# Add or remove space before ';' in non-empty 'for' statements. +sp_before_semi_for = ignore # ignore/add/remove/force + +# Add or remove space before a semicolon of an empty part of a for statement. +sp_before_semi_for_empty = ignore # ignore/add/remove/force + +# Add or remove space after ';', except when followed by a comment. Default=Add. +sp_after_semi = add # ignore/add/remove/force + +# Add or remove space after ';' in non-empty 'for' statements. Default=Force. +sp_after_semi_for = force # ignore/add/remove/force + +# Add or remove space after the final semicolon of an empty part of a for statement: for ( ; ; ). +sp_after_semi_for_empty = ignore # ignore/add/remove/force + +# Add or remove space before '[' (except '[]'). +sp_before_square = remove # ignore/add/remove/force + +# Add or remove space before '[]'. +sp_before_squares = remove # ignore/add/remove/force + +# Add or remove space before structured bindings. Only for C++17. +sp_cpp_before_struct_binding = ignore # ignore/add/remove/force + +# Add or remove space inside a non-empty '[' and ']'. +sp_inside_square = remove # ignore/add/remove/force + +# Add or remove space inside a non-empty OC boxed array '@[' and ']'. +# If set to ignore, sp_inside_square is used. +sp_inside_square_oc_array = ignore # ignore/add/remove/force + +# Add or remove space after ',', 'a,b' vs 'a, b'. +sp_after_comma = add # ignore/add/remove/force + +# Add or remove space before ','. Default=Remove. +sp_before_comma = remove # ignore/add/remove/force + +# Add or remove space between ',' and ']' in multidimensional array type 'int[,,]'. Only for C#. +sp_after_mdatype_commas = ignore # ignore/add/remove/force + +# Add or remove space between '[' and ',' in multidimensional array type 'int[,,]'. Only for C#. +sp_before_mdatype_commas = ignore # ignore/add/remove/force + +# Add or remove space between ',' in multidimensional array type 'int[,,]'. Only for C#. +sp_between_mdatype_commas = ignore # ignore/add/remove/force + +# Add or remove space between an open paren and comma: '(,' vs '( ,'. Default=Force. +sp_paren_comma = force # ignore/add/remove/force + +# Add or remove space before the variadic '...' when preceded by a non-punctuator. +sp_before_ellipsis = ignore # ignore/add/remove/force + +# Add or remove space after class ':'. +sp_after_class_colon = ignore # ignore/add/remove/force + +# Add or remove space before class ':'. +sp_before_class_colon = ignore # ignore/add/remove/force + +# Add or remove space after class constructor ':'. +sp_after_constr_colon = ignore # ignore/add/remove/force + +# Add or remove space before class constructor ':'. +sp_before_constr_colon = ignore # ignore/add/remove/force + +# Add or remove space before case ':'. Default=Remove. +sp_before_case_colon = remove # ignore/add/remove/force + +# Add or remove space between 'operator' and operator sign. +sp_after_operator = remove # ignore/add/remove/force + +# Add or remove space between the operator symbol and the open paren, as in 'operator ++('. +sp_after_operator_sym = remove # ignore/add/remove/force + +# Overrides sp_after_operator_sym when the operator has no arguments, as in 'operator *()'. +sp_after_operator_sym_empty = ignore # ignore/add/remove/force + +# Add or remove space after C/D cast, i.e. 'cast(int)a' vs 'cast(int) a' or '(int)a' vs '(int) a'. +sp_after_cast = force # ignore/add/remove/force + +# Add or remove spaces inside cast parens. +sp_inside_paren_cast = remove # ignore/add/remove/force + +# Add or remove space between the type and open paren in a C++ cast, i.e. 'int(exp)' vs 'int (exp)'. +sp_cpp_cast_paren = remove # ignore/add/remove/force + +# Add or remove space between 'sizeof' and '('. +sp_sizeof_paren = remove # ignore/add/remove/force + +# Add or remove space after the tag keyword (Pawn). +sp_after_tag = ignore # ignore/add/remove/force + +# Add or remove space inside enum '{' and '}'. +sp_inside_braces_enum = force # ignore/add/remove/force + +# Add or remove space inside struct/union '{' and '}'. +sp_inside_braces_struct = force # ignore/add/remove/force + +# Add or remove space inside OC boxed dictionary @'{' and '}' +sp_inside_braces_oc_dict = ignore # ignore/add/remove/force + +# Add or remove space after open brace in an unnamed temporary direct-list-initialization. +sp_after_type_brace_init_lst_open = ignore # ignore/add/remove/force + +# Add or remove space before close brace in an unnamed temporary direct-list-initialization. +sp_before_type_brace_init_lst_close = ignore # ignore/add/remove/force + +# Add or remove space inside an unnamed temporary direct-list-initialization. +sp_inside_type_brace_init_lst = ignore # ignore/add/remove/force + +# Add or remove space inside '{' and '}'. +sp_inside_braces = ignore # ignore/add/remove/force + +# Add or remove space inside '{}'. +sp_inside_braces_empty = remove # ignore/add/remove/force + +# Add or remove space between return type and function name +# A minimum of 1 is forced except for pointer return types. +sp_type_func = force # ignore/add/remove/force + +# Add or remove space between type and open brace of an unnamed temporary direct-list-initialization. +sp_type_brace_init_lst = ignore # ignore/add/remove/force + +# Add or remove space between function name and '(' on function declaration. +sp_func_proto_paren = remove # ignore/add/remove/force + +# Add or remove space between function name and '()' on function declaration without parameters. +sp_func_proto_paren_empty = remove # ignore/add/remove/force + +# Add or remove space between function name and '(' on function definition. +sp_func_def_paren = remove # ignore/add/remove/force + +# Add or remove space between function name and '()' on function definition without parameters. +sp_func_def_paren_empty = remove # ignore/add/remove/force + +# Add or remove space inside empty function '()'. +sp_inside_fparens = remove # ignore/add/remove/force + +# Add or remove space inside function '(' and ')'. +sp_inside_fparen = remove # ignore/add/remove/force + +# Add or remove space inside the first parens in the function type: 'void (*x)(...)'. +sp_inside_tparen = ignore # ignore/add/remove/force + +# Add or remove between the parens in the function type: 'void (*x)(...)'. +sp_after_tparen_close = ignore # ignore/add/remove/force + +# Add or remove space between ']' and '(' when part of a function call. +sp_square_fparen = remove # ignore/add/remove/force + +# Add or remove space between ')' and '{' of function. +sp_fparen_brace = force # ignore/add/remove/force + +# Add or remove space between ')' and '{' of function call in object initialization. Overrides sp_fparen_brace. +sp_fparen_brace_initializer = ignore # ignore/add/remove/force + +# Java: Add or remove space between ')' and '{{' of double brace initializer. +sp_fparen_dbrace = ignore # ignore/add/remove/force + +# Add or remove space between function name and '(' on function calls. +sp_func_call_paren = remove # ignore/add/remove/force + +# Add or remove space between function name and '()' on function calls without parameters. +# If set to 'ignore' (the default), sp_func_call_paren is used. +sp_func_call_paren_empty = ignore # ignore/add/remove/force + +# Add or remove space between the user function name and '(' on function calls +# You need to set a keyword to be a user function, like this: 'set func_call_user _' in the config file. +sp_func_call_user_paren = ignore # ignore/add/remove/force + +# Add or remove space inside user function '(' and ')' +# You need to set a keyword to be a user function, like this: 'set func_call_user _' in the config file. +sp_func_call_user_inside_fparen = ignore # ignore/add/remove/force + +# Add or remove space between nested parens with user functions: '((' vs ') )'You need to set a keyword to be a user function, like this: 'set func_call_user _' in the config file. +sp_func_call_user_paren_paren = ignore # ignore/add/remove/force + +# Add or remove space between a constructor/destructor and the open paren. +sp_func_class_paren = remove # ignore/add/remove/force + +# Add or remove space between a constructor without parameters or destructor and '()'. +sp_func_class_paren_empty = remove # ignore/add/remove/force + +# Add or remove space between 'return' and '('. +sp_return_paren = force # ignore/add/remove/force + +# Add or remove space between '__attribute__' and '('. +sp_attribute_paren = remove # ignore/add/remove/force + +# Add or remove space between 'defined' and '(' in '#if defined (FOO)'. +sp_defined_paren = remove # ignore/add/remove/force + +# Add or remove space between 'throw' and '(' in 'throw (something)'. +sp_throw_paren = ignore # ignore/add/remove/force + +# Add or remove space between 'throw' and anything other than '(' as in '@throw [...];'. +sp_after_throw = ignore # ignore/add/remove/force + +# Add or remove space between 'catch' and '(' in 'catch (something) { }' +# If set to ignore, sp_before_sparen is used. +sp_catch_paren = force # ignore/add/remove/force + +# Add or remove space between '@catch' and '(' in '@catch (something) { }' +# If set to ignore, sp_catch_paren is used. +sp_oc_catch_paren = ignore # ignore/add/remove/force + +# Add or remove space between 'version' and '(' in 'version (something) { }' (D language) +# If set to ignore, sp_before_sparen is used. +sp_version_paren = ignore # ignore/add/remove/force + +# Add or remove space between 'scope' and '(' in 'scope (something) { }' (D language) +# If set to ignore, sp_before_sparen is used. +sp_scope_paren = ignore # ignore/add/remove/force + +# Add or remove space between 'super' and '(' in 'super (something)'. Default=Remove. +sp_super_paren = remove # ignore/add/remove/force + +# Add or remove space between 'this' and '(' in 'this (something)'. Default=Remove. +sp_this_paren = remove # ignore/add/remove/force + +# Add or remove space between macro and value. +sp_macro = force # ignore/add/remove/force + +# Add or remove space between macro function ')' and value. +sp_macro_func = force # ignore/add/remove/force + +# Add or remove space between 'else' and '{' if on the same line. +sp_else_brace = force # ignore/add/remove/force + +# Add or remove space between '}' and 'else' if on the same line. +sp_brace_else = force # ignore/add/remove/force + +# Add or remove space between '}' and the name of a typedef on the same line. +sp_brace_typedef = force # ignore/add/remove/force + +# Add or remove space between 'catch' and '{' if on the same line. +sp_catch_brace = force # ignore/add/remove/force + +# Add or remove space between '@catch' and '{' if on the same line. +# If set to ignore, sp_catch_brace is used. +sp_oc_catch_brace = force # ignore/add/remove/force + +# Add or remove space between '}' and 'catch' if on the same line. +sp_brace_catch = force # ignore/add/remove/force + +# Add or remove space between '}' and '@catch' if on the same line. +# If set to ignore, sp_brace_catch is used. +sp_oc_brace_catch = force # ignore/add/remove/force + +# Add or remove space between 'finally' and '{' if on the same line. +sp_finally_brace = force # ignore/add/remove/force + +# Add or remove space between '}' and 'finally' if on the same line. +sp_brace_finally = force # ignore/add/remove/force + +# Add or remove space between 'try' and '{' if on the same line. +sp_try_brace = force # ignore/add/remove/force + +# Add or remove space between get/set and '{' if on the same line. +sp_getset_brace = force # ignore/add/remove/force + +# Add or remove space between a variable and '{' for C++ uniform initialization. Default=Add. +sp_word_brace = add # ignore/add/remove/force + +# Add or remove space between a variable and '{' for a namespace. Default=Add. +sp_word_brace_ns = add # ignore/add/remove/force + +# Add or remove space before the '::' operator. +sp_before_dc = remove # ignore/add/remove/force + +# Add or remove space after the '::' operator. +sp_after_dc = remove # ignore/add/remove/force + +# Add or remove around the D named array initializer ':' operator. +sp_d_array_colon = ignore # ignore/add/remove/force + +# Add or remove space after the '!' (not) operator. Default=Remove. +sp_not = remove # ignore/add/remove/force + +# Add or remove space after the '~' (invert) operator. Default=Remove. +sp_inv = remove # ignore/add/remove/force + +# Add or remove space after the '&' (address-of) operator. Default=Remove +# This does not affect the spacing after a '&' that is part of a type. +sp_addr = remove # ignore/add/remove/force + +# Add or remove space around the '.' or '->' operators. Default=Remove. +sp_member = remove # ignore/add/remove/force + +# Add or remove space after the '*' (dereference) operator. Default=Remove +# This does not affect the spacing after a '*' that is part of a type. +sp_deref = remove # ignore/add/remove/force + +# Add or remove space after '+' or '-', as in 'x = -5' or 'y = +7'. Default=Remove. +sp_sign = remove # ignore/add/remove/force + +# Add or remove space before or after '++' and '--', as in '(--x)' or 'y++;'. Default=Remove. +sp_incdec = remove # ignore/add/remove/force + +# Add or remove space before a backslash-newline at the end of a line. Default=Add. +sp_before_nl_cont = force # ignore/add/remove/force + +# Add or remove space after the scope '+' or '-', as in '-(void) foo;' or '+(int) bar;'. +sp_after_oc_scope = remove # ignore/add/remove/force + +# Add or remove space after the colon in message specs +# '-(int) f:(int) x;' vs '-(int) f: (int) x;'. +sp_after_oc_colon = force # ignore/add/remove/force + +# Add or remove space before the colon in message specs +# '-(int) f: (int) x;' vs '-(int) f : (int) x;'. +sp_before_oc_colon = remove # ignore/add/remove/force + +# Add or remove space after the colon in immutable dictionary expression +# 'NSDictionary *test = @{@"foo" :@"bar"};'. +sp_after_oc_dict_colon = ignore # ignore/add/remove/force + +# Add or remove space before the colon in immutable dictionary expression +# 'NSDictionary *test = @{@"foo" :@"bar"};'. +sp_before_oc_dict_colon = ignore # ignore/add/remove/force + +# Add or remove space after the colon in message specs +# '[object setValue:1];' vs '[object setValue: 1];'. +sp_after_send_oc_colon = ignore # ignore/add/remove/force + +# Add or remove space before the colon in message specs +# '[object setValue:1];' vs '[object setValue :1];'. +sp_before_send_oc_colon = ignore # ignore/add/remove/force + +# Add or remove space after the (type) in message specs +# '-(int)f: (int) x;' vs '-(int)f: (int)x;'. +sp_after_oc_type = ignore # ignore/add/remove/force + +# Add or remove space after the first (type) in message specs +# '-(int) f:(int)x;' vs '-(int)f:(int)x;'. +sp_after_oc_return_type = ignore # ignore/add/remove/force + +# Add or remove space between '@selector' and '(' +# '@selector(msgName)' vs '@selector (msgName)' +# Also applies to @protocol() constructs. +sp_after_oc_at_sel = ignore # ignore/add/remove/force + +# Add or remove space between '@selector(x)' and the following word +# '@selector(foo) a:' vs '@selector(foo)a:'. +sp_after_oc_at_sel_parens = ignore # ignore/add/remove/force + +# Add or remove space inside '@selector' parens +# '@selector(foo)' vs '@selector( foo )' +# Also applies to @protocol() constructs. +sp_inside_oc_at_sel_parens = ignore # ignore/add/remove/force + +# Add or remove space before a block pointer caret +# '^int (int arg){...}' vs. ' ^int (int arg){...}'. +sp_before_oc_block_caret = ignore # ignore/add/remove/force + +# Add or remove space after a block pointer caret +# '^int (int arg){...}' vs. '^ int (int arg){...}'. +sp_after_oc_block_caret = ignore # ignore/add/remove/force + +# Add or remove space between the receiver and selector in a message. +# '[receiver selector ...]'. +sp_after_oc_msg_receiver = ignore # ignore/add/remove/force + +# Add or remove space after @property. +sp_after_oc_property = ignore # ignore/add/remove/force + +# Add or remove space between '@synchronized' and the parenthesis +# '@synchronized(foo)' vs '@synchronized (foo)'. +sp_after_oc_synchronized = ignore # ignore/add/remove/force + +# Add or remove space around the ':' in 'b ? t : f'. +sp_cond_colon = force # ignore/add/remove/force + +# Add or remove space before the ':' in 'b ? t : f'. Overrides sp_cond_colon. +sp_cond_colon_before = ignore # ignore/add/remove/force + +# Add or remove space after the ':' in 'b ? t : f'. Overrides sp_cond_colon. +sp_cond_colon_after = ignore # ignore/add/remove/force + +# Add or remove space around the '?' in 'b ? t : f'. +sp_cond_question = force # ignore/add/remove/force + +# Add or remove space before the '?' in 'b ? t : f'. Overrides sp_cond_question. +sp_cond_question_before = ignore # ignore/add/remove/force + +# Add or remove space after the '?' in 'b ? t : f'. Overrides sp_cond_question. +sp_cond_question_after = ignore # ignore/add/remove/force + +# In the abbreviated ternary form (a ?: b), add/remove space between ? and :.'. Overrides all other sp_cond_* options. +sp_cond_ternary_short = ignore # ignore/add/remove/force + +# Fix the spacing between 'case' and the label. Only 'ignore' and 'force' make sense here. +sp_case_label = force # ignore/add/remove/force + +# Control the space around the D '..' operator. +sp_range = ignore # ignore/add/remove/force + +# Control the spacing after ':' in 'for (TYPE VAR : EXPR)'. Only JAVA. +sp_after_for_colon = ignore # ignore/add/remove/force + +# Control the spacing before ':' in 'for (TYPE VAR : EXPR)'. Only JAVA. +sp_before_for_colon = ignore # ignore/add/remove/force + +# Control the spacing in 'extern (C)' (D). +sp_extern_paren = ignore # ignore/add/remove/force + +# Control the space after the opening of a C++ comment '// A' vs '//A'. +sp_cmt_cpp_start = add # ignore/add/remove/force + +# True: If space is added with sp_cmt_cpp_start, do it after doxygen sequences like '///', '///<', '//!' and '//!<'. +sp_cmt_cpp_doxygen = true # false/true + +# True: If space is added with sp_cmt_cpp_start, do it after Qt translator or meta-data comments like '//:', '//=', and '//~'. +sp_cmt_cpp_qttr = false # false/true + +# Controls the spaces between #else or #endif and a trailing comment. +sp_endif_cmt = ignore # ignore/add/remove/force + +# Controls the spaces after 'new', 'delete' and 'delete[]'. +sp_after_new = force # ignore/add/remove/force + +# Controls the spaces between new and '(' in 'new()'. +sp_between_new_paren = remove # ignore/add/remove/force + +# Controls the spaces between ')' and 'type' in 'new(foo) BAR'. +sp_after_newop_paren = ignore # ignore/add/remove/force + +# Controls the spaces inside paren of the new operator: 'new(foo) BAR'. +sp_inside_newop_paren = ignore # ignore/add/remove/force + +# Controls the space after open paren of the new operator: 'new(foo) BAR'. +# Overrides sp_inside_newop_paren. +sp_inside_newop_paren_open = ignore # ignore/add/remove/force + +# Controls the space before close paren of the new operator: 'new(foo) BAR'. +# Overrides sp_inside_newop_paren. +sp_inside_newop_paren_close = ignore # ignore/add/remove/force + +# Controls the spaces before a trailing or embedded comment. +sp_before_tr_emb_cmt = add # ignore/add/remove/force + +# Number of spaces before a trailing or embedded comment. +sp_num_before_tr_emb_cmt = 0 # unsigned number + +# Control space between a Java annotation and the open paren. +sp_annotation_paren = ignore # ignore/add/remove/force + +# If True, vbrace tokens are dropped to the previous token and skipped. +sp_skip_vbrace_tokens = false # false/true + +# Controls the space after 'noexcept'. +sp_after_noexcept = force # ignore/add/remove/force + +# If True, a is inserted after #define. +force_tab_after_define = false # false/true + +# +# Indenting +# + +# The number of columns to indent per level. +# Usually 2, 3, 4, or 8. Default=8. +indent_columns = 2 # unsigned number + +# The continuation indent. If non-zero, this overrides the indent of '(' and '=' continuation indents. +# For FreeBSD, this is set to 4. Negative value is absolute and not increased for each '(' level. +indent_continue = 4 # number + +# Indent empty lines - lines which contain only spaces before newline character +indent_single_newlines = false # false/true + +# The continuation indent for func_*_param if they are true. +# If non-zero, this overrides the indent. +indent_param = 0 # unsigned number + +# How to use tabs when indenting code +# 0=spaces only +# 1=indent with tabs to brace level, align with spaces (default) +# 2=indent and align with tabs, using spaces when not on a tabstop +indent_with_tabs = 0 # unsigned number + +# Comments that are not a brace level are indented with tabs on a tabstop. +# Requires indent_with_tabs=2. If false, will use spaces. +indent_cmt_with_tabs = false # false/true + +# Whether to indent strings broken by '\' so that they line up. +indent_align_string = true # false/true + +# The number of spaces to indent multi-line XML strings. +# Requires indent_align_string=True. +indent_xml_string = 0 # unsigned number + +# Spaces to indent '{' from level. +indent_brace = 0 # unsigned number + +# Whether braces are indented to the body level. +indent_braces = false # false/true + +# Disabled indenting function braces if indent_braces is True. +indent_braces_no_func = false # false/true + +# Disabled indenting class braces if indent_braces is True. +indent_braces_no_class = false # false/true + +# Disabled indenting struct braces if indent_braces is True. +indent_braces_no_struct = false # false/true + +# Indent based on the size of the brace parent, i.e. 'if' => 3 spaces, 'for' => 4 spaces, etc. +indent_brace_parent = false # false/true + +# Indent based on the paren open instead of the brace open in '({\n', default is to indent by brace. +indent_paren_open_brace = false # false/true + +# indent a C# delegate by another level, default is to not indent by another level. +indent_cs_delegate_brace = false # false/true + +# indent a C# delegate(To hanndle delegates with no brace) by another level. default: false +indent_cs_delegate_body = false # false/true + +# Whether the 'namespace' body is indented. +indent_namespace = true # false/true + +# Only indent one namespace and no sub-namespaces. +# Requires indent_namespace=True. +indent_namespace_single_indent = true # false/true + +# The number of spaces to indent a namespace block. +indent_namespace_level = 2 # unsigned number + +# If the body of the namespace is longer than this number, it won't be indented. +# Requires indent_namespace=True. Default=0 (no limit) +indent_namespace_limit = 0 # unsigned number + +# Whether the 'extern "C"' body is indented. +indent_extern = true # false/true + +# Whether the 'class' body is indented. +indent_class = true # false/true + +# Whether to indent the stuff after a leading base class colon. +indent_class_colon = true # false/true + +# Indent based on a class colon instead of the stuff after the colon. +# Requires indent_class_colon=True. Default=False. +indent_class_on_colon = false # false/true + +# Whether to indent the stuff after a leading class initializer colon. +indent_constr_colon = true # false/true + +# Virtual indent from the ':' for member initializers. Default=2. +indent_ctor_init_leading = 2 # unsigned number + +# Additional indent for constructor initializer list. +# Negative values decrease indent down to the first column. Default=0. +indent_ctor_init = 0 # number + +# False=treat 'else\nif' as 'else if' for indenting purposes +# True=indent the 'if' one level. +indent_else_if = false # false/true + +# Amount to indent variable declarations after a open brace. neg=relative, pos=absolute. +indent_var_def_blk = 0 # number + +# Indent continued variable declarations instead of aligning. +indent_var_def_cont = false # false/true + +# Indent continued shift expressions ('<<' and '>>') instead of aligning. +# Turn align_left_shift off when enabling this. +indent_shift = false # false/true + +# True: force indentation of function definition to start in column 1 +# False: use the default behavior. +indent_func_def_force_col1 = false # false/true + +# True: indent continued function call parameters one indent level +# False: align parameters under the open paren. +indent_func_call_param = true # false/true + +# Same as indent_func_call_param, but for function defs. +indent_func_def_param = true # false/true + +# Same as indent_func_call_param, but for function protos. +indent_func_proto_param = true # false/true + +# Same as indent_func_call_param, but for class declarations. +indent_func_class_param = true # false/true + +# Same as indent_func_call_param, but for class variable constructors. +indent_func_ctor_var_param = true # false/true + +# Same as indent_func_call_param, but for templates. +indent_template_param = true # false/true + +# Double the indent for indent_func_xxx_param options. +# Use both values of the options indent_columns and indent_param. +indent_func_param_double = true # false/true + +# Indentation column for standalone 'const' function decl/proto qualifier. +indent_func_const = 0 # unsigned number + +# Indentation column for standalone 'throw' function decl/proto qualifier. +indent_func_throw = 0 # unsigned number + +# The number of spaces to indent a continued '->' or '.' +# Usually set to 0, 1, or indent_columns. +indent_member = 4 # unsigned number + +# setting to true will indent lines broken at '.' or '->' by a single indent +# UO_indent_member option will not be effective if this is set to true. +indent_member_single = false # false/true + +# Spaces to indent single line ('//') comments on lines before code. +indent_sing_line_comments = 0 # unsigned number + +# If set, will indent trailing single line ('//') comments relative +# to the code instead of trying to keep the same absolute column. +indent_relative_single_line_comments = false # false/true + +# Spaces to indent 'case' from 'switch' +# Usually 0 or indent_columns. +indent_switch_case = 2 # unsigned number + +# Whether to indent preprocessor statements inside of switch statements. +indent_switch_pp = true # false/true + +# Spaces to shift the 'case' line, without affecting any other lines +# Usually 0. +indent_case_shift = 0 # unsigned number + +# Spaces to indent '{' from 'case'. +# By default, the brace will appear under the 'c' in case. +# Usually set to 0 or indent_columns. +# negative value are OK. +indent_case_brace = 0 # number + +# Whether to indent comments found in first column. +indent_col1_comment = false # false/true + +# How to indent goto labels +# >0: absolute column where 1 is the leftmost column +# <=0: subtract from brace indent +# Default=1 +indent_label = 1 # number + +# Same as indent_label, but for access specifiers that are followed by a colon. Default=1 +indent_access_spec = 3 # number + +# Indent the code after an access specifier by one level. +# If set, this option forces 'indent_access_spec=0'. +indent_access_spec_body = false # false/true + +# If an open paren is followed by a newline, indent the next line so that it lines up after the open paren (not recommended). +indent_paren_nl = false # false/true + +# Controls the indent of a close paren after a newline. +# 0: Indent to body level +# 1: Align under the open paren +# 2: Indent to the brace level +indent_paren_close = 0 # unsigned number + +# Controls the indent of the open paren of a function definition, if on it's own line.If True, indents the open paren +indent_paren_after_func_def = false # false/true + +# Controls the indent of the open paren of a function declaration, if on it's own line.If True, indents the open paren +indent_paren_after_func_decl = false # false/true + +# Controls the indent of the open paren of a function call, if on it's own line.If True, indents the open paren +indent_paren_after_func_call = false # false/true + +# Controls the indent of a comma when inside a paren.If True, aligns under the open paren. +indent_comma_paren = false # false/true + +# Controls the indent of a BOOL operator when inside a paren.If True, aligns under the open paren. +indent_bool_paren = false # false/true + +# Controls the indent of a semicolon when inside a for paren.If True, aligns under the open for paren. +indent_semicolon_for_paren = false # false/true + +# If 'indent_bool_paren' is True, controls the indent of the first expression. If True, aligns the first expression to the following ones. +indent_first_bool_expr = false # false/true + +# If 'indent_semicolon_for_paren' is True, controls the indent of the first expression. If True, aligns the first expression to the following ones. +indent_first_for_expr = false # false/true + +# If an open square is followed by a newline, indent the next line so that it lines up after the open square (not recommended). +indent_square_nl = false # false/true + +# Don't change the relative indent of ESQL/C 'EXEC SQL' bodies. +indent_preserve_sql = false # false/true + +# Align continued statements at the '='. Default=True +# If False or the '=' is followed by a newline, the next line is indent one tab. +indent_align_assign = false # false/true + +# Align continued statements at the '('. Default=True +# If FALSE or the '(' is not followed by a newline, the next line indent is one tab. +indent_align_paren = true # false/true + +# Indent OC blocks at brace level instead of usual rules. +indent_oc_block = false # false/true + +# Indent OC blocks in a message relative to the parameter name. +# 0=use indent_oc_block rules, 1+=spaces to indent +indent_oc_block_msg = 0 # unsigned number + +# Minimum indent for subsequent parameters +indent_oc_msg_colon = 0 # unsigned number + +# If True, prioritize aligning with initial colon (and stripping spaces from lines, if necessary). +# Default=True. +indent_oc_msg_prioritize_first_colon = true # false/true + +# If indent_oc_block_msg and this option are on, blocks will be indented the way that Xcode does by default (from keyword if the parameter is on its own line; otherwise, from the previous indentation level). +indent_oc_block_msg_xcode_style = false # false/true + +# If indent_oc_block_msg and this option are on, blocks will be indented from where the brace is relative to a msg keyword. +indent_oc_block_msg_from_keyword = false # false/true + +# If indent_oc_block_msg and this option are on, blocks will be indented from where the brace is relative to a msg colon. +indent_oc_block_msg_from_colon = false # false/true + +# If indent_oc_block_msg and this option are on, blocks will be indented from where the block caret is. +indent_oc_block_msg_from_caret = false # false/true + +# If indent_oc_block_msg and this option are on, blocks will be indented from where the brace is. +indent_oc_block_msg_from_brace = false # false/true + +# When indenting after virtual brace open and newline add further spaces to reach this min. indent. +indent_min_vbrace_open = 0 # unsigned number + +# True: When identing after virtual brace open and newline add further spaces after regular indent to reach next tabstop. +indent_vbrace_open_on_tabstop = false # false/true + +# If True, a brace followed by another token (not a newline) will indent all contained lines to match the token.Default=True. +indent_token_after_brace = true # false/true + +# If True, cpp lambda body will be indentedDefault=False. +indent_cpp_lambda_body = false # false/true + +# indent (or not) an using block if no braces are used. Only for C#.Default=True. +indent_using_block = true # false/true + +# indent the continuation of ternary operator. +# 0: (Default) off +# 1: When the `if_false` is a continuation, indent it under `if_false` +# 2: When the `:` is a continuation, indent it under `?` +indent_ternary_operator = 0 # unsigned number + +# If true, the indentation of the chunks after a `return new` sequence will be set at return indentation column. +indent_off_after_return_new = false # false/true + +# If true, the tokens after return are indented with regular single indentation.By default (false) the indentation is after the return token. +indent_single_after_return = false # false/true + +# If true, ignore indent and align for asm blocks as they have their own indentation. +indent_ignore_asm_block = false # false/true + +# +# Newline adding and removing options +# + +# Whether to collapse empty blocks between '{' and '}'. +nl_collapse_empty_body = true # false/true + +# Don't split one-line braced assignments - 'foo_t f = { 1, 2 };'. +nl_assign_leave_one_liners = true # false/true + +# Don't split one-line braced statements inside a class xx { } body. +nl_class_leave_one_liners = false # false/true + +# Don't split one-line enums: 'enum foo { BAR = 15 };' +nl_enum_leave_one_liners = false # false/true + +# Don't split one-line get or set functions. +nl_getset_leave_one_liners = false # false/true + +# Don't split one-line get or set functions. +nl_cs_property_leave_one_liners = false # false/true + +# Don't split one-line function definitions - 'int foo() { return 0; }'. +nl_func_leave_one_liners = false # false/true + +# Don't split one-line C++11 lambdas - '[]() { return 0; }'. +nl_cpp_lambda_leave_one_liners = true # false/true + +# Don't split one-line if/else statements - 'if(a) b++;'. +nl_if_leave_one_liners = false # false/true + +# Don't split one-line while statements - 'while(a) b++;'. +nl_while_leave_one_liners = false # false/true + +# Don't split one-line OC messages. +nl_oc_msg_leave_one_liner = false # false/true + +# Add or remove newline between Objective-C block signature and '{'. +nl_oc_block_brace = ignore # ignore/add/remove/force + +# Add or remove newline between @interface and '{'. +nl_oc_interface_brace = ignore # ignore/add/remove/force + +# Add or remove newline between @implementation and '{'. +nl_oc_implementation_brace = ignore # ignore/add/remove/force + +# Add or remove newlines at the start of the file. +nl_start_of_file = remove # ignore/add/remove/force + +# The number of newlines at the start of the file (only used if nl_start_of_file is 'add' or 'force'. +nl_start_of_file_min = 0 # unsigned number + +# Add or remove newline at the end of the file. +nl_end_of_file = force # ignore/add/remove/force + +# The number of newlines at the end of the file (only used if nl_end_of_file is 'add' or 'force'). +nl_end_of_file_min = 1 # unsigned number + +# Add or remove newline between '=' and '{'. +nl_assign_brace = ignore # ignore/add/remove/force + +# Add or remove newline between '=' and '[' (D only). +nl_assign_square = ignore # ignore/add/remove/force + +# Add or remove newline between '[]' and '{'. +nl_tsquare_brace = ignore # ignore/add/remove/force + +# Add or remove newline after '= [' (D only). Will also affect the newline before the ']'. +nl_after_square_assign = ignore # ignore/add/remove/force + +# The number of blank lines after a block of variable definitions at the top of a function body +# 0 = No change (default). +nl_func_var_def_blk = 0 # unsigned number + +# The number of newlines before a block of typedefs +# 0 = No change (default) +# is overridden by the option 'nl_after_access_spec'. +nl_typedef_blk_start = 0 # unsigned number + +# The number of newlines after a block of typedefs +# 0 = No change (default). +nl_typedef_blk_end = 0 # unsigned number + +# The maximum consecutive newlines within a block of typedefs +# 0 = No change (default). +nl_typedef_blk_in = 0 # unsigned number + +# The number of newlines before a block of variable definitions not at the top of a function body +# 0 = No change (default) +# is overridden by the option 'nl_after_access_spec'. +nl_var_def_blk_start = 0 # unsigned number + +# The number of newlines after a block of variable definitions not at the top of a function body +# 0 = No change (default). +nl_var_def_blk_end = 0 # unsigned number + +# The maximum consecutive newlines within a block of variable definitions +# 0 = No change (default). +nl_var_def_blk_in = 0 # unsigned number + +# Add or remove newline between a function call's ')' and '{', as in: +# list_for_each(item, &list) { }. +nl_fcall_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'enum' and '{'. +nl_enum_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'enum' and 'class'. +nl_enum_class = remove # ignore/add/remove/force + +# Add or remove newline between 'enum class' and the identifier. +nl_enum_class_identifier = remove # ignore/add/remove/force + +# Add or remove newline between 'enum class' type and ':'. +nl_enum_identifier_colon = remove # ignore/add/remove/force + +# Add or remove newline between 'enum class identifier :' and 'type' and/or 'type'. +nl_enum_colon_type = remove # ignore/add/remove/force + +# Add or remove newline between 'struct and '{'. +nl_struct_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'union' and '{'. +nl_union_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'if' and '{'. +nl_if_brace = remove # ignore/add/remove/force + +# Add or remove newline between '}' and 'else'. +nl_brace_else = remove # ignore/add/remove/force + +# Add or remove newline between 'else if' and '{' +# If set to ignore, nl_if_brace is used instead. +nl_elseif_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'else' and '{'. +nl_else_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'else' and 'if'. +nl_else_if = remove # ignore/add/remove/force + +# Add or remove newline before 'if'/'else if' closing parenthesis. +nl_before_if_closing_paren = remove # ignore/add/remove/force + +# Add or remove newline between '}' and 'finally'. +nl_brace_finally = remove # ignore/add/remove/force + +# Add or remove newline between 'finally' and '{'. +nl_finally_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'try' and '{'. +nl_try_brace = remove # ignore/add/remove/force + +# Add or remove newline between get/set and '{'. +nl_getset_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'for' and '{'. +nl_for_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'catch' and '{'. +nl_catch_brace = remove # ignore/add/remove/force + +# Add or remove newline between '@catch' and '{'. +# If set to ignore, nl_catch_brace is used. +nl_oc_catch_brace = remove # ignore/add/remove/force + +# Add or remove newline between '}' and 'catch'. +nl_brace_catch = remove # ignore/add/remove/force + +# Add or remove newline between '}' and 'catch'. +# If set to ignore, nl_brace_catch is used. +nl_oc_brace_catch = remove # ignore/add/remove/force + +# Add or remove newline between '}' and ']'. +nl_brace_square = remove # ignore/add/remove/force + +# Add or remove newline between '}' and ')' in a function invocation. +nl_brace_fparen = remove # ignore/add/remove/force + +# Add or remove newline between 'while' and '{'. +nl_while_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'scope (x)' and '{' (D). +nl_scope_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'unittest' and '{' (D). +nl_unittest_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'version (x)' and '{' (D). +nl_version_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'using' and '{'. +nl_using_brace = remove # ignore/add/remove/force + +# Add or remove newline between two open or close braces. +# Due to general newline/brace handling, REMOVE may not work. +nl_brace_brace = ignore # ignore/add/remove/force + +# Add or remove newline between 'do' and '{'. +nl_do_brace = remove # ignore/add/remove/force + +# Add or remove newline between '}' and 'while' of 'do' statement. +nl_brace_while = remove # ignore/add/remove/force + +# Add or remove newline between 'switch' and '{'. +nl_switch_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'synchronized' and '{'. +nl_synchronized_brace = remove # ignore/add/remove/force + +# Add a newline between ')' and '{' if the ')' is on a different line than the if/for/etc. +# Overrides nl_for_brace, nl_if_brace, nl_switch_brace, nl_while_switch and nl_catch_brace. +nl_multi_line_cond = false # false/true + +# Force a newline in a define after the macro name for multi-line defines. +nl_multi_line_define = false # false/true + +# Whether to put a newline before 'case' statement, not after the first 'case'. +nl_before_case = false # false/true + +# Add or remove newline between ')' and 'throw'. +nl_before_throw = ignore # ignore/add/remove/force + +# Whether to put a newline after 'case' statement. +nl_after_case = false # false/true + +# Add or remove a newline between a case ':' and '{'. Overrides nl_after_case. +nl_case_colon_brace = remove # ignore/add/remove/force + +# Newline between namespace and {. +nl_namespace_brace = remove # ignore/add/remove/force + +# Add or remove newline between 'template<>' and whatever follows. +nl_template_class = ignore # ignore/add/remove/force + +# Add or remove newline between 'class' and '{'. +nl_class_brace = remove # ignore/add/remove/force + +# Add or remove newline before/after each ',' in the base class list, +# (tied to pos_class_comma). +nl_class_init_args = add # ignore/add/remove/force + +# Add or remove newline after each ',' in the constructor member initialization. +# Related to nl_constr_colon, pos_constr_colon and pos_constr_comma. +nl_constr_init_args = add # ignore/add/remove/force + +# Add or remove newline before first element, after comma, and after last element in enum. +nl_enum_own_lines = add # ignore/add/remove/force + +# Add or remove newline between return type and function name in a function definition. +nl_func_type_name = ignore # ignore/add/remove/force + +# Add or remove newline between return type and function name inside a class {} +# Uses nl_func_type_name or nl_func_proto_type_name if set to ignore. +nl_func_type_name_class = ignore # ignore/add/remove/force + +# Add or remove newline between class specification and '::' in 'void A::f() { }' +# Only appears in separate member implementation (does not appear with in-line implmementation). +nl_func_class_scope = ignore # ignore/add/remove/force + +# Add or remove newline between function scope and name +# Controls the newline after '::' in 'void A::f() { }'. +nl_func_scope_name = ignore # ignore/add/remove/force + +# Add or remove newline between return type and function name in a prototype. +nl_func_proto_type_name = remove # ignore/add/remove/force + +# Add or remove newline between a function name and the opening '(' in the declaration. +nl_func_paren = remove # ignore/add/remove/force + +# Overrides nl_func_paren for functions with no parameters. +nl_func_paren_empty = remove # ignore/add/remove/force + +# Add or remove newline between a function name and the opening '(' in the definition. +nl_func_def_paren = remove # ignore/add/remove/force + +# Overrides nl_func_def_paren for functions with no parameters. +nl_func_def_paren_empty = remove # ignore/add/remove/force + +# Add or remove newline between a function name and the opening '(' in the call +nl_func_call_paren = remove # ignore/add/remove/force + +# Overrides nl_func_call_paren for functions with no parameters. +nl_func_call_paren_empty = remove # ignore/add/remove/force + +# Add or remove newline after '(' in a function declaration. +nl_func_decl_start = ignore # ignore/add/remove/force + +# Add or remove newline after '(' in a function definition. +nl_func_def_start = ignore # ignore/add/remove/force + +# Overrides nl_func_decl_start when there is only one parameter. +nl_func_decl_start_single = ignore # ignore/add/remove/force + +# Overrides nl_func_def_start when there is only one parameter. +nl_func_def_start_single = ignore # ignore/add/remove/force + +# Whether to add newline after '(' in a function declaration if '(' and ')' are in different lines. +nl_func_decl_start_multi_line = true # false/true + +# Whether to add newline after '(' in a function definition if '(' and ')' are in different lines. +nl_func_def_start_multi_line = true # false/true + +# Add or remove newline after each ',' in a function declaration. +nl_func_decl_args = ignore # ignore/add/remove/force + +# Add or remove newline after each ',' in a function definition. +nl_func_def_args = ignore # ignore/add/remove/force + +# Whether to add newline after each ',' in a function declaration if '(' and ')' are in different lines. +nl_func_decl_args_multi_line = true # false/true + +# Whether to add newline after each ',' in a function definition if '(' and ')' are in different lines. +nl_func_def_args_multi_line = true # false/true + +# Add or remove newline before the ')' in a function declaration. +nl_func_decl_end = remove # ignore/add/remove/force + +# Add or remove newline before the ')' in a function definition. +nl_func_def_end = remove # ignore/add/remove/force + +# Overrides nl_func_decl_end when there is only one parameter. +nl_func_decl_end_single = ignore # ignore/add/remove/force + +# Overrides nl_func_def_end when there is only one parameter. +nl_func_def_end_single = ignore # ignore/add/remove/force + +# Whether to add newline before ')' in a function declaration if '(' and ')' are in different lines. +nl_func_decl_end_multi_line = false # false/true + +# Whether to add newline before ')' in a function definition if '(' and ')' are in different lines. +nl_func_def_end_multi_line = false # false/true + +# Add or remove newline between '()' in a function declaration. +nl_func_decl_empty = remove # ignore/add/remove/force + +# Add or remove newline between '()' in a function definition. +nl_func_def_empty = remove # ignore/add/remove/force + +# Add or remove newline between '()' in a function call. +nl_func_call_empty = remove # ignore/add/remove/force + +# Whether to add newline after '(' in a function call if '(' and ')' are in different lines. +nl_func_call_start_multi_line = false # false/true + +# Whether to add newline after each ',' in a function call if '(' and ')' are in different lines. +nl_func_call_args_multi_line = false # false/true + +# Whether to add newline before ')' in a function call if '(' and ')' are in different lines. +nl_func_call_end_multi_line = false # false/true + +# Whether to put each OC message parameter on a separate line +# See nl_oc_msg_leave_one_liner. +nl_oc_msg_args = false # false/true + +# Add or remove newline between function signature and '{'. +nl_fdef_brace = remove # ignore/add/remove/force + +# Add or remove newline between C++11 lambda signature and '{'. +nl_cpp_ldef_brace = remove # ignore/add/remove/force + +# Add or remove a newline between the return keyword and return expression. +nl_return_expr = ignore # ignore/add/remove/force + +# Whether to put a newline after semicolons, except in 'for' statements. +nl_after_semicolon = true # false/true + +# Java: Control the newline between the ')' and '{{' of the double brace initializer. +nl_paren_dbrace_open = ignore # ignore/add/remove/force + +# Whether to put a newline after the type in an unnamed temporary direct-list-initialization. +nl_type_brace_init_lst = ignore # ignore/add/remove/force + +# Whether to put a newline after open brace in an unnamed temporary direct-list-initialization. +nl_type_brace_init_lst_open = ignore # ignore/add/remove/force + +# Whether to put a newline before close brace in an unnamed temporary direct-list-initialization. +nl_type_brace_init_lst_close = ignore # ignore/add/remove/force + +# Whether to put a newline after brace open. +# This also adds a newline before the matching brace close. +nl_after_brace_open = false # false/true + +# If nl_after_brace_open and nl_after_brace_open_cmt are True, a newline is +# placed between the open brace and a trailing single-line comment. +nl_after_brace_open_cmt = false # false/true + +# Whether to put a newline after a virtual brace open with a non-empty body. +# These occur in un-braced if/while/do/for statement bodies. +nl_after_vbrace_open = false # false/true + +# Whether to put a newline after a virtual brace open with an empty body. +# These occur in un-braced if/while/do/for statement bodies. +nl_after_vbrace_open_empty = false # false/true + +# Whether to put a newline after a brace close. +# Does not apply if followed by a necessary ';'. +nl_after_brace_close = false # false/true + +# Whether to put a newline after a virtual brace close. +# Would add a newline before return in: 'if (foo) a++; return;'. +nl_after_vbrace_close = false # false/true + +# Control the newline between the close brace and 'b' in: 'struct { int a; } b;' +# Affects enums, unions and structures. If set to ignore, uses nl_after_brace_close. +nl_brace_struct_var = ignore # ignore/add/remove/force + +# Whether to alter newlines in '#define' macros. +nl_define_macro = false # false/true + +# Whether to alter newlines between consecutive paren closes, +# The number of closing paren in a line will depend on respective open paren lines +nl_squeeze_paren_close = false # false/true + +# Whether to remove blanks after '#ifxx' and '#elxx', or before '#elxx' and '#endif'. Does not affect top-level #ifdefs. +nl_squeeze_ifdef = false # false/true + +# Makes the nl_squeeze_ifdef option affect the top-level #ifdefs as well. +nl_squeeze_ifdef_top_level = false # false/true + +# Add or remove blank line before 'if'. +nl_before_if = ignore # ignore/add/remove/force + +# Add or remove blank line after 'if' statement. +# Add/Force work only if the next token is not a closing brace. +nl_after_if = ignore # ignore/add/remove/force + +# Add or remove blank line before 'for'. +nl_before_for = ignore # ignore/add/remove/force + +# Add or remove blank line after 'for' statement. +nl_after_for = ignore # ignore/add/remove/force + +# Add or remove blank line before 'while'. +nl_before_while = ignore # ignore/add/remove/force + +# Add or remove blank line after 'while' statement. +nl_after_while = ignore # ignore/add/remove/force + +# Add or remove blank line before 'switch'. +nl_before_switch = ignore # ignore/add/remove/force + +# Add or remove blank line after 'switch' statement. +nl_after_switch = ignore # ignore/add/remove/force + +# Add or remove blank line before 'synchronized'. +nl_before_synchronized = ignore # ignore/add/remove/force + +# Add or remove blank line after 'synchronized' statement. +nl_after_synchronized = ignore # ignore/add/remove/force + +# Add or remove blank line before 'do'. +nl_before_do = ignore # ignore/add/remove/force + +# Add or remove blank line after 'do/while' statement. +nl_after_do = ignore # ignore/add/remove/force + +# Whether to double-space commented-entries in struct/union/enum. +nl_ds_struct_enum_cmt = false # false/true + +# force nl before } of a struct/union/enum +# (lower priority than 'eat_blanks_before_close_brace'). +nl_ds_struct_enum_close_brace = false # false/true + +# Add or remove blank line before 'func_class_def'. +nl_before_func_class_def = 0 # unsigned number + +# Add or remove blank line before 'func_class_proto'. +nl_before_func_class_proto = 0 # unsigned number + +# Add or remove a newline before/after a class colon, +# (tied to pos_class_colon). +nl_class_colon = ignore # ignore/add/remove/force + +# Add or remove a newline around a class constructor colon. +# Related to nl_constr_init_args, pos_constr_colon and pos_constr_comma. +nl_constr_colon = ignore # ignore/add/remove/force + +# If true turns two liner namespace to one liner,else will make then four liners +nl_namespace_two_to_one_liner = false # false/true + +# Change simple unbraced if statements into a one-liner +# 'if(b)\n i++;' => 'if(b) i++;'. +nl_create_if_one_liner = false # false/true + +# Change simple unbraced for statements into a one-liner +# 'for (i=0;i<5;i++)\n foo(i);' => 'for (i=0;i<5;i++) foo(i);'. +nl_create_for_one_liner = false # false/true + +# Change simple unbraced while statements into a one-liner +# 'while (i<5)\n foo(i++);' => 'while (i<5) foo(i++);'. +nl_create_while_one_liner = false # false/true + +# Change simple 4,3,2 liner function def statements into a one-liner +nl_create_func_def_one_liner = false # false/true + +# Change a one-liner if statement into simple unbraced if +# 'if(b) i++;' => 'if(b)\n i++;'. +nl_split_if_one_liner = false # false/true + +# Change a one-liner for statement into simple unbraced for +# 'for (i=0;<5;i++) foo(i);' => 'for (i=0;<5;i++)\n foo(i);'. +nl_split_for_one_liner = false # false/true + +# Change a one-liner while statement into simple unbraced while +# 'while (i<5) foo(i++);' => 'while (i<5)\n foo(i++);'. +nl_split_while_one_liner = false # false/true + +# +# Blank line options +# + +# The maximum consecutive newlines (3 = 2 blank lines). +nl_max = 2 # unsigned number + +# The maximum consecutive newlines in function. +nl_max_blank_in_func = 0 # unsigned number + +# The number of newlines after a function prototype, if followed by another function prototype. +nl_after_func_proto = 2 # unsigned number + +# The number of newlines after a function prototype, if not followed by another function prototype. +nl_after_func_proto_group = 0 # unsigned number + +# The number of newlines after a function class prototype, if followed by another function class prototype. +nl_after_func_class_proto = 0 # unsigned number + +# The number of newlines after a function class prototype, if not followed by another function class prototype. +nl_after_func_class_proto_group = 0 # unsigned number + +# The number of newlines before a multi-line function def body. +nl_before_func_body_def = 0 # unsigned number + +# The number of newlines before a multi-line function prototype body. +nl_before_func_body_proto = 0 # unsigned number + +# The number of newlines after '}' of a multi-line function body. +nl_after_func_body = 0 # unsigned number + +# The number of newlines after '}' of a multi-line function body in a class declaration. +nl_after_func_body_class = 0 # unsigned number + +# The number of newlines after '}' of a single line function body. +nl_after_func_body_one_liner = 0 # unsigned number + +# The minimum number of newlines before a multi-line comment. +# Doesn't apply if after a brace open or another multi-line comment. +nl_before_block_comment = 0 # unsigned number + +# The minimum number of newlines before a single-line C comment. +# Doesn't apply if after a brace open or other single-line C comments. +nl_before_c_comment = 0 # unsigned number + +# The minimum number of newlines before a CPP comment. +# Doesn't apply if after a brace open or other CPP comments. +nl_before_cpp_comment = 0 # unsigned number + +# Whether to force a newline after a multi-line comment. +nl_after_multiline_comment = false # false/true + +# Whether to force a newline after a label's colon. +nl_after_label_colon = false # false/true + +# The number of newlines after '}' or ';' of a struct/enum/union definition. +nl_after_struct = 2 # unsigned number + +# The number of newlines before a class definition. +nl_before_class = 0 # unsigned number + +# The number of newlines after '}' or ';' of a class definition. +nl_after_class = 2 # unsigned number + +# The number of newlines before a 'private:', 'public:', 'protected:', 'signals:', or 'slots:' label. +# Will not change the newline count if after a brace open. +# 0 = No change. +nl_before_access_spec = 2 # unsigned number + +# The number of newlines after a 'private:', 'public:', 'protected:', 'signals:' or 'slots:' label. +# 0 = No change. +# Overrides 'nl_typedef_blk_start' and 'nl_var_def_blk_start'. +nl_after_access_spec = 2 # unsigned number + +# The number of newlines between a function def and the function comment. +# 0 = No change. +nl_comment_func_def = 0 # unsigned number + +# The number of newlines after a try-catch-finally block that isn't followed by a brace close. +# 0 = No change. +nl_after_try_catch_finally = 0 # unsigned number + +# The number of newlines before and after a property, indexer or event decl. +# 0 = No change. +nl_around_cs_property = 0 # unsigned number + +# The number of newlines between the get/set/add/remove handlers in C#. +# 0 = No change. +nl_between_get_set = 0 # unsigned number + +# Add or remove newline between C# property and the '{'. +nl_property_brace = ignore # ignore/add/remove/force + +# Whether to remove blank lines after '{'. +eat_blanks_after_open_brace = false # false/true + +# Whether to remove blank lines before '}'. +eat_blanks_before_close_brace = false # false/true + +# How aggressively to remove extra newlines not in preproc. +# 0: No change +# 1: Remove most newlines not handled by other config +# 2: Remove all newlines and reformat completely by config +nl_remove_extra_newlines = 0 # unsigned number + +# Whether to put a blank line before 'return' statements, unless after an open brace. +nl_before_return = false # false/true + +# Whether to put a blank line after 'return' statements, unless followed by a close brace. +nl_after_return = false # false/true + +# Whether to put a newline after a Java annotation statement. +# Only affects annotations that are after a newline. +nl_after_annotation = ignore # ignore/add/remove/force + +# Controls the newline between two annotations. +nl_between_annotation = ignore # ignore/add/remove/force + +# +# Positioning options +# + +# The position of arithmetic operators in wrapped expressions. +pos_arith = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of assignment in wrapped expressions. +# Do not affect '=' followed by '{'. +pos_assign = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of boolean operators in wrapped expressions. +pos_bool = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of comparison operators in wrapped expressions. +pos_compare = ignore # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of conditional (b ? t : f) operators in wrapped expressions. +pos_conditional = ignore # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of the comma in wrapped expressions. +pos_comma = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of the comma in enum entries. +pos_enum_comma = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of the comma in the base class list if there are more than one line, +# (tied to nl_class_init_args). +pos_class_comma = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of the comma in the constructor initialization list. +# Related to nl_constr_colon, nl_constr_init_args and pos_constr_colon. +pos_constr_comma = trail # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of trailing/leading class colon, between class and base class list +# (tied to nl_class_colon). +pos_class_colon = lead # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# The position of colons between constructor and member initialization, +# (tied to nl_constr_colon). +# Related to nl_constr_colon, nl_constr_init_args and pos_constr_comma. +pos_constr_colon = lead # ignore/join/lead/lead_break/lead_force/trail/trail_break/trail_force + +# +# Line Splitting options +# + +# Try to limit code width to N number of columns +code_width = 110 # unsigned number + +# Whether to fully split long 'for' statements at semi-colons. +ls_for_split_full = true # false/true + +# Whether to fully split long function protos/calls at commas. +ls_func_split_full = true # false/true + +# Whether to split lines as close to code_width as possible and ignore some groupings. +ls_code_width = false # false/true + +# +# Code alignment (not left column spaces/tabs) +# + +# Whether to keep non-indenting tabs. +align_keep_tabs = false # false/true + +# Whether to use tabs for aligning. +align_with_tabs = false # false/true + +# Whether to bump out to the next tab when aligning. +align_on_tabstop = true # false/true + +# Whether to right-align numbers. +align_number_right = true # false/true + +# Whether to keep whitespace not required for alignment. +align_keep_extra_space = true # false/true + +# Align variable definitions in prototypes and functions. +align_func_params = false # false/true + +# The span for aligning parameter definitions in function on parameter name (0=don't align). +align_func_params_span = 0 # unsigned number + +# The threshold for aligning function parameter definitions (0=no limit). +align_func_params_thresh = 0 # unsigned number + +# The gap for aligning function parameter definitions. +align_func_params_gap = 0 # unsigned number + +# Align parameters in single-line functions that have the same name. +# The function names must already be aligned with each other. +align_same_func_call_params = false # false/true + +# The span for aligning variable definitions (0=don't align) +align_var_def_span = 0 # unsigned number + +# How to align the star in variable definitions. +# 0=Part of the type 'void * foo;' +# 1=Part of the variable 'void *foo;' +# 2=Dangling 'void *foo;' +align_var_def_star_style = 0 # unsigned number + +# How to align the '&' in variable definitions. +# 0=Part of the type +# 1=Part of the variable +# 2=Dangling +align_var_def_amp_style = 0 # unsigned number + +# The threshold for aligning variable definitions (0=no limit) +align_var_def_thresh = 0 # unsigned number + +# The gap for aligning variable definitions. +align_var_def_gap = 0 # unsigned number + +# Whether to align the colon in struct bit fields. +align_var_def_colon = false # false/true + +# align variable defs gap for bit colons. +align_var_def_colon_gap = 0 # unsigned number + +# Whether to align any attribute after the variable name. +align_var_def_attribute = false # false/true + +# Whether to align inline struct/enum/union variable definitions. +align_var_def_inline = false # false/true + +# The span for aligning on '=' in assignments (0=don't align) +align_assign_span = 0 # unsigned number + +# The threshold for aligning on '=' in assignments (0=no limit) +align_assign_thresh = 0 # unsigned number + +# The span for aligning on '=' in enums (0=don't align) +align_enum_equ_span = 1 # unsigned number + +# The threshold for aligning on '=' in enums (0=no limit) +align_enum_equ_thresh = 0 # unsigned number + +# The span for aligning class (0=don't align) +align_var_class_span = 0 # unsigned number + +# The threshold for aligning class member definitions (0=no limit). +align_var_class_thresh = 0 # unsigned number + +# The gap for aligning class member definitions. +align_var_class_gap = 0 # unsigned number + +# The span for aligning struct/union (0=don't align) +align_var_struct_span = 0 # unsigned number + +# The threshold for aligning struct/union member definitions (0=no limit) +align_var_struct_thresh = 0 # unsigned number + +# The gap for aligning struct/union member definitions. +align_var_struct_gap = 0 # unsigned number + +# The span for aligning struct initializer values (0=don't align) +align_struct_init_span = 0 # unsigned number + +# The minimum space between the type and the synonym of a typedef. +align_typedef_gap = 0 # unsigned number + +# The span for aligning single-line typedefs (0=don't align). +align_typedef_span = 0 # unsigned number + +# How to align typedef'd functions with other typedefs +# 0: Don't mix them at all +# 1: align the open paren with the types +# 2: align the function type name with the other type names +align_typedef_func = 0 # unsigned number + +# Controls the positioning of the '*' in typedefs. Just try it. +# 0: Align on typedef type, ignore '*' +# 1: The '*' is part of type name: typedef int *pint; +# 2: The '*' is part of the type, but dangling: typedef int *pint; +align_typedef_star_style = 0 # unsigned number + +# Controls the positioning of the '&' in typedefs. Just try it. +# 0: Align on typedef type, ignore '&' +# 1: The '&' is part of type name: typedef int &pint; +# 2: The '&' is part of the type, but dangling: typedef int &pint; +align_typedef_amp_style = 0 # unsigned number + +# The span for aligning comments that end lines (0=don't align) +align_right_cmt_span = 0 # unsigned number + +# If aligning comments, mix with comments after '}' and #endif with less than 3 spaces before the comment. +align_right_cmt_mix = false # false/true + +# If a trailing comment is more than this number of columns away from the text it follows, +# it will qualify for being aligned. This has to be > 0 to do anything. +align_right_cmt_gap = 0 # unsigned number + +# Align trailing comment at or beyond column N; 'pulls in' comments as a bonus side effect (0=ignore) +align_right_cmt_at_col = 0 # unsigned number + +# The span for aligning function prototypes (0=don't align). +align_func_proto_span = 0 # unsigned number + +# Minimum gap between the return type and the function name. +align_func_proto_gap = 0 # unsigned number + +# Align function protos on the 'operator' keyword instead of what follows. +align_on_operator = false # false/true + +# Whether to mix aligning prototype and variable declarations. +# If True, align_var_def_XXX options are used instead of align_func_proto_XXX options. +align_mix_var_proto = false # false/true + +# Align single-line functions with function prototypes, uses align_func_proto_span. +align_single_line_func = false # false/true + +# Aligning the open brace of single-line functions. +# Requires align_single_line_func=True, uses align_func_proto_span. +align_single_line_brace = false # false/true + +# Gap for align_single_line_brace. +align_single_line_brace_gap = 0 # unsigned number + +# The span for aligning ObjC msg spec (0=don't align) +align_oc_msg_spec_span = 0 # unsigned number + +# Whether to align macros wrapped with a backslash and a newline. +# This will not work right if the macro contains a multi-line comment. +align_nl_cont = true # false/true + +# # Align macro functions and variables together. +align_pp_define_together = false # false/true + +# The minimum space between label and value of a preprocessor define. +align_pp_define_gap = 1 # unsigned number + +# The span for aligning on '#define' bodies (0=don't align, other=number of lines including comments between blocks) +align_pp_define_span = 1 # unsigned number + +# Align lines that start with '<<' with previous '<<'. Default=True. +align_left_shift = true # false/true + +# Align text after asm volatile () colons. +align_asm_colon = false # false/true + +# Span for aligning parameters in an Obj-C message call on the ':' (0=don't align) +align_oc_msg_colon_span = 0 # unsigned number + +# If True, always align with the first parameter, even if it is too short. +align_oc_msg_colon_first = false # false/true + +# Aligning parameters in an Obj-C '+' or '-' declaration on the ':'. +align_oc_decl_colon = false # false/true + +# +# Comment modifications +# + +# Try to wrap comments at cmt_width columns +cmt_width = 80 # unsigned number + +# Set the comment reflow mode (Default=0) +# 0: no reflowing (apart from the line wrapping due to cmt_width) +# 1: no touching at all +# 2: full reflow +cmt_reflow_mode = 0 # unsigned number + +# Whether to convert all tabs to spaces in comments. Default is to leave tabs inside comments alone, unless used for indenting. +cmt_convert_tab_to_spaces = true # false/true + +# If False, disable all multi-line comment changes, including cmt_width. keyword substitution and leading chars. +# Default=True. +cmt_indent_multi = true # false/true + +# Whether to group c-comments that look like they are in a block. +cmt_c_group = false # false/true + +# Whether to put an empty '/*' on the first line of the combined c-comment. +cmt_c_nl_start = false # false/true + +# Whether to put a newline before the closing '*/' of the combined c-comment. +cmt_c_nl_end = false # false/true + +# Whether to group cpp-comments that look like they are in a block. +cmt_cpp_group = false # false/true + +# Whether to put an empty '/*' on the first line of the combined cpp-comment. +cmt_cpp_nl_start = false # false/true + +# Whether to put a newline before the closing '*/' of the combined cpp-comment. +cmt_cpp_nl_end = false # false/true + +# Whether to change cpp-comments into c-comments. +cmt_cpp_to_c = false # false/true + +# Whether to put a star on subsequent comment lines. +cmt_star_cont = false # false/true + +# The number of spaces to insert at the start of subsequent comment lines. +cmt_sp_before_star_cont = 0 # unsigned number + +# The number of spaces to insert after the star on subsequent comment lines. +cmt_sp_after_star_cont = 0 # number + +# For multi-line comments with a '*' lead, remove leading spaces if the first and last lines of +# the comment are the same length. Default=True. +cmt_multi_check_last = true # false/true + +# For multi-line comments with a '*' lead, remove leading spaces if the first and last lines of +# the comment are the same length AND if the length is bigger as the first_len minimum. Default=4 +cmt_multi_first_len_minimum = 4 # unsigned number + +# The filename that contains text to insert at the head of a file if the file doesn't start with a C/C++ comment. +# Will substitute $(filename) with the current file's name. +cmt_insert_file_header = "" # string + +# The filename that contains text to insert at the end of a file if the file doesn't end with a C/C++ comment. +# Will substitute $(filename) with the current file's name. +cmt_insert_file_footer = "" # string + +# The filename that contains text to insert before a function implementation if the function isn't preceded with a C/C++ comment. +# Will substitute $(function) with the function name and $(javaparam) with the javadoc @param and @return stuff. +# Will also substitute $(fclass) with the class name: void CFoo::Bar() { ... }. +cmt_insert_func_header = "" # string + +# The filename that contains text to insert before a class if the class isn't preceded with a C/C++ comment. +# Will substitute $(class) with the class name. +cmt_insert_class_header = "" # string + +# The filename that contains text to insert before a Obj-C message specification if the method isn't preceded with a C/C++ comment. +# Will substitute $(message) with the function name and $(javaparam) with the javadoc @param and @return stuff. +cmt_insert_oc_msg_header = "" # string + +# If a preprocessor is encountered when stepping backwards from a function name, then +# this option decides whether the comment should be inserted. +# Affects cmt_insert_oc_msg_header, cmt_insert_func_header and cmt_insert_class_header. +cmt_insert_before_preproc = false # false/true + +# If a function is declared inline to a class definition, then +# this option decides whether the comment should be inserted. +# Affects cmt_insert_func_header. +cmt_insert_before_inlines = true # false/true + +# If the function is a constructor/destructor, then +# this option decides whether the comment should be inserted. +# Affects cmt_insert_func_header. +cmt_insert_before_ctor_dtor = false # false/true + +# +# Code modifying options (non-whitespace) +# + +# Add or remove braces on single-line 'do' statement. +mod_full_brace_do = add # ignore/add/remove/force + +# Add or remove braces on single-line 'for' statement. +mod_full_brace_for = add # ignore/add/remove/force + +# Add or remove braces on single-line function definitions. (Pawn). +mod_full_brace_function = add # ignore/add/remove/force + +# Add or remove braces on single-line 'if' statement. Will not remove the braces if they contain an 'else'. +mod_full_brace_if = add # ignore/add/remove/force + +# Make all if/elseif/else statements in a chain be braced or not. Overrides mod_full_brace_if. +# If any must be braced, they are all braced. If all can be unbraced, then the braces are removed. +mod_full_brace_if_chain = false # false/true + +# Make all if/elseif/else statements with at least one 'else' or 'else if' fully braced. +# If mod_full_brace_if_chain is used together with this option, all if-else chains will get braces, +# and simple 'if' statements will lose them (if possible). +mod_full_brace_if_chain_only = false # false/true + +# Don't remove braces around statements that span N newlines +mod_full_brace_nl = 0 # unsigned number + +# Blocks removal of braces if the parenthesis of if/for/while/.. span multiple lines. +mod_full_brace_nl_block_rem_mlcond = false # false/true + +# Add or remove braces on single-line 'while' statement. +mod_full_brace_while = add # ignore/add/remove/force + +# Add or remove braces on single-line 'using ()' statement. +mod_full_brace_using = ignore # ignore/add/remove/force + +# Add or remove unnecessary paren on 'return' statement. +mod_paren_on_return = ignore # ignore/add/remove/force + +# Whether to change optional semicolons to real semicolons. +mod_pawn_semicolon = false # false/true + +# Add parens on 'while' and 'if' statement around bools. +mod_full_paren_if_bool = false # false/true + +# Whether to remove superfluous semicolons. +mod_remove_extra_semicolon = true # false/true + +# If a function body exceeds the specified number of newlines and doesn't have a comment after +# the close brace, a comment will be added. +mod_add_long_function_closebrace_comment = 0 # unsigned number + +# If a namespace body exceeds the specified number of newlines and doesn't have a comment after +# the close brace, a comment will be added. +mod_add_long_namespace_closebrace_comment = 0 # unsigned number + +# If a class body exceeds the specified number of newlines and doesn't have a comment after +# the close brace, a comment will be added. +mod_add_long_class_closebrace_comment = 0 # unsigned number + +# If a switch body exceeds the specified number of newlines and doesn't have a comment after +# the close brace, a comment will be added. +mod_add_long_switch_closebrace_comment = 0 # unsigned number + +# If an #ifdef body exceeds the specified number of newlines and doesn't have a comment after +# the #endif, a comment will be added. +mod_add_long_ifdef_endif_comment = 0 # unsigned number + +# If an #ifdef or #else body exceeds the specified number of newlines and doesn't have a comment after +# the #else, a comment will be added. +mod_add_long_ifdef_else_comment = 0 # unsigned number + +# If True, will sort consecutive single-line 'import' statements [Java, D]. +mod_sort_import = false # false/true + +# If True, will sort consecutive single-line 'using' statements [C#]. +mod_sort_using = false # false/true + +# If True, will sort consecutive single-line '#include' statements [C/C++] and '#import' statements [Obj-C] +# This is generally a bad idea, as it may break your code. +mod_sort_include = false # false/true + +# If True, it will move a 'break' that appears after a fully braced 'case' before the close brace. +mod_move_case_break = true # false/true + +# Will add or remove the braces around a fully braced case statement. +# Will only remove the braces if there are no variable declarations in the block. +mod_case_brace = ignore # ignore/add/remove/force + +# If True, it will remove a void 'return;' that appears as the last statement in a function. +mod_remove_empty_return = true # false/true + +# If True, it will organize the properties (Obj-C). +mod_sort_oc_properties = false # false/true + +# Determines weight of class property modifier (Obj-C). +mod_sort_oc_property_class_weight = 0 # number + +# Determines weight of atomic, nonatomic (Obj-C). +mod_sort_oc_property_thread_safe_weight = 0 # number + +# Determines weight of readwrite (Obj-C). +mod_sort_oc_property_readwrite_weight = 0 # number + +# Determines weight of reference type (retain, copy, assign, weak, strong) (Obj-C). +mod_sort_oc_property_reference_weight = 0 # number + +# Determines weight of getter type (getter=) (Obj-C). +mod_sort_oc_property_getter_weight = 0 # number + +# Determines weight of setter type (setter=) (Obj-C). +mod_sort_oc_property_setter_weight = 0 # number + +# Determines weight of nullability type (nullable, nonnull, null_unspecified, null_resettable) (Obj-C). +mod_sort_oc_property_nullability_weight = 0 # number + +# +# Preprocessor options +# + +# Control indent of preprocessors inside #if blocks at brace level 0 (file-level). +pp_indent = force # ignore/add/remove/force + +# Whether to indent #if/#else/#endif at the brace level (True) or from column 1 (False). +pp_indent_at_level = false # false/true + +# Specifies the number of columns to indent preprocessors per level at brace level 0 (file-level). +# If pp_indent_at_level=False, specifies the number of columns to indent preprocessors per level at brace level > 0 (function-level). +# Default=1. +pp_indent_count = 0 # unsigned number + +# Add or remove space after # based on pp_level of #if blocks. +pp_space = ignore # ignore/add/remove/force + +# Sets the number of spaces added with pp_space. +pp_space_count = 0 # unsigned number + +# The indent for #region and #endregion in C# and '#pragma region' in C/C++. +pp_indent_region = 0 # number + +# Whether to indent the code between #region and #endregion. +pp_region_indent_code = false # false/true + +# If pp_indent_at_level=True, sets the indent for #if, #else and #endif when not at file-level. +# 0: indent preprocessors using output_tab_size. +# >0: column at which all preprocessors will be indented. +pp_indent_if = 0 # number + +# Control whether to indent the code between #if, #else and #endif. +pp_if_indent_code = false # false/true + +# Whether to indent '#define' at the brace level (True) or from column 1 (false). +pp_define_at_level = false # false/true + +# Whether to ignore the '#define' body while formatting. +pp_ignore_define_body = false # false/true + +# Whether to indent case statements between #if, #else, and #endif. +# Only applies to the indent of the preprocesser that the case statements directly inside of. +pp_indent_case = true # false/true + +# Whether to indent whole function definitions between #if, #else, and #endif. +# Only applies to the indent of the preprocesser that the function definition is directly inside of. +pp_indent_func_def = true # false/true + +# Whether to indent extern C blocks between #if, #else, and #endif. +# Only applies to the indent of the preprocesser that the extern block is directly inside of. +pp_indent_extern = true # false/true + +# Whether to indent braces directly inside #if, #else, and #endif. +# Only applies to the indent of the preprocesser that the braces are directly inside of. +pp_indent_brace = true # false/true + +# +# Sort includes options +# + +# The regex for include category with priority 0. +include_category_0 = "" # string + +# The regex for include category with priority 1. +include_category_1 = "" # string + +# The regex for include category with priority 2. +include_category_2 = "" # string + +# +# Use or Do not Use options +# + +# True: indent_func_call_param will be used (default) +# False: indent_func_call_param will NOT be used. +use_indent_func_call_param = true # false/true + +# The value of the indentation for a continuation line is calculate differently if the statement is: +# a declaration: your case with QString fileName ... +# an assignment: your case with pSettings = new QSettings( ... +# At the second case the indentation value might be used twice: +# at the assignment +# at the function call (if present) +# To prevent the double use of the indentation value, use this option with the value 'True'. +# True: indent_continue will be used only once +# False: indent_continue will be used every time (default). +use_indent_continue_only_once = false # false/true + +# the value might be used twice: +# at the assignment +# at the opening brace +# To prevent the double use of the indentation value, use this option with the value 'True'. +# True: indentation will be used only once +# False: indentation will be used every time (default). +indent_cpp_lambda_only_once = true # false/true + +# SIGNAL/SLOT Qt macros have special formatting options. See options_for_QT.cpp for details. +# Default=True. +use_options_overriding_for_qt_macros = true # false/true + +# +# Warn levels - 1: error, 2: warning (default), 3: note +# + +# Warning is given if doing tab-to-\t replacement and we have found one in a C# verbatim string literal. +warn_level_tabs_found_in_verbatim_string_literals = 2 # unsigned number + +# Meaning of the settings: +# Ignore - do not do any changes +# Add - makes sure there is 1 or more space/brace/newline/etc +# Force - makes sure there is exactly 1 space/brace/newline/etc, +# behaves like Add in some contexts +# Remove - removes space/brace/newline/etc +# +# +# - Token(s) can be treated as specific type(s) with the 'set' option: +# `set tokenType tokenString [tokenString...]` +# +# Example: +# `set BOOL __AND__ __OR__` +# +# tokenTypes are defined in src/token_enum.h, use them without the +# 'CT_' prefix: 'CT_BOOL' -> 'BOOL' +# +# +# - Token(s) can be treated as type(s) with the 'type' option. +# `type tokenString [tokenString...]` +# +# Example: +# `type int c_uint_8 Rectangle` +# +# This can also be achieved with `set TYPE int c_uint_8 Rectangle` +# +# +# To embed whitespace in tokenStrings use the '\' escape character, or quote +# the tokenStrings. These quotes are supported: "'` +# +# +# - Support for the auto detection of languages through the file ending can be +# added using the 'file_ext' command. +# `file_ext langType langString [langString..]` +# +# Example: +# `file_ext CPP .ch .cxx .cpp.in` +# +# langTypes are defined in uncrusify_types.h in the lang_flag_e enum, use +# them without the 'LANG_' prefix: 'LANG_CPP' -> 'CPP' +# +# +# - Custom macro-based indentation can be set up using 'macro-open', +# 'macro-else' and 'macro-close'. +# `(macro-open | macro-else | macro-close) tokenString` +# +# Example: +# `macro-open BEGIN_TEMPLATE_MESSAGE_MAP` +# `macro-open BEGIN_MESSAGE_MAP` +# `macro-close END_MESSAGE_MAP` +# +# +# option(s) with 'not default' value: 0 +# diff --git a/Util/CARLA.sublime-project b/Util/CARLA.sublime-project new file mode 100644 index 000000000..aa8975f8c --- /dev/null +++ b/Util/CARLA.sublime-project @@ -0,0 +1,138 @@ +{ + "folders": + [ + { + "path": "..", + "file_exclude_patterns": + [ + "*.VC.db", + "*.VC.opendb", + "*.gdb_history", + "*.kdev4", + "*.pri", + "*.pro", + "*.py[cod]", + "*.sln", + "*.stackdump", + "*.sublime-workspace", + "*.uasset", + "*.umap", + "*.workspace", + "*CodeCompletionFolders.txt", + "*CodeLitePreProcessor.txt", + ".tags*", + "core" + ], + "folder_exclude_patterns": + [ + ".clang", + ".codelite", + ".kdev4", + ".vs", + ".vscode", + "Binaries", + "DerivedDataCache", + "Dist", + "Doxygen", + "Intermediate", + "PythonAPI/build", + "PythonAPI/dependencies", + "PythonAPI/dist", + "Saved", + "Unreal/CarlaUE4/Content*", + "Unreal/CarlaUE4/Plugins/Carla/CarlaDependencies", + "__pycache__", + "_site" + ], + } + ], + "settings": + { + "ensure_newline_at_eof_on_save": true, + "tab_size": 2, + "translate_tabs_to_spaces": true, + "trim_trailing_white_space_on_save": true + }, + "build_systems": + [ + { + "name": "CARLA - make CarlaUE4Editor", + "working_dir": "${project_path}/..", + "file_regex": "(Unreal\\/CarlaUE4\\/[^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make CarlaUE4Editor" + } + }, + { + "name": "CARLA - make LibCarla", + "working_dir": "${project_path}/..", + "file_regex": "^../../([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make LibCarla" + } + }, + { + "name": "CARLA - make PythonAPI", + "working_dir": "${project_path}/..", + "file_regex": "^../../([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make PythonAPI" + } + }, + { + "name": "CARLA - make check", + "working_dir": "${project_path}/..", + "file_regex": "^../../([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make check" + } + }, + { + "name": "CARLA - make check LibCarla", + "working_dir": "${project_path}/..", + "file_regex": "^../../([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make check ARGS=\"--carlalib-debug\"" + } + }, + { + "name": "CARLA - make check LibCarla (launch GDB)", + "working_dir": "${project_path}/..", + "file_regex": "^../../([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "gnome-terminal --maximize -e 'make check ARGS=\"--gdb --carlalib-debug\"'" + } + }, + { + "name": "CARLA - make clean", + "working_dir": "${project_path}/..", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make clean" + } + }, + { + "name": "CARLA - Prettify this file", + "working_dir": "${project_path}/..", + "file_regex": "^([^:]*):([0-9]+):?([0-9]+)?:? (.*)$", + "syntax": "Packages/Makefile/Make Output.sublime-syntax", + "linux": + { + "shell_cmd": "CARLA_BUILD_NO_COLOR=true make pretty ARGS=-f${file}" + } + } + ] +} diff --git a/mkdocs.yml b/mkdocs.yml index 964c8132d..3a366e59b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -35,6 +35,7 @@ pages: - 'How to add assets': 'how_to_add_assets.md' - 'CARLA design': 'carla_design.md' - 'CarlaServer documentation': 'carla_server.md' + - 'Build system': 'build_system.md' - Appendix: - 'Driving Benchmark Sample Results Town01': 'benchmark_basic_results_town01.md' - 'Driving Benchmark Sample Results Town02': 'benchmark_basic_results_town02.md'