@sharingbox/fabric
v2.2.31
Published
Ressources communes (npm) : fabric
Downloads
11
Readme
@sharingbox/fabric
npm install @sharingbox/fabric@latest --save
Usage
@sharingbox/fabric
est une extension de fabric
.
Pour l'utiliser, nous devons y importer fabric
, puis retourner son instance après qu'elle ait été extended.
import {fabric} from 'fabric'; // [email protected]
import {Fabric} from '@sharingbox/fabric';
const extended = new Fabric(fabric).extend();
export default extended;
Nous pourrons ensuite utiliser fabric
de manière standard en important l'objet extended comme suit :
import fabric from './extend.js';
Développement
Installation
Télécharger le projet @sharingbox/fabric
depuis bitbucket
puis installer les dépendances (pré-requis : nodejs
, npm
).
git clone [email protected]:sharingbox/fabric.git
npm install
Modifier les filtres
Un filtre est une suite d'actions.
Il est possible d'ajouter un filtre (name, test, actions) dans le fichier src/filters/config.ts
. Il est également possible de créer une configuration custom depuis l'event-space
.
arianablack: {
name : 'arianablack',
test : false,
actions: [
{name: 'multiply', parameters: {imageData2: 'arianablack.png'}},
{name: 'colorscheme2', parameters: {value1: 100}},
{name: 'saturation', parameters: {value1: 20}}
]
}
Les actions peuvent également être modifiées.
Chaque action correspond à un fichier dans src/filters/extend/
. Dans chaque fichier, le shader webGL
peut être modifié dans fragmentSource
.
Attention :
le code
webGL
etJavaScript
doivent correspondre.Aussi, il faut toujours veiller à ce que les traitements appliqués sur l'image dans le shader
webGL
correspondent aux traitementsJavaScript
(dansapplyTo2d
). Les traitementswebGL
sont utilisés sous Windows.JavaScript
sont utilisés sous iPhone et iPad (qui ne peuvent pas générer autant de contexteswebGL
que nécessaire).Erreur générée sous iPhone et iPad
There are too many active WebGL contexts on this page, the oldest context will be lost. TypeError Argument 1 ('shader') to WebGLRenderingContext.shaderSource must be an instance of WebGLShader shaderSource@[native code]
Test
Pour tester les filtres (et les actions qui le composent), il est nécessaire de lancer la page de test test/index.test.html
dans un serveur (sous vscode, clic droit : open with Live Server si l'extension LiveServer est installée).
- https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer
Si des modifications ont été appliquées, lancer la ligne de commande suivante :
npm run webpack:development
Deploy
Incrémenter le numéro de version du fichier package.json
.
npm run webpack:production
npm publish
Notes
WebGl
- https://webglfundamentals.org/webgl/lessons/fr/webgl-how-it-works.html
- https://webglfundamentals.org/webgl/lessons/fr/webgl-shaders-and-glsl.html
WebAssembly
Une fois le projet téléchargé, depuis la racine (au niveau de package.json), télécharger et installer
EMscripten
(qui permettra de compiler le codeC/C++
enWebAssembly
) si nécessaire :
- https://developer.mozilla.org/fr/docs/WebAssembly/C_to_wasm
- https://emscripten.org/docs/getting_started/downloads.html
- https://emscripten.org/docs/tools_reference/emcc.html
git clone https://github.com/emscripten-core/emsdk.git # Enter that directory cd emsdk # Fetch the latest version of the emsdk (not needed the first time you clone) git pull # Download and install the latest SDK tools. ./emsdk install latest # Make the "latest" SDK "active" for the current user. (writes .emscripten file) ./emsdk activate latest # Activate PATH and other environment variables in the current terminal source ./emsdk_env.sh
On Windows, run emsdk instead of ./emsdk, and emsdk_env.bat instead of source ./emsdk_env.sh.
Build
Si une première installation adéjà été effectuée, au prochain lancement, simplement activer
emsdk
avant de lancer à nouveau les lignes de commandes par fichier.emsdk activate latest
emcc -o ../src/filters/extend/webassembly_.js ../src/filters/extend/webassembly_.c -s EXPORTED_RUNTIME_METHODS=ccall,cwrap -s EXPORTED_FUNCTIONS=_malloc,_free -s EXPORT_ES6=1 -s MODULARIZE=1 -s USE_ES6_IMPORT_META=0 -s ALLOW_MEMORY_GROWTH=1 -s TOTAL_MEMORY=512mb