کتابخانه روبی برای ایجاد و رندر گرافیک‌های 3D و توسعه بازی‌ها

شروع کار با Ray

ساده‌ترین راه برای نصب نسخهٔ پایدار Ray استفاده از RubyGem است. لطفاً برای نصب روان، دستور زیر را اجرا کنید.

gem 'ray', github: 'Mon-Ouie/ray' 

نمایش پایه Raycasting از طریق کتابخانه Ruby

کتابخانهٔ Ray برای روبی، ریاضیات قدرتمند سه‌بعدی و قابلیت‌های ریکستینگ را در بسته‌ای زیبا به توسعه‌دهندگان روبی ارائه می‌دهد. ریکستینگ برای تشخیص تقاطع‌های بین پرتوها و اشیاء در فضای دو‑بعدی یا سه‌بعدی ضروری است. کتابخانهٔ Ray روشی ساده برای پرتاب پرتوها و بازیابی داده‌های برخورد فراهم می‌کند. در اینجا یک مثال بسیار مفید آورده شده است که نشان می‌دهد چگونه می‌توان تجسم پایهٔ ریکستینگ را با استفاده از کتابخانهٔ روبی انجام داد.

require 'ray'
require 'ruby2d'

# Set up 2D window
set title: "Raycasting Demo", width: 800, height: 600

# Create a ray from center pointing at mouse
ray = Ray::Ray.new(origin: [400, 300], direction: [1, 0])

# Target circle
target = Circle.new(x: 500, y: 300, radius: 30, color: 'red')

update do
  # Update ray direction toward mouse
  ray.direction = [Window.mouse_x - 400, Window.mouse_y - 300].normalize

  # Check intersection
  if ray.intersect_circle(target.position, target.radius)
    target.color = 'lime'
  else
    target.color = 'red'
  end
end

show

محاسبات انعکاس و انکسار

کتابخانهٔ منبع باز Ray پشتیبانی کامل از محاسبات انعکاس و شکست پرتو را در برنامه‌های روبی فراهم کرده است. این کتابخانه شامل توابعی برای محاسبهٔ انعکاس و شکست پرتوها است که برای اثرات نورپردازی، آینه‌ها و شبیه‌سازی‌های نوری مفید می‌باشند. در اینجا یک مثال ساده آورده شده است که نشان می‌دهد توسعه‌دهندگان نرم‌افزار می‌توانند با استفاده از کتابخانهٔ سه‌بعدی روبی، انعکاس پرتو را محاسبه کنند.

# Incident ray (light direction)
incident = Ray::Vector[1, -1, 0].normalize

# Surface normal
normal = [0, 1, 0]

# Calculate reflection
reflected = incident.reflect(normal)
puts "Reflected direction: #{reflected}"

تراز و موقعیت‌یابی

کتابخانه منبع باز 3D Ray پشتیبانی کامل از هم‌ترازی عناصر دو‌بعدی و سه‌بعدی را در برنامه‌های Ruby فراهم کرده است. این کتابخانه روش‌های ساده‌ای برای هم‌ترازی و موقعیت‌یابی عناصر ارائه می‌دهد: روش‌های align، padding و margin به توسعه‌دهندگان کنترل بر روی چیدمان می‌دهند، مشابه مدل‌های جعبه‌ای CSS. مثال ساده زیر نشان می‌دهد چگونه می‌توان خطوط متعدد را که به هر دو انتهای بوم هم‌تراز هستند، با استفاده از دستورات Ruby به دست آورد.

Ray.draw(width: 40, height: 10) do
  text "Left aligned" do
    align :left
  end

  text "Right aligned" do
    align :right
  end
end

رسم جعبه با حاشیه‌های یونیکد

کتابخانه Ray 3D کار را برای توسعه‌دهندگان نرم‌افزار آسان می‌کند تا جعبه‌ها را با رسم یونیکد در برنامه‌های Ruby ترسیم کنند. جعبه‌ها خروجی ترمینال شما را ساختارمندتر می‌سازند. Ray از کاراکترهای رسم جعبه یونیکد برای ایجاد حاشیه‌های زیبا استفاده می‌کند. متد box محتوای شما را در یک حاشیه منظم با استفاده از کاراکترهایی مانند ┌ ─ ┐ و └ ┘ می‌پیچد، همان‌طور که در مثال کد زیر نشان داده شده است.

Ray.draw(width: 50, height: 8) do
  box do
    text "Welcome to Ray UI!" do
      align :center
    end
  end
end