From bbe38f7d30ef4cc5780108a4e4b9dccb8163f9ed Mon Sep 17 00:00:00 2001 From: Will McGugan Date: Tue, 18 Apr 2023 13:29:13 +0100 Subject: [PATCH] faq entry on Transparent backgrounds (#2319) * faq entry * word * update to words --- FAQ.md | 11 +++++++++++ questions/transparent-background.question.md | 14 ++++++++++++++ 2 files changed, 25 insertions(+) create mode 100644 questions/transparent-background.question.md diff --git a/FAQ.md b/FAQ.md index fafc8db2d..ffb91b1d7 100644 --- a/FAQ.md +++ b/FAQ.md @@ -5,6 +5,7 @@ - [Does Textual support images?](#does-textual-support-images) - [How can I fix ImportError cannot import name ComposeResult from textual.app ?](#how-can-i-fix-importerror-cannot-import-name-composeresult-from-textualapp-) - [How can I select and copy text in a Textual app?](#how-can-i-select-and-copy-text-in-a-textual-app) +- [How can I set a translucent app background?](#how-can-i-set-a-translucent-app-background) - [How do I center a widget in a screen?](#how-do-i-center-a-widget-in-a-screen) - [How do I pass arguments to an app?](#how-do-i-pass-arguments-to-an-app) - [Why do some key combinations never make it to my app?](#why-do-some-key-combinations-never-make-it-to-my-app) @@ -42,6 +43,16 @@ may expect from the command line. The exact modifier key depends on the terminal Refer to the documentation for your terminal emulator, if it is not listed above. + +## How can I set a translucent app background? + +Some terminal emulators have a translucent background feature which allows the desktop underneath to be partially visible. + +This feature is unlikely to work with Textual, as the translucency effect requires the use of ANSI background colors, which Textual doesn't use. +Textual uses 16.7 million colors where available which enables consistent colors across all platforms and additional effects which aren't possible with ANSI colors. + +For more information on ANSI colors in Textual, see [Why no Ansi Themes?](#why-doesnt-textual-support-ansi-themes). + ## How do I center a widget in a screen? diff --git a/questions/transparent-background.question.md b/questions/transparent-background.question.md new file mode 100644 index 000000000..83dd15297 --- /dev/null +++ b/questions/transparent-background.question.md @@ -0,0 +1,14 @@ +--- +title: "How can I set a translucent app background?" +alt_titles: + - "Transparent background not working" + - "Translucent background not working" + - "Can't see desktop underneath terminal" +--- + +Some terminal emulators have a translucent background feature which allows the desktop underneath to be partially visible. + +This feature is unlikely to work with Textual, as the translucency effect requires the use of ANSI background colors, which Textual doesn't use. +Textual uses 16.7 million colors where available which enables consistent colors across all platforms and additional effects which aren't possible with ANSI colors. + +For more information on ANSI colors in Textual, see [Why no Ansi Themes?](#why-doesnt-textual-support-ansi-themes).