chunreal

KO | EN

gitlite — search

#javascript #python #ruby #php #blog #hacktoberfest #html #gem #game #dotfiles #c-plus-plus #deprecated

★ 40 Open GitHub ↗

ChucK in Unreal Engine

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Chunreal
## ChucK - Strongly-timed Music Programming Language - in Unreal Engine 5
**_Chunreal_** is a plugin for [Unreal Engine 5](https://www.unrealengine.com/)  that allows users to compile [ChucK](https://github.com/ccrma/chuck) code at runtime. Multiple ChuckMain nodes can be chained in a MetaSound graph using stereo input & output to perform modular synthesis style digital signal processing.

Developed by [Eito Murakami](https://ccrma.stanford.edu/~eitom) and [Ge Wang](https://ccrma.stanford.edu/~ge) with the help of Max Jardetzky at [CCRMA | Stanford University](https://ccrma.stanford.edu/).

## Wiki Tutorial!
The Wiki page contains a step-by-step tutorial that demonstrates how to set up the Chunreal plugin in your Unreal Engine project.

https://github.com/ccrma/chunreal/wiki

## Template Project

This git repository hosts a template Unreal Engine 5.3 project that includes example scenes, Blueprints, MetaSound sources, and materials. Clone or fork the repository and generate Visual Studio project files. 
If this is your first time compiling a Unreal Engine project, set up your IDE by following these tutorials:

https://docs.unrealengine.com/5.3/en-US/setting-up-visual-studio-development-environment-for-cplusplus-projects-in-unreal-engine/

https://docs.unrealengine.com/5.3/en-US/how-to-generate-unreal-engine-project-files-for-your-ide/

### Try Example Scenes!
Try opening the following example levels and playing in the editor viewport!
- **Chunreal_SetGlobals_ExampleLevel**
- **Chunreal_ChainedDSP_ExampleLevel**
- **Chunreal_1Source_ExampleLevel**
- **Chunreal_ManySources_ExampleLevel**
- **Chunreal_Physics_ExampleLevel**
- **Chunreal_Mic_ExampleLevel**
- **Chunreal_GlobalEvent_ExampleLevel**
- **Chunreal_PitchChange_ExampleLevel**

## How To Use Chunreal
### Setting Up ChuckMain Node
**Chunreal_Simple_MetaSound** asset contains an example of ChuckMain node implementation in a MetaSound source.

Input
- **Run Code**: A trigger input for compiling ChucK code.
- **Code**: A string input for ChucK code to be compiled.
- **ID**: A string input for assigning a unique ID to a ChuckMain node. This is used to get and set global variables for a specific ChucK instance.
- **Audio Input Left**: Audio input left channel. Can be accessed by adc.left inside a ChucK code.
- **Audio Input Right**: Audio input right channel. Can be accessed by adc.right inside a ChucK code.
- **Volume Multiplier**: A float input for applying a volume multiplier to both output channels.

Output
- **Audio Output Left**: Audio output left channel. Can be accessed by dac.left inside a ChucK code.
- **Audio Output Right**: Audio output right channel. Can be accessed by dac.right inside a ChucK code.
<img width="683" alt="image" src="https://github.com/ccrma/chunreal/assets/75334216/ca0cd851-843a-4435-8557-efe61fa23a55">

### Set Parameters From A Blueprint Actor
Create a Blueprint actor, attach an audio component, and assign your MetaSound source that contains a ChuckMain node(s) as the sound parameter.
Optionally, enable _Allow Spatialization_ and apply _Attenuation Settings_. We prepared an example **Binaural_SA** sound attenuation asset.

**_Chunreal_Simple_BP_** asset provides a template.

A ChucK code can be written as a string and can be passed to the Audio Component that uses the MetaSound source as follows:

Alternatively, we prepared a **ReadFile** Blueprint function for loading a _.ck_ file using an absolute path.

### Getting & Setting ChucK Global Variables Using ID
A specific ChucK instance can be accessed using its assigned unique ID. Global _event_, _int_, _float_, and _string_ variables can be accessed using the following Blueprint functions.
To learn how to use each function, open each Blueprint Actor in **_ExampleBlueprints_** folder.

### Connecting Multiple ChuckMain Nodes
Multiple ChuckMain nodes can be chained in a MetaSound source and can interact with other existing MetaSound nodes!

**Chunreal_ChainedDSPExample_MetaSound** and **Chunreal_ChainedDSPExample_BP** provide a template.

## ChucK Community
Join us!! [ChucK Community Discord](https://discord.gg/ENr3nurrx8) | [ChucK-users Mailing list](https://lists.cs.princeton.edu/mailman/listinfo/chuck-users)

chunreal

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README