Photopea 埋め込みエディタースキル
ウェブサイトとアプリでの photopea.js (yikuansun/PhotopeaAPI) の使用
このスキルを使用するタイミング
このスキルは、以下を含むすべてのタスクに使用します:
- Photopea を画像エディターとしてウェブページやウェブアプリに埋め込む
- JavaScript コードから埋め込まれた Photopea インスタンスを制御する
- ホストページからの画像編集ワークフローを自動化する(ファイルを開く、スクリプトを実行する、結果をエクスポートする)
- Photopea をエンジンとして使用して、製品に画像編集機能を構築する
- ドキュメント、レイヤー、テキスト、選択範囲、フィルター、色、パスを操作するスクリプトを作成する
生の postMessage を配線せず、必ず photopea.js をラッパーとして使用してください。
ライブラリ: photopea.js
photopea.js は、Photopea ライブメッセージング API をラップする Promise ベースの JavaScript ラッパーです。
リポジトリ: https://github.com/yikuansun/PhotopeaAPI
npm パッケージ: https://www.npmjs.com/package/photopea
インストール
CDN(ビルドステップ不要)
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/photopea.min.js"></script>
セルフホスト
<script src="./photopea.min.js"></script>
npm (Webpack / Vite / Rollup)
npm install photopea
import Photopea from "photopea";
コア API: Photopea クラス
| メソッド | 説明 |
|---|---|
Photopea.createEmbed(container) | iframe を作成して挿入し、準備ができたら解決する |
new Photopea(window.parent) | プラグインモード: 親ウィンドウをラップする |
pea.runScript(script) | Photopea 内で JS 文字列を実行し、出力配列を返す |
pea.loadAsset(arrayBuffer) | バイナリファイル(画像、フォント、ブラシなど)を読み込む |
pea.openFromURL(url, asSmart) | リモート URL を新しいドキュメントまたはスマートオブジェクトレイヤーとして開く |
pea.exportImage(type) | 現在のドキュメントをエクスポートし、Blob("png" または "jpg")を返す |
すべてのメソッドは Promise を返します。常に await または .then() を使用してください。
ステップ 1 — 埋め込み
コンテナ <div> は、createEmbed を呼び出す前に、固定の幅と高さを持っている必要があります。
<div id="editor" style="width:1000px; height:650px;"></div>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/photopea.min.js"></script>
<script>
Photopea.createEmbed(document.getElementById("editor")).then(async (pea) => {
// pea の準備完了
});
</script>
React:
import { useEffect, useRef } from "react";
import Photopea from "photopea";
export default function Editor() {
const containerRef = useRef(null);
const peaRef = useRef(null);
useEffect(() => {
if (!containerRef.current || peaRef.current) return;
Photopea.createEmbed(containerRef.current).then((pea) => {
peaRef.current = pea;
});
}, []);
return <div ref={containerRef} style={{ width: "100%", height: "650px" }} />;
}
ステップ 2 — ファイルを開く
// リモート URL → 新しいドキュメント
await pea.openFromURL("https://example.com/design.psd", false);
// リモート URL → 現在のドキュメント内のスマートオブジェクトレイヤー
await pea.openFromURL("https://example.com/overlay.png", true);
// ローカルファイル(ユーザー入力 → ArrayBuffer → loadAsset)
document.getElementById("fileInput").addEventListener("change", async (e) => {
const buf = await e.target.files[0].arrayBuffer();
await pea.loadAsset(buf);
});
// runScript 経由の Base64 データ URI
await pea.runScript(`app.open("data:image/png;base64,iVBORw0...");`);
ステップ 3 — スクリプトの実行
runScript は JS 文字列を送信し、app.echoToOE(...) の値の配列と最後の "done" を返します。
const result = await pea.runScript(`app.echoToOE("hello");`);
// result → ["hello", "done"]
// 構造化データを返す
const out = await pea.runScript(`
app.echoToOE(JSON.stringify({
width: app.activeDocument.width,
height: app.activeDocument.height,
layers: app.activeDocument.layers.length
}));
`);
const info = JSON.parse(out[0]);
ステップ 4 — エクスポート
// PNG Blob (exportImage 経由)
const blob = await pea.exportImage("png");
document.getElementById("preview").src = URL.createObjectURL(blob);
// JPEG Blob
const blob = await pea.exportImage("jpg");
// saveToOE 経由の WebP / PSD / 品質指定 JPEG
const result = await pea.runScript(`app.activeDocument.saveToOE("webp:0.85");`);
const webpBlob = new Blob([result[0]], { type: "image/webp" });
const result = await pea.runScript(`app.activeDocument.saveToOE("psd:true");`);
const psdBlob = new Blob([result[0]], { type: "application/octet-stream" });
// ダウンロードをトリガー
async function download(pea, filename = "export.png") {
const blob = await pea.exportImage("png");
const a = Object.assign(document.createElement("a"), {
href: URL.createObjectURL(blob),
download: filename
});
a.click();
}
saveToOE のエクスポート形式文字列:
| 文字列 | 形式 |
|---|---|
"png" | PNG ロスレス |
"jpg" | JPEG デフォルト |
"jpg:0.8" | JPEG 品質 0.0–1.0 |
"webp:0.7" | WebP 品質 0.0–1.0 |
"psd" | 完全な PSD |
"psd:true" | 最小化された PSD |
"svg:true" | SVG |
ステップ 5 — アセットの読み込み
// フォント
const buf = await (await fetch("https://example.com/MyFont.otf")).arrayBuffer();
await pea.loadAsset(buf);
// これで textItem.font で使用可能
// ブラシ
await pea.loadAsset(await (await fetch("Nature.ABR")).arrayBuffer());
// グラデーション
await pea.loadAsset(await (await fetch("Gradients.GRD")).arrayBuffer());
ステップ 6 — プラグインモード
// あなたのページが Photopea のサイドバー iframe 内にある場合
const pea = new Photopea(window.parent);
const out = await pea.runScript(`app.echoToOE(app.activeDocument.width);`);
console.log("Width:", out[0]);
// プラグインからアセットを読み込む
const buf = await (await fetch("https://my-assets.com/sticker.png")).arrayBuffer();
await pea.loadAsset(buf);
プラグイン設定:
{
"environment": {
"plugins": [{
"name": "My Plugin",
"url": "https://my-plugin.example.com",
"icon": "===https://my-plugin.example.com/icon.png"
}]
}
}
ユーティリティパターン
addImageAndWait — 堅牢な非同期レイヤー挿入
async function addImageAndWait(pea, imgURI) {
let count = "done";
while (count === "done")
count = (await pea.runScript(`app.echoToOE(app.activeDocument.layers.length)`))[0];
count = parseInt(count);
const imageUrlLiteral = JSON.stringify(imgURI);
await pea.runScript(`app.open(${imageUrlLiteral}, null, true);`);
return new Promise((resolve) => {
const check = async () => {
const n = parseInt((await pea.runScript(
`app.echoToOE(app.activeDocument.layers.length)`
))[0]);
n === count + 1 ? resolve() : setTimeout(check, 50);
};
check();
});
}
getDocumentAsImage — <img> 要素を返す
async function getDocumentAsImage(pea) {
const result = await pea.runScript(`app.activeDocument.saveToOE('png')`);
return new Promise((resolve) => {
const fr = new FileReader();
fr.addEventListener("load", (e) => {
const img = new Image(); img.src = e.target.result; resolve(img);
});
fr.readAsDataURL(new Blob([result[0]], { type: "image/png" }));
});
}
実世界のパターン
パターン A — オープン + エクスポート UI
<input type="file" id="fileInput" accept="image/*,.psd">
<button id="exportBtn">PNG エクスポート</button>
<div id="editor" style="width:100%;height:600px;"></div>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/photopea.min.js"></script>
<script>
let pea;
Photopea.createEmbed(document.getElementById("editor")).then(p => pea = p);
document.getElementById("fileInput").addEventListener("change", async e => {
await pea.loadAsset(await e.target.files[0].arrayBuffer());
});
document.getElementById("exportBtn").addEventListener("click", async () => {
const blob = await pea.exportImage("png");
const a = Object.assign(document.createElement("a"), {
href: URL.createObjectURL(blob), download: "export.png"
});
a.click();
});
</script>
パターン B — テンプレート + テキスト編集 + エクスポート
async function generateCard(pea, name, tagline) {
await pea.openFromURL("https://example.com/card.psd", false);
const nameLiteral = JSON.stringify(name);
const taglineLiteral = JSON.stringify(tagline);
await pea.runScript(`
app.activeDocument.layers.getByName("Name").textItem.contents = ${nameLiteral};
app.activeDocument.layers.getByName("Tagline").textItem.contents = ${taglineLiteral};
`);
return await pea.exportImage("png");
}
パターン C — バッチ透かし
async function batchWatermark(pea, imageURLs, watermarkURL) {
const results = [];
for (const url of imageURLs) {
await pea.openFromURL(url, false);
await pea.openFromURL(watermarkURL, true);
await pea.runScript(`
var doc = app.activeDocument, wm = doc.activeLayer;
wm.translate(doc.width - wm.bounds[2] - 20, doc.height - wm.bounds[3] - 20);
wm.opacity = 70;
`);
results.push(await pea.exportImage("png"));
await pea.runScript(`app.activeDocument.close(SaveOptions.DONOTSAVECHANGES);`);
}
return results;
}
完全なスクリプティング API リファレンス
このセクションのすべてのコードは、
pea.runScript("...")文字列内で実行されます。 Photopea は、Adobe Photoshop CC 2015 JavaScript スクリプティングインターフェースを実装しています。 そのバージョンをターゲットにした Photoshop スクリプトは、Photopea で動作するはずです。
app — アプリケーションオブジェクト
プロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
app.activeDocument | Document | R/W | 現在アクティブなドキュメント |
app.documents | Documents | R | 開いているすべてのドキュメントのコレクション |
app.documents.length | number | R | 開いているドキュメントの数 |
app.documents[i] | Document | R | 0 から始まるインデックスでアクセス |
app.foregroundColor | SolidColor | R/W | 現在の前景色 |
app.backgroundColor | SolidColor | R/W | 現在の背景色 |
app.preferences.rulerUnits | Units | R/W | Units.PIXELS, Units.CM, Units.INCHES, Units.MM, Units.PICAS, Units.POINTS, Units.PERCENT |
app.preferences.typeUnits | TypeUnits | R/W | TypeUnits.PIXELS, TypeUnits.MM, TypeUnits.POINTS |
app.displayDialogs | DialogModes | R/W | DialogModes.NO, DialogModes.ALL, DialogModes.ERROR |
メソッド
| メソッド | 説明 |
|---|---|
app.open(url) | URL を新しいドキュメントとして開く |
app.open(url, null, true) | URL をアクティブなドキュメントのスマートオブジェクトレイヤーとして開く |
app.echoToOE(string) | Photopea 拡張 — ホストページに文字列を送信する(runScript でキャプチャされる) |
app.showWindow("magiccut") | Photopea 拡張 — マジックカットパネルを開く |
app.showWindow("vbitmap") | Photopea 拡張 — ビットマップベクトル化パネルを開く |
app.UI.zoomIn() | ズームイン |
app.UI.zoomOut() | ズームアウト |
app.UI.fitTheArea() | キャンバスをビューポートに合わせる |
app.UI.pixelToPixel() | 100% ズーム |
app.UI.switchFullscreen() | フルスクリーンの切り替え |
app.UI.scroll(dx, dy) | デルタ値でスクロール |
app.UI.scrollTo(x, y) | 絶対位置にスクロール |
重要: ピクセル測定を使用するスクリプトの先頭で、常にルーラーの単位をピクセルに設定してください:
var savedUnits = app.preferences.rulerUnits;
app.preferences.rulerUnits = Units.PIXELS;
// ... あなたのコード ...
app.preferences.rulerUnits = savedUnits;
Document — ドキュメントオブジェクト
app.activeDocument または app.documents[i] でアクセスします。
プロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
width | number | R | 現在のルーラー単位でのドキュメントの幅 |
height | number | R | 現在のルーラー単位でのドキュメントの高さ |
resolution | number | R | DPI (1 インチあたりのピクセル数) |
name | string | R/W | Photopea 拡張 — 表示ラベル(履歴ステップなし) |
source | string | R/W | Photopea 拡張 — ファイルの起点 URL または "local,X,NAME" |
mode | DocumentMode | R | DocumentMode.RGB, GRAYSCALE, CMYK, LAB, BITMAP, INDEXEDCOLOR, MULTICHANNEL |
bitsPerChannel | BitsPerChannelType | R | BitsPerChannelType.EIGHT, SIXTEEN, THIRTYTWO |
colorProfileName | string | R | 埋め込まれたカラープロファイルの名前 |
activeLayer | Layer/ArtLayer/LayerSet | R/W | レイヤーをアクティブにするために設定する |
currentLayer | ArtLayer | R/W | activeLayer のエイリアス |
layers | Layers | R | すべてのトップレベルレイヤー(アート + グループの両方) |
artLayers | ArtLayers | R | トップレベルのアートレイヤーのみ |
layerSets | LayerSets | R | トップレベルのグループレイヤーのみ |
selection | Selection | R | 現在の選択範囲 |
channels | Channels | R | すべてのチャンネル |
historyStates | HistoryStates | R | 元に戻す履歴 |
activeHistoryState | HistoryState | R/W | 現在の履歴位置 |
layerComps | LayerComps | R | レイヤーコンポのコレクション |
guides | Guides | R | ガイドのコレクション |
pathItems | PathItems | R | ベクトルパス |
id | number | R | 一意のドキュメント ID |
saved | boolean | R | ドキュメントに未保存の変更があるかどうか |
quickMaskMode | boolean | R | クイックマスクモードかどうか |
backgroundLayer | ArtLayer | R | 背景レイヤー |
pixelAspectRatio | number | R | カスタムピクセルアスペクト比 (0.1–10.0) |
histogram | array | R | 256 要素のヒストグラム配列 |
メソッド
| メソッド | シグネチャ | 説明 |
|---|---|---|
resizeImage | (w, h, res, resampleMethod) | 画像ピクセルをリサイズします。ResampleMethod: BICUBIC, BILINEAR, NEARESTNEIGHBOR, NONE, BICUBICSHARPER, BICUBICSMOOTHER |
resizeCanvas | (w, h, anchor) | キャンバスをスケーリングせずにリサイズします。AnchorPosition: TOPLEFT, TOPCENTER, TOPRIGHT, MIDDLELEFT, MIDDLECENTER, MIDDLERIGHT, BOTTOMLEFT, BOTTOMCENTER, BOTTOMRIGHT |
rotateCanvas | (degrees) | キャンバス全体を回転します。正の値 = 時計回り |
flipCanvas | (direction) | Direction.HORIZONTAL または Direction.VERTICAL |
crop | ([x1,y1,x2,y2], angle, w, h) | キャンバスを切り抜きます。角度と寸法はオプションです |
trim | (trimType, top, left, bottom, right) | 透明ピクセルまたは特定の色に基づいてキャンバスをトリミングします |
close | (saveOptions) | ドキュメントを閉じます。SaveOptions.DONOTSAVECHANGES, SAVECHANGES, PROMPTTOSAVECHANGES |
saveToOE | (formatString) | Photopea 拡張 — ファイルをエクスポートし、ArrayBuffer を返します(runScript 経由) |
flatten | () | すべてのレイヤーを平坦化します |
mergeVisibleLayers | () | 表示されているレイヤーをマージします |
duplicate | () | ドキュメントのコピーを作成します |
link | (targetDoc) | このドキュメントをもう一方にリンクします(リンクされたレイヤー編集用) |
suspendHistory | (name, script) | 単一の元に戻す履歴ステップとしてスクリプトを実行します |
changeMode | (changeMode) | ChangeMode.CMYK, GRAYSCALE, BITMAP, INDEXEDCOLOR, MULTICHANNEL, RGB, LAB |
convertProfile | (destination, intent, blackPointComp, dither) | カラープロファイルを変換します |
paste | () | クリップボードの内容を新しいレイヤーとして貼り付けます |
mergeAllLayers | () | すべてのレイヤーを 1 つに結合します |
Layer — レイヤーオブジェクト
app.activeDocument.layers[i]、artLayers[i]、または layerSets[i] 経由でアクセスします。
プロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
name | string | R/W | レイヤー名 |
visible | boolean | R/W | 表示/非表示 |
opacity | number | R/W | 不透明度 (0–100) |
blendMode | BlendMode | R/W | ブレンドモード: NORMAL, MULTIPLY, SCREEN, OVERLAY, DIFFERENCE, LIGHTEN, DARKEN, HUE, COLOR, LUMINOSITY, SATURATION, COLORDODGE, COLORBURN, SOFTLIGHT, HARDLIGHT, PINLIGHT, VIVIDLIGHT, LINEARDODGE, LINEARBURN, HARDMIX, LINEARLIGHT, DARKERCOLOR, LIGHTERCOLOR, DIVIDE, SUBTRACT, PASSTHROUGH |
bounds | array | R | 境界ボックス [x1, y1, x2, y2] (ピクセル単位) |
linkedLayers | Layers | R | リンクされたレイヤー |
parent | LayerSet | R | 親レイヤーセット(トップレベルレイヤーの場合は null) |
grouped | boolean | R/W | クリッピングマスク内でグループ化されているかどうか |
allLocked | boolean | R/W | すべてのロック |
pixelsLocked | boolean | R/W | ピクセルロック |
positionLocked | boolean | R/W | 位置ロック |
transparentPixelsLocked | boolean | R/W | 透明ピクセルロック |
isBackgroundLayer | boolean | R | 背景レイヤーかどうか |
id | number | R | 一意のレイヤー ID |
layerMaskEnabled | boolean | R/W | レイヤーマスクが有効かどうか |
vectorMaskEnabled | boolean | R/W | ベクトルマスクが有効かどうか |
メソッド (レイヤー)
| メソッド | シグネチャ | 説明 |
|---|---|---|
remove | () | レイヤーを削除します |
duplicate | (destDoc, name) | このドキュメントまたは別のドキュメントにレイヤーを複製します |
move | (destDoc, ElementPlacement) | レイヤーを別の場所に移動します。ElementPlacement.PLACEATBEGINNING, PLACEATEND, PLACEBEFORE, PLACEAFTER |
resize | (horiz, vert, anchor) | レイヤーをパーセンテージでリサイズします(例: resize(150, 150) = 150%) |
rotate | (angle, anchor) | 度単位で回転します |
translate | (dx, dy) | 指定されたピクセル数だけ移動します |
scale | (relH, relV, anchor) | resize のエイリアス |
flip | (direction) | Direction.HORIZONTAL または Direction.VERTICAL |
adjustFillOpacity | (percent) | 塗りの不透明度をパーセンテージで調整します |
link | (layer) | 別のレイヤーにリンクします |
unlink | () | すべてのリンクを解除します |
applyGroup | (name) | 選択したレイヤーを新しいグループにグループ化します |
merge | () | 下のレイヤーとマージします |
createMask | (maskType) | MaskType.USERSAVE, VECTORSAVE, HIDESELECTION, REVEALALL, HIDEALL, REVEALSELECTION |
enableOtherLayers | () | 他のすべてのレイヤーを非表示にします |
isAnyLocked | () | 何かがロックされている場合は true を返します |
ArtLayer — アートレイヤーオブジェクト
Document のすべてのプロパティに加えて:
プロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
kind | LayerKind | R/W | NORMAL, TEXT, SMARTOBJECT, CLIPBOARD, PATTERN, GRADIENT, BRUSHSTROKE |
textItem | TextItem | R/W | テキストレイヤーのテキストプロパティ |
fillMethod | FillMethod | R/W | SOLIDCOLOR, GRADIENT, PATTERN |
fillForeground | SolidColor | R | 塗りの前景色 |
fillBackground | SolidColor | R | 塗りの背景色 |
strokeMethod | StrokeMethod | R/W | STROKEFILL、GRADIENT、PATTERN |
strokePosition | StrokePosition | R/W | INSIDEFRAME, OUTSIDEFRAME, CENTERFRAME |
strokeWeight | Point | R/W | ストロークの太さ |
strokeColor | SolidColor | R/W | ストロークの色 |
strokeOverPrint | boolean | R/W | オーバープリント |
adjustments | object | R/W | 調整レイヤーの設定(タイプ固有) |
adjustments のキー(調整レイヤー)
| プロパティ | 型 | 説明 |
|---|---|---|
brightness | number | 明るさ (-150–150) |
contrast | number | コントラスト (-50–100) |
hue | number | 色相 (-180–180) |
saturation | number | 彩度 (-100–100) |
lightness | number | 明度 (-100–100) |
levelInput | number[] | レベル入力 [shadow, gamma, highlight] (0–255) |
levelOutput | number[] | レベル出力 [min, max] (0–255) |
curves | number[][] | [[input, output], ...] |
invert | boolean | 反転 |
threshold | number | しきい値 (0–255) |
posterize | number | ポスタリゼーション (2–255) |
channelMixer | object | チャンネルミキサーの設定 |
colorBalance | number[] | カラーバランス [shadow, midtone, highlight] |
photoFilter | object | 写真フィルターの設定 |
exposure | number | 露出 |
offset | number | オフセット |
gammaCorrection | number | ガンマ補正 |
blackAndWhite | object | 白黒ミキサーの設定 |
gradientMap | object | グラデーションマップの設定 |
selectiveColor | object | 特定色域の選択の設定 |
vibrance | object | ビビッドの設定 |
hdrToning | object | HDR トーニングの設定 |
matchingColor | object | カラーマッチの設定 |
replaceColor | object | 色の置き換えの設定 |
LayerSet — レイヤーグループ
Layer のすべてのプロパティに加えて:
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
layers | Layers | R | このグループ内のすべてのレイヤー |
artLayers | ArtLayers | R | このグループ内のアートレイヤーのみ |
layerSets | LayerSets | R | ネストされたグループ |
enabledChannels | ChannelType[] | R/W | ['RGB', 'RED', ...] |
TextItem — テキストレイヤーのプロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
contents | string | R/W | テキストの内容 |
font | string | R/W | フォント名(例: "ArialMT") |
size | Point | R/W | フォントサイズ(タイプ単位) |
color | SolidColor | R/W | テキストの色 |
position | array | R/W | [x, y] 位置 |
kind | TextType | R/W | TextType.PARAGRAPHTEXT または POINTTEXT |
antiAliasMethod | AntiAlias | R/W | ANTIALIASNONE, SHARP, CRISP, SMOOTH, STRONG |
autoLeading | boolean | R/W | オートカーニング |
baselineShift | number | R/W | ベースラインシフト |
characterDirection | Direction | R/W | 文字方向 |
desiredGlyphScaling | number | R/W | グリフスケーリング |
desiredLetterScaling | number | R/W | 文字間スケーリング |
desiredWordScaling | number | R/W | 単語間スケーリング |
fakeBold | boolean | R/W | 疑似太字 |
fakeItalic | boolean | R/W | 疑似斜体 |
firstLineIndent | number | R/W | 最初の行のインデント |
glyphScaling | number[] | R/W | 最小/最大グリフスケーリング |
horizontalAlignment | Justification | R/W | LEFT, CENTER, RIGHT, JUSTIFYLEFT, JUSTIFYCENTER, JUSTIFYRIGHT, FULLYJUSTIFY |
capitalization | Case | R/W | NORMAL, ALLCAPS, SMALLCAPS |
kerning | number | R/W | カーニング |
leading | number | R/W | 行送り |
letterScaling | number[] | R/W | 最小/最大文字間スケーリング |
ligature | boolean | R/W | 合字 |
lines | array | R | テキスト行 |
maximumGlyphScaling | number | R/W | 最大グリフスケーリング |
maximumLetterScaling | number | R/W | 最大文字間スケーリング |
maximumWordScaling | number | R/W | 最大単語間スケーリング |
minimumGlyphScaling | number | R/W | 最小グリフスケーリング |
minimumLetterScaling | number | R/W | 最小文字間スケーリング |
minimumWordScaling | number | R/W | 最小単語間スケーリング |
noBreak | boolean | R/W | 改行禁止 |
openTypeFeatures | OpenTypeFeatures | R/W | OpenType 機能 |
overline | boolean | R/W | 上線 |
paragraphOverflowColumn | boolean | R/W | 段落オーバーフローカラム |
spaceAfter | number | R/W | 段落後のスペース |
spaceBefore | number | R/W | 段落前のスペース |
strikeThrought | boolean | R/W | 打ち消し線 |
tateChuYoko | boolean | R/W | 縦中横 |
tracking | number | R/W | トラッキング |
tsume | number | R/W | ツメ |
underline | boolean | R/W | 下線 |
useAutoLeading | boolean | R/W | 自動行送りを使用 |
wordScaling | number[] | R/W | 最小/最大単語間スケーリング |
wrap | boolean | R/W | テキストの折り返し |
paragraphOverflowColumn | boolean | R/W | 段落オーバーフローカラム |
textComposer | TextComposer | R/W | TextComposer.ADOBE_EVERYLINE_COMPOSER または ADOBE_SINGLELINE_COMPOSER |
paragraphStyle | ParagraphStyle | R/W | 段落スタイル |
characterStyle | CharacterStyle | R/W | 文字スタイル |
Selection — 選択範囲オブジェクト
app.activeDocument.selection 経由でアクセスします。
プロパティ
| プロパティ | 型 | R/W | 説明 |
|---|---|---|---|
bounds | array | R/W | [x1, y1, x2, y2] (現在のルーラー単位) |
solid | boolean | R | 空でない選択範囲の場合は true |
length | number | R | 選択範囲内のパスの数 |
メソッド
| メソッド | シグネチャ | 説明 |
|---|---|---|
select | (region, type, feather) | 長方形 [x1,y1,x2,y2] またはパスアイテムを選択します。SelectionType.REPLACE, EXTEND, DIMINISH, INTERSECT |
selectAll | () | すべてを選択します |
deselect | () | 選択を解除します |
invert | () | 選択範囲を反転します |
contract | (by) | 選択範囲を縮小します |
expand | (by) | 選択範囲を拡大します |
feather | (radius) | 選択範囲をぼかします |
grow | (tolerance) | 許容値に基づいて選択範囲を拡大します |
smooth | (radius) | 選択範囲を滑らかにします |
similar | (tolerance) | 類似ピクセルを選択します |
load | (file, channel, invert) | チャンネルから選択範囲を読み込みます |
store | (file, channel) | 選択範囲をチャンネルに保存します |
clear | () | 選択範囲内の内容を削除します |
fill | (fillType) | FillType.FOREGROUNDCOLOR, BACKGROUNDCOLOR, BLACK, WHITE, GRAY50PERCENT, HISTORY, PATTERN, CONTENTAWARE |
stroke | (color, width, location) | 選択範囲の境界線を描画します。StrokeLocation.INSIDE, OUTSIDE, CENTER |
translate | (dx, dy) | 選択範囲を移動します |
resize | (h, v, anchor) | 選択範囲をパーセンテージでリサイズします |
rotate | (angle, anchor) | 選択範囲を回転します |
expandSelection | (radius) | expand のエイリアス |
contractSelection | (radius) | contract のエイリアス |
featherSelection | (radius) | feather のエイリアス |
SolidColor — カラーオブジェクト
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
rgb | object | {red: 0–255, green: 0–255, blue: 0–255} |
cmyk | object | {cyan: 0–100, magenta: 0–100, yellow: 0–100, black: 0–100} |
gray | object | {gray: 0–100} |
lab | object | {l: 0–100, a: -128–127, b: -128–127} |
hsl | object | Photopea 固有のプロパティ {hue: 0–360, sat: 0–100, lig: 0–100} |
hex | string | Photopea 固有のプロパティ — "#FF8800" のような 16 進文字列 |
例:
var col = new SolidColor();
col.rgb = {red: 255, green: 128, blue: 0};
app.foregroundColor = col;
フィルター (app.activeDocument.activeLayer.applyFilter)
layer.applyFilter("filterName", params);
組み込みフィルター
| フィルター名 | パラメーター |
|---|---|
"motionblur" | {distance: number, angle: number} |
"radialblur" | {amount: number, blurMethod: "spin"/"zoom", quality: "draft"/"good"/"best"} |
"blurmore" | {} |
"blur" | {} |
"gaussianblur" | {radius: number} |
"smartblur" | {radius: number, threshold: number, quality: "low"/"medium"/"high", mode: "normal"/"eedgesonly"/"overlay"} |
"lensblur" | {radius: number, brightness: number, threshold: number} |
"shapblur" | {radius: number, shape: "sqaure"/"triangle"/"circle"} |
"boxblur" | {radius: number} |
"noise" | {amount: number, distribution: "uniform"/"gaussian", monochromatic: bool} |
"despeckle" | {} |
"dustandscratch" | {radius: number, theshold: number} |
"median" | {radius: number} |
"reduceNoise" | {strength: number, preserveDetails: number, reduceColorNoise: number, sharpenDetails: number} |
"clouds" | {} |
"differenceclouds" | {} |
"lightingeffect" | {} |
"fibers" | {variance: number, strength: number} |
"lensflare" | `{brightness: number, center: {x: number, y: number}, type: "50-300mmzoom"/"35mmprime"/"105mmprime", |