stbimage 0.1.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69c08cb285862a8e9966b52a8af3c9f12d60c09e9554153f94a50793e8a94809
-  data.tar.gz: b1b05a5a93b1305b89b2e987fefc460cf7c5210fcdd8b1ee7b0d5b24bc63c45e
+  metadata.gz: 8c7e3cbdd4dccecf5bf9a5c6ebc0365b6466fde88658ba4cc55d9b8d723217b5
+  data.tar.gz: 32f870bd08f340ac675e3d1a68bced77b0201b9fe7c73ea58bcee53314df131c
 SHA512:
-  metadata.gz: 1edc452c7dd5c83825ad0e20e6c049624bffa11532ff2d52ecbf34fc5677492f16bdc87b3cb2b4d8aaef28f8c33cd343d3928c7ceffb3dcf2e4a7a33822f64e0
-  data.tar.gz: 703eb7853e6564251e83f478a85c0a51879f838b2cba9f6a65282c96d0f09684859e89630b7084013cb102be7209b7fd7a405267808de5044690015212121e79
+  metadata.gz: 3a1e041c4080ea9a88292ee5b5b8882a228b0a3ce485ab5eea544cca27576f8e4ccd05e2858e1b0d77b517c004658db6a5d62845b409d44dd0b7d0a4dbdaf313
+  data.tar.gz: 9507fa97a2455e1280d402ebe1419eca0db673e8b7c9001253d7070ddfc1be99e130a31e12eba38f26c6f68f34fe5438a07623bf8c73ae29820243029c7c986c

data/README.md

@@ -0,0 +1,116 @@
+# STBIMAGE     
+
+
+
+Ruby binding of stb-image.h
+
+**Works well on windows!!!**
+**Added support for Linux (32, 64, arm)**
+
+* ### Supports (so far): ###  
+  <br>
+  
+  * **stbi_load** (Default image loader)
+  * **stbi_load_16**
+  * **stbi_loadf** (For `.hdr` images)
+  * **stbi_info**
+  * **stbi_image_free**
+  * **stbi_failure_reason**
+  * **stbi_set_flip_vertically_on_load**
+  * **stbi_set_flip_vertically_on_load_thread**
+  * **stbi_set_unpremultiply_on_load**
+  * **stbi_convert_iphone_png_to_rgb**
+  * **stbi_hdr_to_ldr_gamma**
+  * **stbi_hdr_to_ldr_scale**
+  * **stbi_is_16_bit**
+  * **stbi_is_hdr**
+  * **stbi_zlib_decode_buffer**
+  * **stbi_zlib_decode_malloc**
+  * **stbi_zlib_decode_malloc_guesssize**
+  * **stbi_zlib_decode_malloc_guesssize_headerflag**
+  * **stbi_zlib_decode_noheader_buffer**
+  * **stbi_zlib_decode_noheader_malloc**
+
+
+<br>
+
+# Installation
+
+* Windows:\
+`gem install stbimage`
+
+* Linux/macOs:\
+`gem install stbimage`
+
+*Note: In macOs you have to compile the dynamic libary (.so) yourself. Although I planned to include it in the future*
+
+<br>
+
+# .dll libs
+
+You can find it under [dlls](dlls) folder
+
+<br>
+
+# Usage
+
+```ruby
+require 'stbimage'
+
+# use this to load the dll (from gem version 0.2.3 and above)! Only For windows and linux yet
+STBIMAGE.load_lib() 
+
+# In macOs you have to provide a dynamic libary (.so) by yourself
+# STBIMAGE.load_lib('your_name.so', 'absolute_path_to_file') 
+
+
+width = ' ' * 4
+height = ' ' * 4
+nr_channels = ' ' * 4
+
+data = STBIMAGE.stbi_load("blue-poly.jpg", width, height, nr_channels, 0)
+
+puts data # You can use this data in OpenGL for instance.
+
+puts width.unpack('l')[0]
+puts height.unpack('l')[0]
+puts nr_channels.unpack('l')[0]
+```
+
+<br>
+
+# Credit
+
+* Credit to Vaiorabbit who made the bindings of opengl into ruby! This wrapper is based on his glfw wrapper.
+His repo: https://github.com/vaiorabbit/ruby-opengl
+
+* stb_image.h by Sean Barret. Repo: https://github.com/nothings/stb/blob/master/stb_image.h
+
+
+<br>
+
+# Licence
+
+MIT License
+
+```
+Copyright (c) 2021 Samuel Keresztes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

data/lib/stbimage.rb

@@ -29,12 +29,53 @@ module STBIMAGE
   end
 
   
-  @@glfw_import_done = false
+  @@stbi_image_import_done = false
 
-  # Load native library.
+  # Load native dll libary 
   def self.load_lib(lib = nil, path = nil, output_error = false)
     if lib == nil && path == nil
-        lib, path = 'stbDLL.dll', Dir.pwd
+
+      if RUBY_PLATFORM =~ /x86/
+
+        # puts "You have a 32-bit Architecture ruby"
+        if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
+          # puts "With Windows"
+          lib, path = 'stbDLL_x86.dll', "#{__dir__}/../dlls"
+        elsif RUBY_PLATFORM =~ /linux/ || RUBY_PLATFORM =~ /cygwin/
+          # puts "With Linux"
+          lib, path = 'libstb_x86.so', "#{__dir__}/../dlls"
+        elsif RUBY_PLATFORM =~ /darwin/
+          # puts "With macOS"
+        else
+          # puts "I have no idea what os are you using, so it's possible that stbimage wont't work"
+        end
+      
+      elsif RUBY_PLATFORM =~ /arm/
+      
+        # puts "You have a arm architecture"
+        lib, path = 'libstb_arm.so', "#{__dir__}/../dlls"
+      
+      elsif RUBY_PLATFORM =~ /java/
+      
+        # puts "You have jruby!"
+      
+      else 
+      
+        # puts "You have a 64-bit Architecture ruby"
+        if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
+          # puts "With Windows"
+          lib, path = 'stbDLL_x64.dll', "#{__dir__}/../dlls"
+        elsif RUBY_PLATFORM =~ /linux/ || RUBY_PLATFORM =~ /cygwin/
+          # puts "With Linux"
+          lib, path = 'libstb_x64.so', "#{__dir__}/../dlls"
+        elsif RUBY_PLATFORM =~ /darwin/
+          # puts "With macOS"
+        else
+          # puts "I have no idea what os are you using, so it's possible that stbimage wont't work"
+        end
+      
+      end
+
     end
 
     if path
@@ -42,36 +83,31 @@ module STBIMAGE
     else
       dlload (lib)
     end
-    import_symbols(output_error) unless @@glfw_import_done
-  end
-
-  def self.load_dll(lib = nil, path = nil)
-    puts "Warning STBIMAGE.load_dll is deprecated, use GLFW.load_lib instead"
-    self.load_lib(lib, path)
+    import_symbols(output_error) unless @@stbi_image_import_done
   end
 
   @@lib_signature = [
     'void stbi_convert_iphone_png_to_rgb(int)',
-    'const char *stbi_failure_reason(void)',
+    'const char* stbi_failure_reason(void)',
     'void stbi_hdr_to_ldr_gamma(float)',
     'void stbi_hdr_to_ldr_scale(float)',
     'void stbi_image_free(void*)',
     'int stbi_info(char const* , int*, int*, int*)', 
-    # 'int stbi_info_from_callbacks(stbi_io_callbacks const*, void*, int*, int*, comp*)'
+    # 'stbi_info_from_callbacks'
     # 'stbi_info_from_file'
     # 'stbi_info_from_memory'
-    # 'stbi_is_16_bit'
+    'int stbi_is_16_bit(char const*)',
     # 'stbi_is_16_bit_from_callbacks'
     # 'stbi_is_16_bit_from_file'
     # 'stbi_is_16_bit_from_memory'
-    # 'stbi_is_hdr'
+    'int stbi_is_hdr(char const*)',
     # 'stbi_is_hdr_from_callbacks'
     # 'stbi_is_hdr_from_file'
     # 'stbi_is_hdr_from_memory'
-    # 'stbi_ldr_to_hdr_gamma'
-    # 'stbi_ldr_to_hdr_scale'
+    'void stbi_ldr_to_hdr_gamma(float)',
+    'void stbi_ldr_to_hdr_scale(float)',
     'stbi_uc* stbi_load(char const*, int*, int*, int*, int)', 
-    # 'stbi_load_16'
+    'stbi_us* stbi_load_16(char const*, int*, int*, int*, int)',
     # 'stbi_load_16_from_callbacks'
     # 'stbi_load_16_from_memory' 
     # 'stbi_load_from_callbacks' 
@@ -79,37 +115,38 @@ module STBIMAGE
     # 'stbi_load_from_file_16'
     # 'stbi_load_from_memory' 
     # 'stbi_load_gif_from_memory'
-    # 'stbi_loadf' 
+    'float* stbi_loadf(char const*, int*, int*, int*, int)',
     # 'stbi_loadf_from_callbacks'
     # 'stbi_loadf_from_file' 
     # 'stbi_loadf_from_memory'
-    'void stbi_set_flip_vertically_on_load(int)'
-    # 'stbi_set_flip_vertically_on_load_thread'
-    # 'stbi_set_unpremultiply_on_load' 
-    # 'stbi_zlib_decode_buffer' 
-    # 'stbi_zlib_decode_malloc' 
-    # 'stbi_zlib_decode_malloc_guesssize'
-    # 'stbi_zlib_decode_malloc_guesssize_headerflag'
-    # 'stbi_zlib_decode_noheader_buffer' 
-    # 'stbi_zlib_decode_noheader_malloc'
+    'void stbi_set_flip_vertically_on_load(int)',
+    'void stbi_set_flip_vertically_on_load_thread(int)',
+    'void stbi_set_unpremultiply_on_load(int)',
+    'int stbi_zlib_decode_buffer(char*, int, const char*, int)', 
+    'char* stbi_zlib_decode_malloc(const char*, int, int*)', 
+    'char* stbi_zlib_decode_malloc_guesssize(const char*, int, int, int*)',
+    'char* stbi_zlib_decode_malloc_guesssize_headerflag(const char*, int, int, int*, int)',
+    'int stbi_zlib_decode_noheader_buffer(char*, int, const char*, int)', 
+    'char* stbi_zlib_decode_noheader_malloc(const char*, int, int*)'
+
   ]
 
   def self.import_symbols(output_error = false)
     typealias 'stbi_uc', 'unsigned char'
-    typealias 'stbi_us', 'unsigned short' 
-    
+    typealias 'stbi_us', 'unsigned short'
 
     # function
     @@lib_signature.each do |sig|
+
       begin
         extern sig
       rescue
         $stderr.puts("[Warning] Failed to import #{sig}.") if output_error
       end
+
     end
 
-    @@glfw_import_done = true
+        @@stbi_image_import_done = true
+        
   end
-
-end
-
+end

data/utils/system_check.rb

@@ -0,0 +1,51 @@
+RUBY_PLATFORM = x86-mingw32
+
+if RUBY_PLATFORM =~ /x86/
+
+  puts "You have a 32-bit Architecture ruby"
+  if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
+    puts "With Windows"
+    lib, path = 'stbDLL_x86.dll', "#{__dir__}/../dlls"
+  elsif RUBY_PLATFORM =~ /linux/ || RUBY_PLATFORM =~ /cygwin/
+    puts "With Linux"
+    lib, path = 'libstb_x86.so', "#{__dir__}/../dlls"
+  elsif RUBY_PLATFORM =~ /darwin/
+    puts "With macOS"
+  else
+    puts "I have no idea what os are you using, so it's possible that stbimage wont't work"
+  end
+
+elsif RUBY_PLATFORM =~ /arm/
+
+  puts "You have a arm architecture"
+  lib, path = 'libstb_arm.so', "#{__dir__}/../dlls"
+
+elsif RUBY_PLATFORM =~ /java/
+
+  puts "You have jruby!"
+
+else 
+
+  puts "You have a 64-bit Architecture ruby"
+  if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
+    puts "With Windows"
+    lib, path = 'stbDLL_x64.dll', "#{__dir__}/../dlls"
+  elsif RUBY_PLATFORM =~ /linux/ || RUBY_PLATFORM =~ /cygwin/
+    puts "With Linux"
+    lib, path = 'libstb_x64.so', "#{__dir__}/../dlls"
+  elsif RUBY_PLATFORM =~ /darwin/
+    puts "With macOS"
+  else
+    puts "I have no idea what os are you using, so it's possible that stbimage wont't work"
+  end
+
+end
+
+
+# if RUBY_PLATFORM == "x64-mswin64_140" || RUBY_PLATFORM == "x64-mingw32"
+      #   lib, path = 'stbDLL_x64.dll', "#{__dir__}/../dlls"
+      # elsif RUBY_PLATFORM == "x86-mingw32"
+      #   lib, path = 'stbDLL_x86.dll', "#{__dir__}/../dlls"
+      # elsif RUBY_PLATFORM =~ /x86_linux/
+      #   lib, path = 'libstd_x86.so', "#{__dir__}/../dlls"
+      # else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stbimage
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Keresztes
@@ -10,15 +10,21 @@ bindir: bin
 cert_chain: []
 date: 2021-01-09 00:00:00.000000000 Z
 dependencies: []
-description: |-
-  Beta Version!!! Will be developed! So far compatible with: stbi_load, stbi_set_flip_vertically_on_load(). For an easier
-                      soulution, I choose fiddle as function importer from the dll (You should give the dll libary with the .load_lib(lib, path) function (Only works with windows so far!!!!!). PLEASE CHECK OUT THE HOMEPAGE FOR MORE INFO AND EXAMPLE
+description: "!Beta Version! A practical image importer/loader. It wraps stb_image.h
+  (ver:2.26 -2020.07.13-). Supported image formats are: JPEG, PNG, TGA, BMP, PSD,
+  GIF(not animation), HDR, PIC, PNM. Only works well with windows (win32/win64) and
+  with linux so far, but for macOS, users have to include . Checkout the Homepage
+  for more info (installation, usage and other information)"
 email: ''
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- dlls/stbDLL_x64.dll
+- dlls/stbDLL_x86.dll
 - lib/stbimage.rb
+- utils/system_check.rb
 homepage: https://github.com/fellowchap-samuel/stbimage-ruby
 licenses:
 - MIT