Difference between revisions of "Render Part D Assignment"

From CSE425S Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 6: Line 6:
  
 
=Background=
 
=Background=
Investigate [https://ruby-doc.org/core-2.5.0/Module.html Ruby Modules], specifically the <code>module</code> and <code>include</code> keywords.
+
Mixins are achieved in Ruby by including with [https://ruby-doc.org/core-2.5.0/Module.html modules].
 +
 
 +
<nowiki>module Nameable
 +
  def introduce
 +
    "Hello.  My name is #{@name}."
 +
  end
 +
end
 +
 
 +
class Person
 +
  include Nameable
 +
 
 +
  def initialize(name)
 +
    @name = name
 +
  end
 +
end
 +
 
 +
class Car
 +
  include Nameable
 +
  def initialize(name)
 +
    @name = name
 +
  end
 +
end
 +
 
 +
prof_grossman = Person.new("Dan")
 +
love_bug = Car.new("Herbie")
 +
 
 +
puts prof_grossman.introduce
 +
puts love_bug.introduce</nowiki>
  
 
=Warning=
 
=Warning=
Line 13: Line 40:
 
=Code to Implement=
 
=Code to Implement=
 
==Composite==
 
==Composite==
{{RubyModuleToImplement|composite|drawings|Composite|initialize_components()<br/>push_component(component)<br/>each_component()<br/>untransformed_bounds()}}
+
{{RubyModuleToImplement|composite|drawings|Composite|initialize_components()<br/>push_component(component)<br/>untransformed_render()<br/>untransformed_bounds()}}
  
module Composite should define methods <code>initialize_components</code>, <code>push_component</code>, <code>each_component</code>, and <code>untransformed_bounds</code> as well as mixin the [https://ruby-doc.org/core-2.6.3/Enumerable.html Enumerable] module.
+
module Composite should define methods <code>initialize_components</code>, <code>push_component</code>, <code>untransformed_render</code>, and <code>untransformed_bounds</code>.
  
 
===initialize_components===
 
===initialize_components===
Line 25: Line 52:
 
push a component onto your array instance variable.
 
push a component onto your array instance variable.
  
===each_component===
+
===untransformed_render===
if a block is given, yield for each component in your array instance variable. 
+
Similar to the untransformed render on CompositeTransform and Scene from Part B.
 
 
otherwise use [https://ruby-doc.org/core-2.6.3/Object.html#method-i-to_enum to_enum] to return a new Enumerator of the components.
 
 
 
Note: be sure to invoke <code>to_enum</code> with the symbol of the method <code>:each_component</code> and not invoke the method by mistake.
 
  
 
===untransformed_bounds===
 
===untransformed_bounds===
Similar to the untransformed bounds calculations on CompositeTransform and Scene from Part C.
+
Similar to the untransformed bounds calculations on CompositeTransform from Part C.
 
 
===Mixin Enumerable===
 
to add a number of useful methods, include the [https://ruby-doc.org/core-2.6.3/Enumerable.html Enumerable] module and
 
 
 
===Alias each===
 
use [https://www.rubydoc.info/stdlib/core/Module:alias_method alias_method] to alias an <code>:each</code> method to the <code>:each_component </code> method.
 
  
 
==CompositeTransform==
 
==CompositeTransform==
Line 50: Line 67:
 
  <code>include Composite</code>
 
  <code>include Composite</code>
  
Be sure to invoke <code>initialize_components</code> from the constructor and clean up existing code.  For example bounds calculation can now use [https://ruby-doc.org/core-2.6.3/Enumerable.html#method-i-map map].
+
Be sure to invoke <code>initialize_components</code> from the constructor and clean up existing code.
  
 
==Scene==
 
==Scene==
Line 61: Line 78:
 
  <code>include Composite</code>
 
  <code>include Composite</code>
  
Be sure to invoke <code>initialize_components</code> from the constructor and clean up existing code.  For example bounds calculation can now use [https://ruby-doc.org/core-2.6.3/Enumerable.html#method-i-map map].
+
Be sure to invoke <code>initialize_components</code> from the constructor and clean up existing code.
  
 
=Testing Your Solution=
 
=Testing Your Solution=
 
==Unit Test==
 
==Unit Test==
===Part D===
+
{{RubyUnitTest|*|drawings/core/relatively_fast/part_d}}
{{RubyUnitTest|*|drawings/preliminary/part_d}}
+
 
 
===Backwards Compatibility===
 
===Backwards Compatibility===
{{RubyUnitTest|*|drawings/preliminary/part_c}}
+
{{RubyUnitTest|*|drawings/core/relatively_fast/part_a}}
 
 
{{RubyUnitTest|*|drawings/preliminary/part_b}}
 
  
{{RubyUnitTest|*|drawings/preliminary/part_a}}
+
{{RubyUnitTest|*|drawings/core/relatively_fast/part_b}}
  
==Somewhat Outdated Testing Demo==
+
{{RubyUnitTest|*|drawings/core/relatively_fast/part_c}}
<youtube>utK0TewIRjc</youtube>
 

Latest revision as of 03:50, 4 May 2023

In this studio we will evolve our code from Render_Part_C_Assignment to leverage mixins.

Diagram part d.png

Continue editing files in the render/assignment directory.

Background

Mixins are achieved in Ruby by including with modules.

module Nameable
  def introduce
    "Hello.  My name is #{@name}."
  end
end

class Person
  include Nameable

  def initialize(name)
    @name = name
  end
end

class Car
  include Nameable
  def initialize(name)
    @name = name
  end
end

prof_grossman = Person.new("Dan")
love_bug = Car.new("Herbie")

puts prof_grossman.introduce
puts love_bug.introduce

Warning

caption

Do NOT use the include keyword in Ruby as you would typically in C or C++.
Be sure to include within the intended class or module definition.
If you include at the top-level, it will mixin to Object!
This may or may not rip a hole in the universe.

Code to Implement

Composite

file: src/main/ruby/drawings/composite.rb Ruby logo.svg
module: Composite
methods: initialize_components()
push_component(component)
untransformed_render()
untransformed_bounds()

module Composite should define methods initialize_components, push_component, untransformed_render, and untransformed_bounds.

initialize_components

add an instance variable with a suitable name to store an array of components

NOTE: initialize_components() must be private.

push_component

push a component onto your array instance variable.

untransformed_render

Similar to the untransformed render on CompositeTransform and Scene from Part B.

untransformed_bounds

Similar to the untransformed bounds calculations on CompositeTransform from Part C.

CompositeTransform

Be sure to add:

require_relative 'composite' Ruby logo.svg

Mixin your Composite module to the CompositeTransform class.

include Composite

Be sure to invoke initialize_components from the constructor and clean up existing code.

Scene

Be sure to add:

require_relative 'composite' Ruby logo.svg

Mixin your Composite module to the Scene class.

include Composite

Be sure to invoke initialize_components from the constructor and clean up existing code.

Testing Your Solution

Unit Test

file: src/test/ruby/drawings/core/relatively_fast/part_d/*.rb Ruby logo.svg UnitTest

note: ensure that you have removed all printing to receive credit for any assignment.

Backwards Compatibility

file: src/test/ruby/drawings/core/relatively_fast/part_a/*.rb Ruby logo.svg UnitTest

note: ensure that you have removed all printing to receive credit for any assignment.

file: src/test/ruby/drawings/core/relatively_fast/part_b/*.rb Ruby logo.svg UnitTest

note: ensure that you have removed all printing to receive credit for any assignment.

file: src/test/ruby/drawings/core/relatively_fast/part_c/*.rb Ruby logo.svg UnitTest

note: ensure that you have removed all printing to receive credit for any assignment.