راینو و فایل‌های STEP

اگر بخشی از کارت را در راینو کشیده‌ای، لازم نیست آن را در آتریوم از نو بکشی. سه راه برای آوردن هندسه به آتریوم هست: کپی و پیست مستقیم از راینو، دکمه‌ی SendToAtrium در افزونه‌ی راینوی باند، و رها کردن فایل‌های STEP یا IGES روی ویرایشگر باز. هر سه راه به یک مسیر در آتریوم می‌رسند و نتیجه‌شان یکی است.

#کپی از راینو، پیست در آتریوم

1. در راینو چیزهایی را که می‌خواهی انتخاب کن و Ctrl + C بزن.
2. در آتریوم، ویرایشگر مناسب را باز کن و Ctrl + V بزن.

چیزی که پیست می‌شود به ویرایشگر باز بستگی دارد:

#قانون‌های پیست از راینو

• بلاک‌ها: بلاک راینو محتوای خودش را با همان جا و همان چرخش می‌آورد.
• واحد: واحد فایل راینو خودش به میلی‌متر تبدیل می‌شود. مثلاً ۱۰۰ سانتی‌متر در راینو، این‌جا ۱۰۰۰ میلی‌متر است. متر، اینچ و فوت هم تبدیل می‌شوند.
• جای چیزها: چیزی که نزدیک مبدأ است، همان‌جا می‌نشیند. چیزی که دور است (مثلاً یک بلاک وسط یک نقشه‌ی بزرگ) روی مبدأ می‌آید.
• آندو: یک آندو کل پیست را برمی‌گرداند.
• آخرین کپی برنده است: اگر بعد از کپی در آتریوم در راینو Ctrl + C بزنی، Ctrl + V چیزهای راینو را می‌آورد، و برعکس.

پیست از راینو بدون نصب هیچ افزونه‌ای کار می‌کند. افزونه‌ی راینوی Bond این مسیر را مطمئن‌تر می‌کند.

#افزونه‌ی راینوی Bond

وقتی افزونه‌ی راینوی Bond نصب باشد، انتخاب تو در راینو به شکل یک فایل STEP به آتریوم فرستاده می‌شود؛ با همان خروجی STEP خودِ راینو. این کار دو راه دارد.

#دکمه‌ی SendToAtrium

1. در راینو چیزهایی را که یک قطعه را می‌سازند انتخاب کن (اگر چیزی انتخاب نباشد، دستور از تو می‌خواهد انتخاب کنی).
2. دکمه‌ی SendToAtrium را بزن (یا دستور SendToAtrium را اجرا کن).
3. انتخاب به آتریومِ باز فرستاده می‌شود و پنجره‌ی آتریوم جلو می‌آید.

جای قرار گرفتن قطعه همان قانون‌های رها کردن فایل را دارد (پایین‌تر).

#کپی در راینو با افزونه

با افزونه، Ctrl + C در راینو علاوه بر داده‌های خودِ راینو، یک فایل STEP از همان انتخاب هم در کلیپ‌بورد می‌گذارد؛ پس پیست داخل خودِ راینو مثل قبل کار می‌کند. Ctrl + V در آتریوم (اسمبلی، ۰بعدی و ۱بعدی) به این ترتیب تصمیم می‌گیرد:

1. اگر آخرین کپی را در خودِ آتریوم گرفته‌ای، همان پیست می‌شود.
2. وگرنه فایل STEPِ افزونه (یا فایل‌های STEP و IGES که در Windows Explorer کپی کرده‌ای).
3. وگرنه داده‌های خودِ راینو در کلیپ‌بورد؛ همان روشی که بدون افزونه هم کار می‌کند.

#رها کردن فایل STEP و IGES

یک یا چند فایل STEP (.step یا .stp) یا IGES را از Windows Explorer بکش و روی ویرایشگر باز آتریوم رها کن:

فایل STEP واحد مدل را با خودش دارد و آتریوم آن را به میلی‌متر تبدیل می‌کند؛ مدل‌هایی با واحد سانتی‌متر، متر یا اینچ مشکلی ندارند.

#برای توسعه‌دهنده‌ها

این بخش برای کسانی است که می‌خواهند از برنامه‌ی دیگری، مثلاً یک افزونه‌ی راینو، فایل به آتریوم بفرستند. آتریوم یک named pipe باز می‌کند که فقط تا وقتی برنامه باز است وجود دارد، فقط برای کاربر فعلی ویندوز در دسترس است، و تا پیامی نرسد بیکار می‌ماند.

#فایل

• انتخاب را با خروجی STEP خودِ راینو (.step / .stp؛ IGES هم پذیرفته می‌شود) در یک پوشه‌ی موقت بنویس؛ مثلاً %TEMP%\AtriumBridge\.
• اسم فایل، اسم قطعه در آتریوم می‌شود: اسم آبجکت، وگرنه اسم بلاک (instance definition)، وگرنه چیزی مثل Rhino 12. حرف‌هایی را که ویندوز در اسم فایل نمی‌پذیرد حذف کن.
• فایل را سر جایش بگذار (آتریوم کمی بعد آن را می‌خواند) و در ارسال بعدی، فایل‌های قدیمی‌تر از یک روز را پاک کن.

#ارسال با named pipe

پیش از اتصال، AllowSetForegroundWindow(ASFW_ANY) (از user32) را صدا بزن تا آتریوم بتواند پنجره‌اش را جلو بیاورد. بعد به این pipe روی همین ماشین وصل شو (timeout اتصال حدود ۱ ثانیه):

atrium-bridge-<windows user name>

new NamedPipeClientStream(".", "atrium-bridge-" + Environment.UserName, PipeDirection.InOut)

در اسم کاربر، هر حرفی بیرون از A-Z a-z 0-9 _ . - با _ جایگزین می‌شود. اگر اتصال برقرار نشد، یعنی آتریوم باز نیست.

یک خط JSON با کدگذاری UTF-8 که با \n تمام می‌شود بفرست:

{"v": 1, "cmd": "import", "files": ["C:\\Users\\...\\AtriumBridge\\Cabinet side.step"]}

یک خط JSON جواب بخوان و اتصال را ببند:

{"ok": true, "editor": "assembly", "files": 1}
{"ok": false, "error": "No readable STEP/IGES file arrived"}

• اگر ok برابر false بود، error را به کاربر نشان بده.
• editor می‌گوید فایل به کجا رفت: "assembly"، "part_0d"، "part_1d"، "tool"، "other"، یا "" (هیچ ویرایشگری که فایل بپذیرد باز نیست و هر فایل یک قطعه‌ی تازه می‌شود).
• جواب فوری می‌آید، پیش از آن‌که آتریوم فایل را بخواند؛ آتریوم فقط وجود فایل و STEP/IGES بودن آن را بررسی می‌کند. خطای خواندن داخل آتریوم نشان داده می‌شود. timeout پنج‌ثانیه‌ای کافی است.
• چند آبجکت انتخاب‌شده به شکل یک فایل STEP، یعنی یک قطعه، فرستاده می‌شوند.

برای بررسی باز بودن آتریوم (مثلاً برای کم‌رنگ کردن دکمه وقتی آتریوم باز نیست):

{"v": 1, "cmd": "ping"}

{"ok": true, "app": "Atrium", "version": "x.y.z", "editor": "..."}

#فرمت کلیپ‌بورد

بعد از این‌که دستور Copy خودِ راینو تمام شد (مثلاً در Command.EndCommand برای Copy یا CopyToClipboard)، همان انتخاب را در فایل STEP موقت بنویس و فرمت Atrium.GeometryFiles را کنار داده‌های راینو به کلیپ‌بورد اضافه کن؛ فرمت‌های خودِ راینو را نگه دار تا پیست در راینو هم کار کند. محتوا، بایت‌های UTF-8 این JSON است:

{"files": ["C:\\Users\\...\\AtriumBridge\\Cabinet side.step"]}

رشته‌ی .NET (UTF-16) و یک مسیر در هر خط هم پذیرفته می‌شود. در .NET:

// copy the current DataObject's formats into a new DataObject, then:
obj.SetData("Atrium.GeometryFiles", new MemoryStream(utf8Bytes));
Clipboard.SetDataObject(obj, true);