elf
/
xcb-studies
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
xcb-studies/README.md

84 lines
3.1 KiB
Markdown
Raw Normal View History

Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
# SP3tabletd
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
![Rust](https://img.shields.io/badge/rust-%23000000.svg?style=flat&logo=rust&logoColor=white)
![C++](https://img.shields.io/badge/c++-%2300599C.svg?style=flat&logo=c%2B%2B&logoColor=white)
![Linux](https://img.shields.io/badge/Linux-FCC624?style=flat&logo=linux&logoColor=black)
Changed the color on the Xorg logo to the lighter background.
2022-02-25 01:07:06 +00:00
![X11](https://img.shields.io/badge/X11-FEC350?style=flat&logo=xdotorg&logoColor=black)
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
![Status](https://img.shields.io/badge/Status-Incomplete-red)
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
This is a re-write of my [Surface Pro 3
Autorotate](https://github.com/elfsternberg/surface3-scripts)
program. Note that what you have here is just part of the learning
curve.
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
This program autorotates the screen of a Microsoft Surface Pro 3 Tablet
running Linux. It correctly performs the autorotation for all major
pointer devices, including the stylus and eraser devices. It also
enables palm rejection (meaning you can rest your hand on the screen
while drawing) when the stylus and eraser devices are "in use" (which is
defined by the digitizer as "within approximately 4cm of the screen").
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
This program is written in Python 2, which is included in all major
Linux distributions by default. It has no additional dependencies.
It may run on other versions of the Microsoft Surface, but I haven't
tested it on anything other than my own Surface Pro 3.
## Progress
The intent of this exercise is to eventually
[RIIR](https://adventures.michaelfbryan.com/posts/how-to-riir/) the
code. Right now, I'm actively learning how the X11/XCB library works
to encode and transmit monitor and rotation information for the root
screen, so what you'll find in the [`src`](./src) tree is a C++
program where I'm slowly, one painful step at a time, figuring out how
to efficiently retrieve information from the X11 server and then send
commands to rotate the screen.
It's not enough to rotate the screen, and eventually I'm going to have
to figure out how to use XInput as well to map the pen/pointer device,
so that I can use [Gimp](https://www.gimp.org/) and
[Krita](https://krita.org/en/) effectively.
My only observation so far is that, after having a run in with
`std::unique_ptr`, the ergonomics of Rust make me very happy indeed.
I can only hope the Rust/XCB interface adheres close enough to the C
version that the port is trivial.
## Credits
The original geometry detection algorithms that this script will use
were written by [Ayko
Poel](https://github.com/AykoPoel/surface3-scripts). My contribution
consists of more robust device and device driver identification
algorithms for the stylus and eraser, and a general modernization of
the transform algorithm.
## Requirements
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
This code has been tested with gcc-7.3, and should work on any
C++17-compliant compiler with the relevant standard library, and
obviously X Windows.
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
## Building
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
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
From the base directory of the project (not that there's much there):
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
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
``` shell
$ mkdir build
$ cd build
$ cmake ..
$ make
```
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
## License
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
This XRandR experiment is Copyright [Elf
M. Sternberg](https://elfsternberg.com) (c) 2019, and licensed with
the Mozilla Public License vers. 2.0. A copy of the license file is
included in the root folder.
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
## Code of Conduct
Initial commit: XRandR connects to the server via XCB. I really need to start two cheatsheets for this: one for CMake, and one for XCB.
2022-02-17 15:01:34 +00:00
Added README and LICENSE files. In preparation for putting it up on Github.
2022-02-25 01:03:29 +00:00
Don't be a douchebag. That is all.