0.02
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
FORKED TO USE A DIFFERENT OPENGL DEPENDENCY: Extra special effects, such as shader, for the Gosu game-development library
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.1.0
~> 2.1.1
~> 4.2.9
~> 1.0.4
~> 2.10.0
~> 0.4.3
~> 0.8.2.1

Runtime

 Project Readme

Ashton

Description

Add extra visual effects to the Gosu game-development library, utilising OpenGL shaders (using shader model 1.0, for maximum compatibility) and frame-buffers.

"Ashton" is named after Clark Ashton Smith, an fantasy/horror author with a particularly colourful imagination.

Usage

gem install ashton

Features

  • Gosu extensions

    • {Gosu::Color} - Converting to and from opengl values.

    • {Gosu::Font} - Apply shader to draw operations.

    • {Gosu::Image} - Apply shader to each draw operation or group of draws. Manipulation, such as flipping and scaling.

    • {Gosu::Window} - Post-processing with shaders. Converting to image.

  • Ashton

    • {Ashton::Texture} - Single texture (compared to Gosu::Image which uses a spritesheet) which can be drawn directly onto and drawn to the Window.

    • {Ashton::Lighting::Manager} - Manages and combines the lighting from {Ashton::Lighting::LightSource} objects.

    • {Ashton::Lighting::LightSource} - A single light-source that illuminates and whose can be blocked by shadow-casting objects.

    • {Ashton::ParticleEmitter} - Generates, manages and displays particles.

    • {Ashton::PixelCache} - Cached image data attached to an {Ashton::Texture} or {Gosu::Image}.

    • {Ashton::SignedDistanceField} - A signed distance field based on a an image mask.

    • {Ashton::Shader} - Wrapper around a GLSL shaders, Supports vertex and fragment shaders. Small shader/function library.

    • {Ashton::WindowBuffer} - Texture that is the same size as the Gosu Window that can capture the contents of the screen.

Requirements

  • OSX/Linux: Requires OpenGL library be installed.

  • {Ashton::Shader} and {Ashton::Lighting} or anything else using shaders, require OpenGL 2.0.

Similar Libraries

  • TexPlay - Deals with Gosu::Image manipulation, such as per-pixel editing and drawing. It is compatible with, and complementary to, this gem.

Third party

  • OpenGL static library (in Windows binary gem) and headers.

  • GLee source.

  • Various trivial shaders - "randomly found on the Internet" :$

  • Classic and Simplex noise functions - Copyright (C) 2011 Ashima Arts - MIT license.

    • classicnoise2d.glsl - 2D Classic Perlin noise implementation - cnoise(vec2)
    • classicnoise3d.glsl - 3D Classic Perlin noise implementation - cnoise(vec3)
    • classicnoise4d.glsl - 4D Classic Perlin noise implementation - cnoise(vec4)
    • noise2d.glsl - 2D Simplex noise implementation - snoise(vec2)
    • noise3d.glsl - 3D Simplex noise implementation - snoise(vec3)
    • noise4d.glsl - 4D Simplex noise implementation - snoise(vec4)
  • Bloom filter by myheroics

    • bloom.frag
  • Shockwave by Crystalin

    • shockwave.frag
  • Radial Blur by gamerendering.com

    • radial_blur.frag
  • Lighting based on, but much optimised from, Catalin Zima's shader based dynamic shadows system.