{"_id":"@artdotstyle/filepix","_rev":"1-976b99b8b89c25f4a9819a190de96048","name":"@artdotstyle/filepix","description":"powerful image convertor package this package you can convert the file into a different format","dist-tags":{"latest":"1.0.11"},"versions":{"1.0.10":{"name":"@artdotstyle/filepix","version":"1.0.10","keywords":["pdf","pdf convertor","pdf maker","img","image","png","convert","docx","extractText","jpeg","jpg","gif","image to gif","add effect","watermark","compress image"],"author":{"name":"pariazar"},"license":"MIT","_id":"@artdotstyle/filepix@1.0.10","maintainers":[{"name":"ciprianigna","email":"ciprian.igna@cloudtechnologies.ro"}],"contributors":[{"url":"https://github.com/pariazar","name":"pariazar","email":"hamedpa19@gmail.com"}],"homepage":"https://github.com/pariazar/filepix","bugs":{"url":"https://github.com/pariazar/filepix/issues/new"},"dist":{"shasum":"7e96a073bf70bcf8fb3c7ce747a455b0e5866ff3","tarball":"https://registry.npmjs.org/@artdotstyle/filepix/-/filepix-1.0.10.tgz","fileCount":18,"integrity":"sha512-ER8b2gYdGUDuymf9gHYjL6fbaJTQKWK8sd1LUuqK778ySvi2dOp8OSD8xk1bb+1y6Q5RAbYALfoPwFyHQ8/dhA==","signatures":[{"sig":"MEUCIQC9kNjcaYDMS9tkt1QA1J713gpk+q51zfQgOG88Pr23sAIgHzm5jzo7euYlRBcJyfc78rhCRgTrvGvSV5vEMbPfOVE=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":114062},"main":"index.js","engines":{"node":">4.0"},"gitHead":"b948646f29cfcd6405f884bbea1c2a3660c7b97c","scripts":{"test":"mocha test.js"},"_npmUser":{"name":"ciprianigna","email":"ciprian.igna@cloudtechnologies.ro"},"repository":{"url":"git+https://github.com/pariazar/filepix.git","type":"git"},"_npmVersion":"10.2.4","description":"powerful image convertor package this package you can convert the file into a different format","directories":{},"_nodeVersion":"20.11.0","dependencies":{"docx":"^8.5.0","jimp":"^0.22.12","canvas":"^2.11.2","images":"^3.2.4","is-url":"^1.2.4","pdfkit":"^0.15.0","png-js":"^1.0.0","rimraf":"^5.0.7","jpeg-js":"^0.4.4","pdfjs-dist":"^4.3.136","imagemagick":"^0.1.3","@jimp/plugins":"^0.22.12","compress-image":"^0.0.1","jimp-watermark":"^1.1.0","image-watermark":"^0.0.7","node-tesseract-ocr":"^2.2.1"},"_hasShrinkwrap":false,"devDependencies":{"chai":"5.1.1","mocha":"^10.4.0","request":"^2.88.2"},"_npmOperationalInternal":{"tmp":"tmp/filepix_1.0.10_1717852559906_0.28432582882241664","host":"s3://npm-registry-packages"}},"1.0.11":{"name":"@artdotstyle/filepix","version":"1.0.11","description":"powerful image convertor package this package you can convert the file into a different format","main":"index.js","scripts":{"test":"mocha test.js"},"author":{"name":"pariazar"},"engines":{"node":">4.0"},"license":"MIT","homepage":"https://github.com/pariazar/filepix","contributors":[{"name":"pariazar","email":"hamedpa19@gmail.com","url":"https://github.com/pariazar"}],"bugs":{"url":"https://github.com/pariazar/filepix/issues/new"},"repository":{"type":"git","url":"git+https://github.com/pariazar/filepix.git"},"devDependencies":{"chai":"5.1.1","mocha":"^10.4.0","request":"^2.88.2"},"dependencies":{"@jimp/plugins":"^0.22.12","canvas":"^2.11.2","compress-image":"^0.0.1","docx":"^8.5.0","image-watermark":"^0.0.7","imagemagick":"^0.1.3","images":"^3.2.4","is-url":"^1.2.4","jimp":"^0.22.12","jimp-watermark":"^1.1.0","jpeg-js":"^0.4.4","node-tesseract-ocr":"^2.2.1","pdfjs-dist":"^4.3.136","pdfkit":"^0.15.0","png-js":"^1.0.0","rimraf":"^5.0.7"},"keywords":["pdf","pdf convertor","pdf maker","img","image","png","convert","docx","extractText","jpeg","jpg","gif","image to gif","add effect","watermark","compress image"],"_id":"@artdotstyle/filepix@1.0.11","gitHead":"61412258977d41f2edcf5f8b1983addced96a48f","_nodeVersion":"20.11.0","_npmVersion":"10.2.4","dist":{"integrity":"sha512-CYAifICohqKh3er1YFtD44bCprNDopQn3eV8Q02nOkJmZhvbwGKmmNUu2hc6kYzBFcoTO7H57v4R/AQBAV/iAQ==","shasum":"fe371b52cb8182baeb31a5a087ae205362ee19f0","tarball":"https://registry.npmjs.org/@artdotstyle/filepix/-/filepix-1.0.11.tgz","fileCount":18,"unpackedSize":114085,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCO4VU+qmBtqnbDOdtjz474VRN1Zu+nawRkk1IFW6rRVwIgVTazZsKN7hqYPpcPTM0/aoeETveWgcXaXky8DMJMUvI="}]},"_npmUser":{"name":"ciprianigna","email":"ciprian.igna@cloudtechnologies.ro"},"directories":{},"maintainers":[{"name":"ciprianigna","email":"ciprian.igna@cloudtechnologies.ro"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/filepix_1.0.11_1717852713777_0.6993537266824543"},"_hasShrinkwrap":false}},"time":{"created":"2024-06-08T13:15:59.815Z","modified":"2024-06-08T13:18:34.154Z","1.0.10":"2024-06-08T13:16:00.061Z","1.0.11":"2024-06-08T13:18:33.964Z"},"maintainers":[{"name":"ciprianigna","email":"ciprian.igna@cloudtechnologies.ro"}],"author":{"name":"pariazar"},"repository":{"type":"git","url":"git+https://github.com/pariazar/filepix.git"},"keywords":["pdf","pdf convertor","pdf maker","img","image","png","convert","docx","extractText","jpeg","jpg","gif","image to gif","add effect","watermark","compress image"],"license":"MIT","homepage":"https://github.com/pariazar/filepix","bugs":{"url":"https://github.com/pariazar/filepix/issues/new"},"readme":"# FilePix\r\n[![npm](https://img.shields.io/npm/v/filepix.svg?style=flat-square)](https://www.npmjs.com/package/filepix)\r\n![building workflow](https://github.com/hamedpa/filepix/actions/workflows/nodejs.yml/badge.svg)\r\n<center> <img src=\"./img/cover.png\" /></center>\r\n\r\n<p class=\"lead\">powerful image converter package, it can convert images into a different formats, it includes below features:</p>\r\n\r\n* [convert pdf to word document](#convert-pdf-to-word-document)\r\n* [convert images into a single pdf file](#convert-images-to-pdf)\r\n* [convert pdf to multiple image file](#convert-pdf-to-images)\r\n* [convert png to jpg](#convert-png-to-jpg)\r\n* [convert base64 to jpg or png](#base64-to-jpg-or-png)\r\n* [compress image files](#convert-png-to-jpg)\r\n* [add watermarks or extra effects to your image files](#add-effects)\r\n\r\n<hr>\r\n\r\n## Installation\r\nInstall via NPM:\r\n\r\n```bash\r\nnpm install filepix\r\n```\r\n<p class=\"lead\">Then you can <strong>require</strong> or <strong>import</strong> as usual:</p>\r\n\r\n```javascript\r\nconst filepix = require(\"filepix\");\r\n```\r\n```typescript\r\nimport * as filepix from \"filepix\";\r\n```\r\n<hr>\r\n\r\n## Convert images to PDF\r\n\r\nthis feature let you convert your images into a single pdf file\r\n<h3>Basic Usage</h3>\r\n<p class=\"lead mb-5\">if you want to convert all images inside a specific directory you can use below code:\r\n</p>\r\n<p class=\"lead mb-10\"><code>pages</code>: images directory path</br>\r\n  <code>source</code>: output for saving final PDF file\r\n</p>\r\n\r\n\r\n\r\n```javascript\r\nfilepix.img2PDF(pages = './inputImagesDir', output = \"./outputImageDir/output.pdf\");\r\n```\r\nor maybe your images file in different path for this case you can use below code:\r\n\r\n```javascript\r\nfilepix.img2PDF(\r\n  pages = [\r\n        './1.jpg',\r\n        './public/upload/2.jpg',\r\n        './public/upload/example/3.jpg'\r\n  ],\r\n  output = \"./outputImageDir/output.pdf\");\r\n```\r\n\r\n### Add effects\r\n\r\n<p class=\"lead mb-5\">add easily a lot of effect to your images while converting to pdf\r\n</p>\r\nadd effect to your final pdf by set some options.\r\n\r\n#### Color\r\nApply multiple color modification rules\r\n\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                  name: 'color',\r\n                  config: [{ apply: 'green', params: [100] }]\r\n              }\r\n            ]\r\n  };\r\nfilepix.img2PDF(pages = './inputImagesDir', output = \"./outputImageDir/output.pdf\", options);\r\n```\r\n\r\n#### Flip\r\nFlip the image horizontally or vertically. Defaults to horizontal.\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                  name: 'mirror'\r\n              }\r\n            ]\r\n  };\r\n\r\n```\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'flip',\r\n                config: {\r\n                    vertical: true\r\n                }\r\n              }\r\n            ]\r\n  };\r\nfilepix.img2PDF(pages = './inputImagesDir', output = \"./outputImageDir/output.pdf\", options);\r\n```\r\n#### Blur\r\nA fast blur algorithm that produces similar effect to a Gaussian blur\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'blur',\r\n                config: {\r\n                    pixels: 50\r\n                }\r\n              }\r\n            ]\r\n  };\r\n```\r\n#### Rotate\r\nRotates the image clockwise by a number of degrees. By default the width and height of the image will be resized appropriately.\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'rotate',\r\n                config: {\r\n                    ratio: 45\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Brightness\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'brightness',\r\n                config: {\r\n                    ratio: 0.1\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Contrast\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'contrast',\r\n                config: {\r\n                    ratio: 0.2\r\n                }\r\n              }\r\n            ]\r\n  };\r\n```\r\n#### Gaussian\r\n\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'gaussian',\r\n                config: {\r\n                    ratio: 2\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n\r\n#### Posterize\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'posterize',\r\n                config: {\r\n                    ratio: 100\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Opacity\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'opacity',\r\n                config: {\r\n                    ratio: 0.1\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n### Sepia\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'sepia'\r\n              }\r\n            ]\r\n};\r\n```\r\n\r\n#### Quality\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'quality',\r\n                config: {\r\n                    ratio: 10\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Fade\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'fade',\r\n                config: {\r\n                    ratio: 0.1\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Pixelate\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'pixelate',\r\n                config: {\r\n                    ratio: 50\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Normalize\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'normalize',\r\n                config: {\r\n                    ratio: 50\r\n                }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### Threshold\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n              {\r\n                name: 'threshold',\r\n                config: { max: 200, replace: 200, autoGreyscale: false }\r\n              }\r\n            ]\r\n};\r\n```\r\n#### multiple effects\r\nyou can combine effects by using below code:\r\n```javascript\r\nlet options = {\r\n   effects: [\r\n            {\r\n                name: 'quality',\r\n                config: {\r\n                    ratio: 10\r\n                }\r\n            },\r\n            {\r\n                name: 'contrast',\r\n                config: {\r\n                    ratio: 0.2\r\n                }\r\n            },\r\n            {\r\n              name: 'threshold',\r\n              config: { max: 200 }\r\n            }\r\n          ]\r\n};\r\n```\r\n### Add watermarks\r\nyou can add watermark to all images and merge them as single pdf by set below option\r\npath: watermark image path\r\nposition: watermark position (center,right,right-bottom,center-bottom,left-top,left-bottom)\r\n\r\n```javascript\r\noptions = {\r\n  watermark: {\r\n            type: 'image',\r\n            path: '../logo1.jpg',\r\n            ratio: 0.2,\r\n            opacity: 0.2,\r\n            position: 'left-bottom'\r\n  }\r\n}\r\n```\r\n<hr>\r\n\r\n## Convert pdf to images\r\n\r\nthis feature let you convert your pdf into multiple images.\r\n<h3>Basic Usage</h3>\r\n\r\n```javascript\r\nfilepix.PDF2img('./inputImagesDir/input.pdf', \"./outputImageDir\");\r\n```\r\n<hr>\r\n\r\n## Convert pdf to word document\r\n\r\n\r\n\r\n> **_NOTE:_**  this method using OCR so first, you need to install the Tesseract project. Instructions for installing Tesseract for all platforms can be found on [the project site](https://github.com/tesseract-ocr/tessdoc/blob/master/Installation.md).\r\n\r\nafter installing Tesseract you can easily convert your pdf into file as docx format by calling below code:\r\n```javascript\r\nawait filepix.pdf2docx('./inputImageDir/input.pdf', './outputImageDir/output.docx');\r\n```\r\n\r\n#### Custom Language\r\n\r\n1- find your LangCode from <a href=\"https://tesseract-ocr.github.io/tessdoc/Data-Files-in-different-versions.html\" target=\"_blank\">here</a></br>\r\n2- download proper .traineddata file from <a href=\"https://github.com/tesseract-ocr/tessdata\" target=\"_blank\">here</a> and copy it on your local machine in Tesseract-OCR/tessdata  directory</br>\r\n3- finally use below code:</br>\r\n\r\n```javascript\r\nawait filepix.pdf2docx('./inputImageDir/input.pdf', './outputImageDir/output.docx',  options = { lang: \"deu\" });\r\n```\r\n<hr>\r\n\r\n## Convert png to jpg\r\n\r\nconvert png format into jpg even you can compress your image.\r\n\r\n```javascript\r\nawait filepix.png2jpeg('./input.png', './output.jpg'\r\n, options = {\r\n  quality: 50\r\n});\r\n```\r\n<hr>\r\n\r\n## base64 to jpg or png\r\n\r\nconvert base64 to png or jpg by calling below method.\r\n\r\n```javascript\r\nawait filepix.base64ToImg('base64Str', './outputImageDir/output.png', { extension: 'png' });\r\n```\r\n<hr>\r\n\r\n## Support\r\n  - [Bug Reports](https://github.com/hamedpa/filepix/issues/)\r\n\r\n## Contributors\r\n<p>\r\nPull requests are always welcome! Please base pull requests against the main branch and follow the contributing guide.\r\n\r\nif your pull requests makes documentation changes, please update readme file.\r\n</p>\r\n\r\n## License\r\n\r\nThis project is licensed under the terms of the\r\nMIT license\r\n","readmeFilename":"README.md","contributors":[{"name":"pariazar","email":"hamedpa19@gmail.com","url":"https://github.com/pariazar"}]}