/**
 * <copyright> Copyright 2006 by Know-Center, Graz, Austria </copyright>
 * PDF-AS has been contracted by the E-Government Innovation Center EGIZ, a
 * joint initiative of the Federal Chancellery Austria and Graz University of
 * Technology.
 *
 * Licensed under the EUPL, Version 1.1 or - as soon they will be approved by
 * the European Commission - subsequent versions of the EUPL (the "Licence");
 * You may not use this work except in compliance with the Licence.
 * You may obtain a copy of the Licence at:
 * http://www.osor.eu/eupl/
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the Licence is distributed on an "AS IS" basis,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the Licence for the specific language governing permissions and
 * limitations under the Licence.
 *
 * This product combines work with different licenses. See the "NOTICE" text
 * file for details on the various modules and licenses.
 * The "NOTICE" text file is part of the distribution. Any derivative works
 * that you distribute must include a readable copy of the "NOTICE" text file.
 *
 * $Id:  $
 */
package at.knowcenter.wag.egov.egiz.pdf;

/**
 * The positioning instruction holds information of where to place the signature
 * block.
 * 
 * <p>
 * This instruction is given to the PDF writer in order to place the signature.
 * </p>
 * 
 * @author wprinz
 */
public class PositioningInstruction
{

  /**
   * Tells, if a new plain page should be appended.
   * 
   * <p>
   * This command is executed before the signature block is positioned according
   * to page, x and y.
   * </p>
   */
  protected boolean make_new_page = false;

  /**
   * The number of the page on which the signature block is to be placed. If
   * specified to make a new page, the number of this newly created page can be
   * used here as well.
   */
  protected int page = 0;

  /**
   * The x coordinate where the upper left corner of the signature block should
   * be placed.
   */
  protected float x = 0.0f;

  /**
   * The y coordinate where the upper left corner of the signature block should
   * be placed.
   */
  protected float y = 0.0f;

  /**
   * 
   * @param make_new_page
   *          Tells, if a new plain page should be appended. This command is
   *          executed before the signature block is positioned according to
   *          page, x and y.
   * @param page
   *          The number of the page on which the signature block is to be
   *          placed. If specified to make a new page, the number of this newly
   *          created page can be used here as well.
   * @param x
   *          The x coordinate where the upper left corner of the signature
   *          block should be placed.
   * @param y
   *          The y coordinate where the upper left corner of the signature
   *          block should be placed.
   */
  public PositioningInstruction(boolean make_new_page, int page, float x, float y)
  {
    this.make_new_page = make_new_page;
    this.page = page;
    this.x = x;
    this.y = y;
  }

  /**
   * Tells, if a new plain page should be appended to the document.
   * 
   * @return Returns true, if a new plain page should be appended.
   */
  public boolean isMakeNewPage()
  {
    return this.make_new_page;
  }

  /**
   * Returns the page on which the signature is to be printed.
   * 
   * @return Returns the page on which the signature is to be printed.
   */
  public int getPage()
  {
    return this.page;
  }

  /**
   * Returns the x coordinate where the upper left corner of the signature block
   * should be placed.
   * 
   * @return Returns the x coordinate where the upper left corner of the
   *         signature block should be placed.
   */
  public float getX()
  {
    return this.x;
  }

  /**
   * Returns the y coordinate where the upper left corner of the signature block
   * should be placed.
   * 
   * @return Returns the y coordinate where the upper left corner of the
   *         signature block should be placed.
   */
  public float getY()
  {
    return this.y;
  }

}