pfa 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6ccdb2fab099b304836b687b9d582de1769019ab82ca15edfc05394fdd6e0d01
+  data.tar.gz: 1ada3fac532d0821fe5067347d7f6fc2015e3b515b629cc50acfebb2b9501d21
+SHA512:
+  metadata.gz: 7af5538084c56b345e4d317b0041814b1adc11829aed0475584422f21a5ea6624c5f2fcab3633e3d08871126aa83f9f7c1417a223d8b2d9b84b89f900a37c659
+  data.tar.gz: eeeae95913d4135f4fe1835c7b5792ce7f53c5780e900b599aa74d13ebb648817a40ffa0b29d5c3806d722c098be8149f1139c2df0e0863c34f899d7576de7ac

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.7.3
+before_install: gem install bundler -v 2.1.4

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Change log
+
+## 1.0.1
+
+* Première release propulsée
+
+## 1.0.0
+
+* Première version opérationnelle.

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in pfa.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "minitest", "~> 5.0"

data/Gemfile.lock

@@ -0,0 +1,46 @@
+PATH
+  remote: .
+  specs:
+    pfa (0.1.0)
+      clir
+      singleton
+      yaml
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    clir (0.22.1)
+      json
+      tty-prompt
+    json (2.6.3)
+    minitest (5.19.0)
+    minitest-color (0.0.2)
+      minitest (~> 5)
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    rake (12.3.3)
+    singleton (0.1.1)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.1)
+    wisper (2.0.1)
+    yaml (0.2.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  minitest (~> 5.0)
+  minitest-color
+  pfa!
+  rake (~> 12.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,156 @@
+# PFA
+
+PFA pour "Paradigme de Field Augmenté". Ce gem permet de le gérer de façon simple.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'pfa'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install pfa
+
+## Usage
+
+On commence toujours par instancier un nouveau paradigme.
+
+~~~ruby
+require 'pfa'
+
+pfa = PFA::new
+~~~
+
+> Ou on définit directement toutes les valeurs [cf. ci-dessous](#with-all-data)
+
+Ensuite, on le renseigne en lui ajoutant des nœuds :
+
+~~~ruby
+pfa.add :incident_declencheur, {t:"0+12+0", d:"Louis tue Harlan, le violeur de Selma"}
+pdf.add :pivot1, {t:"0,23,15", d:"Louise décide de fuir au Mexique."}
+# etc.
+~~~
+
+Il faut aussi définir le "zéro" absolu du film et son temps de fin.
+
+> Ce "zéro" permettra de rectifier tous les temps quelle que soit la vidéo utilisée. Par exemple, ce zéro peut être le timecode de la toute première image du film, ou le timecode de l'apparition du titre.
+> Tous les autres temps seront donnés normalement.
+
+~~~ruby
+
+pfa.zero = "0:00:25"
+pfa.end_time = "1:58:56"
+
+~~~
+
+<a name="with-all-data"></a>
+
+### Définition en fournissant toutes les données
+
+On peut aller très vite en définissant tout :
+
+~~~
+require 'pfa'
+
+data_paradigme = {
+  zero: 35,
+  end_time: 2*60+15,
+  incident_declencheur: {t:'0+10+25', d:"LUI rencontre ELLE pour la première fois."},
+  pivot1: {t:'0:25;56', d:"<description du premier pivot"},
+  developpement_part1: {t: 30*60, d:"<description de la première partie du développement>"}
+  # etc. avec toutes les données requises (cf. ci-dessous)
+  # ...
+}
+
+pfa = PFA.new(data_paradigme)
+pfa.to_img 
+# => produit l'image du paradigme
+
+# Ou
+pfa.to_img(**{as: :default})
+# => Produit l'image avec d'autres dimension
+
+~~~
+
+> Noter les différentes formes que peut prendre le temps : une horloge normale ("0:23:45"), une horloge avec des "+" (attention : ce n'est pas une addition, c'est juste un signe plus facile à écrire), une horloge avec des virgules ("0,3,15" — plus facile à écrire aussi), un nombre de secondes (3752), et même un temps `Time` (Time.at(152)).
+
+### Données minimales 
+
+Pour pouvoir être construit, un *PFA* doit définir au moins les nœuds suivants. Tous ces nœuds doivent être définis avec la méthode `pfa#add` et les deux arguments requis, la clé symbolique (p.e. `:pivot2`) et une table contenant la clé `t:` (timecode), la clé `d:` (description) et optionnellement la clé `:duree` (nombre de secondes).
+
+~~~bash
+:exposition 
+:incident_declencheur
+:pivot1
+:developpement_part1
+:developpement_part2
+:pivot2
+:denouement
+:climax
+~~~
+
+> Si un de ces nœuds n'est pas défini, ou que les propriétés `zero` et `end_time` ne sont pas définies, la construction produira une erreur.
+
+La liste complète des clés utilisables et définissables de la même manière est :
+
+~~~bash
+:exposition
+:preambule
+:incident_perturbateur
+:incident_declencheur
+:zone_de_refus
+:pivot1
+:developpement_part1
+:premiere_action
+:premier_tiers
+:cle_de_voute
+:developpement_part2
+:premiere_action_dev2
+:deuxieme_tiers
+:crise
+:pivot2
+:denouement
+:premier_action_denouement
+:climax
+:desinence
+~~~
+
+Une fois les nœuds du paradigme définis, on peut le construire…
+
+* sous forme d'image JPEG :
+  
+  ~~~ruby
+  pfa.to_img
+  ~~~
+
+  Par défaut, ce sera une image pour un livre (environ A5) d'analyse de film comme ceux produit par la collection « Leçons du cinéma ».
+
+* sous forme de fichier HTML (non encore implémenté) :
+
+  ~~~ruby
+  pfa.to_html
+  ~~~
+
+### Options de sortie
+
+Des options de sortie (premier argument de  `#to_img` ou `#to_html`) permettent d'affiner la sortie attendue.
+
+\[À développer]
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/PhilippePerret/pfa.
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "pfa"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/assets/Manuel/ImageMagick.md

@@ -0,0 +1,155 @@
+# PFA — Manuel pour ImageMagick
+
+Ce document permet de comprendre le code utilisé pour la production du Paradigme de Field Augmenté avec Image magick.
+
+
+
+## Description du code
+
+### Introduction
+
+~~~bash
+convert -size #{width}x#{height} \
+	xc:white \
+	-units PixelsPerInch -density 300 \
+	-background transparent \
+	-set colorspace sRGB
+
+# convert
+# 		=> Commande pour produire l’image
+# -size widthxheight
+#			=> Taille de l'image. 
+# 			 Pour un livre d'analyse, c’est 5976 px de large et 3882 px de hauteur
+# 			 ATTENTION de bien définir la taille avant le xc:, sinon
+# 			 le canevas ferait 1 px / 1 px
+# xc:white 
+# 		=> Définit le canevas. Sans cette indication, l'image ne peut pas être 
+#				 créée
+# -units UNITÉ
+# 		=> Permet de définir l'unité de la résolution [à confirmer]
+#			=> PixelsPerInch = Nombre de pixels par pouce
+# -density DENSITÉ
+#			=> Définit la résolution
+# 		=> 300 points par pouce (pixels par pouce ?)
+# -background COULEUR
+# 		=> Définit la nature de couleur du fond
+# 		=> transparent pour le fond de l'image
+# -set colorspace ESPACE_COULEUR
+# 		=> Pour définir l'espace de couleur
+# 		=> sRGB pour un espace RGB (RVB) avec transparence.
+~~~
+
+On dessine le premier **rectangle** pour l’**exposition du paradigme idéal**.
+
+~~~bash
+-stroke gray50 -fill white -strokewidth 3 -draw "rectangle 0,258 1494,1806" \
+
+# -stroke COULEUR
+#			=> Définission de la couleur du trait/de la police
+#			=> gray50 est un gris 50 %
+# -fill COULEUR
+#			=> Couleur de remplissage de la police
+#			=> white, elle sera blanche
+# -strokewidth TAILLE
+# 		(pas sûr que ce soit nécessaire ici)
+#			=> Largeur du trait ou de la police
+# 		=> 3 indique une grosseur de 3 pixels. On aura donc un trait
+# 			 avec des caractères délimités en noir (stroke) et du
+# 			 blanc à l'intérieur
+# -draw
+# 		=> Pour dessiner quelque chose dans l'image avec les paramètres
+# 			 qui viennent d'être définis. Note : on peut aussi dessiner du
+# 			 texte avec cette commande, comme on le verra.
+#			=> "rectangle 0,258 1494,1806" dessinera un rectangle depuis le
+# 			 point 0,258 (left,top) jusqu'au point 1494, 1806 (left, top)
+~~~
+
+On pourrait poursuivre en ajoutant les choses à dessiner de la même manière.
+
+~~~bash
+-draw "text 4,262 EXPOSITION" \
+-draw "rectangle 1494,258 2600,1806" \
+-draw "circle ..." \
+~~~
+
+Le problème, ci-dessus, se pose particulièrement pour les textes, si on veut les aligner aux boites et aux points (qui représentent des évènements du paradigme). Dans ce cas, il faut utiliser le mode composite :
+
+~~~bash
+\( ... définition ... \) -geometry +100-21 -gravity Center -composite
+
+# => \(...\) va définir l'élément à écrire, avec les mêmes paramètres que
+#  					 les autres éléments
+# 					 Penser à laisser des espaces à l'intérieur.
+# => -gravity GRAVITÉ
+# 	 Indique l'alignement de la boite par rappart à l'image totale
+#		 Center indique que la boite va être alignée au centre verticalement
+# 	        et horizontalement. On indique les autres valeurs par North, 
+# 					South, East et West. Par exemple NorthWest pour aligner en haut
+# 					à gauche.
+# => -geometry GEOMÉTRIE
+# 		Permet d'ajuster la position de la boite de façon précise par rapport
+# 		à la gravité choisie. 
+# 		La valeur est un signe et un nombre pour la valeur horizontale et la
+#     même chose par rapport à la valeur verticale. Ici, par exemple, on 
+# 		ajoutera 100 points horizontalement et on en enlèvera 21 verticalement.
+# 		ATTENTION : ces ajouts ne fonctionnement pas de la même manière suivant
+# 		la gravité. Par exemple, si la gravité est au sud (South) une valeur 
+# 		positive fera REMONTER la boite tandis que si la gravité est au nord
+# 		(North) une valeur positive fera DESCENDRE la boite
+~~~
+
+On peut trouver entre les `\(...\)` toutes les propriétés qui vont définir l’aspect (`stroke`, `background` etc.).
+
+On prend soin de mettre le label au bout de la définition, pour qu’il profite bien des définitions.
+
+Les définitions à particulière comprendre sont :
+
+~~~bash
+\( -size <WxH> -extent <WxH>... label:"Mon label" \) -composite \
+
+# => -size DIMENSION
+#		 	Permet de définir la taille du label. Plus la taille sera grande
+# 		et plus le label sera affiché gros.
+# 		ATTENTION : ça n'est pas la taille de la boite contenant.
+# => -extent DIMENSION
+# 		Permet de définir la taille véritable de la boite
+# => label:"STRING"
+# 			Définit le label. Noter qu'il n'y a pas de tiret avant cette
+# 			propriété.
+~~~
+
+On peut trouver les autres propriétés, dans cette boite :
+
+~~~bash
+\( -extent 1000x1000 -gravity SouthEast label:"Label en bas à droite" \) \
+	-geometry +100+100
+	-gravity Center \
+	-composite \
+
+# => -gravity (entre les parenthèses)
+#				Définit l'alignement, mais dans la boite de 1000x1000.
+# 			Alors que la boite elle-même sera située au centre de l'image,
+# 			décalée de 100 points vers le bas et vers la gauche.
+~~~
+
+
+
+On va écrire le label « Exposition ».
+
+~~~bash
+\( -background transparent -stroke gray75 -strokewidth 3 -pointsize 36.0 -size 1494x200 \
+  -trim -extent 1494x200 -gravity Center label:"EXPOSITION" \) -gravity NorthWest \
+  -geometry +0+420 -composite
+
+~~~
+
+
+
+On ajoute le **rectangle** pour la **première partie de développement idéal**.
+
+~~~bash
+
+
+
+~~~
+

data/lib/assets/Manuel/Manuel-developer.md

@@ -0,0 +1,50 @@
+# PFA — Manuel du développeur
+
+## Difficulté des temps
+
+> Note : pour simplifier, on ne ramène plus les temps à 120 minutes comme c'était le cas avant. On ne tient compte que de la durée réelle du film.
+
+La difficulté des temps pour les nœuds tient au fait que :
+
+* Le nœud possède un temps absolu (défini par le paradigme absolu). Ce temps correspond à la position idéale du nœud dans le paradigme.
+* Le nœud possède un temps relatif (défini par rapport au film). Ce temps correspond à la position relative (au zéro) du nœud dans le film analysé. Il correspond à l'horloge réelle qui est affichée à l'écran, qu'on appelle "timecode".
+* Le nœud possède un *temps relatif exact*. Ce temps correspond à la position réelle du nœud dans le film analysé, *en faisant abstraction du zéro*.
+
+Exemple : 
+
+La clé de voûte se trouve dans l'absolu presque au milieu du film. Elle se trouve à `60 - 2` en temps rapporté à 120 minutes.
+
+Imaginons un film qui commence réellement au temps `0:00:23`, qui possède une durée de `90 minutes` et qui possède une clé de voûte à `0:40:00` (à l'écran).
+
+Dans ce cas, la position exacte de la clé de voûte sera :
+
+~~~bash
+   0:40:00
+-  0:00:23
+= 0:39:37
+~~~
+
+Plusieurs méthode pratiques permettent de gérer ces temps :
+
+~~~ruby
+Soit cdv, l'instance \PFA::RelativePFA::Node de la clé de voûte.
+
+cdv.start_at
+# => \PFA::NTime du temps du nœud tel qu'il a été instancié avec l'horloge du film.
+
+cdv.start_at.exact
+# => \PFA::NTime du temps exact du nœud, en tenant compte du zéro
+
+cdv.start_at.exact.to_horloge
+# => \String L'horloge exacte, comme si le film commençait à 0:00:00.
+
+cdv.start_at.to_horloge
+# => \String L'horloge à l'écran, avec un début de film qui n'est pas à 0:00:00.
+
+cdv.start_at.on_120
+# => \Float la minute sur laquelle sera la clé de voûte si le film faisait 120 minutes
+# Noter que cette valeur tient forcément compte de la position du zéro, et prend 
+# donc la valeur de la position exacte du nœud.
+
+
+~~~