Import brush tips and textures

A resource is a tip or texture asset. A preset is a set of settings. The Codeboard brush engine executes those settings. Importing a Photoshop or Krita resource does not install its original engine.

Inspect before selecting a tipCopy Anchor Link

import { importBrushResource } from 'codeboard-studio';
const report = await importBrushResource('brushes.bundle', {
  origin: { source: 'My brush collection', license: 'CC0-1.0', redistribution: 'allowed' },
  maxTipSize: 256,
});
console.log(report.resources.map(({ id, name, role, originalWidth, originalHeight }) =>
  ({ id, name, role, originalWidth, originalHeight })));
console.log(report.presets.map(({ name, engine, resourceIds, mapped }) =>
  ({ name, engine, resourceIds, mapped })));
console.log(report.missingDependencies, report.unsupported, report.warnings);

Replace the example provenance with the resource's actual source and license. Select by reported role and identity, not by assuming the first resource is a usable tip. The report retains a checksum for the source file and each decoded resource.

Provide a linked Krita dependencyCopy Anchor Link

import { readFile } from 'node:fs/promises';
const report = await importBrushResource('pencil.kpp', {
  origin: { source: 'My pencil', license: 'CC0-1.0', redistribution: 'allowed' },
  dependencies: { 'brushes/pencil.gbr': await readFile('brushes/pencil.gbr') },
});

Dependency names must match the preset resource references. Supply the actual tip bytes, not a screenshot or the KPP preview. A BUNDLE can provide its own embedded dependencies. If a dependency remains unresolved, inspect the reported name and correct the mapping; do not substitute a default brush without deciding to reauthor the preset.

Reauthor the supported preset settingsCopy Anchor Link

import { brushes, brushFromResource, renderBrushSwatch } from 'codeboard-studio';
import { writeFile } from 'node:fs/promises';
const preset = report.presets[0];
const resource = report.resources.find(r =>
  r.role === 'tip' && (!preset || preset.resourceIds.includes(r.id)));
if (!resource) throw new Error('Selected preset has no resolved brush tip');
const brush = brushFromResource(resource, {
  ...brushes.cleanInk, ...preset?.mapped,
  id: 'brush:imported-pencil', name: 'Imported pencil', size: 36,
});
await writeFile('imported-swatch.png', await renderBrushSwatch(brush));

This explicitly chooses Codeboard settings for unmapped behavior. mapped currently contains supported spacing, opacity, and flow values when present. It is not a conversion of all foreign dynamics. Inspect both preset-level and report-level unsupported entries.

brushFromResource rejects a texture resource as a tip. Use its alpha data in paperTexture instead:

const texture = report.resources.find(r => r.role === 'texture');
if (texture) brush.paperTexture = {
  width: texture.tip.width, height: texture.tip.height,
  alpha: texture.tip.alpha, scale: 1, strength: .4,
};

Formats and limitsCopy Anchor Link

Tip import dimensions are at most 512 pixels per side. Choose maxTipSize deliberately and inspect resize warnings. The importer enforces bounded input and bundle expansion limits; a resource outside those limits fails instead of exhausting memory. An unsupported resource may produce a report without a usable tip.

For in-memory files, use importBrushResourceBuffer(bytes, filename, options); the filename supplies the format extension. Saving a project preserves the selected tip, texture, and brush settings with the artwork. Keep original foreign files separately if you need their unconverted settings.

See brush authoring for custom tips, derived presets, and version behavior.