AssetImporterと連動する
Asset Importer App,
Asset Importer App (AssetImporter.exe) is a program provided by PhotoAlign, used as a bridge application to import photo files and information from other partnered programs or programs arbitrarily supported by us.
For example, when the Asset Importer App is executed with appropriate command arguments, the app reads the information, displays the photo files, and transfers the information to PhotoAlign, PhotoPort, or PhotoSlide.
For more information about it, visit the Asset Importer App page.
フォトアラインを実行しながら写真ファイルをエセットタップに読み込む
1. Load Files from a Specific FolderThis method preloads photos from a specific folder into the Asset Tab of PhotoAlign.
When launching the PhotoAlign program, pass the folder path as the first command argument.
Example of execution command argument:
"C:\Program Files\PhotoAlign Studio\PhotoAlign.exe" "C:\Users\ComputerUser\Pictures\Demo"2. テンプレート経路またはテンプレート名を指定して読み込む
特定テンプレートが既に適用されている状態で写真を読み込む方法です。
テンプレートの経路または正確なテンプレート名が必要です。
このような追加的な情報はJSONファイルにて作成され、フォトアライン実行時にコマンド引数にて伝達する必要があります。
実行コマンド引数の例:
"C:\Program Files\PhotoAlign Studio\PhotoAlign.exe" "C:\Temp\photoalign_import.json"ただ, JSONファイルが "C:\Users\ComputerUser\Documents\PhotoAlign\api_input.json" に位置する場合, 上記のような別途コマンド引数がなくてもフォトアラインが該当ファイルを自動で読み込んで処理し、処理されたapi_input.json ファイルは 削除されます。
templatepathには読み込むテンプレートの絶対パスが入力出来て, templatenameには テンプレート名が入力出来ます。
2つの引数が全部存在する場合、パスを優先して探索し、パスがテンプレートではない場合はテンプレート名を使います。
templatenameはフォトアラインが初期にロードするテンプレート名と一致する必要があり、フォトアラインにて 選択されている言語に従います。
modeはフォトアラインのメインエディタ画面が開き、自動で配置するかを決める引数です。
- "mode"の値が allocationの場合、写真はJSONファイルの"allocation"必須う項目に合わせて配置されます。"allocation"のキー(key)の値は 選択されたテンプレートの各 キャンバス名と一致する必要があります。
- "mode"の値がaiallocationの場合、AIが自動で写真を配置します。この設定では"selectedfolder"または"assetfolder"の中の一つが必ず設定されているひつようがあります。
- "mode"の値が loadの場合、写真は読み込まれるが自動で配置されません。
assetfolderにパスを入力すると、 写真要素タップに写真を読み込みます。
手動配置情報が含まれたJSONファイル例:
{
"version": 1,
"mode": "allocation", // allocation, aiallocation, load
"templatepath": "C:\\Users\\ComputerUser\\Documents\\PhotoAlign\\CanvasTemplate\\Orthodontic Basic Photo", // Full template path
"templatename": "Orthodontic Intraoral and Facial Basic Set (3:2 Ratio)", // or language specific template name
"allocation": {
"IO Frontal": "C:\\Users\\ComputerUser\\Pictures\\Demo\\DSC_0022.JPG", // Allocation canvas name and file path
"Facial Right": "C:\\Users\\ComputerUser\\Pictures\\Demo\\DSC_0032.JPG"
},
"selectedfolder": "C:\\Users\\ComputerUser\\Pictures\\Demo2", // Folder browser default path
"assetfolder": "C:\\Users\\ComputerUser\\Pictures\\Demo3", // Load assets automatically
"from": "PhotoAlign Manager" // (Optional) Source application name
}
AI配置が設定されたJSONファイル例:
{
"version": 1,
"mode": "aiallocation",
"templatepath": "C:\\Users\\ComputerUser\\Documents\\PhotoAlign\\CanvasTemplate\\Orthodontic Basic Photo",
"templatename": "Orthodontic Intraoral and Facial Basic Set (3:2 Ratio)",
"selectedfolder": "C:\\Users\\ComputerUser\\Pictures\\Demo2", // Either selectedfolder or assetfolder must be specified for AI allocation.
"assetfolder": "C:\\Users\\ComputerUser\\Pictures\\Demo3",
"from": "PhotoAlign Manager"
}
,
フォトアラインが編集した写真の情報を持ってくる
フォトアラインで編集した写真の情報出力フォトアラインにて写真たちが一括保存されると、その結果のメタ情報を常にJSONファイルにて保存します。
外部プログラムでその情報が必要な場合、JSONファイルを読み込み、ご利用出来ます。
JSONファイルは次の一括保存までに維持し、新しく一括保存すると既存情報は上書きされます。
JSONファイルは一般的に"%APPDATA%\local\Temp\photoalign_output.json"に保存されます。
該当位置にファイルがない場合、使用者権限がないか、%APPDATA%パスが変更された可能性がございます。
JSONの各情報はキー(key)名から推測出来ます
出力されるJSONファイル例:
{
"version": 1,
"templatepath": "C:\\Users\\ComputerUser\\Documents\\PhotoAlign\\CanvasTemplate\\Orthodontic Basic Photo",
"templatename": "Orthodontic Intraoral and Facial Basic Set (3:2 Ratio)",
"input": {
// any previous JSON input data if available
},
"result": [
{
"canvastitle": "IO Frontal",
"appointment": "io_frontal", // will be replaced with "class" later
"input": "C:\\Users\\ComputerUser\\Pictures\\Demo\\DSC_0022.JPG", // Original path
"output": "C:\\Users\\ComputerUser\\Pictures\\Result\\io_frontal.JPG", // Saved path
"outputfolder": "C:\\Users\\ComputerUser\\Pictures\\Result",
"outputname": "io_frontal", // Filename without extension
"extension": ".JPG", // File extension
"zoom": 1.5,
"rotation": 3.2,
"left": 0.01,
"top": 0.11,
"horizontalflip": true,
"verticalflip": false
}
]
}
フォトポート(PhotoPort)に写真をインポート
フォトポートに写真ファイルを持ち込み、新しいフォルダーを作ったり既存フォルダーにインポートする
外部の写真ファイルをフォトポートに一括登録するためには、各ファイルのパスと追加情報が含まれたJSONファイルの絶対パスを実行コマンド引数に伝達する必要があります。
実行コマンド引数の例:
"C:\Program Files\PhotoAlign Studio\PhotoPort.exe" "C:\Temp\import_new_photos.json"modeはフォトポートの動作モードを設定する引数です。現在は "import"のみ可能です。
foldernameが与えられたら、利用者が[新規患者フォルダーを生成]を選択した際に自動で"フォルダー名"に入力されます。
folderdescriptionが与えられたら、利用者が[新規患者フォルダーを生成]を選択した際に自動で"フォルダー説明"に入力されます。
foldermemo이 제공되면, 사용자가 [새 환자 폴더 생성]을 선택 시 자동으로 "폴더 메모"로 미리 입력됩니다.
subfoldernameが与えられたら、利用者が選択したフォルダーの下のフォルダー名に入力されます。
assetlist 配列には各ファイルの情報が含まれてます。
"assetlist"の filenameは保存されるファイル名、 filepathは原本ファイルの絶対パス、 subfolderはファイルが保存されるフォルダー名です。
もし、 "subfolder"が与えられない場合、ファイルは利用者が指定した基本フォルダーに保存されます。
一つのJSONファイルに複数の"subfolder"を持ったファイルを一括に読み込めます。つまり、一つの患者フォルダーの中に同時に2個以上の下フォルダーを生成し、それぞれのフォルダーに写真をコピー出来ます。
各ファイルの情報と追加情報が含まれたJSONファイル例:
{
"version": 1,
"mode": "import",
"from": "PhotoAlign Asset Importer",
"foldername": "David 12345", // Optional
"folderdescription": "David Jones, 12345, Class II, VIP", // Optional
"foldermemo": "David Jones, 12345, Private Insurance", // Optional
"subfoldername": "2024-11-11", // Optional
"assetlist": [
{
"filename": "01.jpg",
"filepath": "C:\\Users\\ComputerUser\\Digital Camera\\IMG_01.JPG",
"subfolder": "2024-11-10" // can be blank, but should not be omitted
},
{
"filename": "02.jpg",
"filepath": "C:\\Users\\ComputerUser\\Digital Camera\\IMG_02.JPG",
"subfolder": "2024-11-11"
}
]
}
フォトスライド(PhotoSlide)を起動する際のフォルダーをあらかじめ選択する
"C:\Program Files\PhotoAlign Studio\PhotoSlide.exe" "C:\Users\ComputerUser\Pictures\Photo Series"上記の内容は予告なく変更される可能性があり、連動プロトコル利用時に予想されてないエラーやバグが発生する可能性があります。
