mittsu-3mf 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '090feca45fc7af2c1d8a2e340bdd891613936528ac15e1546f8d8b8448879572'
+  data.tar.gz: 792ef38dbb785b310ff53de0008cfe4a670077c83430c4b979c61bc051fdc0e7
+SHA512:
+  metadata.gz: 582b8756f4ad104ee31bca34d3df7511540c9243770ae49f2687249aa5d4d65efad8388183125cd4134ea64bc79b56721c61aa783c3426618cd15185fc1b47a3
+  data.tar.gz: a226ad6b92db706855237594fef7b8c20e8a6aa3045315bd9cb2ed64680e9fbd7c2dad72ed72bc4a4d70e2e779d82f0aa46c3f69e212cb4b437f4051b3f09a9f

data/README.md

@@ -0,0 +1,25 @@
+# Mittsu: 3MF
+3MF support for [Mittsu](https://github.com/danini-the-panini/mittsu).
+
+## Installation
+
+Just install:
+
+`bundle add mittsu-3mf`
+
+Then require in your code:
+
+`require 'mittsu/3mf'`
+
+## Usage
+
+Currently this gem just includes an exporter. Loading 3MF files is "coming soon".
+
+```
+exporter = Mittsu::ThreeMFExporter.new
+exporter.export(object, "output.3mf")
+```
+
+## About
+
+This code was originally written for [Manyfold](https://manyfold.app), supported by funding from [NLNet](https://nlnet.nl) and [NGI Zero](https://ngi.eu/ngi-projects/ngi-zero/).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/setup"
+
+require "rspec/core"
+require "rspec/core/rake_task"
+require "standard/rake"
+
+desc "Run all specs in spec directory"
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/mittsu/3mf/exporter.rb

@@ -0,0 +1,113 @@
+require "builder"
+require "zip/filesystem"
+
+module Mittsu
+  class ThreeMFExporter
+    def initialize(options = {})
+    end
+
+    def export(object, filename)
+      Zip::OutputStream.open(filename) do |zip|
+        # OPC content types file
+        store(zip, "[Content_Types].xml", content_types_file)
+        # Add models
+        models = [object]
+        model_names = models.map do |model|
+          # Set a model name if there isn't one
+          model.name ||= SecureRandom.uuid
+          # Store model
+          name = filesystem_safe_name(model)
+          store(zip, "3D/#{name}.model", model_file(model))
+          # Remember the name for later
+          name
+        end
+        # Add OPC rels file with list of contained models
+        store(zip, "_rels/.rels", rels_file(model_names))
+      end
+      true
+    end
+
+    # Parse is here for consistency with THREE.js's weird naming of exporter methods
+    alias_method :parse, :export
+
+    private
+
+    def filesystem_safe_name(model)
+      model.name.delete("/\\?*:|\"<>")
+    end
+
+    def store(zip, filename, data)
+      zip.put_next_entry(filename)
+      zip.write(data)
+    end
+
+    def build &block
+      xml = Builder::XmlMarkup.new
+      xml.instruct! :xml, encoding: "UTF-8"
+      yield xml
+      xml.target!
+    end
+
+    def content_types_file
+      build do |xml|
+        xml.Types xmlns: "http://schemas.openxmlformats.org/package/2006/content-types" do
+          xml.Default Extension: "rels", ContentType: "application/vnd.openxmlformats-package.relationships+xml"
+          xml.Default Extension: "model", ContentType: "application/vnd.ms-package.3dmanufacturing-3dmodel+xml"
+        end
+      end
+    end
+
+    def rels_file(models)
+      build do |xml|
+        xml.Relationships xmlns: "http://schemas.openxmlformats.org/package/2006/relationships" do
+          models.each do |name|
+            xml.Relationship Target: "/3D/#{name}.model", Id: name, ContentType: "http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"
+          end
+        end
+      end
+    end
+
+    def model_file(object)
+      build do |xml|
+        xml.model unit: "millimeter", "xml:lang": "en-US", xmlns: "http://schemas.microsoft.com/3dmanufacturing/core/2015/02" do
+          object_ids = []
+          xml.resources do
+            object.traverse do |x|
+              if x.is_a? Mesh
+                object_ids << build_object(xml, x)
+              end
+            end
+          end
+          xml.build do
+            object_ids.each do |id|
+              xml.item objectid: id
+            end
+          end
+        end
+      end
+    end
+
+    def build_object(xml, object)
+      uuid = SecureRandom.uuid
+      xml.object id: uuid, type: "model" do
+        build_mesh_element(xml, object.geometry)
+      end
+      uuid
+    end
+
+    def build_mesh_element(xml, geometry)
+      xml.mesh do
+        xml.vertices do
+          geometry.vertices.each do |vertex|
+            xml.vertex x: vertex.x, y: vertex.y, z: vertex.z
+          end
+        end
+        xml.triangles do
+          geometry.faces.each do |face|
+            xml.triangle v1: face.a, v2: face.b, v3: face.c
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mittsu/3mf/version.rb

@@ -0,0 +1,5 @@
+module Mittsu
+  module ThreeMF
+    VERSION = "0.1.0"
+  end
+end

data/lib/mittsu/3mf.rb

@@ -0,0 +1,3 @@
+require "mittsu"
+require "mittsu/3mf/version"
+require "mittsu/3mf/exporter"

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: mittsu-3mf
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Smith
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-11-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mittsu
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: builder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.41'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.41'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+description: 3MF file support for Mittsu
+email:
+- james@floppy.org.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/mittsu/3mf.rb
+- lib/mittsu/3mf/exporter.rb
+- lib/mittsu/3mf/version.rb
+homepage: https://github.com/manyfold3d/mittsu-mesh_analysis
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/manyfold3d/mittsu-mesh_analysis
+  source_code_uri: https://github.com/manyfold3d/mittsu-3mf
+  changelog_uri: https://github.com/manyfold3d/mittsu-3mf/releases
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: 3MF file support for Mittsu
+test_files: []