Class Overview
Class Sides is a printing attribute class, an enumeration, that specifies
how print-stream pages are to be imposed upon the sides of an instance of a
selected medium, i.e., an impression.
The effect of a Sides attribute on a multidoc print job (a job with multiple
documents) depends on whether all the docs have the same sides values
specified or whether different docs have different sides values specified,
and on the (perhaps defaulted) value of the MultipleDocumentHandling
attribute.
-
If all the docs have the same sides value n specified, then any value
of
MultipleDocumentHandling
makes sense,
and the printer's processing depends on the MultipleDocumentHandling
value:
-
SINGLE_DOCUMENT -- All the input docs will be combined together into one
output document. Each media sheet will consist of n impressions from
the output document.
-
SINGLE_DOCUMENT_NEW_SHEET -- All the input docs will be combined together
into one output document. Each media sheet will consist of n
impressions from the output document. However, the first impression of each
input doc will always start on a new media sheet; this means the last media
sheet of an input doc may have only one impression on it.
-
SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- The input docs will remain separate.
Each media sheet will consist of n impressions from the input doc.
Since the input docs are separate, the first impression of each input doc
will always start on a new media sheet; this means the last media sheet of
an input doc may have only one impression on it.
-
SEPARATE_DOCUMENTS_COLLATED_COPIES -- The input docs will remain separate.
Each media sheet will consist of n impressions from the input doc.
Since the input docs are separate, the first impression of each input doc
will always start on a new media sheet; this means the last media sheet of
an input doc may have only one impression on it.
-
SINGLE_DOCUMENT -- All the input docs will be combined together into one
output document. Each media sheet will consist of ni
impressions from the output document, where i is the number of the
input doc corresponding to that point in the output document. When the next
input doc has a different sides value from the previous input doc, the first
print-stream page of the next input doc goes at the start of the next media
sheet, possibly leaving only one impression on the previous media sheet.
-
SINGLE_DOCUMENT_NEW_SHEET -- All the input docs will be combined together
into one output document. Each media sheet will consist of n
impressions from the output document. However, the first impression of each
input doc will always start on a new media sheet; this means the last
impression of an input doc may have only one impression on it.
-
SEPARATE_DOCUMENTS_UNCOLLATED_COPIES -- The input docs will remain separate.
For input doc i, each media sheet will consist of ni
impressions from the input doc. Since the input docs are separate, the first
impression of each input doc will always start on a new media sheet; this
means the last media sheet of an input doc may have only one impression on
it.
-
SEPARATE_DOCUMENTS_COLLATED_COPIES -- The input docs will remain separate.
For input doc i, each media sheet will consist of ni
impressions from the input doc. Since the input docs are separate, the first
impression of each input doc will always start on a new media sheet; this
means the last media sheet of an input doc may have only one impression on
it.
IPP Compatibility: The category name returned by
getName()
is the IPP attribute name. The enumeration's
integer value is the IPP enum value. The toString()
method
returns the IPP string representation of the attribute value.
Summary
Fields |
public
static
final
Sides |
DUPLEX |
An alias for "two sided long edge" (see TWO_SIDED_LONG_EDGE ). |
public
static
final
Sides |
ONE_SIDED |
Imposes each consecutive print-stream page upon the same side of
consecutive media sheets. |
public
static
final
Sides |
TUMBLE |
An alias for "two sided short edge" (see TWO_SIDED_SHORT_EDGE ). |
public
static
final
Sides |
TWO_SIDED_LONG_EDGE |
Imposes each consecutive pair of print-stream pages upon front and back
sides of consecutive media sheets, such that the orientation of each
pair of print-stream pages on the medium would be correct for the
reader as if for binding on the long edge. |
public
static
final
Sides |
TWO_SIDED_SHORT_EDGE |
Imposes each consecutive pair of print-stream pages upon front and back
sides of consecutive media sheets, such that the orientation of each
pair of print-stream pages on the medium would be correct for the
reader as if for binding on the short edge. |
Protected Constructors |
|
Sides(int value)
Construct a new sides enumeration value with the given integer value.
|
Public Methods |
final
Class<? extends Attribute>
|
getCategory()
Get the printing attribute class which is to be used as the "category"
for this printing attribute value.
|
final
String
|
getName()
Get the name of the category of which this attribute value is an
instance.
|
[Expand]
Inherited Methods |
From class
javax.print.attribute.EnumSyntax
Object
|
clone()
Returns a clone of this enumeration value, which to preserve the
semantics of enumeration values is the same object as this enumeration
value.
|
EnumSyntax[]
|
getEnumValueTable()
Returns the enumeration value table for this enumeration value's
enumeration class.
|
int
|
getOffset()
Returns the lowest integer value used by this enumeration value's
enumeration class.
|
String[]
|
getStringTable()
Returns the string table for this enumeration value's enumeration class.
|
int
|
getValue()
Returns this enumeration value's integer value.
|
int
|
hashCode()
Returns a hash code value for this enumeration value.
|
Object
|
readResolve()
During object input, convert this deserialized enumeration instance to
the proper enumeration value defined in the enumeration attribute class.
|
String
|
toString()
Returns a string value corresponding to this enumeration value.
|
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
From interface
javax.print.attribute.Attribute
abstract
Class<? extends Attribute>
|
getCategory()
Get the printing attribute class which is to be used as the "category"
for this printing attribute value when it is added to an attribute set.
|
abstract
String
|
getName()
Get the name of the category of which this attribute value is an
instance.
|
|
Fields
public
static
final
Sides
DUPLEX
public
static
final
Sides
ONE_SIDED
Imposes each consecutive print-stream page upon the same side of
consecutive media sheets.
public
static
final
Sides
TUMBLE
public
static
final
Sides
TWO_SIDED_LONG_EDGE
Imposes each consecutive pair of print-stream pages upon front and back
sides of consecutive media sheets, such that the orientation of each
pair of print-stream pages on the medium would be correct for the
reader as if for binding on the long edge. This imposition is also
known as "duplex" (see DUPLEX
).
public
static
final
Sides
TWO_SIDED_SHORT_EDGE
Imposes each consecutive pair of print-stream pages upon front and back
sides of consecutive media sheets, such that the orientation of each
pair of print-stream pages on the medium would be correct for the
reader as if for binding on the short edge. This imposition is also
known as "tumble" (see TUMBLE
).
Protected Constructors
protected
Sides
(int value)
Construct a new sides enumeration value with the given integer value.
Public Methods
public
final
Class<? extends Attribute>
getCategory
()
Get the printing attribute class which is to be used as the "category"
for this printing attribute value.
For class Sides, the category is class Sides itself.
public
final
String
getName
()
Get the name of the category of which this attribute value is an
instance.
For class Sides, the category name is "sides"
.
Protected Methods
protected
EnumSyntax[]
getEnumValueTable
()
Returns the enumeration value table for class Sides.
protected
String[]
getStringTable
()
Returns the string table for class Sides.