Pixerate/pixerate-vector

Pixerate-Vektoreditor

Das Vektordokument ist eine Zeichenfläche (width x height in Dokumenteinheiten, y nach unten), die einen Baum von Knoten enthält: path-Knoten (ein oder mehrere Unterpfade von Bézier-Ankern mit Füllung, Kontur und Kontureinstellungen), text-Knoten (ein String als Punkttext, Bereichstext oder entlang eines Pfades, bemalt mit denselben Füllungen und Konturen), instance-Knoten (eine platzierte Kopie eines Symbols) und group-Knoten. Gruppen können auch Live-Boolesche Operationen, Live-Überblendungen, Maskengruppen sein oder einen Live-Effektstapel tragen. Jeder Befehl ist ein vector.*-Befehl, der mit run_command / run_commands ausgeführt wird (siehe pixerate-agent-tools für Stapelverarbeitung mit "$0.id"-Referenzen, atomic: true und Fehlercodes).

• Knoten-IDs stammen von vector.list und von dem, was Schreiboperationen zurückgeben ({ id }, { ids }).
• Anker sind { nodeId, subpath, index }: Unterpfadnummer innerhalb des Pfades, dann Ankernummer innerhalb des Unterpfades, beide beginnend bei 0. Befehle, die anchors erwarten, verwenden standardmäßig die mit dem Direktauswahl-Werkzeug ausgewählten Punkte; solche, die ids erwarten, verwenden standardmäßig die Auswahl.
• Farbe ist eine CSS-Farbe, null für keine oder ein Verlaufsobjekt { type, stops: [{ offset, color, opacity?, midpoint? }], ... }.
• Erscheinungsbild: Ein Pfad kann mehrere Füllungen und mehrere Konturen stapeln (von unten nach oben; alle Füllungen zeichnen unter allen Konturen), jede mit eigener Farbe, Deckkraft (opacity), Mischmodus (blendMode) und Sichtbarkeit (visible), und jede Kontur mit eigener Breite, Ausrichtung, Strichelung, Endkappen, Verbindungen, Pfeilspitzen und Profil, oder einem Pinselstrich (vector.addBrushstroke, vector.setBrushstroke, vector.listBrushes), der entlang der Kontur mit einem trockenen oder nassen Pinsel, einem Mischpinsel, Wischer oder Mischer, Verlauffarbe, gesätem Jitter und Papierkörnung gemalt wird. Ebenen werden durch ihren index im Stapel adressiert, 0 ganz unten. fill / stroke und die Kontureinstellungen von vector.setStyle sind Kurzformen für die oberste Ebene; null löscht den Stapel. Jeder Knoten kann auch einen blendMode und filters haben (Schlagschatten / Innerer Schatten, Äußerer / Innerer Glanz, Ebenenweichzeichner, Feder), die nie die Geometrie ändern.
• Masken: Das erste (unterste) Kind einer Maskengruppe ist ihre Maske; die Kinder darüber werden nur innerhalb der Kontur der Maske (clip) oder dort angezeigt, wo sie hell (luminance) oder deckend (alpha) ist. invert vertauscht Anzeige und Ausblendung. vector.list gibt einer Maskengruppe eine mask { type, invert, maskId, contents, enabled }; eine versteckte Maske (enabled: false) maskiert nichts.
• Text hat eine Basis-font (Familie, Gewicht, kursiv, Größe, Laufweite, Zeilenabstand, Grundlinienversatz, Unterstreichung, Durchstreichung), optionale Läufe, die Felder über Bereiche überschreiben (start / end in UTF-16-Codeeinheiten, plus eine Bereichs-fill), einen paragraph-Stil und einen frame: point (x, y der ersten Grundlinie), area (eine Box, in die er umbricht) oder path (eine Linie, der er folgt).
• Symbole sind wiederverwendbare Grafiken, die im Dokument gespeichert werden (vector.listSymbols), gezeichnet von instance-Knoten durch eine Transformation, die, anders als bei anderen Knoten, skalieren und scheren kann. Das Bearbeiten eines Symbols (vector.editSymbol … vector.exitSymbolEdit) ändert jede Instanz.
• Constraints (CAD-artig) halten geometrische Beziehungen und Maße zwischen Ankern, Segmenten und runden Pfaden aufrecht; sie werden nach jeder Bearbeitung gelöst, sodass spätere Bewegungen sie beibehalten.
• Rahmen sind Gruppen mit einem frame-Rechteck (vector.listFrames): Sie zeichnen einen Hintergrund, beschneiden ihre Kinder und wählen durch ihr Rechteck aus; Rahmen der obersten Ebene sind Zeichenflächen. Wenn ein Rahmen in der Größe verändert wird, folgen seine Kinder ihren Größenänderungs-Constraints (horizontal left / right / leftRight / center / scale, vertikal top / bottom / topBottom / center / scale) anstatt skaliert zu werden.
• Verbinder sind offene Pfade mit einem connector, dessen Enden an den Anschlussstellen anderer Objekte (der Mitte einer Seite oder der Mitte) festgeklebt sind; sie werden nach jeder Bearbeitung neu verlegt, sodass sie dem folgen, was sie verbinden. Ein freies Ende bleibt, wo es ist.
• Symmetriegruppen zeichnen ihre Kinder plus gespiegelte oder gedrehte Kopien. Fügen Sie Grafiken mit parentId auf vector.addShape / vector.addPath hinzu; nur die Originale werden gespeichert und bearbeitet.
• Koordinaten sind in Dokumenteinheiten. Ein gedrehter Knoten speichert seine Geometrie in seinem eigenen Raum: Die von vector.list gemeldeten bounds sind im Dokumentraum, sein d ist das des Knotens selbst.

Parameterdetails (Verlauffelder, Effektparameter, Breitenprofile, Hüllkurven) finden Sie in references/commands.md.

Arbeitsablauf-Fähigkeiten

Laden Sie für diese Aufgaben auch die Arbeitsablauf-Fähigkeit: Sie enthält die Methode, die Überprüfungen zwischen den Schritten und die Fallstricke und verwendet die untenstehenden Befehle.

• pixerate-vector-icon-set: Symbole auf einem Raster, einem Strich und Stil, scharf, als Symbole und SVG.
• pixerate-vector-logo: Marken aus Booleschen Operationen, ein Lockup, Farbvarianten, ausgegebene Lieferdateien.
• pixerate-vector-illustration: Einblocken, Verläufe und gestapelte Füllungen, Masken, Überblendungen, Schatten.

Arbeitsweise

1. Lesen. vector.list gibt die Zeichenflächengröße, jeden Knoten in Tiefensuche (id, Typ, Name, Grenzen, Drehung, Füllung, Kontur, d, Effekte, Überblendungs- und Boolesche Informationen, Stapel, Mischmodus und Filter) und die Auswahl. vector.getAppearance gibt die vollständigen Stapel und Filter eines Knotens.
2. In Ebenen planen. Entscheiden Sie sich für die Formen, ihre Stapelung (von unten nach oben) und ihre Gruppierung, bevor Sie zeichnen. Beginnen Sie mit Primitiven (vector.addShape) und kombinieren Sie sie; schreiben Sie rohes d nur für Kurven, die Primitive nicht erzeugen können.
3. In Stapeln schreiben. Setzen Sie eine Konstruktionssequenz in einen run_commands mit atomic: true und einem label, und verketten Sie ids ("$0.id", "$last.ids"), sodass es ein Undo-Schritt ist, der alles oder nichts anwendet.
4. Live bevorzugen, zuletzt erweitern. Verwenden Sie live: true Boolesche Operationen, Pfadeffekte, Hüllkurven, Live-Ecken und Überblendungen während des Designs; backen Sie mit vector.expandAppearance, vector.expandBlend oder vector.outlineStroke nur, wenn der Benutzer einfache Pfade benötigt.
5. Überprüfen. vector.list noch einmal: Grenzen dort, wo Sie sie beabsichtigt haben, keine überflüssigen Knoten, sinnvolle Namen. vector.exportSvg gibt das endgültige Markup; überprüfen Sie es oder rendern Sie es, wenn Sie können, bevor Sie es übergeben.

Best Practices

• Rahmen für alles, was die Größe ändert. Bauen Sie Bildschirme, Karten, Schaltflächen und Banner in einem Rahmen (vector.addFrame oder vector.frameSelection), setzen Sie die Constraints jedes Kindes mit vector.setResizing (Hintergründe und Trennlinien leftRight, Symbole in ihrer Ecke fixiert, Titel center), dann ändern Sie die Größe mit vector.setFrame, um andere Größen aus einem Design zu erzeugen. Exportieren Sie jede Zeichenfläche mit vector.exportFrameSvg.
• Symbole für Wiederholungen. Wenn dieselbe Grafik mehrmals erscheint (Symbole in einem Set, Bäume in einer Szene, Aufzählungszeichen, ein Logo-Mark), erstellen Sie sie einmal und platzieren Sie Instanzen (vector.makeSymbol, dann vector.placeSymbol mit x / y oder einem transform), sodass eine Bearbeitung in Isolation alle ändert. Geben Sie jedem einen klaren Namen. Verwenden Sie vector.setInstanceOptions fill / stroke für Farbvarianten und hidden, um einen Teil wegzulassen, anstatt zu trennen; trennen Sie nur, wenn eine Kopie endgültig abweichen muss.
• Text. Verwenden Sie Punkttext für Beschriftungen und Überschriften, Bereichstext (width, height) für alles, das umbrechen soll, Text auf einem Pfad für Abzeichen und Siegel. Überprüfen Sie das overflow im Summary, das jeder Textschreibvorgang zurückgibt: versteckte Zeilen oder Zeichen bedeuten, dass die Box oder der Pfad zu klein ist. Halten Sie ein oder zwei Familien pro Design (vector.listFonts listet, was der Shaper hat; eine fehlende Familie zeichnet in einem Fallback und erscheint in missingFonts). Stilbereiche mit vector.setTextStyle anstatt Text in separate Knoten aufzuteilen, sodass er immer noch als ein Absatz bearbeitet wird. Erstellen Sie Konturen nur für endgültige Grafiken oder Logos, die nicht von Schriftarten abhängen dürfen; behalten Sie eine Kopie als Text, wenn sie sich ändern könnte.
• Pfade, Konturen, Pinselstriche, Boolesche Operationen, Verläufe, Stapel, Masken, Schatten, Verbinder, Constraints und vertikaler Text: Lesen Sie zuerst references/best-practices.md.
• Zuerst nicht-destruktiv. Live-Boolesche Operationen (vector.boolean mit live: true), Pfadeffekte und Hüllkurven halten die Operanden bearbeitbar. Eine destruktive Boolesche Operation oder Pathfinder ersetzt ihre Eingaben; machen Sie das zuletzt und nur, wenn eine flache Ausgabe verlangt wird.
• Gruppierung und Benennung. Gruppieren Sie die Teile eines Objekts (vector.group mit einem name), nennen Sie wichtige Pfade (name beim Hinzufügen) und halten Sie den Baum flach.
• SVG-Hygiene. Exportieren Sie mit precision 2 oder 3 (Standard 3); höher nur für winzige Zeichenflächen. Erweitern Sie Effekte, Überblendungen und variable Breitenkonturen, bevor Sie SVG an Werkzeuge übergeben, die Pixerates data-vector-*-Attribute nicht lesen; andere Leser sehen das gezeichnete Erscheinungsbild, aber nicht die Live-Quelle.

Befehle

Lesen

Befehl	Verwenden Sie ihn, um
vector.list	Das Dokument zu lesen: { width, height, nodes, selection, tool }. Jeder Knoten hat id, Typ, Name, Tiefe, dokumentenraum bounds, rotation (Grad im Uhrzeigersinn), sichtbar, gesperrt, ausgewählt, und für Pfade Füllung, Kontur, strokeWidth und d; Gruppen listen children, blend, liveBoolean, effects, mask. Die bounds einer Maskengruppe sind ihr maskiertes Ergebnis. Rufen Sie es zuerst und nach jedem Stapel auf.
vector.shapeBuilderFaces	Die Regionen aufzulisten, die die gegebenen Pfade in die Ebene teilen: Pfaddaten, Fläche, ein Punkt innerhalb jeder und die IDs der Pfade, die sie füllen. Verwenden Sie die Punkte mit vector.shapeBuilder.
vector.exportSvg	Das Dokument als eigenständiges SVG-Markup zu erhalten ({ svg }); precision 0 bis 8 Dezimalstellen (Standard 3).
vector.exportPdf	Ein druckfertiges Vektor-PDF als base64-Daten-URL zu erhalten: eine Seite oder eine pro Zeichenfläche mit pages: "artboards". Gibt { pdf, pages, bytes, notes } zurück; überprüfen Sie notes (Filter, Deckkraftmasken und Text ohne geladene Schriftarten werden ausgelassen).
vector.exportLottie	Das Dokument (oder ids) als Lottie-JSON für Animationsplayer zu erhalten: Pfadeffekte bleiben als Lottie-Modifikatoren live, Verläufe als Verlauffüllungen. Gibt { lottie, notes } zurück; lesen Sie notes für das, was angenähert wurde (Filter, Netzverläufe, Text ohne Konturen).

Erstellen und Löschen

Befehl	Verwenden Sie ihn, um
vector.traceImage	Ein PNG (Daten-URL) in Vektorpfade in einer Gruppe umzuwandeln: threshold-Modus für einfarbige Grafiken (Logos, Scans, Silhouetten; channel: "alpha" für Ausschnitte), color-Modus für einen gestapelten Pfad pro Farbe (colors 2–32). Erhöhen Sie tolerance für weniger Anker, cornerRoundness 0 für scharfe Polygone. Platzieren Sie es mit x, y, width. Gibt { id, paths } zurück; überprüfen Sie subpaths-Anzahl und vereinfachen oder löschen Sie Flecken danach.
vector.mosaicImage	Ein PNG als Mosaikfliesen zu stilisieren (cell px, shape square / circle, gap, colors): Pixelkunst, geflieste Wandbilder. Gibt { id, paths } zurück, einen zusammengesetzten Pfad pro Farbe.
vector.halftoneImage	Ein PNG als Halbtondots auf einem gedrehten Raster zu stilisieren (cell, angle, Tint color oder null für die Farben des Bildes): Comic- und Pop-Art-Looks, Druckeffekte.
vector.lowPolyImage	Ein PNG als Low-Poly-Dreiecke zu stilisieren (cell, jitter, seed, colors): geometrische Porträts und Hintergründe.
vector.hatchImage	Ein PNG als Gravurlinien zu stilisieren, die anschwellen, wo es dunkel ist (cell-Abstand, angle, Tint color): Banknoten-, Holzschnitt- und Linienkunst-Looks.
vector.addPathByDimensions	Einen Pfad so zu zeichnen, wie ein CAD-Benutzer ihn eingibt: von start, jeder Schritt { length, angle } (Grad gegen den Uhrzeigersinn auf der Seite: 0 rechts, 90 oben), { dx, dy } oder { x, y }; closed verbindet die Enden. Verwenden Sie es für exakte technische Umrisse (Klammern, Grundrisse, gegebene Längen und Winkel) anstatt Koordinaten von Hand zu berechnen. Gibt { id, anchors } zurück.
vector.addShape	Eine kind rect, ellipse, polygon (sides, mindestens 3), star (points, innerRatio 0 bis 1) oder line an x, y, width, height hinzuzufügen (alle erforderlich; für eine Linie sind Breite und Höhe der Endversatz). cornerRadius und cornerKind geben Live-Ecken; jedes Stilfeld und name werden angewendet. Verwendet den Editor-Standardstil für alles, was nicht angegeben ist. Gibt { id } zurück.
vector.addPath	Einen Pfad aus SVG-Pfaddaten d (absolute oder relative M, L, H, V, C, S, Q, T, A, Z; Bögen und Quadratics werden zu Cubics) in Dokumenteinheiten hinzuzufügen, mit name und Stilfeldern; nicht gesetzter Stil kommt von den Editor-Standardeinstellungen. Schlägt fehl, wenn d keine Punkte hat. Gibt { id } zurück.
vector.importSvg	Die Formen von SVG-Markup svg oben auf das Dokument hinzuzufügen oder das Dokument mit replace: true zu ersetzen. Liest Pfade, Grundformen, Gruppen, Transformationen, lineare und radiale Verläufe, clip-path / mask-Referenzen (als Maskengruppen) <text> (als Punkttext: Inhalt, Schriftart, Anker und Füllung) und <use> (als Instanzen von Symbolen, die aus dem erstellt wurden, worauf sie verweisen); überspringt Bilder und fremde Filter.
vector.importLottie	Einen frame einer Lottie-Animation (Objekt oder Text) als bearbeitbare Gruppen hinzuzufügen oder das Dokument zu ersetzen (replace: true). Modifikatoren werden zu Live-Effekten. Gibt { ids, notes } zurück.
vector.delete	Knoten (ids) zu löschen.
vector.rename	Knoten id in name umzubenennen (sein Name im Ebenen-Bedienfeld). Benennen Sie, was Sie erstellen, nach dem, was es ist; benennen Sie die Ebenen des Benutzers nur um, wenn Sie darum gebeten werden. Gibt { id, name } zurück.

Stil

Befehl	Verwenden Sie ihn, um
vector.setStyle	fill, stroke, strokeWidth, strokeLinecap (butt, round, square), strokeLinejoin (miter, round, bevel), strokeDasharray, fillRule (nonzero, evenodd), strokeAlign (center, inside, outside; nur geschlossene Formen), startArrow / endArrow (triangle, arrow, open, circle, square, bar, oder null), arrowAlign (extend, tip), startArrowScale / endArrowScale (Vielfache der Konturbreite, Standard 1), strokeWidthProfile auf ids zu setzen. Gruppen wenden sie auf jeden Pfad darin an. Übergeben Sie mindestens ein Feld.
vector.setGradient	Den Verlauf der Füllung (target Standard) oder Kontur von ids zu bearbeiten: type (linear, radial, conic, reflected, diamond), stops, angle (Grad, 0 oben, im Uhrzeigersinn), cx / cy / r, explizite start / end / width / focal, units, spread, interpolation (srgb Standard, linear, oklab), smoothness, strokeMode, aspect, reverse. Fehlende Felder behalten ihren Wert; eine Volltonfarbe wird zu einem Verlauf von ihr zu Weiß. Gibt das aktualisierte Erscheinungsbild zurück.
vector.setFillStack	Den Füllungsstapel von ids zu ersetzen. Gibt die übergebenen fills als neuen Stapel von oben nach unten an (letzter Eintrag ist die unterste Füllung). Jede Füllung ist ein Objekt mit paint, opacity, blendMode und visible.
vector.setStrokeStack	Den Konturstapel von ids zu ersetzen. Jede Kontur ist ein Objekt mit paint, width, opacity, blendMode, visible, dashes, alignment, linecap, linejoin, arrowStart, arrowEnd, arrowAlign, arrowStartScale, arrowEndScale, widthProfile.
vector.setAppearance	fill, stroke, fills, strokes (Stapel, einschließlich optionaler widthProfile und Pfeilfelder), opacity, blendMode, filters, brushstroke und visible auf ids zu setzen. Fehlende Felder werden nicht geändert, auf null gesetzte Felder gelöscht.
vector.getAppearance	Die vollständigen Erscheinungsbilddaten eines Knotens zu lesen ({ id, fills, strokes, opacity, blendMode, filters, brushstroke, visible }).
vector.setBrushstroke	Einen brushstroke auf ids zu setzen: brush ID (aus vector.listBrushes), type (stroke / fill / gradient), size, spacing, scatter, rotation, opacity, color (für einfarbige Pinsel), gradient (für Verlaufspinsel), flipAlong, flipAcross, pressureSize, pressureOpacity, wetEdges, mixBrush, smudge, blender, paperGrain, grainScale, grainBrightness, jitterSeed. Fehlende Felder setzen die aktuellen Pinselparameter zurück.
vector.addBrushstroke	Einen neuen Pinselstrich zu brush auf ids hinzuzufügen (fügt eine zusätzliche Kontur-/Füllungsebene mit Pinseldaten hinzu).
vector.setBlendMode	Den Mischmodus auf ids zu setzen (normal, multiply, screen, overlay, darken, lighten, colorDodge, colorBurn, hardLight, softLight, difference, exclusion, hue, saturation, color, luminosity).
vector.setFilters	Filter auf ids zu setzen: { dropShadow?, innerShadow?, outerGlow?, innerGlow?, layerBlur?, feather? }, jedes mit seinen eigenen Parametern. null löscht alle Filter.

Text

Befehl	Verwenden Sie ihn, um
vector.addText	Text hinzuzufügen: content (String), x, y, width? (für Bereichstext), height? (für Bereichstext), pathId? (für Text auf Pfad), font, fontSize, fontWeight, italic, tracking, leading, baselineShift, underline, strikethrough, fill, stroke, strokeWidth, paragraphAlign (left, center, right, justify), paragraphIndent, paragraphSpacing, name. Gibt { id, overflow? } zurück; überprüfen Sie overflow – wenn wahr, ist der Text abgeschnitten.
vector.setTextStyle	Textstil auf ids zu setzen: fields Objekt mit font, fontSize, fontWeight, italic, tracking, leading, baselineShift, underline, strikethrough, fill, stroke, strokeWidth; range { start, end } (optional, UTF-16-Codeeinheiten) für Bereichsstile.
vector.setParagraphStyle	Absatzstil auf ids zu setzen: align, indent, spacing, hyphenate, firstLineIndent.
vector.setTextOnPath	Text auf einen Pfad zu setzen: textId, pathId, startOffset (Dokumenteinheiten entlang des Pfades), align (baseline, center, top, bottom), side (left, right, both).
vector.createOutlines	Text in Pfade umzuwandeln: ids (von Textknoten), ersetzt sie durch Pfadknoten. Gibt { ids } der neuen Pfade zurück.
vector.listFonts	Verfügbare Schriftarten aufzulisten: { fonts: [{ family, weight, italic }] }.

Symbole und Instanzen

Befehl	Verwenden Sie ihn, um
vector.makeSymbol	Aus ids ein Symbol zu erstellen: name. Gibt { symbolId } zurück.
vector.placeSymbol	Eine Instanz eines Symbols zu platzieren: symbolId, x, y, transform? (Transformationsmatrix [a, b, c, d, e, f]), name. Gibt { id } zurück.
vector.editSymbol	Ein Symbol zur Bearbeitung zu öffnen: symbolId. Danach vector.exitSymbolEdit aufrufen.
vector.exitSymbolEdit	Die Symbolbearbeitung zu schließen und zur Hauptzeichnung zurückzukehren.
vector.setInstanceOptions	Instanzoptionen zu setzen: id, fill?, stroke?, hidden? (Array von Knoten-IDs im Symbol, die ausgeblendet werden sollen).
vector.detachInstance	Eine Instanz von ihrem Symbol zu trennen: id, macht sie zu einer unabhängigen Gruppe.
vector.listSymbols	Alle Symbole im Dokument aufzulisten: { symbols: [{ id, name, bounds }] }.

Boolesche Operationen und Pathfinder

Befehl	Verwenden Sie ihn, um
vector.boolean	ids mit operation (unite, subtract, intersect, exclude) zu kombinieren; live: true für Live-Boolesche Operation. Gibt { id } (oder { ids } für nicht-live).
vector.pathfinder	ids mit operation (divide, trim, merge, crop, outline, minusBack) zu kombinieren. Destruktiv, ersetzt Eingaben. Gibt { ids }.
vector.shapeBuilder	Ausgewählte Regionen in neue Pfade zu formen: points (Array von Punkten innerhalb von Regionen von vector.shapeBuilderFaces), mode (add, subtract, intersect, exclude). Gibt { ids } der neuen Pfade.
vector.paintBucket	Eine Region mit einem Pfad zu füllen: point (Punkt innerhalb der Region), fill, stroke, tolerance. Gibt { id } des neuen Pfades.
vector.expandAppearance	Live-Boolesche Operationen, Pfadeffekte, Hüllkurven und Überblendungen in ids zu erweitern (zu backen). Gibt { ids } der resultierenden flachen Pfade.

Pfadeffekte und Hüllkurven

Befehl	Verwenden Sie ihn, um
vector.addPathEffect	Einen Pfadeffekt zu ids hinzuzufügen: type (trim, repeater, zigzag, offset, roundCorners, simplify, smooth), mit effektspezifischen Parametern.
vector.setPathEffect	Parameter eines vorhandenen Pfadeffekts zu setzen: id, effectIndex, params.
vector.removePathEffect	Einen Pfadeffekt aus ids zu entfernen: effectIndex.
vector.addEnvelope	Eine Hüllkurve auf ids anzuwenden: type (warp, distort), params (warp: style (arc, bulge, flag, fish, rise, shell, squeeze, twist), bend, horizontal, vertical; distort: mesh Punkte).
vector.setEnvelope	Hüllkurvenparameter zu setzen: id, params.
vector.removeEnvelope	Die Hüllkurve von ids zu entfernen.

Überblendungen |

Befehl	Verwenden Sie ihn, um
vector.makeBlend	Eine Überblendung zwischen zwei Pfaden (fromId, toId) zu erstellen: steps, type (smooth, color, shape), orientation (align, angle). Gibt { id } der Überblendungsgruppe.
vector.expandBlend	Eine Überblendung (id) in einzelne Pfade zu erweitern. Gibt { ids }.

Masken

Befehl	Verwenden Sie ihn, um
vector.makeMask	Eine Maske aus maskId (dem, was maskiert) und ids (dem, was maskiert wird) zu erstellen: type (clip, alpha, luminance), invert, name. Gibt { id } der Maskengruppe.
vector.setMask	Maskenparameter zu setzen: id, type, invert, enabled.
vector.releaseMask	Die Maske von id freizugeben und die Kinder als separate Knoten zu belassen.

Rahmen und Zeichenflächen

Befehl	Verwenden Sie ihn, um
vector.addFrame	Einen Rahmen hinzuzufügen: x, y, width, height, name. Gibt { id } einer Rahmen-Gruppe.
vector.frameSelection	Ausgewählte Knoten in einen Rahmen zu setzen. Gibt { id } des neuen Rahmens.
vector.setFrame	Rahmenabmessungen zu setzen: id, width, height, x?, y?.
vector.setResizing	Größenänderungs-Constraints auf Kinder eines Rahmens zu setzen: id, horizontal (left, right, leftRight, center, scale), vertical (top, bottom, topBottom, center, scale).
vector.listFrames	Alle Rahmen im Dokument aufzulisten: { frames: [{ id, name, bounds, children }] }.
vector.exportFrameSvg	Eine Zeichenfläche als SVG zu exportieren: id, precision. Gibt { svg }.

Verbinder

Befehl	Verwenden Sie ihn, um
vector.makeConnector	Einen Verbinder zwischen startId, startSite (top, bottom, left, right, center), endId, endSite zu erstellen. Gibt { id } des Verbinder-Pfades.
vector.setConnector	Verbinderenden zu setzen: id, startId, startSite, endId, endSite.

Constraints (CAD)

Befehl	Verwenden Sie ihn, um
vector.addConstraint	Ein Constraint hinzuzufügen: type (coincident, concentric, collinear, equalLength, equalRadius, fix, horizontal, vertical, parallel, perpendicular, tangent, distance, angle, radius), anchors?, value? (für Maße). Gibt { id } des Constraints.
vector.listConstraints	Alle Constraints aufzulisten.
vector.removeConstraint	Ein Constraint zu entfernen: id.
vector.solveConstraints	Manuell zu lösen. Wird automatisch nach jeder Bearbeitung ausgeführt.

Symmetriegruppen

Befehl	Verwenden Sie ihn, um
vector.makeSymmetry	Eine Symmetriegruppe aus ids zu erstellen: type (mirror, rotate), count (für Rotation), angle (für Spiegelung), center? (Punkt). Gibt { id } der Gruppe.

Transformationen

Befehl	Verwenden Sie ihn, um
vector.move	Knoten (ids) zu verschieben: dx, dy.
vector.rotate	Knoten zu drehen: ids, angle (Grad im Uhrzeigersinn), center (optionaler Drehpunkt).
vector.scale	Knoten zu skalieren: ids, sx, sy, center.
vector.skew	Knoten zu scheren: ids, sx, sy, center.
vector.flip	Knoten zu spiegeln: ids, axis (horizontal, vertical), center.
vector.transform	Eine affine Transformation auf ids anzuwenden: matrix [a, b, c, d, e, f].
vector.align	Knoten auszurichten (ids): align (left, centerX, right, top, centerY, bottom), relativeTo (selection, artboard, lastSelected).
vector.distribute	Knoten zu verteilen (ids): direction (horizontal, vertical), mode (space, center), padding?.

Ankerbearbeitung

Befehl	Verwenden Sie ihn, um
vector.join	Anker (anchors) zu verbinden: mode (join, average), closed? (ob der Pfad geschlossen werden soll).
vector.smooth	Anker zu glätten: anchors, amount.
vector.simplify	Pfade zu vereinfachen (ids): tolerance. Entfernt überflüssige Anker.
vector.knife	Pfade an points (Punkte entlang des Pfades) zu schneiden.
vector.erase	Teile von anchors zu löschen: mode (point, segment).
vector.addAnchor	Einen Anker auf einem Segment hinzuzufügen: pathId, subpath, segmentIndex, t (0-1).
vector.setAnchor	Ankerdaten zu setzen: anchors, x?, y?, handleIn?, handleOut?, type? (corner, smooth, symmetric).
vector.removeAnchor	Anker zu entfernen: anchors.

Gruppen

Befehl	Verwenden Sie ihn, um
vector.group	ids zu gruppieren: name, parentId (optional). Gibt { id } der Gruppe.
vector.ungroup	ids (Gruppen) zu entgruppieren.

Sonstige

Befehl	Verwenden Sie ihn, um
vector.setSelection	Die Auswahl auf ids zu setzen.
vector.duplicate	ids zu duplizieren: dx?, dy? (Versatz). Gibt { ids } der Duplikate.
vector.arrange	Die Stapelreihenfolge von ids zu ändern: action (bringToFront, bringForward, sendBackward, sendToBack).
vector.setLayer	ids auf ein bestimmtes layer (Nummer) im Stapel ihres Elternteils zu verschieben.
vector.toggleVisible	Die Sichtbarkeit von ids umzuschalten.
vector.toggleLocked	Den Sperrstatus von ids umzuschalten.
vector.setName	ids einen name zu geben (wie rename).

Siehe references/commands.md für vollständige Parameterdetails und Beispiele.