tree: d5016039a753f2deb6a31ae386e1f233e0dfff7b [path history] [tgz]
  1. CODE_OF_CONDUCT.md
  2. CONTRIBUTING.md
  3. example.html
  4. LICENSE
  5. package.json
  6. README.md
third_party/skia/modules/pathkit/npm-asmjs/README.md

An asm.js version of Skia's PathOps toolkit.

To use the library, run npm install pathkit-asmjs and then simply include it:

<script src="/node_modules/pathkit-asmjs/bin/pathkit.js"></script>
PathKitInit({
    locateFile: (file) => '/node_modules/pathkit-asmjs/bin/'+file,
}).ready().then((PathKit) => {
    // Code goes here using PathKit
});

PathKit comes in two parts, a JS loader and the actual WASM code. The JS loader creates a global PathKitInit that can be called to load the WASM code. The locateFile function is used to tell the JS loader where to find the .js.mem file. By default, it will look for /pathkit.js.mem, so if this is not the case, use locateFile to configure this properly. The PathKit object returned upon resolution of the .ready() Promise is fully loaded and ready to use.

See the API page and example.html for details on how to use the library.

Using PathKit and WebPack

WebPack‘s support for asm.js should be straight-forward, since it’s just another JS library. PathKit can be used with just a few configuration changes.

In the JS code, use require():

const PathKitInit = require('pathkit-asmjs/bin/pathkit.js')
PathKitInit().ready().then((PathKit) => {
    // Code goes here using PathKit
})

Since WebPack does not expose the entire /node_modules/ directory, but instead packages only the needed pieces, we have to copy pathkit.mem into the build directory. One such solution is to use CopyWebpackPlugin. For example, add the following plugin:

config.plugins.push(
    new CopyWebpackPlugin([
        { from: 'node_modules/pathkit-asmjs/bin/pathkit.js.mem' }
    ])
);

If webpack gives an error similar to:

ERROR in ./node_modules/pathkit-asmjs/bin/pathkit.js
Module not found: Error: Can't resolve 'fs' in '...'

Then, add the following configuration change to the node section of the config:

config.node = {
    fs: 'empty'
};