rndk 0.0.1

data/lib/rndk/histogram.rb

@@ -0,0 +1,412 @@
+require 'rndk'
+
+module RNDK
+  class HISTOGRAM < RNDK::Widget
+    def initialize(rndkscreen, xplace, yplace, height, width, orient,
+        title, box, shadow)
+      super()
+      parent_width = Ncurses.getmaxx(rndkscreen.window)
+      parent_height = Ncurses.getmaxy(rndkscreen.window)
+
+      self.setBox(box)
+
+      box_height = RNDK.setWidgetDimension(parent_height, height, 2)
+      old_height = box_height
+
+      box_width = RNDK.setWidgetDimension(parent_width, width, 0)
+      old_width = box_width
+
+      box_width = self.setTitle(title, -(box_width + 1))
+
+      # Increment the height by number of lines in in the title
+      box_height += @title_lines
+
+      # Make sure we didn't extend beyond the dimensions of the window.
+      box_width = if box_width > parent_width
+                  then old_width
+                  else box_width
+                  end
+      box_height = if box_height > parent_height
+                  then old_height
+                  else box_height
+                  end
+
+      # Rejustify the x and y positions if we need to.
+      xtmp = [xplace]
+      ytmp = [yplace]
+      RNDK.alignxy(rndkscreen.window, xtmp, ytmp, box_width, box_height)
+      xpos = xtmp[0]
+      ypos = ytmp[0]
+
+      # Set up the histogram data
+      @screen = rndkscreen
+      @parent = rndkscreen.window
+      @win = Ncurses.newwin(box_height, box_width, ypos, xpos)
+      @shadow_win = nil
+      @box_width = box_width
+      @box_height = box_height
+      @field_width = box_width - 2 * @border_size
+      @field_height = box_height - @title_lines - 2 * @border_size
+      @orient = orient
+      @shadow = shadow
+
+      # Is the window nil
+      if @win.nil?
+        self.destroy
+        return nil
+      end
+
+      Ncurses.keypad(@win, true)
+
+      # Set up some default values.
+      @filler = '#'.ord | Ncurses::A_REVERSE
+      @stats_attr = Ncurses::A_NORMAL
+      @stats_pos = RNDK::TOP
+      @view_type = :REAL
+      @high = 0
+      @low = 0
+      @value = 0
+      @lowx = 0
+      @lowy = 0
+      @highx = 0
+      @highy = 0
+      @curx = 0
+      @cury = 0
+      @low_string = ''
+      @high_string = ''
+      @cur_string = ''
+
+      # Do we want a shadow?
+      if shadow
+        @shadow_win = Ncurses.newwin(box_height,
+                                     box_width,
+                                     ypos + 1,
+                                     xpos + 1)
+      end
+
+      rndkscreen.register(:HISTOGRAM, self)
+    end
+
+    # This was added for the builder
+    def activate(actions)
+      self.draw(@box)
+    end
+
+    # Set various widget attributes
+    def set(view_type, stats_pos, stats_attr, low, high, value, filler, box)
+      self.setDisplayType(view_type)
+      self.setStatsPos(stats_pos)
+      self.setValue(low, high, value)
+      self.setFillerChar(filler)
+      self.setStatsAttr(stats_attr)
+      self.setBox(box)
+    end
+
+    # Set the values for the widget.
+    def setValue(low, high, value)
+      # We should error check the information we have.
+      @low = if low <= high then low else 0 end
+      @high = if low <= high then high else 0 end
+      @value = if low <= value && value <= high then value else 0 end
+      # Determine the percentage of the given value.
+      @percent = if @high == 0 then 0 else 1.0 * @value / @high end
+
+      # Determine the size of the histogram bar.
+      if @orient == RNDK::VERTICAL
+        @bar_size = @percent * @field_height
+      else
+        @bar_size = @percent * @field_width
+      end
+
+      # We have a number of variables which determine the personality of the
+      # histogram.  We have to go through each one methodically, and set them
+      # correctly.  This section does this.
+      if @view_type != :NONE
+        if @orient == RNDK::VERTICAL
+          if @stats_pos == RNDK::LEFT || @stats_pos == RNDK::BOTTOM
+            # Set the low label attributes.
+            @low_string = @low.to_s
+            @lowx = 1
+            @lowy = @box_height - @low_string.size - 1
+
+            # Set the high label attributes
+            @high_string = @high.to_s
+            @highx = 1
+            @highy = @title_lines + 1
+
+            string = ''
+            # Set the current value attributes.
+            string = if @view_type == :PERCENT
+                     then "%3.1f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTION
+                         string = "%d/%d" % [@value, @high]
+                     else string = @value.to_s
+                     end
+            @cur_string = string
+            @curx = 1
+            @cury = (@field_height - string.size) / 2 + @title_lines + 1
+          elsif @stats_pos == RNDK::CENTER
+            # Set the lower label attributes
+            @low_string = @low.to_s
+            @lowx = @field_width / 2 + 1
+            @lowy = @box_height - @low_string.size - 1
+
+            # Set the high label attributes
+            @high_string = @high.to_s
+            @highx = @field_width / 2 + 1
+            @highy = @title_lines + 1
+
+            # Set the stats label attributes
+            string = if @view_type == :PERCENT
+                     then "%3.2f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTIOn
+                         "%d/%d" % [@value, @high]
+                     else @value.to_s
+                     end
+
+            @cur_string = string
+            @curx = @field_width / 2 + 1
+            @cury = (@field_height - string.size) / 2 + @title_lines + 1
+          elsif @stats_pos == RNDK::RIGHT || @stats_pos == RNDK::TOP
+            # Set the low label attributes.
+            @low_string = @low.to_s
+            @lowx = @field_width
+            @lowy = @box_height - @low_string.size - 1
+
+            # Set the high label attributes.
+            @high_string = @high.to_s
+            @highx = @field_width
+            @highy = @title_lines + 1
+
+            # Set the stats label attributes.
+            string = if @view_type == :PERCENT
+                     then "%3.2f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTION
+                         "%d/%d" % [@value, @high]
+                     else @value.to_s
+                     end
+            @cur_string = string
+            @curx = @field_width
+            @cury = (@field_height - string.size) / 2 + @title_lines + 1
+          end
+        else
+          # Alignment is HORIZONTAL
+          if @stats_pos == RNDK::TOP || @stats_pos == RNDK::RIGHT
+            # Set the low label attributes.
+            @low_string = @low.to_s
+            @lowx = 1
+            @lowy = @title_lines + 1
+
+            # Set the high label attributes.
+            @high_string = @high.to_s
+            @highx = @box_width - @high_string.size - 1
+            @highy = @title_lines + 1
+
+            # Set the stats label attributes.
+            string = if @view_type == :PERCENT
+                     then "%3.1f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTION
+                         "%d/%d" % [@value, @high]
+                     else @value.to_s
+                     end
+            @cur_string = string
+            @curx = (@field_width - @cur_string.size) / 2 + 1
+            @cury = @title_lines + 1
+          elsif @stats_pos == RNDK::CENTER
+            # Set the low label attributes.
+            @low_string = @low.to_s
+            @lowx = 1
+            @lowy = (@field_height / 2) + @title_lines + 1
+
+            # Set the high label attributes.
+            @high_string = @high.to_s
+            @highx = @box_width - @high_string.size - 1
+            @highy = @field_height / 2 + @title_lines + 1
+
+            # Set the stats label attributes.
+            string = if @view_type == :PERCENT
+                     then "%3.1f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTION
+                         "%d/%d" % [@value, @high]
+                     else @value.to_s
+                     end
+            @cur_string = string
+            @curx = (@field_width - @cur_string.size) / 2 + 1
+            @cury = @field_height / 2 + @title_lines + 1
+          elsif @stats_pos == RNDK::BOTTOM || @stats_pos == RNDK::LEFT
+            # Set the low label attributes.
+            @low_string = @low.to_s
+            @lowx = 1
+            @lowy = @box_height -2 * @border_size
+
+            # Set the high label attributes.
+            @high_string = @high.to_s
+            @highx = @box_width - @high_string.size - 1
+            @highy = @box_height - 2 * @border_size
+
+            # Set the stats label attributes.
+            string = if @view_type == :PERCENT
+                     then "%3.1f%%" % [1.0 * @percent * 100]
+                     elsif @view_type == :FRACTION
+                         "%d/%d" % [@value, @high]
+                     else @value.to_s
+                     end
+            @cur_string = string
+            @curx = (@field_width - @cur_string.size) / 2 + 1
+            @cury = @box_height - 2 * @border_size
+          end
+        end
+      end
+    end
+
+    def getValue
+      return @value
+    end
+
+    def getLowValue
+      return @low
+    end
+
+    def getHighValue
+      return @high
+    end
+
+    # Set the histogram display type
+    def setDisplayType(view_type)
+      @view_type = view_type
+    end
+
+    def getViewType
+      return @view_type
+    end
+
+    # Set the position of the statistics information.
+    def setStatsPos(stats_pos)
+      @stats_pos = stats_pos
+    end
+
+    def getStatsPos
+      return @stats_pos
+    end
+
+    # Set the attribute of the statistics.
+    def setStatsAttr(stats_attr)
+      @stats_attr = stats_attr
+    end
+
+    def getStatsAttr
+      return @stats_attr
+    end
+
+    # Set the character to use when drawing the widget.
+    def setFillerChar(character)
+      @filler = character
+    end
+
+    def getFillerChar
+      return @filler
+    end
+
+    # Set the background attribute of the widget.
+    def setBKattr(attrib)
+      Ncurses.wbkgd(@win, attrib)
+    end
+
+    # Move the histogram field to the given location.
+    # Inherited
+    # def move(xplace, yplace, relative, refresh_flag)
+    # end
+
+    # Draw the widget.
+    def draw(box)
+      battr = 0
+      bchar = 0
+      fattr = @filler & Ncurses::A_ATTRIBUTES
+      hist_x = @title_lines + 1
+      hist_y = @bar_size
+
+      Ncurses.werase(@win)
+
+      # Box the widget if asked.
+      if box
+        Draw.drawObjBox(@win, self)
+      end
+
+      # Do we have a shadow to draw?
+      if !(@shadow.nil?)
+        Draw.drawShadow(@shadow_win)
+      end
+
+      self.drawTitle(@win)
+
+      # If the user asked for labels, draw them in.
+      if @view_type != :NONE
+        # Draw in the low label.
+        if @low_string.size > 0
+          Draw.writeCharAttrib(@win, @lowx, @lowy, @low_string,
+              @stats_attr, @orient, 0, @low_string.size)
+        end
+
+        # Draw in the current value label.
+        if @cur_string.size > 0
+          Draw.writeCharAttrib(@win, @curx, @cury, @cur_string,
+              @stats_attr, @orient, 0, @cur_string.size)
+        end
+
+        # Draw in the high label.
+        if @high_string.size > 0
+          Draw.writeCharAttrib(@win, @highx, @highy, @high_string,
+              @stats_attr, @orient, 0, @high_string.size)
+        end
+      end
+
+      if @orient == RNDK::VERTICAL
+        hist_x = @box_height - @bar_size - 1
+        hist_y = @field_width
+      end
+
+      # Draw the histogram bar.
+      (hist_x...@box_height - 1).to_a.each do |x|
+        (1..hist_y).each do |y|
+          battr = Ncurses.mvwinch(@win, x, y)
+
+          if battr == ' '.ord
+            Ncurses.mvwaddch(@win, x, y, @filler)
+          else
+            Ncurses.mvwaddch(@win, x, y, battr | fattr)
+          end
+        end
+      end
+
+      # Refresh the window
+      Ncurses.wrefresh @win
+    end
+
+    # Destroy the widget.
+    def destroy
+      self.cleanTitle
+
+      # Clean up the windows.
+      RNDK.deleteCursesWindow(@shadow_win)
+      RNDK.deleteCursesWindow(@win)
+
+      # Clean the key bindings.
+      self.cleanBindings(:HISTOGRAM)
+
+      # Unregister this object.
+      RNDK::Screen.unregister(:HISTOGRAM, self)
+    end
+
+    # Erase the widget from the screen.
+    def erase
+      if self.validRNDKObject
+        RNDK.eraseCursesWindow(@win)
+        RNDK.eraseCursesWindow(@shadow_win)
+      end
+    end
+
+    def object_type
+      :HISTOGRAM
+    end
+  end
+end

data/lib/rndk/itemlist.rb

@@ -0,0 +1,474 @@
+require 'rndk'
+
+module RNDK
+  class ITEMLIST < RNDK::Widget
+    def initialize(rndkscreen, xplace, yplace, title, label, item, count,
+        default_item, box, shadow)
+      super()
+      parent_width = Ncurses.getmaxx(rndkscreen.window)
+      parent_height = Ncurses.getmaxy(rndkscreen.window)
+      field_width = 0
+
+      if !self.createList(item, count)
+        self.destroy
+        return nil
+      end
+
+      self.setBox(box)
+      box_height = (@border_size * 2) + 1
+
+      # Set some basic values of the item list
+      @label = ''
+      @label_len = 0
+      @label_win = nil
+
+      # Translate the label string to a chtype array
+      if !(label.nil?) && label.size > 0
+        label_len = []
+        @label = RNDK.char2Chtype(label, label_len, [])
+        @label_len = label_len[0]
+      end
+
+      # Set the box width. Allow an extra char in field width for cursor
+      field_width = self.maximumFieldWidth + 1
+      box_width = field_width + @label_len + 2 * @border_size
+      box_width = self.setTitle(title, box_width)
+      box_height += @title_lines
+
+      # Make sure we didn't extend beyond the dimensions of the window
+      @box_width = [box_width, parent_width].min
+      @box_height = [box_height, parent_height].min
+      self.updateFieldWidth
+
+      # Rejustify the x and y positions if we need to.
+      xtmp = [xplace]
+      ytmp = [yplace]
+      RNDK.alignxy(rndkscreen.window, xtmp, ytmp, box_width, box_height)
+      xpos = xtmp[0]
+      ypos = ytmp[0]
+
+      # Make the window.
+      @win = Ncurses.newwin(box_height, box_width, ypos, xpos)
+      if @win.nil?
+        self.destroy
+        return nil
+      end
+
+      # Make the label window if there was a label.
+      if @label.size > 0
+        @label_win = Ncurses.subwin(@win, 1, @label_len,
+            ypos + @border_size + @title_lines,
+            xpos + @border_size)
+
+        if @label_win.nil?
+          self.destroy
+          return nil
+        end
+      end
+
+      Ncurses.keypad(@win, true)
+
+      # Make the field window.
+      if !self.createFieldWin(
+          ypos + @border_size + @title_lines,
+          xpos + @label_len + @border_size)
+        self.destroy
+        return nil
+      end
+
+      # Set up the rest of the structure
+      @screen = rndkscreen
+      @parent = rndkscreen.window
+      @shadow_win = nil
+      @accepts_focus = true
+      @shadow = shadow
+
+      # Set the default item.
+      if default_item >= 0 && default_item < @list_size
+        @current_item = default_item
+        @default_item = default_item
+      else
+        @current_item = 0
+        @default_item = 0
+      end
+
+      # Do we want a shadow?
+      if shadow
+        @shadow_win = Ncurses.newwin(box_height, box_width,
+            ypos + 1, xpos + 1)
+        if @shadow_win.nil?
+          self.destroy
+          return nil
+        end
+      end
+
+      # Register this baby.
+      rndkscreen.register(:ITEMLIST, self)
+    end
+
+    # This allows the user to play with the widget.
+    def activate(actions)
+      ret = -1
+
+      # Draw the widget.
+      self.draw(@box)
+      self.drawField(true)
+
+      if actions.nil? || actions.size == 0
+        input = 0
+
+        while true
+          input = self.getch([])
+
+          # Inject the character into the widget.
+          ret = self.inject(input)
+          if @exit_type != :EARLY_EXIT
+            return ret
+          end
+        end
+      else
+        # Inject each character one at a time.
+        actions.each do |action|
+          ret = self.inject(action)
+          if @exit_type != :EARLY_EXIT
+            return ret
+          end
+        end
+      end
+
+      # Set the exit type and exit.
+      self.setExitType(0)
+      return ret
+    end
+
+    # This injects a single character into the widget.
+    def inject(input)
+      pp_return = 1
+      ret = -1
+      complete = false
+
+      # Set the exit type.
+      self.setExitType(0)
+
+      # Draw the widget field
+      self.drawField(true)
+
+      # Check if there is a pre-process function to be called.
+      unless @pre_process_func.nil?
+        pp_return = @pre_process_func.call(:ITEMLIST, self,
+            @pre_process_data, input)
+      end
+
+      # Should we continue?
+      if pp_return != 0
+        # Check a predefined binding.
+        if self.checkBind(:ITEMLIST, input)
+          complete = true
+        else
+          case input
+          when Ncurses::KEY_UP, Ncurses::KEY_RIGHT, ' '.ord, '+'.ord, 'n'.ord
+            if @current_item < @list_size - 1
+              @current_item += 1
+            else
+              @current_item = 0
+            end
+          when Ncurses::KEY_DOWN, Ncurses::KEY_LEFT, '-'.ord, 'p'.ord
+            if @current_item > 0
+              @current_item -= 1
+            else
+              @current_item = @list_size - 1
+            end
+          when 'd'.ord, 'D'.ord
+            @current_item = @default_item
+          when '0'.ord
+            @current_item = 0
+          when '$'.ord
+            @current_item = @list_size - 1
+          when RNDK::KEY_ESC
+            self.setExitType(input)
+            complete = true
+          when Ncurses::ERR
+            self.setExitType(input)
+            complete = true
+          when RNDK::KEY_TAB, RNDK::KEY_RETURN, Ncurses::KEY_ENTER
+            self.setExitType(input)
+            ret = @current_item
+            complete = true
+          when RNDK::REFRESH
+            @screen.erase
+            @screen.refresh
+          else
+            RNDK.beep
+          end
+        end
+
+        # Should we call a post-process?
+        if !complete && !(@post_process_func.nil?)
+          @post_process_func.call(:ITEMLIST, self, @post_process_data, input)
+        end
+      end
+
+      if !complete
+        self.drawField(true)
+        self.setExitType(0)
+      end
+
+      @result_data = ret
+      return ret
+    end
+
+    # This moves the itemlist field to the given location.
+    def move(xplace, yplace, relative, refresh_flag)
+      windows = [@win, @field_win, @label_win, @shadow_win]
+      self.move_specific(xplace, yplace, relative, refresh_flag,
+          windows, [])
+    end
+
+    # This draws the widget on the screen.
+    def draw(box)
+      # Did we ask for a shadow?
+      unless @shadow_win.nil?
+        Draw.drawShadow(@shadow_win)
+      end
+
+      self.drawTitle(@win)
+
+      # Draw in the label to the widget.
+      unless @label_win.nil?
+        Draw.writeChtype(@label_win, 0, 0, @label, RNDK::HORIZONTAL,
+            0, @label.size)
+      end
+
+      # Box the widget if asked.
+      if box
+        Draw.drawObjBox(@win, self)
+      end
+
+      Ncurses.wrefresh @win
+
+      # Draw in the field.
+      self.drawField(false)
+    end
+
+    # This sets the background attribute of the widget
+    def setBKattr(attrib)
+      Ncurses.wbkgd(@win, attrib)
+      Ncurses.wbkgd(@field_win, attrib)
+      Ncurses.wbkgd(@label_win, attrib) unless @label_win.nil?
+    end
+
+    # This function draws the contents of the field.
+    def drawField(highlight)
+      # Declare local vars.
+      current_item = @current_item
+
+      # Determine how much we have to draw.
+      len = [@item_len[current_item], @field_width].min
+
+      # Erase the field window.
+      Ncurses.werase(@field_win)
+
+      # Draw in the current item in the field.
+      (0...len).each do |x|
+        c = @item[current_item][x]
+
+        if highlight
+          c = c.ord | Ncurses::A_REVERSE
+        end
+
+        Ncurses.mvwaddch(@field_win, 0, x + @item_pos[current_item], c)
+      end
+
+      # Redraw the field window.
+      Ncurses.wrefresh(@field_win)
+    end
+
+    # This function removes the widget from the screen.
+    def erase
+      if self.validRNDKObject
+        RNDK.eraseCursesWindow(@field_win)
+        RNDK.eraseCursesWindow(@label_win)
+        RNDK.eraseCursesWindow(@win)
+        RNDK.eraseCursesWindow(@shadow_win)
+      end
+    end
+
+    def destroyInfo
+      @list_size = 0
+      @item = ''
+    end
+
+    # This function destroys the widget and all the memory it used.
+    def destroy
+      self.cleanTitle
+      self.destroyInfo
+
+      # Delete the windows
+      RNDK.deleteCursesWindow(@field_win)
+      RNDK.deleteCursesWindow(@label_win)
+      RNDK.deleteCursesWindow(@shadow_win)
+      RNDK.deleteCursesWindow(@win)
+
+      # Clean the key bindings.
+      self.cleanBindings(:ITEMLIST)
+
+      RNDK::Screen.unregister(:ITEMLIST, self)
+    end
+
+    # This sets multiple attributes of the widget.
+    def set(list, count, current, box)
+      self.setValues(list, count, current)
+      self.setBox(box)
+    end
+
+    # This function sets the contents of the list
+    def setValues(item, count, default_item)
+      if self.createList(item, count)
+        old_width = @field_width
+
+        # Set the default item.
+        if default_item >= 0 && default_item < @list_size
+          @current_item = default_item
+          @default_item = default_item
+        end
+
+        # This will not resize the outer windows but can still make a usable
+        # field width if the title made the outer window wide enough
+        self.updateFieldWidth
+        if @field_width > old_width
+          self.createFieldWin(@field_win.getbegy, @field_win.getbegx)
+        end
+
+        # Draw the field.
+        self.erase
+        self.draw(@box)
+      end
+    end
+
+    def getValues(size)
+      size << @list_size
+      return @item
+    end
+
+    # This sets the default/current item of the itemlist
+    def setCurrentItem(current_item)
+      # Set the default item.
+      if current_item >= 0 && current_item < @list_size
+        @current_item = current_item
+      end
+    end
+
+    def getCurrentItem
+      return @current_item
+    end
+
+    # This sets the default item in the list.
+    def setDefaultItem(default_item)
+      # Make sure the item is in the correct range.
+      if default_item < 0
+        @default_item = 0
+      elsif default_item >= @list_size
+        @default_item = @list_size - 1
+      else
+        @default_item = default_item
+      end
+    end
+
+    def getDefaultItem
+      return @default_item
+    end
+
+    def focus
+      self.drawField(true)
+    end
+
+    def unfocus
+      self.drawField(false)
+    end
+
+    def createList(item, count)
+      status = false
+      new_items = []
+      new_pos = []
+      new_len = []
+      if count >= 0
+        field_width = 0
+
+        # Go through the list and determine the widest item.
+        status = true
+        (0...count).each do |x|
+          # Copy the item to the list.
+          lentmp = []
+          postmp = []
+          new_items << RNDK.char2Chtype(item[x], lentmp, postmp)
+          new_len << lentmp[0]
+          new_pos << postmp[0]
+          if new_items[0] == 0
+            status = false
+            break
+          end
+          field_width = [field_width, new_len[x]].max
+        end
+
+        # Now we need to justify the strings.
+        (0...count).each do |x|
+          new_pos[x] = RNDK.justifyString(field_width + 1,
+              new_len[x], new_pos[x])
+        end
+
+        if status
+          self.destroyInfo
+
+          # Copy in the new information
+          @list_size = count
+          @item = new_items
+          @item_pos = new_pos
+          @item_len = new_len
+        end
+      else
+        self.destroyInfo
+        status = true
+      end
+
+      return status
+    end
+
+    # Go through the list and determine the widest item.
+    def maximumFieldWidth
+      max_width = -2**30
+
+      (0...@list_size).each do |x|
+        max_width = [max_width, @item_len[x]].max
+      end
+      max_width = [max_width, 0].max
+
+      return max_width
+    end
+
+    def updateFieldWidth
+      want = self.maximumFieldWidth + 1
+      have = @box_width - @label_len - 2 * @border_size
+      @field_width = [want, have].min
+    end
+
+    # Make the field window.
+    def createFieldWin(ypos, xpos)
+      @field_win = Ncurses.subwin(@win, 1, @field_width, ypos, xpos)
+
+      unless @field_win.nil?
+        Ncurses.keypad(@field_win, true)
+        @input_window = @field_win
+        return true
+      end
+      return false
+    end
+
+    def position
+      super(@win)
+    end
+
+    def object_type
+      :ITEMLIST
+    end
+  end
+end