glimmer-libui-cc-graphs_and_charts 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c79188349650bf2223b5885ceaff00675197d6f833af8bffbfc15f1dbaaa2a5
-  data.tar.gz: a9d9f4732bdf4b81e20721cdfda4ffab550e6bd82785884db0ccf8f2f43a6d99
+  metadata.gz: dce47797358894afe69a91ad5a1187b2f989e75674cab2d421ce5e071df844bb
+  data.tar.gz: 25204f836b424b69d4c6209afc6365c31a3b400cb388cbe8bdf482a9023126f6
 SHA512:
-  metadata.gz: b5db2acfba0997e784840523b3e09154daea02fc78f1eb3726a3fbb50b876fc86aa483eea4f4af44c4eda804087d9c651d9081b81faa362b3fca252c76a8cb97
-  data.tar.gz: f6eba9bdc99d3bd30a17e53cbc81345bddb67c2573a6e51f26af546d56eb5d740e066a582cbaacec31e9f1ef00432f620f50dde58b9c6b83e9994ecf41e9fdcb
+  metadata.gz: 352e7f457e6b6c3d3889b58246bba79ea65597dc210a02b1ab472c0f26dddb6776324abcced746f7b7f8f685d3f81732779041bc395a95c6a1a2a51be5cd2857
+  data.tar.gz: 9f4080bf60e38a8f5914769717f492d32638b309504486ca7caed6e2263bdb222903693027206fbf9b7ad97f4e9f69b1d1aa9fbb1be2813f69151e99323b1067

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+## 0.1.1
+
+- Ensure that `line_graph` max `y_value` is taken into account in visible points only (excluding points outside the visible area)
+- Support ability to load entire `'glimmer-libui-cc-graphs_and_charts'` library instead of individual graphs/charts if preferred
+- New `examples/graphs_and_charts/basic_line_graph.rb`
+
+## 0.1.0
+
+- Initial implementation of `line_graph` custom control

data/README.md

@@ -1,6 +1,6 @@
-# Graphs and Charts 0.1.0
+# Graphs and Charts 0.1.1
 ## [Glimmer DSL for LibUI](https://github.com/AndyObtiva/glimmer-dsl-libui) Custom Controls
-[![Gem Version](https://badge.fury.io/rb/glimmer-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
+[![Gem Version](https://badge.fury.io/rb/glimmer-libui-cc-graphs_and_charts.svg)](http://badge.fury.io/rb/glimmer-libui-cc-graphs_and_charts)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 Graphs and Charts (Custom Controls) for [Glimmer DSL for LibUI](https://github.com/AndyObtiva/glimmer-dsl-libui)
@@ -12,7 +12,7 @@ Graphs and Charts (Custom Controls) for [Glimmer DSL for LibUI](https://github.c
 Add this line to Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-libui-cc-graphs_and_charts', '~> 0.1.0'
+gem 'glimmer-libui-cc-graphs_and_charts', '~> 0.1.1'
 ```
 
 Run:
@@ -23,43 +23,103 @@ bundle
 
 ## Usage
 
+It is preferred that you only load the graphs/charts that you need to use as per the instructions in the sub-sections below to conserve memory and startup time.
+
+However, if you prefer to load all graphs and charts, add this line to your Ruby file:
+
+```ruby
+require 'glimmer-libui-cc-graphs_and_charts'
+```
+
 ### Line Graph
 
-Add this line to your Ruby file:
+To load the `line_graph` custom control, add this line to your Ruby file:
 
 ```ruby
 require 'glimmer/view/line_graph'
 ```
 
-Example Glimmer GUI DSL code that can be nested under `window` or some container like `vertical_box`:
+This makes the `line_graph` [Glimmer DSL for LibUI Custom Control](https://github.com/AndyObtiva/glimmer-dsl-libui#custom-components) available in the Glimmer GUI DSL.
+You can then nest `line_graph` under `window` or some container like `vertical_box`. By the way, `line_graph` is implemented on top of the [`area` Glimmer DSL for LibUI control](https://github.com/AndyObtiva/glimmer-dsl-libui#area-api).
 
 ```ruby
 line_graph(
   width: 900,
   height: 300,
+  graph_point_distance: :width_divided_by_point_count,
   lines: [
     {
-      name: 'Failed',
+      name: 'Feature A',
       stroke: [163, 40, 39, thickness: 2],
       x_value_start: Time.now,
-      x_interval_in_seconds: 2,
+      x_interval_in_seconds: 8,
       x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
-      y_values: [36, 0, 60, 0, 0, 16, 0, 36, 0, 0]
+      y_values: [80, 36, 10, 60, 20, 110, 16, 5, 36, 1, 77, 15, 3, 34, 8, 63, 12, 17, 90, 28, 70]
     },
     {
-      name: 'Processed',
+      name: 'Feature B',
       stroke: [47, 109, 104, thickness: 2],
       x_value_start: Time.now,
-      x_interval_in_seconds: 2,
+      x_interval_in_seconds: 8,
       x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
-      y_values: [62, 0, 90, 0, 0, 27, 0, 56, 0, 0]
+      y_values: [62, 0, 90, 0, 0, 27, 0, 56, 0, 0, 24, 0, 60, 0, 30, 0, 47, 0, 38, 90, 0]
     },
   ],
   display_attributes_on_hover: true,
 )
 ```
 
-![line graph](/screenshots/glimmer-libui-cc-graphs_and_charts-mac-line-graph.png)
+![basic line graph](/screenshots/glimmer-libui-cc-graphs_and_charts-mac-line-graph.png)
+
+Basic Line Graph Example:
+
+[examples/graphs_and_charts/basic_line_graph.rb](/examples/graphs_and_charts/basic_line_graph.rb)
+
+```ruby
+require 'glimmer-dsl-libui'
+require 'glimmer/view/line_graph'
+
+class BasicLineGraph
+  include Glimmer::LibUI::Application
+  
+  before_body do
+    @start_time = Time.now
+  end
+  
+  body {
+    window('Basic Line Graph', 900, 330) {
+      line_graph(
+        width: 900,
+        height: 300,
+        graph_point_distance: :width_divided_by_point_count,
+        lines: [
+          {
+            name: 'Feature A',
+            stroke: [163, 40, 39, thickness: 2],
+            x_value_start: @start_time,
+            x_interval_in_seconds: 8,
+            x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
+            y_values: [80, 36, 10, 60, 20, 110, 16, 5, 36, 1, 77, 15, 3, 34, 8, 63, 12, 17, 90, 28, 70]
+          },
+          {
+            name: 'Feature B',
+            stroke: [47, 109, 104, thickness: 2],
+            x_value_start: @start_time,
+            x_interval_in_seconds: 8,
+            x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
+            y_values: [62, 0, 90, 0, 0, 27, 0, 56, 0, 0, 24, 0, 60, 0, 30, 0, 47, 0, 38, 90, 0]
+          },
+        ],
+        display_attributes_on_hover: true,
+      )
+    }
+  }
+end
+
+BasicLineGraph.launch
+```
+
+![basic line graph](/screenshots/glimmer-libui-cc-graphs_and_charts-mac-line-graph.png)
 
 Contributing to glimmer-libui-cc-graphs_and_charts
 ------------------------------------------

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/examples/graphs_and_charts/basic_line_graph.rb

@@ -0,0 +1,44 @@
+# This line is only needed when running the example from inside the project directory
+$LOAD_PATH.prepend(File.expand_path(File.join(__dir__, '..', '..', 'lib'))) if File.exist?(File.join(__dir__, '..', '..', 'lib'))
+
+require 'glimmer-dsl-libui'
+require 'glimmer/view/line_graph'
+
+class BasicLineGraph
+  include Glimmer::LibUI::Application
+  
+  before_body do
+    @start_time = Time.now
+  end
+  
+  body {
+    window('Basic Line Graph', 900, 330) {
+      line_graph(
+        width: 900,
+        height: 300,
+        graph_point_distance: :width_divided_by_point_count,
+        lines: [
+          {
+            name: 'Feature A',
+            stroke: [163, 40, 39, thickness: 2],
+            x_value_start: @start_time,
+            x_interval_in_seconds: 8,
+            x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
+            y_values: [80, 36, 10, 60, 20, 110, 16, 5, 36, 1, 77, 15, 3, 34, 8, 63, 12, 17, 90, 28, 70]
+          },
+          {
+            name: 'Feature B',
+            stroke: [47, 109, 104, thickness: 2],
+            x_value_start: @start_time,
+            x_interval_in_seconds: 8,
+            x_value_format: -> (time) {time.strftime("%a %d %b %Y %T GMT")},
+            y_values: [62, 0, 90, 0, 0, 27, 0, 56, 0, 0, 24, 0, 60, 0, 30, 0, 47, 0, 38, 90, 0]
+          },
+        ],
+        display_attributes_on_hover: true,
+      )
+    }
+  }
+end
+
+BasicLineGraph.launch

data/glimmer-libui-cc-graphs_and_charts.gemspec

@@ -0,0 +1,44 @@
+# Generated by juwelier
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: glimmer-libui-cc-graphs_and_charts 0.1.1 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "glimmer-libui-cc-graphs_and_charts".freeze
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Andy Maleh".freeze]
+  s.date = "2023-12-16"
+  s.description = "Graphs and Charts (Custom Controls) for Glimmer DSL for LibUI, like Line Graph.".freeze
+  s.email = "andy.am@gmail.com".freeze
+  s.extra_rdoc_files = [
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "README.md",
+    "VERSION",
+    "examples/graphs_and_charts/basic_line_graph.rb",
+    "glimmer-libui-cc-graphs_and_charts.gemspec",
+    "lib/glimmer-libui-cc-graphs_and_charts.rb",
+    "lib/glimmer/view/line_graph.rb"
+  ]
+  s.homepage = "http://github.com/AndyObtiva/glimmer-libui-cc-graphs_and_charts".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "3.4.6".freeze
+  s.summary = "Graphs and Charts - Glimmer DSL for LibUI Custom Controls".freeze
+
+  s.specification_version = 4
+
+  s.add_runtime_dependency(%q<glimmer-dsl-libui>.freeze, ["~> 0.11"])
+  s.add_development_dependency(%q<rspec>.freeze, ["~> 3.5.0"])
+  s.add_development_dependency(%q<juwelier>.freeze, ["= 2.4.9"])
+  s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
+end
+

data/lib/glimmer/view/line_graph.rb

@@ -1,3 +1,5 @@
+require 'glimmer-dsl-libui'
+
 module Glimmer
   module View
     # General-Purpose Line Graph Custom Control
@@ -236,8 +238,9 @@ module Glimmer
       
       def y_value_max_for_all_lines
         if @y_value_max_for_all_lines.nil?
-          all_y_values = lines.map { |line| line[:y_values] }.reduce(:+)
-          @y_value_max_for_all_lines = all_y_values.max.to_f
+          line_visible_y_values = lines.map { |line| line[:y_values][0, max_visible_point_count(line)] }
+          all_visible_y_values = line_visible_y_values.reduce(:+)
+          @y_value_max_for_all_lines = all_visible_y_values.max.to_f
         end
         @y_value_max_for_all_lines
       end

data/lib/glimmer-libui-cc-graphs_and_charts.rb

@@ -1,4 +1,4 @@
 $LOAD_PATH.unshift(File.expand_path('..', __FILE__))
 
 require 'glimmer-dsl-libui'
-require 'glimmer/view/graphs_and_charts'
+require 'glimmer/view/line_graph'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-libui-cc-graphs_and_charts
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-15 00:00:00.000000000 Z
+date: 2023-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glimmer-dsl-libui
@@ -66,17 +66,22 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Graphs And Charts - Glimmer DSL for LibUI Custom Controls
+description: Graphs and Charts (Custom Controls) for Glimmer DSL for LibUI, like Line
+  Graph.
 email: andy.am@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - VERSION
+- examples/graphs_and_charts/basic_line_graph.rb
+- glimmer-libui-cc-graphs_and_charts.gemspec
 - lib/glimmer-libui-cc-graphs_and_charts.rb
 - lib/glimmer/view/line_graph.rb
 homepage: http://github.com/AndyObtiva/glimmer-libui-cc-graphs_and_charts
@@ -101,5 +106,5 @@ requirements: []
 rubygems_version: 3.4.6
 signing_key:
 specification_version: 4
-summary: Graphs And Charts - Glimmer DSL for LibUI Custom Controls
+summary: Graphs and Charts - Glimmer DSL for LibUI Custom Controls
 test_files: []