| synopsis || return value || arguments || prev || next |
virtual bool get_window_in_progress( kdu_window * window)
[Declared in "../apps/compressed_io/kdu_client.h"]
This function may be used to learn about the window which the server is currently servicing.
If the server is idle, meaning that it has finished serving all request outstanding requests, an appropriate status message will appear, but the present function will continue to identify the most recently serviced window as the one which is in progress.
If there is no active connection with the server ( is_alive returns false), the present function returns false, with window→num_components equal to 0.
True if the window which the server is currently serving or about to start serving corresponds to the window which was most recently requested via a call to post_window which returned true. Otherwise, the function returns false, meaning that the server has not yet finished serving a previous window request, or no request message has yet been sent to the server.
This argument may be NULL, in which case only the function's return value has any meaning. Otherwise, the function modifies the various members of this object to indicate the current window which is being serviced by the server.
Note that the window→resolution member will be set to reflect the dimensions of the image resolution which is currently being served. These can, and probably should, be used in posting new window requests at the same image resolution.
If the server has not yet responded to any window request, the window object will be set to its initialized state (i.e., the function automatically invokes window→init).
| top || synopsis || return value || arguments || prev || next |