# GraphicsConfigurator [![openupm](https://camo.githubusercontent.com/a973845c7d9cef75f91e3f23f47ea8250b3b75289cd46a4b291b996c771da20e/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f636f6d2e696e63383837372e6772617068696373636f6e666967757261746f723f6c6162656c3d6f70656e75706d2672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/com.inc8877.graphicsconfigurator/) [![Codacy Badge](https://camo.githubusercontent.com/d8ac9fa7e8d6083748de652cdf7a9a542b31ec162087248355fcb3e85a5592d6/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6636623766623135623966323432373362333033633362373934303963626662)](https://www.codacy.com/gh/inc8877/GraphicsConfigurator/dashboard?utm_source=github.com&utm_medium=referral&utm_content=inc8877/GraphicsConfigurator&utm_campaign=Badge_Grade) API for managing URP asset parameters, including hacking of parameters that are forbidden to change. ## Table of Contents - [GraphicsConfigurator](https://github.com/inc8877/GraphicsConfigurator/raw/main/#graphicsconfigurator) - [Table of Contents](https://github.com/inc8877/GraphicsConfigurator/raw/main/#table-of-contents) - [Download](https://github.com/inc8877/GraphicsConfigurator/raw/main/#download) - [How to use](https://github.com/inc8877/GraphicsConfigurator/raw/main/#how-to-use) - [Installation](https://github.com/inc8877/GraphicsConfigurator/raw/main/#installation) - [Install via OpenUPM](https://github.com/inc8877/GraphicsConfigurator/raw/main/#install-via-openupm) - [Install via Git URL](https://github.com/inc8877/GraphicsConfigurator/raw/main/#install-via-git-url) - [Include GraphicsConfigurator `.dll` into the project](https://github.com/inc8877/GraphicsConfigurator/raw/main/#include-graphicsconfigurator-dll-into-the-project) - [Examples](https://github.com/inc8877/GraphicsConfigurator/raw/main/#examples) - [Tested devices](https://github.com/inc8877/GraphicsConfigurator/raw/main/#tested-devices) - [Known issues](https://github.com/inc8877/GraphicsConfigurator/raw/main/#known-issues)

Problem

Unity closed access to change important parameters such as shadows casting, shadow resolution, lighting modes, etc. If you want to give the user the ability to customize the resolution of shadows, then the suggestion from unit sounds like this: ***"create multiple assets and rearrange them"*** If you follow this way, you will have to create hundreds of pipeline assets to give users the ability to customize the graphics settings. At the moment the Unity dev team does not disclose the reasons why they closed the ability to change many important parameters.

Solution

Create a wrapper to bypass the restrictions to modify private parameters.

## Download | URP | LINK | | :------------: | :---------------------------------------------------------------------------------: | | 11.0.0 | [:arrow_down:](https://github.com/inc8877/GraphicsConfigurator/releases/tag/v1.1.1) | | 10.3.1, 10.3.2 | [:arrow_down:](https://github.com/inc8877/GraphicsConfigurator/releases/tag/v1.0.0) | ## How to use 1. Add wrapper to your project ([installation](https://github.com/inc8877/GraphicsConfigurator/raw/main/#installation)) 2. Include wrapper library in code ([how](https://github.com/inc8877/GraphicsConfigurator/raw/main/#examples)) 3. Change any parameters of the URP Asset in one line. In the bag :clap: ## Installation ### Install via OpenUPM The package is available on the [openupm](https://openupm.com) registry. It's recommended to install it via [openupm-cli](https://github.com/openupm/openupm-cli). ```c# openupm add com.inc8877.graphicsconfigurator ``` ### Install via Git URL Open `Packages/manifest.json` with your favorite text editor. Add the following line to the dependencies block. ```c# { "dependencies": { "com.inc8877.graphicsconfigurator": "https://github.com/inc8877/GraphicsConfigurator.git", } } ``` ### Include GraphicsConfigurator `.dll` into the project Add `.dll` to your project, you can find it in [every release](https://github.com/inc8877/GraphicsConfigurator/releases). You can find a suitable version [here](https://github.com/inc8877/GraphicsConfigurator/raw/main/#download) ## Examples First, plugin necessary libraries ```c# using GraphicsConfigurator.API.URP; using UnityEngine.Rendering.Universal; using ShadowResolution = UnityEngine.Rendering.Universal.ShadowResolution; ```
To change the active URP Asset, you need to do the following: ```c# // ... // code somewhere Configuring.CurrentURPA.OpaqueDownsampling(Downsampling._4xBox); Configuring.CurrentURPA.AntiAliasing(MsaaQuality._4x); Configuring.CurrentURPA.MainLightMode(LightRenderingMode.PerPixel); Configuring.CurrentURPA.MainLightShadowsCasting(true); Configuring.CurrentURPA.MainLightShadowResolution(ShadowResolution._1024); // ... ```
If you want to work with a specific URP Asset, do it like this: ```c# private URPAssetConfiguring URPA = new URPAssetConfiguring(target); // ... // code somewhere URPA.MainLightShadowsCasting(true); URPA.Cascade3Split(new Vector2(0.1f, 0.3f)); // ... ``` ## Tested devices | CPU | GPU | OS | Graphics API | Backend | .Net | | :-------: | :-----------------: | :------------: | :----------: | :-----: | :---: | | SD 855 | Adreno 640 | Android 10.3.8 | Vulkan | IL2CPP | 4.x | | SD 845 | Adreno 630 | Android 10.3.7 | Vulkan | IL2CPP | 4.x | | i7 6700HQ | AMD Randeon Pro 450 | macOS 11.2.1 | Metal | IL2CPP | 4.x | ## Known issues - When there is a change in the additional light rendering mode with the display of the target asset in the inspector, then the mode changes briefly, after which it has the parameters that were set before the change was attempted. This happens only in editor mode, it is not observed in assemblies. If, in editor mode, you try to change the rendering mode of the additional light and do not display the target asset in the inspector, then everything is successful. Presumably the problem lies in the way the asset editor works.