xcb-studies/notes.md

- A Display has Screens
- A Screen has Monitors & Windows
- The root Screen is accessed by traversing to the head of the list of
  screens using an interator.
- The root screen's root window is used as the parameter for
  'get_screen_resources'.
- The screen_resources object is contains 'screen_resources_crtcs',
  which you again get via an iterator. These are cookies.

CXX Opts looks like a really useful version of GetOpts that will do what you want:
https://github.com/jarro2783/cxxopts


# Git

- `git submodule add <url>` is how you add a submodule to your project.  It
  creates a new folder for the submodule and it creates an entry in the
  `$(git-root)/.gitmodule` file that explains where the submodule should go and
  how to reference it.
Innteresting. It seems that the `output` collection is much more reliable as a source of truth about which monitors and screens are actually in use. Each one comes with its own collection of `crtc`, but you can just skip the ones that return `null`, giving you a reliable list of the "active and visible" screens that the user is currently looking at. Excellent! This means that I'm one step closer to having a viable solution! I also discovered the [xcb_util](https://xcb.freedesktop.org/XcbUtil/) library of helpful utilities has a function called `xcb_aux_get_screen` for getting the root screen because everyone was weirded out by that list traversal algorithm. The source code to [xedgewarp](https://github.com/Airblader/xedgewarp) was invaluable in revealing these secrets to me. So far this little toy compiles down to only 35KB, and that includes using `std::cout` and `std::vector`! I wonder how big the Rust version will be. Yeah, yeah, I know, it cheats by having lots of itself hidden in the kernel. Next up: Actually knowing what the rotation status is. 2022-02-24 23:59:43 +00:00			`- A Display has Screens`
			`- A Screen has Monitors & Windows`
			`- The root Screen is accessed by traversing to the head of the list of`
			`screens using an interator.`
			`- The root screen's root window is used as the parameter for`
			`'get_screen_resources'.`
			`- The screen_resources object is contains 'screen_resources_crtcs',`
			`which you again get via an iterator. These are cookies.`
Keeping up-to-date, and preparing for some basic CLI stuff with a simple CXXOpts handler that had an API I thought was somewhat readable. 2022-03-31 22:38:18 +00:00
			`CXX Opts looks like a really useful version of GetOpts that will do what you want:`
			`https://github.com/jarro2783/cxxopts`
Moving the 'learning xcb reading' into its own folder. This matches the learning process that I describe in rigged_regex. Step by step, recording everything multiple times and in multiple ways, so that all the learning that I care about is preserved. There's XCB in here, and some C++ (mostly around `unique_ptr`). 2022-04-15 21:41:03 +00:00

			`# Git`

			- `git submodule add <url>` is how you add a submodule to your project. It
			`creates a new folder for the submodule and it creates an entry in the`
			`$(git-root)/.gitmodule` file that explains where the submodule should go and
			`how to reference it.`