src/share/classes/javax/print/attribute/standard/JobMediaSheets.java

Print this page


   1 /*
   2  * Copyright (c) 2000, 2004, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


  40  * Even if the client does supply a value for the JobMediaSheets attribute in
  41  * the Print Request, the printer may choose to change the value if the printer
  42  * is able to compute a value which is more accurate than the client supplied
  43  * value. The printer may be able to determine the correct value for the
  44  * JobMediaSheets attribute either right at job submission time or at any later
  45  * point in time.
  46  * <P>
  47  * Unlike the {@link JobKOctets JobKOctets} and {@link JobImpressions
  48  * JobImpressions} attributes, the JobMediaSheets value must include the
  49  * multiplicative factors contributed by the number of copies specified by the
  50  * {@link Copies Copies} attribute and a "number of copies" instruction embedded
  51  * in the document data, if any. This difference allows the system administrator
  52  * to control the lower and upper bounds of both (1) the size of the document(s)
  53  * with {@link JobKOctetsSupported JobKOctetsSupported} and {@link
  54  * JobImpressionsSupported JobImpressionsSupported} and (2) the size of the job
  55  * with {@link JobMediaSheetsSupported JobMediaSheetsSupported}.
  56  * <P>
  57  * <B>IPP Compatibility:</B> The integer value gives the IPP integer value. The
  58  * category name returned by <CODE>getName()</CODE> gives the IPP attribute
  59  * name.
  60  * <P>
  61  *
  62  * @see JobMediaSheetsSupported
  63  * @see JobMediaSheetsCompleted
  64  * @see JobKOctets
  65  * @see JobImpressions
  66  *
  67  * @author  Alan Kaminsky
  68  */
  69 public class JobMediaSheets extends IntegerSyntax
  70         implements PrintRequestAttribute, PrintJobAttribute {
  71 
  72 
  73     private static final long serialVersionUID = 408871131531979741L;
  74 
  75     /**
  76      * Construct a new job media sheets attribute with the given integer
  77      * value.
  78      *
  79      * @param  value  Integer value.
  80      *


   1 /*
   2  * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


  40  * Even if the client does supply a value for the JobMediaSheets attribute in
  41  * the Print Request, the printer may choose to change the value if the printer
  42  * is able to compute a value which is more accurate than the client supplied
  43  * value. The printer may be able to determine the correct value for the
  44  * JobMediaSheets attribute either right at job submission time or at any later
  45  * point in time.
  46  * <P>
  47  * Unlike the {@link JobKOctets JobKOctets} and {@link JobImpressions
  48  * JobImpressions} attributes, the JobMediaSheets value must include the
  49  * multiplicative factors contributed by the number of copies specified by the
  50  * {@link Copies Copies} attribute and a "number of copies" instruction embedded
  51  * in the document data, if any. This difference allows the system administrator
  52  * to control the lower and upper bounds of both (1) the size of the document(s)
  53  * with {@link JobKOctetsSupported JobKOctetsSupported} and {@link
  54  * JobImpressionsSupported JobImpressionsSupported} and (2) the size of the job
  55  * with {@link JobMediaSheetsSupported JobMediaSheetsSupported}.
  56  * <P>
  57  * <B>IPP Compatibility:</B> The integer value gives the IPP integer value. The
  58  * category name returned by <CODE>getName()</CODE> gives the IPP attribute
  59  * name.

  60  *
  61  * @see JobMediaSheetsSupported
  62  * @see JobMediaSheetsCompleted
  63  * @see JobKOctets
  64  * @see JobImpressions
  65  *
  66  * @author  Alan Kaminsky
  67  */
  68 public class JobMediaSheets extends IntegerSyntax
  69         implements PrintRequestAttribute, PrintJobAttribute {
  70 
  71 
  72     private static final long serialVersionUID = 408871131531979741L;
  73 
  74     /**
  75      * Construct a new job media sheets attribute with the given integer
  76      * value.
  77      *
  78      * @param  value  Integer value.
  79      *