excaliburjs / Excalibur / 5460148499 / 1

89%

main: 89%

push

github

feat: Custom Material/Shader per Actor (#2670)


![material](https://github.com/excaliburjs/Excalibur/assets/612071/7e4da90b-278b-40b3-8bad-b98741656f18)

This PR adds custom material support which enables the custom shader per Actor. To do this there is a new `ex.MaterialRenderer` plugin which takes over from the default batch renderer (`ex.ImageRenderer`) if there is a material present then it will run the custom shader attached to the material. This works by setting `ex.GraphicsComponent.material = someMaterial`

```typescript
const material = new ex.Material({
  name: 'test',
  fragmentSource,
  color: ex.Color.Red,
});

const actor.graphics.material = material;
```


## Changes:

- GraphicsComponent material support for whole actor shader support
- Graphics context material support in save/restore
- New ex.MaterialRenderer plugin
- Updates to draw call to support materials

## TODOs
* [x] Tests
* [x] API cleanup
* [x] Perf analysis

4472 of 5634 branches covered (79.38%)

10414 of 11347 relevant lines covered (91.78%)

26358.26 hits per line