Skip to content

Fix incorrect metadata in documentation comments - #263

Open
umajho wants to merge 4 commits into
AcademySoftwareFoundation:mainfrom
umajho:main
Open

Fix incorrect metadata in documentation comments#263
umajho wants to merge 4 commits into
AcademySoftwareFoundation:mainfrom
umajho:main

Conversation

@umajho

@umajho umajho commented Sep 1, 2026

Copy link
Copy Markdown

Hello. While working on a project where I generate code from the C++ bindings (openfx-cpp/), I found that OfxImageEffectActionIsIdentity.outArgs was missing in ofxPropsBySet.h. This turned out to be because the @actiondef for kOfxImageEffectActionIsIdentity was missing the outArgs metadata (OfxPropName and OfxPropTime), even though they are listed in the action's documentation.

In this PR:

  • The metadata for the newly added OfxImageEffectPropBehaviourWhenUnlicensed is missing from main, which causes gen-props.py and gen-props-docto fail. I added the missing metadata in the 1st commit.
  • I added the two missing outArgs entries for OfxImageEffectActionIsIdentity mentioned above in the 2nd commit.
  • Since I had already found one issue, I thought there might be more similar ones. Therefore I asked GitHub Copilot (Kimi K3 Max) to review the C headers in include/, and I fixed some issues it identified. These changes are included in the 4th commit.

I ran uv run scripts/gen-props.py and uv run scripts/gen-props-doc.py before submitting this PR, I think these should be enough for the changes I made in this PR…?

Comment thread include/ofxImageEffect.h
- OfxImageEffectPropThumbnailRender
outArgs:
- OfxImageEffectPropFrameRange
# - OfxImageEffectPropFrameRange_ # with clip name

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the same way as for OfxImageEffectClipPropRoI_ in kOfxImageEffectActionGetRegionsOfInterest:
https://github.com/umajho/openfx/blob/e82be712c7f7bed3ba3581b42902647ce1c6fe90/include/ofxImageEffect.h#L204

Comment thread include/ofxParam.h
- OfxParamPropInterpolationAmount
outArgs:
- OfxParamPropCustomValue
- OfxParamPropInterpolationTime

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IsOfxParamPropInterpolationTime here actually one of the outArgs for OfxCustomParamInterpFuncV1? The documentation doesn't list it as an outArg, and I can't figure out what it would mean as an outArg. (I'm new to OpenFX, so this might just be a gap in my understanding.)

…props.py

Signed-off-by: umajho <umajho@proton.me>
Signed-off-by: umajho <umajho@proton.me>
…lude/*.h

missing entries:
    - OfxImageEffectActionRender:
        - inArg OfxImageEffectPropFieldToRender
        - inArg OfxImageEffectPropRenderWindow
        - InArg OfxImageEffectPropRenderScale
    - OfxCustomParamInterpFuncV1:
        - inArg OfxPropName
        - inArg OfxPropTime

wrong representations:
    - OfxImageEffectActionGetFramesNeeded:
        - OfxImageEffectPropFrameRange_ is currently unrepresentable. It is
          commented out in the same way as for OfxImageEffectClipPropRoI_.

duplications:
    - OfxImageEffectActionBeginSequenceRender:
        - OfxImageEffectPropInteractiveRenderStatus
    - OfxImageEffectActionEndSequenceRender:
        - OfxImageEffectPropInteractiveRenderStatus

styles:
    - OfxActionBeginInstanceChanged:
        - `outArgs: []` -> `outArgs:`

Assisted-by: GitHub Copilot / Kimi K3 Max
Signed-off-by: umajho <umajho@proton.me>
@umajho

umajho commented Sep 1, 2026

Copy link
Copy Markdown
Author

Should I also add @actiondef metadata for OfxActionDialog, OfxActionOpenGLContextAttached and OfxActionOpenGLContextDetached?

The documentation page Actions Passed to An Image Effect doesn't mention OfxActionOpenGLContextAttached and kOfxActionOpenGLContextDetached. Is there a reason for this? For example, did I misunderstand their purpose: are they not actions that are passed tomainEntry?

@umajho umajho changed the title Fix incorrect metadata in comments Fix incorrect metadata in documentation comments Sep 1, 2026
Comment thread include/ofxImageEffect.h
- OfxImageEffectPropRegionOfInterest
- OfxImageEffectPropThumbnailRender
outArgs:
# - OfxImageEffectClipPropRoI_ # with clip name

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the correct name for this might be OfxImageClipPropRoI_ (12 results in the repo) instead of OfxImageEffectClipPropRoI_ (only used here).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant