Gigi is software designed for rapid prototyping and rapid development of real time rendering techniques. It is meant for use by professionals, researchers, students, and hobbyists.
The goal is to allow work at the speed of thought, and then easily use what was created in real applications using various APIs or engines.
Hear what people say about using Gigi
Gigi is made of three components:
- Editor - Author a rendering technique
- Viewer - Debug and profile the technique
- Compiler - Generate code for the technique like a human would write
Click here to read more about these three components.
Gigi Editor | Gigi Viewer | Gigi Compiler Generated Code (DX12) |
---|---|---|
Gigi is being actively used and developed, but is young software. You may hit bugs or missing features. Please report these so we can improve Gigi and push forward in the most useful directions. Pull requests are also appreciated! Please see the "Contributing" section below.
Currently, only dx12 code generation is available in this public version of Gigi, but we are hoping to support other APIs, and engines as well, in the future.
Cloning this repo and then building gigi.sln is all that is needed to build Gigi Editor, Viewer and Compiler.
To use prebuilt binaries, go to the releases tab https://github.com/electronicarts/gigi/releases/. You can either download the .zip file, and extract that to the location of your choice, or you can download and run the installer exe.
There will be three executables in the root folder:
- GigiEdit - This is the editor.
- GigiViewerDX12 - This is the viewer.
- GigiCompiler - This is the command line interface compiler.
Introductory Gigi Tutorial: Make a box blur post processing effect.
Discord: Gigi Rapid Graphics Development
Gigi Jam 2024 Lightning Talks (YouTube)
Gigi Technical Overview (GPC 2024)
The Techniques/ folder of the repo contains some examples to help get you started. The Techniques/UnitTests/ folder contains the unit tests, which aims to exercise every possible piece of functionality.
There are also documents in the UserDocumentation folder that explain the viewer python interface, Gigi shader tokens, and other things.
For reporting bugs or making feature requests, create a new issue in this repo.
For bug reports, giving or linking to a zip file of a gigi technique and related files which reproduces the bug is helpful. The more minimal the technique, the faster we can fix the problem. Please also provide steps to see the problem, and how what happens differs from what you expect to happen.
For feature requests, the more information you give us about your need, the better we can come up with something to address the need. We may not always give you what you want as you describe it, but we will aim to solve the spirit of what you are asking for, considering any other constraints that may be in play.
If you could also let us know the urgency of the bug or missing feature on your side, that will help us triage the work. We can't promise to have an immediate resolution to your report, but we will do what we can, as soon as we can.
Created by Alan Wolfe
Contributors:
Alexey Gladkov
Berk Emre Saribas
Chris Lewin
Ivar Jönsson
Martin Mittring
Mohit Sethi
Richard Raquepo
Stephane Levesque
Tristan Calderbank
Gigi would not be possible without several open sourced libraries
Before you can contribute, EA must have a Contributor License Agreement (CLA) on file that has been signed by each contributor. You can sign here: http://bit.ly/electronic-arts-cla
Any contribution - large or small - is much appreciated and earns you a spot on the contributors list. Just add your name to the list (alpha sorted) as part of your pull request!
As far as coding standards, we need to write them up and automate them as much as we can, but for now, try to make your code look like other code.
With each pull request, besides testing any functionality you are touching, please also verify that both the viewer and dx12 unit tests are still passing, and consider adding unit tests if appropriate.
To run the viewer unit tests, from inside the viewer select File->Run Python Script and choose Techniques/UnitTests/RunTests.py. It should report that it has zero errors.
To run the DX12 unit tests, first run the MakeCode_UnitTests_DX12.bat file to generate the code for the unit tests. If this results in no diffs, you can consider it a success. To actually run the generated tests, open and run _GeneratedCode/UnitTests/DX12/UnitTests.sln. It should report that it has zero errors.
Search for Extraordinary Experiences Division (SEED) - Electronic Arts
http://seed.ea.com
We are a cross-disciplinary team within EA Worldwide Studios.
Our mission is to explore, build and help define the future of interactive entertainment.