Documentation
Tutorials
Getting started Package repositories Minified collections
Github Then to now walk through Samples

Source

meadco-scriptxfactory.js

  1. /**
  2.  * MeadCo ScriptX 'window.factory' shim (support for modern browsers) JS client library.<br/>
  3.  * 
  4.  * The ScriptX Add-on for Internet Explorer is included on a html document with an &lt;object /&gt; element with a de-facto standard id of 'factory': &lt;object id='factory' /&gt;.
  5.  * 
  6.  * The object is referenced with the property window.factory which exposes properties and methods to define print setting and perform operations such as printing a document or frame.
  7.  * 
  8.  * The object has three further properties:
  9.  * - object
  10.  *   - js
  11.  * - rawPrinting  
  12.  * - printing
  13.  *   - printerControl
  14.  *   - enhancedFormatting
  15.  *
  16.  * This javascript 'module' provides partial emulation of window.factory, window.factory.object and window.factory.object.js
  17.  * 
  18.  * Full emulation (and almost complete implementation) is provided for window.factory.printing, window.factory.printing.printerControl, window.factory.printing.enhancedFormatting. The most notable absent implementation is an implementation of print preview.
  19.  * 
  20.  * Full emulation is provided for window.factory.rawPrinting. Please note that the implementation is synchronous and browsers will issue a warning to the console.
  21.  * 
  22.  * ScriptX Add-on for Internet Explorer intercepts the browser UI for printing. For obvious reasons this is not possible with javascript, however ::
  23.  * 
  24.  * <strong>PLEASE NOTE:</strong> This library replaces window.print(). 
  25.  * 
  26.  * Full documentation on the properties/methods is provided by the {@link https://www.meadroid.com/Developers/KnowledgeBank/TechnicalReference/ScriptXAddOn|technical reference documentation} for the ScriptX Add-on for Internet Explorer. That documentation is not reproduced here.
  27.  * 
  28.  * If the startup script determines that the ScriptX Add.on for IE is already active then it will quietly give priority to the object. In other words, the Add-on has precedence on Internet Explorer.
  29.  * 
  30.  * This enables the same experience (almost) to be delivered to any browser on any device with the same html/javascript code.
  31.  * 
  32.  * It is strongly recommended that the [MeadCoScriptJS library]{@link https://github.com/MeadCo/MeadCoScriptXJS} is used in conjunction with this library as it provides code (Promises) to assist
  33.  * with working with the significant difference between the synchronous nature of the functions of ScriptX.Add-on (which hide the underlying asynchrony) and the asynchronous nature of javascript AJAX processing.
  34.  * 
  35.  * Requires:
  36.  * - MeadCo.Core
  37.  * - MeadCo.ScriptX.Print
  38.  * - MeadCo.ScriptX.Print.HTML
  39.  *
  40.  * - MeadCo.ScriptX.Print.Licensing when using ScritpX.Services for Windows PC
  41.  *      
  42.  * MeadCo.ScriptX.Print.HTML.connect[Async]() or MeadCo.ScriptX.Print.connect[Async]() *MUST* be called before using the apis in this library.
  43.  * 
  44.  * See [ScriptX Samples]{@link https://scriptxprintsamples.meadroid.com} for a lot of samples on using this code.
  45.  * 
  46.  * Some Add-on APIs lead to system provided dialogs (e.g. printer and paper setup) - support for implementing the dialogs in javascript as simple plug-ins is provided, along with an example implementation using bootstrap/jQuery (see jQuery-MeadCo.ScriptX.Print.UI.js)
  47.  *
  48.  * @example
  49.  * MeadCo.ScriptX.Print.UI = {
  50.  *    PageSetup: function(fnDialgCompleteCallBack) { ... dialog code ...},
  51.  *    PrinterSettings: function(fnDialgCompleteCallBack) { ... dialog code ...}
  52.  * }
  53.  * 
  54.  * @namespace factory
  55.  */
  57. // we anti-polyfill &lt;object id="factory" /&gt;
  58. // enabling old code to run in modern browsers
  59. //
  60. // static singleton instances.
  61. //
  62. ; (function (name, definition, undefined) {
  64.     if (this[name] !== undefined || document.getElementById(name) !== null) {
  65.         MeadCo.log("ScriptX.Services ScriptX.factory emulation believes it may not be requred.");
  66.         if (this[name] !== undefined) {
  67.             MeadCo.log("this[" + name + "] is defined");
  68.         }
  69.         if (document.getElementById(name) !== null) {
  70.             MeadCo.log("document.getElementById(" + name + ") is defined");
  71.         }
  72.         if (this[name].object !== undefined) {
  73.             MeadCo.log("this[" + name + "].object is defined -- not required!!!");
  74.             return;
  75.         } else {
  76.             MeadCo.log("this[" + name + "].object is *not* defined");
  77.         }
  78.     }
  80.     MeadCo.log("ScriptX.Services ScriptX.factory emulation believes it is requred.");
  81.     var theModule = definition();
  83.     // Assign to the global object (window)
  84.     (this)[name] = theModule;
  86. })('factory', function () {
  87.     // If this is executing, we believe we are needed.
  88.     // protected API
  89.     const moduleversion = "1.16.0.0";
  90.     const emulatedVersion = "8.3.0.0";
  91.     let servicesVersion = "";
  92.     const printApi = MeadCo.ScriptX.Print;
  93.     const logApi = MeadCo; // could be console
  95.     let outerScope = this;
  97.     function log(str) {
  98.         logApi.log("factory emulation :: " + str);
  99.     }
  101.     log("'factory' loaded " + moduleversion);
  103.     // public API.
  104.     return {
  105.         log: log,
  107.         // 'factory' functions
  109.         /* GetComponentVersion is no longer documented . It is implemented as MeadCoScriptJS relies on it.
  110.          * 
  111.          * We support ScriptX ProgIds and progid style names for scriptx services.
  112.          */
  113.         GetComponentVersion: function (sComponent, a, b, c, d) {
  114.             log("factory.object.getcomponentversion: " + sComponent);
  115.             var v = moduleversion;
  117.             switch (sComponent.toLowerCase()) {
  118.                 case "scriptx.factory":
  119.                     v = emulatedVersion;
  120.                     break;
  122.                 case "scriptx.factory.services":
  123.                     v = moduleversion;
  124.                     break;
  126.                 case "scriptx.services":
  127.                     if (servicesVersion === "") {
  128.                         if (typeof printApi !== "undefined") {
  129.                             var ea = printApi.onErrorAction;
  131.                             printApi.onErrorAction = printApi.ErrorAction.THROW;
  133.                             try {
  134.                                 var sd = printApi.serviceDescription();
  135.                                 if (sd !== null) {
  136.                                     if (typeof sd.serviceVersion === "string") {
  137.                                         servicesVersion = sd.serviceVersion;
  138.                                     }
  139.                                     else {
  140.                                         var sv = sd.serviceVersion;
  141.                                         servicesVersion = sv.major + "." + sv.minor + "." + sv.build + "." + sv.revision;
  142.                                     }
  143.                                 }
  144.                             } catch (e) { servicesVersion = moduleversion; }
  146.                             printApi.onErrorAction = ea;
  147.                         }
  148.                     }
  149.                     v = servicesVersion;
  150.                     break;
  152.                 case "meadco.secmgr":
  153.                     try {
  154.                         v = outerScope.secmgr.version;
  155.                     } catch (e) { v = "0.0.0.0"; }
  156.                     break;
  158.                 case "meadco.triprint":
  159.                     try {
  160.                         v = MeadCo.ScriptX.Print.HTML.version;
  161.                     } catch (e) { v = "0.0.0.0"; }
  162.                     break;
  163.             }
  165.             v = v.split(".");
  166.             a[0] = v[0];
  167.             b[0] = v[1];
  168.             c[0] = v[2];
  169.             d[0] = v[3];
  170.         },
  172.         /*
  173.          * Only ScriptX related ProgIds are supported.
  174.          *
  175.          */
  176.         ComponentVersionString: function (sProgId) {
  177.             var a = new Object();
  178.             var b = new Object();
  179.             var c = new Object();
  180.             var d = new Object();
  182.             outerScope.factory.GetComponentVersion(sProgId, a, b, c, d);
  183.             return a[0] + "." + b[0] + "." + c[0] + "." + d[0];
  184.         },
  186.         get ScriptXVersion() { return emulatedVersion; },
  187.         get SecurityManagerVersion() { return emulatedVersion; },
  189.         /*
  190.          * Unique IDs are not suported in services
  191.          */
  192.         IsUniqueIDAvailable: function (bForMachine) { return false; },
  193.         UniqueID: function (bForMachine) { return 0; },
  194.         ResetUniqueID: function (bForMachine) { return 0; },
  196.         baseURL: function (sUrl) {
  197.             var link = document.createElement("a");
  198.             link.href = sUrl;
  199.             return link.href;
  200.         },
  202.         relativeURL: function (sUrl) {
  203.             throw "MeadCo.ScriptX.Print :: relativeUrl is not implemented.\n\nPlease see https://github.com/medialize/URI.js for an alternative.";
  204.         },
  206.         OnDocumentComplete: function (frameOrWindow, callback) {
  207.             // other windows is an anachronism we dont support, this window is, by 
  208.             // definition, complete
  209.             if (typeof frameOrWindow.contentWindow === "undefined") {
  210.                 callback();
  211.             }
  212.             else {
  213.                 // a frame .. listen for load 
  214.                 frameOrWindow.addEventListener("load", function (e) {
  215.                     callback();
  216.                 }, { once: true });
  217.             }
  218.         },
  220.         get rawPrinting() {
  221.             var sPrinterName = "";
  222.             var printApi = MeadCo.ScriptX.Print;
  224.             function printDirect(eContentType, sContent) {
  226.                 var bPrinted = false;
  228.                 if (typeof printApi !== "undefined") {
  230.                     var p = factory.printing.printer;
  232.                     factory.printing.printer = sPrinterName;
  234.                     if (eContentType === printApi.ContentType.URL) {
  235.                         sContent = outerScope.factory.baseURL(sContent);
  236.                     }
  238.                     bPrinted = printApi.printDirect(eContentType, sContent);
  240.                     factory.printing.printer = p;
  241.                 }
  243.                 return bPrinted;
  244.             }
  246.             return {
  248.                 get printer() { return sPrinterName; },
  249.                 set printer(printerName) {
  250.                     var p = factory.printing.printer;
  251.                     factory.printing.printer = printerName;
  252.                     if (factory.printing.printer !== printerName) {
  253.                         throw "Unknown printer";
  254.                     }
  255.                     factory.printing.printer = p;
  256.                     sPrinterName = printerName;
  257.                 },
  259.                 printString: function (s) {
  260.                     return typeof printApi !== "undefined" ? printDirect(printApi.ContentType.STRING, s) : false;
  261.                 },
  263.                 printDocument: function (sUrl) {
  264.                     return typeof printApi !== "undefined" ? printDirect(printApi.ContentType.URL, sUrl) : false;
  265.                 }
  266.             };
  267.         },
  270.         /*
  271.          * A no op for services 
  272.          */
  273.         Shutdown: function () {
  274.             return null;
  275.         },
  277.         // extend the namespace
  278.         extendFactoryNamespace: function (name, definition) {
  279.             var theModule = definition();
  281.             log("MeadCo factory extending namespace: " + name);
  282.             // walk/build the namespace part by part and assign the module to the leaf
  283.             var namespaces = name.split(".");
  284.             var scope = outerScope;
  285.             for (var i = 0; i < namespaces.length; i++) {
  286.                 var packageName = namespaces[i];
  287.                 if (i === namespaces.length - 1) {
  288.                     if (typeof scope[packageName] === "undefined") {
  289.                         log("installing implementation at: " + packageName);
  290.                         scope[packageName] = theModule;
  291.                     } else {
  292.                         log("Warning - not overwriting package: " + packageName);
  293.                     }
  294.                 } else if (typeof scope[packageName] === "undefined") {
  295.                     log("initialising new: " + packageName);
  296.                     scope[packageName] = {};
  297.                 } else {
  298.                     log("using existing package: " + packageName);
  299.                 }
  300.                 scope = scope[packageName];
  301.             }
  302.         },
  304.         // a Ctrl-P handler function 
  305.         keyPressCtrlP: function (e) {
  306.             if (e.ctrlKey && e.keyCode == 80 && !e.shiftKey) {
  307.                 e.preventDefault();
  308.                 log("ctrl-p being handled.");
  309.                 outerScope.print();
  310.             }
  311.         },
  313.     };
  314. });
  316. ; (function (name, definition) {
  317.     if (typeof factory.extendFactoryNamespace === "function") {
  318.         factory.extendFactoryNamespace(name, definition);
  319.     }
  320. })('factory.printing', function () {
  322.     // protected API
  323.     const printHtml = MeadCo.ScriptX.Print.HTML;
  324.     const printPdf = MeadCo.ScriptX.Print.PDF;
  325.     const settings = printHtml.settings;
  326.     const printApi = MeadCo.ScriptX.Print;
  327.     const htmlPrefixes = ["html://", "html4://", "html5://"];
  329.     let outerScope = this;
  330.     let unloadMsg = "";
  332.     outerScope.factory.log("factory.Printing loaded.");
  334.     function promptAndPrint(bPrompt, fnPrint, fnNotifyStarted) {
  335.         if (typeof (bPrompt) === 'undefined') bPrompt = true;
  336.         const lock = printApi.ensureSpoolingStatus();
  337.         let bStarted = false;
  338.         let err = null;
  340.         if (bPrompt) {
  341.             if (MeadCo.ScriptX.Print.UI) {
  342.                 MeadCo.ScriptX.Print.UI.PrinterSettings(function (dlgAccepted) {
  343.                     if (dlgAccepted) {
  344.                         MeadCo.log("promptAndPrint requesting print ...");
  345.                         try {
  346.                             bStarted = fnPrint();
  347.                             fnNotifyStarted(bStarted);
  348.                         }
  349.                         catch (e) {
  350.                             err = e;
  351.                             MeadCo.error(e.message)
  352.                             fnNotifyStarted(false);
  353.                         }
  354.                     }
  355.                     else
  356.                         fnNotifyStarted(false);
  358.                     printApi.freeSpoolStatus(lock);
  360.                 });
  362.                 MeadCo.log("promptAndPrint exits ...");
  364.                 if (err != null) { // not great but a breaking change to remove this behaviour
  365.                     throw err;
  366.                 }
  368.                 return bStarted;
  369.             }
  370.             MeadCo.warn("prompted print requested but no UI library loaded. See: https://www.meadroid.com/Developers/KnowledgeBank/Articles/Dialogs");
  371.         }
  373.         try {
  374.             bStarted = fnPrint();
  375.             fnNotifyStarted(bStarted);
  376.         }
  377.         catch (e) {
  378.             err = e;
  379.             MeadCo.error(e.message)
  380.             fnNotifyStarted(false);
  381.         }
  382.         finally {
  383.             printApi.freeSpoolStatus(lock);
  384.         }
  386.         if (err !== null)
  387.             throw err;
  390.         return bStarted;
  391.     }
  393.     function isSnippet(sContent) {
  395.         var foundPrefix = htmlPrefixes.find(function (sPrefix) {
  396.             return sContent.indexOf(sPrefix) === 0;
  397.         });
  399.         if (typeof foundPrefix === "string") {
  400.             return sContent.substring(foundPrefix.length);
  401.         }
  403.         return "";
  404.     }
  406.     function printHtmlContent(sUrl, bPrompt, fnNotifyStarted, fnCallback, data) {
  408.         var sHtml = isSnippet(sUrl);
  410.         // if requesting snippet then trim to just the html
  411.         if (sHtml.length > 0) {
  412.             var docType = "<!doctype";
  414.             // add-on scripters might also add doctype but the server handles this 
  415.             if (sHtml.substr(0, docType.length).toLowerCase() === docType) {
  416.                 sHtml = sHtml.substring(sHtml.indexOf(">") + 1);
  417.             }
  418.         } else {
  419.             // if a relative URL supplied then add the base URL of this website
  420.             sUrl = outerScope.factory.baseURL(sUrl);
  421.         }
  423.         return promptAndPrint(bPrompt,
  424.             function () {
  425.                 MeadCo.log("printHtmlContent requesting print ...");
  426.                 return sHtml.length > 0 ? printHtml.printHtml(sHtml, null, fnCallback, data) : printHtml.printFromUrl(sUrl, null, fnCallback, data);
  427.             }, fnNotifyStarted);
  429.     }
  431.     function printPdfContent(sUrl, bPrompt, fnNotifyStarted, fnCallback, data) {
  432.         // if a relative URL supplied then add the base URL of this website
  433.         if (typeof printPdf !== "undefined") {
  434.             sUrl = outerScope.factory.baseURL(sUrl);
  436.             return promptAndPrint(bPrompt,
  437.                 function () {
  438.                     MeadCo.log("printPdfContent requesting print ...");
  439.                     return printPdf.print(sUrl, null, fnCallback, data);
  440.                 },
  441.                 fnNotifyStarted);
  442.         }
  444.         MeadCo.error("MeadCo.ScriptX.Print.PDF is not available to ScriptX.Services factory emulation.");
  445.         fnNotifyStarted(false);
  446.         return false;
  447.     }
  449.     var iEnhancedFormatting = {
  450.         get allPagesHeader() {
  451.             return settings.extraHeadersAndFooters.allPagesHeader;
  452.         },
  453.         set allPagesHeader(v) {
  454.             settings.extraHeadersAndFooters.allPagesHeader = v;
  455.         },
  457.         get allPagesFooter() {
  458.             return settings.extraHeadersAndFooters.allPagesFooter;
  459.         },
  460.         set allPagesFooter(v) {
  461.             settings.extraHeadersAndFooters.allPagesFooter = v;
  462.         },
  464.         get firstPageHeader() {
  465.             return settings.extraHeadersAndFooters.firstPageHeader;
  466.         },
  467.         set firstPageHeader(v) {
  468.             settings.extraHeadersAndFooters.firstPageHeader = v;
  469.         },
  471.         get firstPageFooter() {
  472.             return settings.extraHeadersAndFooters.firstPageFooter;
  473.         },
  474.         set firstPageFooter(v) {
  475.             settings.extraHeadersAndFooters.firstPageFooter = v;
  476.         },
  478.         get extraFirstPageFooter() {
  479.             return settings.extraHeadersAndFooters.extraFirstPageFooter;
  480.         },
  481.         set extraFirstPageFooter(v) {
  482.             settings.extraHeadersAndFooters.extraFirstPageFooter = v;
  483.         },
  485.         get allHeaderHeight() {
  486.             return settings.extraHeadersAndFooters.allHeaderHeight;
  487.         },
  488.         set allHeaderHeight(v) {
  489.             if (typeof v !== "number") {
  490.                 throw "Invalid argument";
  491.             }
  492.             settings.extraHeadersAndFooters.allHeaderHeight = v;
  493.         },
  495.         get allFooterHeight() {
  496.             return settings.extraHeadersAndFooters.allFooterHeight;
  497.         },
  498.         set allFooterHeight(v) {
  499.             if (typeof v !== "number") {
  500.                 throw "Invalid argument";
  501.             }
  502.             settings.extraHeadersAndFooters.allFooterHeight = v;
  503.         },
  505.         get firstHeaderHeight() {
  506.             return settings.extraHeadersAndFooters.firstHeaderHeight;
  507.         },
  508.         set firstHeaderHeight(v) {
  509.             if (typeof v !== "number") {
  510.                 throw "Invalid argument";
  511.             }
  512.             settings.extraHeadersAndFooters.firstHeaderHeight = v;
  513.         },
  515.         get firstFooterHeight() {
  516.             return settings.extraHeadersAndFooters.firstFooterHeight;
  517.         },
  518.         set firstFooterHeight(v) {
  519.             if (typeof v !== "number") {
  520.                 throw "Invalid argument";
  521.             }
  522.             settings.extraHeadersAndFooters.firstFooterHeight = v;
  523.         },
  525.         get extraFirstFooterHeight() {
  526.             return settings.extraHeadersAndFooters.extraFirstFooterHeight;
  527.         },
  528.         set extraFirstFooterHeight(v) {
  529.             if (typeof v !== "number") {
  530.                 throw "Invalid argument";
  531.             }
  532.             settings.extraHeadersAndFooters.extraFirstFooterHeight = v;
  533.         },
  535.         get pageRange() {
  536.             return settings.pageRange;
  537.         },
  538.         set pageRange(v) {
  539.             settings.pageRange = v;
  540.             if (typeof printPdf !== "undefined") {
  541.                 printPdf.settings.pageRange = v;
  542.             }
  543.         },
  545.         get printingPass() {
  546.             var v = "";
  547.             switch (settings.printingPass) {
  548.                 case printHtml.PrintingPasses.DEFAULT:
  549.                 case printHtml.PrintingPasses.ALL:
  550.                     v = "all";
  551.                     break;
  553.                 case printHtml.PrintingPasses.ODD:
  554.                     v = "odd";
  555.                     break;
  557.                 case printHtml.PrintingPasses.EVEN:
  558.                     v = "even";
  559.                     break;
  561.             }
  562.             return v;
  563.         },
  564.         set printingPass(v) {
  565.             var x = printHtml.PrintingPasses.ALL;
  566.             if (typeof v === "string") {
  567.                 switch (v.toLowerCase()) {
  568.                     case "odd":
  569.                         x = printHtml.PrintingPasses.ODD;
  570.                         break;
  572.                     case "even":
  573.                         x = printHtml.PrintingPasses.EVEN;
  574.                         break;
  576.                     case "odd&even":
  577.                     case "all":
  578.                         x = printHtml.PrintingPasses.ALL;
  579.                         break;
  580.                 }
  581.             }
  582.             settings.printingPass = x;
  583.         },
  585.         get pdfPrintMode() {
  586.             return typeof printPdf !== "undefined" ? printPdf.settings.printQuality : 0;
  587.         },
  588.         set pdfPrintMode(v) {
  589.             if (typeof printPdf !== "undefined") {
  590.                 printPdf.settings.printQuality = v;
  591.             }
  592.         }
  594.     };
  596.     if (typeof printApi !== "undefined") {
  597.         printApi.useAttributes();
  599.         if (typeof outerScope.print === "function") {
  600.             outerScope.factory.log("overwriting outerScope.print");
  601.             outerScope.print = function () {
  602.                 outerScope.factory.log("window.print() called and being handled.");
  603.                 promptAndPrint(
  604.                     true,
  605.                     function () {
  606.                         return printHtml.printDocument();
  607.                     },
  608.                     function () { });
  609.             };
  610.         }
  612.         // ScriptX.Addon printing intercepts Ctrl-p ...
  613.         // listen for Ctrl-P and override ...
  614.         var doNotEnable = document.querySelector("[data-meadco-ctrlp='false']") != null;
  615.         if (!doNotEnable) {
  616.             outerScope.factory.log("using addEventListener('keydown',factory.keyPressCtrlP) for Ctrl-P");
  617.             document.addEventListener("keydown", factory.keyPressCtrlP);
  618.         }
  619.     }
  620.     else {
  621.         MeadCo.error("MeadCo.ScriptX.Print is not available to ScriptX.Services factory emulation.");
  622.     }
  624.     // public API
  625.     return {
  626.         // basic properties
  627.         //
  629.         set header(str) {
  630.             outerScope.factory.log("set factory.printing.header: " + str);
  631.             settings.header = str;
  632.         },
  634.         get header() {
  635.             return settings.header;
  636.         },
  638.         set footer(str) {
  639.             settings.footer = str;
  640.         },
  642.         get footer() {
  643.             return settings.footer;
  644.         },
  646.         set headerFooterFont(str) {
  647.             settings.headerFooterFont = str;
  648.         },
  650.         get headerFooterFont() {
  651.             return settings.headerFooterFont;
  652.         },
  654.         set orientation(sOrientation) {
  655.             switch (sOrientation.toLowerCase()) {
  656.                 case "landscape":
  657.                     settings.page.orientation = printHtml.PageOrientation.LANDSCAPE;
  658.                     break;
  660.                 case "portrait":
  661.                     settings.page.orientation = printHtml.PageOrientation.PORTRAIT;
  662.                     break;
  663.             }
  664.         },
  666.         get orientation() {
  667.             return settings.page.orientation === printHtml.PageOrientation.PORTRAIT ? "portrait" : "landscape";
  668.         },
  670.         set portrait(bPortrait) {
  671.             settings.page.orientation = bPortrait ? printHtml.PageOrientation.PORTRAIT : printHtml.PageOrientation.LANDSCAPE;
  672.         },
  674.         get portrait() {
  675.             return settings.page.orientation === printHtml.PageOrientation.PORTRAIT;
  676.         },
  678.         set leftMargin(n) {
  679.             settings.page.margins.left = n;
  680.         },
  682.         get leftMargin() {
  683.             return settings.page.margins.left;
  684.         },
  686.         set topMargin(n) {
  687.             settings.page.margins.top = n;
  688.         },
  690.         get topMargin() {
  691.             return settings.page.margins.top;
  692.         },
  694.         set bottomMargin(n) {
  695.             settings.page.margins.bottom = n;
  696.         },
  698.         get bottomMargin() {
  699.             return settings.page.margins.bottom;
  700.         },
  702.         set rightMargin(n) {
  703.             settings.page.margins.right = n;
  704.         },
  706.         get rightMargin() {
  707.             return settings.page.margins.right;
  708.         },
  710.         // templateURL is a no-op at this time. In the future may
  711.         // enable alternative server behaviour. Doing something
  712.         // is required by the minimiser or it optimises to bad code
  713.         set templateURL(sUrl) {
  714.             var x = sUrl;
  715.         },
  717.         get templateURL() {
  718.             return "MeadCo://default";
  719.         },
  721.         // basic functions
  722.         //
  724.         // No longer relevant, has returned true since IE 6 and was
  725.         // a proxy for testing if the browser was IE5.5 or later!
  726.         IsTemplateSupported: function () {
  727.             return true;
  728.         },
  730.         PageSetup: function (fnNotify) {
  731.             if (typeof fnNotify !== "function") {
  732.                 MeadCo.warn("PageSetup API in ScriptX.Print Service is not synchronous, there is no return value.");
  733.                 fnNotify = function (bDlgOK) { MeadCo.log("PageSetupDlg: " + bDlgOK); };
  734.             }
  736.             if (MeadCo.ScriptX.Print.UI) {
  737.                 MeadCo.ScriptX.Print.UI.PageSetup(fnNotify);
  738.             } else {
  739.                 MeadCo.error("PageSetup dialog in ScriptX.Services needs a dialog implementation. See: https://www.meadroid.com/Developers/KnowledgeBank/Articles/Dialogs");
  740.                 fnNotify(false);
  741.             }
  742.         },
  744.         PrintSetup: function (fnNotify) {
  745.             if (typeof fnNotify !== "function") {
  746.                 MeadCo.warn("PrintSetup API in ScriptX.Print Service is not synchronous, there is no return value.");
  747.                 fnNotify = function (bDlgOK) { MeadCo.log("PrintSetupDlg: " + bDlgOK); }
  748.             }
  750.             if (MeadCo.ScriptX.Print.UI) {
  751.                 MeadCo.ScriptX.Print.UI.PrinterSettings(fnNotify);
  752.             } else {
  753.                 MeadCo.error("PrintSettings dialog in ScriptX.Services needs a dialog implementation. See: https://www.meadroid.com/Developers/KnowledgeBank/Articles/Dialogs");
  754.                 fnNotify(false);
  755.             }
  756.         },
  758.         Preview: function (sOrOFrame) {
  759.             if (!sOrOFrame) {
  760.                 sOrOFrame = null;
  761.             }
  762.             else {
  763.                 // passing in window, or window.self etc will not have an id .. don't barf on that code
  764.                 if (typeof (sOrOFrame) === 'object' && !sOrOFrame.id) {
  765.                     sOrOFrame = null;
  766.                 }
  767.             }
  769.             if (sOrOFrame !== null) {
  770.                 var sFrame = typeof (sOrOFrame) === 'string' ? sOrOFrame : sOrOFrame.id;
  771.                 return printHtml.previewFrame(sFrame);
  772.             }
  774.             printHtml.previewDocument();
  775.         },
  777.         Print: function (bPrompt, sOrOFrame, fnNotifyStarted) { // needs and wants update to ES2015 (for default values)
  778.             if (!fnNotifyStarted) {
  779.                 fnNotifyStarted = function (bStarted) { MeadCo.log("A print has started: " + bStarted); };
  780.             }
  781.             if (!sOrOFrame) {
  782.                 sOrOFrame = null;
  783.             }
  784.             else {
  785.                 // passing in window, or window.self etc will not have an id .. don't barf on that code
  786.                 if (typeof (sOrOFrame) === 'object' && !sOrOFrame.id) {
  787.                     sOrOFrame = null;
  788.                 }
  789.             }
  791.             return promptAndPrint(bPrompt,
  792.                 function () {
  793.                     if (sOrOFrame !== null) {
  794.                         var sFrame = typeof (sOrOFrame) === 'string' ? sOrOFrame : sOrOFrame.id;
  795.                         return printHtml.printFrame(sFrame);
  796.                     }
  798.                     return printHtml.printDocument();
  799.                 },
  800.                 fnNotifyStarted);
  801.         },
  803.         PrintHTML: function (sUrl, bPrompt, fnNotifyStarted) {
  804.             if (typeof fnNotifyStarted === "undefined") {
  805.                 fnNotifyStarted = function (bStarted) { };
  806.             }
  807.             return printHtmlContent(sUrl, bPrompt, fnNotifyStarted);
  808.         },
  810.         PrintHTMLEx: function (sUrl, bPrompt, fnCallback, data, fnNotifyStarted) {
  811.             if (typeof fnNotifyStarted === "undefined") {
  812.                 fnNotifyStarted = function (bStarted) { };
  813.             }
  814.             return printHtmlContent(sUrl, bPrompt, fnNotifyStarted, fnCallback, data);
  815.         },
  817.         PrintPDF: function (options, bPrompt, bShrinkToFit, iPageFrom, iPageTo, fnNotifyStarted) {
  818.             if (typeof fnNotifyStarted === "undefined") {
  819.                 fnNotifyStarted = function (bStarted) { };
  820.             }
  822.             if (typeof printPdf !== "undefined") {
  824.                 printPdf.resetSettings();
  826.                 if (typeof options.pagescaling !== "undefined") {
  827.                     printPdf.settings.pageScaling = options.pagescaling;
  828.                 } else {
  829.                     printPdf.settings.pageScaling = bShrinkToFit
  830.                         ? printPdf.PdfPageScaling.SHRINKLARGEPAGES
  831.                         : printPdf.PdfPageScaling.UNDEFINED;
  832.                 }
  834.                 if (typeof options.autorotatecenter !== "undefined") {
  835.                     printPdf.settings.autoRotateCenter = options.autorotatecenter
  836.                         ? printPdf.BooleanOption.TRUE
  837.                         : printPdf.BooleanOption.FALSE;
  838.                 } else
  839.                     printPdf.settings.autoRotateCenter = printPdf.BooleanOption.DEFAULT;
  841.                 if (typeof options.orientation !== "undefined") {
  842.                     printPdf.settings.orientation = options.orientation === 1
  843.                         ? printPdf.PageOrientation.PORTRAIT
  844.                         : printPdf.PageOrientation.LANDSCAPE;
  845.                 } else
  846.                     printPdf.settings.orientation = this.portrait
  847.                         ? printPdf.PageOrientation.PORTRAIT
  848.                         : printPdf.PageOrientation.LANDSCAPE;
  850.                 if (typeof options.pages !== "undefined") {
  851.                     printPdf.settings.pageRange = options.pages;
  852.                 } else {
  853.                     if (typeof iPageFrom !== "undefined" &&
  854.                         typeof iPageTo !== "undefined" &&
  855.                         iPageFrom !== -1 &&
  856.                         iPageTo !== -1) {
  857.                         printPdf.settings.pageRange = iPageFrom + "-" + iPageTo;
  858.                     } else {
  859.                         printPdf.settings.pageRange = "";
  860.                     }
  861.                 }
  863.                 if (typeof options.monochrome !== "undefined") {
  864.                     printPdf.settings.monochrome = options.monochrome
  865.                         ? printPdf.BooleanOption.TRUE
  866.                         : printPdf.BooleanOption.FALSE;
  867.                 } else
  868.                     printPdf.settings.monochrome = printPdf.BooleanOption.DEFAULT;
  870.                 if (typeof options.normalise !== "undefined" || typeof options.normalize !== "undefined") {
  871.                     printPdf.settings.normalise = options.normalise || options.normalize
  872.                         ? printPdf.BooleanOption.TRUE
  873.                         : printPdf.BooleanOption.FALSE;
  874.                 } else
  875.                     printPdf.settings.normalise = printPdf.BooleanOption.DEFAULT;
  877.                 if (typeof options.printMode !== "undefined") {
  878.                     printPdf.settings.printQuality = options.printMode;
  879.                 } else {
  880.                     if (typeof options.printQuality !== "undefined") {
  881.                         printPdf.settings.printQuality = options.printQuality;
  882.                     }
  883.                 }
  885.                 if (typeof options.jobname !== "undefined") {
  886.                     printPdf.settings.jobDescription = options.jobname;
  887.                 }
  889.                 if (typeof options.jobName !== "undefined") {
  890.                     printPdf.settings.jobDescription = options.jobName;
  891.                 }
  893.                 return printPdfContent(options.url, bPrompt, fnNotifyStarted);
  894.             }
  895.             MeadCo.error("MeadCo.ScriptX.Print.PDF is not available to ScriptX.Services factory emulation.");
  896.             fnNotifyStarted(false);
  897.             return false;
  898.         },
  900.         BatchPrintPDF: function (sUrl, fnNotifyStarted) {
  901.             this.BatchPrintPDFEx(sUrl, function () {
  903.             }, "BatchPrintPDF", fnNotifyStarted);
  904.         },
  906.         BatchPrintPDFEx: function (sUrl, fnCallback, data, fnNotifyStarted) {
  907.             if (typeof fnNotifyStarted === "undefined") {
  908.                 fnNotifyStarted = function (bStarted) { };
  909.             }
  911.             if (typeof printPdf !== "undefined") {
  912.                 printPdf.resetSettings();
  914.                 printPdf.settings.pageRange = iEnhancedFormatting.pageRange;
  915.                 printPdf.settings.pageScaling = settings.viewScale === -1
  916.                     ? printPdf.PdfPageScaling.SHRINKLARGEPAGES
  917.                     : printPdf.PdfPageScaling.UNDEFINED;
  918.                 printPdf.settings.orientation = this.portrait
  919.                     ? printPdf.PageOrientation.PORTRAIT
  920.                     : printPdf.PageOrientation.LANDSCAPE;
  921.                 printPdf.settings.printQuality = iEnhancedFormatting.pdfPrintMode;
  923.                 printPdfContent(sUrl, false, fnNotifyStarted, fnCallback, data);
  924.                 return;
  925.             }
  927.             MeadCo.error("MeadCo.ScriptX.Print.PDF is not available to ScriptX.Services factory emulation.");
  928.             fnNotifyStarted(false);
  929.         },
  931.         set units(enumUnits) {
  932.             this.SetMarginMeasure(enumUnits);
  933.         },
  935.         get units() {
  936.             return this.GetMarginMeasure();
  937.         },
  939.         set paperSize(sPaperSize) {
  940.             printApi.deviceSettings.paperSizeName = sPaperSize;
  941.         },
  943.         get paperSize() {
  944.             return printApi.deviceSettings.paperSizeName;
  945.         },
  947.         set paperSource(sPaperSource) {
  948.             printApi.deviceSettings.paperSourceName = sPaperSource;
  949.         },
  951.         get paperSource() {
  952.             return printApi.deviceSettings.paperSourceName;
  953.         },
  955.         set paperSource2(sPaperSource) {
  956.             printApi.deviceSettings.paperSourceName = sPaperSource;
  957.         },
  959.         get paperSource2() {
  960.             return printApi.deviceSettings.paperSourceName;
  961.         },
  963.         get pageWidth() {
  964.             return printApi.deviceSettings.paperPageSize.width;
  965.         },
  967.         get pageHeight() {
  968.             return printApi.deviceSettings.paperPageSize.height;
  969.         },
  971.         set copies(nCopies) {
  972.             printApi.deviceSettings.copies = nCopies;
  973.         },
  975.         get copies() {
  976.             return printApi.deviceSettings.copies;
  977.         },
  979.         set collate(bCollate) {
  980.             printApi.deviceSettings.collate = (bCollate === true || bCollate === 1) ? printApi.CollateOptions.TRUE : printApi.CollateOptions.FALSE;
  981.         },
  983.         get collate() {
  984.             return printApi.deviceSettings.collate === printApi.CollateOptions.TRUE;
  985.         },
  987.         set duplex(duplex) {
  988.             printApi.deviceSettings.duplex = duplex;
  989.         },
  991.         get duplex() {
  992.             return printApi.deviceSettings.duplex;
  993.         },
  995.         set duplex2(duplex) {
  996.             printApi.deviceSettings.duplex = duplex;
  997.         },
  999.         get duplex2() {
  1000.             return printApi.deviceSettings.duplex;
  1001.         },
  1003.         set onafterprint(fn) {
  1004.             printApi.reportFeatureNotImplemented("onafterprint", fn);
  1005.         },
  1006.         set onbeforeprint(fn) {
  1007.             printApi.reportFeatureNotImplemented("onbeforeprint", fn);
  1008.         },
  1010.         set onbeforeunload(sMsg) {
  1011.             unloadMsg = sMsg;
  1012.             window.addEventListener('beforeunload', async (e) => {
  1013.                 MeadCo.log("beforeunload handler running");
  1014.                 if (!MeadCo.ScriptX.Print.noJobsWaitingDelivery) {
  1015.                     MeadCo.log("jobs are waiting client side, will prompt user (custom text is not supported by modern browsers)");
  1016.                     e.returnValue = sMsg;
  1017.                     e.preventDefault();
  1018.                 }
  1019.                 else {
  1020.                     MeadCo.log("no jobs are waiting client side");
  1021.                 }
  1022.             });
  1023.         },
  1025.         get onbeforeunload() {
  1026.             return unloadMsg;
  1027.         },
  1029.         set onpagesetup(fn) {
  1030.             printApi.reportFeatureNotImplemented("onpagesetup", fn);
  1031.         },
  1033.         set onuserpagesetup(fn) {
  1034.             printApi.reportFeatureNotImplemented("onuserpagesetup", fn);
  1035.         },
  1037.         set onuserprint(fn) {
  1038.             printApi.reportFeatureNotImplemented("onuserprint", fn);
  1039.         },
  1041.         set onuserprintpreview(fn) {
  1042.             printApi.reportFeatureNotImplemented("onuserprintpreview", fn);
  1043.         },
  1045.         DefaultPrinter: function () {
  1046.             return printApi.deviceSettingsFor("systemdefault").printerName;
  1047.         },
  1049.         AddPrinterConnection: function (sShareName) {
  1050.             printApi.addPrinterConnection(sShareName);
  1051.         },
  1053.         RemovePrinterConnection: function (sShareName) {
  1054.             printApi.removePrinterConnection(sShareName);
  1055.         },
  1057.         AddPrinterConnectionAsync: function (sShareName, onSuccess) {
  1058.             printApi.addPrinterConnectionAsync(sShareName, onSuccess, function (errTxt) {
  1059.                 printApi.reportError(errTxt);
  1060.             });
  1061.         },
  1063.         RemovePrinterConnectionAsync: function (sShareName, onSuccess) {
  1064.             printApi.removePrinterConnectionAsync(sShareName, onSuccess, function (errTxt) {
  1065.                 printApi.reportError(errTxt);
  1066.             });
  1067.         },
  1069.         // duplicate to cope with COM objects were/are not case sensitive
  1070.         get CurrentPrinter() {
  1071.             return printApi.printerName;
  1072.         },
  1074.         set CurrentPrinter(sPrinterName) {
  1075.             this.currentPrinter = sPrinterName;
  1076.         },
  1078.         get currentPrinter() {
  1079.             return printApi.printerName;
  1080.         },
  1082.         set currentPrinter(sPrinterName) {
  1083.             if (typeof sPrinterName === "string") {
  1084.                 var a = printApi.onErrorAction;
  1086.                 printApi.onErrorAction = printApi.ErrorAction.THROW;
  1088.                 try {
  1089.                     printApi.printerName = sPrinterName;
  1090.                     printApi.onErrorAction = a;
  1091.                 } catch (e) {
  1092.                     printApi.onErrorAction = a;
  1093.                     throw e;
  1094.                 }
  1095.             }
  1096.         },
  1098.         get printer() {
  1099.             return printApi.printerName;
  1100.         },
  1102.         set printer(sPrinterName) {
  1103.             if (typeof sPrinterName === "string") {
  1105.                 var a = printApi.onErrorAction;
  1107.                 printApi.onErrorAction = printApi.ErrorAction.THROW;
  1109.                 // eat all and any errors. finally might be better but
  1110.                 // minifiers dont like empty blocks 
  1111.                 try {
  1112.                     printApi.printerName = sPrinterName;
  1113.                     printApi.onErrorAction = a;
  1114.                 }
  1115.                 catch (e) {
  1116.                     printApi.onErrorAction = a;
  1117.                 }
  1118.             }
  1119.         },
  1121.         set printToFileName(sFileName) {
  1122.             printApi.deviceSettings.printToFileName = sFileName;
  1123.         },
  1125.         get printBackground() {
  1126.             return settings.printBackgroundColorsAndImages;
  1127.         },
  1129.         set printBackground(bPrintBackground) {
  1130.             settings.printBackgroundColorsAndImages = bPrintBackground;
  1131.         },
  1133.         get viewScale() {
  1134.             return settings.viewScale;
  1135.         },
  1137.         set viewScale(x) {
  1138.             settings.viewScale = x;
  1139.         },
  1141.         set unprintableLeft(n) {
  1142.             printApi.deviceSettings.unprintableMargins.left = n;
  1143.         },
  1145.         get unprintableLeft() {
  1146.             return printApi.deviceSettings.unprintableMargins.left;
  1147.         },
  1149.         set unprintableRight(n) {
  1150.             printApi.deviceSettings.unprintableMargins.right = n;
  1151.         },
  1153.         get unprintableRight() {
  1154.             return printApi.deviceSettings.unprintableMargins.right;
  1155.         },
  1157.         set unprintableTop(n) {
  1158.             printApi.deviceSettings.unprintableMargins.top = n;
  1159.         },
  1161.         get unprintableTop() {
  1162.             return printApi.deviceSettings.unprintableMargins.top;
  1163.         },
  1165.         set unprintableBottom(n) {
  1166.             printApi.deviceSettings.unprintableMargins.bottom = n;
  1167.         },
  1169.         get unprintableBottom() {
  1170.             return printApi.deviceSettings.unprintableMargins.bottom;
  1171.         },
  1173.         EnumPrinters: function (index) {
  1174.             var arP = printApi.availablePrinterNames;
  1176.             if (!arP || arP.length === 0) {
  1177.                 if (index === 0) {
  1178.                     return this.CurrentPrinter;
  1179.                 }
  1180.             } else {
  1181.                 if (index < arP.length) {
  1182.                     return arP[index];
  1183.                 }
  1184.             }
  1186.             return "";
  1187.         },
  1189.         EnumJobs: function (sPrinterName, iIndex, jobNameOut) {
  1191.             var jobs = printApi.queue;
  1192.             var i;
  1193.             var plist = new Array();
  1195.             sPrinterName = sPrinterName.toLowerCase();
  1196.             for (i = 0; i < jobs.length; i++) {
  1197.                 if (jobs[i].printerName.toLowerCase() === sPrinterName) {
  1198.                     plist.push(jobs[i]);
  1199.                 }
  1200.             }
  1202.             if (iIndex < plist.length) {
  1203.                 jobNameOut.name = plist[iIndex].jobName;
  1204.                 return plist[iIndex].status;
  1205.             }
  1207.             return 0;
  1208.         },
  1210.         GetJobsCount: function (sPrinterName) {
  1211.             // return printApi.activeJobs;
  1212.             var jobs = printApi.queue;
  1213.             var i;
  1214.             var c = 0;
  1216.             sPrinterName = sPrinterName.toLowerCase();
  1217.             for (i = 0; i < jobs.length; i++) {
  1218.                 if (jobs[i].printerName.toLowerCase() === sPrinterName)
  1219.                     c++;
  1220.             }
  1222.             return c;
  1223.         },
  1225.         printerControl: function (printerName) {
  1226.             return {
  1227.                 get Forms() {
  1228.                     return printApi.deviceSettingsFor(printerName).forms;
  1229.                 },
  1231.                 get Bins() {
  1232.                     return printApi.deviceSettingsFor(printerName).bins;
  1233.                 },
  1235.                 get forms() {
  1236.                     return printApi.deviceSettingsFor(printerName).forms;
  1237.                 },
  1239.                 get bins() {
  1240.                     return printApi.deviceSettingsFor(printerName).bins;
  1241.                 },
  1243.                 get name() {
  1244.                     return printerName;
  1245.                 },
  1247.                 get status() {
  1248.                     return printApi.deviceSettingsFor(printerName).port;
  1249.                 },
  1251.                 get port() {
  1252.                     return printApi.deviceSettingsFor(printerName).port;
  1253.                 },
  1254.                 get attributes() {
  1255.                     return printApi.deviceSettingsFor(printerName).attributes;
  1256.                 },
  1257.                 get serverName() {
  1258.                     return printApi.deviceSettingsFor(printerName).serverName;
  1259.                 },
  1260.                 get shareName() {
  1261.                     return printApi.deviceSettingsFor(printerName).shareName;
  1262.                 },
  1263.                 get location() {
  1264.                     return printApi.deviceSettingsFor(printerName).location;
  1265.                 },
  1266.                 get isLocal() {
  1267.                     return printApi.deviceSettingsFor(printerName).isLocal;
  1268.                 },
  1269.                 get isNetwork() {
  1270.                     return printApi.deviceSettingsFor(printerName).isNetwork;
  1271.                 },
  1272.                 get isShared() {
  1273.                     return printApi.deviceSettingsFor(printerName).isShared;
  1274.                 },
  1276.                 get Jobs() {
  1277.                     printApi.reportFeatureNotImplemented("printerControl.Jobs");
  1278.                 },
  1279.                 Purge: function () {
  1280.                     printApi.reportFeatureNotImplemented("printerControl.Purge()");
  1281.                 },
  1282.                 Pause: function () {
  1283.                     printApi.reportFeatureNotImplemented("printerControl.Pause()");
  1284.                 },
  1285.                 Resume: function () {
  1286.                     printApi.reportFeatureNotImplemented("printerControl.Resume()");
  1287.                 }
  1288.             };
  1289.         },
  1291.         GetMarginMeasure: function () {
  1292.             return settings.page.units === printApi.MeasurementUnits.INCHES ? 2 : 1;
  1293.         },
  1295.         SetMarginMeasure: function (enumUnits) {
  1296.             settings.page.units = enumUnits === 2 ? printApi.MeasurementUnits.INCHES : printApi.MeasurementUnits.MM;
  1297.         },
  1299.         SetPrintScale: function (value) {
  1300.             settings.viewScale = value;
  1301.         },
  1303.         IsSpooling: function () {
  1304.             return printApi.isSpooling;
  1305.         },
  1307.         OwnQueue: function () {
  1308.             // NOTE: No-op, no concept of 'out of process' here
  1309.             return null;
  1310.         },
  1312.         SetPageRange: function (bSelectionOnly, iFrom, iTo) {
  1313.             if (bSelectionOnly) {
  1314.                 printApi.reportFeatureNotImplemented("SetPageRange selection only");
  1315.             }
  1317.             settings.pageRange = "" + iFrom + "-" + iTo;
  1318.         },
  1320.         SetPreviewZoom: function () {
  1321.             printApi.reportFeatureNotImplemented("SetPreviewZoom");
  1322.         },
  1324.         Sleep: function () {
  1325.             // If you need this, please implement your own for the browsers you are deploying to. 
  1326.             // Contact MeadCo for assistance if required.
  1327.             printApi.reportFeatureNotImplemented("Sleep");
  1328.         },
  1330.         TotalPrintPages: function () {
  1331.             printApi.reportFeatureNotImplemented("TotalPrintPages");
  1332.         },
  1334.         WaitForSpoolingComplete: function (iTimeout, fnComplete) {
  1335.             printApi.waitForSpoolingComplete(iTimeout, fnComplete);
  1336.         },
  1338.         enhancedFormatting: iEnhancedFormatting,
  1340.         // helpers for wrapper MeadCoJS
  1341.         PolyfillInit: function () {
  1342.             if (!MeadCo.ScriptX.Print.isConnected) {
  1343.                 printHtml.connect("", "", function (e) {
  1344.                     MeadCo.warn("Services server connection failed: " + e);
  1345.                 });
  1346.             }
  1347.             return MeadCo.ScriptX.Print.isConnected;
  1348.         },
  1350.         PolyfillInitAsync: function (resolve, reject) {
  1351.             if (MeadCo.ScriptX.Print.isConnected) {
  1352.                 resolve(2);
  1353.             } else {
  1354.                 printHtml.connectAsync("", "", resolve, reject);
  1355.             }
  1356.         },
  1358.         get PolyfillAuthorisationCookie() {
  1359.             return MeadCo.ScriptX.Print.authorisationCookie;
  1360.         },
  1362.         set PolyfillAuthorisationCookie(cookie) {
  1363.             MeadCo.ScriptX.Print.authorisationCookie = cookie;
  1364.         }
  1365.     };
  1367. });
  1369. ; (function (name, definition) {
  1370.     if (typeof factory.extendFactoryNamespace === "function") {
  1371.         factory.extendFactoryNamespace(name, definition);
  1372.     }
  1373. })('factory.object', function () {
  1375.     // protected API
  1376.     var outerScope = this;
  1378.     outerScope.factory.log("factory.object loaded.");
  1380.     /*
  1381.      * This completes the emulation of an &lt;object /&gt; element
  1382.      *
  1383.      * Compatibility with Add-on to allow inspection of  &lt;object /&gt; and this javascript
  1384.      * for the underlying object implementing 'factory'.
  1385.      * 
  1386.      * @property {object} factory
  1387.      * @memberof factoryobject
  1388.      */
  1389.     return outerScope.factory;
  1390. });
  1392. ; (function (name, definition) {
  1393.     if (typeof factory.extendFactoryNamespace === "function") {
  1394.         factory.extendFactoryNamespace(name, definition);
  1395.     }
  1396. })('factory.object.js', function () {
  1398.     // protected API
  1399.     var outerScope = this;
  1401.     outerScope.factory.log("factory.object.js loaded.");
  1403.     // public API
  1404.     return {
  1405.         /*
  1406.          * Convert object to number -- required for some code compatibility only. Do not use
  1407.          * 
  1408.          * @function FormatNumber
  1409.          * @memberof factoryjs
  1410.          * @param {any} arg object to convert
  1411.          * @returns {Number} arg as a number if it can be converted, else 0 
  1412.          */
  1413.         FormatNumber: function (arg) {
  1414.             if (isNaN(arg)) {
  1415.                 return 0;
  1416.             } else {
  1417.                 if (typeof arg === 'string') {
  1418.                     return Number(arg);
  1419.                 } else {
  1420.                     return arg;
  1421.                 }
  1422.             }
  1423.         }
  1424.     };
  1425. });