{"id":27880658,"url":"https://github.com/microsoft/mixedreality-graphicstools-unity","last_synced_at":"2025-05-05T04:31:55.315Z","repository":{"id":37246755,"uuid":"406516024","full_name":"microsoft/MixedReality-GraphicsTools-Unity","owner":"microsoft","description":"Graphics tools and components for developing Mixed Reality applications in Unity.","archived":false,"fork":false,"pushed_at":"2025-04-23T21:14:27.000Z","size":56272,"stargazers_count":185,"open_issues_count":44,"forks_count":41,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-29T07:40:50.395Z","etag":null,"topics":["graphics","graphicstools","hololens","mixed-reality","mixedrealitytookit-unity","mixedrealitytoolkit","mrtk","unity"],"latest_commit_sha":null,"homepage":"","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/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-09-14T20:44:46.000Z","updated_at":"2025-04-23T21:14:31.000Z","dependencies_parsed_at":"2023-11-17T02:30:24.482Z","dependency_job_id":"c6d8ff57-8d92-403b-bc49-6bada11a3323","html_url":"https://github.com/microsoft/MixedReality-GraphicsTools-Unity","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FMixedReality-GraphicsTools-Unity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FMixedReality-GraphicsTools-Unity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FMixedReality-GraphicsTools-Unity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FMixedReality-GraphicsTools-Unity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/MixedReality-GraphicsTools-Unity/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252440037,"owners_count":21748135,"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":["graphics","graphicstools","hololens","mixed-reality","mixedrealitytookit-unity","mixedrealitytoolkit","mrtk","unity"],"created_at":"2025-05-05T04:31:54.526Z","updated_at":"2025-05-05T04:31:55.301Z","avatar_url":"https://github.com/microsoft.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"![MRTK](README/MRTKBanner.png)\n\n# What is Graphics Tools?\n\nMRTK Graphics Tools for Unity is a [Unity engine](https://unity.com/) package with code, shaders, assets, and samples created to help improve the visual fidelity of [mixed reality](https://docs.microsoft.com/windows/mixed-reality/discover/mixed-reality) applications while staying within performance budgets.\n\n![Graphics Tools](README/GTBanner.png)\n\n# Getting started with Graphics Tools\n\nGraphics Tools is normally ingested as a Unity [package](https://docs.unity3d.com/Manual/Packages.html). To import Graphics Tools into your Unity project follow the below steps:\n\n\u003e [!NOTE]\n\u003e The Graphics Tools package requires Unity 2021.3 and above.\n\n1. Open your Unity project and select `Window \u003e Package Manager` from the file menu bar\n\n2. Click the `'+'` icon within the Package Manager and select `\"Add package from git URL...\"`\n\n    ![Package Manager Add](README/PackageManagerAdd.png)\n\n3. Paste *https://github.com/microsoft/MixedReality-GraphicsTools-Unity.git?path=/com.microsoft.mrtk.graphicstools.unity#v0.8.0* into the text field and click `\"Add\"`\n\n    ![Package Manager Paste](README/PackageManagerPaste.png)\n\n4. Graphics Tools will now be installed within your Unity project as an immutable package within the project's `Packages` folder named `MRTK Graphics Tools`.\n\nIt is advised you use a specific release of the Graphics Tools package to ensure your project is locked to a stable release. Release version 0.8.0 is suggested in step three above. You can also pull another version, specific branch, or git commit hash by altering the URL as demonstrated below:\n\n| Syntax           | URL example                                                                                                                                               |\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Specific version | *https://github.com/microsoft/MixedReality-GraphicsTools-Unity.git?path=/com.microsoft.mrtk.graphicstools.unity#vX.Y.Z*                                   |\n| Specific branch  | *https://github.com/microsoft/MixedReality-GraphicsTools-Unity.git?path=/com.microsoft.mrtk.graphicstools.unity#my_branch*                                |\n| Git commit hash  | *https://github.com/microsoft/MixedReality-GraphicsTools-Unity.git?path=/com.microsoft.mrtk.graphicstools.unity#badc0ffee0ddf00ddead10cc8badf00d1badb002* |\n\n## Documentation\n\nDocumentation can be found on Microsoft's technical documentation website.\n\n| Documentation Category | Link                                                                                                               |\n|------------------------|--------------------------------------------------------------------------------------------------------------------|\n| Conceptual             | [MRTK Unity](https://docs.microsoft.com/windows/mixed-reality/mrtk-unity/mrtk3-graphicstools/)                                         |\n| API Reference          | [Microsoft.MixedReality.GraphicsTools](https://docs.microsoft.com/dotnet/api/Microsoft.MixedReality.GraphicsTools) |\n\n## Importing samples\n\nTo view the samples contained within Graphics Tools select `Window \u003e Package Manager` from the Unity file menu bar. Click on the `MRTK Graphics Tools` package and expand the `Samples` list. Finally, click the `Import` button for any samples you would like to try:\n\n![Package Manager Samples](README/PackageManagerSamples.png)\n\n## Example project\n\nA Unity project named `GraphicsToolsUnityProject` lives at the root of this repository. The project serves as sandbox to test and validate the Graphics Tools package. This project can also assist in developing contributions to this repo. See [below](#updating-the-package-samples) to learn more about contributing.\n\n\u003e [!TIP]\n\u003e See GraphicsToolsUnityProject/ProjectSettings/ProjectVersion.txt to inspect the Unity version used for the example project.\n\n# Feedback and contributions\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit \u003chttps://cla.opensource.microsoft.com\u003e.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Updating the package samples\n\nSamples exist under the `Samples~` subfolder as outlined by Unity's [sample recommendations](https://docs.unity3d.com/Manual/cus-samples.html). The '~' character prevents the `Samples~` folder for being imported by Unity.\n\nIf you wish to contribute changes to the samples you must make a temporary local change to the Unity project's directory structure.\n\n1. Open the `GraphicsToolsUnityProject` in Unity. The `Samples` folder will not be visible in the `MRTK Graphics Tools` package by default. To show the samples select `Window \u003e Graphics Tools \u003e Show Samples` from the file menu bar.\n2. Make any desired changes to the samples.\n3. **Important:** When finished and before committing your changes, remember to hide the samples. Select `Window \u003e Graphics Tools \u003e Hide Samples` from the file menu bar.\n\n# License agreement\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit \u003chttps://cla.opensource.microsoft.com\u003e.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fmixedreality-graphicstools-unity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fmixedreality-graphicstools-unity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fmixedreality-graphicstools-unity/lists"}