| synopsis || return value || arguments || prev || next |

kdu_serve_target::read_metagroup

virtual int read_metagroup( const kds_metagroup * group, kdu_byte * buf, int offset, int num_bytes)

[Declared in "../apps/kdu_server/kdu_serve.h"]

Go to class description.


Synopsis

Reads a range of bytes from the data associated with a given kds_metagroup object. This group may represent a single JP2-family box at the top level of its corresponding meta data-bin. However, it may also represent a collection of boxes.


Return Value

The number of bytes actually read. This may be less than num_bytes only if not all data for the relevant JP2 boxes is available locally at the current time. This enables JPIP proxies to be implemented, which retrieve data from another server. If the data is not currently available, it will likely become available in the future, but the proxy server should proceed to serve up other data to its local clients, rather than wait.

Arguments

group [const kds_metagroup *]

buf [kdu_byte *]

offset [int]

num_bytes [int]


| top || synopsis || return value || arguments || prev || next |