OLD | NEW |
1 /* libFLAC - Free Lossless Audio Codec library | 1 /* libFLAC - Free Lossless Audio Codec library |
2 * Copyright (C) 2001,2002,2003,2004,2005,2006,2007 Josh Coalson | 2 * Copyright (C) 2001-2009 Josh Coalson |
| 3 * Copyright (C) 2011-2014 Xiph.Org Foundation |
3 * | 4 * |
4 * Redistribution and use in source and binary forms, with or without | 5 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 6 * modification, are permitted provided that the following conditions |
6 * are met: | 7 * are met: |
7 * | 8 * |
8 * - Redistributions of source code must retain the above copyright | 9 * - Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 10 * notice, this list of conditions and the following disclaimer. |
10 * | 11 * |
11 * - Redistributions in binary form must reproduce the above copyright | 12 * - Redistributions in binary form must reproduce the above copyright |
12 * notice, this list of conditions and the following disclaimer in the | 13 * notice, this list of conditions and the following disclaimer in the |
(...skipping 479 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
492 * blocks. | 493 * blocks. |
493 * | 494 * |
494 * \param iterator A pointer to an existing initialized iterator. | 495 * \param iterator A pointer to an existing initialized iterator. |
495 * \assert | 496 * \assert |
496 * \code iterator != NULL \endcode | 497 * \code iterator != NULL \endcode |
497 * \a iterator has been successfully initialized with | 498 * \a iterator has been successfully initialized with |
498 * FLAC__metadata_simple_iterator_init() | 499 * FLAC__metadata_simple_iterator_init() |
499 * \retval unsigned | 500 * \retval unsigned |
500 * The length of the metadata block at the current iterator position. | 501 * The length of the metadata block at the current iterator position. |
501 * The is same length as that in the | 502 * The is same length as that in the |
502 * <a href="http://flac.sourceforge.net/format.html#metadata_block_header">me
tadata block header</a>, | 503 * <a href="http://xiph.org/flac/format.html#metadata_block_header">metadata
block header</a>, |
503 * i.e. the length of the metadata body that follows the header. | 504 * i.e. the length of the metadata body that follows the header. |
504 */ | 505 */ |
505 FLAC_API unsigned FLAC__metadata_simple_iterator_get_block_length(const FLAC__Me
tadata_SimpleIterator *iterator); | 506 FLAC_API unsigned FLAC__metadata_simple_iterator_get_block_length(const FLAC__Me
tadata_SimpleIterator *iterator); |
506 | 507 |
507 /** Get the application ID of the \c APPLICATION block at the current | 508 /** Get the application ID of the \c APPLICATION block at the current |
508 * position. This avoids reading the actual block data which can save | 509 * position. This avoids reading the actual block data which can save |
509 * time for large blocks. | 510 * time for large blocks. |
510 * | 511 * |
511 * \param iterator A pointer to an existing initialized iterator. | 512 * \param iterator A pointer to an existing initialized iterator. |
512 * \param id A pointer to a buffer of at least \c 4 bytes where | 513 * \param id A pointer to a buffer of at least \c 4 bytes where |
(...skipping 1466 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1979 * \param track_num Index into track array to set. NOTE: this is not | 1980 * \param track_num Index into track array to set. NOTE: this is not |
1980 * necessarily the same as the track's \a number field. | 1981 * necessarily the same as the track's \a number field. |
1981 * \param track The track to set the track to. You may safely pass in | 1982 * \param track The track to set the track to. You may safely pass in |
1982 * a const pointer if \a copy is \c true. | 1983 * a const pointer if \a copy is \c true. |
1983 * \param copy See above. | 1984 * \param copy See above. |
1984 * \assert | 1985 * \assert |
1985 * \code object != NULL \endcode | 1986 * \code object != NULL \endcode |
1986 * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode | 1987 * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode |
1987 * \code track_num < object->data.cue_sheet.num_tracks \endcode | 1988 * \code track_num < object->data.cue_sheet.num_tracks \endcode |
1988 * \code (track->indices != NULL && track->num_indices > 0) || | 1989 * \code (track->indices != NULL && track->num_indices > 0) || |
1989 * (track->indices == NULL && track->num_indices == 0) | 1990 * (track->indices == NULL && track->num_indices == 0) \endcode |
1990 * \retval FLAC__bool | 1991 * \retval FLAC__bool |
1991 * \c false if \a copy is \c true and malloc() fails, else \c true. | 1992 * \c false if \a copy is \c true and malloc() fails, else \c true. |
1992 */ | 1993 */ |
1993 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_set_track(FLAC__StreamMetadat
a *object, unsigned track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC_
_bool copy); | 1994 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_set_track(FLAC__StreamMetadat
a *object, unsigned track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC_
_bool copy); |
1994 | 1995 |
1995 /** Insert a track in a CUESHEET block at the given index. | 1996 /** Insert a track in a CUESHEET block at the given index. |
1996 * | 1997 * |
1997 * If \a copy is \c true, a copy of the track is stored; otherwise, the object | 1998 * If \a copy is \c true, a copy of the track is stored; otherwise, the object |
1998 * takes ownership of the \a track pointer. | 1999 * takes ownership of the \a track pointer. |
1999 * | 2000 * |
(...skipping 172 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2172 */ | 2173 */ |
2173 FLAC_API FLAC__bool FLAC__metadata_object_picture_is_legal(const FLAC__StreamMet
adata *object, const char **violation); | 2174 FLAC_API FLAC__bool FLAC__metadata_object_picture_is_legal(const FLAC__StreamMet
adata *object, const char **violation); |
2174 | 2175 |
2175 /* \} */ | 2176 /* \} */ |
2176 | 2177 |
2177 #ifdef __cplusplus | 2178 #ifdef __cplusplus |
2178 } | 2179 } |
2179 #endif | 2180 #endif |
2180 | 2181 |
2181 #endif | 2182 #endif |
OLD | NEW |