add PdfPageEvent.onBeforePageStart

src/java/cljpdf/text/pdf/PdfDocument.java

@@ -1109,6 +1109,8 @@ public void resetFooter() {
      * @throws DocumentException on error
      */
     protected void initPage() throws DocumentException {
+        PdfPageEvent pageEvent = writer.getPageEvent();
+
         // the pagenumber is incremented
         pageN++;
 
@@ -1123,6 +1125,20 @@ protected void initPage() throws DocumentException {
         text.beginText();
         textEmptySize = text.size();
 
+        // the whole point of the onBeforeStartPage event is to make it so that it's possible to react
+        // to each new page at a point where it's still possible to change the page size and margins
+        // (among other settings) and have it take effect for the very next page that is being started.
+        // onStartPage and onEndPage are too late for this (though onEndPage would be the next best spot
+        // for this kind of code).
+        // however, in order to not break compatibility with existing code, i've opted to not move when
+        // onOpenDocument is triggered. as a result it's a little bit weird in that onBeforeStartPage
+        // will be triggered before onOpenDocument.
+        // (i personally do feel that onOpenDocument is being triggered too late... but whatever)
+        // - Gered King, March 2017
+        if (pageEvent != null) {
+            pageEvent.onBeforeStartPage(writer, this);
+        }
+
     	markPoint = 0;
         setNewPageSizeAndMargins();
         imageEnd = -1;
@@ -1162,7 +1178,6 @@ protected void initPage() throws DocumentException {
         alignment = oldAlignment;
         carriageReturn();
 
-        PdfPageEvent pageEvent = writer.getPageEvent();
         if (pageEvent != null) {
             if (firstPageEvent) {
                 pageEvent.onOpenDocument(writer, this);

src/java/cljpdf/text/pdf/PdfPageEvent.java

@@ -71,6 +71,19 @@ public interface PdfPageEvent {
  */
     public void onOpenDocument(PdfWriter writer, Document document);
 
+
+/**
+ * Called before a new page is about to be initialized.
+ * <P>
+ * This event allows for doing things such as resetting page margins
+ * or size, etc between pages, as it is too late to do certain adjustments
+ * in <CODE>onStartPage</CODE> and <CODE>onEndPage</CODE>.
+ *
+ * @param writer the <CODE>PdfWriter</CODE> for this document
+ * @param document the document
+ */
+    public void onBeforeStartPage(PdfWriter writer, Document document);
+
 /**
  * Called when a page is initialized.
  * <P>

src/java/cljpdf/text/pdf/PdfPageEventHelper.java

@@ -73,6 +73,19 @@ public class PdfPageEventHelper implements PdfPageEvent {
     public void onOpenDocument(PdfWriter writer,Document document) {
     }
 
+/**
+ * Called before a new page is about to be initialized.
+ * <P>
+ * This event allows for doing things such as resetting page margins
+ * or size, etc between pages, as it is too late to do certain adjustments
+ * in <CODE>onStartPage</CODE> and <CODE>onEndPage</CODE>.
+ *
+ * @param writer the <CODE>PdfWriter</CODE> for this document
+ * @param document the document
+ */
+    public void onBeforeStartPage(PdfWriter writer, Document document) {
+    }
+
 /**
  * Called when a page is initialized.
  * <P>

src/java/cljpdf/text/pdf/events/PdfPageEventForwarder.java

@@ -94,6 +94,24 @@ public void onOpenDocument(PdfWriter writer, Document document) {
 		}
 	}
 
+	/**
+	 * Called before a new page is about to be initialized.
+	 * <P>
+	 * This event allows for doing things such as resetting page margins
+	 * or size, etc between pages, as it is too late to do certain adjustments
+	 * in <CODE>onStartPage</CODE> and <CODE>onEndPage</CODE>.
+	 *
+	 * @param writer the <CODE>PdfWriter</CODE> for this document
+	 * @param document the document
+	 */
+	public void onBeforeStartPage(PdfWriter writer, Document document) {
+		PdfPageEvent event;
+		for (Iterator i = events.iterator(); i.hasNext(); ) {
+			event = (PdfPageEvent)i.next();
+			event.onBeforeStartPage(writer, document);
+		}
+	}
+
 	/**
 	 * Called when a page is initialized.
 	 * <P>