| 
									
										
										
										
											2016-10-17 08:50:25 +02:00
										 |  |  | #!/usr/bin/env python | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  | Import("env") | 
					
						
							|  |  |  | Import("env_modules") | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | env_freetype = env_modules.Clone() | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | # Thirdparty source files | 
					
						
							| 
									
										
										
										
											2020-12-17 16:01:36 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | thirdparty_obj = [] | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  | if env["builtin_freetype"]: | 
					
						
							| 
									
										
										
										
											2016-10-30 18:44:57 +01:00
										 |  |  |     thirdparty_dir = "#thirdparty/freetype/" | 
					
						
							|  |  |  |     thirdparty_sources = [ | 
					
						
							|  |  |  |         "src/autofit/autofit.c", | 
					
						
							|  |  |  |         "src/base/ftbase.c", | 
					
						
							|  |  |  |         "src/base/ftbbox.c", | 
					
						
							|  |  |  |         "src/base/ftbdf.c", | 
					
						
							|  |  |  |         "src/base/ftbitmap.c", | 
					
						
							|  |  |  |         "src/base/ftcid.c", | 
					
						
							|  |  |  |         "src/base/ftdebug.c", | 
					
						
							|  |  |  |         "src/base/ftfstype.c", | 
					
						
							|  |  |  |         "src/base/ftgasp.c", | 
					
						
							|  |  |  |         "src/base/ftglyph.c", | 
					
						
							|  |  |  |         "src/base/ftgxval.c", | 
					
						
							|  |  |  |         "src/base/ftinit.c", | 
					
						
							|  |  |  |         "src/base/ftmm.c", | 
					
						
							|  |  |  |         "src/base/ftotval.c", | 
					
						
							|  |  |  |         "src/base/ftpatent.c", | 
					
						
							|  |  |  |         "src/base/ftpfr.c", | 
					
						
							|  |  |  |         "src/base/ftstroke.c", | 
					
						
							|  |  |  |         "src/base/ftsynth.c", | 
					
						
							|  |  |  |         "src/base/ftsystem.c", | 
					
						
							|  |  |  |         "src/base/fttype1.c", | 
					
						
							|  |  |  |         "src/base/ftwinfnt.c", | 
					
						
							|  |  |  |         "src/bdf/bdf.c", | 
					
						
							| 
									
										
										
										
											2017-06-24 23:42:22 +09:00
										 |  |  |         "src/bzip2/ftbzip2.c", | 
					
						
							| 
									
										
										
										
											2016-10-30 18:44:57 +01:00
										 |  |  |         "src/cache/ftcache.c", | 
					
						
							|  |  |  |         "src/cff/cff.c", | 
					
						
							|  |  |  |         "src/cid/type1cid.c", | 
					
						
							|  |  |  |         "src/gxvalid/gxvalid.c", | 
					
						
							| 
									
										
										
										
											2017-06-24 23:42:22 +09:00
										 |  |  |         "src/gzip/ftgzip.c", | 
					
						
							|  |  |  |         "src/lzw/ftlzw.c", | 
					
						
							| 
									
										
										
										
											2016-10-30 18:44:57 +01:00
										 |  |  |         "src/otvalid/otvalid.c", | 
					
						
							|  |  |  |         "src/pcf/pcf.c", | 
					
						
							|  |  |  |         "src/pfr/pfr.c", | 
					
						
							|  |  |  |         "src/psaux/psaux.c", | 
					
						
							|  |  |  |         "src/pshinter/pshinter.c", | 
					
						
							|  |  |  |         "src/psnames/psnames.c", | 
					
						
							|  |  |  |         "src/raster/raster.c", | 
					
						
							| 
									
										
										
										
											2022-01-13 08:37:24 +01:00
										 |  |  |         "src/sdf/sdf.c", | 
					
						
							| 
									
										
										
										
											2022-05-17 18:14:19 +03:00
										 |  |  |         "src/svg/svg.c", | 
					
						
							| 
									
										
										
										
											2016-10-30 18:44:57 +01:00
										 |  |  |         "src/smooth/smooth.c", | 
					
						
							|  |  |  |         "src/truetype/truetype.c", | 
					
						
							|  |  |  |         "src/type1/type1.c", | 
					
						
							|  |  |  |         "src/type42/type42.c", | 
					
						
							|  |  |  |         "src/winfonts/winfnt.c", | 
					
						
							|  |  |  |     ] | 
					
						
							|  |  |  |     thirdparty_sources = [thirdparty_dir + file for file in thirdparty_sources] | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-08-03 13:38:37 +03:00
										 |  |  |     if env["brotli"]: | 
					
						
							|  |  |  |         env_freetype.Append(CPPDEFINES=["FT_CONFIG_OPTION_USE_BROTLI"]) | 
					
						
							| 
									
										
										
										
											2022-03-31 17:33:28 +03:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |     if env["platform"] == "uwp": | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  |         # Include header for UWP to fix build issues | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |         env_freetype.Append(CCFLAGS=["/FI", '"modules/freetype/uwpdef.h"']) | 
					
						
							| 
									
										
										
										
											2018-11-03 16:45:04 +01:00
										 |  |  |         # Globally too, as freetype is used in scene (see bottom) | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |         env.Append(CCFLAGS=["/FI", '"modules/freetype/uwpdef.h"']) | 
					
						
							| 
									
										
										
										
											2018-03-06 19:18:34 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-30 13:12:02 +02:00
										 |  |  |     env_freetype.Prepend(CPPPATH=[thirdparty_dir + "/include"]) | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  |     # Also needed in main env for scene/ | 
					
						
							| 
									
										
										
										
											2019-04-30 13:12:02 +02:00
										 |  |  |     env.Prepend(CPPPATH=[thirdparty_dir + "/include"]) | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-05-17 18:14:19 +03:00
										 |  |  |     env_freetype.Append(CPPDEFINES=["FT2_BUILD_LIBRARY", "FT_CONFIG_OPTION_USE_PNG", "FT_CONFIG_OPTION_SYSTEM_ZLIB"]) | 
					
						
							| 
									
										
											  
											
												SCons: Unify tools/target build type configuration
Implements https://github.com/godotengine/godot-proposals/issues/3371.
New `target` presets
====================
The `tools` option is removed and `target` changes to use three new presets,
which match the builds users are familiar with. These targets control the
default optimization level and enable editor-specific and debugging code:
- `editor`: Replaces `tools=yes target=release_debug`.
  * Defines: `TOOLS_ENABLED`, `DEBUG_ENABLED`, `-O2`/`/O2`
- `template_debug`: Replaces `tools=no target=release_debug`.
  * Defines: `DEBUG_ENABLED`, `-O2`/`/O2`
- `template_release`: Replaces `tools=no target=release`.
  * Defines: `-O3`/`/O2`
New `dev_build` option
======================
The previous `target=debug` is now replaced by a separate `dev_build=yes`
option, which can be used in combination with either of the three targets,
and changes the following:
- `dev_build`: Defines `DEV_ENABLED`, disables optimization (`-O0`/`/0d`),
  enables generating debug symbols, does not define `NDEBUG` so `assert()`
  works in thirdparty libraries, adds a `.dev` suffix to the binary name.
Note: Unlike previously, `dev_build` defaults to off so that users who
compile Godot from source get an optimized and small build by default.
Engine contributors should now set `dev_build=yes` in their build scripts or
IDE configuration manually.
Changed binary names
====================
The name of generated binaries and object files are changed too, to follow
this format:
`godot.<platform>.<target>[.dev][.double].<arch>[.<extra_suffix>][.<ext>]`
For example:
- `godot.linuxbsd.editor.dev.arm64`
- `godot.windows.template_release.double.x86_64.mono.exe`
Be sure to update your links/scripts/IDE config accordingly.
More flexible `optimize` and `debug_symbols` options
====================================================
The optimization level and whether to generate debug symbols can be further
specified with the `optimize` and `debug_symbols` options. So the default
values listed above for the various `target` and `dev_build` combinations
are indicative and can be replaced when compiling, e.g.:
`scons p=linuxbsd target=template_debug dev_build=yes optimize=debug`
will make a "debug" export template with dev-only code enabled, `-Og`
optimization level for GCC/Clang, and debug symbols. Perfect for debugging
complex crashes at runtime in an exported project.
											
										 
											2022-09-22 08:28:55 +02:00
										 |  |  |     if env.dev_build: | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |         env_freetype.Append(CPPDEFINES=["ZLIB_DEBUG"]) | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |     # Also requires libpng headers | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |     if env["builtin_libpng"]: | 
					
						
							| 
									
										
										
										
											2019-04-30 13:12:02 +02:00
										 |  |  |         env_freetype.Prepend(CPPPATH=["#thirdparty/libpng"]) | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |     sfnt = thirdparty_dir + "src/sfnt/sfnt.c" | 
					
						
							| 
									
										
										
										
											2019-07-03 09:16:20 +02:00
										 |  |  |     # Must be done after all CPPDEFINES are being set so we can copy them. | 
					
						
							| 
									
										
										
										
											2022-08-28 20:27:45 +02:00
										 |  |  |     if env["platform"] == "web": | 
					
						
							| 
									
										
										
										
											2019-05-01 18:32:17 +02:00
										 |  |  |         # Forcibly undefine this macro so SIMD is not used in this file, | 
					
						
							|  |  |  |         # since currently unsupported in WASM | 
					
						
							|  |  |  |         tmp_env = env_freetype.Clone() | 
					
						
							| 
									
										
										
										
											2021-08-06 10:32:02 +02:00
										 |  |  |         tmp_env.disable_warnings() | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |         tmp_env.Append(CPPFLAGS=["-U__OPTIMIZE__"]) | 
					
						
							| 
									
										
										
										
											2019-05-01 18:32:17 +02:00
										 |  |  |         sfnt = tmp_env.Object(sfnt) | 
					
						
							|  |  |  |     thirdparty_sources += [sfnt] | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-10-01 10:59:03 +02:00
										 |  |  |     env_thirdparty = env_freetype.Clone() | 
					
						
							|  |  |  |     env_thirdparty.disable_warnings() | 
					
						
							|  |  |  |     lib = env_thirdparty.add_library("freetype_builtin", thirdparty_sources) | 
					
						
							| 
									
										
										
										
											2020-12-17 16:01:36 +01:00
										 |  |  |     thirdparty_obj += lib | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-19 14:26:27 +01:00
										 |  |  |     # Needs to be appended to arrive after libscene in the linker call, | 
					
						
							|  |  |  |     # but we don't want it to arrive *after* system libs, so manual hack | 
					
						
							|  |  |  |     # LIBS contains first SCons Library objects ("SCons.Node.FS.File object") | 
					
						
							|  |  |  |     # and then plain strings for system library. We insert between the two. | 
					
						
							|  |  |  |     inserted = False | 
					
						
							|  |  |  |     for idx, linklib in enumerate(env["LIBS"]): | 
					
						
							| 
									
										
										
										
											2020-03-30 08:28:32 +02:00
										 |  |  |         if isinstance(linklib, (str, bytes)):  # first system lib such as "X11", otherwise SCons lib object | 
					
						
							| 
									
										
										
										
											2017-03-19 14:26:27 +01:00
										 |  |  |             env["LIBS"].insert(idx, lib) | 
					
						
							|  |  |  |             inserted = True | 
					
						
							|  |  |  |             break | 
					
						
							|  |  |  |     if not inserted: | 
					
						
							|  |  |  |         env.Append(LIBS=[lib]) | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-12-17 16:01:36 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-14 21:57:43 +02:00
										 |  |  | # Godot source files | 
					
						
							| 
									
										
										
										
											2020-12-17 16:01:36 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | module_obj = [] | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | env_freetype.add_source_files(module_obj, "*.cpp") | 
					
						
							|  |  |  | env.modules_sources += module_obj | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | # Needed to force rebuilding the module files when the thirdparty library is updated. | 
					
						
							|  |  |  | env.Depends(module_obj, thirdparty_obj) |