PDF Annotation - Add/Edit - Python Sample Code

1//
2// Copyright (c) 2001-2024 by Apryse Software Inc. All Rights Reserved.
3//
4
5using pdftron;
6using pdftron.Common;
7using pdftron.Filters;
8using pdftron.SDF;
9using pdftron.PDF;
10using pdftron.PDF.Annots;
11
12namespace AnnotationTestCS
13{
14	/// <summary>
15	/// Summary description for Class1.
16	/// </summary>
17	class Class1
18	{
19		private static pdftron.PDFNetLoader pdfNetLoader = pdftron.PDFNetLoader.Instance();
20		static Class1() {}
21
22		private static void AnnotationHighLevelAPI(PDFDoc doc)
23		{
24			// The following code snippet traverses all annotations in the document
25			System.Console.WriteLine("Traversing all annotations in the document...");
26
27			string uri;
28			int page_num = 1;
29			for (PageIterator itr = doc.GetPageIterator(); itr.HasNext(); itr.Next())
30			{
31				System.Console.WriteLine("Page " + page_num++ + ": ");
32
33				Page page = itr.Current();
34				int num_annots = page.GetNumAnnots();
35				for (int i = 0; i < num_annots; ++i)
36				{
37					Annot annot = page.GetAnnot(i);
38					if (!annot.IsValid()) continue;
39					System.Console.WriteLine("Annot Type: " + annot.GetSDFObj().Get("Subtype").Value().GetName());
40
41					Rect bbox = annot.GetRect();
42					System.Console.WriteLine("  Position: " + bbox.x1
43						+ ", " + bbox.y1
44						+ ", " + bbox.x2
45						+ ", " + bbox.y2);
46
47					switch (annot.GetType())
48					{
49						case Annot.Type.e_Link:
50							{
51								Link lnk = new Link(annot);
52								Action action = lnk.GetAction();
53								if (!action.IsValid()) continue;
54								if (action.GetType() == Action.Type.e_GoTo)
55								{
56									Destination dest = action.GetDest();
57									if (!dest.IsValid())
58									{
59										System.Console.WriteLine("  Destination is not valid");
60									}
61									else
62									{
63										int pg_num = dest.GetPage().GetIndex();
64										System.Console.WriteLine("  Links to: page number " + pg_num + " in this document");
65									}
66								}
67								else if (action.GetType() == Action.Type.e_URI)
68								{
69									uri = action.GetSDFObj().Get("URI").Value().GetAsPDFText();
70									System.Console.WriteLine("  Links to: " + uri);
71								}
72								// ...
73							}
74							break;
75						case Annot.Type.e_Widget:
76							break;
77						case Annot.Type.e_FileAttachment:
78							break;
79						// ...
80						default:
81							break;
82					}
83				}
84			}
85
86			// Use the high-level API to create new annotations.
87			Page first_page = doc.GetPage(1);
88
89			// Create a hyperlink...
90			Link hyperlink = Link.Create(doc, new Rect(85, 570, 503, 524), Action.CreateURI(doc, "http://www.pdftron.com"));
91			first_page.AnnotPushBack(hyperlink);
92
93			// Create an intra-document link...
94			Action goto_page_3 = Action.CreateGoto(Destination.CreateFitH(doc.GetPage(3), 0));
95			Link link = Link.Create(doc, new Rect(85, 458, 503, 502), goto_page_3);
96			link.SetColor(new ColorPt(0, 0, 1));
97
98			// Add the new annotation to the first page
99			first_page.AnnotPushBack(link);
100
101			// Create a stamp annotation ...
102			RubberStamp stamp = RubberStamp.Create(doc, new Rect(30, 30, 300, 200));
103			stamp.SetIcon("Draft");
104			first_page.AnnotPushBack(stamp);
105
106			// Create a file attachment annotation (embed the 'peppers.jpg').
107			FileAttachment file_attach = FileAttachment.Create(doc, new Rect(80, 280, 108, 320), (input_path + "peppers.jpg"));
108			first_page.AnnotPushBack(file_attach);
109
110
111			Ink ink = Ink.Create(doc, new Rect(110, 10, 300, 200));
112			Point pt3 = new Point(110, 10);
113			//pt3.x = 110; pt3.y = 10;
114			ink.SetPoint(0, 0, pt3);
115			pt3.x = 150; pt3.y = 50;
116			ink.SetPoint(0, 1, pt3);
117			pt3.x = 190; pt3.y = 60;
118			ink.SetPoint(0, 2, pt3);
119			pt3.x = 180; pt3.y = 90;
120			ink.SetPoint(1, 0, pt3);
121			pt3.x = 190; pt3.y = 95;
122			ink.SetPoint(1, 1, pt3);
123			pt3.x = 200; pt3.y = 100;
124			ink.SetPoint(1, 2, pt3);
125			pt3.x = 166; pt3.y = 86;
126			ink.SetPoint(2, 0, pt3);
127			pt3.x = 196; pt3.y = 96;
128			ink.SetPoint(2, 1, pt3);
129			pt3.x = 221; pt3.y = 121;
130			ink.SetPoint(2, 2, pt3);
131			pt3.x = 288; pt3.y = 188;
132			ink.SetPoint(2, 3, pt3);
133			ink.SetColor(new ColorPt(0, 1, 1), 3);
134			first_page.AnnotPushBack(ink);
135		}
136
137		static void AnnotationLowLevelAPI(PDFDoc doc)
138		{
139			Page page = doc.GetPage(1);
140
141			Obj annots = page.GetAnnots();
142			if (annots == null)
143			{
144				// If there are no annotations, create a new annotation 
145				// array for the page.
146				annots = doc.CreateIndirectArray();
147				page.GetSDFObj().Put("Annots", annots);
148			}
149
150			// Create the Text annotation
151			Obj text_annot = doc.CreateIndirectDict();
152			text_annot.PutName("Subtype", "Text");
153			text_annot.PutBool("Open", true);
154			text_annot.PutString("Contents", "The quick brown fox ate the lazy mouse.");
155			text_annot.PutRect("Rect", 266, 116, 430, 204);
156
157			// Insert the annotation in the page annotation array
158			annots.PushBack(text_annot);
159
160			// Create a Link annotation
161			Obj link1 = doc.CreateIndirectDict();
162			link1.PutName("Subtype", "Link");
163			Destination dest = Destination.CreateFit(doc.GetPage(2));
164			link1.Put("Dest", dest.GetSDFObj());
165			link1.PutRect("Rect", 85, 705, 503, 661);
166			annots.PushBack(link1);
167
168			// Create another Link annotation
169			Obj link2 = doc.CreateIndirectDict();
170			link2.PutName("Subtype", "Link");
171			Destination dest2 = Destination.CreateFit(doc.GetPage(3));
172			link2.Put("Dest", dest2.GetSDFObj());
173			link2.PutRect("Rect", 85, 638, 503, 594);
174			annots.PushBack(link2);
175
176			// Note that PDFNet APi can be used to modify existing annotations. 
177			// In the following example we will modify the second link annotation 
178			// (link2) so that it points to the 10th page. We also use a different 
179			// destination page fit type.
180
181			link2.Put("Dest",
182				Destination.CreateXYZ(doc.GetPage(10), 100, 792 - 70, 10).GetSDFObj());
183
184			// Create a third link annotation with a hyperlink action (all other 
185			// annotation types can be created in a similar way)
186			Obj link3 = doc.CreateIndirectDict();
187			link3.PutName("Subtype", "Link");
188			link3.PutRect("Rect", 85, 570, 503, 524);
189
190			// Create a URI action
191			Obj action = link3.PutDict("A");
192			action.PutName("S", "URI");
193			action.PutString("URI", "http://www.pdftron.com");
194			annots.PushBack(link3);
195		}
196		
197		private static void CreateTestAnnots(PDFDoc doc) {
198
199			ElementWriter ew = new ElementWriter();
200			ElementBuilder eb = new ElementBuilder();
201			Element element;
202
203			Page first_page= doc.PageCreate(new Rect(0, 0, 600, 600));
204			doc.PagePushBack(first_page);
205			ew.Begin(first_page, ElementWriter.WriteMode.e_overlay, false );	// begin writing to this page
206			ew.End();  // save changes to the current page
207
208			//
209			// Test of a free text annotation.
210			//
211			{
212				FreeText txtannot = FreeText.Create( doc, new Rect(10, 400, 160, 570)  );
213				txtannot.SetContents( "\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare." +
214									  "\n\nAha!\n\nAnd there was much rejoicing!" );
215				txtannot.SetBorderStyle( new Annot.BorderStyle( Annot.BorderStyle.Style.e_solid, 1, 10, 20 ) );
216				txtannot.SetQuaddingFormat(0);
217				first_page.AnnotPushBack(txtannot);
218				txtannot.RefreshAppearance();
219			}
220			{
221				FreeText txtannot = FreeText.Create( doc, new Rect(100, 100, 350, 500)  );
222				txtannot.SetContentRect( new Rect( 200, 200, 350, 500 ) );
223				txtannot.SetContents( "\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare." +
224									  "\n\nAha!\n\nAnd there was much rejoicing!" );
225				txtannot.SetCalloutLinePoints( new Point(200,300), new Point(150,290), new Point(110,110) );
226				txtannot.SetBorderStyle(new Annot.BorderStyle(Annot.BorderStyle.Style.e_solid, 1, 10, 20 ) );
227				txtannot.SetEndingStyle(Line.EndingStyle.e_ClosedArrow );
228				txtannot.SetColor( new ColorPt( 0, 1, 0 ) );
229				txtannot.SetQuaddingFormat(1);
230				first_page.AnnotPushBack(txtannot);
231				txtannot.RefreshAppearance();
232			}
233			{
234				FreeText txtannot = FreeText.Create( doc, new Rect(400, 10, 550, 400)  );
235				txtannot.SetContents( "\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare." +
236									  "\n\nAha!\n\nAnd there was much rejoicing!" );
237				txtannot.SetBorderStyle( new Annot.BorderStyle( Annot.BorderStyle.Style.e_solid, 1, 10, 20 ) );
238				txtannot.SetColor( new ColorPt( 0, 0, 1 ) );
239				txtannot.SetOpacity( 0.2 );
240				txtannot.SetQuaddingFormat(2);
241				first_page.AnnotPushBack(txtannot);
242				txtannot.RefreshAppearance();
243			}
244
245			Page page= doc.PageCreate(new Rect(0, 0, 600, 600));
246			doc.PagePushBack(page);
247			ew.Begin(page, ElementWriter.WriteMode.e_overlay, false );	// begin writing to this page
248			eb.Reset();			// Reset the GState to default
249			ew.End();  // save changes to the current page
250
251			{
252				//Create a Line annotation...
253				Line line = Line.Create(doc, new Rect(250, 250, 400, 400));
254				line.SetStartPoint( new Point(350, 270 ) );
255				line.SetEndPoint( new Point(260,370) );
256				line.SetStartStyle(Line.EndingStyle.e_Square);
257				line.SetEndStyle(Line.EndingStyle.e_Circle);
258				line.SetColor(new ColorPt(.3, .5, 0), 3);
259				line.SetContents( "Dashed Captioned" );
260				line.SetShowCaption(true);
261				line.SetCaptionPosition(Line.CapPos.e_Top );
262				double[] dash = new double[2];
263				dash[0] = 2;
264				dash[1] = 2.0;
265				line.SetBorderStyle( new Annot.BorderStyle( Annot.BorderStyle.Style.e_dashed, 2, 0, 0, dash ) );
266				line.RefreshAppearance();
267				page.AnnotPushBack(line);
268			}
269			{
270				Line line=Line.Create(doc, new Rect(347, 377, 600, 600));
271				line.SetStartPoint( new Point(385, 410 ) );
272				line.SetEndPoint(new Point(540,555) );
273				line.SetStartStyle(Line.EndingStyle.e_Circle);
274				line.SetEndStyle(Line.EndingStyle.e_OpenArrow);
275				line.SetColor(new ColorPt(1, 0, 0), 3);
276				line.SetInteriorColor(new ColorPt(0, 1, 0), 3);
277				line.SetContents( "Inline Caption" );
278				line.SetShowCaption(true);
279				line.SetCaptionPosition( Line.CapPos.e_Inline);
280				line.SetLeaderLineExtensionLength( 4 );
281				line.SetLeaderLineLength( -12 );
282				line.SetLeaderLineOffset( 2 );
283				line.RefreshAppearance();
284				page.AnnotPushBack(line);
285			}
286			{
287				Line line=Line.Create(doc, new Rect(10, 400, 200, 600));
288				line.SetStartPoint(new Point(25, 426 ) );
289				line.SetEndPoint(new Point(180,555) );
290				line.SetStartStyle(Line.EndingStyle.e_Circle);
291				line.SetEndStyle(Line.EndingStyle.e_Square);
292				line.SetColor(new ColorPt(0, 0, 1), 3);
293				line.SetInteriorColor(new ColorPt(1, 0, 0), 3);
294				line.SetContents("Offset Caption");
295				line.SetShowCaption(true);
296				line.SetCaptionPosition( Line.CapPos.e_Top );
297				line.SetTextHOffset( -60 );
298				line.SetTextVOffset( 10 );
299				line.RefreshAppearance();
300				page.AnnotPushBack(line);
301			}
302			{
303				Line line=Line.Create(doc, new Rect(200, 10, 400, 70));
304				line.SetStartPoint(new Point(220, 25 ) );
305				line.SetEndPoint(new Point(370,60) );
306				line.SetStartStyle(Line.EndingStyle.e_Butt);
307				line.SetEndStyle(Line.EndingStyle.e_OpenArrow);
308				line.SetColor(new ColorPt(0, 0, 1), 3);
309				line.SetContents("Regular Caption");
310				line.SetShowCaption(true);
311				line.SetCaptionPosition( Line.CapPos.e_Top );
312				line.RefreshAppearance();
313				page.AnnotPushBack(line);
314			}
315			{
316				Line line=Line.Create(doc, new Rect(200, 70, 400, 130));
317				line.SetStartPoint(new Point(220, 111 ) );
318				line.SetEndPoint(new Point(370,78) );
319				line.SetStartStyle(Line.EndingStyle.e_Circle);
320				line.SetEndStyle(Line.EndingStyle.e_Diamond);
321				line.SetContents("Circle to Diamond");
322				line.SetColor(new ColorPt(0, 0, 1), 3);
323				line.SetInteriorColor(new ColorPt(0, 1, 0), 3);
324				line.SetShowCaption(true);
325				line.SetCaptionPosition( Line.CapPos.e_Top );
326				line.RefreshAppearance();
327				page.AnnotPushBack(line);
328			}
329			{
330				Line line=Line.Create(doc, new Rect(10, 100, 160, 200));
331				line.SetStartPoint(new Point(15, 110 ) );
332				line.SetEndPoint(new Point(150, 190) );
333				line.SetStartStyle(Line.EndingStyle.e_Slash);
334				line.SetEndStyle(Line.EndingStyle.e_ClosedArrow);
335				line.SetContents("Slash to CArrow");
336				line.SetColor(new ColorPt(1, 0, 0), 3);
337				line.SetInteriorColor(new ColorPt(0, 1, 1), 3);
338				line.SetShowCaption(true);
339				line.SetCaptionPosition( Line.CapPos.e_Top );
340				line.RefreshAppearance();
341				page.AnnotPushBack(line);
342			}
343			{
344				Line line=Line.Create(doc, new Rect( 270, 270, 570, 433 ));
345				line.SetStartPoint(new Point(300, 400 ) );
346				line.SetEndPoint(new Point(550, 300) );
347				line.SetStartStyle(Line.EndingStyle.e_RClosedArrow);
348				line.SetEndStyle(Line.EndingStyle.e_ROpenArrow);
349				line.SetContents("ROpen & RClosed arrows");
350				line.SetColor(new ColorPt(0, 0, 1), 3);
351				line.SetInteriorColor(new ColorPt(0, 1, 0), 3);
352				line.SetShowCaption(true);
353				line.SetCaptionPosition( Line.CapPos.e_Top );
354				line.RefreshAppearance();
355				page.AnnotPushBack(line);
356			}
357			{
358				Line line=Line.Create(doc, new Rect( 195, 395, 205, 505 ));
359				line.SetStartPoint(new Point(200, 400 ) );
360				line.SetEndPoint(new Point(200, 500) );
361				line.RefreshAppearance();
362				page.AnnotPushBack(line);
363			}
364			{
365				Line line=Line.Create(doc, new Rect( 55, 299, 150, 301 ));
366				line.SetStartPoint(new Point(55, 300 ) );
367				line.SetEndPoint(new Point(155, 300) );
368				line.SetStartStyle(Line.EndingStyle.e_Circle);
369				line.SetEndStyle(Line.EndingStyle.e_Circle);
370				line.SetContents("Caption that's longer than its line.");
371				line.SetColor(new ColorPt(1, 0, 1), 3);
372				line.SetInteriorColor(new ColorPt(0, 1, 0), 3);
373				line.SetShowCaption(true);
374				line.SetCaptionPosition( Line.CapPos.e_Top );
375				line.RefreshAppearance();
376				page.AnnotPushBack(line);
377			}
378			{
379				Line line=Line.Create(doc, new Rect( 300, 200, 390, 234 ));
380				line.SetStartPoint(new Point(310, 210 ) );
381				line.SetEndPoint(new Point(380, 220) );
382				line.SetColor(new ColorPt(0, 0, 0), 3);
383				line.RefreshAppearance();
384				page.AnnotPushBack(line);
385			}
386
387			Page page3 = doc.PageCreate(new Rect(0, 0, 600, 600));
388			ew.Begin(page3);	// begin writing to the page
389			ew.End();  // save changes to the current page
390			doc.PagePushBack(page3);
391			{
392				Circle circle = Circle.Create(doc, new Rect( 300, 300, 390, 350 ));
393				circle.SetColor(new ColorPt(0, 0, 0), 3);
394				circle.RefreshAppearance();
395				page3.AnnotPushBack(circle);
396			}
397			{
398				Circle circle= Circle.Create(doc, new Rect( 100, 100, 200, 200 ));
399				circle.SetColor(new ColorPt(0, 1, 0), 3);
400				circle.SetInteriorColor(new ColorPt(0, 0, 1), 3);
401				double[] dash = new double[2];
402				dash[0]=2;dash[1]=4;
403				circle.SetBorderStyle(new Annot.BorderStyle( Annot.BorderStyle.Style.e_dashed, 3, 0, 0, dash ) );
404				circle.SetPadding( new Rect(2,2,2,2) );
405				circle.RefreshAppearance();
406				page3.AnnotPushBack(circle);
407			}
408			{
409				Square sq = Square.Create( doc, new Rect(10,200, 80, 300 ) );
410				sq.SetColor(new ColorPt(0, 0, 0), 3);
411				sq.RefreshAppearance();
412				page3.AnnotPushBack( sq );
413			}
414			{
415				Square sq = Square.Create( doc, new Rect(500,200, 580, 300 ) );
416				sq.SetColor(new ColorPt(1, 0, 0), 3);
417				sq.SetInteriorColor(new ColorPt(0, 1, 1), 3);
418				double[] dash = new double[2];
419				dash[0]=4;dash[1]=2;
420				sq.SetBorderStyle(new Annot.BorderStyle( Annot.BorderStyle.Style.e_dashed, 6, 0, 0, dash ) );
421				sq.SetPadding( new Rect(4,4,4,4) );
422				sq.RefreshAppearance();
423				page3.AnnotPushBack( sq );
424			}
425			{
426				Polygon poly = Polygon.Create(doc, new Rect(5, 500, 125, 590));
427				poly.SetColor(new ColorPt(1, 0, 0), 3);
428				poly.SetInteriorColor(new ColorPt(1, 1, 0), 3);
429				poly.SetVertex(0, new Point(12,510) );
430				poly.SetVertex(1, new Point(100,510) );
431				poly.SetVertex(2, new Point(100,555) );
432				poly.SetVertex(3, new Point(35,544) );
433				poly.SetBorderStyle(new Annot.BorderStyle( Annot.BorderStyle.Style.e_solid, 4, 0, 0 ) );
434				poly.SetPadding( new Rect(4,4,4,4) );
435				poly.RefreshAppearance();
436				page3.AnnotPushBack( poly );
437			}
438			{
439				PolyLine poly = PolyLine.Create(doc, new Rect(400, 10, 500, 90));
440				poly.SetColor(new ColorPt(1, 0, 0), 3);
441				poly.SetInteriorColor(new ColorPt(0, 1, 0), 3);
442				poly.SetVertex(0, new Point(405,20) );
443				poly.SetVertex(1, new Point(440,40) );
444				poly.SetVertex(2, new Point(410,60) );
445				poly.SetVertex(3, new Point(470,80) );
446				poly.SetBorderStyle( new Annot.BorderStyle( Annot.BorderStyle.Style.e_solid, 2, 0, 0 ) );
447				poly.SetPadding( new Rect(4,4,4,4) );
448				poly.SetStartStyle( Line.EndingStyle.e_RClosedArrow );
449				poly.SetEndStyle( Line.EndingStyle.e_ClosedArrow );
450				poly.RefreshAppearance();
451				page3.AnnotPushBack( poly );
452			}
453			{
454				Link lk = Link.Create( doc, new Rect(5,5,55,24) );
455				//lk.SetColor( ColorPt(0,1,0), 3 );
456				lk.RefreshAppearance();
457				page3.AnnotPushBack( lk );
458			}
459
460
461			Page page4 = doc.PageCreate(new Rect(0, 0, 600, 600));
462			ew.Begin(page4);	// begin writing to the page
463			ew.End();  // save changes to the current page
464			doc.PagePushBack(page4);
465
466			{	
467				ew.Begin( page4 );
468				Font font = Font.Create(doc, Font.StandardType1Font.e_helvetica);
469				element = eb.CreateTextBegin( font, 16 );
470				element.SetPathFill(true);
471				ew.WriteElement(element);
472				element = eb.CreateTextRun( "Some random text on the page", font, 16 );
473				element.SetTextMatrix(1, 0, 0, 1, 100, 500 );
474				ew.WriteElement(element);
475				ew.WriteElement( eb.CreateTextEnd() );
476				ew.End();
477			}
478			{
479				Highlight hl = Highlight.Create( doc, new Rect(100,490,150,515) );
480				hl.SetColor(new ColorPt(0,1,0), 3 );
481				hl.RefreshAppearance();
482				page4.AnnotPushBack( hl );
483			}
484			{
485				Squiggly sq = Squiggly.Create( doc, new Rect(100,450,250,600) );
486				//sq.SetColor( ColorPt(1,0,0), 3 );
487				sq.SetQuadPoint( 0, new QuadPoint(new Point( 122,455), new Point(240, 545), new Point(230, 595), new Point(101,500 ) ) );
488				sq.RefreshAppearance();
489				page4.AnnotPushBack( sq );
490			}
491			{
492				Caret cr = Caret.Create( doc, new Rect(100,40,129,69) );
493				cr.SetColor( new ColorPt(0,0,1), 3 );
494				cr.SetSymbol( "P" );
495				cr.RefreshAppearance();
496				page4.AnnotPushBack( cr );
497			}
498
499
500			Page page5 = doc.PageCreate(new Rect(0, 0, 600, 600));
501			ew.Begin(page5);	// begin writing to the page
502			ew.End();  // save changes to the current page
503			doc.PagePushBack(page5);
504			Page page6 = doc.PageCreate(new Rect(0, 0, 600, 600));
505			ew.Begin(page6);	// begin writing to the page
506			ew.End();  // save changes to the current page
507			doc.PagePushBack(page6);
508
509			{
510				Text txt = Text.Create( doc, new Rect( 10, 20, 30, 40 ) );
511				txt.SetIcon( "UserIcon" );
512				txt.SetContents( "User defined icon, unrecognized by appearance generator" );
513				txt.SetColor(new ColorPt(0,1,0) );
514				txt.RefreshAppearance();
515				page6.AnnotPushBack( txt );
516			}
517			{
518				Ink ink = Ink.Create( doc, new Rect( 100, 400, 200, 550 ) );
519				ink.SetColor(new ColorPt(0,0,1) );
520				ink.SetPoint( 1, 3, new Point( 220, 505) );
521				ink.SetPoint( 1, 0, new Point( 100, 490) );
522				ink.SetPoint( 0, 1, new Point( 120, 410) );
523				ink.SetPoint( 0, 0, new Point( 100, 400) );
524				ink.SetPoint( 1, 2, new Point( 180, 490) );
525				ink.SetPoint( 1, 1, new Point( 140, 440) );		
526				ink.SetBorderStyle( new Annot.BorderStyle( Annot.BorderStyle.Style.e_solid, 3, 0, 0  ) );
527				ink.RefreshAppearance();
528				page6.AnnotPushBack( ink );
529			}
530
531
532			Page page7 = doc.PageCreate(new Rect(0, 0, 600, 600));
533			ew.Begin(page7);	// begin writing to the page
534			ew.End();  // save changes to the current page
535			doc.PagePushBack(page7);
536
537			{
538				Sound snd = Sound.Create( doc, new Rect( 100, 500, 120, 520 ) );
539				snd.SetColor(  new ColorPt(1,1,0) );
540				snd.SetIcon(Sound.Icon.e_Speaker );
541				snd.RefreshAppearance();
542				page7.AnnotPushBack( snd );
543			}
544			{
545				Sound snd = Sound.Create( doc, new Rect( 200, 500, 220, 520 ) );
546				snd.SetColor(new ColorPt(1,1,0) );
547				snd.SetIcon(Sound.Icon.e_Mic );
548				snd.RefreshAppearance();
549				page7.AnnotPushBack( snd );
550			}
551
552			Page page8 = doc.PageCreate(new Rect(0, 0, 600, 600));
553			ew.Begin(page8);	// begin writing to the page
554			ew.End();  // save changes to the current page
555			doc.PagePushBack(page8);
556
557			for( int ipage =0; ipage < 2; ++ipage ) {
558				double px = 5, py = 520;
559				for (RubberStamp.Icon istamp = RubberStamp.Icon.e_Approved; 
560					istamp <= RubberStamp.Icon.e_Draft; 
561					istamp = (RubberStamp.Icon) (  (int)(istamp) + 1  ) ) {
562						RubberStamp stmp = RubberStamp.Create( doc, new Rect(1,1,100,100) );
563						stmp.SetIcon( istamp );
564						stmp.SetContents(stmp.GetIconName());
565						stmp.SetRect(new Rect(px, py, px+100, py+25 ) );
566						py -= 100;
567						if( py < 0 ) {
568							py = 520;
569							px += 200;
570						}
571						if( ipage == 0 ){
572							//page7.AnnotPushBack( st );
573							;
574						}
575						else {
576							page8.AnnotPushBack(stmp);
577							stmp.RefreshAppearance();
578						}
579				}
580			}
581			RubberStamp st = RubberStamp.Create( doc, new Rect(400,5,550,45) );
582			st.SetIcon( "UserStamp" );
583			st.SetContents( "User defined stamp" );
584			page8.AnnotPushBack( st );
585			st.RefreshAppearance();
586
587
588
589		}
590
591
592		// Relative path to the folder containing test files.
593		const string input_path =  "../../../../TestFiles/";
594		const string output_path = "../../../../TestFiles/Output/";
595
596		/// <summary>
597		/// The main entry point for the application.
598		/// </summary>
599		[System.STAThread]
600		static void Main(string[] args)
601		{
602			PDFNet.Initialize(PDFTronLicense.Key);
603
604			try
605			{
606				using (PDFDoc doc = new PDFDoc(input_path + "numbered.pdf"))
607				{
608					doc.InitSecurityHandler();
609
610					// An example of using SDF/Cos API to add any type of annotations.
611					AnnotationLowLevelAPI(doc);
612					doc.Save(output_path + "annotation_test1.pdf", SDFDoc.SaveOptions.e_linearized);
613					System.Console.WriteLine("Done. Results saved in annotation_test1.pdf");
614					
615					// An example of using the high-level PDFNet API to read existing annotations,
616					// to edit existing annotations, and to create new annotation from scratch.
617					AnnotationHighLevelAPI(doc);
618					doc.Save(output_path + "annotation_test2.pdf", SDFDoc.SaveOptions.e_linearized);
619					System.Console.WriteLine("Done. Results saved in annotation_test2.pdf");
620				}
621
622				// an example of creating various annotations in a brand new document
623				using (PDFDoc doc1 = new PDFDoc())
624				{
625					CreateTestAnnots(doc1);
626					doc1.Save(output_path + "new_annot_test_api.pdf", SDFDoc.SaveOptions.e_linearized);
627					System.Console.WriteLine("Saved new_annot_test_api.pdf");
628				}
629			}
630			catch (PDFNetException e)
631			{
632				System.Console.WriteLine(e.Message);
633			}
634			PDFNet.Terminate();
635		}
636	}
637}

1//---------------------------------------------------------------------------------------
2// Copyright (c) 2001-2024 by Apryse Software Inc. All Rights Reserved.
3// Consult legal.txt regarding legal and license information.
4//---------------------------------------------------------------------------------------
5
6#include <PDF/PDFNet.h>
7#include <PDF/PDFDoc.h>
8#include <PDF/ElementBuilder.h>
9#include <PDF/ElementReader.h>
10#include <PDF/ElementWriter.h>
11#include <PDF/Annot.h>
12#include <SDF/Obj.h>
13#include <iostream>
14#include "../../LicenseKey/CPP/LicenseKey.h"
15
16using namespace pdftron;
17using namespace SDF;
18using namespace PDF;
19using namespace std;
20
21
22std::string output_path = "../../TestFiles/Output/";
23std::string input_path = "../../TestFiles/";
24
25void AnnotationHighLevelAPI(PDFDoc& doc)
26{
27	// The following code snippet traverses all annotations in the document
28	cout << "Traversing all annotations in the document..." << endl; 
29
30	UString uri;
31	int page_num=1;
32	for (PageIterator itr = doc.GetPageIterator(); itr.HasNext(); itr.Next()) 
33	{
34		cout << "Page " << page_num++ << ": " << endl; 
35
36		Page page = itr.Current();
37		int num_annots = page.GetNumAnnots(); 
38		for (int i=0; i<num_annots; ++i) 
39		{
40			Annot annot = page.GetAnnot(i);
41			if (!annot.IsValid()) continue;
42			cout << "Annot Type: " << annot.GetSDFObj().Get("Subtype").Value().GetName() << endl; 
43
44			Rect bbox = annot.GetRect();
45			cout << "  Position: " << bbox.x1 
46				<< ", " << bbox.y1
47				<< ", " << bbox.x2
48				<< ", " << bbox.y2 << endl;
49
50			switch (annot.GetType()) 
51			{
52			case Annot::e_Link: 
53				{
54					Annots::Link link(annot);
55					Action action = link.GetAction();
56					if (!action.IsValid()) continue;
57					if (action.GetType() == Action::e_GoTo) 
58					{
59						Destination dest = action.GetDest();
60						if (!dest.IsValid()) {
61							cout << "  Destination is not valid" << endl;
62						}
63						else {
64							int page_num = dest.GetPage().GetIndex();
65							cout << "  Links to: page number " << page_num << " in this document" << endl;
66						}
67					}
68					else if (action.GetType() == Action::e_URI) 
69					{						
70						action.GetSDFObj().Get("URI").Value().GetAsPDFText(uri);
71						cout << "  Links to: " << uri << endl;
72					}
73					// ...
74				}
75				break; 
76			case Annot::e_Widget:
77				break; 
78			case Annot::e_FileAttachment:
79				break; 
80				// ...
81			default:
82				break; 
83			}
84		}
85	}
86
87	// Use the high-level API to create new annotations.
88	Page first_page = doc.GetPage(1);
89
90	// Create a hyperlink...
91	Annots::Link hyperlink = Annots::Link::Create(doc, Rect(85, 570, 503, 524), Action::CreateURI(doc, "http://www.pdftron.com"));
92	first_page.AnnotPushBack(hyperlink);
93
94	// Create an intra-document link...
95	Action goto_page_3 = Action::CreateGoto(Destination::CreateFitH(doc.GetPage(3), 0));
96	Annots::Link link = Annots::Link::Create(doc, Rect(85, 458, 503, 502), goto_page_3);
97	link.SetColor(ColorPt(0, 0, 1));
98
99	// Add the new annotation to the first page
100	first_page.AnnotPushBack(link);
101
102	// Create a stamp annotation ...
103	Annots::RubberStamp stamp = Annots::RubberStamp::Create(doc, Rect(30, 30, 300, 200));
104	stamp.SetIcon("Draft");
105	first_page.AnnotPushBack(stamp);
106
107	// Create a file attachment annotation (embed the 'peppers.jpg').
108	Annots::FileAttachment file_attach = Annots::FileAttachment::Create(doc, Rect(80, 280, 108, 320), (input_path + "peppers.jpg").c_str());
109	first_page.AnnotPushBack(file_attach);
110
111
112	Annots::Ink ink = Annots::Ink::Create(doc, Rect(110, 10, 300, 200));
113	Point pt3(110, 10);
114	//pt3.x = 110; pt3.y = 10;
115	ink.SetPoint(0, 0, pt3);
116	pt3.x = 150; pt3.y = 50;
117	ink.SetPoint(0, 1, pt3);
118	pt3.x = 190; pt3.y = 60;
119	ink.SetPoint(0, 2, pt3);
120	pt3.x = 180; pt3.y = 90;
121	ink.SetPoint(1, 0, pt3);
122	pt3.x = 190; pt3.y = 95;
123	ink.SetPoint(1, 1, pt3);
124	pt3.x = 200; pt3.y = 100;
125	ink.SetPoint(1, 2, pt3);
126	pt3.x = 166; pt3.y = 86;
127	ink.SetPoint(2, 0, pt3);
128	pt3.x = 196; pt3.y = 96;
129	ink.SetPoint(2, 1, pt3);
130	pt3.x = 221; pt3.y = 121;
131	ink.SetPoint(2, 2, pt3);
132	pt3.x = 288; pt3.y = 188;
133	ink.SetPoint(2, 3, pt3);
134	ink.SetColor(ColorPt(0, 1, 1), 3);
135	first_page.AnnotPushBack(ink);
136
137}
138
139void AnnotationLowLevelAPI(PDFDoc& doc)  
140{
141	Page page = (doc.GetPageIterator()).Current(); 
142
143	Obj annots = page.GetAnnots();
144
145	if (!annots) 
146	{
147		// If there are no annotations, create a new annotation 
148		// array for the page.
149		annots = doc.CreateIndirectArray();  
150		page.GetSDFObj().Put("Annots", annots);
151	}
152
153	// Create a Text annotation
154	Obj annot = doc.CreateIndirectDict();
155	annot.PutName("Subtype", "Text");
156	annot.PutBool("Open", true);
157	annot.PutString("Contents", "The quick brown fox ate the lazy mouse.");
158	annot.PutRect("Rect", 266, 116, 430, 204);
159
160	// Insert the annotation in the page annotation array
161	annots.PushBack(annot);	
162
163	// Create a Link annotation
164	Obj link1 = doc.CreateIndirectDict();
165	link1.PutName("Subtype", "Link");
166	Destination	dest = Destination::CreateFit(doc.GetPage(2));
167	link1.Put("Dest", dest.GetSDFObj());
168	link1.PutRect("Rect", 85, 705, 503, 661);
169	annots.PushBack(link1);
170
171	// Create another Link annotation
172	Obj link2 = doc.CreateIndirectDict();
173	link2.PutName("Subtype", "Link");
174	Destination	dest2 = Destination::CreateFit(doc.GetPage(3));
175	link2.Put("Dest", dest2.GetSDFObj());
176	link2.PutRect("Rect", 85, 638, 503, 594);
177	annots.PushBack(link2);
178
179	// Note that PDFNet API can be used to modify existing annotations. 
180	// In the following example we will modify the second link annotation 
181	// (link2) so that it points to the 10th page. We also use a different 
182	// destination page fit type.
183
184	// link2 = annots.GetAt(annots.Size()-1);
185	link2.Put("Dest", 
186		Destination::CreateXYZ(doc.GetPage(10), 100, 792-70, 10).GetSDFObj());
187
188	// Create a third link annotation with a hyperlink action (all other 
189	// annotation types can be created in a similar way)
190	Obj link3 = doc.CreateIndirectDict();
191	link3.PutName("Subtype", "Link");
192	link3.PutRect("Rect", 85, 570, 503, 524);
193
194	// Create a URI action 
195	Obj action = link3.PutDict("A");
196	action.PutName("S", "URI");
197	action.PutString("URI", "http://www.pdftron.com");
198
199	annots.PushBack(link3);
200}
201
202
203void CreateTestAnnots(PDFDoc& doc) {
204	using namespace pdftron;
205	using namespace SDF;
206	using namespace PDF;
207	using namespace Annots;
208
209
210	ElementWriter ew;
211	ElementBuilder eb;
212	Element element ;
213
214	Page first_page= doc.PageCreate(Rect(0, 0, 600, 600));
215	doc.PagePushBack(first_page);
216	ew.Begin(first_page, ElementWriter::e_overlay, false );	// begin writing to this page
217	ew.End();  // save changes to the current page
218
219	//
220	// Test of a free text annotation.
221	//
222	{
223		Annots::FreeText txtannot = Annots::FreeText::Create( doc, Rect(10, 400, 160, 570)  );
224		txtannot.SetContents( UString("\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare."
225							  "\n\nAha!\n\nAnd there was much rejoicing!"	) );
226		//std::vector<double> dash( 2, 2.0 );
227		txtannot.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 1, 10, 20 ), false);
228		txtannot.SetQuaddingFormat(0);
229		first_page.AnnotPushBack(txtannot);
230		txtannot.RefreshAppearance();
231	}
232	{
233		Annots::FreeText txtannot = Annots::FreeText::Create( doc, Rect(100, 100, 350, 500)  );
234		txtannot.SetContentRect( Rect( 200, 200, 350, 500 ) );
235		txtannot.SetContents( UString("\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare."
236							  "\n\nAha!\n\nAnd there was much rejoicing!"	) );
237		txtannot.SetCalloutLinePoints( Point(200,300), Point(150,290), Point(110,110) );
238		//std::vector<double> dash( 2, 2.0 );
239		txtannot.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 1, 10, 20 ), false);
240		txtannot.SetEndingStyle( Line::e_ClosedArrow );
241		txtannot.SetColor( ColorPt( 0, 1, 0 ) );
242		txtannot.SetQuaddingFormat(1);
243		first_page.AnnotPushBack(txtannot);
244		txtannot.RefreshAppearance();
245	}
246	{
247		Annots::FreeText txtannot = Annots::FreeText::Create( doc, Rect(400, 10, 550, 400)  );
248		txtannot.SetContents( UString("\n\nSome swift brown fox snatched a gray hare out of the air by freezing it with an angry glare."
249							  "\n\nAha!\n\nAnd there was much rejoicing!"	) );
250		txtannot.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 1, 10, 20 ), false);
251		txtannot.SetColor( ColorPt( 0, 0, 1 ) );
252		txtannot.SetOpacity( 0.2 );
253		txtannot.SetQuaddingFormat(2);
254		first_page.AnnotPushBack(txtannot);
255		txtannot.RefreshAppearance();
256	}
257
258	Page page= doc.PageCreate(Rect(0, 0, 600, 600));
259	doc.PagePushBack(page);
260	ew.Begin(page, ElementWriter::e_overlay, false );	// begin writing to this page
261	eb.Reset();			// Reset the GState to default
262	ew.End();  // save changes to the current page
263
264	{
265		//Create a Line annotation...
266		Line line=Line::Create(doc, Rect(250, 250, 400, 400));
267		line.SetStartPoint( Point(350, 270 ) );
268		line.SetEndPoint( Point(260,370) );
269		line.SetStartStyle(Line::e_Square);
270		line.SetEndStyle(Line::e_Circle);
271		line.SetColor(ColorPt(.3, .5, 0), 3);
272		line.SetContents( UString("Dashed Captioned") );
273		line.SetShowCaption(true);
274		line.SetCaptionPosition( Line::e_Top );
275		std::vector<double> dash( 2, 2.0 );
276		line.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_dashed, 2, 0, 0, dash ) );
277		line.RefreshAppearance();
278		page.AnnotPushBack(line);
279	}
280	{
281		Line line=Line::Create(doc, Rect(347, 377, 600, 600));
282		line.SetStartPoint( Point(385, 410 ) );
283		line.SetEndPoint( Point(540,555) );
284		line.SetStartStyle(Line::e_Circle);
285		line.SetEndStyle(Line::e_OpenArrow);
286		line.SetColor(ColorPt(1, 0, 0), 3);
287		line.SetInteriorColor(ColorPt(0, 1, 0), 3);
288		line.SetContents( UString("Inline Caption") );
289		line.SetShowCaption(true);
290		line.SetCaptionPosition( Line::e_Inline );
291		line.SetLeaderLineExtensionLength( 4. );
292		line.SetLeaderLineLength( -12. );
293		line.SetLeaderLineOffset( 2. );
294		line.RefreshAppearance();
295		page.AnnotPushBack(line);
296	}
297	{
298		Line line=Line::Create(doc, Rect(10, 400, 200, 600));
299		line.SetStartPoint( Point(25, 426 ) );
300		line.SetEndPoint( Point(180,555) );
301		line.SetStartStyle(Line::e_Circle);
302		line.SetEndStyle(Line::e_Square);
303		line.SetColor(ColorPt(0, 0, 1), 3);
304		line.SetInteriorColor(ColorPt(1, 0, 0), 3);
305		line.SetContents( UString("Offset Caption") );
306		line.SetShowCaption(true);
307		line.SetCaptionPosition( Line::e_Top );
308		line.SetTextHOffset( -60 );
309		line.SetTextVOffset( 10 );
310		line.RefreshAppearance();
311		page.AnnotPushBack(line);
312	}
313	{
314		Line line=Line::Create(doc, Rect(200, 10, 400, 70));
315		line.SetStartPoint( Point(220, 25 ) );
316		line.SetEndPoint( Point(370,60) );
317		line.SetStartStyle(Line::e_Butt);
318		line.SetEndStyle(Line::e_OpenArrow);
319		line.SetColor(ColorPt(0, 0, 1), 3);
320		line.SetContents( UString("Regular Caption") );
321		line.SetShowCaption(true);
322		line.SetCaptionPosition( Line::e_Top );
323		line.RefreshAppearance();
324		page.AnnotPushBack(line);
325	}
326	{
327		Line line=Line::Create(doc, Rect(200, 70, 400, 130));
328		line.SetStartPoint( Point(220, 111 ) );
329		line.SetEndPoint( Point(370,78) );
330		line.SetStartStyle(Line::e_Circle);
331		line.SetEndStyle(Line::e_Diamond);
332		line.SetContents( UString("Circle to Diamond") );
333		line.SetColor(ColorPt(0, 0, 1), 3);
334		line.SetInteriorColor(ColorPt(0, 1, 0), 3);
335		line.SetShowCaption(true);
336		line.SetCaptionPosition( Line::e_Top );
337		line.RefreshAppearance();
338		page.AnnotPushBack(line);
339	}
340	{
341		Line line=Line::Create(doc, Rect(10, 100, 160, 200));
342		line.SetStartPoint( Point(15, 110 ) );
343		line.SetEndPoint( Point(150, 190) );
344		line.SetStartStyle(Line::e_Slash);
345		line.SetEndStyle(Line::e_ClosedArrow);
346		line.SetContents( UString("Slash to CArrow") );
347		line.SetColor(ColorPt(1, 0, 0), 3);
348		line.SetInteriorColor(ColorPt(0, 1, 1), 3);
349		line.SetShowCaption(true);
350		line.SetCaptionPosition( Line::e_Top );
351		line.RefreshAppearance();
352		page.AnnotPushBack(line);
353	}
354	{
355		Line line=Line::Create(doc, Rect( 270, 270, 570, 433 ));
356		line.SetStartPoint( Point(300, 400 ) );
357		line.SetEndPoint( Point(550, 300) );
358		line.SetStartStyle(Line::e_RClosedArrow);
359		line.SetEndStyle(Line::e_ROpenArrow);
360		line.SetContents( UString("ROpen & RClosed arrows") );
361		line.SetColor(ColorPt(0, 0, 1), 3);
362		line.SetInteriorColor(ColorPt(0, 1, 0), 3);
363		line.SetShowCaption(true);
364		line.SetCaptionPosition( Line::e_Top );
365		line.RefreshAppearance();
366		page.AnnotPushBack(line);
367	}
368	{
369		Line line=Line::Create(doc, Rect( 195, 395, 205, 505 ));
370		line.SetStartPoint( Point(200, 400 ) );
371		line.SetEndPoint( Point(200, 500) );
372		line.RefreshAppearance();
373		page.AnnotPushBack(line);
374	}
375	{
376		Line line=Line::Create(doc, Rect( 55, 299, 150, 301 ));
377		line.SetStartPoint( Point(55, 300 ) );
378		line.SetEndPoint( Point(155, 300) );
379		line.SetStartStyle(Line::e_Circle);
380		line.SetEndStyle(Line::e_Circle);
381		line.SetContents( UString("Caption that's longer than its line.") );
382		line.SetColor(ColorPt(1, 0, 1), 3);
383		line.SetInteriorColor(ColorPt(0, 1, 0), 3);
384		line.SetShowCaption(true);
385		line.SetCaptionPosition( Line::e_Top );
386		line.RefreshAppearance();
387		page.AnnotPushBack(line);
388	}
389	{
390		Line line=Line::Create(doc, Rect( 300, 200, 390, 234 ));
391		line.SetStartPoint( Point(310, 210 ) );
392		line.SetEndPoint( Point(380, 220) );
393		line.SetColor(ColorPt(0, 0, 0), 3);
394		line.RefreshAppearance();
395		page.AnnotPushBack(line);
396	}
397
398	Page page3 = doc.PageCreate(Rect(0, 0, 600, 600));
399	ew.Begin(page3);	// begin writing to the page
400	ew.End();  // save changes to the current page
401	doc.PagePushBack(page3);
402	{
403		Circle circle=Circle::Create(doc, Rect( 300, 300, 390, 350 ));
404		circle.SetColor(ColorPt(0, 0, 0), 3);
405		circle.RefreshAppearance();
406		page3.AnnotPushBack(circle);
407	}
408	{
409		Circle circle=Circle::Create(doc, Rect( 100, 100, 200, 200 ));
410		circle.SetColor(ColorPt(0, 1, 0), 3);
411		circle.SetInteriorColor(ColorPt(0, 0, 1), 3);
412		std::vector<double> dash( 2 ); dash[0]=2;dash[1]=4;
413		circle.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_dashed, 3, 0, 0, dash ) );
414		circle.SetPadding( 2 );
415		circle.RefreshAppearance();
416		page3.AnnotPushBack(circle);
417	}
418	{
419		Square sq = Square::Create( doc, Rect(10,200, 80, 300 ) );
420		sq.SetColor(ColorPt(0, 0, 0), 3);
421		sq.RefreshAppearance();
422		page3.AnnotPushBack( sq );
423	}
424	{
425		Square sq = Square::Create( doc, Rect(500,200, 580, 300 ) );
426		sq.SetColor(ColorPt(1, 0, 0), 3);
427		sq.SetInteriorColor(ColorPt(0, 1, 1), 3);
428		std::vector<double> dash( 2 ); dash[0]=4;dash[1]=2;
429		sq.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_dashed, 6, 0, 0, dash ) );
430		sq.SetPadding( 4 );
431		sq.RefreshAppearance();
432		page3.AnnotPushBack( sq );
433	}
434	{
435		Polygon poly = Polygon::Create(doc, Rect(5, 500, 125, 590));
436		poly.SetColor(ColorPt(1, 0, 0), 3);
437		poly.SetInteriorColor(ColorPt(1, 1, 0), 3);
438		poly.SetVertex(0, Point(12,510) );
439		poly.SetVertex(1, Point(100,510) );
440		poly.SetVertex(2, Point(100,555) );
441		poly.SetVertex(3, Point(35,544) );
442		poly.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 4, 0, 0 ) );
443		poly.SetPadding( 4 );
444		poly.RefreshAppearance();
445		page3.AnnotPushBack( poly );
446	}
447	{
448		PolyLine poly = PolyLine::Create(doc, Rect(400, 10, 500, 90));
449		poly.SetColor(ColorPt(1, 0, 0), 3);
450		poly.SetInteriorColor(ColorPt(0, 1, 0), 3);
451		poly.SetVertex(0, Point(405,20) );
452		poly.SetVertex(1, Point(440,40) );
453		poly.SetVertex(2, Point(410,60) );
454		poly.SetVertex(3, Point(470,80) );
455		poly.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 2, 0, 0 ) );
456		poly.SetPadding( 4 );
457		poly.SetStartStyle( Line::e_RClosedArrow );
458		poly.SetEndStyle( Line::e_ClosedArrow );
459		poly.RefreshAppearance();
460		page3.AnnotPushBack( poly );
461	}
462	{
463		Link lk = Link::Create( doc, Rect(5,5,55,24) );
464		//lk.SetColor( ColorPt(0,1,0), 3 );
465		lk.RefreshAppearance();
466		page3.AnnotPushBack( lk );
467	}
468
469
470	Page page4 = doc.PageCreate(Rect(0, 0, 600, 600));
471	ew.Begin(page4);	// begin writing to the page
472	ew.End();  // save changes to the current page
473	doc.PagePushBack(page4);
474
475	{	
476		ew.Begin( page4 );
477		Font font = Font::Create(doc, Font::e_helvetica);
478		element = eb.CreateTextBegin( font, 16 );
479		element.SetPathFill(true);
480		ew.WriteElement(element);
481		element = eb.CreateTextRun( "Some random text on the page", font, 16 );
482		element.SetTextMatrix(1, 0, 0, 1, 100, 500 );
483		ew.WriteElement(element);
484		ew.WriteElement( eb.CreateTextEnd() );
485		ew.End();
486	}
487	{
488		Highlight hl = Highlight::Create( doc, Rect(100,490,150,515) );
489		hl.SetColor( ColorPt(0,1,0), 3 );
490		hl.RefreshAppearance();
491		page4.AnnotPushBack( hl );
492	}
493	{
494		Squiggly sq = Squiggly::Create( doc, Rect(100,450,250,600) );
495		//sq.SetColor( ColorPt(1,0,0), 3 );
496		sq.SetQuadPoint( 0, QuadPoint( Point( 122,455), Point(240, 545), Point(230, 595), Point(101,500 ) ) );
497		sq.RefreshAppearance();
498		page4.AnnotPushBack( sq );
499	}
500	{
501		Caret cr = Caret::Create( doc, Rect(100,40,129,69) );
502		cr.SetColor( ColorPt(0,0,1), 3 );
503		cr.SetSymbol( "P" );
504		cr.RefreshAppearance();
505		page4.AnnotPushBack( cr );
506	}
507
508
509	Page page5 = doc.PageCreate(Rect(0, 0, 600, 600));
510	ew.Begin(page5);	// begin writing to the page
511	ew.End();  // save changes to the current page
512	doc.PagePushBack(page5);
513	FileSpec fs = FileSpec::Create( doc, (input_path + "butterfly.png").c_str(), false );
514	Page page6 = doc.PageCreate(Rect(0, 0, 600, 600));
515	ew.Begin(page6);	// begin writing to the page
516	ew.End();  // save changes to the current page
517	doc.PagePushBack(page6);
518
519	{
520		Text txt = Text::Create( doc, Rect( 10, 20, 30, 40 ) );
521		txt.SetIcon( "UserIcon" );
522		txt.SetContents( "User defined icon, unrecognized by appearance generator" );
523		txt.SetColor( ColorPt(0,1,0) );
524		txt.RefreshAppearance();
525		page6.AnnotPushBack( txt );
526	}
527	{
528		Ink ink = Ink::Create( doc, Rect( 100, 400, 200, 550 ) );
529		ink.SetColor( ColorPt(0,0,1) );
530		ink.SetPoint( 1, 3, Point( 220, 505) );
531		ink.SetPoint( 1, 0, Point( 100, 490) );
532		ink.SetPoint( 0, 1, Point( 120, 410) );
533		ink.SetPoint( 0, 0, Point( 100, 400) );
534		ink.SetPoint( 1, 2, Point( 180, 490) );
535		ink.SetPoint( 1, 1, Point( 140, 440) );		
536		ink.SetBorderStyle( Annot::BorderStyle( Annot::BorderStyle::e_solid, 3, 0, 0  ) );
537		ink.RefreshAppearance();
538		page6.AnnotPushBack( ink );
539	}
540
541
542	Page page7 = doc.PageCreate(Rect(0, 0, 600, 600));
543	ew.Begin(page7);	// begin writing to the page
544	ew.End();  // save changes to the current page
545	doc.PagePushBack(page7);
546
547	{
548		Sound snd = Sound::Create( doc, Rect( 100, 500, 120, 520 ) );
549		snd.SetColor(  ColorPt(1,1,0) );
550		snd.SetIcon( Sound::e_Speaker );
551		snd.RefreshAppearance();
552		page7.AnnotPushBack( snd );
553	}
554	{
555		Sound snd = Sound::Create( doc, Rect( 200, 500, 220, 520 ) );
556		snd.SetColor(  ColorPt(1,1,0) );
557		snd.SetIcon( Sound::e_Mic );
558		snd.RefreshAppearance();
559		page7.AnnotPushBack( snd );
560	}
561
562
563
564
565	Page page8 = doc.PageCreate(Rect(0, 0, 600, 600));
566	ew.Begin(page8);	// begin writing to the page
567	ew.End();  // save changes to the current page
568	doc.PagePushBack(page8);
569
570	for( int ipage =0; ipage < 2; ++ipage ) {
571		double px = 5, py = 520;
572		for( RubberStamp::Icon istamp = RubberStamp::e_Approved; 
573			istamp <= RubberStamp::e_Draft; 
574			istamp = static_cast<RubberStamp::Icon>(  static_cast<int>(istamp) + 1  ) ) {
575				RubberStamp st = RubberStamp::Create( doc, Rect(1,1,100,100) );
576				st.SetIcon( istamp );
577				st.SetContents( UString( st.GetIconName() ) );
578				st.SetRect( Rect(px, py, px+100, py+25 ) );
579				py -= 100;
580				if( py < 0 ) {
581					py = 520;
582					px += 200;
583				}
584				if( ipage == 0 )
585					//page7.AnnotPushBack( st );
586					;
587				else {
588					page8.AnnotPushBack( st );
589					st.RefreshAppearance();
590				}
591		}
592	}
593	RubberStamp st = RubberStamp::Create( doc, Rect(400,5,550,45) );
594	st.SetIcon( "UserStamp" );
595	st.SetContents( "User defined stamp" );
596	page8.AnnotPushBack( st );
597	st.RefreshAppearance();
598
599
600
601}
602
603
604
605
606int main(int argc, char *argv[])
607{
608	int ret = 0;
609	PDFNet::Initialize(LicenseKey);
610
611	std::string output_path = "../../TestFiles/Output/";
612
613	try  
614	{
615		PDFDoc doc((input_path + "numbered.pdf").c_str());
616		doc.InitSecurityHandler();
617
618		// An example of using SDF/Cos API to add any type of annotations.
619		AnnotationLowLevelAPI(doc);
620		doc.Save((output_path + "annotation_test1.pdf").c_str(), SDFDoc::e_linearized, 0);
621		cout << "Done. Results saved in annotation_test1.pdf" << endl;
622
623		// An example of using the high-level PDFNet API to read existing annotations,
624		// to edit existing annotations, and to create new annotation from scratch.
625		AnnotationHighLevelAPI(doc);
626		doc.Save((output_path + "annotation_test2.pdf").c_str(), SDFDoc::e_linearized, 0);
627		cout << "Done. Results saved in annotation_test2.pdf" << endl;
628
629		// an example of creating various annotations in a brand new document
630		PDFDoc doc1;
631		CreateTestAnnots( doc1 );
632		doc1.Save(output_path + "new_annot_test_api.pdf", SDFDoc::e_linearized, 0);
633		cout << "Saved new_annot_test_api.pdf" << std::endl;
634	}
635	catch(Common::Exception& e)
636	{
637		cout << e << std::endl;
638		ret = 1;
639	}
640	catch(...)
641	{
642		cout << "Unknown Exception" << std::endl;
643		ret = 1;
644	}
645
646	PDFNet::Terminate();
647	return ret;
648}