#10017 closed defect (invalid)

Filter expression syntax is undocumented

Reported by: jason Owned by:
Priority: minor Component: documentation
Version: git-master Keywords:
Cc: Blocked By:
Blocking: Reproduced by developer: no
Analyzed by developer: no

Description

Multiple filters take a mathematical expression as a parameter, for example 'setpts' and 'select'.

The syntax of this expression is completely undocumented, despite its heavy use. For example, what functions are available? Are boolean combinations allowable and if so, what are the operators? What other mathematical operators are available? Are there equality comparison operators?

Afaict there is no hint in any of the documentation of the format of an "expression".

If it does exist, it should be made available under a more obvious documentation section heading, and possibly moved towards the beginning of the filter docs with the rest of the general common filter info.

Change History (4)

comment:1 by Carl Eugen Hoyos, 18 months ago

Priority: importantminor
Version: unspecifiedgit-master

comment:2 by Cigaes, 18 months ago

https://ffmpeg.org/ffmpeg-all.html#Expression-Evaluation

I grant you FFmpeg's documentation is lacking in the department of internal links, but you cannot say that expressions are not documented.

in reply to:  2 comment:3 by jason, 18 months ago

Replying to Cigaes:

https://ffmpeg.org/ffmpeg-all.html#Expression-Evaluation

I grant you FFmpeg's documentation is lacking in the department of internal links, but you cannot say that expressions are not documented.

Thank you, much appreciated. I just found the same and actually came here to close this report.

These expression docs are really good, actually.

Last edited 18 months ago by jason (previous) (diff)

comment:4 by jason, 18 months ago

Resolution: invalid
Status: newclosed

Docs exist! And are pretty good, too. https://ffmpeg.org/ffmpeg-utils.html#Expression-Evaluation

Note: See TracTickets for help on using tickets.