Dagor Shader Language Support
Dagor Shader Language Support for Visual Studio Code. If you're not on x64 architecture, you have to install Node.js in order to use the extension.
Features
Syntax highlight
The extension colorizes types, variables, functions, constructors, keywords, modifiers, semantics, attributes, preprocessor directives, operators, literals, and comments. The extension uses semantic highlight to further improve code coloring.
Diagnostics
The extension can show compile time errors or warnings when you open or save a file.
Code completion
The extension provides types, variables, functions, constructors, keywords, modifiers, semantics, attributes, shaders, block statements, preprocessor directives, code snippets, DSHL macros, and HLSL defines using IntelliSense, according to the context. It can also give you a quick summary about the item, and links to the documentation when available.
Signature help
The extension can display a signature helper for functions, and macros.
Document highlights
The extension can highlight all the occurrences of the selected DSHL variable, function, shader, block statement, macro, HLSL variable, function, struct, class, interface, enum, or define in the file.
Hover
The extension can provide useful information if you hover over DSHL variables, functions, shaders, block statements, macros, HLSL variables, functions, structs, classes, interfaces, enums, or defines.
Document symbols
The extension can provide outline information and breadcrumbs about DSHL variables, shaders, block statements, macros, HLSL variables, functions, structs, classes, interfaces, enums, and defines. You can also easily find them by typing a @ into the Command Palette.
The extension can format the whole document, the selected region, or regions.
Inlay hints
The extension can show DSHL function, macro, and HLSL function, define parameters in the source code.
Go to / Peek definitions
You can find (go to / peek) the definition of a DSHL variable, function, shader, block statement, macro, HLSL variable, function, struct, class, interface, enum, define, or to the included file.
Go to / Peek declarations
You can find (go to / peek) the declaration of a DSHL variable, function, shader, block statement, macro, HLSL variable, function, struct, class, interface, enum, define, or to the included file.
Go to / Peek implementations
You can find (go to / peek) the implementation of a DSHL function, shader, block statement, macro, HLSL function, struct, class, interface, enum, define, or to the included file.
Go to / Peek type definition
You can find (go to / peek) the type definition of an HLSL variable.
Type hierarchy
The extension can show the inheritance-tree of HLSL structs, classes, and interfaces.
Rename
The extension can rename DSHL variables, macros, macro parameters, HLSL types, enums, enum members, variables, functions, shaders, blocks, and defines.
Find all references
The extension can find all references of DSHL variables, macros, macro parameters, HLSL types, enums, enum members, variables, functions, shaders, blocks, and defines.
Color picker
The extension can show a color picker for HLSL float3 or float4 variable initializations.
Bracket matching
Auto closing pairs
Surrounding pairs
Folding regions
Indentation
Code snippets
File icons
Configuration
dagorShaderLanguageServer.shaderConfigOverride: Shader configs are .blk files, usually located in the games' prog/shaders folders, and they determine include folders. For example: samples/testGI/prog/shaders/shaders_dx12.blk. If you want to override the extension's automatic shader config selection, provide the shader config's path here. Leaving it empty enables the automatic selection based on game, platform, and driver in launch options.
Issues
If you have any problems or feature request for the extension, feel free to create an issue.
Release Notes
For more information, see the changelog.
1.9.0
- Code completion (for HLSL functions)
- Document highlights (for HLSL functions)
- Hover (for HLSL functions)
- Document symbols (for HLSL functions)
- Inlay hints (for HLSL functions)
- Signature help (for HLSL functions)
- Go to definition (for user HLSL functions)
- Go to declaration (for user HLSL functions)
- Go to implementation (for user HLSL functions)
- Rename (for all language constructs)
- Find all references (for all language constructs)
- Color picker (for HLSL variable initialization)
- Several improvements, and bugfixes
1.8.0
- Code completion (for HLSL struct, class, and enum members)
- Document highlights (for HLSL struct, class, and enum members)
- Hover (for HLSL struct, class, and enum members)
- Go to definition (for HLSL struct, class, and enum members)
- Go to declaration (for HLSL struct, class, and enum members)
- Go to implementation (for HLSL struct, and class members)
- Go to type definition (for HLSL struct, and class members)
- Type hierarchy (for HLSL structs, classes, and interfaces)
- Semantic highlight (for variables and types)
- Several improvements, and bugfixes
1.7.0
- Code completion (for HLSL variables, structs, enums, classes, and interfaces)
- Document highlights (for HLSL variables, structs, enums, classes, and interfaces)
- Hover (for HLSL variables, structs, enums, classes, and interfaces)
- Document symbols (for HLSL variables, structs, enums, classes, and interfaces)
- Go to definition (for HLSL variables, structs, enums, classes, and interfaces)
- Go to declaration (for HLSL variables, structs, enums, classes, and interfaces)
- Go to implementation (for HLSL structs, enums, classes, and interfaces)
- Go to type definition (for HLSL variables)
- Several improvements, and bugfixes
1.6.0 Pre-release
- Code completion (for HLSL variables)
- Document highlights (for HLSL variables)
- Hover (for HLSL variables)
- Document symbols (for HLSL variables)
- Go to definition (for HLSL variables)
- Go to declaration (for HLSL variables)
- Other smaller bugfixes and improvements
1.5.0
- Diagnostics
- Code formatting
- Migrating includes from document links to go to declaration/definition/implementation
- Other smaller improvements
1.4.2 Pre-release
- Migrating includes from document links to go to declaration/definition/implementation
- Other smaller improvements
1.4.1 Pre-release
- Diagnostics
- Other smaller improvements
1.4.0 Pre-release
1.3.0
- Code completion (for DSHL variables, shaders, and block statements)
- Document highlights (for DSHL variables, functions, shaders, and block statements)
- Hover (for DSHL variables, functions, shaders, and block statements)
- Document symbols (for DSHL variables, shaders, and block statements)
- Inlay hints (for DSHL functions)
- Signature help (for DSHL functions)
- Go to definition (for DSHL variables, functions, shaders, and block statements)
- Go to declaration (for DSHL variables, functions, shaders, and block statements)
- Go to implementation (for DSHL functions, shaders, and block statements)
- Adding assume and supports code snippets
- Adding folding ranges based on blocks
- Several improvements, bugfixes and optimizations
1.2.0
- Code completion (for HLSL defines, include statements, DSHL macro parameters)
- Document highlights (for HLSL defines, DSHL macro parameters)
- Hover (for HLSL defines)
- Document symbols (for HLSL defines)
- Inlay hints (for HLSL defines)
- Go to definition (for HLSL defines, DSHL macro parameters)
- Go to declaration (for HLSL defines, DSHL macro parameters)
- Go to implementation (for HLSL defines)
- A context menu item to the shader config files to make shader config overriding easier
- Handling multiple declarations for DSHL macros
- Making DSHL macros hierarchical in the document symbols
- Adding a link to DSHL macro parameters in inlay hints
- Several bugfixes and optimizations
1.1.0
- Code completion (for built-in items, and DSHL macros)
- Signature help (for DSHL macros)
- Document highlights (for DSHL macros)
- Hover (for DSHL macros)
- Document symbols (for DSHL macros)
- Inlay hints (for DSHL macros)
- Go to definition (for DSHL macros)
- Go to declaration (for DSHL macros)
- Go to implementation (for DSHL macros)
- Several bugfixes and optimizations
1.0.0
- Syntax highlight
- Document links
- Comment toggling
- Bracket matching
- Auto closing pairs
- Surrounding pairs
- Folding regions
- Indentation
- Code snippets
- File icons
| |
