Class Overview
Class PrinterResolution is a printing attribute class that specifies an
exact resolution supported by a printer or to be used for a print job.
This attribute assumes that printers have a small set of device resolutions
at which they can operate rather than a continuum.
PrinterResolution is used in multiple ways:
-
When a client searches looking for a printer that supports the client's
desired resolution exactly (no more, no less), the client specifies
an instance of class PrinterResolution indicating the exact resolution the
client wants. Only printers supporting that exact resolution will match the
search.
-
When a client needs to print a job using the client's desired resolution
exactly (no more, no less), the client specifies an instance of class
PrinterResolution as an attribute of the Print Job. This will fail if the
Print Job doesn't support that exact resolution, and Fidelity is set to
true.
If a client wants to locate a printer supporting a resolution
greater than some required minimum, then it may be necessary to exclude
this attribute from a lookup request and to directly query the set of
supported resolutions, and specify the one that most closely meets
the client's requirements.
In some cases this may be more simply achieved by specifying a
PrintQuality attribute which often controls resolution.
IPP Compatibility: The information needed to construct an IPP
"printer-resolution"
attribute can be obtained by calling
methods on the PrinterResolution object. The category name returned by
getName()
gives the IPP attribute name.
Summary
Public Constructors |
|
PrinterResolution(int crossFeedResolution, int feedResolution, int units)
Construct a new printer resolution attribute from the given items.
|
Public Methods |
boolean
|
equals(Object object)
Returns whether this printer resolution attribute is equivalent to the
passed in object.
|
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.ResolutionSyntax
boolean
|
equals(Object object)
Returns whether this resolution attribute is equivalent to the passed in
object.
|
int
|
getCrossFeedResolution(int units)
Returns this resolution attribute's cross feed direction resolution in
the given units.
|
int
|
getCrossFeedResolutionDphi()
Returns this resolution attribute's cross feed direction resolution in
units of dphi.
|
int
|
getFeedResolution(int units)
Returns this resolution attribute's feed direction resolution in the
given units.
|
int
|
getFeedResolutionDphi()
Returns this resolution attribute's feed direction resolution in units
of dphi.
|
int[]
|
getResolution(int units)
Get this resolution attribute's resolution values in the given units.
|
int
|
hashCode()
Returns a hash code value for this resolution attribute.
|
boolean
|
lessThanOrEquals(ResolutionSyntax other)
Determine whether this resolution attribute's value is less than or
equal to the given resolution attribute's value.
|
String
|
toString(int units, String unitsName)
Returns a string version of this resolution attribute in the given units.
|
String
|
toString()
Returns a string version of this resolution attribute.
|
|
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.
|
|
Public Constructors
public
PrinterResolution
(int crossFeedResolution, int feedResolution, int units)
Construct a new printer resolution attribute from the given items.
Parameters
crossFeedResolution
| Cross feed direction resolution. |
feedResolution
| Feed direction resolution. |
units
| Unit conversion factor, e.g. ResolutionSyntax.DPI
or ResolutionSyntax.>DPCM . |
Public Methods
public
boolean
equals
(Object object)
Returns whether this printer resolution attribute is equivalent to the
passed in object. To be equivalent, all of the following conditions
must be true:
-
object
is not null.
-
object
is an instance of class PrinterResolution.
-
This attribute's cross feed direction resolution is equal to
object
's cross feed direction resolution.
-
This attribute's feed direction resolution is equal to
object
's feed direction resolution.
Parameters
object
| Object to compare to. |
Returns
- True if
object
is equivalent to this printer
resolution attribute, false otherwise.
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 PrinterResolution, the category is class PrinterResolution itself.
public
final
String
getName
()
Get the name of the category of which this attribute value is an
instance.
For class PrinterResolution, the
category name is "printer-resolution"
.