DSH2xxx --- Lexer and syntax

The block between the generated markers is written by .skill/gen-diagnostics.ps1. Everything below a marker is written by hand and survives a regeneration.

DSH2101

Severity error

Message

Unexpected character '{0}' in source.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:780

Cause. a character that is not part of any DreamShaderLang token: a stray @, $, a backtick, a full-width punctuation mark pasted in from a document, or a non-breaking space that a browser copy left behind. The lexer is deliberately ASCII-only — a Cyrillic а or a full-width Ａ is not an identifier character, because a symbol built from one would look right in the editor and match nothing downstream.

Fix. delete the character. When the message shows a character that looks ordinary, it is almost always the invisible kind: retype the line rather than editing it, or turn on "render whitespace" in the editor. @ inside a /// block is a directive and is fine — this error only fires on code.

Note. the character is still emitted as an Unknown token, so the parser reports what it expected at that spot as well; both messages describe the same typo.

See DreamShaderLang 2.0

DSH2102

Severity error

Message

Unterminated block comment; expected a closing '*/'.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:353

Cause. a /* with no */ after it. Block comments do not nest: the first */ closes the outermost comment, so a commented-out region that itself contains /* ... */ ends early and the tail of the region becomes code — and, more often, a later /* then runs to the end of the file and lands here.

Fix. close the comment. The position reported is the opening /*, not the end of the file: that is the place to look, because the end of the file says nothing about which comment was left open. To comment out a region that already contains block comments, use ///-free // line comments or #if 0 … #endif, which the preprocessor handles.

See DreamShaderLang 2.0

DSH2103

Severity error

Message

Unterminated string literal; expected a closing '"'.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:507

Cause. a " with no closing " before the end of its line. A DreamShaderLang string never spans lines: that is a deliberate limit, and it is what keeps one missing quote from swallowing the rest of the file. Two common shapes reach here — a genuinely forgotten quote, and a path that ends in a backslash ("C:\Assets\"), where the \" is read as an escaped quote and the literal runs on.

Fix. close the string. In a path, use forward slashes ("/Game/Materials/M_A") or double the backslash ("C:\\Assets\\"); DreamShaderLang asset paths are /-separated everywhere.

Note. the text up to the end of the line is still emitted as one string token, so the statement around it is still parsed and any further mistakes in the file are still reported.

See DreamShaderLang 2.0

DSH2104

Severity error

Message

Unknown escape sequence '\{0}' in a string literal.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:487

Cause. a backslash inside a string followed by something other than the six escapes the language knows: \\, \", \n, \r, \t, \0. Nearly always a Windows path written with single backslashes — "D:\new\textures" contains \n and \t (which silently become a newline and a tab) and \x, which lands here.

Fix. double every backslash, or — better — write the path with forward slashes. There are no \x41, \u0041 or octal escapes: a string that needs a character outside the six escapes should carry that character literally (the source is read as UTF-8).

Note. the backslash is kept in the resolved value, so "\q" yields the two characters \q. Nothing is silently lost, and a source that round-trips through the printer comes back unchanged.

See DreamShaderLang 2.0

DSH2105

Severity error

Message

Malformed number literal '{0}'.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:698

Cause. something that starts like a number but is not one. The shapes that reach here:

The last row is the one that surprises people: 2abc is one malformed number token, not 2 followed by the identifier abc. Splitting it would hand the parser a plausible-looking expression and hide the real mistake.

Fix. write the literal the way the language spells it: decimal integers with an optional u/U (unsigned) or l/L (long) suffix, hex as 0x… (integer only), floats with a ., an exponent, or an f/F/h/H suffix. 1.0f, 0x10, 2u, .5, 1e-3 and 2.0h are all valid. When the intent was a member access or a swizzle, put the number in front of the dot: x.5 is a member access, 2.5 is a float.

Note. a malformed literal still produces exactly one token with its value parsed as far as it can be (1e reads as 1), so the surrounding statement is still parsed and the rest of the file still reports its own errors.

See DreamShaderLang 2.0

DSH2106

Severity error

Message

A '#' directive must be the first thing on its line.

Raised by Source/DreamShaderLang/Private/Lang/LangLexer.cpp:382

Cause. a # that is not the first non-whitespace character on its physical line — int a = 1; #pragma x, or a # used as an operator (DreamShaderLang has no #, ## or stringize operator). Leading spaces and tabs are fine; anything else on the line is not, and that includes a comment: /* c */ #pragma x is not a directive line, because the comment is something the lexer has already seen.

Fix. put the directive on a line of its own. If the # was meant as an operator, it is not one — use the DreamShaderLang spelling of whatever was intended (#pragma material(...) for material settings, import "..." or #include "..." for includes).

Note. the # is emitted as an Unknown token and lexing continues on the same line, so the words after it are still lexed normally and any second mistake on that line is still reported.

See DreamShaderLang 2.0

DSH2150

Severity error

Message

Unexpected end of file while parsing {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParser.cpp:246

Cause. the file ended in the middle of something that was not finished: an expression, an argument list, an initializer list, a statement or a block. Almost always an unbalanced {, ( or [ earlier in the file — the parser kept looking for the closer and ran out of text.

Fix. close the construct the message names. When the message says "a block", look for the function whose } is missing; the reported position is the end of the file, not the mistake.

DSH2151

Severity error

Message

Expected an expression, found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:544, Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:631

Cause. a token that cannot begin a value turned up where a value was required: a stray , or ;, a keyword that starts a statement (if, return), a closing bracket, or the leftovers of a line that lost its ; earlier.

Fix. write the missing operand, or delete the stray token. When the token named is a keyword, the previous statement is usually the one missing its ;.

DSH2152

Severity error

Message

Expected ')' to close a cast, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:253, Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:522, Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:620, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:159, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:259, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:294, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:341

Cause. an unbalanced (. The parser read a complete expression and then found something other than the ) it was owed.

Fix. add the ). When the message names an argument list, check for a missing , between two arguments — f(a b) reports this code at b.

DSH2153

Severity error

Message

Expected ']' to close an index, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:325

Cause. an index expression a[… whose ] is missing, or an index that swallowed the ] by starting an expression the author did not intend (a[i, j] — the comma operator is not part of DreamShaderLang, so the , ends the index).

Fix. add the ]. A multi-dimensional index is written a[i][j], never a[i, j].

DSH2154

Severity error

Message

Expected ';' after the 'for' initializer, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:223, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:244, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:346, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:372, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:387, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:401, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:415, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:464, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:600

Cause. a statement that does not end with ;. Unlike 1.x, the 2.0 grammar has no newline-terminated statement form: every statement ends with ; or a }.

Fix. add the ;. The reported position is the FIRST token of the next line, so the mistake is on the line above the one the message points at.

Recovery. the statement that lost its ; is dropped together with the tokens up to the next ;, and the block keeps parsing — one missing semicolon costs one statement, not the rest of the function.

DSH2155

Severity error

Message

Expected '}' to close an initializer list, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:672

Cause. a { … } initializer whose } is missing, or an element that is not an expression (a ; inside the braces, for instance).

Fix. close the list. Elements are separated by , and a trailing , before the } is allowed; nested lists are written { { 1, 2 }, { 3, 4 } }.

DSH2157

Severity error

Message

Expected '(' after 'if', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:148, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:193, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:283, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:330

Cause. a control-flow keyword whose parenthesised header is missing. In DreamShaderLang, as in HLSL, the condition of if, for, while and do … while is always parenthesised.

Fix. write if (cond), for (init; cond; step), while (cond), do … while (cond);.

DSH2158

Severity error

Message

A positional argument cannot follow a named argument; give this argument a name too.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:603

Cause. a call that mixes the two argument forms in the wrong order — Fn(A = 1, x). A named argument binds a pin by name, so once one argument is named the position of the following ones carries no information the reader can trust.

Fix. name the remaining arguments (Fn(A = 1, B = x)), or move the named ones to the end (Fn(x, A = 1), which is legal). An argument that is genuinely an assignment is written in parentheses: Fn((a = b), c).

DSH2159

Severity error

Message

Expected ':' to complete the conditional operator, found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:153

Cause. a ? without its :. Usually a : typed as something else, or a conditional whose middle operand ran past the : because a bracket inside it is unbalanced.

Fix. write cond ? a : b. The operator is right-associative, so a chain needs no parentheses: a ? b : c ? d : e means a ? b : (c ? d : e).

DSH2160

Severity error

Message

Unsupported statement: the preprocessor line '#{0}' cannot appear inside a function body; mark the function /// @custom to hand its body to the shader compiler.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:134, Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:442

Message (statement) Unsupported statement '{0}': DreamShaderLang 2.0 has no switch statement, write if / else if instead.

Message (directive) Unsupported statement: the preprocessor line '#{0}' cannot appear inside a function body; mark the function /// @custom to hand its body to the shader compiler.

Cause. switch, case or default at statement level, or a # line inside a parsed function body. Neither is part of the language: 2.0 lowers a function body to a material graph, and a graph has no jump table; a # line should have been consumed by the preprocessor before the parser saw it.

Fix. rewrite a switch as an if / else if chain. For a # line, either move it to file scope (#pragma, #include are declarations, not statements) or, when the body really is HLSL, mark the function /// @custom — its body is then captured verbatim and handed to the shader compiler untouched.

DSH2161

Severity error

Message

Expected a member or swizzle name after '.', found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:295

Cause. a . that is not followed by an identifier: a number (v.1), a keyword, or a . that was meant to be part of a float literal (1 .5).

Fix. write the member or swizzle name. Swizzles are ordinary member accesses to the parser, so v.xy, v.rgb and Struct.Field all take the same form.

DSH2162

Severity error

Message

An initializer list is only allowed as a variable initializer, not as a general expression.

Raised by Source/DreamShaderLang/Private/Lang/LangParserExpressions.cpp:536

Cause. a { … } used as a value — as a call argument, in a return, or on the right of an operator. In HLSL, as in C, a brace list is a syntactic form of an initializer, not an expression with a type.

Fix. declare a variable and pass that, or use a constructor: float3(1, 2, 3) instead of { 1, 2, 3 }.

DSH2163

Severity error

Message

Expected a variable name, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:572

Cause. a declaration whose declarator has no name: a doubled , (float a,, b;), a , before the = (float a, = 1;), or a type spelling that was actually meant to be a variable and shadowed the name.

Fix. write the name. Every declarator of a declaration is Name, Name[dims], Name = init or Name[dims] = init.

DSH2164

Severity error

Message

Expected 'while' after the body of a 'do' statement, found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:324

Cause. a do whose while is missing or misspelled.

Fix. write do { … } while (cond); — the trailing ; is part of the statement and its absence is DSH2154, not this code.

DSH2165

Severity error

Message

Expected '{' to open a block, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserStatements.cpp:479

Cause. a block was required and something else was found. This is reachable only when a caller asks for a block without checking first — a function body whose { is missing reports it.

Fix. open the block with {. An extern function has no body at all and ends with ;; a /// @custom function still needs its braces, the parser simply does not read inside them.

DSH2200

Severity error

Message

(built at runtime)

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:550

Cause. A 1.x Graph expression used a comparison, a logical operator or ?: outside an if condition. The 1.x expression reader knew + - * /, calls and members; at anything else it stopped and used what it had read so far, so a < b ? x : y silently became a. The legacy front end refuses the text instead of reproducing that.

Fix. Put the choice in an if / else (1.x compares there), or use a node such as UE.If(...); or move the code to a .dss file, where these operators exist.

DSH2201

Severity error

Message

(built at runtime)

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:546

Cause. A 1.x Graph expression used %, a shift or a bitwise operator. 1.x had none of them: it stopped reading at the operator and silently dropped the rest of the expression.

Fix. Use fmod(a, b) for a remainder; for anything bitwise, move the code into a Function (HLSL) or to a .dss file.

DSH2202

Severity error

Message

Expected no '[ ]' in a 1.x Graph expression, found '{0}', where 1.x silently dropped the index and everything after it; use a swizzle such as '.r' or move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:392

Cause. A 1.x Graph expression indexed a value with [ ]. 1.x dropped the index and everything after it without a word, so the graph never did what the text says.

Fix. Take a component with a swizzle (.r, .xy); to read an output of a node by number write OutputIndex = k in the call. Real indexing needs a .dss file.

DSH2203

Severity error

Message

Expected a constructor such as 'float3(x)' in a 1.x Graph expression, found the cast '({0})', which 1.x never had; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:502

Cause. A C-style cast such as (float3)x stands in a 1.x Graph expression. 1.x had constructors only.

Fix. Write the constructor, float3(x), or move the code to a .dss file.

DSH2204

Severity error

Message

Expected an assignment only as a whole 1.x Graph statement, found one inside an expression; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:513

Cause. An assignment was used as a value inside a 1.x Graph expression (a = (b = c), or an assignment as a call argument). In 1.x an assignment is a whole statement.

Fix. Split it into two statements, or move the code to a .dss file.

DSH2205

Severity error

Message

Expected '=' in a 1.x Graph assignment, found '{0}', which 1.x read as the declaration of a variable named '{1}'; write 'x = x + y' or move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:316

Cause. A compound assignment (+=, *=, ...) stands in a 1.x Graph body. 1.x did not know these operators: it read x += y as the declaration of a variable, with x as its type, and failed much later or not at all.

Fix. Write it out: x = x + y;. Compound assignment exists in a .dss file.

DSH2206

Severity error

Message

Expected a variable or 'variable.member' on the left of a 1.x Graph assignment, found '{0}'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:341

Cause. The left side of a 1.x Graph assignment is neither a variable nor variable.member. 1.x could assign to a local, an output, or one member of Base / a material variable, and to nothing else (not to a swizzle of a swizzle, an index or a call result).

Fix. Assign to a plain variable and combine the parts with a constructor on the right-hand side.

DSH2207

Severity error

Message

Expected no '++' or '--' in a 1.x Graph expression, found '{0}'; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:444

Cause. ++ or -- stands in a 1.x Graph expression. 1.x had no such operators and no loops to use them in.

Fix. Write x = x + 1.0;, or move the code to a .dss file.

DSH2208

Severity error

Message

Expected a declaration, an assignment, a call or 'if' in a 1.x Graph body, found '{0}', which 1.x did not have; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:227

Cause. A statement 1.x never had opens this line of a Graph body: for, while, do, return, break, continue or discard. A 1.x Graph body is declarations, assignments, calls and if / else. (switch is refused one step earlier, by the parser, as DSH2160.)

Fix. Move loops and early exits into a Function (HLSL), or migrate the file and write them in the .dss.

DSH2209

Severity error

Message

Expected braces around the body of a 1.x Graph 'if', found a single statement.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:256, Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:281

Cause. The body of a 1.x Graph if or else is a single statement without braces, and 1.x required them.

Fix. Put { } around the body, even when it is one statement.

DSH2210

Severity error

Message

Expected at most one comparison in a 1.x Graph 'if' condition, found '{0}' as well, where 1.x silently dropped the rest of the condition; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:298

Cause. A 1.x Graph if condition holds more than one comparison (a > b && c < d). 1.x read the first comparison and silently dropped the rest, so the branch was taken on half of the condition.

Fix. Nest two ifs, or compute the combined mask first and compare that; && and || work in a .dss file.

DSH2211

Severity error

Message

Expected a call or an assignment as a 1.x Graph statement, found an expression whose value is never used.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:150

Cause. A 1.x Graph statement is an expression whose value goes nowhere, such as a + b;. It builds nodes nothing reads, which is almost always a lost assignment.

Fix. Assign the value to a variable or an output, or delete the line.

DSH2212

Severity error

Message

Expected no storage keyword on a 1.x Graph variable, found '{0}'; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:96

Cause. A storage keyword (static, const, uniform) stands on a variable inside a 1.x Graph body. 1.x locals had none; constants and parameters live in Properties.

Fix. Remove the keyword, or declare the value in Properties. A .dss file has const locals.

DSH2213

Severity error

Message

Expected a single value in a 1.x Graph declaration, found the array declarator '{0}'; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:108

Cause. A 1.x Graph variable is declared as an array. The 1.x graph had no array values.

Fix. Use separate variables, or move the code to a .dss file or into a Function.

DSH2214

Severity error

Message

Expected an expression as a 1.x Graph initializer, found an initializer list; use a constructor such as 'float3(a, b, c)'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:522

Cause. A braced list stands where 1.x did not read one: inside another list. 1.x accepted T x = {a, b, c}; as the constructor T(a, b, c) and T x = {}; as zero, in a declaration, where the type is written next to it; a list nested in that list has no type to construct. (A list as the value of an assignment or as an argument is refused earlier, by the parser, as DSH2162.)

Fix. Write the constructor: float3(a, b, c).

DSH2215

Severity error

Message

Expected an initializer on the 1.x Graph variable '{0}' of type '{1}', found none, and 1.x had no zero value for that type.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:1165

Cause. A 1.x Graph variable has no initializer and a type 1.x had no zero for: a texture, a Substrate value or a sampler. Numbers start as zero and a MaterialAttributes as an empty set.

Fix. Give the variable an initializer.

DSH2216

Severity error

Message

Expected a name after '#Region', found none.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:1023

Cause. #Region has no name after it. The name is the title of the comment box the region becomes in the graph.

Fix. Write #Region "Name".

DSH2217

Severity error

Message

Expected a '#Region' before this '#EndRegion', found none open.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:171

Cause. An #EndRegion has no #Region open before it in this Graph body.

Fix. Remove it, or add the #Region "Name" it was meant to close.

DSH2218

Severity error

Message

Expected '#EndRegion' to close the region '{0}' before the end of the Graph body, found none.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:65

Cause. A #Region is still open where the Graph body ends.

Fix. Close it with #EndRegion before the body's }.

DSH2219

Severity error

Message

Expected '#Region' or '#EndRegion' as the only '#' line in a 1.x Graph body, found '#{0}'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:1007

Cause. A # line other than #Region / #EndRegion stands inside a 1.x Graph body. Conditional compilation (#if ...) is resolved before the parser runs. In a .dsm / .dsf the preprocessor refuses a directive it does not know before the parser sees it (DSH1035); this code is what a 1.x Graph body in a .dsh gets, where #pragma and #include pass the preprocessor because the header may hold 2.0 declarations too.

Fix. Move import lines to the top of the file; #pragma belongs in a .dss file.

DSH2220

Severity error

Message

Expected no bare block in a 1.x Graph body, found one; 1.x has blocks only after 'if' and 'else'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:191

Cause. A bare { ... } block stands in a 1.x Graph body. 1.x had blocks only after if and else, and its variables were all of one scope, so a block of its own meant nothing.

Fix. Remove the braces.

DSH2222

Severity error

Message

Expected a decimal number in a 1.x Graph expression, found the hexadecimal literal '{0}', which 1.x read as 0 followed by a name; move this code to a .dss file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyStatements.cpp:364

Cause. A hexadecimal literal stands in a 1.x Graph expression. The 1.x number reader stopped after the 0 and read x1F as a name, so the value was silently 0.

Fix. Write the number in decimal.

DSH2240

Severity error

Message

Expected a top-level Shader, ShaderFunction, ShaderLayer, ShaderLayerBlend, Function, GraphFunction, Namespace, VirtualFunction or import, found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:506

Cause. Something other than a 1.x block opens a declaration at the top of a .dsm / .dsf file, or of a 1.x part of a .dsh.

Fix. A 1.x file is a list of Shader, ShaderFunction, ShaderLayer, ShaderLayerBlend, Function, GraphFunction, Namespace, VirtualFunction blocks and import lines. Check for a stray token or an unclosed block above this line.

DSH2241

Severity error

Message

Expected '(' with the block's attributes, such as '(Name = "M_Example")', found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:555

Cause. A block word is not followed by its attribute list. Every 1.x block says at least its name there.

Fix. Write Shader(Name = "M_Example") and open the body with { after it.

DSH2242

Severity error

Message

Expected a 'Name = "..."' attribute on '{0}', found none.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:776

Cause. The block has an attribute list and no Name in it. The name is the asset the block builds (or, for a VirtualFunction, the name calls use).

Fix. Add Name = "...".

DSH2243

Severity error

Message

Expected an attribute name such as 'Name', found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:574, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:583, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:594, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:645

Cause. The attribute list of a block is not Key = value pairs separated by commas: a key is missing, the = is, or the value is not a string, a word or a number. A comma right before the ) is fine, as it was in 1.x; two commas in a row are not.

Fix. Write each attribute as Key = "value".

DSH2244

Severity warning

Message

The attribute '{0}' is written twice; the later value wins, as it did in 1.x.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:622

Cause. One attribute is written twice in a block's attribute list. 1.x kept the later value, and so does this front end; the warning is there because the first value is dead text.

Fix. Remove one of them.

DSH2245

Severity error

Message

Expected a Shader section (Properties, Settings, Outputs, Graph or Layout), found '{0}'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2659, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:996

Cause. A word that is no section opens a line inside a block. A Shader has Properties, Settings, Outputs, Graph and Layout; a ShaderFunction, layer or blend has Inputs as well, and takes Results for Outputs; a VirtualFunction has Options, Inputs and Outputs. Code is DSH2246.

Fix. Check the spelling — section names are matched ignoring case, as in 1.x, so it is the letters that are wrong — and that the section before it is closed.

DSH2246

Severity error

Message

Expected 'Graph' as the body section of '{0}', found 'Code', which 1.x accepted only inside a Function.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:988

Cause. A Shader or ShaderFunction block has a Code section. 1.x read Code only inside a Function; in an asset block the body is Graph.

Fix. Rename the section to Graph, or move the HLSL into a Function and call it.

DSH2247

Severity error

Message

Expected no body in the VirtualFunction '{0}', which declares an existing asset, found the section '{1}'.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2651

Cause. A VirtualFunction has a Graph or Code section. A VirtualFunction declares the interface of an asset that already exists; it builds nothing.

Fix. Remove the body, or make the block a ShaderFunction if the source is meant to build the asset.

DSH2248

Severity error

Message

Expected a 1.x block in a '.{0}' file, found {1}, which is 2.0 syntax; 2.0 declarations belong in a .dss file or a .dsh header.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:497

Cause. 2.0 syntax (a uniform, an export function, a #pragma) stands in a .dsm or .dsf file, which is read by the 1.x front end only.

Fix. Put 2.0 declarations in a .dss file, or in a .dsh header, which takes both dialects. dsc migrate rewrites a whole 1.x file.

DSH2249

Severity error

Message

Expected only Function, GraphFunction, Namespace and VirtualFunction blocks in a '.dsh' header, found the asset block '{0}', which belongs in a .dsm or .dsf file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:520, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:722

Cause. A .dsh header holds a block that builds an asset (Shader, ShaderFunction, a layer). A header is included into other files; an asset block in it would be built once per including file.

Fix. Move the block into a .dsm / .dsf of its own and keep functions and VirtualFunctions in the header.

DSH2250

Severity error

Message

Expected one Shader block in a file, found a second one.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:750

Cause. A file holds two Shader blocks. A material source is one material.

Fix. Give each material its own file.

DSH2251

Severity warning

Message

'{0}' is the old spelling of '{1}'; it still reads the same.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:740

Cause. A block word of an earlier 1.x release is used (MaterialLayer for ShaderLayer, MaterialLayerBlend for ShaderLayerBlend). It reads the same.

Fix. Nothing has to change; dsc migrate writes the current form.

DSH2252

Severity error

Message

Expected a double-quoted path after 'import', found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:380, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:392, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:409

Cause. An import line the front end does not read. Three cases: import is not followed by a quoted path ("...", or '...' on one line, which a 1.x file and a .dsh still take); the path names a .dsf or a .dsm -- a material or function file is compiled on its own, never included; or the path is root-qualified (Project:Shared/Common.dsh, Plugin.X:...), the 1.6.0 form, which an import no longer takes.

Fix. Write import "Shared/Common.dsh"; with a path relative to this file or to its own source root. A header that lives in another root is reached with a /-anchored path, import "/Shared/Common.dsh";, which looks in this file's root first and then in every other root -- or by copying it, or through a package. See import.

DSH2253

Severity warning

Message

'{0}' is read as 'import'; write it in lower case.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:371

Cause. Import (or another casing) is used for import. 1.x matched the word loosely.

Fix. Write import in lower case.

DSH2254

Severity error

Message

Expected a top-level Shader, ShaderFunction, ShaderLayer, ShaderLayerBlend, Function, GraphFunction, Namespace or VirtualFunction block in this 1.x file, found none.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:309

Cause. The file has no block at all: it is empty, everything in it is commented out, or an #if removed it.

Fix. A .dsm needs a Shader, a .dsf a ShaderFunction, ShaderLayer or ShaderLayerBlend. Delete the file if it is a leftover.

DSH2255

Severity error

Message

Expected a Graph section in the Shader '{0}', found none.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:1042

Cause. A Shader has no Graph section and nothing in its Outputs section either, so there is nothing to build. Without a Graph, the Outputs statements have to compute the values themselves: an initialized declaration, or a binding whose right side is an expression.

Fix. Add Graph = { ... }.

DSH2256

Severity warning

Message

The Shader '{0}' has no Outputs section, so nothing its Graph computes reaches the material.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:1049

Cause. A Shader has a Graph and no Outputs section, so no value reaches a material attribute. The material builds, with nothing wired to it.

Fix. Add Outputs = { ... } with at least one Base.<Attribute> = <variable>; binding.

DSH2257

Severity error

Message

Expected '`{' to open the '{0}' block, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2455, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2569, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2608, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:2625, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:809, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:882, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:899

Cause. A block is not opened where one has to be: the attribute list of a Shader, ShaderFunction, Namespace or VirtualFunction is not followed by {, a section name (Properties, Graph, Inputs, ...) is missing inside the block, or the section name is not followed by {.

Fix. Open the body with { on the same line or the next, and start each section with its name.

DSH2258

Severity warning

Message

The section '{0}' is written twice; the later one wins, as it did in 1.x.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:962, Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:976

Cause. One section is written twice in a block. 1.x kept the later one and dropped the first silently; this front end does the same and says so.

Fix. Merge the two sections into one.

DSH2259

Severity error

Message

Expected ShaderFunction, ShaderLayer and ShaderLayerBlend blocks in a '.dsf' file, found a Shader block, which belongs in a .dsm file.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:758

Cause. A .dsf holds a Shader block. A .dsf builds function assets -- ShaderFunction, ShaderLayer, ShaderLayerBlend -- and a material belongs in a .dsm. 1.x refused it too, when it generated the file. The block is skipped; the rest of the file is still read.

Fix. Move the Shader block into a .dsm. A .dsm may keep ShaderFunction and layer blocks beside its Shader, so moving the whole file to .dsm works as well.

DSH2260

Severity warning

Message

'{0}' is not a value of NoGeneration, which is true or false; the block is built as if it were false.

Raised by Source/DreamShaderLang/Private/Lang/LangLegacyParser.cpp:798

Cause. A 1.x block's NoGeneration = (after 2.1.2) holds something other than true, false, 1 or 0. The block is built as if it said false. See NoGeneration.

Fix. Write NoGeneration = true, or remove the key.

DSH2300

Severity error

Message

Expected '`{' to open the block of pass '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:240

Cause. The head of a pass, pass <Name> : <kind>, is not followed by the { that opens its block. A pass has no argument list -- its settings are statements inside the braces, unlike a buffer's (Key = Value) list -- so pass Blur : compute(Injection = AfterOpaque) is this error, at the (. Other shapes: a ; or a second word after the kind (pass Blur : compute fullscreen), and a { left out altogether, when the message names the first setting of the block.

Fix. Open the block right after the kind, on the same line or the next, with every setting inside it:

pass Blur : compute
{
    Injection = AfterOpaque;
    Shader    = "BoxBlur.usf";
    Entry     = BlurCS;
    write Result = Blurred;
}

Without the {, the lines of the block are read as file-scope declarations and its } as a stray one, so more errors follow (DSH3205, DSH3222 for a Shader = line, DSH3200); they are this mistake and go away with it.

DSH2301

Severity error

Message

Expected a setting ('Key = Value;'), a 'read', 'write' or 'param' line or an 'hlsl' block in a pass block, found {0}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:334

Cause. A statement in a pass block starts with something no statement starts with. A pass holds settings (Key = Value;) and read, write and param lines, all of which start with a name; this is a keyword, a number, a string or a punctuation mark instead. Typical shapes: HLSL habits such as in Source = Mask; or out Result = Blurred; (in and out are keywords), a uniform or static const declaration written inside the pass, a value without its key ("M_Mask";), and a doubled ; -- a pass block has no empty statement. A uniform line can also mean that the } of the pass above it is missing.

Fix. Write the line as a setting or a binding -- read Source = Mask;, write Result = Blurred;, Material = "M_Mask"; -- and delete a stray ;. Declarations go at file scope, above the passes, and a pass takes their values with param:

uniform float BlurRadius = 3.0;

pass Blur : compute
{
    ...
    param Radius = BlurRadius;
}

DSH2302

Severity error

Message

Expected '=' after the key '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:447

Cause. A pass statement starts with a name that is not a binding word, so it is read as a setting, Key = Value;, and the = is not there. The usual shapes:

• a missing or mistyped =: Injection AfterOpaque;, Injection: AfterOpaque;, Material("M_Mask");;
• a binding word in the wrong case: Read Mask;, Write SceneColor; -- read, write and param are lower case, setting keys start with a capital;
• a buffer with no binding word: Mask; for read Mask;;
• a declaration inside the block: float Radius = 2;.

read, write and param themselves always start a binding, whatever follows them, so a binding word with no name after it (read;, read "Mask";, param = 3;) is DSH2304 or DSH2306, not this.

Fix. Give a setting its =, and a binding its lower-case word and a name. A value the pass needs from the pipeline is a file-scope uniform or static const, handed in with param Radius = BlurRadius;.

DSH2303

Severity error

Message

Expected ';' at the end of the pass statement, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:458

Cause. A complete pass statement is not followed by ;. Most often the ; is missing at the end of a line, and the message points at the first token of the next one -- the mistake is on the line above. Other shapes: two bindings in one statement (read A, B;), something after the buffer (read Source = Mask[0];, read Mask.Previous.r;), and two settings joined by a comma (Shader = "Blur.usf", Entry = BlurCS;).

Fix. End every setting and binding with ;, and bind one buffer per statement: read A; read B;, not read A, B;. A channel is picked in the shader or the material, not in the binding. When the ; was missing, recovery skipped the next statement as well, so a mistake in that one shows only once this is fixed.

DSH2304

Severity error

Message

Expected a buffer after '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:374, Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:384

Cause. A read or write binding has no buffer where one belongs. read and write at the start of a statement always begin a binding, whatever follows them, so the word with no name after it -- read;, write;, read "Mask"; -- is this error, as Expected a buffer after 'read', .... So is a binding that names its slot and = and then no buffer -- read Source = "Mask";, read Source = ;, write Result = (Blurred); -- as Expected a buffer after 'read Source =', .... A buffer is a bare name -- a buffer of this pipeline or a built-in texture such as SceneColor -- never a string or an expression.

Fix. Name the buffer: read Source = Mask;, write Result = Blurred;. When the name inside the pass is the buffer's own, leave it out: read Mask;.

DSH2305

Severity error

Message

'{0}.{1}': the one thing a buffer has after '.' is 'Previous', last frame's contents of a 'History = true' buffer.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:402, Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:408

Cause. A read or write binding has a . after its buffer, and what follows is not Previous spelt exactly so: read Mask.previous;, read Blurred.r; (a channel), read Wind.Last;. A buffer has no members and no swizzles; .Previous -- last frame's contents of a History = true buffer -- is the one thing a binding can name after it. A . with no name after it is this code too, as Expected 'Previous' after '.', found ....

Fix. Bind the buffer itself and take the channel where it is sampled: read Blurred;, then .r in the shader or the material. For last frame's contents write read Prev = Wind.Previous; and declare Wind with History = true (DSH4415 otherwise). Only a read may name .Previous; a write of one is DSH7318.

DSH2306

Severity error

Message

Expected a parameter name after 'param', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:426

Cause. param is not followed by the name of the value inside the pass -- the material parameter or the HLSL name it sets. param at the start of a statement always begins a binding, whatever follows it, so the name left out (param = 3;), nothing after the word (param;) and a quoted name (param "Radius" = 3;) are all this error; none of them is read as a setting.

Fix. Write param <Name> = <expression>;, as in param Radius = OutlineWidth * 2;. The name is the pass's: a parameter of the pass's material, or the macro its .usf reads.

DSH2307

Severity error

Message

Expected '=' after 'param {0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:430

Cause. A param binding names its target and then has no =: param Radius OutlineWidth;, param Radius: OutlineWidth;, param Radius(OutlineWidth); or param Radius == OutlineWidth;.

Fix. Write param <Name> = <expression>;. The expression is computed on the CPU once per view: a uniform, a static const, a literal or DreamPassWeight, times and plus constants, as in param Radius = OutlineWidth * 2 + 1;.

DSH2308

Severity error

Message

Expected a key such as 'Scale' in the arguments of buffer '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:147

Cause. A buffer's argument list has something other than a key where an argument starts: a value without its key (R8(0) for a clear value), a quoted key (R8("Clear" = 0)), a trailing comma (R8(Clear = 0, )), or a vector written without its constructor, whose second number then stands where a key should (Size = 256, 256).

Fix. Name every argument and give vectors their constructor:

buffer Wind : RG16F(Size = int2(256, 256), History = true, Clear = 0);

The keys are Scale, Size, Resolution, Clear, Mips, History and Export.

DSH2309

Severity error

Message

Expected '=' after '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:151

Cause. A key in a buffer's argument list is not followed by =: a key written alone as if it were a flag (R8(History), RGBA16F(Export, Scale = 0.5)), or a : where the = goes (R8(Clear: 0)).

Fix. Give every key its value: History = true, Export = true, Clear = 0. A buffer has no bare flags.

DSH2310

Severity error

Message

Expected ',' or ')' in the arguments of buffer '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:171

Cause. A Key = Value in a buffer's argument list is followed by neither , nor ): two arguments without a comma between them (R8(Clear = 0 Scale = 0.5)), a ; used as the separator, or a list that is never closed (R8(Clear = 0;).

Fix. Separate the arguments with , and close the list before the ;: buffer Mask : R8(Clear = 0, Scale = 0.5);.

DSH2311

Severity error

Message

Expected ';' after the declaration of buffer '{0}', found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:184

Cause. A buffer declaration does not end with ; after its format or its argument list. Usually the ; is missing and the message points at the next declaration; other shapes are arguments without their parentheses (buffer Mask : R8 Clear = 0;), two buffers in one declaration (buffer Mask : R8, Edge : R8;), and braces where the argument list goes (buffer Mask : R8 { Clear = 0; }).

Fix. One buffer per declaration, its arguments in parentheses, a ; at the end:

buffer Mask : R8(Clear = 0);
buffer Edge : R8;

DSH2312

Severity error

Message

The line '#{0}' cannot appear inside a pass block; a pass holds settings, 'read', 'write' and 'param' lines and an 'hlsl' block, where HLSL's own '#' lines go.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:322

Cause. A #pragma or #include line stands inside a pass's braces. The preprocessor's own lines -- #if, #ifdef, #else, #endif, #define -- are resolved before the parser runs and may stand there, but #pragma and #include are file-scope declarations and reach the parser as written: #pragma region around a group of settings, a #pragma pipeline(...) that slipped into the first pass, an #include meant for the pass's shader. The error costs only that line: the statement after it is parsed as usual, so a mistake in it is reported in the same run.

Fix. Move a #pragma pipeline(...) to file scope, above the passes. Drop #pragma region: a .dsp ignores it at file scope too (DSH3315), and // comments group lines as well. An #include belongs in the HLSL the pass runs: its hlsl block, or its .usf. Inside an hlsl block every # line is HLSL's, passed to the shader compiler as written.

DSH2313

Severity error

Message

Expected '{' after 'hlsl' to open a block of HLSL, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserDeclarations.cpp:996

Cause. In a .dsp, hlsl opens a block of HLSL -- a pass's code, or the file's shared code -- and the next thing after it is not a {. Wherever a declaration or a pass statement starts in a .dsp, hlsl is that word and nothing else, so it is no name there.

Fix. Write the block: hlsl { ... }, the { on the same line or the next. Outside a .dsp hlsl is an ordinary name.

DSH2314

Severity error

Message

Expected '`}' to close pass '{0}' before the next declaration, found {1}.

Raised by Source/DreamShaderLang/Private/Lang/LangParserPipeline.cpp:269

Cause. A pass block is not closed, and a buffer or pass declaration starts a line inside it. The parser ends the open pass there, with the statements read so far, so the declaration below still parses. The same missing } reads differently when something else comes next: at the end of the file it is DSH2150, before a uniform or static const line DSH2301, before a #pragma line DSH2312.

Fix. Add the } that closes the pass above the line the message points at.