Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
This file is part of the iText (R) project.
Copyright (c) 1998-2024 Apryse Group NV
Authors: Apryse Software.
This program is offered under a commercial and under the AGPL license.
For commercial licensing, contact us at https://itextpdf.com/sales. For AGPL licensing, see below.
AGPL licensing:
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 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 Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
*/
package com.itextpdf.kernel.pdf.navigation;
import com.itextpdf.kernel.pdf.IPdfNameTreeAccess;
import com.itextpdf.kernel.pdf.PdfArray;
import com.itextpdf.kernel.pdf.PdfName;
import com.itextpdf.kernel.pdf.PdfNumber;
import com.itextpdf.kernel.pdf.PdfObject;
/**
* This class shall be used for creation of destinations, associated Remote Go-To and Embedded Go-To actions only,
* i.e. the destination point is in another PDF.
* If you need to create a destination, associated with an object inside current PDF, you should use {@link PdfExplicitDestination} class instead.
*/
public class PdfExplicitRemoteGoToDestination extends PdfDestination {
public PdfExplicitRemoteGoToDestination() {
this(new PdfArray());
}
public PdfExplicitRemoteGoToDestination(PdfArray pdfObject) {
super(pdfObject);
}
@Override
public PdfObject getDestinationPage(IPdfNameTreeAccess names) {
return ((PdfArray)getPdfObject()).get(0);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified by the factor zoom and positioned at the upper-left corner of the window.
*
* @param pageNum the destination page
* @param left the X coordinate of the left edge of the destination rectangle
* @param top the Y coordinate of the upper edge of the destination rectangle
* @param zoom zoom factor
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createXYZ(int pageNum, float left, float top, float zoom) {
return create(pageNum, PdfName.XYZ, left, Float.NaN, Float.NaN, top, zoom);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the entire page within the window both horizontally and vertically.
*
* @param pageNum the destination page
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFit(int pageNum) {
return create(pageNum, PdfName.Fit, Float.NaN, Float.NaN, Float.NaN, Float.NaN, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the entire width of the page within the window.
*
* @param pageNum the destination page
* @param top the Y coordinate of the upper edge of the destination rectangle
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitH(int pageNum, float top) {
return create(pageNum, PdfName.FitH, Float.NaN, Float.NaN, Float.NaN, top, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the entire height of the page within the window.
*
* @param pageNum the destination page
* @param left the X coordinate of the left edge of the destination rectangle
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitV(int pageNum, float left) {
return create(pageNum, PdfName.FitV, left, Float.NaN, Float.NaN, Float.NaN, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the rectangle specified by the coordinates left, bottom, right, and top
* entirely within the window both horizontally and vertically.
*
* @param pageNum the destination page
* @param left the X coordinate of the left edge of the destination rectangle
* @param bottom the Y coordinate of the lower edge of the destination rectangle
* @param right the X coordinate of the right edge of the destination rectangle
* @param top the Y coordinate of the upper edge of the destination rectangle
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitR(int pageNum, float left, float bottom, float right, float top) {
return create(pageNum, PdfName.FitR, left, bottom, right, top, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit its bounding box entirely within the window both horizontally and vertically.
*
* @param pageNum the destination page
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitB(int pageNum) {
return create(pageNum, PdfName.FitB, Float.NaN, Float.NaN, Float.NaN, Float.NaN, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the entire width of its bounding box within the window.
*
* @param pageNum the destination page
* @param top the Y coordinate of the upper edge of the destination rectangle
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitBH(int pageNum, float top) {
return create(pageNum, PdfName.FitBH, Float.NaN, Float.NaN, Float.NaN, top, Float.NaN);
}
/**
* Creates {@link PdfExplicitRemoteGoToDestination}. The designated page will be displayed with its contents
* magnified just enough to fit the entire height of its bounding box within the window.
*
* @param pageNum the destination page
* @param left the X coordinate of the left edge of the destination rectangle
* @return newly created {@link PdfExplicitRemoteGoToDestination}
*/
public static PdfExplicitRemoteGoToDestination createFitBV(int pageNum, float left) {
return create(pageNum, PdfName.FitBH, left, Float.NaN, Float.NaN, Float.NaN, Float.NaN);
}
/**
* Creates a {@link PdfExplicitRemoteGoToDestination} associated with an object in another PDF document.
*
* @param pageNum the destination page
* @param type a {@link PdfName} specifying one of the possible ways to define the area to be displayed.
* See ISO 32000-1, section 12.3.2.2 "Explicit Destinations", Table 151 – Destination syntax
* @param left the X coordinate of the left edge of the destination rectangle
* @param bottom the Y coordinate of the lower edge of the destination rectangle
* @param right the X coordinate of the right edge of the destination rectangle
* @param top the Y coordinate of the upper edge of the destination rectangle
* @param zoom zoom factor
* @return newly created {@link PdfExplicitDestination}
*/
public static PdfExplicitRemoteGoToDestination create(int pageNum, PdfName type, float left, float bottom, float right, float top, float zoom) {
return new PdfExplicitRemoteGoToDestination().add(--pageNum).add(type).add(left).add(bottom).add(right).add(top).add(zoom);
}
@Override
protected boolean isWrappedObjectMustBeIndirect() {
return false;
}
private PdfExplicitRemoteGoToDestination add(float value) {
if (!Float.isNaN(value)) {
((PdfArray) getPdfObject()).add(new PdfNumber(value));
}
return this;
}
private PdfExplicitRemoteGoToDestination add(int value) {
((PdfArray)getPdfObject()).add(new PdfNumber(value));
return this;
}
private PdfExplicitRemoteGoToDestination add(PdfName type) {
((PdfArray)getPdfObject()).add(type);
return this;
}
}
