Contents

ffi-gdal
========

Ruby wrapper around GDAL, using FFI, along with some helper methods.

Installation
------------

Add this line to your application's Gemfile:

    gem 'ffi-gdal'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install ffi-gdal

Usage
-----

ffi-gdal provides two interfaces, really: the direct FFI wrapper around GDAL's
C API, and a Ruby-fied interface that uses the FFI wrapper to make use more
like using an object-oriented library instead of a functional one.  Most likely
you'll just want to use the Ruby-fied library, but if for some reason that
doesn't get you what you want, direct access to the FFI wrapper (which is
really just direct access to the C API) is available.


### The Ruby-fied Library

To distinguish this gem from the already-existing gdal gem, you
`require ffi-gdal` to get access to the `GDAL` module and its children.


### The direct FFI wrapper

Following RubyGem conventions, to get access to the FFI wrapper, you
`require ffi/gdal`.


Testing
-------

You'll need some images to run the integration specs against, and instead of
keeping those as part of this repo, there's a Rake task that will pull OSGeo's
set of sample geotiffs down via FTP.  Running `rake get_tifs` will pull
everything down from ftp://downloads.osgeo.org/geotiff/samples and put the
files under spec/support/images/osgeo/geotiff.

Contributing
------------

1. Fork it ( https://github.com/turboladen/ffi-gdal/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
ffi-gdal-1.0.0.beta3	README.md
ffi-gdal-1.0.0.beta1	README.md
ffi-gdal-0.0.4	README.md
ffi-gdal-0.0.3	README.md
ffi-gdal-0.0.2	README.md
ffi-gdal-0.0.1	README.md