Delen via


Weergaveprofielinstellingen in Windows Terminal

De onderstaande instellingen zijn van invloed op de visuele instellingen van elk profiel afzonderlijk. Als u een instelling wilt toepassen op al uw profielen, kunt u deze toevoegen aan de defaults sectie boven de lijst met profielen in uw settings.json bestand.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Tekst

Kleurenschema

Dit is de naam van het kleurenschema dat in het profiel wordt gebruikt. Kleurenschema's worden gedefinieerd in het schemes object. Meer gedetailleerde informatie vindt u op de pagina Kleurenschema's.

Naast de naam van één kleurenschema kan deze eigenschap als volgt een paar namen van kleurenschema's accepteren:

"colorScheme":
{
    "light": "One Half Light",
    "dark": "One Half Dark",
},

Wanneer deze op deze manier is opgegeven, schakelt de Terminal automatisch tussen de twee opgegeven kleurenschema's, afhankelijk van het thema van de toepassing. De terminal volgt de theme.applicationTheme eigenschap van het geselecteerde thema van de terminal. Als dat applicationTheme is ingesteld op system, wordt in plaats daarvan het kleurenschema gebruikt dat overeenkomt met het besturingssysteemthema.

Eigenschapsnaam:colorScheme

Noodzaak: Facultatief

Accepteert: Naam van kleurenschema als een tekenreeks of een object met een light en dark eigenschap

Standaardwaarde:"Campbell"

Lettertype

Dit is de structuur waarin de andere lettertype-instellingen moeten worden gedefinieerd. Hieronder ziet u een voorbeeld van hoe dit eruit kan zien in het JSON-bestand.

Eigenschapsnaam:font

Noodzaak: Facultatief

Lettertype gezicht

Dit is de naam van het lettertype dat in het profiel wordt gebruikt. De terminal probeert terug te vallen naar Consolas als dit niet kan worden gevonden of ongeldig is. Ga naar de pagina Cascadia Code voor meer informatie over de andere varianten van het standaardlettertype Cascadia Mono.

Eigenschapsnaam:face (gedefinieerd binnen het font object)

Noodzaak: Facultatief

Accepteert: Lettertypenaam als tekenreeks

Standaardwaarde:"Cascadia Mono"

Tekengrootte

Hiermee stelt u de tekengrootte van het profiel in punten in.

Eigenschapsnaam:size (gedefinieerd binnen het font object)

Noodzaak: Facultatief

Accepteert: Geheel getal

Standaardwaarde:12

Tekendikte

Hiermee stelt u het gewicht (lichtheid of zwaarheid van de pennenstreken) in voor het lettertype van het profiel.

Eigenschapsnaam:weight (gedefinieerd binnen het font object)

Noodzaak: Facultatief

Accepteert:"normal", "thin", "extra-light", "light", , "semi-light", "medium", "semi-bold", "bold""extra-bold", , "black"of "extra-black"een geheel getal dat overeenkomt met de numerieke weergave van het OpenType-lettertypegewicht

Standaardwaarde:"normal"

Voorbeeld van lettertype

"font": {
    "face": "Cascadia Mono",
    "size": 12,
    "weight": "normal"
}

Belangrijk

Dit font object is alleen beschikbaar in Windows Terminal versie 1.10+. Vóór die versie moet u de fontFace, fontSizeen fontWeight eigenschappen afzonderlijk gebruiken, zoals:

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

Lettertypefuncties

Hiermee stelt u de OpenType-tekenfuncties voor het opgegeven lettertype in.

Eigenschapsnaam:features (gedefinieerd binnen het font object)

Noodzaak: Facultatief

Accepteert: Eigenschappen van functies in de indeling van: "string": integer

Example:

// Enables ss01 and disables ligatures
"font": {
    "face": "Cascadia Code",
    "features": {
        "ss01": 1,
        "liga": 0
    }
}

Lettertypeassen

Hiermee stelt u de OpenType-tekenassen voor het opgegeven lettertype in.

Eigenschapsnaam:axes (gedefinieerd binnen het font object)

Noodzaak: Facultatief

Accepteert: Aseigenschappen in de indeling van: "string": integer

Example:

// Sets the font to italic
"font": {
    "face": "Cascadia Code",
    "axes": {
        "ital": 1
    }
}

Intense tekstopmaak

Hiermee bepaalt u hoe 'intense' tekst wordt opgemaakt in de terminal. "Intense" tekst is opgemaakt met de escape-reeks \x1b[1m.

Eigenschapsnaam:intenseTextStyle

Noodzaak: Facultatief

Accepteert:"none", "bold", "bright""all"

  • "all": intense tekst weergeven als vet en helder
  • "bold": intense tekst weergeven als vet, maar niet helder
  • "bright": intense tekst helder weergeven, maar niet vet
  • "none": de terminal doet niets speciaals voor intense tekst

Standaardwaarde:"bright"

Retro terminaleffecten

Wanneer dit is ingesteld true, zal de terminal een klassieke CRT-weergave met scanlijnen en wazige tekstranden emuleren. Dit is een experimentele functie en het voortdurende bestaan ervan is niet gegarandeerd.

Als experimental.pixelShaderPath deze instelling is ingesteld, wordt deze instelling overschreven.

Eigenschapsnaam:experimental.retroTerminalEffect

Noodzaak: Facultatief

Accepteert:true, false

Standaardwaarde:false

Windows Terminal experimentele retro terminal effect configuratie: retro opdrachtprompt



Cursor

Cursorshape

Hiermee stelt u de cursorshape voor het profiel in. De mogelijke cursors zijn als volgt: "bar" ( ┃ ), "vintage" ( ▃ ), "underscore" ( _ ), "filledBox" ( █ ), "emptyBox" ( ▯ ), "doubleUnderscore" ( ̳ )

Eigenschapsnaam:cursorShape

Noodzaak: Facultatief

Accepteert:"bar", "vintage", "underscore", "filledBox", , "emptyBox""doubleUnderscore"

Standaardwaarde:"bar"

Hoogte van cursor

Hiermee stelt u de percentagehoogte van de cursor vanaf de onderkant in. Dit werkt alleen als cursorShape deze is ingesteld op "vintage".

Eigenschapsnaam:cursorHeight

Noodzaak: Facultatief

Accepteert: Geheel getal van 1-100



Achtergrondafbeeldingen en pictogrammen

Met Windows Terminal kunt u aangepaste achtergrondafbeeldingen en pictogrammen opgeven met behulp van het menu Gebruikersinterface van instellingen of settings.json bestand voor elk van uw opdrachtregelprofielen, zodat u elk van uw profielen onafhankelijk van elkaar kunt configureren/markeren/stylen. Geef hiervoor uw voorkeur backgroundImageop, plaats het met behulp backgroundImageAlignmentvan, stel de dekking in met backgroundImageOpacityen/of geef op hoe uw afbeelding de beschikbare ruimte vult met behulp van backgroundImageStretchMode.

Voorbeeld:

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

U kunt eenvoudig uw verzameling afbeeldingen en pictogrammen op al uw computers roamen door uw pictogrammen en afbeeldingen op te slaan in OneDrive (zoals hierboven wordt weergegeven).

Pad naar achtergrondafbeelding

Hiermee stelt u de bestandslocatie van de afbeelding in om over de achtergrond van het venster te tekenen. De achtergrondafbeelding kan een .jpg, .pngof .gif bestand zijn. "desktopWallpaper" stelt de achtergrondafbeelding in op de achtergrond van het bureaublad.

Eigenschapsnaam:backgroundImage

Noodzaak: Facultatief

Accepteert: Bestandslocatie als een tekenreeks of "desktopWallpaper"

Het wordt aanbevolen dat aangepaste afbeeldingen en pictogrammen worden opgeslagen in door het systeem geleverde mappen en waarnaar wordt verwezen met behulp van de juiste URI-schema's. URI-schema's bieden een manier om te verwijzen naar bestanden die onafhankelijk zijn van hun fysieke paden (die in de toekomst kunnen veranderen). De handigste URI-schema's die u moet onthouden bij het aanpassen van achtergrondafbeeldingen en pictogrammen zijn:

URI-schema Overeenkomend fysiek pad Gebruik /beschrijving
ms-appdata:///Local/ %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\ Bestanden per machine
ms-appdata:///Roaming/ %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState\ Algemene bestanden

Waarschuwing

Vertrouw niet op bestandsverwijzingen met behulp van het ms-appx URI-schema (d.w. pictogrammen). Deze bestanden worden beschouwd als een interne implementatiedetails en kunnen naam/locatie wijzigen of in de toekomst worden weggelaten.

Opmerking

Vanaf Windows Terminal 1.24 backgroundImage kan worden verwezen naar inhoud die grenst aan het settings.json bestand.

Icons

In Windows Terminal worden pictogrammen weergegeven voor elk profiel dat door de terminal wordt gegenereerd voor ingebouwde shells, bijvoorbeeld: PowerShell Core, PowerShell en geïnstalleerde Linux/WSL-distributies. Elk profiel verwijst naar een aandelenpictogram via het ms-appx URI-schema. U kunt verwijzen naar uw eigen aangepaste pictogrammen door een pad in uw settings.json-bestand in te voeren:

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

Pictogrammen moeten een grootte hebben van 32x32 pixels in een geschikte rasterafbeeldingsindeling (bijvoorbeeld .PNG, .GIF of . ICO) om te voorkomen dat u uw pictogrammen tijdens runtime moet schalen (wat een merkbare vertraging en verlies van kwaliteit veroorzaakt).

Als er geen pictogram is opgegeven voor een opdrachtregel die u hebt geïnstalleerd, wordt deze glyph standaard ingesteld op het lettertype Segoe Fluent :

Schriftteken Unicode-punt Description
Segoe Fluent-opdrachtregelpictogram e756 CommandPrompt

Stretch-modus achtergrondafbeelding

Hiermee stelt u in hoe het formaat van de achtergrondafbeelding wordt aangepast om het venster te vullen.

Eigenschapsnaam:backgroundImageStretchMode

Noodzaak: Facultatief

Accepteert:"none", "fill", "uniform""uniformToFill"

Standaardwaarde:"uniformToFill"

Uitlijning van achtergrondafbeelding

Hiermee stelt u in hoe de achtergrondafbeelding wordt uitgelijnd op de grenzen van het venster.

Eigenschapsnaam:backgroundImageAlignment

Noodzaak: Facultatief

Accepteert:"center", "left", , "top""right", "bottom", , "topLeft", "topRight", "bottomLeft""bottomRight"

Standaardwaarde:"center"

Dekking van achtergrondafbeelding

Hiermee stelt u de transparantie van de achtergrondafbeelding in.

Eigenschapsnaam:backgroundImageOpacity

Noodzaak: Facultatief

Accepteert: Getal als een drijvende-kommawaarde van 0-1

Standaardwaarde:1.0



Transparency

Ondoorzichtigheid

Hiermee stelt u de transparantie van het venster voor het profiel in. Hiermee wordt een geheel getal van 0-100 geaccepteerd, wat een ondoorzichtig percentage vertegenwoordigt. 100 is 'volledig ondoorzichtig', 50 semi-transparant en 0 is volledig transparant.

Wanneer useAcrylic dit is ingesteld true, zal het venster het acrylmateriaal gebruiken om een wazige achtergrond voor de terminal te creëren. Wanneer useAcrylic deze is ingesteld op onwaar, gebruikt de terminal een onoplosbare dekking.

Gebruikers kunnen verschillende ondoorzichtigheidswaarden kiezen voor gerichte en niet-gerichte vensters die aanpassing mogelijk maken.

Eigenschapsnaam:opacity

Noodzaak: Facultatief

Accepteert: Getal als een geheel getal tussen 0 en 100

Standaardwaarde:100

Windows Terminal acryl ondoorzichtigheid

Belangrijk

Vóór Windows Terminal versie 1.12 was acrylicOpacitydeze instelling een float die 0.0-1.0 heeft geaccepteerd, wat standaard 0.5 was, en de dekking zou alleen van toepassing zijn als useAcrylic deze is ingesteld op waar. Op 1,12+ acrylicOpacity blijft het probleemloos werken als de equivalente opacity waarde.

Belangrijk

Onoplosbare dekking ("useAcrylic": false) werkt alleen in Windows 11.

Belangrijk

Wanneer Mica is ingeschakeld in de thema-instellingen, wordt Mica weergegeven onder de inhoud van de terminal wanneer de opacity terminal is ingesteld op een waarde <100.

Acryl inschakelen

Wanneer dit is ingesteld op true, heeft het venster een acrylachtergrond. Wanneer deze optie is ingesteld false, heeft het venster een niet-getextureerde achtergrond. Afhankelijk van de Enable Unfocused Acrylic globale instelling is de transparantie van toepassing op niet-gerichte vensters, evenals gerichte vensters wanneer deze zijn ingesteld true op of alleen van toepassing op gerichte vensters wanneer ingesteld op false.

Eigenschapsnaam:useAcrylic

Noodzaak: Facultatief

Accepteert:true, false

Standaardwaarde:false

updated_acrylic_toggle_doc



Venster

Vulling

Hiermee stelt u de opvulling rond de tekst in het venster in. Dit accepteert drie verschillende indelingen: "#" en # stelt dezelfde opvulling voor alle zijden in, "#, #" stelt dezelfde opvulling in voor links-rechts en bovenbenen, en "#, #, #, #" stelt de opvulling afzonderlijk in voor links, boven, rechts en onder.

Eigenschapsnaam:padding

Noodzaak: Facultatief

Accepteert: Waarden als een tekenreeks in de volgende notaties: "#", "#, #""#, #, #, #" of waarde als geheel getal:#

Standaardwaarde:"8, 8, 8, 8"

Windows Terminal-opvulling

Zichtbaarheid van schuifbalk

Hiermee stelt u de zichtbaarheid van de schuifbalk in.

Eigenschapsnaam:scrollbarState

Noodzaak: Facultatief

Accepteert:"visible", "hidden"(vanaf release 1.17 "always" wordt opgenomen)



Kleurinstellingen

Tabkleur

Hiermee stelt u de kleur van het tabblad van het profiel in. Als u de tabkleurkiezer gebruikt, wordt deze kleur overschreven.

Eigenschapsnaam:tabColor

Noodzaak: Facultatief

Accepteert: Kleur als een tekenreeks in hexindeling: "#rgb" of "#rrggbb"

Voorgrondkleur

Hiermee wordt de voorgrondkleur van het profiel gewijzigd. Deze onderdrukkingen foreground worden ingesteld in het kleurenschema als colorScheme deze is ingesteld.

Eigenschapsnaam:foreground

Noodzaak: Facultatief

Accepteert: Kleur als een tekenreeks in hexindeling: "#rgb" of "#rrggbb"

Achtergrondkleur

Hiermee wordt de achtergrondkleur van het profiel gewijzigd met deze instelling. Deze onderdrukkingen background worden ingesteld in het kleurenschema als colorScheme deze is ingesteld.

Eigenschapsnaam:background

Noodzaak: Facultatief

Accepteert: Kleur als een tekenreeks in hexindeling: "#rgb" of "#rrggbb"

Achtergrondkleur selecteren

Hiermee stelt u de achtergrondkleur van een selectie in het profiel in. Hiermee wordt de selectionBackground set in het kleurenschema overschreven als colorScheme deze is ingesteld.

Eigenschapsnaam:selectionBackground

Noodzaak: Facultatief

Accepteert: Kleur als een tekenreeks in hexindeling: "#rgb" of "#rrggbb"

Niet-te onderscheiden kleuren aanpassen

Met deze instelling wordt de voorgrondkleur aangepast om deze beter zichtbaar te maken op basis van de achtergrondkleur. Als deze optie is ingesteld always, worden de kleuren altijd aangepast. Wanneer deze optie is ingesteld indexed, worden de kleuren alleen aangepast als deze kleuren deel uitmaken van het kleurenschema. Als deze optie is ingesteld never, worden de kleuren nooit aangepast.

Eigenschapsnaam:adjustIndistinguishableColors

Noodzaak: Facultatief

Accepteert:always, , indexednever

Cursorkleur

Hiermee stelt u de cursorkleur van het profiel in. Hiermee wordt de cursorColor set in het kleurenschema overschreven als colorScheme deze is ingesteld.

Eigenschapsnaam:cursorColor

Noodzaak: Facultatief

Accepteert: Kleur als een tekenreeks in hexindeling: "#rgb" of "#rrggbb"



Instellingen voor niet-gericht uiterlijk

Een object dat u kunt toevoegen aan een profiel dat instellingen toepast op het profiel wanneer het niet-gericht is. Deze instelling accepteert alleen weergave-instellingen.

Eigenschapsnaam:unfocusedAppearance

Noodzaak: Facultatief

Accepteert:backgroundImage, backgroundImageAlignment, , backgroundImageOpacitybackgroundImageStretchMode, , cursorHeight, cursorShape, cursorColor, colorScheme, foregroundopacitybackgroundselectionBackgrounduseAcrylicexperimental.retroTerminalEffect,experimental.pixelShaderPath

Example:

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance":
{
    "backgroundImageOpacity": 0.3
},


Pixel-shadereffecten

Met deze instelling kan een gebruiker het pad naar een aangepaste pixel-shader opgeven voor gebruik met de terminalinhoud. Dit is een experimentele functie en het voortdurende bestaan ervan is niet gegarandeerd. Zie deze documentatie voor meer informatie over het ontwerpen van aangepaste pixel-shaders voor de terminal.

Als deze instelling is ingesteld, wordt de experimental.retroTerminalEffect instelling overschreven.

Eigenschapsnaam:experimental.pixelShaderPath

Noodzaak: Facultatief

Accepteert: Een pad naar een .hlsl shader-bestand als tekenreeks

Met een extra instelling experimental.pixelShaderImagePathkunt u een afbeeldingsbestand opgeven dat langs de shader moet worden geladen. Deze wordt beschikbaar gesteld in het patroonregister t1.

Eigenschapsnaam:experimental.pixelShaderImagePath

Noodzaak: Facultatief

Accepteert: Een pad naar een afbeeldingsbestand als een tekenreeks

Opmerking

Vanaf Windows Terminal 1.24 experimental.pixelShaderPath kan experimental.pixelShaderImagePath dit verwijzen naar inhoud die grenst aan het settings.json bestand.