{"id":20772144,"url":"https://github.com/joachimcoenen/cat-postprocessing","last_synced_at":"2025-09-11T05:38:25.444Z","repository":{"id":195210234,"uuid":"93930281","full_name":"JoachimCoenen/Cat-PostProcessing","owner":"JoachimCoenen","description":"various post-processing effects for Unity","archived":false,"fork":false,"pushed_at":"2019-04-24T07:52:43.000Z","size":17601,"stargazers_count":48,"open_issues_count":7,"forks_count":11,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2025-04-30T14:27:29.441Z","etag":null,"topics":["effects","image-effects","post-processing","shaders","unity"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JoachimCoenen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-06-10T09:50:41.000Z","updated_at":"2025-03-22T10:54:20.000Z","dependencies_parsed_at":"2023-09-17T01:43:16.536Z","dependency_job_id":"f2847876-2a4a-48ee-aba4-be1b332ba687","html_url":"https://github.com/JoachimCoenen/Cat-PostProcessing","commit_stats":null,"previous_names":["joachimcoenen/cat-postprocessing"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoachimCoenen%2FCat-PostProcessing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoachimCoenen%2FCat-PostProcessing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoachimCoenen%2FCat-PostProcessing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoachimCoenen%2FCat-PostProcessing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JoachimCoenen","download_url":"https://codeload.github.com/JoachimCoenen/Cat-PostProcessing/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251721073,"owners_count":21632767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["effects","image-effects","post-processing","shaders","unity"],"created_at":"2024-11-17T12:19:24.294Z","updated_at":"2025-04-30T14:27:36.321Z","avatar_url":"https://github.com/JoachimCoenen.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cat-Post Processing Effects for Unity 2017.2\nHigh Quality Post-processing effects for Unity. It is compatible with Unity 5.5, Unity 5.6, Unity 2017.1 and Unity 2017.2\n\nDownloads:  \n[Current Version][Package_Newest_LINK] \u003c--  \n[Developement Version][Branch_Develop_LINK]\n\n\n \u003ctable style=\"width:100%;border-spacing:0px\"\u003e\n  \u003ctr style=\"padding:0px\"\u003e\n    \u003ctd colspan=\"2\" style=\"padding:0px\"\u003e \u003cimg src=\"Media/ElevatorDoorDetail.png\" alt=\"Most Effects in action 2\" style=\"width:width;height:height;\"\u003e \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr style=\"padding:0px\"\u003e\n    \u003ctd style=\"padding:0px\"\u003e \u003cimg src=\"Media/DragonFly3.png\" alt=\"All Effects in action\" style=\"width:width;height:height;\"\u003e \u003c/td\u003e\n    \u003ctd style=\"padding:0px\"\u003e \u003cimg src=\"Media/coloredBalls.png\" alt=\"Most Effects in action 3\" style=\"width:width;height:height;\"\u003e \u003c/td\u003e\n  \u003c/tr style=\"padding:0px\"\u003e\n  \n  \u003ctr style=\"padding:0px\"\u003e\n    \u003ctd colspan=\"2\" style=\"padding:0px\"\u003e \u003cimg src=\"Media/ElevatorDoor.png\" alt=\"Most Effects in action 2\" style=\"width:width;height:height;\"\u003e \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nThe main goal is to create high quality post-processing effects with only a small performance impact. Tested with Unity 2017.2.0f3.\n\nThere are currently 7 different post-processing effects included:\n- Ambient Occlusion ([AO][AO_ANCHOR])\n- Stochastic Screen Space Reflections ([SSR][SSR_ANCHOR]), Importance Sampled with contact hardening, specular elongation and retro reflections \n- Depth of Field ([DoF][DoF_ANCHOR])\n- Chromatic Aberration ([CA][CA_ANCHOR])\n- [Bloom][Bloom_ANCHOR] Effect with energy conservation\n- Temporal Anti-Alialising ([TAA][TAA_ANCHOR])\n- Color Grading ([CG][ColorGrading_ANCHOR])\n\n## Install Intructions\nDownload the [newest version here][Package_Newest_LINK], and import the Package via the menu `Assets`\u0026rarr;`Import Package`\u0026rarr;`Custom Package...`.\n\n## Usage\n\u003e For maximum awesomeness we recommend that you work in **Linear + HDR**. Some effects will look wired in Gamma or without LDR. Using the **Deferred rendering path** is also recommended (and required for some effects like [Screen Space Reflections][SSR_ANCHOR] and [Ambient Occlusion][AO_ANCHOR]).\n\nTo add an effect to your camera, either\n- Use the menu `Component`\u0026rarr;`Cat`\u0026rarr;`Post Processing`. Or\n- Use the `Add Component` button in the inspector. `Add Component`\u0026rarr;`Cat`\u0026rarr;`Post Processing`.\n\n## Ambient Occlusion\n![AmbientOcclusionGUI_IMG][AmbientOcclusionGUI_IMG]\n- **Intensity:** The intensity of the ambient occlusion.\n- **Sample Count:** How many samples should be taken? Try to keep it small.\n- **Radius:** The search radius. Try to keep it small, too.\n- **Debug On:** Visualizes the generated Ambient Occlusion.\n\n## Screen Space Reflections\nFor best Results use this effect together with Temporal Anti-Alialising.\n\nPerformance comparison, 2Kx2K resolution: | ms / frame\n--- | ---\nNo SSR: | 10.5 - 12.3 ms\nSSR from Unitys [Post Processing Stack](https://github.com/Unity-Technologies/PostProcessing): | 23.2 - 24.0 ms\n[SSSR by cCharkes](https://github.com/cCharkes/StochasticScreenSpaceReflection): | 21.8 - 22.3 ms\nCat SSR: | 17.0 - 17.8 ms\n\n![ScreenSpaceReflectionsGUI_IMG][ScreenSpaceReflectionsGUI_IMG]\n\nRayTracing\n- **Ray Trace Resol.:** The Resolution of the generated hit texture. _High Performance Impact!_\n- **Step Count:** The maximum amount of steps the ray tracer will take. _High Performance Impact!_\n- **Min Pixel Stride:** The minimum size of a step im pixels.\n- **Max Pixel Stride:** The maximum size of a step im pixels.\n- **Cull Back Faces:** If selected rays towards camera are ignored. Can Increase performance a lot in indoor scenes\n- **Max Refl. Distance:** The radius around the Player (in meters) in which reflections are calculated. mosly usfull in large outdoor scenes\n\nReflections\n- **Reflection Resol.:** The Resolution of the generated reflection texture. _Medium Performance Impact!_\n- **Intensity:** The intensity of the reflections.\n- **Distance Fade:** Controls how soon reflections are faded out, based on distance to the camera.\n- **Ray Length Fade:** Controls how soon reflections are faded out, based on length of ray.\n- **Screen Edge Fade:** Controls how soon reflections are faded out, based on distance from the border of the screen.\n- **Retro Reflections:** Controls whether retro-reflections are used or not. Very low, if any performance impact.\n\nImportance sampling\n- **Sample Count:** Amount of samples per pixel (usually `4`). _Medium Performance Impact!_\n- **Bias (Spread):** Controls how far the samples are spread out. Physically correct is a value of `1`, but that can lead to artifacts\n- **Use Mip Map:** Mip Maps have a surprisingly low impact on performance. They can de-noise the Reflections substantially, but the can also lead to some subtle artifacts.\n\nTemporal\n- **Use Temporal:** Temporally de-noises the importance sampled reflections. But this can currently lead to strong artifacts when an object moves in front of a highly reflective background.\n- **Response:** TBD.\n- **Tolerance Margin:** TBD.\n\nDebugging\n- **Debug On:** TBD.\n- **Debug Mode:** TBD.\n- **Mip Level For Debug:** TBD.\n\n## Depth of Field\n![DepthOfFieldGUI_IMG][DepthOfFieldGUI_IMG]\n- **f-Stop f/n:** Also: f-number. Describes the size of the aperture. A smaller value means a larger aperture and you get a smaller depth of field. See [Wikipedia][fNumberWikipedia_LINK].\n- **Focus Distance:** The Distance of object in focus (*S\u003csub\u003e1\u003c/sub\u003e*). Not to be confused with the [focal length][FocalLengthWikipedia_LINK] *f*.\n- **Radius:** a value of `5` semms to work pretty well.\n- **Debug On:** Shows the Focus Distance in red .\n\n## Chromatic Aberration\n![ChromaticAberrationGUI_IMG][ChromaticAberrationGUI_IMG]\n\n## Bloom\n![BloomGUI_IMG][BloomGUI_IMG]\n- **Intensity:** The intensity of the bloom.\n- **Dirt Intensity:** Only effective when a Dirt Texture is selected  \n- **Dirt Texture:** The dirt on the lense. (RGB)\n- **Min Luminance:** Minimum luminance required for the bloom to appear.\n- **Knee Strength:** \n- **Debug On:** Visualizes the Bloom only.\n\n## Temporal Anti-Alialising\n![TemporalAntiAlialisingGUI_IMG][TemporalAntiAlialisingGUI_IMG]\n- **Sharpness:** Artificially sharpens the image. High values can look cheap.\n- **Velocity Scale:** Controls how sensitive it reacts when pixels move along the screen.\n- **Response:** Controls how fast a pixel responds to a change of color.\n- **Tolerance Margin:** \n- **Jitter Matrix:** What jitter sequence should be used to shake the camera. (Halton Sequence recomended)\n- **Halton Seq. Length:** The length of the Halton Sequence if selected.\n\n## Color Grading\n![ColorGradingGUI_IMG][ColorGradingGUI_IMG]\nColor Grading\n- **Exposure:** Artificially darkens / brightens the image (post exposure).\n- **Contrast:** Changes the contrast without altering the saturation.\n- **Saturation:** Changes the colorfullness of the image.\n\nColor Correction\n- **Temperature:** Blue / Orange.\n- **Tint:** Lime Green / Pink.\n\nCurves\n- **BlackPoint:** Moves the black point of the image.\n- **MidPoint:** Moves the mid grays of the image.\n- **WhitePoint:** Moves the white point of the image.\n- **Shadows:** Strengthens / weakens the shadows.\n- **Highlights:** Strengthens / weakens the highlights.\n\n![Main Img 2][DragonFly_IMG]\n\n[Download][Package_Newest_LINK] Cat-Post Processing Effects for Unity\n\n\n\n[coloredBalls_IMG]:              Media/coloredBalls.png               \"Most Effects in action 1\"\n[ElevatorDoor_IMG]:              Media/ElevatorDoor.png               \"Most Effects in action 2\"\n[ElevatorDoorDetail_IMG]:        Media/ElevatorDoorDetail.png         \"Most Effects in action 3\"\n[DragonFly_IMG]:                 Media/DragonFly3.png                 \"Most Effects in action 4\"\n[AmbientOcclusionGUI_IMG]:       Media/CatAOGUI.png                   \"Ambient Occlusion GUI\"\n[ScreenSpaceReflectionsGUI_IMG]: Media/CatSSRGUI.png                  \"Screen Space Reflections GUI\"\n[DepthOfFieldGUI_IMG]:           Media/CatDoFGUI.png                  \"Depth of Field GUI\"\n[ChromaticAberrationGUI_IMG]:    Media/CatChromaticAberrationGUI.png  \"Chromatic Aberration GUI\"\n[BloomGUI_IMG]:                  Media/CatBloomGUI.png                \"Bloom Effect GUI\"\n[TemporalAntiAlialisingGUI_IMG]: Media/CatAAGUI.png                   \"Temporal Anti-Alialising GUI\"\n[ColorGradingGUI_IMG]:           Media/CatColorGradingGUI.png          \"Color Grading GUI\"\n\n[Install_ANCHOR]:                #install-intructions\n[Usage_ANCHOR]:                  #usage\n[AO_ANCHOR]:                     #ambient-occlusion\n[SSR_ANCHOR]:                    #screen-space-reflections\n[CA_ANCHOR]:                     #chromatic-aberration\n[DoF_ANCHOR]:                    #depth-of-field\n[TAA_ANCHOR]:                    #temporal-anti-alialising\n[Bloom_ANCHOR]:                  #bloom\n[ColorGrading_ANCHOR]:           #color-grading\n\n[Releases_LINK]:                 https://github.com/JoachimCoenen/Cat-PostProcessing/releases \"Cat-PostProcessing/releases\"\n[Package_Newest_LINK]:           https://github.com/JoachimCoenen/Cat-PostProcessing/releases/download/v0.4.1-alpha/Cat-Post.Processing.v0.4.1.unitypackage  \"Cat-Post Processing v0.4.1-alpha - Source Code\"\n[Branch_Develop_LINK]:           https://github.com/JoachimCoenen/Cat-PostProcessing/tree/develop \"develop branch\"\n\n\n\n[fNumberWikipedia_LINK]:         https://en.wikipedia.org/wiki/F-number                       \"f-number - Wikipedia\"\n[FocalLengthWikipedia_LINK]:     https://en.wikipedia.org/wiki/Focal_length                   \"Focal length - Wikipedia\"\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoachimcoenen%2Fcat-postprocessing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoachimcoenen%2Fcat-postprocessing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoachimcoenen%2Fcat-postprocessing/lists"}