gif-info 0.1.0

data/lib/gif-info/block.rb

@@ -0,0 +1,84 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "abstract"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General block.
+    # @abstract
+    #
+    
+    class Block
+    
+        ##
+        # Holds IO object.
+        #
+        
+        @io
+        
+        ##
+        # Holds block position in stream.
+        #
+        
+        @position
+    
+        ##
+        # Returns header.
+        #
+        
+        def header
+            nil
+        end
+        
+        ##
+        # Returns body.
+        #
+        
+        def body
+            nil
+        end
+        
+        ##
+        # Constructor.
+        # @param [IO] io some IO object at appropriate offset
+        #
+        
+        def initialize(io)
+            @io = io
+            @position = io.pos
+            self.skip!
+        end
+        
+        ##
+        # Skips block in stream.
+        # @abstract
+        #
+        
+        def skip!
+            not_implemented
+        end
+        
+        ##
+        # Prepares to reading position.
+        #
+        
+        def prepare!
+            @io.seek(@position)
+        end
+        
+        ##
+        # Returns size of block in bytes.
+        # @abstract
+        #
+                
+        def bytesize
+            not_implemented
+        end
+    end
+end

data/lib/gif-info/blocks/application-extension.rb

@@ -0,0 +1,38 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/dynamic-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Application specific information to embedded in the GIF file itself.
+        #
+        
+        class ApplicationExtension < DynamicBlock
+            
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                skip {1}
+                uint8 :extension_type
+                uint8 :block_size
+                string (:application_identifier) {8}
+                string (:application_authentication_code) {3}
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/comment-extension.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/dynamic-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Contents textual comment data.
+        #
+        
+        class CommentExtension < DynamicBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                skip {1}
+                uint8 :extension_type
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/global-color-table.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/color-table"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # List of all the colors that can be in the image.
+        #
+        
+        class GlobalColorTable < ColorTable
+        end
+    end
+end

data/lib/gif-info/blocks/graphics-control-extension.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/fixed-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+    
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Used to specify transparency settings and control animations.
+        #
+        
+        class GraphicsControlExtension < FixedBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                skip {3}
+                byte (:packed) do
+                    number (:reserved) {3}
+                    number (:disposal_method) {3}
+                    boolean :user_input
+                    boolean :transparent_color
+                end
+                uint16 :delay_time
+                uint8 :transparent_color_index
+                skip {1}
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/header-block.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/fixed-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Signature and version.
+        #
+        
+        class HeaderBlock < FixedBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                string (:signature) {3}
+                string (:version) {3}
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/image-data.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/dynamic-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # series of output codes which tell the decoder which colors to 
+        # spit out to the canvas.
+        #
+        
+        class ImageData < DynamicBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                uint8 :lzw_minimum_code_size
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/image-descriptor.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/fixed-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Block for describing single image in GIF.
+        #
+        
+        class ImageDescriptor < FixedBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                skip {1}
+                uint16 :image_left
+                uint16 :image_top
+                uint16 :image_width
+                uint16 :image_height
+                byte (:packed) do
+                    boolean :local_color_table
+                    boolean :interlace
+                    boolean :local_color_table_sort
+                    number (:reserved) {2}
+                    number (:local_color_table_size) {3}
+                end
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/local-color-table.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/color-table"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # List of all the colors that can be in the image.
+        #
+        
+        class LocalColorTable < ColorTable
+        end
+    end
+end

data/lib/gif-info/blocks/logical-screen-descriptor.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/fixed-block"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Tells the decoder how much room this image will take up.
+        #
+        
+        class LogicalScreenDescriptor < FixedBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                uint16 :canvas_width
+                uint16 :canvas_height
+                byte (:packed) do 
+                    boolean :global_color_table
+                    number (:global_color_table_resolution) {3}
+                    boolean :global_color_table_sort
+                    number (:global_color_table_size) {3}
+                end
+                uint8 :background_color_index
+                uint8 :pixel_aspect_ratio
+            end
+        end
+    end
+end

data/lib/gif-info/blocks/plain-text-extension.rb

@@ -0,0 +1,77 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "gif-info/dynamic-block"
+require "gif-info/body"
+require "frozen-objects"
+
+##
+# Primary GifInfo module.
+#
+
+class GifInfo
+
+    ##
+    # General blocks module.
+    #
+    
+    module Blocks
+    
+        ##
+        # Specifies text which user wish to have rendered on the image.
+        # Support of this feature is very rare.
+        #
+        
+        class PlainTextExtension < DynamicBlock
+        
+            ##
+            # Byte structure.
+            #
+            
+            STRUCTURE = Frozen << Proc::new do
+                skip {1}
+                uint8 :extension_type
+                uint8 :block_size
+            end
+            
+            ##
+            # Returns data body.
+            #
+            # @param [Integer] skip number of bytes to skip before data
+            # @return [Body] data body
+            #
+
+            def body
+                super(__additional)
+            end
+            
+            ##
+            # Skips block in stream.
+            #
+     
+            def skip!
+                super(__additional)
+            end
+ 
+            ##
+            # Returns block size.
+            # @return [Integer] block size in bytes
+            #
+           
+            def bytesize
+                super + __additional
+            end
+
+            
+            private
+            
+            ##
+            # Returns additional length.
+            #
+            
+            def __additional
+                self.header.data.block_size
+            end
+        end
+    end
+end