| name | unity-postprocess |
| description | Modern SRP post-processing effects on URP / HDRP VolumeProfiles (built on top of the Volume framework). Use when users want to add / remove / inspect or tune Bloom, Depth Of Field, Tonemapping, Vignette, Color Adjustments, or any modern PP effect override on a VolumeProfile. Do NOT use for the legacy PPv2 stack (`com.unity.postprocessing`). Triggers (EN): post-processing, modern post-processing, Bloom, Depth Of Field, DOF, Tonemapping, Vignette, Color Adjustments, color grading, post effect, VolumeProfile effect. Triggers (ZH): 后处理, 现代后处理, 泛光, Bloom, 景深, 色调映射, 暗角, 颜色调整, 调色, Volume 后处理. |
PostProcess Skills
Modern URP / HDRP post-processing skills built on top of the SRP Volume framework. For Volume container / profile CRUD (volume_profile_create, volume_create, etc.), use the volume module.
Operating Mode
- Query skills (
postprocess_list_effects, postprocess_get_effect) are SkillMode.SemiAuto — they run in all three modes without grant.
- Mutating skills (
postprocess_add_effect, postprocess_set_parameter, postprocess_set_bloom, postprocess_set_depth_of_field, postprocess_set_tonemapping, postprocess_set_vignette, postprocess_set_color_adjustments) are SkillMode.FullAuto — under Approval they need user grant (grant triggers one server-side execute returning the result); under Auto / Bypass they execute directly.
postprocess_remove_effect carries SkillOperation.Delete and is auto-forbidden in Approval / Auto modes (NeverInSemi). Only Bypass or the user-managed Allowlist can run it.
SRP Package Stub
This module is compiled against com.unity.render-pipelines.core (SRP_CORE). When neither URP nor HDRP is installed (no SRP Core), every skill returns a stub { error: "Scriptable Render Pipeline Core package … is not installed." } (RenderPipelineSkillsCommon.NoSRP()). The stub is a diagnostic payload, not a permission denial — it does not require grant and is not treated as NeverInSemi.
Guardrails
DO NOT:
- Use this module for PPv2 /
com.unity.postprocessing
- Use this module for general Volume container/profile management; use
volume
Runtime-first rules:
- Always call
postprocess_list_effects before assuming an effect exists on the active pipeline
- Use
postprocess_get_effect or volume_get_component to inspect real parameter names before setting generic parameters
- Prefer the dedicated high-frequency skills (
postprocess_set_bloom, postprocess_set_depth_of_field, etc.) over guessing generic parameter names
- Treat URP and HDRP parameter surfaces as similar-but-not-identical; do not reuse names blindly across pipelines
Skills
postprocess_list_effects
List modern SRP post-processing effects supported by the active pipeline.
postprocess_add_effect
Add a post-processing effect override to a VolumeProfile.
postprocess_remove_effect
Remove a post-processing effect override from a VolumeProfile.
postprocess_get_effect
Inspect a post-processing effect override.
postprocess_set_parameter
Set one parameter on a post-processing effect override.
postprocess_set_bloom
Configure Bloom.
postprocess_set_depth_of_field
Configure Depth Of Field.
postprocess_set_tonemapping
Configure Tonemapping.
postprocess_set_vignette
Configure Vignette.
postprocess_set_color_adjustments
Configure Color Adjustments.
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
