ashton 0.0.1alpha → 0.0.2alpha

data/examples/output/README.txt

@@ -1 +0,0 @@
-Output from the examples will be saved here, to prove that some functionality works.

data/lib/ashton/base_shader.rb

@@ -1,172 +0,0 @@
-module Ashton
-  # @abstract
-  class BaseShader
-    INVALID_LOCATION = -1
-    MIN_OPENGL_VERSION = 2.0
-
-    attr_reader :fragment_source, :vertex_source
-
-    # Todo: Pass in a filename (String) or name of built-in pp shader (Symbol)
-    #
-    # @option options [String] :vertex Source code for vertex shader.
-    # @option options [String] :vert equivalent to :vertex
-    # @option options [String] :fragment Source code for fragment shader.
-    # @option options [String] :frag equivalent to :fragment
-    def initialize(vertex_source, fragment_source)
-      raise "Can't instantiate abstract class" if self.class == BaseShader
-
-      unless GL.version_supported? MIN_OPENGL_VERSION
-        raise NotSupportedError, "Ashton requires OpenGL #{MIN_OPENGL_VERSION} support to utilise shaders"
-      end
-
-      @uniform_locations = {}
-      @attribute_locations = {}
-      @program = nil
-
-      @vertex_source = vertex_source
-      @fragment_source = fragment_source
-
-      @vertex = compile GL_VERTEX_SHADER, vertex_source
-      @fragment = compile GL_FRAGMENT_SHADER, fragment_source
-
-      link
-
-      glBindFragDataLocationEXT @program, 0, "out_FragColor"
-    end
-
-
-    # Creates a copy of the shader program, recompiling the source,
-    # but not preserving the uniform values.
-    def dup
-      self.class.new :vertex => @vertex_source, :fragment => @fragment_source
-    end
-
-    # Make this the current shader program.
-    def use
-      previous_program = glGetIntegerv GL_CURRENT_PROGRAM
-      glUseProgram @program
-
-      if block_given?
-        result = yield self
-        $window.flush # TODO: need to work out how to make shader affect delayed draws.
-        glUseProgram previous_program
-      end
-
-      result
-    end
-
-    # Disable the shader program (not needed in block version of #use).
-    def disable
-      glUseProgram 0 # Disable the shader!
-    end
-
-    # Is this the current shader program?
-    def current?
-      glGetIntegerv(GL_CURRENT_PROGRAM) == @program
-    end
-
-    # Set the value of a uniform.
-    def []=(name, value)
-      use do
-        case value
-          when true, GL_TRUE
-            glUniform1i uniform(name), 1
-
-          when false, GL_FALSE
-            glUniform1i uniform(name), 0
-
-          when Float
-            glUniform1f uniform(name), value
-
-          when Integer
-            glUniform1i uniform(name), value
-
-          when Array
-            size = value.size
-
-            raise ArgumentError, "Empty array not supported for uniform data" if size.zero?
-            raise ArgumentError, "Only support uniforms up to 4 elements" if size > 4
-
-            case value[0]
-              when Float
-                GL.send "glUniform#{size}f", uniform(name), *value
-
-              when Integer
-                GL.send "glUniform#{size}i", uniform(name), *value
-
-              else
-                raise ArgumentError, "Uniform data type not supported for element of type: #{value[0].class}"
-            end
-
-          else
-            raise ArgumentError, "Uniform data type not supported for type: #{value.class}"
-        end
-      end
-    end
-
-
-
-    def uniform(name)
-      location = @uniform_locations[name]
-      if location
-        location
-      else
-        location = glGetUniformLocation @program, name.to_s
-        raise ShaderUniformError, "No #{name} uniform specified in program" if location == INVALID_LOCATION
-        @uniform_locations[name] = location
-      end
-    end
-
-    protected
-    def attribute(name)
-      location = @attribute_locations[name]
-      if location
-        location
-      else
-        location = glGetAttribLocation @program, name.to_s
-        raise ShaderAttributeError, "No #{name} attribute specified in program" if location == INVALID_LOCATION
-        @attribute_locations[name] = location
-      end
-    end
-
-    protected
-    def compile(type, source)
-      shader = glCreateShader type
-      glShaderSource shader, source
-      glCompileShader shader
-
-      unless glGetShaderiv shader, GL_COMPILE_STATUS
-        error = glGetShaderInfoLog shader
-        error_lines = error.scan(/0\((\d+)\)+/m).map {|num| num.first.to_i }.uniq
-
-        if type == GL_VERTEX_SHADER
-          type_name =  "Vertex"
-          source = @vertex_source
-        else
-          type_name = "Fragment"
-          source = @fragment_source
-        end
-
-        source_lines = source.split("\n")
-        lines = error_lines.map {|i| "#{i.to_s.rjust 3}: #{source_lines[i - 1].rstrip}" }.join "\n"
-        raise ShaderCompileError, "#{type_name} shader error: #{glGetShaderInfoLog(shader)}\n#{lines}"
-      end
-
-      shader
-    end
-
-    protected
-    def link
-      @program = glCreateProgram
-      glAttachShader @program, @vertex
-      glAttachShader @program, @fragment
-      glLinkProgram @program
-
-      unless glGetProgramiv @program, GL_LINK_STATUS
-        raise ShaderLinkError, "Shader link error: #{glGetProgramInfoLog(@program)}"
-      end
-
-      nil
-    end
-  end
-end

data/lib/ashton/framebuffer.rb

@@ -1,183 +0,0 @@
-module Ashton
-  class Framebuffer
-    TEXTURE_COORDINATES = [
-        [0, 1], # TL
-        [0, 0], # BL
-        [1, 0], # TR
-        [1, 1], # BR
-    ]
-
-    TEXTURE_COORDINATES_FLIPPED = [
-        [0, 0], # BL
-        [0, 1], # TL
-        [1, 1], # BR
-        [1, 0], # TR
-    ]
-
-    attr_reader :width, :height, :texture
-
-    def initialize(width, height)
-      @width, @height = width.to_i, height.to_i
-      @fbo, @texture = init_framebuffer
-
-      status = glCheckFramebufferStatusEXT GL_FRAMEBUFFER_EXT
-      raise unless status == GL_FRAMEBUFFER_COMPLETE_EXT
-
-      clear
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, 0
-      glBindRenderbufferEXT GL_RENDERBUFFER_EXT, 0
-    end
-
-    # Clears the buffer to transparent.
-    def clear(options = {})
-      options = {
-          color: [0.0, 0.0, 0.0, 0.0],
-      }.merge! options
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, @fbo
-
-      glClearColor *options[:color]
-      glClear GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, 0
-    end
-
-    # Enable the framebuffer to use (e.g. to draw or convert it).
-    # BUG: This will force all draws performed in, AND BEFORE, the block!
-    def use
-      raise ArgumentError, "block required" unless block_given?
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, @fbo
-      result = yield self
-
-      $window.flush
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, 0
-
-      result
-    end
-
-    # Draw the image, _immediately_ (no z-ordering by Gosu).
-    #
-    # This is not as versatile as converting the Framebuffer into a Gosu::Image and then
-    # drawing it, but it is many times faster, so use it when you are updating the buffer
-    # every frame, rather than just composing an image.
-    #
-    # Drawing in Gosu orientation will be flipped in standard OpenGL and visa versa.
-    #
-    # @param x [Number]
-    # @param y [Number]
-    # @option options :orientation [:gosu, :opengl] (:gosu)
-    def draw x, y, options = {}
-      options = {
-          :orientation => :gosu,
-      }.merge! options
-
-      glEnable GL_TEXTURE_2D
-      glBindTexture GL_TEXTURE_2D, @texture
-
-      coords = case options[:orientation]
-                 when :gosu   then TEXTURE_COORDINATES_FLIPPED
-                 when :opengl then TEXTURE_COORDINATES
-                 else raise ArgumentError, ":orientation option expected to be either :opengl or :gosu"
-               end
-
-      glBegin GL_QUADS do
-        glTexCoord2d *coords[0]
-        glVertex2d x, y + @height # BL
-
-        glTexCoord2d *coords[1]
-        glVertex2d x, y # TL
-
-        glTexCoord2d *coords[2]
-        glVertex2d x + @width, y # TR
-
-        glTexCoord2d *coords[3]
-        glVertex2d x + @width, y + @height # BR
-      end
-
-      glBindTexture GL_TEXTURE_2D, 0
-    end
-
-    # Convert the current contents of the buffer into a Gosu::Image
-    #
-    # @option options [Boolean] :caching (true) TexPlay behaviour.
-    # @option options [Boolean] :tileable (false) Standard Gosu behaviour.
-    # @option options [Array<Integer>] :rect ([0, 0, width, height]) Rectangular area of buffer to use to create the image [x, y, w, h]
-    def to_image(options = {})
-      options = {
-        rect: [0, 0, @width, @height],
-        tileable: false,
-      }.merge! options
-
-      rect = options[:rect]
-
-      # Draw onto the clean flip buffer, in order to flip before saving.
-      @fbo_flip, @fbo_flip_texture = init_framebuffer unless defined? @fbo_flip
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, @fbo_flip
-      glClearColor 0, 0, 0, 0
-      glClear GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT
-      draw 0, 0
-
-      # Read the data in the flip-buffer.
-      glBindTexture GL_TEXTURE_2D, @fbo_flip_texture
-      blob = glReadPixels *rect, GL_RGBA, GL_UNSIGNED_BYTE
-
-      # Clean up.
-      glBindTexture GL_TEXTURE_2D, 0
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, 0
-
-      # Create a new Image from the flipped pixel data.
-      stub = ImageStub.new blob, rect[2], rect[3]
-      if defined? TexPlay
-        Gosu::Image.new $window, stub, options[:tileable], options
-      else
-        Gosu::Image.new $window, stub, options[:tileable]
-      end
-
-    end
-
-    # Create an fbo and its texture
-    def init_framebuffer
-      fbo = glGenFramebuffersEXT(1)[0]
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, fbo
-
-      texture = init_framebuffer_texture
-
-      glFramebufferTexture2DEXT GL_FRAMEBUFFER_EXT, GL_COLOR_ATTACHMENT0_EXT, GL_TEXTURE_2D, texture, 0
-
-      [fbo, texture]
-    end
-
-    protected
-    # Called by init_framebuffer.
-    def init_framebuffer_texture
-      texture = glGenTextures(1)[0]
-      glBindTexture GL_TEXTURE_2D, texture
-
-      glTexParameterf GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE
-      glTexParameterf GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE
-      glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST
-      glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST
-
-      glTexImage2D GL_TEXTURE_2D, 0, GL_RGBA8, @width, @height,
-                   0, GL_RGBA, GL_UNSIGNED_BYTE, nil
-
-      glBindTexture GL_TEXTURE_2D, 0 # Unbind the texture
-
-      texture
-    end
-
-    protected
-    def delete
-      glDeleteFramebuffersEXT @fbo
-      glDeleteTextures @texture
-
-      glDeleteFramebuffersEXT @fbo_flip if defined? @fbo_flip
-      glDeleteTextures @fbo_flip_texture if defined? @fbo_flip_texture
-
-      glBindFramebufferEXT GL_FRAMEBUFFER_EXT, 0
-    end
-  end
-end

data/lib/ashton/post_process.rb

@@ -1,83 +0,0 @@
-require "ashton/base_shader"
-
-module Ashton
-  # Process the entire screen.
-  class PostProcess < BaseShader
-    DEFAULT_VERTEX_SOURCE = File.read File.expand_path("../post_process/default.vert", __FILE__)
-
-    class << self
-      # Canvas used to copy out the screen before post-processing it back onto the screen.
-      # We only need one of these, but only create it after a PostProcessor has
-      # actually been used.
-      def texture
-        @texture ||= begin
-          texture = glGenTextures(1).first
-          glBindTexture GL_TEXTURE_2D, texture
-          glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR
-          glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR
-          glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE
-          glTexParameteri GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE
-          glTexImage2D GL_TEXTURE_2D, 0, GL_RGB8, $window.width, $window.height, 0,
-                       GL_RGB, GL_UNSIGNED_BYTE, "\0" * ($window.width * $window.height * 3)
-          texture
-        end
-      end
-    end
-
-    # Todo: Pass in a filename (String) or name of built-in pp shader (Symbol)
-    def initialize(fragment)
-      super DEFAULT_VERTEX_SOURCE, fragment
-
-      # Set up defaults that we won't need to change at run-time.
-      use do
-        # Width/height are optional.
-        glUniform1i glGetUniformLocation(@program, "in_WindowWidth"), $window.width
-        glUniform1i glGetUniformLocation(@program, "in_WindowHeight"), $window.height
-
-        self["in_Texture"] = 0 # GL_TEXTURE0 will be activated.
-      end
-    end
-
-    # Full screen post-processing using a fragment shader.
-    #
-    # It will force all previous draw operations to be flushed to the
-    # screen, so that you can, or example, process the "game world" before you draw the GUI.
-    #
-    # Variables set for you in the fragment shader:
-    #   uniform sampler2D in_Texture; // Texture containing the screen image.
-    #   uniform int in_WindowWidth;
-    #   uniform int in_WindowHeight;
-    def process
-      $window.gl do
-        width, height = $window.width, $window.height
-        texture = PostProcess.texture
-
-        # Copy window contents into a frame-buffer.
-        glBindTexture GL_TEXTURE_2D, texture
-        glCopyTexImage2D GL_TEXTURE_2D, 0, GL_RGBA8, 0, 0, width, height, 0
-
-        # clear screen and set "normal" openGL coordinates.
-        glClear GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT
-        glColor4f 1.0, 1.0, 1.0, 1.0
-        glMatrixMode GL_PROJECTION
-        glLoadIdentity
-        glViewport 0, 0, width, height
-        glOrtho 0, width, height, 0, -1, 1
-
-        # Assign the canvas, which was a copy of the screen.
-        glActiveTexture GL_TEXTURE0
-        glBindTexture GL_TEXTURE_2D, texture
-        raise unless glGetIntegerv(GL_ACTIVE_TEXTURE) == GL_TEXTURE0
-
-        use do
-          glBegin GL_QUADS do
-            glTexCoord2f(0.0, 1.0); glVertex2f(0.0,   0.0)
-            glTexCoord2f(1.0, 1.0); glVertex2f(width, 0.0)
-            glTexCoord2f(1.0, 0.0); glVertex2f(width, height)
-            glTexCoord2f(0.0, 0.0); glVertex2f(0.0,   height)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ashton/post_process/default.vert

@@ -1,9 +0,0 @@
-#version 110
-
-varying vec2 var_TexCoord;
-
-void main()
-{
-  gl_Position = ftransform();
-  var_TexCoord = gl_MultiTexCoord0.xy;
-}