dxf_io 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: acd6e7e421e794fc455849a0bef5891546f156f0
+  data.tar.gz: 05ed5c94483547c11977cb46fe5aef576500326f
+SHA512:
+  metadata.gz: d4ab61f9f327ca682d0f5960b9e17150f9444176bd5e09182877f75acbf0fcc1f14d667f986dfd12a9885654b3dd93bcc72465d6cb673f43d0b7304c05b103cb
+  data.tar.gz: af51a521f4325f2901fda5916c405801cf655ceb02f56e4f88bec4d4ae0de6aeb79fc3f6b5df04d6d847a7563a49b28be6505b73dd50cfe9b300c14308b94052

data/.gitignore

@@ -0,0 +1,11 @@
+*.gem
+/.bundle/
+/.yardoc
+/.idea/*
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dxf_io.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Ivan Zabrovskiy
+
+MIT License
+
+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/README.md

@@ -0,0 +1,224 @@
+# DxfIO
+
+This is a gem for read and write DXF files and for processing of simple actions over dxf entities.
+Reader part of the gem based on [ruby-dxf-reader](https://github.com/jimfoltz/ruby-dxf-reader).
+Gem supported DXF files generated by AutoCAD 2008 ([dxf-specification](http://images.autodesk.com/adsk/files/acad_dxf0.pdf)).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'dxf_io'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dxf_io
+
+## Usage
+
+Gem consists from __Reader__, __Writer__, __Wrapper__ and support classes.
+
+### Reader
+
+Reader require a path to DXF file and return a hash with dxf-objects.
+
+Reader can be initialized as follows:
+
+```ruby
+reader_instance = DxfIO::Reader.new(path: '/path/to/your/file.dxf')
+```
+
+Additionally you can use `open` method:
+
+```ruby
+DxfIO::Reader.open('/path/to/your/file.dxf') do |dxf_reader_instance|
+  # ...
+end
+```
+
+`open` receive same options as `new`.
+
+Available options of __Reader__:
+
+* path - path to DXF-file (required)
+* encoding - encoding of input file (`'Windows-1251'` by default)
+
+As alternative you may pass single string as input parameter:
+
+```ruby
+reader_instance = DxfIO::Reader.new('/path/to/your/file.dxf')
+```
+
+To obtain full hash with DXF content eval
+
+```ruby
+dxf_content = reader_instance.run
+```
+
+or
+
+```ruby
+dxf_content = reader_instance.to_h
+```
+
+Format of resulted hash:
+
+    {
+                 "HEADER" => {...}, 
+                "CLASSES" => [...],
+                 "TABLES" => [...],
+                 "BLOCKS" => [...],
+               "ENTITIES" => [...],
+                "OBJECTS" => [...],
+        "THUMBNAILIMAGES" => [...]
+    }
+
+If you need certain part of DXF you may execute one of the following functions
+
+* header
+* classes
+* tables
+* blocks
+* entities
+* objects
+* thumbnailimages
+
+Format of __header__ section is
+
+    {
+        $PLIMCHECK" => {
+            70 => 0
+        },
+        "$PEXTMIN" => {
+            10 => 1.0e+20,
+            20 => 1.0e+20,
+            30 => 1.0e+20
+        },
+        ...
+    }
+
+Other section has different format:
+
+    [
+        [
+            {   0 => "CLASS" },
+            {   1 => "VISUALSTYLE" },
+            {   2 => "AcDbVisualStyle" },
+            {   3 => "ObjectDBX Classes" },
+            {  90 => 4095 },
+            { 280 => 0 },
+            { 281 => 0 }
+        ],
+        [...]
+    ]
+
+Sequence of groups and values is same as in DXF file.
+
+#### Notes
+
+* Reader caches result of parse DXF file. If you want to update a cache call `reader_instance.rerun`.
+* Reader automatically cast integer and float values to proper Ruby classes.
+
+### Writer
+
+__Writer__ receive a dxf-hash in format from __Reader__ and construct a DXF-file.
+
+__Writer__ can be initialized as follow
+
+```ruby
+writer_instance = DxfIO::Writer.new(dxf_hash: dxf_content, path: '/path/to/new/file.dxf')
+```
+
+To process write execute `writer_instance.run`.
+
+Alternative way to use __Writer__:
+
+```ruby
+writer_instance = DxfIO::Writer.open('/path/to/new/file.dxf') do |dxf_writer_instance|
+  # ...
+  dxf_writer_instance.write_hash dxf_hash
+end
+```
+
+`open` receive same options as `new`.
+
+Available options of __Writer__:
+
+* dxf_hash - hash with DXF-file in format of __Reader__ (required in `new` or in `run`/`write_hash` methods)
+* path - path to new DXF-file (required)
+* encoding - encoding of output file (`'Windows-1251'` by default)
+* delimiter - delimiter in DXF-file (`"\r\n"` by default)
+* strategy - strategy of _Writer_ (`:memory` by default)
+
+#### Write strategy
+
+__Writter__ support two strategy:
+
+1. `:disk` - a lot of small write operation for each group, section etc
+2. `:memory` - prepare full file content in memory and write by a single operation (default behaviour)
+
+### Wrapper
+
+__Wrapper__ provide several tools for work with dxf-entities.
+
+__Wrapper__ can be initialized as follow
+
+```ruby
+wrapper_instance = DxfIO::Wrapper.new(dxf_hash: dxf_content)
+```
+
+It has functions for fetch any groups except header:
+
+* classes
+* tables
+* blocks
+* entities
+* objects
+* thumbnailimages
+
+Any of these functions return array with __Entity__ which is `DxfIO::Entity::Other`.
+
+Each __Entity__ has follows methods
+
+* to_a - same as in __Reader__ format
+* to_h - hash with group code on keys and array with group values on values
+* type - value of zero group (for example "LINE")
+* points - array of __Points__ which is `DxfIO::Entity::Support::Point`
+* xs - array of X-coordinates
+* ys - array of Y-coordinates
+* move_to! - receive __Point__ and move all points of current __Entity__
+
+### Support
+
+#### Point
+
+This is a simple class for storage 2D points. It provide follows methods:
+
+* x - access to X-coordinate
+* y - access to Y-coordinate
+* start? - is this start-point of primitive (codes 10 and 20 from [dxf-specification](http://images.autodesk.com/adsk/files/acad_dxf0.pdf))
+* end? - is this end-point of primitive (codes 11 and 21 from [dxf-specification](http://images.autodesk.com/adsk/files/acad_dxf0.pdf))
+* `==`
+* binary `+`, `-`, `*`, `/`
+* unary `-`
+* `rotate_90`, `rotate_180` (supposed what point is a vector from zero)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+1. Fork it ( https://github.com/Loriowar/dxf_io/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "dxf_io"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/dxf_io.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dxf_io/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dxf_io'
+  spec.version       = DxfIO::VERSION
+  spec.authors       = ['Ivan Zabrovskiy']
+  spec.email         = ['loriowar@gmail.com']
+
+  spec.summary       = %q{Gem for read and write DXF files}
+  spec.description   =  <<-STRING
+                          Gem for read and write DXF files.
+                          Gem based on "ruby-dxf-reader" from https://github.com/jimfoltz/ruby-dxf-reader.
+                          It support DXF files comes from AutoCAD 2008 (http://images.autodesk.com/adsk/files/acad_dxf0.pdf).
+                        STRING
+  spec.homepage      = 'https://github.com/Loriowar/dxf_io'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  if spec.respond_to?(:metadata)
+    #spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com' to prevent pushes to rubygems.org, or delete to allow pushes to any server."
+  end
+
+  spec.add_dependency 'activesupport', '>= 3.2'
+
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

data/lib/dxf_io.rb

@@ -0,0 +1,13 @@
+require 'dxf_io/version'
+
+module DxfIO
+  extend ActiveSupport::Autoload
+
+  autoload :Constants
+
+  autoload :Reader
+  autoload :Writer
+
+  autoload :Wrapper
+  autoload :Entity
+end

data/lib/dxf_io/constants.rb

@@ -0,0 +1,24 @@
+module DxfIO
+  module Constants
+    SECTIONS_LIST = %w(CLASSES TABLES BLOCKS ENTITIES OBJECTS THUMBNAILIMAGES).freeze
+    HEADER_NAME = 'HEADER'.freeze
+
+    WRITER_STRATEGY = %i(memory disk).freeze
+
+    START_POINT_GROUP_NUMS = [10, 20].freeze
+    END_POINT_GROUP_NUMS = [11, 21].freeze
+
+    ENTITIES_TYPE_NAME_VALUE_MAPPING = {ellipse: 'ELLIPSE',
+                                        polyline: 'LWPOLYLINE',
+                                        arc: 'ARC',
+                                        circle: 'CIRCLE',
+                                        dimension: 'DIMENSION',
+                                        hatch: 'HATCH',
+                                        leader: 'LEADER',
+                                        line: 'LINE',
+                                        mline: 'MLINE',
+                                        text: 'TEXT',
+                                        mtext: 'MTEXT',
+                                        spline: 'SPLINE'}.freeze
+  end
+end

data/lib/dxf_io/entity.rb

@@ -0,0 +1,21 @@
+module DxfIO
+  module Entity
+    extend ActiveSupport::Autoload
+
+    autoload :Ellipse
+    autoload :Polyline
+    autoload :Arc
+    autoload :Circle
+    autoload :Dimension
+    autoload :Hatch
+    autoload :Leader
+    autoload :Line
+    autoload :Mline
+    autoload :Text
+    autoload :Mtext
+    autoload :Spline
+
+    autoload :Other
+    autoload :Support
+  end
+end

data/lib/dxf_io/entity/arc.rb

@@ -0,0 +1,44 @@
+module DxfIO
+  module Entity
+    class Arc < Other
+      ADDITIONAL_GROUP_CODES = {radius: 40,
+                                start_angle: 50,
+                                end_angle: 51}.freeze
+
+      ADDITIONAL_GROUP_CODES.each_pair do |method_name, group_code|
+        class_eval <<-EOT, __FILE__, __LINE__ + 1
+          def #{method_name}                       # def radius
+            to_h[#{group_code}]                    #   to_h[40]
+          end                                      # end
+        EOT
+      end
+
+      def center
+        points.first
+      end
+
+      def bordering_points
+        [point_by_angle(start_angle,
+                        point_type: :start),
+         point_by_angle(end_angle,
+                        point_type: :end)]
+      end
+
+    protected
+
+      def initialize(groups, representation_hash)
+        @representation_hash = representation_hash
+        super(groups)
+      end
+
+    private
+
+      def point_by_angle(angle, point_type: :start)
+        DxfIO::Entity::Support::Point.new(center.x + radius * Math::cos(angle),
+                                          center.y + radius * Math::sin(angle),
+                                          type: point_type)
+      end
+
+    end
+  end
+end