stbimage 0.2.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd2fac88ebb74d0fbcd77f9c8023b3e7069d1fc959e8e81bbeffb6781dede3e7
-  data.tar.gz: 0fff22ec0287d01a33191db63938d50eb902c58ec1eeb5785ac1ea844633f9c2
+  metadata.gz: bbcc8434378681a4cb30e911d9d1af4e4f121c300e1a291db7b33eeb5505a4f3
+  data.tar.gz: b96b64b299432b39f088a2dbbfd064e77858b1fb57b7b220f89cc5f2f503e39f
 SHA512:
-  metadata.gz: 85bd11a5b36083ccb9d15b0bd8b13cb544456c043aaaffb0ff2b725093ce80f917696d1f5d33f157570339da2b15778a0932839c4e195d72555279319334ebab
-  data.tar.gz: 6b36b4ec6d9711f68348c63890a494b00dc6ed008f3dccdbec891f92d69549e61549a877d7205af83f2fea7ba2add5aa8245ac8a218a862327b946ede7b41295
+  metadata.gz: 01faa35b8bd2b50520ff54924f1d22442a0ec3f3de319597ef4e9a8cda3b549a8160bad6b04af87ea2e16c90394fdfd51e8589b0ab2a12eec84867715cd900dd
+  data.tar.gz: 0ea9d9f48aff7874d1986ef2075b0ce6084f29d27e7fc2bc391e2e8ae706a0e9f8b58d3d99c10b820e44347a821e6a4b625d76a122ba62942fc8325b11833064

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,20 +29,53 @@ module STBIMAGE
   end
 
   
-  @@glfw_import_done = false
+  @@stbi_image_import_done = false
 
-=begin
-Load native dll libary 
-- lib = the name of the file
-- path = route to the file
-=end
+  # Load native dll libary 
   def self.load_lib(lib = nil, path = nil, output_error = false)
     if lib == nil && path == nil
-      if RUBY_PLATFORM == "x64-mswin64_140" || RUBY_PLATFORM == "x64-mingw32"
-        lib, path = 'stbDLL_x64.dll', '../dlls'
-      elsif RUBY_PLATFORM == "x86-mingw32"
-        lib, path = 'stbDLL_x86.dll', '../dlls'
+
+      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
@@ -50,31 +83,31 @@ Load native dll libary
     else
       dlload (lib)
     end
-    import_symbols(output_error) unless @@glfw_import_done
+    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' 
@@ -82,37 +115,38 @@ Load native dll libary
     # '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.2.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Keresztes
@@ -10,15 +10,24 @@ 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(). 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/libstb_arm.so
+- dlls/libstb_x64.so
+- dlls/libstb_x86.so
+- 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