From 25d9bc067c3843f57ffead3892c3a9d6d79bb3aa Mon Sep 17 00:00:00 2001 From: Kayla Cinnamon Date: Tue, 13 Apr 2021 23:08:32 -0700 Subject: [PATCH] Fix placement of unfocused appearance section (#312) --- TerminalDocs/customize-settings/appearance.md | 26 ----------------- .../customize-settings/profile-appearance.md | 28 +++++++++++++++++++ 2 files changed, 28 insertions(+), 26 deletions(-) diff --git a/TerminalDocs/customize-settings/appearance.md b/TerminalDocs/customize-settings/appearance.md index 91c3f93f..75f88324 100644 --- a/TerminalDocs/customize-settings/appearance.md +++ b/TerminalDocs/customize-settings/appearance.md @@ -149,32 +149,6 @@ This sets the width of the tabs. `"equal"` makes each tab the same width. `"titl ___ -## Unfocused appearance settings ([Preview](https://aka.ms/terminal-preview)) - -An object you can add to a profile that applies settings to the profile when it is unfocused. This setting only accepts appearance settings. - -**Property name:** `unfocusedAppearance` - -**Necessity:** Optional - -**Accepts:** `backgroundImage`, `backgroundImageAlignment`, `backgroundImageOpacity`, `backgroundImageStretchMode`, `cursorHeight`, `cursorShape`, `cursorColor`, `colorScheme`, `foreground`, `background`, `selectionBackground`, `experimental.retroTerminalEffect`, `experimental.pixelShaderPath` - -**Example:** -```json -// Sets the profile's background image opacity to 0.3 when it is unfocused -"unfocusedAppearance": -{ - "backgroundImageOpacity": 0.3 -}, -``` - -> [!IMPORTANT] -> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview). - -
- -___ - ## Disable pane animations This disables visual animations across the application when set to `true`. diff --git a/TerminalDocs/customize-settings/profile-appearance.md b/TerminalDocs/customize-settings/profile-appearance.md index 5a76ff54..6ba22e7f 100644 --- a/TerminalDocs/customize-settings/profile-appearance.md +++ b/TerminalDocs/customize-settings/profile-appearance.md @@ -347,6 +347,34 @@ This sets the cursor color of the profile. This will override the `cursorColor` ___ +## Unfocused appearance settings + +### Unfocused appearance settings ([Preview](https://aka.ms/terminal-preview)) + +An object you can add to a profile that applies settings to the profile when it is unfocused. This setting only accepts appearance settings. + +**Property name:** `unfocusedAppearance` + +**Necessity:** Optional + +**Accepts:** `backgroundImage`, `backgroundImageAlignment`, `backgroundImageOpacity`, `backgroundImageStretchMode`, `cursorHeight`, `cursorShape`, `cursorColor`, `colorScheme`, `foreground`, `background`, `selectionBackground`, `experimental.retroTerminalEffect`, `experimental.pixelShaderPath` + +**Example:** +```json +// Sets the profile's background image opacity to 0.3 when it is unfocused +"unfocusedAppearance": +{ + "backgroundImageOpacity": 0.3 +}, +``` + +> [!IMPORTANT] +> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview). + +
+ +___ + ## Pixel shader effects This setting allows a user to specify the path to a custom pixel shader to use with the terminal content. This is an experimental feature and its continued existence is not guaranteed. For more details on authoring custom pixel shaders for the terminal, see [this documentation](https://github.com/microsoft/terminal/blob/main/samples/PixelShaders/README.md).