Dokumentation

Installation

macOS

DMG von der Release-Seite herunterladen, öffnen und mlcos-playground.app in den Programme-Ordner ziehen.

CLI-Tools sind im .tar.gz-Archiv enthalten:

tar xzf mlcos-v0.7.3-macos-arm64.tar.gz
sudo mv mlcos-* /usr/local/bin/

Windows

Den NSIS-Installer (mlcos-playground-v0.7.3-windows-setup.exe) ausführen. Er installiert die CLI-Tools nach %PROGRAMFILES%\mlc-opticscript und fügt sie zum PATH hinzu.

Linux

tar xzf mlcos-v0.7.3-linux-x86_64.tar.gz
sudo mv mlcos-* /usr/local/bin/

Schnellstart — Desktop-Playground

1. MLC OpticScript Playground starten
2. Ein Bild auf die Eingabezone ziehen
3. Ein Beispiel aus dem Dropdown wählen — oder eigenes Skript schreiben
4. Run klicken (oder Ctrl+Enter / Cmd+Enter)

Skript-Direktiven

//!OUTPUT: RESULT          // Output-Keys deklarieren
//!INPUT: PHOTO            // Input-Slots deklarieren (erzeugt Drop-Zonen)
//!PARAM: ANGLE:number=45  // Parameter-Slider zur UI hinzufügen

Schnellstart — CLI

# JavaScript-Pipeline ausführen
mlcos-run skript.js --INPUT=foto.png --OUTPUT=ergebnis.png

Schnellstart — HTTP-Server

mlcos-server -port 8080 -token meinsecret
# POST /process mit Bild + Skript

JavaScript API-Überblick

// Laden und transformieren
const img = Engine.loadImage("INPUT");
const result = img
  .brightness(1.1)
  .contrast(1.3)
  .blur(1.5)
  .rotate(30)
  .resize(800, 600);
Engine.saveImage(result, "OUTPUT");

// Vektor-Overlay
const canvas = Engine.createCanvas(800, 600);
const path = Engine.createPath()
  .moveTo(100, 100)
  .cubicTo(200, 50, 300, 150, 400, 100)
  .close();
canvas.fill(1, 0, 0, 0.5).drawPath(path);
const overlay = canvas.toImage();
result.blendAt(overlay, 0, 0, { mode: BLEND_OVER });

// SVG-Tracing
const svg = img.toSVG({ colorCount: 16, pathSimplify: "spline" });
Engine.writeSVG("OUTPUT_SVG", svg);