public class ServerControlField extends java.lang.Object implements ImageReturnTypes
Further information, see ISO/IEC 15444-9 section C.7
Modifier and Type | Field and Description |
---|---|
boolean |
align
align = "align" "=" ("yes" / "no")
This field specifies whether the server response data shall be aligned on natural boundaries.
|
float |
drate
drate = "drate" "=" rate-factor
rate-factor = UFLOAT This field is used to specify the delivery rate of various codestreams. |
java.util.ArrayList<java.lang.String> |
type
type = "type" "=" 1#image-return-type
image-return-type = media-type / reserved-image-return-type media-type = TOKEN "/" TOKEN *( ";" parameter ) reserved-image-return-type = TOKEN *( ";" parameter ) parameter = attribute "=" value attribute = TOKEN value = TOKEN This field is used to indicate the type (or types) of the requested response data. |
boolean |
useExtendedHeaders |
boolean |
wait
wait = "wait" "=" ("yes" / "no")
This field is used to indicate whether the server shall complete a response to the previous request.
|
JPP_STREAM, JPT_STREAM, MAX_IMAGE_RETURN_TYPES_ALLOWED, RAW
Constructor and Description |
---|
ServerControlField()
Constructor.
|
public boolean align
This field specifies whether the server response data shall be aligned on natural boundaries. The default value is "no". If the value is "yes", any JPT-stream or JPP-stream message delivered in response to this request which crosses any "natural boundary" shall terminate at any subsequent "natural boundary." The natural boundaries for each data-bin type are listed in the below table. A message is said to cross a natural boundary if it includes the last byte prior to the boundary, and the first byte after the boundary. For example, a precinct data-bin crosses a natural boundary if it includes the last byte of one packet and the first byte of the next packet. Note carefully that aligned response messages are not actually required to terminate at a natural boundary unless they cross a boundary. This means, for example, that the response may include partial packets from precincts, which may be necessary if a prevailing byte limit prevents the delivery of complete packets.
Bin type | Natural boundary |
Precinct data-bin | End of a packet (one boundary for each quality layer) |
Tile data-bin | End of a tile-part (one boundary for each tile-part) |
Tile header data-bin | End of the bin (only one boundary) |
Main data-bin | End of the bin (only one boundary) |
Metadata-bin | End of a box at the top level of the data-bin (one boundary for each box) |
public boolean wait
This field is used to indicate whether the server shall complete a response to the previous request. If the value of the field is "yes", the server shall completely respond to the previous request on the same channel resource specified through the channel ID field before starting to respond to this request. If the value of this field is "no", the server may gracefully terminate the processing of any previous request on the same channel resource (specified through the Channel ID field) prior to completion and may start to respond to this new request. In this context, "graceful termination" implies that the server shall at least complete the current message. The default value of this field is "no"
public java.util.ArrayList<java.lang.String> type
This field is used to indicate the type (or types) of the requested response data. A server unwilling to provide any of the requested return types shall issue an error response.
The value of the Image Return Type request field shall be either a media type (defined in RFC 2046) or one of the reserved image return types defined as:
Type | Interpretation |
"jpp-stream" | A JPP-stream as defined in Annex A. "jpp-stream" may optionally be followed by ";ptype=ext", in which case the requested return type is one in which all precinct databin message headers have the extended form. (see A.2.2) |
"jpt-stream" | A JPT-stream as defined in Annex A. "jpt-stream" may optionally be followed by ";ttype=ext", in which case the requested return type is one in which all tile data-bin message headers have the extended form. (see A.2.2) |
"raw" | The client is requesting the entire sequence of bytes in the logical target to be delivered unchanged. |
Other values | Reserved for ISO use |
public boolean useExtendedHeaders
public float drate
This field is used to specify the delivery rate of various codestreams. If this field is supplied, the server shall deliver data belonging to the various codestreams in the view-window following a temporally sequenced schedule. The codestreams which belong to the view-window are all those identified via the Codestream request field and the Codestream Context request field, possibly subsampled in accordance with the Sampling Rate request field.
public void reset()
public java.lang.String toString()
toString
in class java.lang.Object
public void list(java.io.PrintStream out)
out
- an output stream.
CADI - Copyright (C) 2007
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Group on Interactive Coding of Images (GICI) (contact)