graffik 0.0.1

data/README.markdown

@@ -0,0 +1,20 @@
+Graffik
+=======
+
+Graffik is a fast, light-weight image manipulation library.
+
+Example
+-------
+
+	Graffic::Image('photo.jpg') do |img|
+		img.thumbnail(500) do |resized|
+			resized.write('thumbnail.jpg')
+		end
+	end
+
+Requirements
+------------
+
+ * [FreeImage][1]
+
+[1]: http://freeimage.sourceforge.net/ "FreeImage"

data/Rakefile

@@ -0,0 +1,14 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "graffik"
+    gemspec.summary = "Graffik is a fast, light-weight image manipulation library."
+    gemspec.description = "Graffik is a Ruby wrapper for the FreeImage library."
+    gemspec.email = "jeremy@jeremyboles.com"
+    gemspec.homepage = "http://github.com/jeremyboles/Graffik"
+    gemspec.authors = ["Jeremy Boles"]
+    gemspec.files.exclude '.DS_Store', '.gitignore'
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/ext/graffik/extconf.rb

@@ -0,0 +1,14 @@
+# Loads mkmf which is used to make makefiles for Ruby extensions
+require 'mkmf'
+
+# Add FreeImage
+$LIBS << "-lfreeimage"
+
+# Give it a name
+extension_name = 'graffik'
+
+# The destination
+dir_config(extension_name)
+
+# Do the work
+create_makefile(extension_name)

data/ext/graffik/graffik.c

@@ -0,0 +1,248 @@
+// Include the Ruby headers
+#include "ruby.h"
+#include "freeimage.h"
+
+static VALUE rb_mGraffik;
+static VALUE rb_cImage;
+
+FIBITMAP *get_instance_image(VALUE self) {
+  FIBITMAP *image; // Place to store the image
+  Data_Get_Struct(self, FIBITMAP, image); // Load the image data from the instance
+  
+  // Throw error if the image has already been closed
+  if (!image) {
+    rb_raise(rb_eTypeError, "Image has already been closed");
+  }
+  
+  return image;
+}
+
+VALUE rb_graffik_close(VALUE self) {
+  FIBITMAP *image = get_instance_image(self);
+  FreeImage_Unload(image); // Free the image from memory
+  DATA_PTR(self) = NULL; // Release the data for Ruby
+  return Qnil; // Return nil back
+}
+
+VALUE rb_graffik_crop(VALUE self, VALUE rb_left, VALUE rb_top, VALUE rb_right, VALUE rb_bottom) {
+  // Convert Ruby numbers to C numbers
+  int top = FIX2INT(rb_top), right = FIX2INT(rb_right), bottom = FIX2INT(rb_bottom), left = FIX2INT(rb_left);
+  // Load our image and specifiy where to put the copy
+  FIBITMAP *image = get_instance_image(self);
+  // Crop the image
+  FIBITMAP *cropped = FreeImage_Copy(image, left, top, right, bottom);
+  // Create a new instance for Ruby
+  VALUE instance = Data_Wrap_Struct(CLASS_OF(self), NULL, NULL, cropped);
+  rb_iv_set(instance, "@file_type", rb_iv_get(self, "@file_type"));
+  
+  // If a block is given, yield to it, if not, return the instance
+  if (rb_block_given_p()) {
+   return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+  } else {
+   return instance;
+  }
+}
+
+VALUE rb_graffik_cropped_thumbnail(VALUE self, VALUE rb_size) {
+  // Convert the Ruby numbers to C numbers
+  int size = FIX2INT(rb_size);
+  // Load our image
+  FIBITMAP *image = get_instance_image(self);
+  // Get dimensions
+  int width = FreeImage_GetWidth(image), height = FreeImage_GetHeight(image);
+  int left = 0, top = 0, right = width, bottom = height;
+  int half = (width - height) / 2;
+  
+  if (width > height) {
+    left = half;
+    right = half + height;
+  }
+  
+  if (height > width) {
+    top = half;
+    bottom = half + width;
+  }
+  
+  // Crop the image
+  FIBITMAP *cropped = FreeImage_Copy(image, left, top, right, bottom);
+  // Resize the image
+  FIBITMAP *thumbnail = FreeImage_MakeThumbnail(cropped, size, TRUE);
+  // Create a new instance for Ruby
+  VALUE instance = Data_Wrap_Struct(CLASS_OF(self), NULL, NULL, thumbnail);
+  rb_iv_set(instance, "@file_type", rb_iv_get(self, "@file_type"));
+   
+   // If a block is given, yield to it, if not, return the instance
+  if (rb_block_given_p()) {
+    return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+  } else {
+    return instance;
+  }
+}
+
+VALUE rb_graffik_from_memory(VALUE self, VALUE rb_data) {
+  FREE_IMAGE_FORMAT fif = FIF_UNKNOWN;
+  Check_Type(rb_data, T_STRING);
+  
+  // Get info about our in-memory image
+  BYTE *data_ptr = (BYTE *) RSTRING_PTR(rb_data);
+  DWORD data_length = RSTRING_LEN(rb_data);
+  
+  // Open up the memory stream
+  FIMEMORY *stream = FreeImage_OpenMemory(data_ptr, data_length);
+  
+  // Make sure the stream was open
+  if (stream == NULL) {
+    rb_raise(rb_eTypeError, "Unable to read image from memory");
+  }
+  
+  fif = FreeImage_GetFileTypeFromMemory(stream, 0);
+  if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsReading(fif)) {
+    int flags = ((fif == FIF_JPEG) ? JPEG_ACCURATE : 0);
+    // Load the image from disk
+    FIBITMAP *image = FreeImage_LoadFromMemory(fif, stream, flags);
+    // Release memory
+    FreeImage_CloseMemory(stream);
+    // Develop an instance for Ruby
+    VALUE instance = Data_Wrap_Struct(self, NULL, NULL, image);
+    // Store the image type as a FixNum
+    rb_iv_set(instance, "@file_type", INT2FIX(fif));
+    
+    // If a block is given, yield to it, if not, return the instance
+    if (rb_block_given_p()) {
+      return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+    } else {
+      return instance;
+    }
+  }
+  
+  // If we couldn't load it, throw and error
+  rb_raise(rb_eTypeError, "Unknown file format");
+}
+
+VALUE rb_graffik_height(VALUE self) {
+  FIBITMAP *image = get_instance_image(self);
+  int height = FreeImage_GetHeight(image); // Height from FreeImage
+  
+  return INT2FIX(height);
+}
+
+VALUE rb_graffik_open(VALUE self, VALUE rb_filename) {
+  char *filename = STR2CSTR(rb_filename);
+  FREE_IMAGE_FORMAT fif = FIF_UNKNOWN;
+  
+  // Try various methods to thet the image format
+  fif = FreeImage_GetFileType(filename, 0);
+  if (fif == FIF_UNKNOWN) {
+    fif = FreeImage_GetFIFFromFilename(filename);
+  }
+  
+  if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsReading(fif)) {
+    int flags = ((fif == FIF_JPEG) ? JPEG_ACCURATE : 0);
+    // Load the image from disk
+    FIBITMAP *image = FreeImage_Load(fif, filename, flags);
+    // Develop an instance for Ruby
+    VALUE instance = Data_Wrap_Struct(self, NULL, NULL, image);
+    // Store the image type as a FixNum
+    rb_iv_set(instance, "@file_type", INT2FIX(fif));
+    
+    // If a block is given, yield to it, if not, return the instance
+    if (rb_block_given_p()) {
+      return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+    } else {
+      return instance;
+    }
+  }
+  
+  // If we couldn't load it, throw and error
+  rb_raise(rb_eTypeError, "Unknown file format");
+}
+
+VALUE rb_graffik_resize(VALUE self, VALUE rb_width, VALUE rb_height) {
+  // Convert the Ruby numbers to C numbers
+  int width = FIX2INT(rb_width), height = FIX2INT(rb_height);
+  // Load our image
+  FIBITMAP *image = get_instance_image(self);
+  // Resize the image
+  FIBITMAP *resized = FreeImage_Rescale(image, width, height, FILTER_CATMULLROM);
+  // Create a new instance for Ruby
+  VALUE instance = Data_Wrap_Struct(CLASS_OF(self), NULL, NULL, resized);
+  rb_iv_set(instance, "@file_type", rb_iv_get(self, "@file_type"));
+   
+   // If a block is given, yield to it, if not, return the instance
+  if (rb_block_given_p()) {
+    return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+  } else {
+    return instance;
+  }
+}
+
+VALUE rb_graffik_thumbnail(VALUE self, VALUE rb_size) {
+  // Convert the Ruby numbers to C numbers
+  int size = FIX2INT(rb_size);
+  // Load our image
+  FIBITMAP *image = get_instance_image(self);
+  // Resize the image
+  FIBITMAP *thumbnail = FreeImage_MakeThumbnail(image, size, TRUE);
+  // Create a new instance for Ruby
+  VALUE instance = Data_Wrap_Struct(CLASS_OF(self), NULL, NULL, thumbnail);
+  rb_iv_set(instance, "@file_type", rb_iv_get(self, "@file_type"));
+   
+   // If a block is given, yield to it, if not, return the instance
+  if (rb_block_given_p()) {
+    return rb_ensure(rb_yield, instance, rb_graffik_close, instance);
+  } else {
+    return instance;
+  }
+}
+
+VALUE rb_graffik_width(VALUE self) {
+  FIBITMAP *image = get_instance_image(self);
+  int width = FreeImage_GetWidth(image); // Width from FreeImage
+  
+  return INT2FIX(width);
+}
+
+VALUE rb_graffik_write(VALUE self, VALUE rb_filename) {
+  char *filename = STR2CSTR(rb_filename);
+  FREE_IMAGE_FORMAT fif = FIF_UNKNOWN;
+  
+  // Try various methods to get the image format
+  fif = FreeImage_GetFIFFromFilename(filename);
+  if (fif == FIF_UNKNOWN) {
+    fif = FIX2INT(rb_iv_get(self, "@file_type"));
+  }
+  
+  if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsWriting(fif)) {
+    int flags = fif == FIF_JPEG ? JPEG_QUALITYSUPERB : 0;
+    // Load the image from the instance
+    FIBITMAP *image = get_instance_image(self);
+
+    // Return Ruby objects for the write status from FreeImage
+    return FreeImage_Save(fif, image, filename, flags) ? Qtrue : Qfalse;
+  }
+  
+  rb_raise(rb_eTypeError, "Unknown file format");
+}
+
+// Intialize extension
+void Init_graffik() {
+  // Define the Graffik module
+  rb_mGraffik = rb_define_module("Graffik");
+  
+  // Image class
+  rb_cImage = rb_define_class_under(rb_mGraffik, "Image", rb_cObject);
+  
+  // Image class methods
+  rb_define_singleton_method(rb_cImage, "open", rb_graffik_open, 1);
+  rb_define_singleton_method(rb_cImage, "from_memory", rb_graffik_from_memory, 1);
+  
+  // Image instance methods
+  rb_define_method(rb_cImage, "crop", rb_graffik_crop, 4);
+  rb_define_method(rb_cImage, "cropped_thumbnail", rb_graffik_cropped_thumbnail, 1);
+  rb_define_method(rb_cImage, "close", rb_graffik_close, 0);
+  rb_define_method(rb_cImage, "height", rb_graffik_height, 0);
+  rb_define_method(rb_cImage, "resize", rb_graffik_resize, 2);
+  rb_define_method(rb_cImage, "thumbnail", rb_graffik_thumbnail, 1);
+  rb_define_method(rb_cImage, "width", rb_graffik_width, 0);
+  rb_define_method(rb_cImage, "write", rb_graffik_write, 1);
+}

data/graffik.gemspec

@@ -0,0 +1,43 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{graffik}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeremy Boles"]
+  s.date = %q{2010-06-01}
+  s.description = %q{Graffik is a Ruby wrapper for the FreeImage library.}
+  s.email = %q{jeremy@jeremyboles.com}
+  s.extensions = ["ext/graffik/extconf.rb"]
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "ext/graffik/extconf.rb",
+     "ext/graffik/graffik.c",
+     "graffik.gemspec"
+  ]
+  s.homepage = %q{http://github.com/jeremyboles/Graffik}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Graffik is a fast, light-weight image manipulation library.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: graffik
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jeremy Boles
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-01 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Graffik is a Ruby wrapper for the FreeImage library.
+email: jeremy@jeremyboles.com
+executables: []
+
+extensions: 
+- ext/graffik/extconf.rb
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- VERSION
+- ext/graffik/extconf.rb
+- ext/graffik/graffik.c
+- graffik.gemspec
+has_rdoc: true
+homepage: http://github.com/jeremyboles/Graffik
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Graffik is a fast, light-weight image manipulation library.
+test_files: []
+