htmlgrid 1.0.0

data/lib/htmlgrid/booleanvalue.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#
+#	HtmlGrid -- HyperTextMarkupLanguage Framework
+#	Copyright (C) 2003 ywesee - intellectual capital connected
+# Andreas Schrafl, Benjamin Fay, Hannes Wyss, Markus Huggler
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#	ywesee - intellectual capital connected, Winterthurerstrasse 52, CH-8006 Zuerich, Switzerland
+#	htmlgrid@ywesee.com, www.ywesee.com
+#
+# BooleanValue -- oddb -- 28.07.2003 -- hwyss@ywesee.com 
+
+require 'htmlgrid/namedcomponent'
+
+module HtmlGrid
+	class BooleanValue < NamedComponent
+		LABEL = true
+		def init
+			bool = if(@model.respond_to?(@name) && @model.send(@name))
+				:true
+			else
+				:false
+			end
+			@value = @lookandfeel.lookup(bool)
+		end
+	end
+end

data/lib/htmlgrid/button.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#
+#	HtmlGrid -- HyperTextMarkupLanguage Framework
+#	Copyright (C) 2003 ywesee - intellectual capital connected
+# Andreas Schrafl, Benjamin Fay, Hannes Wyss, Markus Huggler
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#	ywesee - intellectual capital connected, Winterthurerstrasse 52, CH-8006 Zuerich, Switzerland
+#	htmlgrid@ywesee.com, www.ywesee.com/htmlgrid
+#
+# Button -- htmlgrid -- 26.11.2002 -- hwyss@ywesee.com 
+
+require 'htmlgrid/staticinput'
+
+module HtmlGrid
+	class Button < StaticInput
+		def init
+			super
+			@attributes['type'] = 'button'
+		end
+	end
+end

data/lib/htmlgrid/centeredcomposite.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#
+#	HtmlGrid -- HyperTextMarkupLanguage Framework
+#	Copyright (C) 2003 ywesee - intellectual capital connected
+# Andreas Schrafl, Benjamin Fay, Hannes Wyss, Markus Huggler
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#	ywesee - intellectual capital connected, Winterthurerstrasse 52, CH-8006 Zuerich, Switzerland
+#	htmlgrid@ywesee.com, www.ywesee.com/htmlgrid
+#
+# CenteredComposite -- htmlgrid -- 7.1.2003 -- hwyss@ywesee.com 
+
+require 'htmlgrid/composite'
+
+module HtmlGrid
+	class CenteredComposite < Composite
+		TABLE_ATTRIBUTES = {
+			"style"	=>	"margin-left:auto;margin-right:auto;text-align:left",
+		}
+		DIV_ATTRIBUTES = {
+			"style"	=>	"text-align:center;margin-left:auto;margin-right:auto;text-align:left",
+		}
+		def to_html(context)
+			context.div(self::class::DIV_ATTRIBUTES) {
+				super 
+			}
+		end
+		def init
+			super
+			@attributes.update(self::class::TABLE_ATTRIBUTES)
+		end
+	end
+end

data/lib/htmlgrid/component.rb

@@ -0,0 +1,232 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#--
+#	HtmlGrid -- HyperTextMarkupLanguage Framework
+#	Copyright (C) 2003 ywesee - intellectual capital connected
+# Andreas Schrafl, Benjamin Fay, Hannes Wyss, Markus Huggler
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#	ywesee - intellectual capital connected, Winterthurerstrasse 52, CH-8006 Zuerich, Switzerland
+#	htmlgrid@ywesee.com, www.ywesee.com/htmlgrid
+#
+# Component -- htmlgrid -- 23.10.2002 -- hwyss@ywesee.com 
+#++
+
+module HtmlGrid
+	class Component
+		# sets the 'class' html-attribute
+		CSS_CLASS = nil
+		# sets the 'id' html-attribute
+		CSS_ID = nil
+		# other html-attributes
+		HTML_ATTRIBUTES = {}
+    # default http-headers
+    HTTP_HEADERS = {
+      "Content-Type"  => "text/html",
+      "Cache-Control" => "no-cache, max-age=3600, must-revalidate",
+    }
+		# precede instances of this class with a label?
+		LABEL = false
+		@@html_entities = [
+			['&', 'amp'],
+			['<', 'lt'],
+			['>', 'gt'],
+		] # :nodoc:
+		@@symbol_entities = {
+			34	=>	"forall",
+			36	=>	"exist",
+			42	=>	"lowast",
+			45	=>	"minus",
+			64	=>	"cong",
+			65	=>	"Alpha",				97	=>	"alpha",
+			66	=>	"Beta",     		98	=>	"beta",
+			67	=>	"Chi",      		99	=>	"chi",
+			68	=>	"Delta",    		100	=>	"delta",
+			69	=>	"Epsilon",  		101	=>	"epsilon",
+			70	=>	"Phi",      		102	=>	"phi",
+			71	=>	"Gamma",    		103	=>	"gamma",
+			72	=>	"Eta",      		104	=>	"eta",
+			73	=>	"Iota",     		105	=>	"iota",
+			75	=>	"Kappa",    		107	=>	"kappa",
+			76	=>	"Lambda",   		108	=>	"lambda",
+			77	=>	"Mu",       		109	=>	"mu",
+			78	=>	"Nu",       		110	=>	"nu",
+			79	=>	"Omicron",  		111	=>	"omicron",
+			80	=>	"Pi",       		112	=>	"pi",
+			81	=>	"Theta",    		113	=>	"theta",
+			82	=>	"Rho",      		114	=>	"rho",
+			83	=>	"Sigma",    		115	=>	"sigma",
+			84	=>	"Tau",      		116	=>	"tau",
+			85	=>	"Upsilon",  		117	=>	"upsilon",
+			86	=>	"sigmaf",   		
+			87	=>	"Omega",    		119	=>	"omega",
+			88	=>	"Xi",       		120	=>	"xi",
+			89	=>	"Psi",      		121	=>	"psi",
+			90	=>	"Zeta",     		122	=>	"zeta",
+			94	=>	"perp",					126	=>	"sim",
+	                           	163	=>	"le",
+															165	=>	"infin",
+															166	=>	"fnof",
+															171	=>	"harr",
+															172	=>	"larr",
+															173	=>	"uarr",
+															174	=>	"rarr",
+															175	=>	"darr",
+															179	=>	"ge",
+															181	=>	"prop",
+															182	=>	"part",
+															185	=>	"ne",
+															186	=>	"equiv",
+															187	=>	"asymp",
+															191	=>	"crarr",
+															196	=>	"otimes",
+															197	=>	"oplus",
+															198	=>	"empty",
+															199	=>	"cap",
+															200	=>	"cup",
+															201	=>	"sup",
+															202	=>	"supe",
+															203	=>	"nsub",
+															204	=>	"sub",
+															205	=>	"sube",
+															206	=>	"isin",
+															207	=>	"notin",
+															208	=>	"ang",
+															209	=>	"nabla",
+															213	=>	"prod",
+															214	=>	"radic",
+															215	=>	"sdot",
+															217	=>	"and",
+															218	=>	"or",
+															219	=>	"hArr",
+															220	=>	"lArr",
+															221	=>	"uArr",
+															222	=>	"rArr",
+															223	=>	"dArr",
+															229	=>	"sum",
+															242	=>	"int",
+		} # :nodoc:
+		attr_reader :attributes, :model
+		attr_accessor :value
+		def initialize(model, session=nil, container=nil)
+			@model = model
+			@session = session
+			@lookandfeel = session.lookandfeel if session.respond_to?(:lookandfeel)
+			@container = container
+			@attributes = self::class::HTML_ATTRIBUTES.dup
+			if(css_class())
+				@attributes.store("class", css_class())
+			end
+			if(css_id())
+				@attributes.store("id", css_id())
+			end
+			@value = nil
+			@label = self::class::LABEL
+			init()
+		end
+		# delegator to @container, default definition in Form
+		def autofill?
+			@container.autofill? if @container.respond_to?(:autofill?)
+		end
+		# gets the 'class' html-attribute if defined
+		def css_class
+			@css_class ||= self::class::CSS_CLASS
+		end
+		# sets the 'class' html-attribute
+		def css_class=(css_class)
+			@css_class = @attributes['class'] = css_class
+		end
+		# gets the 'id' html-attribute if defined
+		def css_id
+			@css_id ||= self::class::CSS_ID
+		end
+		# sets the 'id' html-attribute
+		def css_id=(css_id)
+			@css_id = @attributes['id'] = css_id
+		end
+		def dynamic_html(context)
+			''
+		end
+		# escape '&', '<' and '>' characters in txt
+		def escape(txt)
+			@@html_entities.inject(txt.to_s.dup) { |str, map| 
+				char, entity = map
+				str.gsub!(char, '&' << entity << ';')
+				str
+			}
+		end
+		# escape symbol-font strings
+		def escape_symbols(txt)
+			esc = ''
+			txt.to_s.each_byte { |byte|
+				esc << if(entity = @@symbol_entities[byte])
+					'&' << entity << ';'
+				else
+					byte.chr
+				end
+			}
+			esc
+		end
+		# delegator to @container, default definition in Form
+		def formname
+			@container.formname if @container.respond_to?(:formname)
+		end
+		def http_headers
+			self::class::HTTP_HEADERS.dup
+		end
+		# precede this instance with a label?
+		def label?
+			@label
+		end
+		def label=(boolean)
+			@label = boolean
+		end
+		def onclick=(onclick)
+      @attributes['onclick'] = onclick
+		end
+		# delegator to @container, default definition in Template
+		def onload=(onload)
+			@container.onload = onload if(@container.respond_to? :onload=)
+		end
+		# delegator to @container, default definition in Form
+		def onsubmit=(onsubmit)
+			@container.onsubmit = onsubmit if(@container.respond_to? :onsubmit=)
+		end
+		# set a html attribute
+		def set_attribute(key, value)
+			@attributes.store(key, value)
+		end
+		def tabindex=(tab)
+			@attributes.store('tabIndex', tab.to_s)
+		end
+		def to_html(context)
+			_to_html(context, @value).to_s
+		end
+    @@nl2br_ptrn = /(\r\n)|(\n)|(\r)/
+		def _to_html(context, value=@value)
+			if(value.is_a?(Array))
+				value.collect { |item| _to_html(context, item) }.join(' ')
+			elsif(value.respond_to?(:to_html))
+				value.to_html(context).to_s
+			else
+				value.to_s.gsub(@@nl2br_ptrn, '<br>')
+			end
+		end
+		private
+		def init
+		end
+	end
+end

data/lib/htmlgrid/composite.rb

@@ -0,0 +1,350 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#
+#	HtmlGrid -- HyperTextMarkupLanguage Framework
+#	Copyright (C) 2003 ywesee - intellectual capital connected
+# Andreas Schrafl, Benjamin Fay, Hannes Wyss, Markus Huggler
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#	ywesee - intellectual capital connected, Winterthurerstrasse 52, CH-8006 Zuerich, Switzerland
+#	htmlgrid@ywesee.com, www.ywesee.com/htmlgrid
+#
+# Template -- htmlgrid -- 23.10.2002 -- hwyss@ywesee.com 
+
+require 'htmlgrid/grid'
+require 'htmlgrid/component'
+require 'htmlgrid/value'
+require 'htmlgrid/inputtext'
+require 'htmlgrid/label'
+require 'htmlgrid/text'
+
+if RUBY_VERSION < '1.9'
+  class Hash
+    alias :key :index
+  end
+end
+
+module HtmlGrid
+	class AbstractComposite < Component
+		LABELS = false
+		LEGACY_INTERFACE = true
+		SYMBOL_MAP = {}
+		CSS_MAP = {}
+		CSS_ID_MAP = {}
+		CSS_STYLE_MAP = {}
+		CSS_CLASS = nil
+		CSS_ID = nil
+		DEFAULT_CLASS = Value
+		LOOKANDFEEL_MAP = {}
+		def init
+			super
+			setup_grid()
+			compose()
+		end
+		def create(component, model=@model)
+			if(component.is_a? Class)
+				component.new(model, @session, self)
+			elsif(component.is_a? Symbol)
+				if(self.respond_to?(component, true))
+					args = [model]
+					if(self::class::LEGACY_INTERFACE)
+						args.push(@session)
+					end
+					self.send(component, *args)
+				elsif(klass = symbol_map[component])
+					klass.new(component, model, @session, self)
+				else
+					self::class::DEFAULT_CLASS.new(component, model, @session, self)
+				end
+			elsif(component.is_a? String)
+				val = @lookandfeel.lookup(component) { component.to_s }
+        val.gsub(@@nl2br_ptrn, '<br>')
+			end
+		rescue StandardError => exc
+			exc.backtrace.push(sprintf("%s::COMPONENTS[%s] in create(%s)", 
+				self.class, components.key(component).inspect, component))
+			raise exc
+		end
+		private
+		def components
+			@components ||= self::class::COMPONENTS.dup
+		end
+		def css_id_map
+			@css_id_map ||= self::class::CSS_ID_MAP.dup
+		end
+		def css_map
+			@css_map ||= self::class::CSS_MAP.dup
+		end
+		def css_style_map
+			@css_style_map ||= self::class::CSS_STYLE_MAP.dup
+		end
+		def labels?
+			self::class::LABELS
+		end
+		def lookandfeel_map 
+			@lookandfeel_map ||= self::class::LOOKANDFEEL_MAP.dup
+		end
+		def symbol_map
+			@symbol_map ||= self::class::SYMBOL_MAP.dup
+		end
+		def AbstractComposite.component(klass, key, name=nil)
+			methname = klass.to_s.downcase.gsub('::', '_') << '_' << key.to_s
+			define_method(methname) { |*args|
+				model, session = args
+				args = [model.send(key), @session, self]
+				if(name)
+					args.unshift(name)
+					lookandfeel_map.store(methname.to_sym, name.to_sym)
+				end
+				klass.new(*args)
+			}
+			methname.to_sym
+		end
+	end
+	class TagComposite < AbstractComposite
+		def compose(model=@model)
+			components.sort { |a, b|
+				a <=> b
+			}.each { |pos, component|
+				@grid.push(label(create(component, model), component))
+				css = {}
+				if(klass = css_map[pos])
+					css.store('class', klass)
+				end
+				if(id = css_id_map[pos])
+					css.store('id', id)
+				end
+				if(style = css_style_map[pos])
+					css.store('style', style)
+				end
+				@css_grid.push(css.empty? ? nil : css)
+			}
+		end
+		def create(component, model=@model)
+			if(component.is_a? Class)
+				component.new(model, @session, self)
+			elsif(component.is_a? Symbol)
+				if(self.respond_to?(component, true))
+					self.send(component, model)
+				elsif(klass = symbol_map[component])
+					klass.new(component, model, @session, self)
+				else
+					self::class::DEFAULT_CLASS.new(component, model, @session, self)
+				end
+			elsif(component.is_a? String)
+				val = @lookandfeel.lookup(component) { component.to_s }
+        val.gsub(@@nl2br_ptrn, '<br>')
+			end
+		rescue StandardError => exc
+			exc.backtrace.push(sprintf("%s::COMPONENTS[%s] in create(%s)", 
+				self.class, components.index(component).inspect, component))
+			raise exc
+		end
+		def insert_row(ypos, txt, css_class=nil)
+			@grid[ypos, 0] = [[txt]]
+			@css_grid[ypos, 0] = [css_class ? {'class' => css_class} : nil]
+		end
+		def label(component, key)
+			if(labels? \
+         && (!component.respond_to?(:label?) || component.label?))
+				label = SimpleLabel.new(key, component, @session, self)
+				[label, component]
+			else
+				component
+			end
+		end
+		def setup_grid
+			@grid = []
+			@css_grid = []
+		end
+		def submit(model=@model, name=event())
+			Submit.new(name, model, @session, self)
+		end
+		def tag_attributes(idx=nil)
+			attr = {}
+			if(klass = self.class.const_get(:CSS_CLASS))
+				attr.store('class', klass)
+			end
+			if(id = self.class.const_get(:CSS_ID))
+				attr.store('id', id)
+			end
+			if(idx && (css = @css_grid.at(idx)))
+				attr.update(css)
+			end
+			attr
+		end
+	end
+	class Composite < AbstractComposite
+		COLSPAN_MAP = {}
+		COMPONENT_CSS_MAP = {}
+		CSS_MAP = {}
+		DEFAULT_CLASS = InputText
+		VERTICAL = false
+		def compose(model=@model, offset=[0,0], bg_flag=false)
+			comps = components
+			css = css_map
+      cids = css_id_map
+			ccss = component_css_map
+			colsp = colspan_map
+			suffix = resolve_suffix(model, bg_flag)
+			comps.keys.concat(css.keys).concat(colsp.keys).uniq.sort_by { |key| 
+        [-key.size, key] 
+      }.each { |key|
+				nkey = key[0,2]
+				matrix = resolve_offset(key, offset)
+				nmatrix = resolve_offset(nkey, offset)
+				comp = compose_component(model, comps[key], matrix)
+				if(style = css[key])
+					@grid.add_style(style + suffix, *matrix)
+				elsif(style = css[nkey])
+					@grid.add_style(style + suffix, *nmatrix)
+				end
+        if(id = cids[key] || cids[nkey])
+          comp.css_id = id
+        end
+				if(span = colsp[key])
+					@grid.set_colspan(matrix.at(0), matrix.at(1), span)	
+				end
+			}
+      # component-styles depend on components having been initialized 
+      # -> separate iteration
+      ccss.each { |key, cstyle|
+        matrix = resolve_offset(key, offset)
+        @grid.add_component_style(cstyle + suffix, *matrix)
+      }
+=begin
+			compose_components(model, offset)
+			compose_css(offset)
+			compose_colspan(offset)
+=end
+		end
+		alias :_compose :compose
+		def compose_colspan(offset)
+			colspan_map.each { |matrix, span|
+				res = resolve_offset(matrix, offset)
+				@grid.set_colspan(res.at(0), res.at(1), span)	
+			}
+		end
+		def event
+			@container.event if @container.respond_to?(:event)
+		end
+=begin
+		def explode!
+			@grid.explode!
+			super
+		end
+=end
+		def full_colspan
+			raw_span = components.keys.collect{ |key|
+				key.at(0)
+			}.max.to_i
+			(raw_span > 0) ? raw_span + 1 : nil
+		end
+		def insert_row(ypos, txt, css_class=nil)
+			@grid.insert_row(ypos, txt)
+			@grid.set_colspan(0,ypos)
+			@grid.add_style(css_class, 0, ypos) if(css_class)
+		end
+		def to_html(context)
+			@grid.set_attributes(@attributes)
+			super << @grid.to_html(context)
+		end
+		private
+		def back(model=@model, session=@session)
+			bak = HtmlGrid::Button.new(:back, model, session, self)	
+			url = @lookandfeel.event_url(:back)
+			bak.set_attribute("onClick","document.location.href='#{url}';")
+			bak
+		end
+		def colspan_map
+			@colspan_map ||= self::class::COLSPAN_MAP.dup
+		end
+		def component_css_map
+			@component_css_map ||= self::class::COMPONENT_CSS_MAP.dup
+		end
+		def compose_component(model, component, matrix)
+			if(component)
+				comp = create(component, model)
+				if((tab = matrix.at(3)) && comp.respond_to?(:tabindex=))
+					comp.tabindex = tab
+				end
+				@grid.add(label(comp, component), matrix.at(0), matrix.at(1), 
+					self::class::VERTICAL)
+        comp
+			end
+		end
+		## compose_components: legacy-code
+		def compose_components(model=@model, offset=[0,0])
+			warn "HtmlGrid::List#compose_components is deprecated"
+			each_component { |matrix, component|
+				res = resolve_offset(matrix, offset)
+				comp = create(component, model)
+				if((tab = matrix.at(3)) && comp.respond_to?(:tabindex=))
+					comp.tabindex = tab
+				end
+				@grid.add(label(comp, component), res.at(0), res.at(1), 
+					self::class::VERTICAL)
+			}
+		end
+		## compose_css: legacy-code
+		def compose_css(offset=[0,0], suffix='')
+			warn "HtmlGrid::List#compose_css is deprecated"
+			each_css { |matrix, style| 
+				@grid.add_style(style + suffix, *resolve_offset(matrix, offset))
+			}
+			each_component_css { |matrix, style|
+				@grid.add_component_style(style + suffix, *resolve_offset(matrix, offset))
+			}
+		end
+		def each_component(&block)
+			(@sorted_components ||= components.sort).each(&block)
+		end
+		def each_component_css(&block)
+			(@sorted_component_css_map ||= component_css_map.sort).each(&block)
+		end
+		def each_css(&block)
+			(@sorted_css_map ||= css_map.sort).each(&block)
+		end
+		def label(component, key=nil)
+			if labels?
+				HtmlGrid::Label.new(component, @session, lookandfeel_key(key))
+			else
+				component
+			end
+		end
+		def lookandfeel_key(component)
+			lookandfeel_map.fetch(component) {
+				component
+			}
+		end
+		def setup_grid
+			@grid = Grid.new
+		end
+		def submit(model=@model, session=@session, name=event())
+			Submit.new(name, model, session, self)
+		end
+		def resolve_offset(matrix, offset=[0,0])
+			result = []
+			matrix.each_with_index{ |value, index|
+				result.push(value+offset.at(index).to_i)
+			}
+			result
+		end
+		def resolve_suffix(model, bg_flag=false)
+			bg_flag ? self::class::BACKGROUND_SUFFIX : ''
+		end
+	end
+end