Agent Skills › ProwlEngine/Prowl › prowl-rendering

prowl-rendering

GitHub

提供Prowl引擎渲染相关技能的参考,涵盖材质、着色器、相机设置、光照及后处理效果。指导用户进行线性色彩管理、Shader属性配置、Camera参数调整及粒子特效添加,适用于游戏画面开发。

Prowl.Editor/Resources/Agent/Skills/prowl-rendering/SKILL.md ProwlEngine/Prowl

触发场景

创建或编辑材质和着色器 设置相机视野和裁剪平面 添加光照、雾效或天空盒 配置后处理和粒子特效

安装

npx skills add ProwlEngine/Prowl --skill prowl-rendering -g -y
更多选项

非标准路径

npx skills add https://github.com/ProwlEngine/Prowl/tree/main/Prowl.Editor/Resources/Agent/Skills/prowl-rendering -g -y

不安装直接使用

npx skills use ProwlEngine/Prowl@prowl-rendering

指定 Agent (Claude Code)

npx skills add ProwlEngine/Prowl --skill prowl-rendering -a claude-code -g -y

安装 repo 全部 skill

npx skills add ProwlEngine/Prowl --all -g -y

预览 repo 内 skill

npx skills add ProwlEngine/Prowl --list

SKILL.md

Frontmatter
{
    "name": "prowl-rendering",
    "description": "Materials, shaders, cameras, lights and effects in Prowl. Use when creating or editing materials, picking shaders, setting up cameras (field of view, clip planes, a weapon viewmodel camera), adding post processing, lights, fog, skybox, lightmap bakes, or particle effects such as muzzle flashes."
}

Prowl rendering

Materials

Colour values are linear, in materials and lights alike. Textures are decoded from sRGB, but a colour you type is used as is, so a colour picked in an image editor comes out too bright and washed out. Convert it first, roughly value ^ 2.2: sRGB 0.5 grey is linear 0.21.

The built in Standard shader uses these property names. material <ref> lists the real ones for any shader.

Property Meaning
_MainTex, _MainColor albedo texture and tint
_NormalTex, _NormalScale normal map
_SurfaceTex G is roughness, B is metallic
_Roughness, _Metallic multipliers on the surface texture
_OcclusionTex ambient occlusion in R
_EmissionTex, _EmissiveColor, _EmissionIntensity emission
_Tiling, _Offset UV tiling and offset

Metallic and emission do nothing on their own. The shader multiplies them by a texture: metallic is _SurfaceTex.b * _Metallic, and the default surface texture has a blue of 0. Emission is _EmissionTex * _EmissiveColor * _EmissionIntensity, and the default emission texture is black. Assign a surface or emission texture (a white texture works for emission) before those values show. _Roughness works without a texture and defaults to 1, fully rough.

  • From the CLI: material Materials/Metal.mat --values '{"_MainColor": [0.8, 0.8, 0.8, 1], "_EmissionTex": "Textures/White.png", "_EmissiveColor": [1, 0.5, 0, 1], "_EmissionIntensity": 4}'.
  • In code: material.SetColor, SetFloat, SetTexture, SetVector.
  • Shader variants are separate shaders: Shader.LoadDefault(DefaultShader.StandardTransparent), also StandardCutout, StandardDoubleSided and others. There is no Shader.Find.
  • There is no MaterialPropertyBlock. For a per object colour, Clone() the material and assign the copy. Dispose clones you no longer need. Changing a shared material asset changes every object using it.
  • .shader files have their own format with GLSL bodies. Start from an existing shader or the editor's create menu, not from Unity ShaderLab.

Cameras

  • A newly added Camera component has FarClipPlane 100, FieldOfView 60, no Profile and AntiAliasing None. The default scene's Main Camera is the same.
  • Camera.Main is the enabled camera with the highest Depth that draws to the screen.
  • Anti aliasing is a camera field, not an effect: camera.AntiAliasing = AntiAliasingMode.FXAA (also SMAA, TAA), tuned through camera.Fxaa, camera.Smaa and camera.Taa.
  • camera.HDR (on by default) renders into float colour, which the Tonemapping volume component maps to the display. Without one, or with Mode None, light above 1 clips. Cameras made by a new scene or GameObject > Camera start with VolumeProfile.CreateCameraDefault(name), a profile with Tonemapping set to AgXPunchy. A camera added with AddComponent<Camera>() has no profile, so give it that one.
  • Post processing comes from volume profiles. A VolumeProfile holds volume components from Prowl.Runtime.Rendering: Tonemapping, Bloom, AutoExposure, AmbientOcclusion, ScreenSpaceReflections, MotionBlur, DepthOfField, GodRays, Vignette, ChromaticAberration, FilmGrain, ColorGrading, ColorLookup, Sharpen, EdgeDetection, Pixelation, VolumetricFog. The camera's own Profile applies under every Volume component in the scene. A Volume is global by default, or set IsGlobal = false and a Size to apply it only inside a box.
  • Each setting is a VolumeParameter and only counts once overridden. Use .Set(value) to set and override it in one go, or Add<T>(overrideAll: true).
  • Bloom is off until Intensity is above 0. Threshold defaults to 1.2, so mostly emissive and very bright surfaces bloom. Lower it to make lit surfaces glow too. Tonemapping.Mode is a TonemappingMode: None, ACES, AgXNeutral, AgXPunchy, Reinhard, RomBinDaHouse or Uncharted2. AgXNeutral is a soft filmic curve that desaturates bright colours, AgXPunchy adds contrast and saturation, and ACES keeps colours punchier still.
  • A custom tonemapper is a PostEffect whose Stage is PostEffectStage.Tonemap. Its shader maps linear HDR light to linear 0 to 1 in outColor, Prowl clamps and encodes it for the display, and it takes the place of the Tonemapping component.
// prowl eval: bloom, tonemapping and FXAA on the main camera
using Prowl.Runtime.Rendering;
var camera = SceneInstance.Main.GetAll<Camera>(includeDisabled: true)[0]!;
camera.Profile = VolumeProfile.CreateCameraDefault("Main Camera Profile");
camera.Profile.Add<Bloom>().Intensity.Set(1f);
camera.Profile.Get<Tonemapping>()!.Mode.Set(TonemappingMode.ACES);
camera.AntiAliasing = AntiAliasingMode.FXAA;
return camera.Profile.Components.Count;

Eval changes do not mark the scene dirty, so scene --action save afterwards.

A first person viewmodel camera keeps the gun from clipping into walls:

using Prowl.Runtime;

public sealed class ViewmodelSetup : Component
{
    public Camera World;
    public Camera Viewmodel;

    public override void Start()
    {
        int weapon = LayerMask.NameToLayer("Weapon");
        World.CullingMask.RemoveLayer(weapon);

        Viewmodel.Depth = World.Depth + 1;
        Viewmodel.Background = CameraBackground.None;
        Viewmodel.CullingMask = LayerMask.FromMask(1u << weapon);
        Viewmodel.NearClipPlane = 0.01f;
    }
}

The viewmodel camera is a child of the world camera, and the arms and gun objects are on the Weapon layer (define it first, see the prowl-cli eval recipes).

Environment

SceneInstance.Main.Environment holds the sky, ambient light and fog. SkyMaterial is a Material whose shader has a Sky pass, usually from SceneEnvironment.CreateSkyMaterial(BuiltInSky.Procedural) (also Gradient, Cubemap, Panorama, SixSided), null shows SkyColor. Ambient (Mode Uniform, Hemisphere or Sky, Intensity, colours) and Fog (Mode Off, Linear, Exponential, ExponentialSquared, Color, Density, Start, End, UseSky) are struct fields: set them directly, for example SceneInstance.Main.Environment.Fog.Mode = FogMode.Off (FogMode and AmbientMode are in Prowl.Graphite.Rendering). Copying one into a local and changing the local does nothing. Fog is on by default (exponential squared, density 0.01).

Lights and lightmaps

  • A component for each kind of light, all deriving from Light: DirectionalLight (lux), PointLight and SpotLight (candela), RectLight, DiskLight and TubeLight (nits). Each starts as a real light preset, the sun at 100000 lux and 5600 K. They shine along Forward. Spots take a whole cone SpotAngle and a SpotSoftness, rects Width and Height, disks Diameter, tubes Length and Radius. Local lights reach an automatic Range unless one is set. Cookie (2D for a spot, cubemap for a point) and IesProfile work on points and spots. Directional, point and spot lights cast shadows (CastShadows, ShadowResolution, ShadowFilter), cascades and shadow distance come from the quality level. The brightest directional light is the sun.
  • Renderers take ShadowCasting (Off, On, ShadowsOnly) and ReceiveShadows.
  • Only objects with IsStatic set get lightmaps. The bake runs from the Environment panel and only progresses while that panel is open.

Particles

  • ParticleSystemComponent (namespace Prowl.Runtime.ParticleSystem, module types and their enums such as ParticleBlendMode in Prowl.Runtime.ParticleSystem.Modules) modules are fields: Initial, Emission, Shape, Renderer start enabled, the rest (ColorOverLifetime, SizeOverLifetime, Trails and so on) need Enabled = true.
  • Curves are MinMaxCurve. From the CLI: set /Muzzle:ParticleSystemComponent Emission.RateOverTime.ConstantValue 0.
using Prowl.Runtime;
using Prowl.Runtime.ParticleSystem;

public sealed class MuzzleFlash : Component
{
    public ParticleSystemComponent Flash;

    public override void Start()
    {
        Flash.Looping = false;
        Flash.PlayOnEnable = false;
        Flash.Emission.RateOverTime.ConstantValue = 0f;
        Flash.Initial.StartLifetime.ConstantValue = 0.05f;
        Flash.Initial.StartSpeed.ConstantValue = 0f;
    }

    public void Fire() => Flash.Emit(6);   // emits right away, playing or not
}

Look up Material, Shader, Camera, VolumeProfile and ParticleSystemComponent with api --type.

版本历史

  • f68efb0 当前 2026-11-21 16:09

同 Skill 集合

Prowl.Editor/Resources/Agent/Skills/prowl-animation/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-assets/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-cli/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-paper/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-physics/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-profiler/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-scenes/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-serialization/SKILL.md
Prowl.Editor/Resources/Agent/Skills/prowl-ui/SKILL.md

元信息

文件数
0
版本
12b6b29
Hash
2ce5a743
收录时间
2026-11-21 16:09

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-22 04:53
浙ICP备14020137号-1