ＰａｓＳ
アドインプログラム作成の手引き

目次

アドインプログラムの作成について……
PasS 補助データファイルの形式………
返却ファイルの形式……………………
PasS ファイルの形式 …………………
オプション設定ファイルの形式…………

Copyright © 2005〜 uaubn

１
３
４
５
６

アドインプログラムの作成について
１．必要フォルダ・ファイル構成（１）アドインプログラム格納フォルダ
アドインプログラムは、PasS の実行ファイルが入っているフォルダ下の addin フォル
ダにアドインプログラムごとにサブフォルダを作り、その中に必要なファイルを入れます。
（２）アドインプログラム必要ファイル① 実行プログラム（.exe, .com, .bat）
フォルダ名と同じ主ファイル名であることが必要です。
例）フォルダが 「Gconpass」の場合、ファイル名は「Gconpass.exe」② オプション設定ファイル（.cfg）
フォルダ名と同じ主ファイル名であることが必要です。
ない場合は、フォルダ名がアドインプログラムの名称となります。
例）フォルダが 「Gconpass」の場合、ファイル名は「Gconpass.cfg」③ アイコン（１６×１６ドット）
フォルダ名と同じ主ファイル名であることが必要です。
ない場合は、既定のアイコンとなります。
例）フォルダが 「Gconpass」の場合、ファイル名は「Gconpass.ico」

２．ＰａｓＳへのアドインプログラム登録
アドインプログラムの PasS への登録は、PasS 起動時に addin フォルダ下を検索し、自動的に行われます。したがって、アドインプログラムのセットアップは、PasS フォルダ下の addin フォルダ内に、前述したファイルをコピーすることで完了します。

３．ＰａｓＳのアドインプログラムの起動

ツールバーのアドインプログラムアイコンをクリックします。メニューからの実行も可能です。
-1-

４．ＰａｓＳのアドインプログラムの呼出
アドインプログラムの起動が選択されると、ＰａｓＳは次の形式でアドインプログラムを呼び出します。

＋

アドインプログラムのフルパス¥アドインプログラムファイル名
ＰａｓＳの処理ファイルのフルパス¥主ファイル名例）test.pas を Gconpass で処理する場合、C:¥Program Files¥PasS¥addin¥Gconpass¥Gconpass.exe "D:¥My Documents¥test"
Gconpass のﾌﾙﾊﾟｽ＋ﾌｧｲﾙ名
処理データのﾌﾙﾊﾟｽと主ﾌｧｲﾙ名
したがって、C 言語などでプログラムを組む場合は、argv[]を参照することで、自分自身の位置、処理ファイルの位置と主ファイル名を得ることができます。

５．ＰａｓＳからアドインプログラムへの情報
アドインプログラムは、（PasS ファイル：.pas、PasS 補助データファイル：.pad）の２つのファイルを参照することができます。（それぞれのファイル形式の詳細は後述）
ＰａｓＳファイルの情報
部品情報、ライン情報など
ＰａｓＳ補助データファイルの情報
部品ピン情報、ライン情報、隣接距離、ホール情報など

６．アドインプログラムからＰａｓＳへの返却情報
アドインプログラムは、処理データと同じ場所に、（PasS ファイル：̲.pas）を生成する
ことで、アドイン処理終了後、ＰａｓＳはその情報を読込みます。（返却ファイル形式の詳細は後述）
なお、返却情報ファイルは、PasS がデータ読込み後、自動的に削除します。
ＰａｓＳファイルの情報
返却メッセージ、ライン再配置情報など例）処理ファイル名が D:¥My Documents¥test.pas の場合①PasS①④test.pas

test.pad②②③test_.pas

同一フォルダ「D:¥My Documents」内-2-アドインプログラム

PasS 補助データファイルの形式
１．ファイル名
PasS ファイルの拡張子を．ｐａｄ にしたものです。

２．形式
座標は PasS 上の左上を（０，０）右下を（+X, +Y）とした、ピクセル単位の値となります（PasS は、１０ピクセルで２．５４ｍｍを表現しています。）
なお、近接物までの距離は、対象から最も近い、ライン中心線、ピン中心までの距離をピクセル値で表現しています。
2.54ｍｍピッチでの処理の場合は、７，１０，１４，２０，３０ピクセル以上の５段階の値を、1.27ｍｍピッチでの処理の場合は、3.5，５，７，１０，１５ピクセル以上の５段階の値となります。なお、ピンからの距離が 3.5 の配線に付いては、迂回処理をしたデータが引き渡されます。
配線情報は、PasS の配線情報とは異なり、ある程度まとまった直線の情報として出力しています。
補助データファイルの形式は次の通りです。なお、将来的に分類(*** で始まる内容)や一行のデータの最後尾に新しいデータ項目が追加される場合もありますので、ご注意ください。

*** Pitch 配線ピッチを記述します。
1：２．５４ｍｍピッチ または 2：１．２７ｍｍピッチ*** Type 基板の情報を記述します。
0：片面基板 または 1：両面基板*** Area 外形線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2, 裏面近接物までの距離, 表面近接物までの距離*** Parts 部品の情報を以下に記述します。
部品 No, ピン No, ピン中心座標 X, Y, 裏面近接物までの距離, 表面近接物までの距離*** ThruHole スルーホール情報を以下に記述します。
穴中心座標 X, Y,
裏面近接物までの距離, 表面近接物までの距離,*** JumperHole
穴中心座標 X, Y,穴直径（×１０ｍｍ）

片面基板の時のジャンパ線の穴情報を以下に記述します。
裏面近接物までの距離, 表面近接物までの距離*** Hole 穴情報を以下に記述します。
穴中心座標 X, Y,穴直径（×１０ｍｍ）

穴直径：3.2mm の穴の場合は 32 となります。

*** BottomLine 裏面配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2, 裏面近接物までの距離*** BottomFill 裏面の塗りつぶし情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2, ０*** TopLine 表面配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2, 表面近接物までの距離*** TopFill 表面の塗りつぶし情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2, ０-3-返却ファイルの形式
１．ファイル名
PasS ファイルの主ファイル名に＿．ｐａｓを加えたものです。

２．形式
返却ファイルの形式は、ＰａｓＳのデータファイル形式に準じますが、次の追加項目が設定されています。
３．追加項目*** Option PasS の動作を変更するオプションを以下に記述します。
Clear：現在のＰａｓＳの基板上の全ての部品・配線を削除してから、返却ファイル上の部品・配線を読み込みます。自動配置などで利用できます。
*** Message
PasS に表示させるメッセージを以下に記述します。
メッセージの内容：*** Message のエリア中に記述された内容が、PasS のメッセージとして全て表示されます。
<ERROR>：返却メッセージの背景を赤にするとともに、強制的にメッセージを表示させます。
<WARNING>：返却メッセージの背景を黄色にするとともに、強制的にメッセージを表示させます。
<ERROR>を<WARNING>が両方記述されている場合は、<ERROR>の処理を行います。記述する場所は、*** Message のエリアであればどこでもかまいませんが、一行には<ERROR>または<WARNING>のみを記入してください。<ERROR><WARNING>はメッセージには表示されません。
*** ThruHole
PasS に追加するスルーホール情報を以下に記述します。
穴中心座標 X, Y, ０
両面基板の自動配線などの処理で、裏面と表面にする−ホールを設定する場合に使用します。

-4-

PasS ファイルの形式
１．ファイル名
ファイルの主ファイル名に ．ｐａｓを加えたものです。

２．形式
座標は PasS 上の左上を（０，０）右下を（+X, +Y）とした、ピクセル単位の値となります。

*** Version 保存した PasS のヴァージョンを記述します。
保存したＰａｓＳのヴァージョン
*** Pitch 配線ピッチを記述します。
1：２．５４ｍｍピッチ または 2：１．２７ｍｍピッチ*** Board 基板のファイル名を記述します。
裏面ボードファイル名，表面ボードファイル名*** Type 基板の情報を記述します。
0：片面基板 または 1：両面基板*** Parts 部品の情報を以下に記述します。
部品ファイル名，左上座標Ｘ，Ｙ，部品幅，部品高さ，回転角度
部品番号，左上座標Ｘ，Ｙ
部品ラベル，左上座標Ｘ，Ｙ*** BottomLine 裏面配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2*** TopLine 表面配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2*** BottomJump 裏面被覆配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2*** TopJump 表面被覆配線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2*** Area 外形線の情報を以下に記述します。
配線始点座標 X1,Y1, 終点座標 X2,Y2-5-オプション設定ファイルの形式
１．ファイル名
アドインプログラムの主ファイル名に．ｃｆｇを加えたものです。

２．形式
オプション設定ファイルのの形式は、以下によります。
（１）１行目：タイトルとオプション値の設定①メニューやツールバーのボタンのツールチップテキストに表示する内容を記述します。
②オプション値
タイトルの後に，に続けて、アドインプログラムの動作オプションを設定できます。
オプションは数値により行い、オプションが複数の場合は、それぞれのオプション値の合計値を記述します。
（オプション値）
１：補助データファイルを出力する最に、近接物までの距離算出を行いません。
自動配線処理などで近接物までの距離情報が不要な場合、処理が早くなります。
※現在のオプションは、これだけです。
記述例）１行目…自動配線,1（２）２行目以降：オプション設定項目設定⑩が出るまでが、一つのフレーム内に表示されます。詳細は、次ページのオプションファイルの例を参照してください。

①;

コメント行

②!

メッセージ表示③?

フレームのツールチップテキストの入力④( )オプションボタンによるオプション設定⑤[ ]チェックボックスによるオプション設定⑥｢ ｣テキスト入力によるオプション設定⑦{ }リスト形式によるオプション設定⑧¦ ¦ファイル選択によるオプション設定⑨< >ディレクトリ選択によるオプション設定⑩>

現在の選択・設定値-6-オプションファイルの例;

？
！
()

[]

｢｣

{}

¦¦<>

テスト
;↑１行目は必ずタイトルを記述;コメント記述;-------------------------------------------;オプションボタン形式
質問１?フレームのツールチップテキストを入力!表示メッセージを入力(a1)項目１−１(a2)項目１−２(a3)項目１−３>a1;-------------------------------------------;チェックボックス形式
質問２[b1]項目２−１[b2]項目２−２[b3]項目２−３[b4]項目２−４>b1>b2;-------------------------------------------;テキスト入力
質問３｢c1｣項目３−１｢c2｣項目３−２｢c3｣項目３−３>c1 テキスト入力１>c2>c3 テキスト入力２;-------------------------------------------;リスト形式テキスト入力
質問４{d1}項目４−１{d2}項目４−２{d3}{d4}項目４−４{d5}項目４−５{d6}項目４−６>d1 111>d2 222>d3>d4 444>d5 555>d6;-------------------------------------------;ファイル選択
質問５¦e¦ファイル>e;-------------------------------------------;ドライブ・ディレクトリ選択
質問６<f>ドライブ・ディレクトリ
>f c:¥;-------------------------------------------;色々混合
質問７(option1)項目７−１(option2)項目７−２(option3)項目７−３[check1]項目７−４[check2]項目７−５｢text1｣項目７−６{list1}項目７−７{list2}項目７−８>option2>check1>text1>list1 aaa>list2-7-