CLIの使用

ローカルAPI経由で実行中のアプリを調査および編集するか、G-codeを直接エクスポートします。

beambench-cliバイナリはデスクトップアプリとともに配布されます。ほとんどのプロジェクト、デザイン、マシン、プロファイル、状態コマンドは、アプリのローカルAPIのクライアントです。これらのコマンドを実行するには、アプリを起動し、Settings > General > Local APIを有効にする必要があります。

同じコンピューターで実行するスクリプトでは、Allow network devices to connectを無効にしてください。CLIはアプリの設定から構成済みのAPIポートを読み取ります。デフォルトは5900です。

利用可能なコマンドを確認する

beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json

ヘルプはアプリなしで使用できます。機能一覧とライブ状態にはAPIを使用します。サブコマンドに--helpを付けて実行すると、インストールされているバージョンで使用できるパラメーターが表示されます。

プロジェクトを開いて確認する

beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json

プロジェクトを開くと、デスクトップアプリ内のプロジェクトが変わります。プロジェクトを置き換えるスクリプトや編集するスクリプトを実行する前に、作業を保存してください。

beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj

レンダリングとエクスポート

beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg

これらのコマンドは、API経由で実行中のアプリのプロジェクトを使用します。デザインのレンダリングに表示中のキャンバスは必要ありませんが、サーバーは必要です。

beambench-cli camera overlay render --output /tmp/overlay.png --view fit

カメラオーバーレイのレンダリングには、レンダリング要求を処理するアプリのフロントエンドも必要です。これはカメラワークフローのヘッドレスな代替手段ではありません。

アプリなしで動作するコマンド

シリアルポート一覧、ヘルプ、位置指定のG-codeエクスポートには、直接実行できるローカル処理があります。

beambench-cli ports
beambench-cli export gcode /abs/path/project.lzrproj /abs/path/out.gcode

スタンドアロンのG-codeエクスポートでは、ローカルに保存されたマシンプロファイルと、デスクトップのプランニングおよび出力チェックを使用します。ライブのマシン位置を読み取ることはできません。プロファイルと配置の要件についてはG-code出力を参照してください。

自動化と競合

デザインのトランザクションは、現在のプロジェクトリビジョンを使用します。別の編集、プロジェクトの切り替え、または終了によって取得したプロジェクトが無効になった場合、トランザクションは拒否されます。状態を更新してから操作を再評価し、再試行してください。古いスナップショットで同時に行われたユーザー編集を上書きしないでください。

マシンの移動、レーザーの発射、生のG-codeの送信、またはエアアシストの変更を行うコマンドには、それぞれ対応する確認フラグが必要です。フラグを指定する前に、コマンドのヘルプと実行する操作を確認してください。

CLIではキャンバスツールの選択、パネルの並べ替え、ショートカットの実行はできません。これらはデスクトップUIで行う操作です。