KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

DigitalPainting

★ 13 Open GitHub ↗

A Unity project that provides a "Digital Painting", a scene that is automatically explored by the camera. It provides a frameowork in which digitial art can be created.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# The Digital Painting

A Unity project that provides a "Digital Painting", a scene that is automatically explored by the camera. It provides a framework in which digital art can be created.

## Features of the Digital Painting

* Intelligent assistance in setting up your scene enables you to get to a "good enough" state very quickly, then it's time to have your designers dive in and make it as close to "perfect" as possible
  * Automated Scene Exploration - see `Scripts/Agent/DroneController`
  * Designate items as [Interesting Things](./Assets/Digital%20Painting/Docs/InterestingThings.md) in the scene to be explored by the drone
  * Support for spawning items into the world using a [SimpleSpawner](./Assets/Digital%20Painting/Docs/SpawnableObjects.md)
  * [Pluggable Day Night Cycle](./Assets/Digital%20Painting/Docs/DayNightCycle.md)
    * Basic Day Night Cycle included
    * [Plugin](https://github.com/DigitalPainting/WeatherMakerPlugin) for [Digital Ruby's Weather Maker](https://assetstore.unity.com/packages/tools/particles-effects/weather-maker-sky-weather-water-volumetric-clouds-and-light-60955) 
  * [Pluggable Weather System](./Assets/Digital%20Painting/Docs/Weather.md)
    * [Plugin](https://github.com/DigitalPainting/RainMakerPlugin) for [Digital Ruby's Rain Maker (Free)](https://assetstore.unity.com/packages/vfx/particles/environment/rain-maker-2d-and-3d-rain-particle-system-for-unity-34938)
  * Pull current or forecasted weather ([powered by Dark Sky](https://darksky.net/poweredby/)) and reflect it in the Digital Painting
  * Easily add the Digital Painting asset to your own scene
    * Standard Assets example scene

## Getting Started

The Digital Painting asset comes with functional scenes that are designed for development and demonstration use. These scenes are very basic in their nature, using only primitives that comes with Unity by default. They are not designed to be pretty. There are some additional [demo scenes](./Assets/Digital%20Painting/Plugins/Scenes/README.md) included that are prettier, in some cases beautiful, though each of these has some additional dependencies that must be installed - some of which are not free. The [demo scenes](./Assets/Digital%20Painting/Plugins/Scenes/README.md) document details these.

Have a play with those scenes and then, when you are ready create your own as described in the next section.

### Creating your First Scene

1. Open the Digital Painting window using `Windows -> Wizards Code -> Open Digital Painting Manager Window`
2. Ensure the `Standard` tab is selected
3. Click the `Add Digital Painting Manager` button - this will add a `Wizards Code` game object to your scene
3. Check to see if there are any errors and resolve them or ignore them as appropriate for your scene.

To create your own Digital Painting scene you can start with any Unity scene that has a terrain. To add the Digital Painting asset to your scene open the Digital Painting Manager Window using `Window > Wizards Code > Open Digital Painting Manager`, ensure the `Standard` tab is selected and click `Add Digital Painting Manager`. This will add the necessary components to your scene and present an interface for adding plugins to enhance your scene.

For more details see the [documentation on creating scenes](./Assets/Digital%20Painting/Docs/CreatingAScene.md).

## Development

We use Git submodules to keep things clean and open the possibility of releasing some of the features as separate projects. Therefore in order to checkout the source you must use:

`git clone git@github.com:DigitalPainting/DigitalPainting.git test --recurse-submodules`

### Required Assets and Packages for Development Work (all zero cost)

Download and import the following assets:

* Unity Environment Standard Assets (Assets -> Import Package -> Environment)
    * You only need the `Environment` and `Effects/LightFlares`
    * You'll need to regenerate the SpeedTree assets (click the error then click `Apply & Generate Materials` in the inspector)
  * ProBuilder Package (install using Package Manager)
  * TextMesh Pro  (install using Package Manager)

### Dev Scenes

In order to build and test features of the Digital Painting project all developers should create
or use the appropriate dev sene (see `Digital Patinting/scenes/dev`). No new features will be accepted without a
corresponding dev scene to allow testing of the feature. It is also important that the "Demo Scene" 
includes a demo of all new new features.

The dev and demo scenes must use only a standard set of (zero cost) 
assets from the Unity Asset store and packages from Unity itself. The number of dependencies must be kept to a minimum.
Any features that are dependent on assets that are not free of cost must be optional and must degrade gracefully in this scene when 
only the assets and packages listed below are included. See the plugin mechanism for guidance on how to include features that
depend on paid assets.

### Credits

Various resources in this asset come from one or more of the following and come under a public domain license.

* [opengameart.org](https://opengameart.org/textures/all) under a [CC0 license](https://creativecommons.org/share-your-work/public-domain/) and can therefore be reused without restriction. 
  * [openclipart.org](https://openclipart.org) under a public domain license and can therefore be used without restriction.
  * [keijiro/PuppetTest ](https://github.com/keijiro/PuppetTest) and is under a [CC0 license](https://creativecommons.org/share-your-work/public-domain/).
  * [Silk Icons](http://www.famfamfam.com/lab/icons/silk/) by Mark James are under a [CC-BY 2.5](http://creativecommons.org/licenses/by/2.5/) license
  * [FreeSFX](https://www.freesfx.co.uk) is a collection of free to use sound FX and music tracks

Please see the license details within git submodules. Only permissively licensed code is included. Changes to these submodules should be submitted upstream for inclusion in the originating project (at the owners discretion).

### Potentially Useful Resources

In addition to the repositories and libraries in the credit section here is another list of useful resources:

* [TreeIt](http://www.evolved-software.com/treeit) a free tree generator

DigitalPainting

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README