-
Notifications
You must be signed in to change notification settings - Fork 7.6k
doc: migration-guide-4.2: video: add note on pitch #90110
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc: migration-guide-4.2: video: add note on pitch #90110
Conversation
doc/releases/migration-guide-4.2.rst
Outdated
* video_format.pitch is no longer to be set by the application, but instead written back by | ||
the driver letting the application know how much padding this particular driver will use | ||
per line and in turn know the required buffer size. Existing applications will not be | ||
broken by this change but can be simplified as performed in the samplesp in the commit |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/samplesp/sample
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! I also split an overly long sentence in half in the process.
d0fc96b
to
f9a1ab4
Compare
doc/releases/migration-guide-4.2.rst
Outdated
the driver. Then the application can know how much padding this particular driver uses | ||
per line, and in turn know the required buffer size. Existing applications will not be | ||
broken by this change but can be simplified as performed in the sample in the commit | ||
``33dcbe37cfd3593e8c6e9cfd218dd31fdd533598``. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A proposed re-wording:
video_format.ptich has been updated to be set explicitly by the driver, a task formerly required of the application.
This update enables the application to correctly allocate a buffer size on a per driver basis. Existing applications
will not be broken by this change but can be simplified as performed in the sample in the commit
``33dcbe37cfd3593e8c6e9cfd218dd31fdd533598``.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good to be synthetic and high-level here... Thanks!
f9a1ab4
to
1491a9e
Compare
Force-push:
|
|
Document the change of semantics of video_format.pitch field, modified in commit 33dcbe3. Signed-off-by: Josuah Demangeon <me@josuah.net>
Dependencies:
Document the change of semantics of video_format.pitch field, modified in 33dcbe3
A separate patch to allow it to be discussed separately and speed-up #87366 review.