stl 0 → 0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0ecf41f3cb85f2b3f74b5ac05560c972fd4d8e82
-  data.tar.gz: dd2f9b13e1d6c802649f30d951a521e5df20852a
+  metadata.gz: 3e442a1d1d6c73f5568291d19e4a9c76ca9f7960
+  data.tar.gz: b13b828b174516b81743aafec4f9830b5d39cdfd
 SHA512:
-  metadata.gz: 128823cbeabf56dcbb1ed77c10d732cbd6d28528b5b306f914470a4b8e73b2629684ce39d9dcf33d07d72e01f6d5ced0d10b11ae4b07c209f8c1ce56e100aa86
-  data.tar.gz: 6714a65fabb1da01e56992ec77f95f45a9ec1335740eb5793cb2a3d5e33e61ffc2a7b272d609beb159940eccab402aff1bb709ada11eb304a483cd54dd4330f5
+  metadata.gz: 7a0e02cf15977359cf82cbcfe31e6376ad4e6d2d059ffe940bb030b529e804c3f183d96e903d1556b081bc5da803b1a6346ca298b510967ffda944fdc8570bf8
+  data.tar.gz: d31042303cf87bf9f1b533e090a3837c120585ca134a175d8ffee15cfc292cd174c2e8883b946972a2b51354ce56c2a00dfac716b1d1d48d29b383ea503ba566

data/README.markdown

@@ -1,6 +1,6 @@
 # STL
 
-TODO: Write a gem description
+Read, write and manipulate both ASCII and binary [STL files](http://en.wikipedia.org/wiki/STL_(file_format))
 
 ## Installation
 
@@ -18,12 +18,8 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+require 'stl'
 
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+faces = STL.read('my_awesome.stl')	# => [[normal, Triangle], ...]
+```

data/lib/stl.rb

@@ -1,3 +1,10 @@
+require_relative 'stl/parser'
+
 module STL
-  # Your code goes here...
+    # Read an STL file
+    # @param filename [String]	The path to the file to read
+    # @return [STL] the resulting {STL} object
+    def self.read(filename)
+	File.open(filename, 'r') {|f| STL::Parser.parse(f) }
+    end
 end

data/lib/stl/parser.rb

@@ -0,0 +1,56 @@
+require 'geometry'
+
+module STL
+    # http://en.wikipedia.org/wiki/STL_(file_format)
+    class Parser
+	# @param io [IO]    the stream to parse
+	# @return [Array]   An array of [Normal, Triangle] pairs
+	def self.parse(io)
+	    # A binary STL file has an 80 byte header that should never contain
+	    #  the word 'solid'. The first non-whitespace characters of an ASCII
+	    #  STL file should contain 'solid'.
+	    if io.gets(80).include?('solid')
+		self.new.parse_ascii(io.rewind)
+	    else
+		self.new.parse_binary(io)
+	    end
+	end
+
+	# Parse an ASCII STL file
+	# @param io [IO]    the stream to parse
+	# @return [Array]   An array of [Normal, Triangle] pairs
+	def parse_ascii(io)
+	    stack = []
+	    triangles = []
+	    io.each do |line|
+		case line
+		    when /solid (.*)/
+			name = $1
+		    when /facet normal (.+) (.+) (.+)/
+			stack.push Vector[Float($1), Float($2), Float($3)]
+		    when /vertex (.+) (.+) (.+)/
+			stack.push Vector[Float($1), Float($2), Float($3)]
+		    when /endloop/
+			triangles.push [stack.pop, Geometry::Triangle.new(*stack.pop(3))]
+		end
+	    end
+	    triangles
+	end
+
+	# Parse a binary STL file, assuming that the header has already been read
+	# @param io [IO]    the stream to parse
+	# @return [Array]   An array of [Normal, Triangle] pairs
+	def parse_binary(io)
+	    count = io.read(4).unpack('V').first
+
+	    faces = []
+	    while not io.eof?
+		normal, *vertices = io.read(50).unpack('F3F3F3F3x2').each_slice(3).to_a
+		faces.push [normal, Geometry::Triangle.new(*vertices)]
+	    end
+	    raise StandardError, "Unexpected end of file after #{faces.length} triangles" if faces.length != count
+
+	    faces
+	end
+    end
+end

data/stl.gemspec

@@ -3,8 +3,8 @@ lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
-    spec.name          = "stl"
-    spec.version       = '0'
+    spec.name          = 'stl'
+    spec.version       = '0.1'
     spec.authors       = ["Brandon Fosdick"]
     spec.email         = ["bfoz@bfoz.net"]
     spec.description   = %q{Read and write STL files}
@@ -19,4 +19,6 @@ Gem::Specification.new do |spec|
 
     spec.add_development_dependency "bundler", "~> 1.5"
     spec.add_development_dependency "rake"
+
+    spec.add_dependency	'geometry'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stl
 version: !ruby/object:Gem::Version
-  version: '0'
+  version: '0.1'
 platform: ruby
 authors:
 - Brandon Fosdick
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-25 00:00:00.000000000 Z
+date: 2014-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,20 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: geometry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Read and write STL files
 email:
 - bfoz@bfoz.net
@@ -50,6 +64,7 @@ files:
 - README.markdown
 - Rakefile
 - lib/stl.rb
+- lib/stl/parser.rb
 - stl.gemspec
 homepage: https://github.com/bfoz/stl-ruby
 licenses:
@@ -71,7 +86,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.11
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Read, write and manipulate stereolithography files