annotate cmake/MlkBcc.cmake @ 646:7e1eb7f6c049 default tip @

misc: remove .clang
author David Demelier <markand@malikania.fr>
date Sun, 04 Feb 2024 15:24:37 +0100
parents f2aff78644db
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 #
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 # CMakeLists.txt -- CMake build system for Molko's Engine
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 #
581
cedfdbc0e9a7 misc: update copyright years
David Demelier <markand@malikania.fr>
parents: 574
diff changeset
4 # Copyright (c) 2020-2023 David Demelier <markand@malikania.fr>
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 #
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 # Permission to use, copy, modify, and/or distribute this software for any
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 # purpose with or without fee is hereby granted, provided that the above
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 # copyright notice and this permission notice appear in all copies.
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 #
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 #
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
19 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
20 # mlk_bcc(
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
21 # OUTPUT_VAR variable
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
22 # ASSETS files...
611
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
23 # [CONST]
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
24 # [NUL]
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
25 # [OUTPUT_DIRECTORY directory]
611
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
26 # [STATIC]
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
27 # [TYPE char]
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
28 # )
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
29 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
30 # Convert binary files to header files using mlk-bcc utility.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
31 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
32 # This macro will generate all files under the OUTPUT_DIRECTORY variable which
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
33 # defaults to ${CMAKE_CURRENT_BINARY_DIR}/assets if unset.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
34 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
35 # It will also keep the last parent directory name under the output directory
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
36 # because most users will arrange more files under a specific file hierarchy,
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
37 # this also avoid a file name conflict.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
38 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
39 # Example, given the following assets files:
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
40 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
41 # - assets/sprites/foo.png
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
42 # - assets/sounds/volume-up.wav
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
43 # - assets/sounds/volume-down.wav
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
44 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
45 # The following files will be generated:
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
46 #
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
47 # - <output-directory>/assets/sprites/foo.h
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
48 # - <output-directory>/assets/sounds/volume-up.h
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
49 # - <output-directory>/assets/sounds/volume-down.h
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
50 #
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 macro(mlk_bcc)
611
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
52 set(options "CONST;NUL;STATIC")
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
53 set(oneValueArgs "OUTPUT_DIRECTORY;OUTPUTS_VAR")
611
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
54 set(multiValueArgs "ASSETS")
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
55
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 cmake_parse_arguments(_bcc "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
57
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 if (NOT _bcc_OUTPUTS_VAR)
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 message(FATAL_ERROR "Missing OUTPUTS_VAR")
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 elseif (NOT _bcc_ASSETS)
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 message(FATAL_ERROR "Missing ASSETS")
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 endif ()
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
63
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
64 if (NOT _bcc_OUTPUT_DIRECTORY)
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
65 set(_bcc_base_directory ${CMAKE_CURRENT_BINARY_DIR}/assets)
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
66 else ()
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
67 set(_bcc_base_directory ${_bcc_OUTPUT_DIRECTORY})
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
68 endif ()
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
69
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 foreach (a ${_bcc_ASSETS})
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
71 # Determine output parent directory name.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
72 get_filename_component(_bcc_dirname ${a} DIRECTORY)
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
73 get_filename_component(_bcc_dirname ${_bcc_dirname} NAME)
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
74
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
75 # Determine output file name.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
76 cmake_path(GET a FILENAME _bcc_filename)
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
77 cmake_path(REPLACE_EXTENSION _bcc_filename .h)
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
78 set(_bcc_output_file ${_bcc_base_directory}/${_bcc_dirname}/${_bcc_filename})
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
79
611
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
80 if (_bcc_CONST)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
81 list(APPEND _bcc_args -c)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
82 endif ()
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
83 if (_bcc_NUL)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
84 list(APPEND _bcc_args -0)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
85 endif ()
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
86 if (_bcc_STATIC)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
87 list(APPEND _bcc_args -s)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
88 endif ()
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
89 if (_bcc_TYPE)
f2aff78644db mlk-bcc: update to 2.2.0
David Demelier <markand@malikania.fr>
parents: 597
diff changeset
90 list(APPEND _bcc_args -t ${_bcc_TYPE})
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
91 endif ()
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
92
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
93 # This is the mlk-bcc variable to generate the C identifier.
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
94 set(_bcc_var "assets_${_bcc_dirname}_${_bcc_filename}")
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
95
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 add_custom_command(
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
97 OUTPUT ${_bcc_output_file}
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
98 COMMAND
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
99 ${CMAKE_COMMAND} -E make_directory ${_bcc_base_directory}/${_bcc_dirname}
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 COMMAND
597
087468cbf7ab cmake: install more modules
David Demelier <markand@malikania.fr>
parents: 581
diff changeset
101 $<TARGET_FILE:mlk::mlk-bcc> ${_bcc_args} ${a} ${_bcc_var} > ${_bcc_output_file}
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
102 COMMENT "Generating asset ${_bcc_dirname}/${_bcc_filename}"
597
087468cbf7ab cmake: install more modules
David Demelier <markand@malikania.fr>
parents: 581
diff changeset
103 DEPENDS $<TARGET_FILE:mlk::mlk-bcc> ${a}
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 )
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
105
553
cb4508f45048 cmake: rework assets output directory
David Demelier <markand@malikania.fr>
parents: 552
diff changeset
106 list(APPEND ${_bcc_OUTPUTS_VAR} ${_bcc_output_file})
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 endforeach ()
574
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
108
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
109 source_group(
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
110 TREE ${_bcc_base_directory}
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
111 FILES ${${_bcc_OUTPUTS_VAR}}
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
112 PREFIX build/assets
8cf895e51fb6 win: various improvements
David Demelier <markand@malikania.fr>
parents: 553
diff changeset
113 )
447
e1fa1b867281 cmake: resurrection
David Demelier <markand@malikania.fr>
parents:
diff changeset
114 endmacro()