ffi-gdal 1.0.4 → 1.1.0

data/lib/gdal/utils/rasterize.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require_relative "rasterize/options"
+
+module GDAL
+  module Utils
+    # Wrapper for gdal_rasterize using GDALRasterize C API.
+    #
+    # @see https://gdal.org/programs/gdal_rasterize.html gdal_rasterize utility documentation.
+    # @see https://gdal.org/api/gdal_utils.html#_CPPv413GDALRasterizePKc12GDALDatasetH12GDALDatasetHPK20GDALRasterizeOptionsPi
+    #   GDALRasterize C API.
+    class Rasterize
+      # Perform the gdal_rasterize (GDALRasterize) operation.
+      #
+      # @example Rasterize a dataset with options (for dst_dataset_path).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   options = GDAL::Utils::Rasterize::Options.new(options: ["-ts", "10", "10"])
+      #
+      #   dataset = GDAL::Utils::Rasterize.perform(
+      #     dst_dataset_path: "destination.tif",
+      #     src_dataset: src_dataset,
+      #     options: options
+      #   )
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.raster_x_size
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Rasterize a dataset (for dst_dataset_path) using block syntax.
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   options = GDAL::Utils::Rasterize::Options.new(options: ["-ts", "10", "10"])
+      #
+      #   GDAL::Utils::Rasterize.perform(
+      #     dst_dataset_path: "destination.tif",
+      #     src_dataset: src_dataset,
+      #     options: options
+      #   ) do |dataset|
+      #     # Do something with the dataset.
+      #     puts dataset.raster_x_size
+      #
+      #     # Dataset will be closed automatically.
+      #   end
+      #   src_dataset.close
+      #
+      # @example Rasterize a dataset (for dst_dataset).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   dst_dataset = GDAL::Dataset.open("destination.tif", "w")
+      #   options = GDAL::Utils::Rasterize::Options.new(options: ["-ts", "10", "10"])
+      #
+      #   GDAL::Utils::Rasterize.perform(dst_dataset: dst_dataset, src_dataset: src_dataset, options: options)
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dst_dataset.close
+      #   src_dataset.close
+      #
+      # @param dst_dataset_path [String] The path to the destination dataset.
+      # @param dst_dataset [GDAL::Dataset] The destination dataset.
+      # @param src_dataset [OGR::DataSource] The source dataset.
+      # @param options [GDAL::Utils::Rasterize::Options] Options.
+      # @yield [GDAL::Dataset] The destination dataset.
+      # @return [GDAL::Dataset] The destination dataset (only if block is not specified; dataset must be closed).
+      def self.perform(src_dataset:, dst_dataset: nil, dst_dataset_path: nil, options: Options.new, &block)
+        if dst_dataset
+          for_dataset(dst_dataset: dst_dataset, src_dataset: src_dataset, options: options)
+        else
+          for_dataset_path(dst_dataset_path: dst_dataset_path, src_dataset: src_dataset, options: options, &block)
+        end
+      end
+
+      def self.for_dataset(dst_dataset:, src_dataset:, options: Options.new)
+        result_dataset_ptr(dst_dataset: dst_dataset, src_dataset: src_dataset, options: options)
+
+        # Return the input dataset as the output dataset (dataset is modified in place).
+        dst_dataset
+      end
+      private_class_method :for_dataset
+
+      def self.for_dataset_path(dst_dataset_path:, src_dataset:, options: Options.new, &block)
+        dst_dataset_ptr = result_dataset_ptr(
+          dst_dataset_path: dst_dataset_path, src_dataset: src_dataset, options: options
+        )
+
+        ::GDAL::Dataset.open(dst_dataset_ptr, "w", &block)
+      end
+      private_class_method :for_dataset_path
+
+      def self.result_dataset_ptr(src_dataset:, dst_dataset_path: nil, dst_dataset: nil, options: Options.new)
+        result_code_ptr = ::FFI::MemoryPointer.new(:int)
+        dst_dataset_ptr = ::FFI::GDAL::Utils.GDALRasterize(
+          dst_dataset_path,
+          dst_dataset&.c_pointer,
+          src_dataset.c_pointer,
+          options.c_pointer,
+          result_code_ptr
+        )
+        success = result_code_ptr.read_int.zero?
+
+        raise ::GDAL::Error, "GDALRasterize failed." if dst_dataset_ptr.null? || !success
+
+        dst_dataset_ptr
+      end
+      private_class_method :result_dataset_ptr
+    end
+  end
+end

data/lib/gdal/utils/translate/options.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module GDAL
+  module Utils
+    class Translate
+      # Ruby wrapper for GDALTranslateOptions C API (options for gdal_translate utility).
+      #
+      # @see GDAL::Utils::Translate
+      # @see https://gdal.org/programs/gdal_translate.html gdal_translate utility documentation.
+      class Options
+        # @private
+        class AutoPointer < ::FFI::AutoPointer
+          # @param pointer [FFI::Pointer]
+          def self.release(pointer)
+            return unless pointer && !pointer.null?
+
+            ::FFI::GDAL::Utils.GDALTranslateOptionsFree(pointer)
+          end
+        end
+
+        # @return [AutoPointer] C pointer to the GDALTranslateOptions.
+        attr_reader :c_pointer
+
+        # @return [Array<String>] The options.
+        attr_reader :options
+
+        # Create a new instance.
+        #
+        # @see https://gdal.org/programs/gdal_translate.html
+        #   List of available options could be found in gdal_translate utility documentation.
+        #
+        # @example Create a new instance.
+        #  options = GDAL::Utils::Translate::Options.new(options: ["-of", "GTiff", "-co", "COMPRESS=DEFLATE"])
+        #
+        # @param options [Array<String>] The options list.
+        def initialize(options: [])
+          @options = options
+          @string_list = ::GDAL::Utils::Helpers::StringList.new(strings: options)
+          @c_pointer = AutoPointer.new(options_pointer)
+        end
+
+        private
+
+        attr_reader :string_list
+
+        def options_pointer
+          ::FFI::GDAL::Utils.GDALTranslateOptionsNew(string_list.c_pointer, nil)
+        end
+      end
+    end
+  end
+end

data/lib/gdal/utils/translate.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "translate/options"
+
+module GDAL
+  module Utils
+    # Wrapper for gdal_translate using GDALTranslate C API.
+    #
+    # @see https://gdal.org/programs/gdal_translate.html gdal_translate utility documentation.
+    # @see https://gdal.org/api/gdal_utils.html#gdal__utils_8h_1a1cf5b30de14ccaf847ae7a77bb546b28 GDALTranslate C API.
+    class Translate
+      # Perform the gdal_translate (GDALTranslate) operation.
+      #
+      # @example Translate a dataset.
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   dataset = GDAL::Utils::Translate.perform(dst_dataset_path: "destination.tif", src_dataset: src_dataset)
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.raster_x_size
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Translate a dataset with options.
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   dataset = GDAL::Utils::Translate.perform(
+      #     dst_dataset_path: "destination.tif",
+      #     src_dataset: src_dataset,
+      #     options: GDAL::Utils::Translate::Options.new(options: ["-of", "GTiff", "-co", "COMPRESS=DEFLATE"])
+      #   )
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.raster_x_size
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Translate a dataset using block syntax.
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   GDAL::Utils::Translate.perform(dst_dataset_path: "destination.tif", src_dataset: src_dataset) do |dataset|
+      #     # Do something with the dataset.
+      #     puts dataset.raster_x_size
+      #
+      #     # Dataset will be closed automatically.
+      #   end
+      #   src_dataset.close
+      #
+      # @param dst_dataset_path [String] The path to the destination dataset.
+      # @param src_dataset [GDAL::Dataset] The source dataset.
+      # @param options [GDAL::Utils::Translate::Options] Options.
+      # @yield [GDAL::Dataset] The destination dataset.
+      # @return [GDAL::Dataset] The destination dataset (only if block is not specified; dataset must be closed).
+      # @raise [GDAL::Error] If the operation fails.
+      def self.perform(dst_dataset_path:, src_dataset:, options: Options.new, &block)
+        result_code_ptr = ::FFI::MemoryPointer.new(:int)
+        dst_dataset_ptr = ::FFI::GDAL::Utils.GDALTranslate(
+          dst_dataset_path,
+          src_dataset.c_pointer,
+          options.c_pointer,
+          result_code_ptr
+        )
+        success = result_code_ptr.read_int.zero?
+
+        raise ::GDAL::Error, "GDALTranslate failed." if dst_dataset_ptr.null? || !success
+
+        ::GDAL::Dataset.open(dst_dataset_ptr, "w", &block)
+      end
+    end
+  end
+end

data/lib/gdal/utils/vector_translate/options.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module GDAL
+  module Utils
+    class VectorTranslate
+      # Ruby wrapper for GDALVectorTranslateOptions C API (options for ogr2ogr utility).
+      #
+      # @see GDAL::Utils::VectorTranslate
+      # @see https://gdal.org/programs/ogr2ogr.html ogr2ogr utility documentation.
+      class Options
+        # @private
+        class AutoPointer < ::FFI::AutoPointer
+          # @param pointer [FFI::Pointer]
+          def self.release(pointer)
+            return unless pointer && !pointer.null?
+
+            ::FFI::GDAL::Utils.GDALVectorTranslateOptionsFree(pointer)
+          end
+        end
+
+        # @return [AutoPointer] C pointer to the GDALVectorTranslateOptions.
+        attr_reader :c_pointer
+
+        # @return [Array<String>] The options.
+        attr_reader :options
+
+        # Create a new instance.
+        #
+        # @see https://gdal.org/programs/ogr2ogr.html
+        #   List of available options could be found in ogr2ogr utility documentation.
+        #
+        # @example Create a new instance.
+        #  options = GDAL::Utils::VectorTranslate::Options.new(options: ["-overwrite", "-nlt", "MULTIPOLYGON"])
+        #
+        # @param options [Array<String>] The options list.
+        def initialize(options: [])
+          @options = options
+          @string_list = ::GDAL::Utils::Helpers::StringList.new(strings: options)
+          @c_pointer = AutoPointer.new(options_pointer)
+        end
+
+        private
+
+        attr_reader :string_list
+
+        def options_pointer
+          ::FFI::GDAL::Utils.GDALVectorTranslateOptionsNew(string_list.c_pointer, nil)
+        end
+      end
+    end
+  end
+end

data/lib/gdal/utils/vector_translate.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require_relative "vector_translate/options"
+
+module GDAL
+  module Utils
+    # Wrapper for ogr2ogr using GDALVectorTranslate C API.
+    #
+    # @see https://gdal.org/programs/ogr2ogr.html ogr2ogr utility documentation.
+    # @see https://gdal.org/api/gdal_utils.html#_CPPv419GDALVectorTranslatePKc12GDALDatasetHiP12GDALDatasetHPK26GDALVectorTranslateOptionsPi
+    #   GDALVectorTranslate C API.
+    class VectorTranslate
+      # Perform the ogr2ogr (GDALVectorTranslate) operation.
+      #
+      # @example Translate a vector dataset (for dst_dataset_path).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   dataset = GDAL::Utils::VectorTranslate.perform(
+      #     dst_dataset_path: "destination.geojson",
+      #     src_datasets: [src_dataset]
+      #   )
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.layer(0).name
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Translate a vector dataset with options (for dst_dataset_path).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   dataset = GDAL::Utils::VectorTranslate.perform(
+      #     dst_dataset_path: "destination.geojson",
+      #     src_datasets: [src_dataset],
+      #     options: GDAL::Utils::VectorTranslate::Options.new(options: ["-nlt", "MULTIPOLYGON"])
+      #   )
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.layer(0).name
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Translate a vector dataset using block syntax (for dst_dataset_path).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   GDAL::Utils::VectorTranslate.perform(
+      #     dst_dataset_path: "destination.geojson",
+      #     src_datasets: [src_dataset]
+      #   ) do |dataset|
+      #     # Do something with the dataset.
+      #     puts dataset.layer(0).name
+      #
+      #     # Dataset will be closed automatically.
+      #   end
+      #   src_dataset.close
+      #
+      # @example Translate a vector dataset (for dst_dataset).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   dst_dataset = OGR::DataSource.open("destination.geojson", "w")
+      #
+      #   GDAL::Utils::VectorTranslate.perform(dst_dataset: dst_dataset, src_datasets: [src_dataset])
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dst_dataset.close
+      #   src_dataset.close
+      #
+      # @example Translate a vector dataset with options (for dst_dataset).
+      #   src_dataset = OGR::DataSource.open("source.shp", "r")
+      #   dst_dataset = OGR::DataSource.open("destination.geojson", "w")
+      #
+      #   GDAL::Utils::VectorTranslate.perform(
+      #     dst_dataset: dst_dataset,
+      #     src_datasets: [src_dataset],
+      #     options: GDAL::Utils::VectorTranslate::Options.new(options: ["-nlt", "MULTIPOLYGON"])
+      #   )
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dst_dataset.close
+      #   src_dataset.close
+      #
+      # @param dst_dataset_path [String] The path to the destination dataset.
+      # @param dst_dataset [OGR::DataSource] The destination dataset.
+      # @param src_datasets [Array<OGR::DataSource>] The source datasets.
+      # @param options [GDAL::Utils::VectorTranslate::Options] Options.
+      # @yield [OGR::DataSource] The destination dataset.
+      # @return [OGR::DataSource] The destination dataset (only if block is not specified; dataset must be closed).
+      def self.perform(dst_dataset: nil, dst_dataset_path: nil, src_datasets: [], options: Options.new, &block)
+        if dst_dataset
+          for_dataset(dst_dataset: dst_dataset, src_datasets: src_datasets, options: options)
+        else
+          for_dataset_path(dst_dataset_path: dst_dataset_path, src_datasets: src_datasets, options: options, &block)
+        end
+      end
+
+      def self.for_dataset(dst_dataset:, src_datasets: [], options: Options.new)
+        result_dataset_ptr(dst_dataset: dst_dataset, src_datasets: src_datasets, options: options)
+
+        # Return the input dataset as the output dataset (dataset is modified in place).
+        dst_dataset
+      end
+      private_class_method :for_dataset
+
+      def self.for_dataset_path(dst_dataset_path:, src_datasets: [], options: Options.new, &block)
+        dst_dataset_ptr = result_dataset_ptr(
+          dst_dataset_path: dst_dataset_path, src_datasets: src_datasets, options: options
+        )
+
+        ::OGR::DataSource.open(dst_dataset_ptr, "w", &block)
+      end
+      private_class_method :for_dataset_path
+
+      def self.result_dataset_ptr(dst_dataset_path: nil, dst_dataset: nil, src_datasets: [], options: Options.new)
+        src_dataset_list = ::GDAL::Utils::Helpers::DatasetList.new(datasets: src_datasets)
+        result_code_ptr = ::FFI::MemoryPointer.new(:int)
+        dst_dataset_ptr = ::FFI::GDAL::Utils.GDALVectorTranslate(
+          dst_dataset_path,
+          dst_dataset&.c_pointer,
+          src_dataset_list.count,
+          src_dataset_list.c_pointer,
+          options.c_pointer,
+          result_code_ptr
+        )
+        success = result_code_ptr.read_int.zero?
+
+        raise ::GDAL::Error, "GDALVectorTranslate failed." if dst_dataset_ptr.null? || !success
+
+        dst_dataset_ptr
+      end
+      private_class_method :result_dataset_ptr
+    end
+  end
+end

data/lib/gdal/utils/warp/options.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module GDAL
+  module Utils
+    class Warp
+      # Ruby wrapper for GDALWarpAppOptions C API (options for ogr2ogr utility).
+      #
+      # @see GDAL::Utils::Warp
+      # @see https://gdal.org/programs/gdalwarp.html gdalwarp utility documentation.
+      class Options
+        # @private
+        class AutoPointer < ::FFI::AutoPointer
+          # @param pointer [FFI::Pointer]
+          def self.release(pointer)
+            return unless pointer && !pointer.null?
+
+            ::FFI::GDAL::Utils.GDALWarpAppOptionsFree(pointer)
+          end
+        end
+
+        # @return [AutoPointer] C pointer to the GDALWarpAppOptions.
+        attr_reader :c_pointer
+
+        # @return [Array<String>] The options.
+        attr_reader :options
+
+        # Create a new instance.
+        #
+        # @see https://gdal.org/programs/gdalwarp.html
+        #   List of available options could be found in gdalwarp utility documentation.
+        #
+        # @example Create a new instance.
+        #  options = GDAL::Utils::Warp::Options.new(options: ["-multi", "-wo", "CUTLINE_ALL_TOUCHED=TRUE"])
+        #
+        # @param options [Array<String>] The options list.
+        def initialize(options: [])
+          @options = options
+          @string_list = ::GDAL::Utils::Helpers::StringList.new(strings: options)
+          @c_pointer = AutoPointer.new(options_pointer)
+        end
+
+        private
+
+        attr_reader :string_list
+
+        def options_pointer
+          ::FFI::GDAL::Utils.GDALWarpAppOptionsNew(string_list.c_pointer, nil)
+        end
+      end
+    end
+  end
+end

data/lib/gdal/utils/warp.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require_relative "warp/options"
+
+module GDAL
+  module Utils
+    # Wrapper for gdalwarp using GDALWarp C API.
+    #
+    # @see https://gdal.org/programs/gdalwarp.html gdalwarp utility documentation.
+    # @see https://gdal.org/api/gdal_utils.html#_CPPv48GDALWarpPKc12GDALDatasetHiP12GDALDatasetHPK18GDALWarpAppOptionsPi
+    #   GDALWarp C API.
+    class Warp
+      # Perform the gdalwarp (GDALWarp) operation.
+      #
+      # @example Warp a dataset (for dst_dataset_path).
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   options = GDAL::Utils::Warp::Options.new(options: ["-t_srs", "EPSG:3857"])
+      #
+      #   dataset = GDAL::Utils::Warp.perform(
+      #     dst_dataset_path: "destination.tif",
+      #     src_datasets: [src_dataset],
+      #     options: options
+      #   )
+      #
+      #   # Do something with the dataset.
+      #   puts dataset.raster_x_size
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dataset.close
+      #   src_dataset.close
+      #
+      # @example Warp a dataset (for dst_dataset_path) using block syntax.
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   options = GDAL::Utils::Warp::Options.new(options: ["-t_srs", "EPSG:3857"])
+      #
+      #   GDAL::Utils::Warp.perform(
+      #     dst_dataset_path: "destination.tif",
+      #     src_datasets: src_dataset,
+      #     options: options
+      #   ) do |dataset|
+      #     # Do something with the dataset.
+      #     puts dataset.raster_x_size
+      #
+      #     # Dataset will be closed automatically.
+      #   end
+      #   src_dataset.close
+      #
+      # @example Warp a dataset (for dst_dataset).
+      #   src_dataset = GDAL::Dataset.open("source.tif", "r")
+      #   dst_dataset = GDAL::Dataset.open("destination.tif", "w") # Dataset with other projection.
+      #
+      #   GDAL::Utils::Warp.perform(dst_dataset: dst_dataset, src_datasets: [src_dataset])
+      #
+      #   # You must close the dataset when you are done with it.
+      #   dst_dataset.close
+      #   src_dataset.close
+      #
+      # @param dst_dataset_path [String] The path to the destination dataset.
+      # @param dst_dataset [GDAL::Dataset] The destination dataset.
+      # @param src_datasets [Array<GDAL::Dataset>] The source datasets.
+      # @param options [GDAL::Utils::Warp::Options] Options.
+      # @yield [GDAL::Dataset] The destination dataset.
+      # @return [GDAL::Dataset] The destination dataset (only if block is not specified; dataset must be closed).
+      def self.perform(dst_dataset: nil, dst_dataset_path: nil, src_datasets: [], options: Options.new, &block)
+        if dst_dataset
+          for_dataset(dst_dataset: dst_dataset, src_datasets: src_datasets, options: options)
+        else
+          for_dataset_path(dst_dataset_path: dst_dataset_path, src_datasets: src_datasets, options: options, &block)
+        end
+      end
+
+      # @param dst_dataset [GDAL::Dataset] The destination dataset.
+      # @param src_datasets [Array<GDAL::Dataset>] The source datasets.
+      # @param options [GDAL::Utils::Warp::Options] Options.
+      # @return [GDAL::Dataset] The destination dataset (it's the same object as dst_dataset).
+      def self.for_dataset(dst_dataset:, src_datasets: [], options: Options.new)
+        result_dataset_ptr(dst_dataset: dst_dataset, src_datasets: src_datasets, options: options)
+
+        # Return the input dataset as the output dataset (dataset is modified in place).
+        dst_dataset
+      end
+      private_class_method :for_dataset
+
+      # @param dst_dataset_path [String] The path to the destination dataset.
+      # @param src_datasets [Array<GDAL::Dataset>] The source datasets.
+      # @param options [GDAL::Utils::Warp::Options] Options.
+      # @yield [GDAL::Dataset] The destination dataset.
+      # @return [GDAL::Dataset] The destination dataset (only if block is not specified; dataset must be closed).
+      def self.for_dataset_path(dst_dataset_path:, src_datasets: [], options: Options.new, &block)
+        dst_dataset_ptr = result_dataset_ptr(
+          dst_dataset_path: dst_dataset_path, src_datasets: src_datasets, options: options
+        )
+
+        ::GDAL::Dataset.open(dst_dataset_ptr, "w", &block)
+      end
+      private_class_method :for_dataset_path
+
+      def self.result_dataset_ptr(dst_dataset_path: nil, dst_dataset: nil, src_datasets: [], options: Options.new)
+        src_dataset_list = ::GDAL::Utils::Helpers::DatasetList.new(datasets: src_datasets)
+        result_code_ptr = ::FFI::MemoryPointer.new(:int)
+        dst_dataset_ptr = ::FFI::GDAL::Utils.GDALWarp(
+          dst_dataset_path,
+          dst_dataset&.c_pointer,
+          src_dataset_list.count,
+          src_dataset_list.c_pointer,
+          options.c_pointer,
+          result_code_ptr
+        )
+        success = result_code_ptr.read_int.zero?
+
+        raise ::GDAL::Error, "GDALWarp failed." if dst_dataset_ptr.null? || !success
+
+        dst_dataset_ptr
+      end
+      private_class_method :result_dataset_ptr
+    end
+  end
+end

data/lib/gdal/utils.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module GDAL
+  # Wrappers for the GDAL utilities.
+  #
+  # @see https://gdal.org/programs/index.html GDAL Utils documentation (gdalwarp, gdal_translate, ...).
+  # @see https://gdal.org/api/gdal_utils.html GDAL Utils C API.
+  module Utils
+    # Internal helpers
+    autoload :Helpers, File.expand_path("utils/helpers", __dir__)
+
+    # GDAL Utils
+    autoload :DEM, File.expand_path("utils/dem", __dir__)
+    autoload :Grid, File.expand_path("utils/grid", __dir__)
+    autoload :Nearblack, File.expand_path("utils/nearblack", __dir__)
+    autoload :Rasterize, File.expand_path("utils/rasterize", __dir__)
+    autoload :Info, File.expand_path("utils/info", __dir__)
+    autoload :Translate, File.expand_path("utils/translate", __dir__)
+    autoload :VectorTranslate, File.expand_path("utils/vector_translate", __dir__)
+    autoload :Warp, File.expand_path("utils/warp", __dir__)
+  end
+end

data/lib/gdal/warp_options.rb

@@ -12,7 +12,7 @@ module GDAL
       @destination_dataset = nil
 
       options.each_key do |k|
-        assign_meth = "#{k}=".to_sym
+        assign_meth = :"#{k}="
 
         begin
           if respond_to?(assign_meth)
@@ -175,8 +175,17 @@ module GDAL
     def source_per_band_validity_mask_function=(band_procs)
       mask_func = FFI::GDAL::Warper::MaskFunc
 
+      mask_func_return_type =
+        if mask_func.respond_to?(:return_type)
+          # `.return_type` is for FFI 1.16.0+;
+          mask_func.return_type
+        else
+          # `.result_type` is for older FFI versions.
+          mask_func.result_type
+        end
+
       funcs = band_procs.map do |band_proc|
-        FFI::Function.new(mask_func.result_type, mask_func.param_types, band_proc, blocking: true)
+        FFI::Function.new(mask_func_return_type, mask_func.param_types, band_proc, blocking: true)
       end
 
       pointer = FFI::MemoryPointer.new(:pointer, band_procs.length)

data/lib/gdal.rb

@@ -37,6 +37,7 @@ module GDAL
   autoload :Options,              gdal_require("gdal/options")
   autoload :RasterAttributeTable, gdal_require("gdal/raster_attribute_table")
   autoload :RasterBand,           gdal_require("gdal/raster_band")
+  autoload :Utils,                gdal_require("gdal/utils")
 end
 
 require_relative "gdal/exceptions"

data/lib/ogr/extensions/layer/extensions.rb

@@ -130,7 +130,7 @@ module OGR
         # least at this point), it needs to be as fast as possible.
         each_feature_pointer do |feature_ptr| # rubocop:todo Metrics/BlockLength
           field_values = field_indices.map.with_index do |j, attribute_index|
-            FFI::OGR::API.send("OGR_F_GetFieldAs#{with_attributes.values[attribute_index].capitalize}", feature_ptr, j)
+            FFI::OGR::API.send(:"OGR_F_GetFieldAs#{with_attributes.values[attribute_index].capitalize}", feature_ptr, j)
           end
 
           geom_ptr = FFI::OGR::API.OGR_F_GetGeometryRef(feature_ptr)

data/lib/ogr/extensions/spatial_reference/extensions.rb

@@ -11,8 +11,8 @@ module OGR
       # @raise [NameError] If the +unit_label+ isn't of a known type.
       def angular_units=(unit_label)
         unit_name = unit_label.to_s.upcase
-        unit_label = self.class.const_get("#{unit_name}_LABEL".to_sym)
-        unit_value = self.class.const_get("RADIAN_TO_#{unit_name}".to_sym)
+        unit_label = self.class.const_get(:"#{unit_name}_LABEL")
+        unit_value = self.class.const_get(:"RADIAN_TO_#{unit_name}")
 
         set_angular_units(unit_label, unit_value)
       rescue NameError
@@ -24,8 +24,8 @@ module OGR
       # @raise [NameError] If the +unit_label+ isn't of a known type.
       def linear_units=(unit_label)
         unit_name = unit_label.to_s.upcase
-        unit_label = self.class.const_get("#{unit_name}_LABEL".to_sym)
-        unit_value = self.class.const_get("METER_TO_#{unit_name}".to_sym)
+        unit_label = self.class.const_get(:"#{unit_name}_LABEL")
+        unit_value = self.class.const_get(:"METER_TO_#{unit_name}")
 
         set_linear_units(unit_label, unit_value)
       rescue NameError