jspdf-dynamo 1.0.0

package/documentation/1. Introduction/Introduction.txt

@@ -0,0 +1,91 @@
+.SetVar ChapterName Introduction
+.do ChapterHeading
+.SetVar text jsPdf-Dynamo is a wrapper around the open-source JavaScript PDF generation library, jsPDF.
+.SetVar text %text% Using a template driven approach, it enables the separation of layout and formatting logic
+.SetVar text %text% from the placement of data.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% *None %text%
+.incCurrentY  %_FONTHEIGHT%
+
+.SetVar text jsPdf-Dynamo can be used with browser or NodeJs JavaScript or TypeScript applications.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% *None %text%
+.incCurrentY  %_FONTHEIGHT%
+
+.DrawText 0 %_CurrentY% Advantages of using jsPdf-Dynamo include:
+.incCurrentY %halfLineGap%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar width %_PageWidth%
+.IncVar width -10
+.SetVar text The separation of layout and formatting logic from the placement of data. As a page is
+.SetVar text %text% filled with data, jsPdf-Dynamo can insert new pages, with appropriate headings,
+.SetVar text %text% footings, and bookmarks as required.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text The ability to store corporate and application wide format settings in templates 
+.SetVar text %text% that can be maintained independently from the application.
+.SetVar text %text% This is similar to the use of style sheets in web applications to enable 
+.SetVar text %text% visual consistency, reduce errors and minimise maintenance costs. These format settings
+.SetVar text %text% can include colours, font styles and sizes, page headings, and more.
+.DrawTextWrapped 10 %top% %width% *None %text%
+.incCurrentY  %_FONTHEIGHT%
+
+.DrawText 0 %_CurrentY% There are a few basic concepts to be aware of when using jsPdf-Dynamo:
+.incCurrentY %halfLineGap%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text The functionality of jsPdf-Dynamo is implemented through the JsPdfDynamo class.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text The initial page size, orientation and units of measure are set when the
+.SetVar text %text% JsPdfDynamo instance is instantiated.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text Output is driven by a series of plain text 'commands'. These
+.SetVar text %text% commands can be provided as a list of strings from multiple sources, 
+.SetVar text %text% including the JavaScript or TypeScript application, or loaded from
+.SetVar text %text% 'templates' retrieved from a URL (browser or NodeJs) or from local text 
+.SetVar text %text% files (NodeJs only).
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text Positions are specified relative to the left and top margin. The exception to this are
+.SetVar text %text% margins which are measured from the appropriate edge of the page.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text All measurements and positions are in the unit of measure specified
+.SetVar text %text% when the instance of JsPdfDynamo is created. This can be millimeters, inches,
+.SetVar text %text% or points. The exception to this are fonts, which are always specified in points.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.DrawText 10 %top% A series of commands can be grouped and named. These groups of commands can then 
+.DrawText 10 %_CurrentY% be processed one or more times. This is a similar concept to methods or procedures
+.DrawText 10 %_CurrentY% in more sophisticated computer languages. 
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text All commands, command group names and variable names are case insensitive.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.SetVar top %_CurrentY%
+.DrawText 5 %top% -
+.SetVar text There are two kinds of variables, user variables and system maintained variables.
+.SetVar text %text% User variables can be created and modified as required using script commands. 
+.SetVar text %text% As the name implies, system maintained variables are created and maintained and
+.SetVar text %text% cannot be directly modified directly by script commands.
+.DrawTextWrapped 10 %top% %width% *None %text%
+
+.incCurrentY  %_FONTHEIGHT%
+.DrawText 0 %_CurrentY% This document has been generated by jsPdf-Dynamo and demonstrates some of its capabilities.

package/documentation/2. JsPdfDynamo/JsPdfDynamo.txt

@@ -0,0 +1,6 @@
+.SetVar ChapterName JsPdfDynamo Class
+.do ChapterHeading
+
+.DrawText 0 %_CurrentY% JsPdfDynamo is implemented using an instance of the JsPdfDynamo class. This class has the 
+.DrawText 0 %_CurrentY% following public properties.
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/constructor.txt

@@ -0,0 +1,31 @@
+.SetVar CommandName Constructor
+.Do CommandHeading
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 const dynamo = new JsPdfDynamo(options, logger)
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 options
+.SetVar CommandLine2 An optional object that implements some or all of the properties of a JsPdfOptions 
+.SetVar CommandLine2 %CommandLine2% object. (Refer to the description in the Other Definitions chapter.)
+.Do CommandLine2
+.SetVar CommandLine1 logger
+.SetVar CommandLine2 An optional object that implements some or all of the properties of a Logger
+.SetVar CommandLine2 %CommandLine2% class. (Refer to the description in the Other Definitions chapter.)
+.SetVar CommandLine2 %CommandLine2% If a logger object is not provided than a default one is created
+.SetVar CommandLine2 %CommandLine2% that outputs to the console.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Returns
+.Do CommandSubHeading
+.SetVar CommandLine1 An instance of the JsPdfDynamo class.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Notes
+.Do CommandSubHeading
+.SetVar text The first, blank page of the PDF will have been created and initialised with the given (or default) values.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/getVariable.txt

@@ -0,0 +1,29 @@
+.SetVar CommandName getVariable()
+.Do CommandHeading
+.SetVar text This method returns the current value of a variable as a string. This can be useful for unit testing.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 getVariable(varName)
+.SetVar CommandLine2 The name of the variable to retrieve. This can be the name of either a user or a 
+.SetVar CommandLine2 %CommandLine2% system maintained variable.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 varName
+.SetVar CommandLine2 A string or constant containing the name of the variable whose value is to be retrieved.
+.SetVar CommandLine2 %CommandLine2% (The name is not case sensitive.)
+.Do CommandLine2
+
+.SetVar CommandSubHeading Returns
+.Do CommandSubHeading
+.SetVar CommandLine1 The current value of the named variable as a string.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Notes
+.Do CommandSubHeading
+.SetVar LongText If the supplied variable does not exist at the time this method is called then a null value is returned.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/prepareWrappedString.txt

@@ -0,0 +1,28 @@
+.SetVar CommandName prepareWrappedString()
+.Do CommandHeading
+.SetVar LongText This method prepares a given string for output by the DrawTextWrapped command.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 const text = myJsPdfDynamo.prepareWrappedString(input)
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 input
+.SetVar CommandLine2 A string that may contain special characters, including percentage signs, back
+.SetVar CommandLine2 %CommandLine2% slashes and new line characters.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Returns
+.Do CommandSubHeading
+.SetVar CommandLine1 The input string with any special characters converted to a format that the DrawTextWrapped
+.SetVar CommandLine1 %CommandLine1% command can use to output the string correctly.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Notes
+.Do CommandSubHeading
+.SetVar LongText If the input string is null or undefined then an empty is returned.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/processCommands.txt

@@ -0,0 +1,27 @@
+.SetVar CommandName processCommands()
+.Do CommandHeading
+.DrawText 0 %_CurrentY% This method processes the commands provided in an array of strings.
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 myJsPdfDynamo.processCommands(commands)
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 commands
+.SetVar CommandLine2 An array of strings containing commands to process.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Notes
+.Do CommandSubHeading
+.SetVar text The commands may (optionally) create the final document using the .SavePdf command.
+.SetVar text %text% Alternatively, additional calls may be made to the processCommands method and/or
+.SetVar text %text% the PDF document can be retrieved using the toBlob or toBlobUrl methods.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 SavePdf, toBlob, toBlobUrl
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/toBlob.txt

@@ -0,0 +1,19 @@
+.SetVar CommandName toBlob()
+.Do CommandHeading
+.DrawText 0 %_CurrentY% This method returns the contents of the current PDF as a Blob.
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 const myBlob = myJsPdfDynamo.toBlob();
+.Do CommandLine2
+
+.SetVar CommandSubHeading Returns
+.Do CommandSubHeading
+.SetVar CommandLine1 A JavaScript Blob containing the current PDF.
+.Do CommandLine2
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 ProcessCommands, SavePdf, toBlobUri
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/2. JsPdfDynamo/toBlobUrl.txt

@@ -0,0 +1,36 @@
+.SetVar CommandName toBlobUrl()
+.Do CommandHeading
+.SetVar text This is a browser only method that generates the current PDF as a Blob
+.SetVar text %text% and returns a string containing a URL to that Blob. This can be
+.SetVar text %text% used to display the PDF in the current or another browser window.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 const blobUrl = myJsPdfDynamo.toBlobUrl();
+.Do CommandLine2
+
+.SetVar CommandSubHeading Returns
+.Do CommandSubHeading
+.SetVar CommandLine1 A string containing the URL reference to the PDF.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Example
+.Do CommandSubHeading
+.SetVar CommandLine1 Display the PDF in a new browser window:
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 const blobUrl = myJsPdfDynamo.toBlobUrl();
+.Do CommandLine2
+.SetVar CommandLine1 if (blobUrl) {
+.Do CommandLine2
+.SetVar CommandLine1    window.open(blobUrl, '_blank');
+.Do CommandLine2
+.SetVar CommandLine1 }
+.Do CommandLine2
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 ProcessCommands, SavePdf, toBlob
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/3. Variables/Introduction.txt

@@ -0,0 +1,36 @@
+.SetVar ChapterName Variables
+.do ChapterHeading
+
+.DrawText 0 %_CurrentY% Variables can be used to substitute fixed text within a template. There are two kinds of variable:
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 * System variables. These are updated automatically and can not be changed directly.
+.Do CommandLine2
+.SetVar CommandLine1 * User defined variables which can be updated by commands in the script.
+.Do CommandLine2
+.incCurrentY %halfLineGap%
+.DrawText 0 %_CurrentY% Commands are described in a following chapter.
+
+.incCurrentY %_FontHeight%
+.DrawText 0 %_CurrentY% Variables are referenced by enclosing them in percentage symbols. For example, to write some
+.DrawText 0 %_CurrentY% text at the current position on the page the following DrawText command can be used:
+.incCurrentY %_FontHeight%
+.SetVar CommandLine1 .DrawText %%%%_CurrentX%%%% %%%%_CurrentY%%%% Hello World!
+.Do CommandLine2 
+.incCurrentY %_FontHeight%
+.DrawText 0 %_CurrentY% Variables (and commands) are not case sensitive and the above command could also be given
+.DrawText 0 %_CurrentY% as:
+.incCurrentY %_FontHeight%
+.SetVar CommandLine1 .drawTEXT %%%%_currentX%%%% %%%%_CURRENTy%%%% Hello World!
+.Do CommandLine2 
+.incCurrentY %_FontHeight%
+.DrawText 0 %_CurrentY% Variables are stored as strings though there is a limited capability to perform arithmatic on
+.DrawText 0 %_CurrentY% variables. For example, the .IncVar command can be used to add or subtract a number from
+.DrawText 0 %_CurrentY% a variable.
+.incCurrentY %_FontHeight%
+.DrawText 0 %_CurrentY% Variables do not have to be assigned a value before being used. 
+.DrawText 0 %_CurrentY% The value of a variable referenced before being assigned a value is an empty string.
+.incCurrentY %_FontHeight%
+.DrawText 0 %_CurrentY% All variables are global, there is no scoping of variables within a group. A variable
+.DrawText 0 %_CurrentY% defined within a group is available to commands run after that group.
+.incCurrentY %_FontHeight%
+

package/documentation/3. Variables/SystemMaintained.txt

@@ -0,0 +1,190 @@
+.SetVar CommandName System Maintained Variables
+.Do CommandHeading
+
+.incCurrentY %halfLineGap%
+.SetVar text JsPdfDynamo maintains and updates various variables as each command is processed. These
+.SetVar text %text% variables can not be changed directly by using the SetVar command. They include:
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.incCurrentY %halfLineGap%
+.SetMargin L 20
+
+.SetVar CommandLine1 _CurrentX
+.SetVar CommandLine2 The current horizontal position on the page, relative to the left margin, in
+.Do VariableLine
+.SetVar CommandLine2 millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _CurrentY
+.SetVar CommandLine2 The current vertical position on the page, relative to the top margin, in
+.Do VariableLine
+.SetVar CommandLine2 millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _CurrentPageSize
+.SetVar CommandLine2 The name of the last page size specified, for example, 'A4', 'Letter'.
+.Do VariableLineWide
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _CurrentPageOrientation
+.SetVar CommandLine2 The last page orientation specified: 
+.Do VariableLineWide
+.SetVar CommandLine2 0=Portrait (default) 1=Landscape 
+.Do VariableLineWide
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FontHeight
+.SetVar CommandLine2 The height of the current font, in millimeters. This can be used to create
+.Do VariableLine
+.SetVar CommandLine2 a space between paragraphs when used in conjunction with the
+.Do VariableLine
+.SetVar CommandLine2 incCurrentY command: .incCurrentY %%%%_FontHeight%%%%
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FontPointSize
+.SetVar CommandLine2 The size of the current font in points. The default font size is 12 points.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FontStyle
+.SetVar CommandLine2 The current font style. For example, "normal" or "italic".
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FontType
+.SetVar CommandLine2 The name of the current font. For example, "Helvetica", which is the
+.Do VariableLine
+.SetVar CommandLine2 default font type.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _ImageHeight
+.SetVar CommandLine2 The height of the last loaded image in the current units of measure.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _ImageHeightPx
+.SetVar CommandLine2 The height of the last loaded image in pixels.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _ImageWidth
+.SetVar CommandLine2 The width of the last loaded image in the current units of measure.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _ImageWidthPx
+.SetVar CommandLine2 The width of the last loaded image in pixels.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastError
+.SetVar CommandLine2 A description of the last error encountered. 
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastImageAdded
+.SetVar CommandLine2 The zero based index of the last image added to the PDF, either from a file or from a URL.
+.Do VariableLineWrapped
+
+.SetVar CommandLine1 _LastImageIndex
+.SetVar CommandLine2 The index of the last drawn image. 
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastObjectHeight
+.SetVar CommandLine2 The height of the last object that has been output, in millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastObjectWidth
+.SetVar CommandLine2 The width of the last object that has been output, in millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastOutline
+.SetVar CommandLine2 This contains the number assigned to each outline entry when it is
+.Do VariableLine
+.SetVar CommandLine2 created. This number is used when creating child outline entries. 
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LastResult
+.SetVar CommandLine2 Most commands update this variable. If the command fails, this will be
+.Do VariableLine
+.SetVar CommandLine2 set to '0'. A successful command wil set this to '1' or to some other
+.Do VariableLine
+.SetVar CommandLine2 useful value. For example, when a new page is created the page number
+.Do VariableLine
+.SetVar CommandLine2 is returned in this variable.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _MarginBottom
+.SetVar CommandLine2 The current margin, in millimeters, from the page bottom edge.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _MarginLeft
+.SetVar CommandLine2 The current margin, in millimeters, from the page left edge.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _MarginRight
+.SetVar CommandLine2 The current margin, in millimeters, from the page right edge.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _MarginTop
+.SetVar CommandLine2 The current margin, in millimeters, from the page top edge.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _PageNo
+.SetVar CommandLine2 The current page number, starting from 1 for the first page.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _PageHeight
+.SetVar CommandLine2 The height of the page, less the current top and bottom margins,
+.Do VariableLine
+.SetVar CommandLine2 expressed in millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _Pages
+.SetVar CommandLine2 The total number of pages in the document.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _PageWidth
+.SetVar CommandLine2 The width of the page, less the current left and right margins, expressed
+.Do VariableLine
+.SetVar CommandLine2 in millimeters.
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _SpaceHoz
+.SetVar CommandLine2 JsPdfDynamo keeps track of the current position, relative to the left
+.Do VariableLine
+.SetVar CommandLine2 margin, after each object is output. This position is calculated in
+.Do VariableLine
+.SetVar CommandLine2 millimeters from the width of the object plus the current horizontal spacing, 
+.Do VariableLine
+.SetVar CommandLine2 which can be set with the SetSpaceHoz command. 
+.Do VariableLine
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _SpaceVert
+.SetVar CommandLine2 JsPdfDynamo keeps track of the current position, in millimeters, relative
+.Do VariableLine
+.SetVar CommandLine2 to the top margin, after each object is output. This position is calculated
+.Do VariableLine
+.SetVar CommandLine2 from the height of the object plus the current vertical spacing, which can 
+.Do VariableLine
+.SetVar CommandLine2 be set with the SetSpaceVert command. 
+.Do VariableLine
+.incCurrentY %_SPACEVERT%
+.Do SetMargins 

package/documentation/4. Commands/AddBookmark.txt

@@ -0,0 +1,47 @@
+.SetVar CommandName AddBookmark
+.Do CommandHeading
+.SetVar text Adds an entry to the document bookmarks. (Bookmarks
+.SetVar text %text% also known as Table of Contents, Sidebar Reference, or Outlines.)
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 .AddBookmark ParentId PageNo Text
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 ParentId
+.SetVar CommandLine2 The Id of the parent bookmark for this entry. Set to zero to create
+.SetVar CommandLine2 %CommandLine2% a new top level bookmark.
+.Do CommandLine2
+.SetVar CommandLine1 PageNo
+.SetVar CommandLine2 The page number to which this bookmark refers to.
+.Do CommandLine2
+.SetVar CommandLine1 Text
+.SetVar CommandLine2 The text for this bookmark.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Other
+.Do CommandSubHeading
+.SetVar CommandLine1 If successful then the variable _LastResult is set to the Id of the bookmark just created, else
+.Do CommandLine
+.SetVar CommandLine1 it is set to '0'.
+.Do CommandLine
+
+.SetVar CommandSubHeading Examples
+.Do CommandSubHeading
+.SetVar CommandLine1 Create a top level bookmark entry for the current page:
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .AddBookmark 0 %%%%_PAGENO%%%% Chapter one of the document 
+.Do CommandLine2
+.SetVar CommandLine1 .SetVar Chapter1 %%%%_LastResult%%%% 
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+.SetVar CommandLine1 Create a child bookmark entry for the chapter 1:
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .AddBookmark %%%%Chapter1%%%% %%%%_PAGENO%%%% Chapter one, Paragraph 1 
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/4. Commands/AddImageFromFile.txt

@@ -0,0 +1,59 @@
+.SetVar CommandName AddImageFromFile (NodeJs Only)
+.Do CommandHeading
+.SetVar text Reads an image from the file system and stores it for later output. JsPdfDynamo can use all image types
+.SetVar text %text% that jsPDF supports, including: BMP, GIF, JPEG, PNG, TIFF and WEBP
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 .AddImageFromFile FileName
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 FileName
+.SetVar CommandLine2 The name and relative path to the image file to be read.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Other
+.Do CommandSubHeading
+.SetVar CommandLine1 If successful then the variable _LastResult is set '1', else it is set to '0'.
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 If successful then several other variables are also set:
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1c _ImageHeight is set to the height of the image in the current units of measure.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageHeightPx is set to the height of the image pixels.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageWidth is set to the width of the image in the current units of measure.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageWidthPx is set to the width of the image pixels.
+.Do CommandLine2
+.SetVar CommandLine1c _LastImageAdded is the Id of the image just loaded. This is used when adding the image to the document.
+.Do CommandLine2
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 An image only needs to be loaded once, but it can be drawn multiple times in the document 
+.SetVar CommandLine1 %CommandLine1% by referring to the image's Id.
+.Do CommandLine
+
+.SetVar CommandSubHeading Examples
+.Do CommandSubHeading
+.SetVar CommandLine1 Read a logo from an image and add it to the top left of the current page.
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .AddImageFromFile ../images/myLogo.jpg
+.Do CommandLine2
+.SetVar CommandLine1 .SetVar IdLogo %%%%_LastImageAdded%%%% 
+.Do CommandLine2
+.SetVar CommandLine1 .DrawImage %%%%IdLogo%%%% 0 0 1
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 AddImageFromUrl, DrawImage
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/4. Commands/AddImageFromUrl.txt

@@ -0,0 +1,63 @@
+.SetVar CommandName AddImageFromUrl
+.Do CommandHeading
+.SetVar text Reads an image from the given URL and stores it for later output. JsPdfDynamo can use all image types
+.SetVar text %text% that jsPDF supports, including: BMP, GIF, JPEG, PNG, TIFF and WEBP
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+.SetVar text This command is available for both browser and NodeJs applications.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 .AddImageFromUrl URL
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 URL
+.SetVar CommandLine2 The URL to the image file to be read. 
+.Do CommandLine2
+
+.SetVar CommandSubHeading Other
+.Do CommandSubHeading
+.SetVar CommandLine1 If successful then the variable _LastResult is set '1', else it is set to '0'.
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 If successful then several other variables are also set:
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1c _ImageHeight is set to the height of the image in the current units of measure.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageHeightPx is set to the height of the image pixels.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageWidth is set to the width of the image in the current units of measure.
+.Do CommandLine2
+.SetVar CommandLine1c _ImageWidthPx is set to the width of the image pixels.
+.Do CommandLine2
+.SetVar CommandLine1c _LastImageAdded is Id of the image just loaded. This is used when adding the image to the document.
+.Do CommandLine2
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 An image only needs to be loaded once, but it can be drawn multiple times in the document 
+.SetVar CommandLine1 %CommandLine1% by referring to the image's Id.
+.Do CommandLine
+
+.SetVar CommandSubHeading Examples
+.Do CommandSubHeading
+.SetVar CommandLine1 Read a logo from an image and add it to the top left of the current page.
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .AddImageFromUrl /images/logo.png
+.Do CommandLine2
+.SetVar CommandLine1 .SetVar IdLogo %%%%_LastImageAdded%%%% 
+.Do CommandLine2
+.SetVar CommandLine1 .DrawImage %%%%IdLogo%%%% 0 0 1
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 AddImageFromFile, DrawImage
+.Do CommandLine2
+
+.incCurrentY %_FontHeight%