stbimage 0.2.1 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dee6483bc900314ff5c02f734ebc3ddeadfeffa3e780ee564a54fc44008406d2
-  data.tar.gz: e95ea2ba342e53eebdc9fb1b7390bb705f6cdc7f6993af69fca0b0a0363a3dbb
+  metadata.gz: 2bcd3ab3b0b48a77141fcca550db3b1a0c09e11d29e9773c9ac223886e971305
+  data.tar.gz: fe10826a06846cfa142957074c9fcf823007523d911ebbce5c1f6257d17bb75d
 SHA512:
-  metadata.gz: c61cbd2a8e1084834aff19e41d7245e189251feef10829eab4a8bf3676b8b1224062e5a1a2978545e0b08bf32bec59efdd05f468a4f483cc5bfb016421684bff
-  data.tar.gz: 01af2da836ff901fa79784779d3679920d82e84ef3fde5d9dc6d7aa2ec444516d8ea0f8a0c2d40d4e5b7836e27f803f624f91918ca749f5dd396f3e5109ac287
+  metadata.gz: ce225e878f58bae458104edeebff01eb714ee08c2453c67fdf0a23840790d2b2435f41dbe80e27421b97dda72e3b76855c24fabac68c0be56711b8ffb8ad8939
+  data.tar.gz: f11837adcbb954dff506566c4bd7845224768246907c375d6061a4eaa45ed6352ea91bd612ca9a2771cca9bd741126adb03bf423edac84a537e01144ee4ff89f

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 =~ /64/
+
+        # 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
+      
+      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 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
+      
       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 =~ /64/
+
+  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
+
+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 32-bit Architecture ruby"
+  if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
+    puts "With Windows"
+    lib, path = 'stbDLL_x32.dll', "#{__dir__}/../dlls"
+  elsif RUBY_PLATFORM =~ /linux/ || RUBY_PLATFORM =~ /cygwin/
+    puts "With Linux"
+    lib, path = 'libstb_x32.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.1
+  version: 0.5.1
 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