pfa 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f913dd85d082580d078e4ad450e301a5319dcc40bd3fdefd7f91d5bac0e3de2
-  data.tar.gz: 14fcd1184d5f3d27abdd806bdbd21dddc73208096fc12224823f7f3bbabfa16c
+  metadata.gz: 954bf4b6d68f905c832b829cb2b60576862cfca4181625120cbf9a05714c1af4
+  data.tar.gz: 3e39efe3488f45edd9641a7cb6f6c34d874b5e2e1082772e2b4dca93b71c82a9
 SHA512:
-  metadata.gz: 5dfb3c9ec216dfb1c3e9c5b079de3335fb5129ddb8d5a8dcefd72aafdbf8f92df3ae301328dde4bbe2e51c3def13b91629e673af3c50c24d60873b827d9a3c6c
-  data.tar.gz: 174732fa70895295f02f92205abfec880462a4bbaf78c0e5b78c3145284ece140c8df977974f23e301dab74ab624ab9fc0851c8f537d5af1769bd538bd895b08
+  metadata.gz: edaacba4bb1310875003dcb54a4b8cccd784e0ce1f4396d938dd5f4799aa8a3b746577592b59bd3fd012f55991c5e903779b93e3a180105711c743fab9d27c9e
+  data.tar.gz: e52c5b8b332751da42088cf79a11926338f812fbc7e44b2109bbf9acb1cb0c453217aff22d9b27182c4ab7a8f81c827553eaaa14028c64504701d407719ef1e1

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change log
 
+## 1.1.0
+
+* Écriture de la table du paradigme de Field Augmenté, de travers.
+
 ## 1.0.3
 
 * Isolation du LIB_FOLDER

data/lib/assets/fr/PFA_ABSOLUTE_DATA.yaml

@@ -87,7 +87,7 @@ nodes:
     hname:        'DÉV. PART I'
     abs_start:    1/4
     abs_duration: 1/4
-    items: ['premiere_action', 'premier_tiers', 'cle_de_voute']
+    items: ['action_1_part1', 'premier_tiers', 'cle_de_voute']
   action_1_part1:
     printed:      false
     drawn:        false # pas sur le PFA
@@ -128,7 +128,7 @@ nodes:
     hname:        'DÉV. PART II'
     abs_start:    1/2
     abs_duration: 1/4
-    items:        ['premiere_action_dev2', 'deuxieme_tiers', 'crise', 'pivot2']
+    items:        ['action_1_part2', 'second_tiers', 'crise', 'pivot2']
   action_1_part2:
     printed:      false
     drawn:        false # pas sur le PFA
@@ -139,7 +139,7 @@ nodes:
     description:  "Pendant de la première action du développement, après la clé de voûte."
     abs_start:    1/2 + 1/48 # p.e. 60 + 2,5 mn = 62,5 mn
     abs_duration: null
-  deuxieme_tiers:
+  second_tiers:
     printed:      true
     drawn:        true # sur le PFA
     required:     false
@@ -179,7 +179,7 @@ nodes:
     hname:        'DÉNOUEMENT'
     abs_start:    3/4
     abs_duration: 1/4
-    items:        ['premiere_action_den', 'climax', 'desinence']
+    items:        ['action_1_denouement', 'climax', 'desinence']
   action_1_denouement:
     printed:      false
     drawn:        false # pas sur le PFA

data/lib/pfa/relative_pfa.rb

@@ -80,6 +80,18 @@ class RelativePFA
     end
   end
 
+  def node(node_key)
+    data[node_key]
+  end
+
+  # --- Predicate Methods ---
+
+  # @return true si le paradigme définit le noeud de clé +node_key+
+  # 
+  def node?(node_key)
+    data.key?(node_key.to_sym)
+  end
+
   # Test la pertinence de la définition de la clé +key+ et produit une
   # erreur éclairante en cas de problème.
   #

data/lib/pfa/relative_pfa_datatime.rb

@@ -7,14 +7,30 @@ class DataTime
 
   attr_reader :pfa, :key
 
+  # @oaram pfa [PFA::RelativePFA]
+  # 
+  # @param key [Symbol] La clé structurelle (:zero ou :end_time)
+  # 
+  # 
+  # @param value [String|Integer|Hash]
+  #   Dans valeur de cette donnée temps. Ça peut être soit un temps,
+  #   soit une table contenant le temps et la description.
+  # 
   def initialize(pfa, key, value = nil)
     @pfa        = pfa
     @key        = key
-    @raw_value  = value
+    @ini_value  = value
+    case value
+    when Hash
+      @horloge = value[:t]||value[:time]||value[:horloge]
+      @description = value[:d]||value[:description]
+    else
+      @horloge  = value
+    end
   end
 
   def time
-    @time ||= PFA::NTime.new(@raw_value, 0)
+    @time ||= PFA::NTime.new(@horloge, 0)
   end
   alias :start_at :time
 

data/lib/pfa/relative_pfa_node.rb

@@ -10,8 +10,6 @@ class Node
 
   attr_reader :pfa, :key
 
-  attr_reader :description
-
   def initialize(pfa, key, value = nil)
     @pfa        = pfa
     @key        = key
@@ -22,6 +20,12 @@ class Node
     pfa.img_builder.code_image_magick
   end
 
+  def description(ensure_output = false)
+    @description || begin
+      ensure_output ? "" : nil
+    end
+  end
+
   # --- MÉTHODES TEMPORELLES ---
 
   # -- Temps relatifs --

data/lib/pfa/table_builder.rb

@@ -0,0 +1,112 @@
+#
+# Module qui gère l'écriture du tableau du PFA, décrivant tous les
+# éléments du PFA (même ceux qui ne sont pas affichés dans le 
+# graphique)
+# 
+# Tous les éléments affichés sont les éléments printed: true dans les
+# données absolues du PFA
+# 
+module PFA
+
+class RelativePFA
+  def print_full_table_in_pdf(pdf, **options)
+    table_builder.build(pdf, **options)
+  end
+  def table_builder
+    @table_builder ||= TableBuilder.new(self)
+  end
+
+class TableBuilder < AnyBuilder
+
+  # Méthode principale qui reçoit un Prawn::View et écrit dedans la
+  # table du PFA en respectant les +options+
+  # 
+  # @param pdf [Prawn::View] 
+  # @param options [Hash]
+  #           :rotated Si true, on met la table de travers
+  #           :font [Hash] La police à utiliser, contenant :name et :size
+  # 
+  def build(pdf, **options)
+
+    # Penser à utiliser Prawn4book::PdfBook::NTable.safeize(str) pour
+    # escaper les mauvais caractères (sauf si inscription directe dans
+    # le livre)
+     
+    table_width   = pdf.bounds.height # car en travers
+    table_height  = pdf.bounds.width  # idem
+    quart_column  = table_width / 4
+    data_table = {
+      width:          table_width,
+      column_widths:  [quart_column, quart_column, quart_column, quart_column],
+      cell_style: {
+        border_width: [0,1,0,1],
+        inline_format: true,
+        padding: [2, 5],
+      }
+    }
+
+    # -- Description des noeuds --
+    nodes = {expo:nil, dev_part1: nil, dev_part2: nil, denoue: nil}
+    {
+      exposition:           :expo, 
+      developpement_part1:  :dev_part1, 
+      developpement_part2:  :dev_part2,
+      denouement:           :denoue
+    }.each do |key_part, key_nodes|
+      nodes[key_nodes] = AbsolutePFA.data[:nodes][key_part][:items].collect do |node_key|
+        node_key = node_key.to_sym
+        # -- Si le paradigme définit ce noeud, on l'ajoute --
+        if pfa.node?(node_key)
+          node = pfa.send(node_key)
+          "<b>#{node.mark}</b> : #{node.description}"
+        end
+      end.compact.join(' | ')
+    end
+
+    data_lines = [
+      # -- Entête de table --
+      ["EXPOSITION", "DÉV. PARTIE 1", "DÉV. PARTIE 2", "DÉNOUEMENT"],
+      # -- 2e ligne --
+      [
+        pfa.exposition&.description(true), 
+        pfa.developpement_part1&.description(true), 
+        pfa.developpement_part2&.description(true), 
+        pfa.denouement&.description(true)
+      ],
+      # -- 3e ligne --
+      [nodes[:expo], nodes[:dev_part1], nodes[:dev_part2], nodes[:denoue]]
+    ]
+
+    #
+    # Une fonte est-elle définie ?
+    # 
+    options.key?(:font) || options.merge!(font: {name:'Arial', size:8})
+    options[:font][:name] ||= 'Arial'
+    options[:font][:size] ||= 8
+
+    pdf.update do
+      font(options[:font][:name], **{size: options[:font][:size]})
+      if options[:rotated]
+        #
+        # Il faut écrire la table de travers
+        # 
+        rotate(90, :origin => [bounds.width,bounds.height/2]) do 
+          # text "La table complète du PFA"
+          table(data_lines, data_table) do |tb|
+            tb.row(0).style(borders:[:top, :left, :right], border_width:1, align: :center)
+            tb.row(-1).style(borders:[:bottom, :left, :right], border_width:1, padding_bottom: 5)
+          end
+        end
+      else
+        #
+        # Tableau à l'endroit sur la page
+        # 
+        # text "La table complète du PFA"
+        table(data_lines, data_table)
+      end
+    end #/pdf.update
+  end
+
+end #/class TableBuilder
+end #/class RelativePFA
+end #/module PFA

data/lib/pfa/version.rb

@@ -1,3 +1,3 @@
 module PFA
-  VERSION = "1.0.3"
+  VERSION = "1.1.0"
 end

data/lib/pfa.rb

@@ -19,3 +19,4 @@ require 'pfa/absolute_pfa'
 require 'pfa/relative_pfa_node'
 require 'pfa/relative_pfa_datatime'
 require 'pfa/img_builder'
+require 'pfa/table_builder'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pfa
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - PhilippePerret
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-09 00:00:00.000000000 Z
+date: 2023-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yaml
@@ -114,6 +114,7 @@ files:
 - lib/pfa/relative_pfa.rb
 - lib/pfa/relative_pfa_datatime.rb
 - lib/pfa/relative_pfa_node.rb
+- lib/pfa/table_builder.rb
 - lib/pfa/temporal_methods.rb
 - lib/pfa/version.rb
 - pfa.gemspec