pixelflow_canvas 0.7.7 → 0.7.9

data/docs/render-docs.rb

@@ -11,7 +11,13 @@ palettes = YAML.load(File.read('../lib/pixelflow_canvas/palettes.yaml'))
 s = StringIO.open do |io|
     palettes.each do |name, palette|
         io.puts
-        io.puts "#### #{name}"
+        io.puts "#### #{name.to_s.gsub('_', ' ').capitalize}"
+        io.puts
+        io.puts <<~END_OF_STRING
+        ```ruby
+        set_predefined_palette(:#{name})
+        ```
+        END_OF_STRING
         io.puts
         io.puts "<div class='swatches'>"
         palette.each.with_index do |color, i|

data/lib/pixelflow_canvas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PixelflowCanvas
-  VERSION = "0.7.7"
+  VERSION = "0.7.9"
 end

data/lib/pixelflow_canvas.rb

@@ -47,14 +47,36 @@ module Pixelflow
             @compose_mode = :copy
             @palette = VGA_PALETTE.dup
             @socket = TCPSocket.new('127.0.0.1', 19223)
+
+
+            # Fast transport: all drawing changes the local framebuffer.
+            # Complete frames are sent instead of MOVE_TO/SET_PIXEL commands.
+            @dirty = false
+            @direct_frame_interval = 1.0 / 30.0
+            @direct_pixel_counter = 0
+            @last_present_timestamp =
+                Process.clock_gettime(Process::CLOCK_MONOTONIC)
             set_size(width, height)
             set_color_mode(color_mode) if color_mode
-            @last_timestamp = Time.now.to_f
+            @last_timestamp = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            at_exit do
+                begin
+                    present if @dirty && @socket && !@socket.closed?
+                rescue IOError, SystemCallError
+                    # VS Code may already have gone away during shutdown.
+                end
+            end
+
             if block_given?
                 instance_eval(&block)
+                present if @dirty
             end
         end
 
+        def inspect
+            "#<Pixelflow::Canvas @ #{@width}x#{@height}>"
+        end
+
         attr_reader :width, :height, :color_mode
 
         def run(&block)
@@ -123,23 +145,49 @@ module Pixelflow
         end
 
         def flip()
-            if @draw_mode == :buffered
-                @socket.write([7].pack('C'))
-                @socket.write(@screen.pack('C*'))
-                @socket.flush
-            end
+            present
+        end
+
+        # Send one complete framebuffer as one SET_BUFFER packet.
+        def present
+            return unless @dirty
+
+            packet = "\x07".b
+            packet << @screen.pack('C*')
+            @socket.write(packet)
+            @socket.flush
+
+            @dirty = false
+            @direct_pixel_counter = 0
+            @last_present_timestamp =
+                Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        end
+
+        # Direct mode remains progressive without checking the clock for
+        # every single pixel. We only test the 30 fps deadline every 1024
+        # pixel writes. Existing animation code gets an exact frame boundary
+        # through ensure_max_fps below.
+        def present_if_due
+            return unless @draw_mode == :direct && @dirty
+
+            @direct_pixel_counter += 1
+            return unless (@direct_pixel_counter & 1023).zero?
+
+            now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            present if now - @last_present_timestamp >= @direct_frame_interval
         end
 
         def ensure_max_fps(fps)
-            fps1 = 1.0 / fps
-            t = Time.now.to_f
+            # Existing examples call this once after drawing a frame.
+            present if @draw_mode == :direct && @dirty
+
+            frame_time = 1.0 / fps
+            now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
             if @last_timestamp
-                loop do
-                    sleep 0.01
-                    break if (Time.now.to_f - @last_timestamp) >= fps1
-                end
+                remaining = frame_time - (now - @last_timestamp)
+                sleep remaining if remaining > 0
             end
-            @last_timestamp = Time.now.to_f
+            @last_timestamp = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         end
 
         def save_as_png(path)
@@ -250,13 +298,9 @@ module Pixelflow
             x = x.to_i
             y = y.to_i
             return if x < 0 || x >= @width || y < 0 || y >= @height
+
             @x = x
             @y = y
-            buffer = [5].pack('C')
-            buffer += [x].pack((@width <= 256) ? 'C' : 'n')
-            buffer += [y].pack((@height <= 256) ? 'C' : 'n')
-            @socket.write(buffer)
-            @socket.flush
         end
 
         def set_pixel(x, y, r = nil, g = nil, b = nil)
@@ -300,14 +344,8 @@ module Pixelflow
                 offset = @y * @width + @x
                 @screen[offset] = r
             end
-            if @draw_mode == :direct
-                if @color_mode == :rgb
-                    @socket.write([6, r, g, b].pack('CCCC'))
-                else
-                    @socket.write([6, r].pack('CC'))
-                end
-                @socket.flush()
-            end
+            @dirty = true
+            present_if_due
             if @advance_mode == :right
                 @x += 1
                 if @x >= @width

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pixelflow_canvas
 version: !ruby/object:Gem::Version
-  version: 0.7.7
+  version: 0.7.9
 platform: ruby
 authors:
 - Michael Specht
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -84,7 +83,6 @@ metadata:
   homepage_uri: https://github.com/specht/pixelflow_canvas_ruby
   source_code_uri: https://github.com/specht/pixelflow_canvas_ruby
   changelog_uri: https://github.com/specht/pixelflow_canvas_ruby
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -99,8 +97,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.15
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Ruby driver for the Pixelflow Canvas VS Code extension.
 test_files: []