Gaffer Examples.

Last Updated: 10/02/2021

Note: UVs/Surfacing/Lighting is in WIP

Setup
Templates
    Assets Template
    Shots Template
        Barbershop
        Clasroom
Contribute! Help wanted
licences

All tools presented here are based solely on examples shared on the Gaffer community mailing list

Gaffer Version

Requires 0.61.2.0 or above.

Setup

Before you start

Unzip the barbershop alembic file /barbershop/abc/babershop_interior.7z.
Alternatively you can run expand-assets.sh to unzip it using file-roller.

Enviroment Variables

source gaffer-examples.sh before running gaffer.
Alternatively set those environments in your system manually.

Dependencies

OIDN is optionally required for the LDTBatchRender node.

LDTGaffer is required for this examples.
If you would rather have the LDTGaffer repo in a different location:
Comment the line "source LDTGaffer/LDTGaffer.sh", and source both .sh from the repositories before running gaffer.

Templates

Note on GPU render: Ai User Data String and Trace Sets are not supported
in GPU render.
Shots Template: Turn the barbershop Reference Node gpu_uncompat_nodes Off.
Asset Template: Prune the Shader balls reference.

Assets Template

Asset Template, with lightrigs Render, metadata overlay and ContactSheet.

Shots Template

Shot level Box nodes containing overrides, with rendered icons

Template Outputs

Note: UVs/Surfacing/Lighting is in WIP. No compositing, beauty pass only.

Barbershop

Clasroom

Licences

Different parts of this repository, are given with different licences.
You can find the plaintext legalcode licence files under each folder where applicable.

Clasroom

Blender Classroom By Christophe Seux.
Terms of Use: This work is licenced under CC0

Barbershop

Blender Barbershop from "Agent 327" by Blender Institute
Terms of Use: This work is licenced under CC-BY-ND.

Change list:

• Gaffer Scene converted from Original Blender file.
• Export/Conversion was not possible at a 100% match.
  Certain elements -such as:objects/uvs/textures- did not translate properly
  Conversion is still pretty much in WIP and will continue to improve,
  following the original work.

PBR Textures

cc0textures

PBR textures by www.cc0textures.com
Terms of Use: This work is licenced under CC0

3dtextures me

PBR textures by https://3dtextures.me/
Terms of Use: This work is licenced under CC0

polyhaven

PBR textures by https://polyhaven.com
Terms of Use: This work is licenced under CC0

HDRIs

Pixar Renderman Stinson Beach

Stinson Beach HDRI files by Loren Carpenter from piper-look-dev
Terms of Use: This work is licenced under CC BY-NC-SA

hdrihaven

HDR under /resources/hdri/hdrihaven by www.hdrihaven.com
Terms of Use: This work is licenced under CC0

zbyg

HDR under /resources/hdri/zbyg by zbyg
Terms of Use: This work is licenced under CC BY

Icons

String lights icon by supalerk laipawat from the Noun Project
Set Lights by Lluisa Iborra from the Noun Project
Camera aperture tool by Vectors Point from the Noun Project
Videocamera by Vichanon Chaimsuk from the Noun Project
Rotation by Andrejs Kirma from the Noun Project
Setting by ghufronagustian from the Noun Project
Gear by Gan Khoon Lay from the Noun Project
Fork by useiconic dot com from the Noun Project
Layers by Creative Stall from the Noun Project
Layers by Bernar Novalyi from the Noun Project
Tag by Marta Ambrosetti from the Noun Project
Settings by Fahmi Ramdani from the Noun Project
Tools by Vectors Point from the Noun Project
Start by Larea from the Noun Project
Restore by Phoenix group from the Noun Project

About CC0, CC-BY, CC-BY-ND and CC BY-NC-SA

CC0 Universal Public Domain Dedication
CC BY
CC BY-ND
CC BY-NC-SA

Contribute

Help needed!

Do you feel like:

• helping with assets surfacing or lighting Setups?
• sharing cool tricks, examples, templates, or workflows?
• improve the templates?
• helping translating the Assets and lighting to Gaffer Cycles?

How to Contribute

Before you start, contact us and let us know what you want to work on.
Certain things -such as asset surfacing, and lighting updates- will need to be handled case by case, to ensure a smooth conflict-free update in the main files.

Fork, clone, branch, work, push, pull request as usual.

Style guide

Examples style guide

Extra styling

Styling Exceptions

Where nodes are Shots or Sequence based, for better readability we prefix these nodes with SEQ0001 for exampe SEQ0001_RenderQuality or SEQ0001_SHO0002

Icons

Icons are placed in /resources/icons. To set a Node's icon, open the Node's EditUI window and set the Node icon as /assets/resources/icons/iconName.png

IconScale

You can set the Node's iconScale using the code snippet below.
The values used in the templates are 3.0, 5.0 or 7.0, depending on the node importance. Only Box Nodes are scaled.

import Gaffer
node = root['LDTTurnTable']
Gaffer.Metadata.registerValue (node, 'iconScale', 7.0)

Licences:

• When contributing you are agreeing to submit your work under a CC0 licence.
  Attributions -although not required by this licence- will be given in this repository.

• Files from external other sources need to be compatible with CC0 licence or its derivates. See the licences section.
  This includes -but is not limited to- textures, .hdr files, .grf files, python scripts, Gaffer Nodes, etc.

• Licences should be listed and specified for all external sources following their specific requirements.

• Attributions should be given, even in the case of CC0 licenced material that do not required them.

    Not everybody is familiar with licences, in this case specially cc0 and its derivates.
    If you have concerns or questions about this subject, contact us.