README¶
概要¶
@scriptは、スクリプトからAEGPのAPIに気軽にアクセスするために開発されたAfter Effectsプラグインである。
開発背景は、 After Effectsのスクリプトの可能性を広げる。 に詳しい。
このドキュメントは例示を含め、TypeScript環境を前提としているので、適宜調べてください。
リポジトリ¶
対象¶
Win, Mac
CC2018-
導入方法¶
Releases · atarabi/at_script から @script.zip をダウンロード。
プラグインは、pluginフォルダにある@scriptプラグイン(Windowsの場合は @script.aex , Macの場合は @script.plugin )をAfter Effectsのプラグイン関係のフォルダ内にコピー。
スクリプトは、script/Startupフォルダにある !@script_initializer.jsx、 !@script_UI.jsx をAfter EffectsのStartup向けスクリプトのフォルダ内にコピー(例えば、Windows、AE2025の場合、 C:Program FilesAdobeAdobe After Effects 2025Support FilesScriptsStartup )。
後は各自使いたいスクリプトを各自script/Startupフォルダないしscript/ScriptUIフォルダからコピーする。
自身でAPIを用いたスクリプトを開発したい場合は、リポジトリをクローンし、 script フォルダをコピーし作業フォルダにし、 src フォルダ内に適当にフォルダを作成し、その中でtsxという拡張子でスクリプトファイルを作っていけばよい。
Atarabi.version¶
version: string;
v0.4.2(2024/11/14)¶
Fix¶
Windows環境で、UI.showContextMenu()において、コンテクストメニューの文字列が正常に表示されない場合があることに対する修正
UI.FuzzySearch()においてキャッシュを有効にした状態である特定の文字列を与えた場合に、配列以外が返ってくる場合があることに対する修正（@effect_launcher, @effect_search, @effect_presetなどで使用しているので、使っている方は!@script_UI.jsxを更新してください）
Script¶
@script_panel の追加
@effect_launcher にショートカット機能を追加
@effect_search で、スクリプト、プリセットを扱える機能を追加
@effect_launcher、@effect_search、@effect_preset で検索窓のデバウンスタイムを少なくした
@still_maker、 @movie_maker のブラウズボタンの挙動を改善した
v0.4.1(2024/10/22)¶
Fix¶
Compositing Options以下のプロパティの扱いでエラーが生じることに対する修正 (#7)
API¶
Property.loadCustomValue() の追加
Script¶
@proxy_maker の追加
@rpp_loader にアンドゥ処理を追加
v0.4.0(2024/06/30)¶
Fix¶
Register.importFlavor() で登録した拡張子のファイルを複数個同時に読み込んだ際に、モーダルダイアログに関するエラーが生じることに対する修正
API¶
Property.saveCustomValue() の追加
Effect['ADBE CurvesCustom'] の追加
Effect['APC Colorama'] の追加
Script¶
@svg の追加
v0.3.1(2024/05/29)¶
Fix¶
ある環境下で、API実行時にPreferencesのウインドウが表示される問題の対処 (#3)
API¶
Register.hookCommand() の引数にoptionsを追加
Register.unhookCommandAll() の追加
Script¶
@hook_solid の平面の命名規則の変更及びカラーパネルの追加 (#4)
@hook_adjustment の平面の命名規則の変更
@hook_null のリファクタリング
@swatch にツールチップを追加
v0.3.0(2024/02/13)¶
Fix¶
Windows環境で、AME起動時などDynamic Link経由でAfterFXが起動する際にStartupのスクリプトがAfterFXをクラッシュさせる問題の対処 (#1)
API¶
Atarabi.isDynamicLink() の追加
Mouse.getPosition() の追加
Mouse.hook() の追加
Mouse.unhook() の追加
Mouse.enableHook() の追加
Mouse.enableHookByUuid() の追加
Mouse.sendClick() の追加
Script¶
Dynamic Linkに関するバグに伴う、Startup系のスクリプトの修正
@effect_launcher が表示されなくなることがある問題の修正
@rpp_loader でプロジェクト内にEmpty Itemがあるときに読み込みが失敗する問題の修正
Atarabi.UI.Builder にaddCustom()を追加
@effects_in_use の追加
@swatch の追加
v0.2.0(2023/09/16)¶
API¶
App.setProjectDirty() の追加
App.saveBackgroundState() の追加
App.forceForeground() の追加
App.restoreBackgroundState() の追加
App.refreshAllWindows() の追加
App.getMainHWND() の追加
Item.touchActiveItem() の追加
Item.moveTimeStepActiveItem() の追加
Item.getFootageSoundDataFormat() の追加
Camera.getDefaultCameraDistanceToImagePlane() の追加
Camera.getFilmSize() の追加
Camera.setFilmSize() の追加
Keyboard.hook() の追加
Keyboard.unhook() の追加
Keyboard.enableHook() の追加
Keyboard.enableHookByUuid() の追加
Keyboard.sendKeys() の追加
Script¶
@script_UI を !@script_UI にリネーム
@effect_launcher の追加
@hook_] の追加
@save_to_desktop の追加
@toggle_mfr の追加