comparison dvdnav/dvdnav.h @ 413:f30f443d3841 src

Fix typos Mike Castle kindly sent a patch to fix a few typos in dvdnav.h. Thanks Mike!

412:34e632fb6a39

/*********************************************************************
 * reading data                                                      *
 *********************************************************************/

/*
 * These functions are used to poll the playback enginge and actually get data
 * off the DVD.
 */

/*
 * Attempts to get the next block off the DVD and copies it into the buffer 'buf'.

dvdnav_status_t dvdnav_time_search(dvdnav_t *self,
				   uint64_t time);

/*
 * Stop playing current position and play the "GoUp"-program chain.
 * (which generally leads to the title menu or a higer-level menu).
 */
dvdnav_status_t dvdnav_go_up(dvdnav_t *self);

/*
 * Stop playing the current position and start playback at the

 *********************************************************************/

/*
 * Return a string describing the title of the DVD.
 * This is an ID string encoded on the disc by the author. In many cases
 * this is a descriptive string such as `THE_MATRIX' but sometimes is sigularly
 * uninformative such as `PDVD-011421'. Some DVD authors even forget to set this,
 * so you may also read the default of the authoring software they used, like
 * `DVDVolume'.
 */
dvdnav_status_t dvdnav_get_title_string(dvdnav_t *self, const char **title_str);

 * (returns 0xffff if no such stream).
 */
uint16_t dvdnav_audio_stream_format(dvdnav_t *self, uint8_t stream);

/*
 * Returns number of channelsn in *logical* audio stream 'stream'
 * (returns 0xffff if no such stream).
 */
uint16_t dvdnav_audio_stream_channels(dvdnav_t *self, uint8_t stream);

/*

 * dvdnav_get_angle_info() as definitive only up to the next time you call
 * dvdnav_get_next_block().
 */

/*
 * Sets the current angle. If you try to follow a non existant angle
 * the call fails.
 */
dvdnav_status_t dvdnav_angle_change(dvdnav_t *self, int32_t angle);

/*

413:f30f443d3841

/*********************************************************************
 * reading data                                                      *
 *********************************************************************/

/*
 * These functions are used to poll the playback engine and actually get data
 * off the DVD.
 */

/*
 * Attempts to get the next block off the DVD and copies it into the buffer 'buf'.

dvdnav_status_t dvdnav_time_search(dvdnav_t *self,
				   uint64_t time);

/*
 * Stop playing current position and play the "GoUp"-program chain.
 * (which generally leads to the title menu or a higher-level menu).
 */
dvdnav_status_t dvdnav_go_up(dvdnav_t *self);

/*
 * Stop playing the current position and start playback at the

 *********************************************************************/

/*
 * Return a string describing the title of the DVD.
 * This is an ID string encoded on the disc by the author. In many cases
 * this is a descriptive string such as `THE_MATRIX' but sometimes is singularly
 * uninformative such as `PDVD-011421'. Some DVD authors even forget to set this,
 * so you may also read the default of the authoring software they used, like
 * `DVDVolume'.
 */
dvdnav_status_t dvdnav_get_title_string(dvdnav_t *self, const char **title_str);

 * (returns 0xffff if no such stream).
 */
uint16_t dvdnav_audio_stream_format(dvdnav_t *self, uint8_t stream);

/*
 * Returns number of channels in *logical* audio stream 'stream'
 * (returns 0xffff if no such stream).
 */
uint16_t dvdnav_audio_stream_channels(dvdnav_t *self, uint8_t stream);

/*

 * dvdnav_get_angle_info() as definitive only up to the next time you call
 * dvdnav_get_next_block().
 */

/*
 * Sets the current angle. If you try to follow a non existent angle
 * the call fails.
 */
dvdnav_status_t dvdnav_angle_change(dvdnav_t *self, int32_t angle);

/*