{"id":374256,"date":"2023-07-25T14:20:56","date_gmt":"2023-07-25T13:20:56","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=dotnet&p=374256"},"modified":"2023-07-25T14:23:27","modified_gmt":"2023-07-25T13:23:27","slug":"improvements-to-unity-shader-files-in-rider-2023-2","status":"publish","type":"dotnet","link":"https:\/\/blog.jetbrains.com\/zh-hans\/dotnet\/2023\/07\/25\/improvements-to-unity-shader-files-in-rider-2023-2","title":{"rendered":"Improvements to Unity shader files in Rider 2023.2"},"content":{"rendered":"\n

With the release of Rider 2023.2 just around the corner, it\u2019s time to take a look at all the new features we\u2019ve added for Unity shader<\/a> files.<\/p>\n\n\n\n

This release builds on the existing support for ShaderLab .shader<\/code> files as well as Rider\u2019s deep understanding of the HLSL shader language to provide a more productive editing experience<\/strong>. It introduces a wealth of new features like typing assistance, live templates, online help, breadcrumbs, the Structure<\/em> tool window and even Ctrl+Click navigation and renaming of shaders and shader passes.<\/p>\n\n\n\n

Let\u2019s dig in and see what\u2019s new.<\/p>\n\n\n\n\n\n\n\n

Typing Assistance<\/h2>\n\n\n\n

One of the most basic features you\u2019d expect from a smart IDE like Rider is typing assistance<\/strong>, and we\u2019ve made a lot of changes to ShaderLab support to provide this. Simply type an opening {<\/code> brace, and Rider will automatically insert the closing }<\/code> brace. Hit enter inside the braces to insert a new line, with correct auto-indent and formatting. ShaderLab is a very block-oriented language, so this will save you a lot of boilerplate keystrokes!<\/p>\n\n\n\n

Rider now supports completion of block keywords, command keywords, and even command values. Just start typing, and Rider will automatically show a popup<\/strong>.<\/p>\n\n\n\n

\"Completion<\/figure>\n\n\n\n

As you can see in the image above, we\u2019ve also added live templates<\/a>. These allow you to quickly create various properties, as well as more complex shaders that will create a surface shader (surf<\/code>), a vertex and fragment shader (vfshader<\/code>), or \u2013 if you\u2019re already inside a subshader block \u2013 create a new pass (vfpass<\/code>). And once inside a pass, there are a number of templates for creating common Blend<\/code> commands.<\/p>\n\n\n\n

Naturally, the templates are all fully editable, and you can even create your own, specifying the appropriate scope to ensure they only show in the right place.<\/p>\n\n\n\n

\"The<\/figure>\n\n\n\n

Online Help<\/h2>\n\n\n\n

Rider will show you a tooltip for all ShaderLab keywords, with a link to external documentation. This will open the correct page in the locally installed documentation<\/strong>, if available, or a search page on Unity\u2019s help site if not.<\/p>\n\n\n\n

\"A<\/figure>\n\n\n\n

Structure<\/em> Tool Window<\/h2>\n\n\n\n

ShaderLab files can be very large. With the Structure<\/em> tool window<\/a> you can see an overview of your ShaderLab file and quickly navigate around. The block structure of the file is shown as a tree, and clicking a node will take you to the ShaderLab block or command. It will also show you the structure of the embedded HLSL programs.<\/p>\n\n\n\n

\"The<\/figure>\n\n\n\n

To give you a more compact view of where you are in the file, Rider shows the file\u2019s structure in the breadcrumbs control at the bottom of the editor or in the status bar in the new UI<\/a>. Here too, you can simply click the nodes to navigate around the file.<\/p>\n\n\n\n

\"The<\/figure>\n\n\n\n

Shader and Pass Names<\/h2>\n\n\n\n

These are all nice features, but let\u2019s up the ante a little and look at something even smarter!<\/p>\n\n\n\n

Each shader you create has a name, declared in the Shader<\/code> block command at the top of the file. This name can be used in a few places, such as the Fallback<\/code> command. Moreover, you can give each pass a name and use that in the UsePass<\/code> command. Wouldn\u2019t it be great if your IDE could provide completion for these names?<\/p>\n\n\n\n

\"Completion<\/figure>\n\n\n\n

Rider will not only provide completion, it also provides Ctrl+Click <\/em>navigation, Find Usages<\/em>, and rename refactoring. And when you rename a pass, Rider will make sure that UsePass<\/code> refers to it in uppercase, an important ShaderLab requirement.<\/p>\n\n\n\n

Your C# code doesn\u2019t miss out here, either. If you\u2019re using Shader.Find<\/code>, Rider will provide completion of the shader name<\/strong>, with working navigation, Find Usages<\/em>, and rename support.<\/p>\n\n\n\n

\"Completion<\/figure>\n\n\n\n

Rider doesn\u2019t currently show built-in shaders, but we hope to add this in a future release, at which point we can add validation highlighting if the shader doesn\u2019t exist \u2013 a perfect way to help avoid typos.<\/p>\n\n\n\n

HLSL features<\/h2>\n\n\n\n

To round things off, there are also a couple of updates within HLSL blocks and files. Firstly, Rider understands the #pragma surface<\/code> and #pragma vertex<\/code> directives and will resolve the surface or vertex shader method name, making sure you\u2019ve declared it correctly, highlighting it as an error if it can\u2019t be found<\/strong>. If the method name is valid, Rider will provide the usual Ctrl+Click<\/em> navigation, Find Usages<\/em>, and rename support.<\/p>\n\n\n\n

\"Rider<\/figure>\n\n\n\n

And speaking of pragma directives, how does parameter completion sound?<\/p>\n\n\n\n

\"Completion<\/figure>\n\n\n\n

We\u2019ve fixed the IDE\u2019s handling of the Packages<\/code> folder in #include<\/code> statements. Unity treats this as a kind of \u201cvirtual\u201d folder, and you can use it to include files from the Packages<\/code> folder in your project or from packages stored in the package cache. Rider will now do the same and supports completion and Ctrl+Click<\/em> navigation for all files.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

And finally, Rider now understands the UNITY_VERSION<\/code> predefined macro when analysing your HLSL files. If you hover over the macro, you\u2019ll see the current value<\/strong>, based on the version of Unity you\u2019re using.<\/p>\n\n\n\n

\"The<\/figure>\n\n\n\n

We hope you\u2019ll agree that 2023.2 is a great release for Unity shader file support! We\u2019d love to hear what you think. Download Rider 2023.2<\/a>, try it out with your own shaders, and let us know how you get on in the comments below.<\/p>\n","protected":false},"author":96,"featured_media":375489,"comment_status":"closed","ping_status":"closed","template":"","categories":[4992,1401],"tags":[477,1978,2031,3772,1941],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/dotnet\/374256"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/dotnet"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/dotnet"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/96"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=374256"}],"version-history":[{"count":10,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/dotnet\/374256\/revisions"}],"predecessor-version":[{"id":375512,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/dotnet\/374256\/revisions\/375512"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/375489"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=374256"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=374256"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=374256"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=374256"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}