plugin-asset-manifest

星标13

分支0

更新时间2026年7月3日 10:47

Define and consume a JSON manifest that binds exported control filmstrips to plugin parameters for a GUI skinning engine. Use when wiring StripKit or KnobMan output into a JUCE LookAndFeel or a VybeForge-style skin, when designing a skin.json that maps each control to its asset, frame count, geometry and parameter, when a skinning system must auto-load knobs, faders, sliders, buttons and meters without hard-coded paths, or when versioning a skin so a loader stays compatible. Covers the manifest schema, relative-path and HiDPI conventions, a JSON Schema with a worked example, and how a loader picks the frame from a normalized value. Triggers on skin manifest, skin.json, plugin asset manifest, bind filmstrip to parameter, LookAndFeel from JSON, asset manifest schema, frame count, HiDPI at2x asset, skin versioning.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

Vybecode-LTD

Vybecode-LTD/stripkit

打开 GitHub 仓库查看创作者相关仓库

下载

相关职业SOC

基于 SOC 职业分类

软件开发工程师计算机与数学类职业·SOC 15-1252

SKILL.md

readonly

同仓库更多 Skills

同仓库

release-source-integrity-guard

Vybecode-LTD/stripkit

Guard a release so its git tag can always rebuild its own artifact. Many release scripts make a "Release vX.Y.Z" commit that stages ONLY the bumped version files plus the built installer/binary — so if the feature SOURCE was not committed first, it is orphaned: the tag and the shipped binary exist, but the source behind them is missing from history and the tag cannot be rebuilt. Use when cutting a release, when writing or reviewing a release/publish script, or when a tag's tree does not match what shipped. Covers the clean-tracked-tree pre-flight check (allow untracked strays, block modified/staged tracked files), the commit-source-then-release ordering, and how to recover an already-orphaned release by committing the source as-is before fixing forward. Triggers on release integrity, orphaned source, tag cannot rebuild, release commit only version files, commit before release, reproducible release, release script guard.

2026-06-1413

layer-aware-filmstrip-compositing

Vybecode-LTD/stripkit

Composite a control filmstrip (sprite sheet) from layers: a static body plus a separately-animated overlay (a rotating pointer, a sliding cap, an opacity-ramped glow), so only the moving part transforms while the body stays crisp and re-renderable at any size. Use when building or extending a filmstrip / knob / sprite generator (e.g. StripKit), when a baked single-image knob looks soft or can't be re-skinned, or when adding a base+pointer or layered PSD/SVG input mode. Covers the render-lib-free layer model (behaviour + per-layer pivot), contain-fit + supersample-once compositing, the N-1 per-frame angle law, the pivot-is-the-knob-axis-not-the-overlay-centre rule, and gating so empty layers stay byte-identical to single-source output. Triggers on layered knob, base plus pointer, only the pointer rotates, layer-aware animation, filmstrip compositing, sprite-sheet layers, pointer pivot, per-layer behaviour.

2026-06-0513

avalonia-drag-drop-files

Vybecode-LTD/stripkit

Wire file drag-and-drop into an Avalonia 11 view so users can drop files onto a window or control. Use when adding a drop a file here zone to an Avalonia app, when a drop handler never fires, when migrating from Avalonia 10 drag-drop, when reading the local paths of dropped files, when filtering dropped files by extension, or when showing visual feedback while dragging over a target. Covers enabling AllowDrop, handling the DragOver and Drop routed events, why DragOver must set DragEffects or Drop will not fire, reading dropped items via DataFormats.Files and IStorageItem.TryGetLocalPath (replacing the removed FileNames API), handling multiple files, and delegating to the view model so logic stays out of code-behind. Triggers on Avalonia drag and drop, drop files, AllowDrop, DragDrop.DropEvent, DragOver, DataFormats.Files, GetFiles, TryGetLocalPath, drop handler not firing, drag drop not working, drop a file onto the window.

2026-06-0313

avalonia-skia-interop

Vybecode-LTD/stripkit

Render with SkiaSharp inside an Avalonia 11 app and move pixels between SkiaSharp and Avalonia correctly. Use when drawing custom visuals on the Avalonia Skia canvas, when an SKBitmap or SKImage must be shown in an Image control, when building a live preview that updates many times per second, when rotated or scaled images look jagged, when colours look wrong or edges show dark fringing, or when a heavy render blocks the UI thread. Covers the ICustomDrawOperation lease pattern for zero-copy drawing, SKBitmap to Avalonia Bitmap via PNG round-trip versus a reused WriteableBitmap pixel copy, SkiaSharp 3.x SKSamplingOptions and supersampling, premultiplied-alpha and Bgra8888 versus Rgba8888 matching, disposal, and off-thread rendering. Triggers on SkiaSharp Avalonia, SKBitmap to Bitmap, WriteableBitmap, ICustomDrawOperation, SKSamplingOptions, premultiplied alpha, jagged rotation, render off UI thread.

2026-06-0313

filmstrip-importer-engine

Vybecode-LTD/stripkit

Detect the frame layout of an existing control filmstrip (sprite sheet) and split, re-slice, or re-stack it. Use when importing a KnobMan export or a purchased plugin-asset pack, when you have a filmstrip PNG of unknown frame count, when extracting a single frame from a strip, when converting a vertical strip to horizontal or changing frame count, or when adding a filmstrip importer to a tool like StripKit. Covers the frame-count detection algorithm (test plausible counts, height or width divisibility, aspect-ratio classification into knob vs vertical fader vs horizontal slider), confidence and ambiguity handling, single-frame extraction, and clean re-export. Triggers on filmstrip import, sprite sheet detect frames, KnobMan strip, how many frames, frame count detection, split filmstrip, re-slice filmstrip, extract one frame, knob strip, fader strip, purchased asset pack, detect frame height.

2026-06-0313

image-regression-testing

Vybecode-LTD/stripkit

Lock down the pixel output of rendering code with golden-image (snapshot) tests and perceptual diffing, so a refactor cannot silently change what gets drawn. Use when testing a renderer, an image exporter, a thumbnail or chart generator, a filmstrip or sprite tool, or any code whose output is an image, when a change altered output and you must catch it, when deciding how to store and update baselines, or when pixel comparisons go flaky on anti-aliasing or platform differences. Covers capturing a baseline PNG, tolerant pixel diff with a per-pixel and fraction budget, determinism tips, baseline storage and an approve-baseline workflow, and emitting a visual diff on failure. Triggers on golden image test, snapshot test image, visual regression, pixel diff, image comparison test, baseline image, perceptual diff, SSIM, render output changed, anti-alias tolerance.

2026-06-0313

name

plugin-asset-manifest

description

Plugin Asset Manifest

A filmstrip on disk is useless to a skinning engine until something tells it which parameter the strip drives, how many frames it has, and where it sits in the GUI. A manifest is that contract: one JSON file the engine reads to load and bind every control, with no hard-coded paths or pixel positions in the C++.

Core principle

The engine should be data-driven: it reads skin.json, loads each declared asset, and binds it to a parameter by id. Adding or restyling a control becomes a manifest edit plus a new PNG — not a recompile. Keep all paths relative to the manifest, declare HiDPI variants explicitly, and version the manifest so a newer skin can refuse to load on an older host instead of crashing.

Schema

Top-level keys describe the skin; controls is an array of bindings.

Field	Meaning
`manifestVersion`	Integer. Bump on breaking changes; the loader checks it.
`name`, `author`, `skinVersion`	Human metadata.
`baseWidth`, `baseHeight`	Design resolution the `bounds` are authored against.
`background`	Optional whole-window background image (relative path).
`controls[]`	One entry per control (see below).

Each control:

Field	Meaning
`id`	Unique control id within the skin.
`type`	`knob` \| `vfader` \| `hslider` \| `button` \| `meter`.
`parameterId`	The host/APVTS parameter id this control reads and writes.
`asset`	Relative path to the 1x filmstrip PNG.
`asset2x`	Optional relative path to the @2x PNG for HiDPI displays.
`frames`	Frame count in the strip.
`frameWidth`, `frameHeight`	One frame's 1x pixel size.
`stack`	`vertical` \| `horizontal` — frame layout in the PNG.
`layout`	Optional. Absent = a single Stack-direction strip; `"grid"` = an R×C sprite atlas.
`gridColumns`	Present only when `layout` is `"grid"` — column count; rows = `ceil(frames / gridColumns)`.
`bounds`	`{ x, y, w, h }` in base-resolution pixels.
`background`	Optional per-control static layer drawn behind the strip.
`valueMin`, `valueMax`, `valueDefault`	Parameter range mapping (optional; many hosts already normalize).

Conventions (do not break)

Relative paths only. Resolve every asset relative to the manifest's folder so the skin is portable and embeddable as BinaryData.
Transparent RGBA frames. The control's background is the manifest background/per-control background; the strip draws only the control.
Vertical stack, frame 0 = minimum. Match what the exporter produced.
HiDPI by naming. Ship asset2x (e.g. gain_64.png + gain_64@2x.png); the loader picks by display scale, never by guessing.
bounds are in base resolution. The loader scales them by the actual display/window scale — do not bake device pixels into the manifest.
frames must match the PNG. A mismatch shows the wrong frame; validate on load (png_height / frames == frameHeight for a vertical strip).

JSON Schema (draft)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["manifestVersion", "name", "baseWidth", "baseHeight", "controls"],
  "properties": {
    "manifestVersion": { "type": "integer", "minimum": 1 },
    "name": { "type": "string" },
    "author": { "type": "string" },
    "skinVersion": { "type": "string" },
    "baseWidth": { "type": "integer", "minimum": 1 },
    "baseHeight": { "type": "integer", "minimum": 1 },
    "background": { "type": "string" },
    "controls": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["id", "type", "parameterId", "asset", "frames",
                     "frameWidth", "frameHeight", "bounds"],
        "properties": {
          "id": { "type": "string" },
          "type": { "enum": ["knob", "vfader", "hslider", "button", "meter"] },
          "parameterId": { "type": "string" },
          "asset": { "type": "string" },
          "asset2x": { "type": "string" },
          "frames": { "type": "integer", "minimum": 1 },
          "frameWidth": { "type": "integer", "minimum": 1 },
          "frameHeight": { "type": "integer", "minimum": 1 },
          "stack": { "enum": ["vertical", "horizontal"], "default": "vertical" },
          "layout": { "enum": ["grid"] },
          "gridColumns": { "type": "integer", "minimum": 1 },
          "background": { "type": "string" },
          "bounds": {
            "type": "object",
            "required": ["x", "y", "w", "h"],
            "properties": {
              "x": { "type": "number" }, "y": { "type": "number" },
              "w": { "type": "number" }, "h": { "type": "number" }
            }
          },
          "valueMin": { "type": "number" },
          "valueMax": { "type": "number" },
          "valueDefault": { "type": "number" }
        }
      }
    }
  }
}

Worked example

{
  "manifestVersion": 1,
  "name": "Petrol Synth Skin",
  "author": "Vibrant Mindz",
  "skinVersion": "1.0.0",
  "baseWidth": 800,
  "baseHeight": 480,
  "background": "bg/panel.png",
  "controls": [
    {
      "id": "cutoff",
      "type": "knob",
      "parameterId": "filterCutoff",
      "asset": "knobs/big_64.png",
      "asset2x": "knobs/big_64@2x.png",
      "frames": 64,
      "frameWidth": 80,
      "frameHeight": 80,
      "stack": "vertical",
      "bounds": { "x": 120, "y": 90, "w": 80, "h": 80 }
    },
    {
      "id": "level",
      "type": "vfader",
      "parameterId": "outputGain",
      "asset": "faders/cap_64.png",
      "frames": 64,
      "frameWidth": 40,
      "frameHeight": 128,
      "stack": "vertical",
      "background": "faders/track.png",
      "bounds": { "x": 700, "y": 60, "w": 40, "h": 128 }
    }
  ]
}

How a loader consumes it

For a control bound to a parameter whose normalized value is value01 in [0,1]:

frameIndex = round(value01 * (frames - 1))     // (frames-1): last frame = max
srcRect    = vertical ? (0, frameIndex*frameHeight, frameWidth, frameHeight)
                      : (frameIndex*frameWidth, 0, frameWidth, frameHeight)
drawScale  = displayScale                        // 1x asset on a 2x display => 0.5 source-to-dest, or load asset2x

When layout is "grid", ignore stack and index by column/row instead:

col     = frameIndex % gridColumns
row     = frameIndex / gridColumns             // integer division
srcRect = (col*frameWidth, row*frameHeight, frameWidth, frameHeight)

A JUCE LookAndFeel reads the manifest once at construction, loads each asset (from BinaryData or file), and in drawRotarySlider / drawLinearSlider blits srcRect into the control's scaled bounds. Pick asset2x when Desktop::getInstance().getDisplays().getPrimaryDisplay()->scale >= 2.

Anti-patterns

Absolute paths — the skin breaks the moment it moves or is embedded.
Baking device pixels into bounds instead of base-resolution + scale.
Omitting manifestVersion — an old loader then silently mis-reads a new skin.
frames that disagrees with the PNG height — every control shows wrong frames.
Flattened/opaque assets — the control paints a visible rectangle.
Shipping only asset and stretching it on Retina instead of providing asset2x.