Unityマクロ

• Unityマクロ
• はじめに
• スクリーンショット
• Unityマクロのインターフェース
• Unityマクロ用語
• source（ソース）一覧
• 操作方法
• マクロの導入方法
• 動作環境
• ダウンロード
• ソースとカインドを作成する方法
• その他
• 謝辞
• 連絡先
• 寄付

はじめに

Unityマクロとは秀丸エディタ用の統合ユーザーインターフェースです。

最初に検索パターンを入力することで一致する対象（ファイル名、ウインドウ名など）を絞り込み、選択した対象を操作（開く、挿入するなど）するインターフェースを提供します。

ヒデマラー向け説明

unite.vimの秀丸エディタ版です、Emacsでいうところのanything.el的存在です。

スクリーンショット

文字列の挿入

ファイル履歴(file_mru)を検索してファイルを開く

ファイル履歴(file_mru)の削除

プロセスのkill

auto preview オプション

auto preview オプションをONにするとpreviewアクションを自動的に呼び出します。

ファイルの場合

備考

ファイルの先頭行をアウトプット枠に表示します。

ハイライト（強調表示）の場合

備考

秀丸エディタのハイライト（強調表示）を変更すると、ウインドウフォーカスが切り替わり使い勝手が悪いです。 その使いにくさを回避するため事前に手作業でウインドウを分離しました。

Unityマクロのインターフェース

Unityマクロ用語

source（ソース）

候補(candidates)を集めてくる秀丸マクロのこと。

標準のソース一覧

• directory
• directroy_mru
• directroy_recursive
• file
• file_mru
• file_recursive
• emoji
• process
• window
• など

もちろんユーザー作成のソースも自由に追加できます。

kind（カインド）

候補（candidates）の型に対応した操作(action)をまとめた秀丸マクロです。

標準のカインド一覧

• common
• file
• file_base
• cdable
• process
• window
• など

もちろんユーザー作成のカインドも自由に追加できます。

カインドは複数のactionを持っています、例えばcommonカインドは以下のアクションを持っています。

(例)
commonカインド
	nopアクション
	yancアクション
	echoアクション
	insertアクション
	  :
	  :
	など

action(アクション)

選択した候補に対して行う操作のことです。

アクションは幾つかのフラグを持っています。

• 複数の候補を選択可能か
• ユーザーが編集中のテキストを変更するか
• 操作後すぐに終了するか
• 操作後に新たな候補を生成するか
• ...など

画面の名称

二つの画面（バッファ）があります。

• 検索バッファ
• 候補バッファ

検索バッファ

検索の候補を空白区切りで入力します、候補は大文字小文字の区別をせずAND検索します。

候補バッファ

絞り込み検索した結果をリアルタイムで表示します。

さらに、アクションの対象とする候補を複数選択することができます（赤文字の行）。

source（ソース）一覧

標準のソース一覧です。

|ソース名|説明|その他| |--|--|--| |directory|カレントディレクトリの一覧|| |directory_mru|ディレクトリ履歴|| |directory_recursive|カレントディレクトリ以下のディレクトリ一覧（再帰）|候補を非同期で取得するため、ファイル数が多くてもそれなりに動きます| |emoji|絵文字（Full Emoji List, v13.0）|http://unicode.org/emoji/charts/full-emoji-list.html| |file|カレントディレクトリのファイル一覧|| |file_mru|ファイル履歴|| |file_recursive|カレントディレクトリ以下のファイル一覧（再帰）|候補を非同期で取得するため、ファイル数が多くてもそれなりに動きます| |hilight|強調表示|| |lines|編集中テキストの一行|| |mark|マーク一覧|| |outline|アウトライン枠の内容|| |process|プロセス一覧|| |everything|ファイル検索|Windowsの高速なファイル検索ソフトeverythingと、コマンドラインツールのes.exeが必要です| |tab|タブ一覧|| |window|ウインドウ一覧||

引数指定可能なソースがあります、それぞれのファイル冒頭のコメントを参照してください。

操作方法

検索バッファ

行編集が主なので概ねBashに準拠しています。

カーソル移動

|キー|説明|備考| |--|--|--| |← or Ctrl-b|カーソル左|| |→ or Ctrl-f|カーソル右|| |Home|先頭へ|| |End|最後へ||

テキスト編集

|キー|説明|備考| |--|--|--| |Del or Ctrl-d or Ctrl-Backspace|Delete|| |Ctrl-t|Transpose|| |Ctrl-k|KillLine|| |Ctrl-u|LineDiscard|| |Backspace or Ctrl-h|Backspace||

候補バッファ

|キー|説明|備考| |--|--|--| |↑|前候補へ移動|| |↓|次候補へ移動|| |PageUp|１ページ前へ移動|| |PageDown|１ページ後ろへ移動|| |Ctrl-space|候補をマークする|複数の候補を選択するとき利用します| |Ctrl-a|候補を全て選択する|| |Enter|ディフォルトアクションを実行する|| |Esc|一つ前のバッファに戻る||

共通

|キー|説明|備考| |--|--|--| |Ctrl-w|タブを分離する|タブモード時のみ有効。auto-previewと組み合わせると便利| |Ctrl-c or Ctrl-q|マクロを終了する||

マクロの導入方法

まずは、動作確認を行った安定バージョンをダウンロードして下さい。

https://github.com/ohtorii/unity/releases

masterブランチは動作確認を行っていないため動作しないです。（仕事じゃないので気楽に開発してます☺）

ディレクトリ構成

全ファイルとフォルダを秀丸エディタのスクリプトディレクトリにコピーしてください。

コピー後のディレクトリ構成

hidemaru-editor-script-directory
 └unity
    ├─help
    ├─internal
    ├─kinds
    └─sources

依存DLLのインストール

本マクロを動かすには以下のDLLが必要です、それぞれダウンロードして導入してください。

• 田楽DLL 32bit
• 田楽DLL 64bit

32bitと64bit版があります、適切なDLLを導入してください。導入方法はそれぞれのドキュメントを参照しください。

補足

田楽DLLとはGUI表示などを行うDLLです。

ショートカットキー

unity_dialog.mac をショートカットキーに割り当てて下さい。

（例）

• Ctrl-@
• Ctrl-:
• Ctrl-;
• Ctrl-.
• Ctrl-/

コマンド実行っぽいキーを列挙してみました。

unity_dialog.macを起動する

ショートカットキーを押下してunity_dialog.mac を起動すると、

↑こんなダイアログが開きます。

ソース(file_mruとかprocessとか)を選んでEnterキーを押下すると絞り込み検索が始まります😙

いろいろな方法でUnityマクロを呼び出す

以下の表からご自身の都合に合うマクロをショートカットキーに割り当ててご利用ください。

汎用型マクロと特化型マクロの二通りを用意しました、それぞれ数行のマクロで理解しやすいと思います。上級ヒデマラーの皆様におかれましてはカスタマイズしてお使いください。

|ファイル名|説明|ソースの複数選択|オプション指定|ソースの引数指定| |--|--|--|--|--| |unity_dialog.mac |ダイアログから複数ソースとオプションを指定可能|○|○|×| |unity_file_argument.mac |fileソースへ引数を渡す|×|×|○| |unity_file_paths.mac |ファイルパスに関するソース（file,directroy_mru,file_mru）を指定して起動|○|×|×| |unity_file_snipetts.mac.mac |default-actionを指定するスニペットのサンプル|×|○|○| |unity_menu.mac |メニューからソースを一つ選択して呼び出す。ソースを一つ選択することに特化|×|×|×| |unity_menu_manual.mac |利用頻度の高いソースをメニュー化する例|×|×|×| |unity_source_directory.mac |directroyソースを指定して起動|×|×|×| |unity_source_directory_mru.mac |directroy_mruソースを指定して起動|×|×|×| |unity_source_directory_recursive.mac |directroy_recursiveソースを指定して起動|×|×|×| |unity_source_emoji.mac |emojiソースを指定して起動|×|×|×| |unity_source_file.mac |fileソースを指定して起動|×|×|×| |unity_source_file_mru.mac |file_mruソースを指定して起動|×|×|×| |unity_source_file_recursive.mac |file_recursiveソースを指定して起動|×|×|×| |unity_source_hilight.mac |hilightソースを指定して起動|×|×|×| |unity_source_outline.mac |outlineソースを指定して起動|×|×|×| |unity_source_process.mac |processソースを指定して起動|×|×|×| |unity_source_everything.mac |everythingソースを指定して起動|×|×|Todo:次期バージョンで対応したい| |unity_source_tab.mac |tabソースを指定して起動|×|×|×| |unity_source_window.mac |windowソースを指定して起動|×|×|×|

動作環境のカスタマイズ(config.ini)

config.iniを環境毎に編集してください。

;秀丸ファイラーClassicへのパス
[hidemaru_filer_classic]
path_x64="C:\Program Files\HmFilerClassic\HmFilerClassic.exe"
path_x86="C:\Program Files (x86)\HmFilerClassic\HmFilerClassic.exe"

;引数の詳細は「秀丸ファイラーClassic　ヘルプ　→　起動時のオプション」を参照してください。
arguments="/t /select,"

;ディフォルトの動作に任せる場合
;arguments=""


;アクション固有の設定
[action]
;アクション実行後に待機する時間(ミリ秒)
;ウインドウ、ハイライトのプレビューなどから参照。
sleep=1500

通常はディフォルトのままで良いです、もし不都合あれば編集してください。

ソースのカスタマイズ(sources\everything.ini)

'es.exe'のパスを指定できます。

[paths]
;
;es.exeのパスを指定します
;
exe=%HOMEDRIVE%%HOMEPATH%\hidemaru\macro\bin\everything\es.exe
;exe=%ProgramFiles%\Everything\es.exe

動作環境

• 秀丸エディタ ver 9.15 以降

秀丸マクロの新命令を利用しているため必ず上記バージョン以降をお使いください。

動作確認を行った環境

ご参考までに。

64 bit 環境

• Windows 10 64bit
• 秀丸エディタ 64bit ver 8.91
• 田楽DLL 64bit ver Ver.3.22.1

32 bit 環境

• Windows 10 64bit
• 秀丸エディタ 32bit ver 8.91
• 田楽DLL 32bit ver Ver.3.22.1

ダウンロード

こちらから動作確認済みのパッケージをダウンロードして下さい。

https://github.com/ohtorii/unity/releases

注意

masterブランチを取得しても多分動作しないです。

ブランチを作らずに気楽に開発してます。（仕事じゃないしね😉）

バージョン番号のルール

バージョン番号の表記方法

バージョン番号は version 1.2.3 のように表記され、それぞれ major.minor.revision を表します。

|番号|説明| |--|--| |major|互換性が失われる大きな変更を表します| |minor|機能追加のように互換性のある更新を表します| |revision|バグ修正のように機能そのものに変化が無い軽微な更新を表します|

git clone で取得する場合

クローンと同時にサブモジュールもクローンするために、以下コマンドを実行してください。

git clone --recursive https://github.com/ohtorii/unity.git

サブモジュールをクローンしないと色々と動かないです😢

ソースとカインドを作成する方法

このドキュメントを参照してください。

help/extension.md

その他

ここに書き切れない情報を以下ドキュメントにまとめました。

help/README.md

謝辞

思想とソースコードをかなり参考にさせてもらいました😘😘😘

• unite.vim
• anything.el

参考書籍

• Vimテクニックバイブル
• Emacsテクニックバイブル

作者に感謝

• 田楽DLL 32bit
• 田楽DLL 64bit

連絡先

• https://ohtorii.hatenadiary.jp
• https://twitter.com/ohtorii
• https://github.com/ohtorii

寄付

もし気に入ってくれたらSteamからゲームを寄付してくれるとうれしいです😘

• https://store.steampowered.com/wishlist/id/ohtorii

開発の励みになります。