AcademySoftwareFoundation / AcademySoftwareFoundation/openfx

Host 3D Support

Open
#176 4 comments 0 reactions 0 assignees View on GitHub
standard change
Dominant language
C++
Stars
570
Forks
152
Avg merge
5m
Merged PRs (30d)
2

Description

# Open Effects Proposal for Standard Change

Please read the contribution [guidelines](https://github.com/ofxa/openfx/wiki/Extending-OpenFX-Guidelines#submit-a-proposal-or-bug-report-to-review) first.

## Standard Change Workflow
- [X] Create proposal as issue (you're doing this now!)
- [X] Tag this issue with `standard change` tag
- [ ] Identify subcommittee: at least one plug-in vendor, and at least one host
- [ ] Discuss the idea in this issue
- [ ] Write new or updated code and doc
- [ ] Publish updates as a pull request (ideally on a `feature/PROPOSAL-NAME` branch)
- [ ] Make sure that PR references this issue number to keep them in sync
- [ ] Discuss and review code in the PR
- [ ] Meet all requirements below for accepting PR
- [ ] When subcommittee signs off and other members don't have any further review comments,
maintainer merges PR to master which closes PR and issue

## Requirements for accepting a standard change:
- [ ] Header files updated
- [ ] Documentation updated
- [ ] Release notes added
- [ ] Compatibility review completed
- [ ] Working code demonstrated with at least one host and one plugin
- [ ] At least two members sign off
- [ ] No further changes requested from membership

## Summary

Some hosts have the concept of a 3D camera, lights, nulls, etc. There is currently no standard method
by an OFX plugin for querying that information.

## Motivation

Plugin vendors want to get access to the host Camera and possibly lights and 3D nulls.

## Problem

The problem is there is currently no standard way to query this information. Some hosts have
private suites but they are inconsistent.

## Impact

This would require a new set of 3D-related properties and and a suite which would not affect
existing suites or properties.

Host support for 3D would be determined by the presence of a new suite.

## Documentation Impact

A new section on 3D support would be required in the documentation.

## Stakeholders

Hosts and plugins would benefit from this.

## Discussion

The following hosts have private suites:

### Nuke
Nuke has a NukeOfxCameraSuiteV1 with functions for defining a camera input (during the Describe) action that can be connected to via the graph, like an image input. Cameras are described as a PropertySetHandle with properties:

- Projection Mode
- Focal Length
- H/V Aperture
- Near/Far planes
- window translation/scale/roll
- Focal Point
- position matrix (a 4x4 matrix but its nature is not described)

### Scratch
Scratch has a OfxAssimilateCameraSuite with a call to get a single global camera. The camera information is described by a PropertySetHandle with properties:

- Pose (a 4x4 OpenGL-style matrix),
- Field of View
- Near/Far planes.

### HitFilm
HitFilm has comprehensive 3D support for Cameras, Lights, and arbitrary per-clip Transforms.
The Camera API is similar to Nuke's, where Cameras are treated like inputs. Properties are:

- Matrix (row-major 4x4 double)
- Zoom
- FOV
- Focus Distance
- Blur Level
- Aperture

Additionally, the suite allows querying the available lights which have numerous light-related properties.
Transformation matrices for clips that are "3D" can also be queried.

Contributor guide

Open the contributing guide

Research direction

Start with the linked OpenFX contribution guidelines, then review the documented Nuke, Scratch, and HitFilm camera or 3D suites in this proposal. Determine the new properties and suite needed for host and plugin support, and account for the stated requirements: updated headers and documentation, release notes, compatibility review, demonstrations, and member sign-off.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
api, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.