Skip to content

Docs: Updates with an example on how to check for black & white pages.#5026

Merged
jamie-lemon merged 1 commit into
mainfrom
docs-detect-bw
Jun 17, 2026
Merged

Docs: Updates with an example on how to check for black & white pages.#5026
jamie-lemon merged 1 commit into
mainfrom
docs-detect-bw

Conversation

@jamie-lemon

Copy link
Copy Markdown
Collaborator

Also some updates to file conversion section & docs README

Comment thread docs/the-basics.rst Outdated
Also some updates to file conversion section & docs README
@jamie-lemon jamie-lemon merged commit f3b61df into main Jun 17, 2026
3 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Jun 17, 2026

@JorjMcKie JorjMcKie left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The wording ...

A simple check to determine if a page is black and white or has color can be done by checking for whether a page is monochrome.

... is logically incorrect, because the negation of "black & white" is not the same as "page has colors".
A page with many "shades of gray/grey" is also not black & white but neither shows colors.

Black & white means that everything on the page is either pure white or pure black. This is what we are actually checking. If the result is True then we can conclude that the page has definitely no colors. But in case of False we cannot conclude that there are colors.

A page without colors is one where all pixels have R=G=B when the page was rendered as RGB.

Suggestion:

A simple check to determine if a page is pure black and white ("monochrome"). Non‑monochrome means the page has multiple gray levels or colors.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants