Let’s break down your questions about the surf() function in Unity’s Standard Surface Shader one by one:

When is the surf() function called? #

• The surf() function runs once per pixel that the shader is rendering, during the fragment processing stage of Unity’s rendering pipeline.
• Unity handles the low-level scheduling automatically: it gets triggered after vertex data is transformed and passed into the Input struct (which includes UVs, world position, normal data, etc.), right before Unity applies its built-in lighting calculations using the SurfaceOutputStandard struct.

What’s the purpose of the surf() function? #

This is your dedicated workspace to define the surface properties of your material that drive how it interacts with light. Your main job here is to populate the fields of the inout SurfaceOutputStandard o parameter, which includes key values like:

• Albedo: The base color of the material (what you see under direct light)
• Metallic: How "metal-like" the surface is (0 = non-metal, 1 = pure metal)
• Smoothness: Controls how shiny the surface is (affects specular highlights and reflections)
• Normal: The surface normal (critical for accurate lighting and bump mapping)
• Emission: Self-illuminated color of the material
• Additional properties like Occlusion, Alpha, and more

In short, surf() sets up all the visual characteristics of the material before Unity runs its lighting calculations on it.

Where to find the official language reference? #

You can access the full, official documentation directly within Unity’s ecosystem:

• Open the Unity Editor, then go to Help > Unity Manual or Help > Scripting Reference
• Search for "Surface Shader Examples" or "SurfaceOutputStandard" — the surf() function is thoroughly explained in the Surface Shader section, covering its parameters, execution flow, and practical usage examples.
• Alternatively, create a new Standard Surface Shader (right-click in the Project window > Create > Shader > Standard Surface Shader) — the template includes inline comments that point to relevant docs, and you can access them via the help icons in the shader editor.

内容的提问来源于stack exchange，提问作者Jethro