ruby-gr 0.0.14 → 0.0.19

data/lib/gr3.rb

@@ -2,43 +2,48 @@
 
 # OverView of GR.rb
 #
-#                            +--------------------+
-#     +-------------------+  | GR3 module         |
-#     | GR module         |  | +----------------+ |
-#     | +---------------+ |  | | GR3::FFI       | |
-#     | | GR::FFI       | |  | | +    libGR3.so | |
-#     | | +   libGR.so  | |  | +----------------+ |
-#     | +---------------+ |  |   | define_method  |
-#     |   | define_method |  | +----------------+ |
-#     | +---------------+ |  | | | GR3::GR3Base | |
-#     | | | GR::GRBase  | |  | | v  (Private)   | |
-#     | | v  (Private)  | |  | +++--------------+ |
-#     | +++-------------+ |  |  | Extend          |
-#     |  | Extend         |  |  v        +------+ |
-#     |  v                |  |           |Check | |
-#     |                   |  |        <--+Error | |
-#     +-------+-----------+  |           +------+ |
-#             ^              +---------+----------+
-#             |  +------------------+  ^
-#      Extend |  | GRCommons module |  | Extend
-#             |  | +--------------+ |  |
-#             |  | |    Fiddley   | |  |
-#             |  | +--------------+ |  |
-#             |  | +--------------+ |  |
-#             +----+ CommonUtils  +----+
-#             |  | +--------------+ |  |
-#             |  | +--------------+ |  |
-#             +----+    Version   +----+
-#             |  | +--------------+ |
-#             |  | +--------------+ |
-#             +----+JupyterSupport| |
-#                | +--------------+ |
-#                +------------------+
+#  +--------------------+  +--------------------+
+#  | GR module          |  | GR3 module         |
+#  | +----------------+ |  | +----------------+ |
+#  | | GR::FFI        | |  | | GR3::FFI       | |
+#  | | +   libGR.so   | |  | | +    libGR3.so | |
+#  | +----------------+ |  | +----------------+ |
+#  |   | define_method  |  |   | define_method  |
+#  | +----------------+ |  | +----------------+ |
+#  | | | GR::GRBase   | |  | | | GR3::GR3Base | |
+#  | | v  (Pri^ate)   | |  | | v  (Pri^ate)   | |
+#  | +++--------------+ |  | +++--------------+ |
+#  |  | Extend          |  |  | Extend          |
+#  |  v                 |  |  v       +-------+ |
+#  |      +-----------+ |  |          | Check | |
+#  |      | GR::Plot  | |  |       <--+ Error | |
+#  |      +-----------+ |  |          +-------+ |
+#  +--------------------+  +----------+---------+
+#            ^                        ^
+#            |  +------------------+  |
+#     Extend |  | GRCommons module |  | Extend
+#            |  | +--------------+ |  |
+#            |  | |    Fiddley   | |  |
+#            |  | +--------------+ |  |
+#            |  | +--------------+ |  |
+#            +----+ CommonUtils  +----+
+#            |  | +--------------+ |  |
+#            |  | +--------------+ |  |
+#            +----+    Version   +----+
+#            |  | +--------------+ |
+#            |  | +--------------+ |
+#            +----+JupyterSupport| |
+#               | +--------------+ |
+#               +------------------+
+#
+# (You can edit the above AA diagram with http://asciiflow.com/)
+#
+# Fiddley is Ruby-FFI compatible API layer for Fiddle.
 #
 # Why not GR::GR3?
 # * kojix2 did not want to force gr3 to be loaded when gr is loaded.
 # * kojix2 did not want to write `GR3 = GR::GR3` or something.
-# * This is a opinion of kojix2 and may be changed in the future.
+# * This is a opinion of kojix2 and may be changed by future maintainers.
 #
 # GR3 uses Numo::Narrray.
 # * It is difficult to write GR3 modules with only Ruby arrays.
@@ -55,20 +60,24 @@ module GR3
     attr_accessor :ffi_lib
   end
 
-  raise Error, 'Please set env variable GRDIR' unless ENV['GRDIR']
-
   # Platforms |  path
   # Windows   |  bin/libGR3.dll
   # MacOSX    |  lib/libGR3.so (NOT .dylib)
   # Ubuntu    |  lib/libGR3.so
   if Object.const_defined?(:RubyInstaller)
+    ENV['GRDIR'] ||= [
+      RubyInstaller::Runtime.msys2_installation.msys_path,
+      RubyInstaller::Runtime.msys2_installation.mingwarch
+    ].join(File::ALT_SEPARATOR)
     self.ffi_lib = File.expand_path('bin/libGR3.dll', ENV['GRDIR'])
     RubyInstaller::Runtime.add_dll_directory(File.dirname(ffi_lib))
   else
+    raise Error, 'Please set env variable GRDIR' unless ENV['GRDIR']
+
     self.ffi_lib = File.expand_path('lib/libGR3.so', ENV['GRDIR'])
   end
 
-  # change the default encoding to UTF-8
+  # change the default encoding to UTF-8.
   ENV['GKS_ENCODING'] ||= 'utf8'
 
   require_relative 'gr_commons/gr_commons'
@@ -76,9 +85,12 @@ module GR3
   require_relative 'gr3/ffi'
   require_relative 'gr3/gr3base'
 
-  # `float` is the default type in GR3
+  # `inquiry` methods etc. are defined here.
+  extend GRCommons::GRCommonUtils
+
+  # `float` is the default type in GR3.
   # A Ruby array or NArray passed to GR3 method is automatically converted to
-  # a FFI::MemoryPointer in the GR3Base class.
+  # a Fiddley::MemoryPointer in the GR3Base class.
   extend GR3Base
 
   # This module is for adding error checking to all methods in GR3.
@@ -113,8 +125,7 @@ module GR3
   extend CheckError
 
   # Now you can see a lot of methods just calling super here.
-  # Why? Do they really need?
-  # Yes. They are written to help the yard generate the documentation.
+  # They are written to help the yard generate the documentation.
   class << self
     # This method initializes the gr3 context.
     # @return [Integer]

data/lib/gr3/ffi.rb

@@ -73,8 +73,17 @@ module GR3
     try_extern 'void gr3_setviewmatrix(const float *m)'
     try_extern 'int gr3_getprojectiontype(void)'
     try_extern 'void gr3_setprojectiontype(int type)'
-    # try_extern 'unsigned int gr3_triangulate(const unsigned short *data, unsigned short isolevel, unsigned int dim_x, unsigned int dim_y, unsigned int dim_z, unsigned int stride_x, unsigned int stride_y, unsigned int stride_z, double step_x, double step_y, double step_z, double offset_x, double offset_y, double offset_z, gr3_triangle_t **triangles_p)'
-    # try_extern 'void gr3_triangulateindexed(const unsigned short *data, unsigned short isolevel, unsigned int dim_x, unsigned int dim_y, unsigned int dim_z, unsigned int stride_x, unsigned int stride_y, unsigned int stride_z, double step_x, double step_y, double step_z, double offset_x, double offset_y, double offset_z, unsigned int *num_vertices, gr3_coord_t **vertices, gr3_coord_t **normals, unsigned int *num_indices, unsigned int **indices)'
+    # try_extern 'unsigned int gr3_triangulate(const unsigned short *data, ' \
+    #      'unsigned short isolevel, unsigned int dim_x, unsigned int dim_y, unsigned int dim_z, ' \
+    #      'unsigned int stride_x, unsigned int stride_y, unsigned int stride_z, ' \
+    #      'double step_x, double step_y, double step_z, double offset_x, double offset_y, double offset_z, ' \
+    #      'gr3_triangle_t **triangles_p)'
+    # try_extern 'void gr3_triangulateindexed(const unsigned short *data, ' \
+    #      'unsigned short isolevel, unsigned int dim_x, unsigned int dim_y, unsigned int dim_z, ' \
+    #      'unsigned int stride_x, unsigned int stride_y, unsigned int stride_z, ' \
+    #      'double step_x, double step_y, double step_z, double offset_x, double offset_y, double offset_z, ' \
+    #      'unsigned int *num_vertices, gr3_coord_t **vertices, gr3_coord_t **normals, ' \
+    #      'unsigned int *num_indices, unsigned int **indices)'
     try_extern 'int gr3_createisosurfacemesh(int *mesh, unsigned short *data, ' \
            'unsigned short isolevel, unsigned int dim_x, unsigned int dim_y, unsigned int dim_z, ' \
            'unsigned int stride_x, unsigned int stride_y, unsigned int stride_z, ' \

data/lib/gr3/gr3base.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module GR3
-  # This module automatically converts Ruby arrays and Numo::Narray into pointers.
+  # This module automatically converts Ruby arrays and Numo::Narray into
+  # Fiddley::MemoryPointer.
   module GR3Base
     extend GRCommons::DefineMethods
     define_ffi_methods(FFI,
@@ -15,6 +16,4 @@ module GR3
                        default_type: :double)
   end
   private_constant :GR3Base
-
-  extend GRCommons::GRCommonUtils
 end

data/lib/gr_commons/define_methods.rb

@@ -16,9 +16,9 @@ module GRCommons
           args.map! do |arg|
             case arg
             when Array
-              send(default_type, arg)
+              GRCommons::GRCommonUtils.send(default_type, arg)
             when ->(x) { defined?(Numo::NArray) && x.is_a?(Numo::NArray) }
-              send(default_type, arg)
+              GRCommons::GRCommonUtils.send(default_type, arg)
             else
               arg
             end

data/lib/gr_commons/fiddley.rb

@@ -3,7 +3,7 @@
 require 'fiddle/import'
 
 module GRCommons
-  # Fiddley v0.0.8
+  # Fiddley v0.0.8 - Ruby-FFI compatible API layer for Fiddle
   # https://github.com/unak/fiddley
   #
   # Copyright (c) 2017 NAKAMURA Usaku usa@garbagecollect.jp

data/lib/gr_commons/gr_common_utils.rb

@@ -5,7 +5,7 @@ require 'gr_commons/fiddley'
 module GRCommons
   # This module provides functionality common to GR and GR3.
   module GRCommonUtils
-    private
+    module_function
 
     def equal_length(*args)
       lengths = args.map(&:length)
@@ -17,34 +17,60 @@ module GRCommons
       lengths[0]
     end
 
+    # This constants is used in the test.
     SUPPORTED_TYPES = %i[uint8 uint16 int uint double float].freeze
 
-    # NOTE: The following method converts Ruby Array or NArray into packed string.
-    SUPPORTED_TYPES.each do |type|
-      define_method(type) do |data|
-        case data
-        when Array
-          data = data.flatten
-          Fiddley::Utils.array2str(type, data)
-        when ->(x) { narray?(x) }
-          case type
-          when :uint8
-            Numo::UInt8.cast(data).to_binary
-          when :uint16
-            Numo::UInt16.cast(data).to_binary
-          when :int
-            Numo::Int32.cast(data).to_binary
-          when :uint
-            Numo::UInt32.cast(data).to_binary
-          when :double
-            Numo::DFloat.cast(data).to_binary
-          when :float
-            Numo::SFloat.cast(data).to_binary
-          end
-        else
-          data = data.to_a.flatten
-          Fiddley::Utils.array2str(type, data)
-        end
+    # convert Ruby Array or NArray into packed string.
+    def uint8(data)
+      if narray?(data)
+        Numo::UInt8.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:uint8, data.to_a.flatten)
+      end
+    end
+
+    # convert Ruby Array or NArray into packed string.
+    def uint16(data)
+      if narray?(data)
+        Numo::UInt16.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:uint16, data.to_a.flatten)
+      end
+    end
+
+    # convert Ruby Array or NArray into packed string.
+    def int(data)
+      if narray?(data)
+        Numo::Int32.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:int32, data.to_a.flatten)
+      end
+    end
+
+    # convert Ruby Array or NArray into packed string.
+    def uint(data)
+      if narray?(data)
+        Numo::UInt32.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:uint, data.to_a.flatten)
+      end
+    end
+
+    # convert Ruby Array or NArray into packed string.
+    def double(data)
+      if narray?(data)
+        Numo::DFloat.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:double, data.to_a.flatten)
+      end
+    end
+
+    # convert Ruby Array or NArray into packed string.
+    def float(data)
+      if narray?(data)
+        Numo::SFloat.cast(data).to_binary
+      else
+        Fiddley::Utils.array2str(:float, data.to_a.flatten)
       end
     end
 

data/lib/gr_commons/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GRCommons
-  VERSION = '0.0.14'
+  VERSION = '0.0.19'
 end

data/lib/grm.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module GRM
+  class Error < StandardError; end
+
+  class << self
+    attr_accessor :ffi_lib
+  end
+
+  # Platforms |  path
+  # Windows   |  bin/libGRM.dll
+  # MacOSX    |  lib/libGRM.so (NOT .dylib)
+  # Ubuntu    |  lib/libGRM.so
+  if Object.const_defined?(:RubyInstaller)
+    ENV['GRDIR'] ||= [
+      RubyInstaller::Runtime.msys2_installation.msys_path,
+      RubyInstaller::Runtime.msys2_installation.mingwarch
+    ].join(File::ALT_SEPARATOR)
+    self.ffi_lib = File.expand_path('bin/libGRM.dll', ENV['GRDIR'])
+    RubyInstaller::Runtime.add_dll_directory(File.dirname(ffi_lib))
+  else
+    raise Error, 'Please set env variable GRDIR' unless ENV['GRDIR']
+
+    self.ffi_lib = File.expand_path('lib/libGRM.so', ENV['GRDIR'])
+  end
+
+  # change the default encoding to UTF-8.
+  ENV['GKS_ENCODING'] ||= 'utf8'
+
+  require_relative 'gr_commons/gr_commons'
+  require_relative 'grm/version'
+  require_relative 'grm/ffi'
+  require_relative 'grm/grmbase'
+
+  # `inquiry` methods etc. are defined here.
+  extend GRCommons::GRCommonUtils
+
+  # `XXX` is the default type in GR.
+  # A Ruby array or NArray passed to GR method is automatically converted to
+  # a Fiddley::MemoryPointer in the GRBase class.
+  extend GRMBase
+
+  class << self
+  end
+end

data/lib/grm/ffi.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'fiddle/import'
+
+module GRM
+  # FFI Wrapper module for GRM.
+  # The functions for GRM are listed here.
+  # Add functions here when a new version of GR is released.
+  module FFI
+    extend Fiddle::Importer
+
+    begin
+      dlload GRM.ffi_lib
+    rescue LoadError
+      raise LoadError, 'Could not find GR Framework'
+    end
+
+    extend GRCommons::Extern
+
+    # Currently, the declarations of GRM functions are distributed in several
+    # header files.
+
+    # https://github.com/sciapp/gr/blob/master/lib/grm/args.h
+
+    try_extern 'grm_args_t *grm_args_new(void)'
+    try_extern 'void grm_args_delete(grm_args_t *args)'
+    # Fiddle does not currently support variable-length arguments in C.
+    try_extern 'int grm_args_push(grm_args_t *args, const char *key, const char *value_format, ...)'
+    try_extern 'int grm_args_push_buf(grm_args_t *args, const char *key, const char *value_format, const void *buffer, int apply_padding)'
+    try_extern 'int grm_args_contains(const grm_args_t *args, const char *keyword)'
+    try_extern 'void grm_args_clear(grm_args_t *args)'
+    try_extern 'void grm_args_remove(grm_args_t *args, const char *key)'
+
+    # https://github.com/sciapp/gr/blob/master/lib/grm/dump.h
+    try_extern 'void grm_dump(const grm_args_t *args, FILE *f)'
+    try_extern 'void grm_dump_json(const grm_args_t *args, FILE *f)'
+    try_extern 'char *grm_dump_json_str(void)'
+
+    # https://github.com/sciapp/gr/blob/master/lib/grm/event.h
+    # grm_event_type_t is an enum.
+    # In the original fiddley, there is code for an enum.
+    # But GR's fiddley doesn't have it.
+    # try_extern 'int grm_register(grm_event_type_t type, grm_event_callback_t callback)'
+    # try_extern 'int grm_unregister(grm_event_type_t type)'
+
+    # https://github.com/sciapp/gr/blob/master/lib/grm/interaction.h
+    try_extern 'int grm_input(const grm_args_t *input_args)'
+    # try_extern 'int grm_get_box(const int x1, const int y1, const int x2, const int y2, const int keep_aspect_ratio, int *x, int *y, int *w, int *h)'
+    # try_extern 'grm_tooltip_info_t *grm_get_tooltip(const int, const int)'
+
+    # https://github.com/sciapp/gr/blob/master/lib/grm/net.h
+    # try_extern 'void *grm_open(int is_receiver, const char *name, unsigned int id,
+    #                            const char *(*custom_recv)(const char *, unsigned int),
+    #                            int (*custom_send)(const char *, unsigned int, const char *))
+    try_extern 'grm_args_t *grm_recv(const void *p, grm_args_t *args)'
+    # Fiddle does not currently support variable-length arguments in C.
+    try_extern 'int grm_send(const void *p, const char *data_desc, ...)'
+    try_extern 'int grm_send_buf(const void *p, const char *data_desc, const void *buffer, int apply_padding)'
+    try_extern 'int grm_send_ref(const void *p, const char *key, char format, const void *ref, int len)'
+    try_extern 'int grm_send_args(const void *p, const grm_args_t *args)'
+    try_extern 'void grm_close(const void *p)'
+  end
+end

data/lib/grm/grmbase.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module GRM
+  # This module automatically converts Ruby arrays and Numo::Narray into
+  # Fiddley::MemoryPointer.
+  module GRMBase
+    extend GRCommons::DefineMethods
+    define_ffi_methods(FFI,
+                       prefix: 'grm_',
+                       default_type: :float) # FIXME!
+  end
+  private_constant :GRMBase
+end

data/lib/grm/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module GRM
+  VERSION = GRCommons::VERSION
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-gr
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.19
 platform: ruby
 authors:
 - kojix2
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-04 00:00:00.000000000 Z
+date: 2020-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -147,10 +147,15 @@ files:
 - lib/gr_commons/gr_commons.rb
 - lib/gr_commons/jupyter_support.rb
 - lib/gr_commons/version.rb
+- lib/grm.rb
+- lib/grm/ffi.rb
+- lib/grm/grmbase.rb
+- lib/grm/version.rb
 homepage: https://github.com/red-data-tools/GR.rb
 licenses:
 - MIT
-metadata: {}
+metadata:
+  msys2_mingw_dependencies: gr
 post_install_message: 
 rdoc_options: []
 require_paths: