Opened 2 years ago
Closed 2 years ago
#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 , 2 years ago
Priority: | important → minor |
---|---|
Version: | unspecified → git-master |
follow-up: 3 comment:2 by , 2 years ago
comment:3 by , 2 years 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.
comment:4 by , 2 years ago
Resolution: | → invalid |
---|---|
Status: | new → closed |
Docs exist! And are pretty good, too. https://ffmpeg.org/ffmpeg-utils.html#Expression-Evaluation
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.