| synopsis || return value || arguments || prev || next |
bool load_matches( int num_codestreams, const int codestream_indices[], int num_compositing_layers, const int layer_indices[])
[Declared in "../apps/compressed_io/jpx.h"]
Call this function to make sure that as many relevant metadata boxes have been parsed as possible prior to using enumerate_matches to scan through the nodes which match a particular set of criteria. The present function attempts to parse any metadata boxes which have not already been fully parsed. The function also attempts to recover any metadata which may be nested inside codestream header boxes or compositing layer header boxes, where the codestreams and compositing layers of interest are identified by the function's arguments.
True if, as a result of calling this function, one or more new nodes which could be returned via a subsequent call to enumerate_matches have become available.
Number of codestream indices supplied via the codestream_indices array.
Array with num_codestreams elements. In addition to metadata boxes which appear at the top level of the file (or nested within association boxes which are at the top level of the file), the function also looks for any unparsed metadata within codestream header boxes belonging to the identified codestreams.
Number of compositing layer indices supplied via the layer_indices array.
Array with num_compositing_layers elements. In addition to metadata boxes which appear at the top level of the file (or nested within association boxes which are at the top level of the file), the function also looks for any unparsed metadata within compositing layer header boxes belonging to the identified compositing layers.
| top || synopsis || return value || arguments || prev || next |