meson: ensure all examples are included in doc

Move declaration of examples to use same file lists for build and docs.

doc/meson.build

@@ -88,27 +88,13 @@ example_files = [
   'tutorial4.c',
   'tutorial5.c',
   'tutorial6.c',
-  'audio-src.c',
-  'audio-dsp-src.c',
-  'audio-dsp-filter.c',
-  'video-play.c',
-  'video-src.c',
-  'video-dsp-play.c',
-  'video-play-pull.c',
-  'video-play-reneg.c',
-  'video-src-alloc.c',
-  'video-src-reneg.c',
-  'export-sink.c',
-  'export-source.c',
-  'export-spa.c',
-  'export-spa-device.c',
-  'bluez-session.c',
-  'local-v4l2.c',
-  'spa/examples/adapter-control.c',
-  'spa/examples/example-control.c',
-  'spa/examples/local-libcamera.c',
-  'spa/examples/local-v4l2.c',
 ]
+foreach h : examples
+  example_files += [h + '.c']
+endforeach
+foreach h : spa_examples
+  example_files += ['spa/examples/' + h + '.c']
+endforeach
 
 example_doxygen = []
 example_ref = []

spa/examples/meson.build

@@ -1,27 +1,32 @@
-if sdl_dep.found()
+# Examples, in order from simple to complicated
-  executable('local-v4l2', 'local-v4l2.c',
+spa_examples = [
-             include_directories : [configinc, spa_inc],
+  'adapter-control',
-             dependencies : [dl_lib, sdl_dep, pthread_lib],
+  'example-control',
-             install : installed_tests_enabled,
+  'local-libcamera',
-             install_dir : installed_tests_execdir / 'examples' / 'spa')
+  'local-v4l2',
+]
 
-  if libcamera_dep.found()
+spa_examples_extra_deps = {
-    executable('local-libcamera', 'local-libcamera.c',
+  'local-v4l2': [sdl_dep],
-               include_directories : [configinc, spa_inc],
+  'local-libcamera': [sdl_dep, libcamera_dep],
-               dependencies : [dl_lib, sdl_dep, pthread_lib, libcamera_dep],
+}
-               install : installed_tests_enabled,
+
-               install_dir : installed_tests_execdir / 'examples' / 'spa')
+foreach c : spa_examples
+  deps = spa_examples_extra_deps.get(c, [])
+
+  found = true
+  foreach dep : deps
+    found = found and dep.found()
+  endforeach
+
+  if found
+    executable(
+      c,
+      c + '.c',
+      include_directories : [configinc, spa_inc],
+      dependencies : [dl_lib, pthread_lib, mathlib] + deps,
+      install : installed_tests_enabled,
+      install_dir : installed_tests_execdir / 'examples' / 'spa'
+    )
   endif
-endif
+endforeach
-
-executable('example-control', 'example-control.c',
-             include_directories : [configinc, spa_inc],
-             dependencies : [dl_lib, pthread_lib, mathlib],
-             install : installed_tests_enabled,
-             install_dir : installed_tests_execdir / 'examples' / 'spa')
-
-executable('adapter-control', 'adapter-control.c',
-             include_directories : [configinc, spa_inc],
-             dependencies : [dl_lib, pthread_lib, mathlib],
-             install : installed_tests_enabled,
-             install_dir : installed_tests_execdir / 'examples' / 'spa')

src/examples/meson.build

@@ -1,121 +1,50 @@
-executable('video-src',
+# Examples, in order from simple to complicated
-  'video-src.c',
+examples = [
-  install : installed_tests_enabled,
+  'audio-src',
-  install_dir : installed_tests_execdir / 'examples',
+  'audio-dsp-src',
-  dependencies : [pipewire_dep, mathlib],
+  'audio-dsp-filter',
-)
+  'video-play',
-executable('video-src-alloc',
+  'video-src',
-  'video-src-alloc.c',
+  'video-dsp-play',
-  install : installed_tests_enabled,
+  'video-play-pull',
-  install_dir : installed_tests_execdir / 'examples',
+  'video-play-reneg',
-  dependencies : [pipewire_dep, mathlib],
+  'video-src-alloc',
-)
+  'video-src-reneg',
-executable('video-src-reneg',
+  'video-src-fixate',
-  'video-src-reneg.c',
+  'video-play-fixate',
-  install : installed_tests_enabled,
+  'export-sink',
-  install_dir : installed_tests_execdir / 'examples',
+  'export-source',
-  dependencies : [pipewire_dep, mathlib],
+  'export-spa',
-)
+  'export-spa-device',
-if drm_dep.found()
+  'bluez-session',
-  executable('video-src-fixate',
+  'local-v4l2',
-    'video-src-fixate.c',
+]
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, drm_dep, mathlib],
-  )
-endif
-executable('audio-src',
-  'audio-src.c',
-  install : installed_tests_enabled,
-  install_dir : installed_tests_execdir / 'examples',
-  dependencies : [pipewire_dep, mathlib],
-)
-executable('audio-dsp-src',
-  'audio-dsp-src.c',
-  install : installed_tests_enabled,
-  install_dir : installed_tests_execdir / 'examples',
-  dependencies : [pipewire_dep, mathlib],
-)
-executable('export-source',
-  'export-source.c',
-  install : installed_tests_enabled,
-  install_dir : installed_tests_execdir / 'examples',
-  dependencies : [pipewire_dep, mathlib],
-)
 
-executable('audio-dsp-filter',
+examples_extra_deps = {
-  'audio-dsp-filter.c',
+  'video-src-fixate': [drm_dep],
-  install : installed_tests_enabled,
+  'video-play': [sdl_dep],
-  install_dir : installed_tests_execdir / 'examples',
+  'video-play-reneg': [sdl_dep],
-  dependencies : [pipewire_dep, mathlib],
+  'video-play-fixate': [sdl_dep, drm_dep],
-)
+  'video-play-pull': [sdl_dep],
+  'video-dsp-play': [sdl_dep],
+  'local-v4l2': [sdl_dep],
+  'export-sink': [sdl_dep],
+}
 
-executable('export-spa',
+foreach c : examples
-  'export-spa.c',
+  deps = examples_extra_deps.get(c, [])
-  install : installed_tests_enabled,
-  install_dir : installed_tests_execdir / 'examples',
-  dependencies : [pipewire_dep, mathlib],
-)
 
-executable('export-spa-device',
+  found = true
-  'export-spa-device.c',
+  foreach dep : deps
-  install : installed_tests_enabled,
+    found = found and dep.found()
-  install_dir : installed_tests_execdir / 'examples',
+  endforeach
-  dependencies : [pipewire_dep, mathlib],
-)
 
-executable('bluez-session',
+  if found
-  'bluez-session.c',
+    executable(
-  install : installed_tests_enabled,
+      c, c + '.c',
-  install_dir : installed_tests_execdir / 'examples',
-  dependencies : [pipewire_dep, mathlib],
-)
-
-if sdl_dep.found()
-  executable('video-play',
-    'video-play.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep, mathlib],
-  )
-  executable('video-play-reneg',
-    'video-play-reneg.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep, mathlib],
-  )
-  if drm_dep.found()
-    executable('video-play-fixate',
-      'video-play-fixate.c',
       install : installed_tests_enabled,
       install_dir : installed_tests_execdir / 'examples',
-      dependencies : [pipewire_dep, sdl_dep, drm_dep, mathlib],
+      dependencies : [pipewire_dep, mathlib] + deps,
     )
   endif
-  executable('video-play-pull',
+endforeach
-    'video-play-pull.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep, mathlib],
-  )
-  executable('video-dsp-play',
-    'video-dsp-play.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep, mathlib],
-  )
-
-  executable('local-v4l2',
-    'local-v4l2.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep],
-  )
-
-  executable('export-sink',
-    'export-sink.c',
-    install : installed_tests_enabled,
-    install_dir : installed_tests_execdir / 'examples',
-    dependencies : [pipewire_dep, sdl_dep, mathlib],
-  )
-endif

src/examples/video-play-fixate.c

@@ -24,7 +24,7 @@
 
 /*
  [title]
- Video input stream using \ref pw_stream "pw_stream", with format renegotiation.
+ Video input stream using \ref pw_stream "pw_stream", with format fixation.
  [title]
  */