pbrt 0.1.0

data/lib/pbrt/parameter.rb

@@ -0,0 +1,12 @@
+module PBRT
+  class Parameter
+    def initialize(type, name)
+      @type = type
+      @name = name
+    end
+
+    def to_s
+      %("#@type #@name")
+    end
+  end
+end

data/lib/pbrt/parameter_list.rb

@@ -0,0 +1,45 @@
+module PBRT
+  class ParameterList
+    def self.from(params, type_signature)
+      allow_shapes_to_override_materials!(params, type_signature)
+
+      Signature.new(type_signature).check(params)
+
+      pairs = params.map do |name, value|
+        type = type_signature[name]
+
+        type, value = Texture.unpack(type, value)
+
+        if type == :spectrum || value.is_a?(Spectrum)
+          type, value = Spectrum.unpack(value)
+        end
+
+        [Parameter.new(type, name), Values.new(value)]
+      end
+
+      new(pairs.to_h)
+    end
+
+    def initialize(name_value_pairs)
+      @name_value_pairs = name_value_pairs
+    end
+
+    def to_s
+      @name_value_pairs.map do |parameter, values|
+        [parameter.to_s, "[#{values}]"].join(" ")
+      end.join(" ")
+    end
+
+    def self.allow_shapes_to_override_materials!(params, type_signature)
+      return unless type_signature[:allow_material_overrides]
+      type_signature.delete(:allow_material_overrides)
+
+      surplus = params.keys - type_signature.keys
+
+      surplus.each do |key|
+        type = Builder::Material::ALL_PARAMS[key]
+        type_signature[key] = type if type
+      end
+    end
+  end
+end

data/lib/pbrt/signature.rb

@@ -0,0 +1,39 @@
+module PBRT
+  class Signature
+    TYPES = %i(
+      integer float point2 vector2 point3
+      vector3 normal3 spectrum bool string
+      texture float_texture spectrum_texture
+    )
+
+    def initialize(names_and_types)
+      @names_and_types = names_and_types
+
+      check_for_known_types
+    end
+
+    def check(params)
+      check_for_surplus(params)
+    end
+
+    private
+
+    def check_for_known_types
+      unknown = @names_and_types.values - TYPES
+
+      if unknown.any?
+        raise ArgumentError, "unknown types: #{unknown.join(", ")}"
+      end
+    end
+
+    def check_for_surplus(params)
+      surplus = params.keys - @names_and_types.keys
+
+      if surplus.size == 1
+        raise ArgumentError, "(unknown keyword: #{surplus.first})"
+      elsif surplus.size > 1
+        raise ArgumentError, "(unknown keywords: #{surplus.join(", ")})"
+      end
+    end
+  end
+end

data/lib/pbrt/spectrum.rb

@@ -0,0 +1,29 @@
+module PBRT
+  class Spectrum
+    attr_reader :type, :args
+
+    def initialize(type, *args)
+      @type = type
+      @args = args
+    end
+
+    def self.unpack(value)
+      check_value_is_a_spectrum(value)
+
+      [value.type, value.args]
+    end
+
+    def self.check_value_is_a_spectrum(value)
+      return if value.is_a?(self)
+
+      message = "Please specify the spectrum representation for #{value.inspect}.\n"
+      message += "You can do this by wrapping the value: rgb(#{value.inspect})\n"
+      message += "Valid representations are: rgb, xyz, sampled and blackbody"
+
+      raise AmbiguousSpectrumError, message
+    end
+  end
+
+  class AmbiguousSpectrumError < StandardError
+  end
+end

data/lib/pbrt/statement.rb

@@ -0,0 +1,11 @@
+module PBRT
+  class Statement
+    def self.fixed_size(*args)
+      FixedSize.new(*args)
+    end
+
+    def self.variadic(*args)
+      Variadic.new(*args)
+    end
+  end
+end

data/lib/pbrt/statement/fixed_size.rb

@@ -0,0 +1,28 @@
+module PBRT
+  class Statement
+    class FixedSize
+      def initialize(directive, expected, *args)
+        @directive = directive
+        @expected = expected
+        @values = Values.new(*args)
+
+        check_size
+      end
+
+      def to_s
+        @values.size.zero? ? @directive : "#@directive #@values"
+      end
+
+      private
+
+      def check_size
+        return if @expected == @values.size
+
+        message = "wrong number of arguments to #@directive "
+        message += "(given #{@values.size}, expected #@expected)"
+
+        raise ArgumentError, message
+      end
+    end
+  end
+end

data/lib/pbrt/statement/variadic.rb

@@ -0,0 +1,15 @@
+module PBRT
+  class Statement
+    class Variadic
+      def initialize(directive, kind, parameter_list)
+        @directive = directive
+        @kind = kind
+        @parameter_list = parameter_list
+      end
+
+      def to_s
+        %(#@directive "#@kind" #@parameter_list).strip
+      end
+    end
+  end
+end

data/lib/pbrt/texture.rb

@@ -0,0 +1,63 @@
+# This class does double duty as both a means of wrapping parameter
+# values to disambiguate them from floats/spectrums, but it's also
+# the interface for the builder to write Texture directives.
+
+module PBRT
+  class Texture
+    attr_reader :args
+
+    def initialize(builder, *args)
+      @builder = builder
+      @args = args
+    end
+
+    # If these three methods are called, it means the user is trying
+    # to write a Texture directive, so delegate to that builder.
+    def spectrum
+      PBRT::Builder::Texture.new(@builder, args.first, "spectrum")
+    end
+
+    def color
+      PBRT::Builder::Texture.new(@builder, args.first, "color")
+    end
+
+    def float
+      PBRT::Builder::Texture.new(@builder, args.first, "float")
+    end
+
+    def self.unpack(type, value)
+      return [type, value] unless type.to_s.include?("texture")
+      return [:texture, value.args] if value.is_a?(self)
+
+      if type == :float_texture
+        return string?(value) ? [:texture, value] : [:float, value]
+      end
+
+      if type == :spectrum_texture && !string?(value)
+        return [:spectrum, value]
+      end
+
+      if type == :texture && !string?(value)
+        return [:float, value]
+      end
+
+      raise_ambiguous_error(value)
+    end
+
+    def self.raise_ambiguous_error(value)
+      message = "Please specify whether #{value.inspect} is a spectrum or texture.\n"
+      message += "If it's a texture, wrap it with: texture(#{value.inspect})\n"
+      message += "If it's a spectrum, wrap it with its representation: sampled(#{value.inspect})\n"
+      message += "Valid representations are: rgb, xyz, sampled and blackbody"
+
+      raise AmbiguousArgumentError, message
+    end
+
+    def self.string?(*value)
+      value.flatten.first.is_a?(String)
+    end
+  end
+
+  class AmbiguousArgumentError < StandardError
+  end
+end

data/lib/pbrt/values.rb

@@ -0,0 +1,25 @@
+module PBRT
+  class Values
+    def initialize(*inner)
+      @inner = inner.flatten
+    end
+
+    def to_s
+      @inner.map { |v| format(v) }.join(" ")
+    end
+
+    def size
+      @inner.size
+    end
+
+    private
+
+    def format(value)
+      return '"true"' if value.is_a?(TrueClass)
+      return '"false"' if value.is_a?(FalseClass)
+      return %("#{value}") if value.is_a?(String)
+
+      value
+    end
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: pbrt
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chris Patuzzo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.8.0
+description: A Ruby gem to generate scene description files for the third edition
+  of Physically Based Rendering.
+email: chris@patuzzo.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/pbrt.rb
+- lib/pbrt/builder.rb
+- lib/pbrt/builder/accelerator.rb
+- lib/pbrt/builder/area_light_source.rb
+- lib/pbrt/builder/camera.rb
+- lib/pbrt/builder/film.rb
+- lib/pbrt/builder/integrator.rb
+- lib/pbrt/builder/light_source.rb
+- lib/pbrt/builder/material.rb
+- lib/pbrt/builder/named_material.rb
+- lib/pbrt/builder/named_medium.rb
+- lib/pbrt/builder/pixel_filter.rb
+- lib/pbrt/builder/sampler.rb
+- lib/pbrt/builder/shape.rb
+- lib/pbrt/builder/texture.rb
+- lib/pbrt/parameter.rb
+- lib/pbrt/parameter_list.rb
+- lib/pbrt/signature.rb
+- lib/pbrt/spectrum.rb
+- lib/pbrt/statement.rb
+- lib/pbrt/statement/fixed_size.rb
+- lib/pbrt/statement/variadic.rb
+- lib/pbrt/texture.rb
+- lib/pbrt/values.rb
+homepage: https://github.com/tuzz/pbrt
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: PBRT
+test_files: []