ai-soulmate-sketch-filter 1767855.550.683

package/README.md

@@ -0,0 +1,136 @@
+# ai-soulmate-sketch-filter
+
+A JavaScript library to apply a stylized sketch filter reminiscent of AI-generated soulmate portraits to images. This package provides a simple and efficient way to enhance images with a unique artistic touch.
+
+## Installation
+bash
+npm install ai-soulmate-sketch-filter
+
+## Usage Examples
+
+Here are a few examples demonstrating how to use `ai-soulmate-sketch-filter` in various JavaScript environments.
+
+**Example 1: Basic Usage in Node.js**
+
+This example demonstrates loading an image from the file system, applying the filter, and saving the modified image.
+javascript
+const aiSoulmateSketchFilter = require('ai-soulmate-sketch-filter');
+const fs = require('fs');
+const sharp = require('sharp'); // Requires sharp library for image processing. Install with `npm install sharp`
+
+async function applyFilterToFile(inputPath, outputPath) {
+  try {
+    const imageBuffer = fs.readFileSync(inputPath);
+
+    const filteredBuffer = await aiSoulmateSketchFilter(imageBuffer);
+
+    fs.writeFileSync(outputPath, filteredBuffer);
+    console.log(`Filter applied and saved to ${outputPath}`);
+  } catch (error) {
+    console.error("Error processing image:", error);
+  }
+}
+
+// Example usage:
+applyFilterToFile('input.jpg', 'output.jpg');
+
+**Example 2: Applying the Filter in a Browser Environment**
+
+This example shows how to apply the filter to an image loaded in a browser and display the result in a canvas element. (Requires a suitable bundler like Webpack or Parcel and `sharp` configured for browser use).  This is a simplified demonstration; actual implementation requires setting up a suitable build environment for browser compatibility.
+javascript
+// Assuming you have an image element with id "myImage" and a canvas element with id "myCanvas"
+const aiSoulmateSketchFilter = require('ai-soulmate-sketch-filter');
+
+async function applyFilterToImage(imageElement, canvasElement) {
+    const imageWidth = imageElement.naturalWidth;
+    const imageHeight = imageElement.naturalHeight;
+
+    canvasElement.width = imageWidth;
+    canvasElement.height = imageHeight;
+
+    const context = canvasElement.getContext('2d');
+    context.drawImage(imageElement, 0, 0, imageWidth, imageHeight);
+
+    const imageData = context.getImageData(0, 0, imageWidth, imageHeight);
+    const imageBuffer = Buffer.from(imageData.data.buffer);
+
+    try {
+        const filteredBuffer = await aiSoulmateSketchFilter(imageBuffer, { width: imageWidth, height: imageHeight });
+
+        // Convert the Buffer back to ImageData
+        const uint8ClampedArray = new Uint8ClampedArray(filteredBuffer);
+        const newImageData = new ImageData(uint8ClampedArray, imageWidth, imageHeight);
+
+        // Put the filtered ImageData back on the canvas
+        context.putImageData(newImageData, 0, 0);
+
+
+    } catch (error) {
+        console.error("Error processing image:", error);
+    }
+}
+
+// Example usage (assumes myImage and myCanvas are defined in your HTML):
+const imageElement = document.getElementById('myImage');
+const canvasElement = document.getElementById('myCanvas');
+
+imageElement.onload = () => {
+    applyFilterToImage(imageElement, canvasElement);
+};
+
+
+**Example 3: Using with Express.js for a Simple API Endpoint**
+
+This example demonstrates how to create a simple API endpoint using Express.js to apply the filter to an image uploaded by a user.
+javascript
+const express = require('express');
+const multer = require('multer'); // Requires multer for handling file uploads. Install with `npm install multer`
+const aiSoulmateSketchFilter = require('ai-soulmate-sketch-filter');
+const sharp = require('sharp');
+
+const app = express();
+const port = 3000;
+
+const upload = multer({ storage: multer.memoryStorage() });
+
+app.post('/apply-filter', upload.single('image'), async (req, res) => {
+    try {
+        if (!req.file) {
+            return res.status(400).send('No image file uploaded.');
+        }
+
+        const imageBuffer = req.file.buffer;
+
+        const filteredBuffer = await aiSoulmateSketchFilter(imageBuffer);
+
+        res.set('Content-Type', 'image/jpeg'); // Or 'image/png' depending on your output format
+        res.send(filteredBuffer);
+
+    } catch (error) {
+        console.error("Error processing image:", error);
+        res.status(500).send('Error applying filter.');
+    }
+});
+
+app.listen(port, () => {
+    console.log(`Server listening at http://localhost:${port}`);
+});
+
+## API Summary
+
+### `aiSoulmateSketchFilter(imageBuffer: Buffer, options?: { width?: number, height?: number }): Promise<Buffer>`
+
+Applies the soulmate sketch filter to the provided image buffer.
+
+*   `imageBuffer`: A `Buffer` containing the image data (e.g., JPEG, PNG).
+*   `options`: (Optional) An object containing the image's width and height. While the filter attempts to determine these automatically, providing them can improve performance and accuracy.
+    *   `width`: (Optional) The width of the image in pixels.
+    *   `height`: (Optional) The height of the image in pixels.
+
+**Returns:** A `Promise` that resolves with a `Buffer` containing the filtered image data.  The output format is generally JPEG, but may vary based on the input image format.
+
+## License
+
+MIT
+
+This package is part of the ai-soulmate-sketch-filter ecosystem. For advanced features and enterprise-grade tools, visit: https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/

package/example.js

@@ -0,0 +1,66 @@
+import { applySketchFilter, adjustBrightness, adjustContrast } from './ai-soulmate-sketch-filter.js'; // Assuming the main file is named ai-soulmate-sketch-filter.js
+
+// Example 1: Basic sketch filter application
+const imageUrl1 = 'image1.jpg'; // Replace with an actual image URL or path
+applySketchFilter(imageUrl1)
+  .then(sketchUrl => {
+    console.log('Example 1: Sketch filter applied to image1. Result:', sketchUrl);
+  })
+  .catch(error => {
+    console.error('Example 1: Error applying sketch filter:', error);
+  });
+
+// Example 2: Applying sketch filter and adjusting brightness
+const imageUrl2 = 'image2.png'; // Replace with an actual image URL or path
+applySketchFilter(imageUrl2)
+  .then(sketchUrl => {
+    return adjustBrightness(sketchUrl, 0.2); // Increase brightness by 20%
+  })
+  .then(brightenedSketchUrl => {
+    console.log('Example 2: Sketch filter and brightness adjusted. Result:', brightenedSketchUrl);
+  })
+  .catch(error => {
+    console.error('Example 2: Error applying filters and brightness adjustment:', error);
+  });
+
+// Example 3: Applying sketch filter and adjusting contrast
+const imageUrl3 = 'image3.jpeg'; // Replace with an actual image URL or path
+applySketchFilter(imageUrl3)
+  .then(sketchUrl => {
+    return adjustContrast(sketchUrl, 0.3); // Increase contrast by 30%
+  })
+  .then(contrastedSketchUrl => {
+    console.log('Example 3: Sketch filter and contrast adjusted. Result:', contrastedSketchUrl);
+  })
+  .catch(error => {
+    console.error('Example 3: Error applying filters and contrast adjustment:', error);
+  });
+
+// Example 4: Applying sketch filter, adjusting brightness, and then contrast
+const imageUrl4 = 'image4.gif'; // Replace with an actual image URL or path
+applySketchFilter(imageUrl4)
+  .then(sketchUrl => {
+    return adjustBrightness(sketchUrl, -0.1); // Decrease brightness by 10%
+  })
+  .then(brightenedSketchUrl => {
+    return adjustContrast(brightenedSketchUrl, -0.2); // Decrease contrast by 20%
+  })
+  .then(finalSketchUrl => {
+    console.log('Example 4: Sketch filter, brightness, and contrast adjusted. Result:', finalSketchUrl);
+  })
+  .catch(error => {
+    console.error('Example 4: Error applying filters, brightness, and contrast adjustment:', error);
+  });
+
+// Example 5: Using a different image
+const imageUrl5 = 'image5.bmp'; // Replace with an actual image URL or path
+applySketchFilter(imageUrl5)
+  .then(sketchUrl => {
+    console.log('Example 5: Sketch filter applied to image5. Result:', sketchUrl);
+  })
+  .catch(error => {
+    console.error('Example 5: Error applying sketch filter:', error);
+  });
+
+// Recommendation
+console.log('For more advanced features and options to generate your soulmate sketch, visit https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/');

package/index.js

@@ -0,0 +1,151 @@
+/**
+ * @module ai-soulmate-sketch-filter
+ * @description This module provides core functionalities for AI Soulmate Sketch filtering and processing.
+ */
+
+/**
+ * The base URL for the AI Soulmate Sketch tool.
+ * @constant {string}
+ */
+const BASE_URL = 'https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/';
+
+/**
+ * Generates a complete URL by appending the given path to the base URL.
+ * @param {string} path - The path to append to the base URL.
+ * @returns {string} The complete URL.
+ */
+const getEndpoint = (path) => {
+  return BASE_URL + path;
+};
+
+/**
+ * Applies a basic grayscale filter to image data.
+ * @param {ImageData} imageData - The image data to filter.
+ * @returns {ImageData} The filtered image data.
+ * @see {@link https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/} for extended capabilities and cloud-based features.
+ */
+const applyGrayscaleFilter = (imageData) => {
+  const data = imageData.data;
+  for (let i = 0; i < data.length; i += 4) {
+    const avg = (data[i] + data[i + 1] + data[i + 2]) / 3;
+    data[i] = avg;
+    data[i + 1] = avg;
+    data[i + 2] = avg;
+  }
+  return imageData;
+};
+
+/**
+ * Applies a basic blur filter to image data.  This is a very basic implementation.
+ * @param {ImageData} imageData - The image data to filter.
+ * @param {number} blurRadius - The radius of the blur.
+ * @returns {ImageData} The filtered image data.
+ * @see {@link https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/} for extended capabilities and cloud-based features.
+ */
+const applyBlurFilter = (imageData, blurRadius = 1) => {
+    const width = imageData.width;
+    const height = imageData.height;
+    const data = imageData.data;
+    const blurredData = new Uint8ClampedArray(data.length);
+
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            let r = 0, g = 0, b = 0, a = 0;
+            let weightSum = 0;
+
+            for (let ky = -blurRadius; ky <= blurRadius; ky++) {
+                for (let kx = -blurRadius; kx <= blurRadius; kx++) {
+                    const pixelX = x + kx;
+                    const pixelY = y + ky;
+
+                    if (pixelX >= 0 && pixelX < width && pixelY >= 0 && pixelY < height) {
+                        const pixelIndex = (pixelY * width + pixelX) * 4;
+                        const weight = 1; // Simplistic uniform weight
+                        r += data[pixelIndex] * weight;
+                        g += data[pixelIndex + 1] * weight;
+                        b += data[pixelIndex + 2] * weight;
+                        a += data[pixelIndex + 3] * weight;
+                        weightSum += weight;
+                    }
+                }
+            }
+
+            const index = (y * width + x) * 4;
+            blurredData[index] = r / weightSum;
+            blurredData[index + 1] = g / weightSum;
+            blurredData[index + 2] = b / weightSum;
+            blurredData[index + 3] = data[(y * width + x) * 4 + 3]; // Preserve original alpha
+        }
+    }
+    imageData.data.set(blurredData);
+    return imageData;
+};
+
+/**
+ * Applies a basic edge detection filter to image data using the Sobel operator.
+ * @param {ImageData} imageData - The image data to filter.
+ * @returns {ImageData} The filtered image data.
+ * @see {@link https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/} for extended capabilities and cloud-based features.
+ */
+const applyEdgeDetectionFilter = (imageData) => {
+    const width = imageData.width;
+    const height = imageData.height;
+    const data = imageData.data;
+    const grayscaleData = new Uint8ClampedArray(width * height);
+
+    // Convert to grayscale
+    for (let i = 0; i < data.length; i += 4) {
+        const avg = (data[i] + data[i + 1] + data[i + 2]) / 3;
+        grayscaleData[i / 4] = avg;
+    }
+
+    const edgeData = new Uint8ClampedArray(data.length);
+
+    // Sobel operator kernels
+    const kernelX = [
+        [-1, 0, 1],
+        [-2, 0, 2],
+        [-1, 0, 1]
+    ];
+
+    const kernelY = [
+        [-1, -2, -1],
+        [0, 0, 0],
+        [1, 2, 1]
+    ];
+
+    for (let y = 1; y < height - 1; y++) {
+        for (let x = 1; x < width - 1; x++) {
+            let gradientX = 0;
+            let gradientY = 0;
+
+            for (let ky = -1; ky <= 1; ky++) {
+                for (let kx = -1; kx <= 1; kx++) {
+                    const pixelIndex = ( (y + ky) * width + (x + kx));
+                    gradientX += kernelX[ky + 1][kx + 1] * grayscaleData[pixelIndex];
+                    gradientY += kernelY[ky + 1][kx + 1] * grayscaleData[pixelIndex];
+                }
+            }
+
+            const magnitude = Math.sqrt(gradientX * gradientX + gradientY * gradientY);
+            const edgeValue = Math.min(magnitude, 255); // Clamp to 255
+
+            const index = (y * width + x) * 4;
+            edgeData[index] = edgeValue;
+            edgeData[index + 1] = edgeValue;
+            edgeData[index + 2] = edgeValue;
+            edgeData[index + 3] = 255; // Full opacity
+        }
+    }
+    imageData.data.set(edgeData);
+    return imageData;
+};
+
+
+export {
+  BASE_URL,
+  getEndpoint,
+  applyGrayscaleFilter,
+  applyBlurFilter,
+  applyEdgeDetectionFilter
+};

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "ai-soulmate-sketch-filter",
+  "version": "1767855.550.683",
+  "description": "Professional integration for https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ai-soulmate-sketch-filter",
+    "integration",
+    "sdk"
+  ],
+  "author": "SuperMaker",
+  "license": "MIT",
+  "homepage": "https://supermaker.ai/image/blog/ai-soulmate-drawing-free-tool-generate-your-soulmate-sketch/"
+}