1. Productos
  2.   3D
  3.   Ruby
  4.   Ray
 
  

Biblioteca Ruby para crear y renderizar gráficos 3D y desarrollo de juegos

Biblioteca Ruby 3D de código abierto para crear y renderizar gráficos y escenas 3D en desarrollo de juegos, simulaciones y robótica mediante una API Ruby gratuita.

¿Qué es Ray Library?

Si eres un desarrollador Ruby con amor por los DSL elegantes y gusto por los gráficos basados en terminal, la biblioteca Ray es una gema de código abierto que vale la pena explorar. Creada por Mon-Ouie, Ray ofrece un lenguaje específico de dominio (DSL) para crear hermosos gráficos ASCII y ANSI directamente en tu terminal. A diferencia de bibliotecas gráficas más pesadas, Ray enfatiza la simplicidad y expresividad, permitiéndote definir visuales con código mínimo. La biblioteca soporta operaciones de rayos tanto 2D como 3D, lo que la hace versátil para diferentes tipos de aplicaciones. Profundicemos en algunas de las características específicas que ofrece la biblioteca. Soporta configuración simplificada de Juego/Ventana (DSL), crear y gestionar escenas, dibujar formas 2D comunes y texto, crear formas geométricas básicas, creación de matemáticas vectoriales, soporte de matrices de transformación personalizadas, soporte de renderizado fuera de pantalla y así sucesivamente.

Ray es un DSL de Ruby para dibujar gráficos en la terminal, que permite definir formas, colores, degradados y diseños usando una sintaxis declarativa. La idea central es tratar la terminal como un lienzo y construir elementos gráficos estructurados que pueden componerse como widgets de UI. Piénsalo como HTML y CSS para tu terminal. Aprovecha los códigos de escape ANSI y los caracteres Unicode para renderizar visuales complejos. Ray puede renderizar gráficos usando caracteres Unicode y símbolos de dibujo de cajas, que son esenciales para crear diseños nítidos y limpios en entornos de terminal. Ray es una encantadora pequeña biblioteca de Ruby que captura el espíritu del minimalismo y la expresividad. Aunque puede no reemplazar frameworks completos de TUI (Interfaz de Usuario de Terminal) como curses o tty, sobresale en la creación rápida de prototipos de diseño, formato de salida hermoso y proporcionar una forma divertida y idiomática de Ruby para construir visuales en la terminal.

Previous Next

Comenzando con Ray

La forma más fácil de instalar la versión estable de Ray es usando RubyGem. Por favor, usa el siguiente comando para una instalación sin problemas.

Instalar Ray via RubyGem

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

Puedes descargar la biblioteca compartida compilada desde el repositorio Github.

Visualización básica de Raycasting mediante la biblioteca Ruby

La biblioteca Ray Ruby brinda potentes capacidades de matemáticas 3D y raycasting a los desarrolladores Ruby en un paquete elegante. El raycasting es esencial para detectar intersecciones entre rayos y objetos en un espacio 2D o 3D. La biblioteca Ray ofrece una forma sencilla de lanzar rayos y obtener datos de colisión. Aquí tienes un ejemplo muy útil que muestra cómo realizar una visualización básica de raycasting usando la biblioteca Ruby.

¿Cómo realizar una visualización básica de raycasting usando Ruby?

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

Cálculos de reflexión y refracción

La biblioteca Ray de código abierto ha proporcionado soporte completo para cálculos de reflexión y refracción dentro de aplicaciones Ruby. La biblioteca incluye funciones para calcular reflexiones y refracciones de rayos, útiles para efectos de iluminación, espejos y simulaciones ópticas. Aquí tienes un ejemplo sencillo que muestra a los desarrolladores de software cómo calcular la reflexión de rayos usando la biblioteca Ruby 3D.

¿Cómo calcular la reflexión de rayos mediante la biblioteca Ruby??

# 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}"

Alineación y posicionamiento

La biblioteca de código abierto 3D Ray ha proporcionado soporte completo para alineaciones de elementos 2D y 3D dentro de aplicaciones Ruby. Ofrece métodos simples para alinear y posicionar elementos: los métodos align, padding y margin dan a los desarrolladores control sobre el diseño, similar a los modelos de caja CSS. El siguiente ejemplo sencillo muestra cómo obtener múltiples líneas, alineadas a ambos extremos del lienzo usando comandos Ruby.

¿Cómo obtener múltiples líneas, alineadas a ambos extremos del lienzo mediante la API de Ruby?

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

  text "Right aligned" do
    align :right
  end
end

Dibujo de cajas con bordes Unicode

La biblioteca Ray 3D facilita a los desarrolladores de software dibujar cajas con trazado Unicode dentro de aplicaciones Ruby. Las cajas hacen que la salida de tu terminal sea más estructurada. Ray utiliza caracteres Unicode de dibujo de cajas para crear bordes elegantes. El método box envuelve tu contenido en un borde ordenado usando caracteres como ┌ ─ ┐ y └ ┘ como se muestra en el siguiente ejemplo de código.

¿Cómo envolver contenido en una caja ordenada con borde usando la biblioteca Ruby?

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