From bb2529de039009cb10e4308940f6453fb7f96df0 Mon Sep 17 00:00:00 2001
From: Brendan Dahl <brendan.dahl@gmail.com>
Date: Mon, 19 Aug 2013 16:33:20 -0700
Subject: [PATCH 1/2] Move the creation of canvas path fonts to the worker.

---
 examples/acroforms/index.html          |   1 -
 examples/helloworld/index.html         |   1 -
 make.js                                |   4 +-
 src/core/evaluator.js                  |  38 +++++++++--
 src/{display => core}/font_renderer.js |  83 ++++++++++++-------------
 src/core/fonts.js                      |   6 +-
 src/core/worker.js                     |   1 +
 src/display/api.js                     |  16 ++++-
 src/display/canvas.js                  |  18 +-----
 src/display/font_loader.js             |  16 +++--
 src/shared/util.js                     |  13 ++++
 src/worker_loader.js                   |   1 +
 test/pdfs/issue3584.pdf                | Bin 0 -> 21424 bytes
 test/test_manifest.json                |   7 +++
 test/test_slave.html                   |   1 -
 web/viewer.html                        |   1 -
 16 files changed, 131 insertions(+), 76 deletions(-)
 rename src/{display => core}/font_renderer.js (95%)
 create mode 100644 test/pdfs/issue3584.pdf

diff --git a/examples/acroforms/index.html b/examples/acroforms/index.html
index 4e484727b..91094f390 100644
--- a/examples/acroforms/index.html
+++ b/examples/acroforms/index.html
@@ -13,7 +13,6 @@
   <script type="text/javascript" src="../../src/display/metadata.js"></script>
   <script type="text/javascript" src="../../src/display/canvas.js"></script>
   <script type="text/javascript" src="../../src/display/font_loader.js"></script>
-  <script type="text/javascript" src="../../src/display/font_renderer.js"></script>
 
   <script type="text/javascript">
     // Specify the main script used to create a new PDF.JS web worker.
diff --git a/examples/helloworld/index.html b/examples/helloworld/index.html
index 6cb0ec266..9a70e7ae4 100644
--- a/examples/helloworld/index.html
+++ b/examples/helloworld/index.html
@@ -13,7 +13,6 @@
   <script type="text/javascript" src="../../src/display/metadata.js"></script>
   <script type="text/javascript" src="../../src/display/canvas.js"></script>
   <script type="text/javascript" src="../../src/display/font_loader.js"></script>
-  <script type="text/javascript" src="../../src/display/font_renderer.js"></script>
 
   <script type="text/javascript">
     // Specify the main script used to create a new PDF.JS web worker.
diff --git a/make.js b/make.js
index c39977b33..7b003b518 100644
--- a/make.js
+++ b/make.js
@@ -278,8 +278,7 @@ target.bundle = function(args) {
     'display/api.js',
     'display/metadata.js',
     'display/canvas.js',
-    'display/font_loader.js',
-    'display/font_renderer.js'
+    'display/font_loader.js'
   ];
 
   var WORKER_SRC_FILES = [
@@ -298,6 +297,7 @@ target.bundle = function(args) {
     'core/crypto.js',
     'core/evaluator.js',
     'core/fonts.js',
+    'core/font_renderer.js',
     'core/glyphlist.js',
     'core/image.js',
     'core/metrics.js',
diff --git a/src/core/evaluator.js b/src/core/evaluator.js
index f7bc9f46f..5956c540d 100644
--- a/src/core/evaluator.js
+++ b/src/core/evaluator.js
@@ -20,7 +20,7 @@
            isStream, isString, JpegStream, Lexer, Metrics, Name, Parser,
            Pattern, PDFImage, PDFJS, serifFonts, stdFontMap, symbolsFonts,
            TilingPattern, TODO, warn, Util, Promise,
-           RefSetCache, isRef */
+           RefSetCache, isRef, TextRenderingMode */
 
 'use strict';
 
@@ -349,6 +349,31 @@ var PartialEvaluator = (function PartialEvaluatorClosure() {
       return loadedName;
     },
 
+    handleText: function PartialEvaluator_handleText(chars) {
+      var font = this.state.font.translated;
+      var glyphs = font.charsToGlyphs(chars);
+      var isAddToPathSet = !!(this.state.textRenderingMode &
+                              TextRenderingMode.ADD_TO_PATH_FLAG);
+      if (isAddToPathSet || PDFJS.disableFontFace) {
+        for (var i = 0; i < glyphs.length; i++) {
+          if (glyphs[i] === null) {
+            continue;
+          }
+          var fontChar = glyphs[i].fontChar;
+          if (!font.renderer.hasBuiltPath(fontChar)) {
+            var path = font.renderer.getPathJs(fontChar);
+            this.handler.send('commonobj', [
+              font.loadedName + '_path_' + fontChar,
+              'FontPath',
+              path
+            ]);
+          }
+        }
+      }
+
+      return glyphs;
+    },
+
     setGState: function PartialEvaluator_setGState(resources, gState,
                                                    operatorList) {
 
@@ -631,19 +656,21 @@ var PartialEvaluator = (function PartialEvaluatorClosure() {
               this.state = prev;
             }
           } else if (cmd === 'Tj') { // showText
-            args[0] = this.state.font.translated.charsToGlyphs(args[0]);
+            args[0] = this.handleText(args[0]);
           } else if (cmd === 'TJ') { // showSpacedText
             var arr = args[0];
             var arrLength = arr.length;
             for (var i = 0; i < arrLength; ++i) {
               if (isString(arr[i])) {
-                arr[i] = this.state.font.translated.charsToGlyphs(arr[i]);
+                arr[i] = this.handleText(arr[i]);
               }
             }
           } else if (cmd === '\'') { // nextLineShowText
-            args[0] = this.state.font.translated.charsToGlyphs(args[0]);
+            args[0] = this.handleText(args[0]);
           } else if (cmd === '"') { // nextLineSetSpacingShowText
-            args[2] = this.state.font.translated.charsToGlyphs(args[2]);
+            args[2] = this.handleText(args[2]);
+          } else if (cmd === 'Tr') { // setTextRenderingMode
+            this.state.textRenderingMode = args[0];
           }
 
           switch (fn) {
@@ -1529,6 +1556,7 @@ var OperatorList = (function OperatorListClosure() {
 var EvalState = (function EvalStateClosure() {
   function EvalState() {
     this.font = null;
+    this.textRenderingMode = TextRenderingMode.FILL;
   }
   EvalState.prototype = {
     clone: function CanvasExtraState_clone() {
diff --git a/src/display/font_renderer.js b/src/core/font_renderer.js
similarity index 95%
rename from src/display/font_renderer.js
rename to src/core/font_renderer.js
index 7875c7ab7..6de6d5d99 100644
--- a/src/display/font_renderer.js
+++ b/src/core/font_renderer.js
@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/* globals error, Stream, GlyphsUnicode, CFFParser, Encodings */
+/* globals error, Stream, GlyphsUnicode, CFFParser, Encodings, Util */
 
 'use strict';
 
@@ -585,18 +585,14 @@ var FontRendererFactory = (function FontRendererFactoryClosure() {
     parse(code);
   }
 
-  function TrueTypeCompiled(glyphs, cmap, fontMatrix) {
-    this.glyphs = glyphs;
-    this.cmap = cmap;
-    this.fontMatrix = fontMatrix || [0.000488, 0, 0, 0.000488, 0, 0];
+  var noop = '';
 
-    this.compiledGlyphs = [];
+  function CompiledFont(fontMatrix) {
+    this.compiledGlyphs = {};
+    this.fontMatrix = fontMatrix;
   }
-
-  var noop = function () {};
-
-  TrueTypeCompiled.prototype = {
-    getPathGenerator: function (unicode) {
+  CompiledFont.prototype = {
+    getPathJs: function (unicode) {
       var gid = lookupCmap(this.cmap, unicode);
       var fn = this.compiledGlyphs[gid];
       if (!fn) {
@@ -604,6 +600,7 @@ var FontRendererFactory = (function FontRendererFactoryClosure() {
       }
       return fn;
     },
+
     compileGlyph: function (code) {
       if (!code || code.length === 0 || code[0] === 14) {
         return noop;
@@ -614,23 +611,47 @@ var FontRendererFactory = (function FontRendererFactoryClosure() {
       js.push('c.transform(' + this.fontMatrix.join(',') + ');');
       js.push('c.scale(size, -size);');
 
-      var stack = [], x = 0, y = 0;
-      compileGlyf(code, js, this);
+      this.compileGlyphImpl(code, js);
 
       js.push('c.restore();');
 
-      /*jshint -W054 */
-      return new Function('c', 'size', js.join('\n'));
+      return js.join('\n');
+    },
+
+    compileGlyphImpl: function () {
+      error('Children classes should implement this.');
+    },
+
+    hasBuiltPath: function (unicode) {
+      var gid = lookupCmap(this.cmap, unicode);
+      return gid in this.compiledGlyphs;
     }
   };
 
+  function TrueTypeCompiled(glyphs, cmap, fontMatrix) {
+    fontMatrix = fontMatrix || [0.000488, 0, 0, 0.000488, 0, 0];
+    CompiledFont.call(this, fontMatrix);
+
+    this.glyphs = glyphs;
+    this.cmap = cmap;
+
+    this.compiledGlyphs = [];
+  }
+
+  Util.inherit(TrueTypeCompiled, CompiledFont, {
+    compileGlyphImpl: function (code, js) {
+      compileGlyf(code, js, this);
+    }
+  });
+
   function Type2Compiled(cffInfo, cmap, fontMatrix, glyphNameMap) {
+    fontMatrix = fontMatrix || [0.001, 0, 0, 0.001, 0, 0];
+    CompiledFont.call(this, fontMatrix);
     this.glyphs = cffInfo.glyphs;
     this.gsubrs = cffInfo.gsubrs || [];
     this.subrs = cffInfo.subrs || [];
     this.cmap = cmap;
     this.glyphNameMap = glyphNameMap || GlyphsUnicode;
-    this.fontMatrix = fontMatrix || [0.001, 0, 0, 0.001, 0, 0];
 
     this.compiledGlyphs = [];
     this.gsubrsBias = this.gsubrs.length < 1240 ? 107 :
@@ -639,34 +660,12 @@ var FontRendererFactory = (function FontRendererFactoryClosure() {
                      this.subrs.length < 33900 ? 1131 : 32768;
   }
 
-  Type2Compiled.prototype = {
-    getPathGenerator: function (unicode) {
-      var gid = lookupCmap(this.cmap, unicode);
-      var fn = this.compiledGlyphs[gid];
-      if (!fn) {
-        this.compiledGlyphs[gid] = fn = this.compileGlyph(this.glyphs[gid]);
-      }
-      return fn;
-    },
-    compileGlyph: function (code) {
-      if (!code || code.length === 0 || code[0] === 14) {
-        return noop;
-      }
-
-      var js = [];
-      js.push('c.save();');
-      js.push('c.transform(' + this.fontMatrix.join(',') + ');');
-      js.push('c.scale(size, -size);');
-
-      var stack = [], x = 0, y = 0;
+  Util.inherit(Type2Compiled, CompiledFont, {
+    compileGlyphImpl: function (code, js) {
       compileCharString(code, js, this);
-
-      js.push('c.restore();');
-
-      /*jshint -W054 */
-      return new Function('c', 'size', js.join('\n'));
     }
-  };
+  });
+
 
   return {
     create: function FontRendererFactory_create(font) {
diff --git a/src/core/fonts.js b/src/core/fonts.js
index b621e55b2..5092aa022 100644
--- a/src/core/fonts.js
+++ b/src/core/fonts.js
@@ -18,7 +18,7 @@
            ExpertSubsetCharset, FileReaderSync, GlyphsUnicode,
            info, isArray, isNum, ISOAdobeCharset, Stream,
            stringToBytes, TextDecoder, TODO, warn, Lexer, Util,
-           FONT_IDENTITY_MATRIX */
+           FONT_IDENTITY_MATRIX, FontRendererFactory, shadow */
 
 'use strict';
 
@@ -2791,6 +2791,10 @@ var Font = (function FontClosure() {
     font: null,
     mimetype: null,
     encoding: null,
+    get renderer() {
+      var renderer = FontRendererFactory.create(this);
+      return shadow(this, 'renderer', renderer);
+    },
 
     exportData: function Font_exportData() {
       var data = {};
diff --git a/src/core/worker.js b/src/core/worker.js
index 3d78ae16c..8c18f347b 100644
--- a/src/core/worker.js
+++ b/src/core/worker.js
@@ -224,6 +224,7 @@ var WorkerMessageHandler = PDFJS.WorkerMessageHandler = {
 
       PDFJS.maxImageSize = data.maxImageSize === undefined ?
                            -1 : data.maxImageSize;
+      PDFJS.disableFontFace = data.disableFontFace;
 
       getPdfManager(data).then(function pdfManagerReady() {
         loadDocument(false).then(onSuccess, function loadFailure(ex) {
diff --git a/src/display/api.js b/src/display/api.js
index 7949d9fba..974aebb83 100644
--- a/src/display/api.js
+++ b/src/display/api.js
@@ -29,6 +29,16 @@
  */
 PDFJS.maxImageSize = PDFJS.maxImageSize === undefined ? -1 : PDFJS.maxImageSize;
 
+/**
+ * By default fonts are converted to OpenType fonts and loaded via font face
+ * rules. If disabled, the font will be rendered using a built in font renderer
+ * that constructs the glyphs with primitive path commands.
+ * @var {Boolean}
+ */
+PDFJS.disableFontFace = PDFJS.disableFontFace === undefined ?
+                        false :
+                        PDFJS.disableFontFace;
+
 /**
  * This is the main entry point for loading a PDF and interacting with it.
  * NOTE: If a URL is used to fetch the PDF data a standard XMLHttpRequest(XHR)
@@ -673,6 +683,9 @@ var WorkerTransport = (function WorkerTransportClosure() {
               }.bind(this)
             );
             break;
+          case 'FontPath':
+            this.commonObjs.resolve(id, data[2]);
+            break;
           default:
             error('Got unknown common object type ' + type);
         }
@@ -770,7 +783,8 @@ var WorkerTransport = (function WorkerTransportClosure() {
       this.messageHandler.send('GetDocRequest', {
         source: source,
         disableRange: PDFJS.disableRange,
-        maxImageSize: PDFJS.maxImageSize
+        maxImageSize: PDFJS.maxImageSize,
+        disableFontFace: PDFJS.disableFontFace
       });
     },
 
diff --git a/src/display/canvas.js b/src/display/canvas.js
index 2e2b6b0dd..1f8f6c000 100644
--- a/src/display/canvas.js
+++ b/src/display/canvas.js
@@ -16,26 +16,14 @@
  */
 /* globals ColorSpace, DeviceCmykCS, DeviceGrayCS, DeviceRgbCS, error,
            FONT_IDENTITY_MATRIX, IDENTITY_MATRIX, ImageData, isArray, isNum,
-           Pattern, TilingPattern, TODO, Util, warn, assert, info */
+           Pattern, TilingPattern, TODO, Util, warn, assert, info,
+           TextRenderingMode */
 
 'use strict';
 
 // <canvas> contexts store most of the state we need natively.
 // However, PDF needs a bit more state, which we store here.
 
-var TextRenderingMode = {
-  FILL: 0,
-  STROKE: 1,
-  FILL_STROKE: 2,
-  INVISIBLE: 3,
-  FILL_ADD_TO_PATH: 4,
-  STROKE_ADD_TO_PATH: 5,
-  FILL_STROKE_ADD_TO_PATH: 6,
-  ADD_TO_PATH: 7,
-  FILL_STROKE_MASK: 3,
-  ADD_TO_PATH_FLAG: 4
-};
-
 // Minimal font size that would be used during canvas fillText operations.
 var MIN_FONT_SIZE = 16;
 
@@ -1007,7 +995,7 @@ var CanvasGraphics = (function CanvasGraphicsClosure() {
 
       var addToPath;
       if (font.disableFontFace || isAddToPathSet) {
-        addToPath = font.renderer.getPathGenerator(character);
+        addToPath = font.getPathGenerator(this.commonObjs, character);
       }
 
       if (font.disableFontFace) {
diff --git a/src/display/font_loader.js b/src/display/font_loader.js
index 31d983165..17d86782a 100644
--- a/src/display/font_loader.js
+++ b/src/display/font_loader.js
@@ -14,8 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/* globals PDFJS, shadow, isWorker, assert, warn, FontRendererFactory,
-           bytesToString, globalScope */
+/* globals PDFJS, shadow, isWorker, assert, warn, bytesToString, globalScope */
 
 'use strict';
 
@@ -267,6 +266,7 @@ var FontLoader = {
 
 var FontFace = (function FontFaceClosure() {
   function FontFace(name, file, properties) {
+    this.compiledGlyphs = {};
     if (arguments.length === 1) {
       // importing translated data
       var data = arguments[0];
@@ -277,10 +277,6 @@ var FontFace = (function FontFaceClosure() {
     }
   }
   FontFace.prototype = {
-    get renderer() {
-      var renderer = FontRendererFactory.create(this);
-      return shadow(this, 'renderer', renderer);
-    },
     bindDOM: function FontFace_bindDOM() {
       if (!this.data)
         return null;
@@ -305,6 +301,14 @@ var FontFace = (function FontFaceClosure() {
         globalScope['FontInspector'].fontAdded(this, url);
 
       return rule;
+    },
+    getPathGenerator: function (objs, character) {
+      if (!(character in this.compiledGlyphs)) {
+        var js = objs.get(this.loadedName + '_path_' + character);
+        /*jshint -W054 */
+        this.compiledGlyphs[character] = new Function('c', 'size', js);
+      }
+      return this.compiledGlyphs[character];
     }
   };
   return FontFace;
diff --git a/src/shared/util.js b/src/shared/util.js
index f94491d88..ad1694167 100644
--- a/src/shared/util.js
+++ b/src/shared/util.js
@@ -27,6 +27,19 @@ var verbosity = WARNINGS;
 
 var FONT_IDENTITY_MATRIX = [0.001, 0, 0, 0.001, 0, 0];
 
+var TextRenderingMode = {
+  FILL: 0,
+  STROKE: 1,
+  FILL_STROKE: 2,
+  INVISIBLE: 3,
+  FILL_ADD_TO_PATH: 4,
+  STROKE_ADD_TO_PATH: 5,
+  FILL_STROKE_ADD_TO_PATH: 6,
+  ADD_TO_PATH: 7,
+  FILL_STROKE_MASK: 3,
+  ADD_TO_PATH_FLAG: 4
+};
+
 // The global PDFJS object exposes the API
 // In production, it will be declared outside a global wrapper
 // In development, it will be declared here
diff --git a/src/worker_loader.js b/src/worker_loader.js
index e8b249318..e59299e2b 100644
--- a/src/worker_loader.js
+++ b/src/worker_loader.js
@@ -35,6 +35,7 @@ var files = [
   'core/crypto.js',
   'core/evaluator.js',
   'core/fonts.js',
+  'core/font_renderer.js',
   'core/glyphlist.js',
   'core/image.js',
   'core/metrics.js',
diff --git a/test/pdfs/issue3584.pdf b/test/pdfs/issue3584.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..144f1a5548ab455b9f460065716f3706a7f9bacf
GIT binary patch
literal 21424
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

literal 0
HcmV?d00001

diff --git a/test/test_manifest.json b/test/test_manifest.json
index 18b5f3024..46c048fd2 100644
--- a/test/test_manifest.json
+++ b/test/test_manifest.json
@@ -1063,6 +1063,13 @@
       "link": true,
       "type": "eq"
     },
+    {  "id": "issue3584",
+      "file": "pdfs/issue3584.pdf",
+      "md5": "7a00646865a840eefc76f05c588b60ce",
+      "rounds": 1,
+      "type": "eq",
+      "about": "CFF font that is drawn with clipping."
+    },
     {  "id": "annotation-tx",
       "file": "pdfs/annotation-tx.pdf",
       "md5": "56321ea830be9c4f8437ca17ac535b2d",
diff --git a/test/test_slave.html b/test/test_slave.html
index 1c6164c8c..a4864dbf9 100644
--- a/test/test_slave.html
+++ b/test/test_slave.html
@@ -28,7 +28,6 @@ limitations under the License.
     <script type="text/javascript" src="/src/display/metadata.js"></script>
     <script type="text/javascript" src="/src/display/canvas.js"></script>
     <script type="text/javascript" src="/src/display/font_loader.js"></script>
-    <script type="text/javascript" src="/src/display/font_renderer.js"></script>
     <script type="text/javascript" src="driver.js"></script>
 
     <script type="text/javascript">
diff --git a/web/viewer.html b/web/viewer.html
index f0c064672..e785fa562 100644
--- a/web/viewer.html
+++ b/web/viewer.html
@@ -50,7 +50,6 @@ limitations under the License.
     <script type="text/javascript" src="../src/display/metadata.js"></script>
     <script type="text/javascript" src="../src/display/canvas.js"></script>
     <script type="text/javascript" src="../src/display/font_loader.js"></script>
-    <script type="text/javascript" src="../src/display/font_renderer.js"></script>
     <script type="text/javascript">PDFJS.workerSrc = '../src/worker_loader.js';</script>
 <!--#endif-->
 

From 60586e31016a2e8d694d47e5bcbbb80e0c1c1943 Mon Sep 17 00:00:00 2001
From: Brendan Dahl <brendan.dahl@gmail.com>
Date: Thu, 22 Aug 2013 12:55:43 -0700
Subject: [PATCH 2/2] Ensure there's data to build path.

---
 src/core/evaluator.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/core/evaluator.js b/src/core/evaluator.js
index 5956c540d..c099fe9d4 100644
--- a/src/core/evaluator.js
+++ b/src/core/evaluator.js
@@ -354,7 +354,7 @@ var PartialEvaluator = (function PartialEvaluatorClosure() {
       var glyphs = font.charsToGlyphs(chars);
       var isAddToPathSet = !!(this.state.textRenderingMode &
                               TextRenderingMode.ADD_TO_PATH_FLAG);
-      if (isAddToPathSet || PDFJS.disableFontFace) {
+      if (font.data && (isAddToPathSet || PDFJS.disableFontFace)) {
         for (var i = 0; i < glyphs.length; i++) {
           if (glyphs[i] === null) {
             continue;