« Info::pcLogo:comment fabriquer un logo PCStreet » : différence entre les versions

De wiki_pcwiki2
Aller à la navigationAller à la recherche
Aucun résumé des modifications
Aucun résumé des modifications
 
Ligne 16 : Ligne 16 :


== Exemple de fonctionnement ==
== Exemple de fonctionnement ==
  #1: Créer un fichier .ini dans /root/.config/pcLogo (''ex: TLD.ini'')
  #1: Créer un fichier '''.ini''' dans '''/root/.config/pcLogo''' (''ex: TLD.ini'')
  puis:
  puis:
<pre>
<pre>

Dernière version du 16 novembre 2026 à 07:01

KEYWORDS: PCLOGO

Le 16/11/2026:

pcLogo

Version : 1.02

Date : 28/09/2026

Rôle : génère un logo aux formats PNG, JPEG et SVG (rendu Cairo/Pango) à partir d'une description textuelle dans un fichier .ini : fond, cadres à coins arrondis, textes positionnés (police, taille, couleur, position), bandes horizontales décoratives. Permet de reconstituer un logo existant sans dépendre de son fichier image d'origine.

Exemple de fonctionnement

#1: Créer un fichier .ini dans /root/.config/pcLogo (ex: TLD.ini)
puis:
strLogoName="pcWebTool@srv18"
fltExpand=1.5
cp -p ./pcLogo /home/local/bin
cp -vpfd pcLogo.*[svg,png,jpg] LOGOS
rm *svg *png *jpg
# ./pcLogo --brandname mjplantes --expand 5.0
# ./pcLogo --brandname pcLogo --expand 1.5
# ./pcLogo --brandname pcwiki@srv18 --expand ${fltExpand}
./pcLogo --brandname ${strLogoName} --expand ${fltExpand} 

if test $? -eq 0
	then
	mv logo.svg pcLogo.${strLogoName}.svg
	mv logo.png pcLogo.${strLogoName}.png
	mv logo.jpg pcLogo.${strLogoName}.jpg
	cp -vpfd pcLogo.${strLogoName}.* /root/LOGOS
	scp pcLogo.${strLogoName}.* srv18:/root/LOGOS

	set -x
	firefox pcLogo.${strLogoName}.svg
	scp -p *svg srv18:/tmp
	fi

Fonctionnement

pcLogo lit un fichier .ini décrivant le canevas :

  • [canvas] : largeur, hauteur, couleur de fond, nom de
 sortie (output — une extension éventuelle est ignorée :
 pcLogo écrit toujours les trois fichiers <output>.png
 (matriciel), <output>.jpg (matriciel, sans transparence)
 et <output>.svg (vectoriel)) ; jpeg_quality
 (optionnel, 0-100, défaut 90) règle la compression JPEG ;
  • [frame] : cadre extérieur et cadre intérieur (rectangles à
 coins arrondis, couleur et épaisseur de trait indépendantes) ;
  • [powered_by], [main], [address],
 [extra], [contact] : cinq zones de texte
 (Pango) dessinées dans cet ordre, chacune avec sa police, sa taille,
 sa couleur, sa transparence et sa position ; si x est
 omis ou négatif, le texte est centré horizontalement ;
 boldness (optionnel, défaut 0) épaissit le contour du
 texte au-delà du poids natif de la police ; scale_x
 (optionnel, défaut 1.0) comprime/étire le texte horizontalement ;
 tout texte qui déborderait malgré tout de la largeur du canevas est
 automatiquement réduit (taille et boldness dans le même
 rapport) pour y tenir, sans changer ses proportions — sauf une
 section en défilement (scroll_period), où le
 débordement est le principe même de l'effet et n'est donc jamais
 réduit ;
 pulse_amplitude/pulse_period (optionnels,
 voir « Pulsation » ci-dessous) animent la section en sortie SVG ;
  • [stripes] : bandes horizontales fines derrière ou devant
 [main] selon behind_main (0 = devant, comme
 sur le logo PC Street d'origine où les bandes traversent les lettres ;
 1 = derrière) — couleur, transparence, épaisseur, bornes, espacement.
 Le texte de [main] reste toujours contraint à 90% de la
 largeur de [stripes] (x2 - x1, marge de
 10% pour ne jamais coller aux bords), et non à celle, plus large, du
 canevas entier : quel que soit le texte saisi, il est automatiquement
 réduit si besoin pour rester encadré par les bandes, au lieu de
 simplement tenir dans le canevas. Il est également centré
 verticalement dans [stripes].y1..y2 (et non ancré à son
 y du .ini) : sa hauteur dépendant de l'auto-ajustement,
 seul un centrage dynamique le garde aligné sur la bande quelle que
 soit la taille résultante. De même, [extra] reste
 contraint à 90% de [frame].inner_w tant qu'il n'est pas
 en défilement (pas de scroll_period) : un texte statique
 trop long y est réduit plutôt que de déborder du cadre. Sans effet
 s'il défile, l'auto-ajustement étant alors ignoré (voir
 scroll_period ci-dessous).

Le rendu est produit dans cet ordre : fond, cadre extérieur, cadre intérieur, powered_by, puis main et les bandes (ordre selon [stripes].behind_main), puis address, extra, contact. La scène est dessinée trois fois (une fois par surface Cairo, PNG puis JPEG puis SVG), toutes trois nommées à partir de [canvas].output. Le JPEG partage la même surface ARGB32 que le PNG (Cairo n'a pas d'export JPEG natif) ; la conversion passe par gdk-pixbuf lors de l'écriture, sans canal alpha (fond toujours opaque).

Effets d'animation (SVG uniquement)

Toute section de texte (powered_by, main, address, extra, contact) peut porter un ou plusieurs effets d'animation en sortie SVG (sans effet sur le PNG, format matriciel qui ne peut pas contenir d'animation) :

  • Pulsation (pulse_amplitude > 0) : effet de
 respiration. pulse_amplitude : amplitude de l'échelle,
 ex. 0.08 pour une oscillation entre 100 % et 108 % ;
 pulse_period (optionnel, défaut 2.0) : durée d'un cycle,
 en secondes.
  • Défilement (scroll_period > 0) : texte qui défile
 horizontalement en boucle, de bord à bord (texte entièrement caché à
 droite au départ, entièrement caché à gauche à l'arrivée, quelle que
 soit sa longueur — voir le calcul d'amplitude ci-dessous).
 scroll_period : vitesse de lecture, exprimée comme
 le temps (en secondes) pour parcourir une largeur de canevas — pas
 une durée totale de cycle figée : la durée réelle du cycle s'adapte
 automatiquement à la longueur du texte (voir ci-dessous), pour une
 vitesse de lecture constante sans avoir à retoucher cette valeur à
 chaque changement de texte ; scroll_direction
 (optionnel, left [défaut, droite→gauche] ou
 right).
  • Fondu oscillant (fade_amplitude > 0) : opacité qui
 descend puis remonte en boucle. fade_amplitude :
 profondeur du creux (0 à 1), ex. 0.5 pour osciller entre
 100 % et 50 % d'opacité ; fade_period (optionnel, défaut
 2.0) : durée d'un cycle, en secondes.
  • Lueur pulsante (glow_radius > 0) : halo lumineux
 qui grossit puis disparaît en boucle. glow_radius :
 rayon maximal du halo, en pixels ; glow_color
 (optionnel, défaut : la couleur du texte de la section) ;
 glow_period (optionnel, défaut 2.0) : durée d'un cycle,
 en secondes.

Pulsation et défilement animent tous deux la propriété CSS transform : les combiner sur une même section n'est pas garanti (seule la dernière animation de la liste l'emporte visuellement selon le visualiseur). Fondu (opacity) et lueur (filter) portent sur des propriétés distinctes : ils se combinent proprement entre eux et avec pulsation/défilement, sans ce conflit.

Les bornes du défilement sont calculées en pixels (unités du repère SVG), pas en pourcentage : la position de repos centre déjà le texte sur le canevas (xRest = (canvasWidth - largeurTexte) / 2, une valeur très négative si le texte est bien plus large que le canevas). Le texte entre/sort au ras du cadre intérieur ([frame].inner_x/inner_w), pas du bord brut du canevas : son bord gauche atteint exactement x = inner_x + inner_w (juste caché derrière le cadre, à droite) à un bout du cycle, et son bord droit atteint exactement x = inner_x (juste caché derrière le cadre, à gauche) à l'autre bout — garantissant à la fois que le texte entier devient visible au cours de la boucle (quelle que soit sa longueur) et qu'il ne traverse pas visuellement la ligne du cadre à chaque passage (viser le bord du canevas, plus large que le cadre, faisait déborder le texte par-dessus la ligne du cadre lors de l'entrée/la sortie). Un pourcentage fixe du canevas (ancienne implémentation) ne suffisait pas non plus : pour un texte plus large que le canevas, la position de repos démarre déjà loin hors-champ, et une amplitude fixe ne ramenait alors jamais son tout début à l'écran.

La durée réelle du cycle CSS (animation-duration) est scroll_period × (inner_w + largeurTexte) / canvasWidth — c'est-à-dire scroll_period mis à l'échelle de la distance totale réellement parcourue, rapportée à une largeur de canevas. Sans cette mise à l'échelle, un texte deux fois plus long qu'un autre parcourrait une distance deux fois plus grande dans la même durée totale, donc défilerait deux fois plus vite — trop rapide pour être lu depuis son tout début.

Techniquement, Cairo ne fournit aucune API pour émettre du CSS ou grouper son tracé sous une balise SVG arbitraire (vérifié : même cairo_tag_begin reste sans effet sur son export SVG). pcLogo contourne cette limite : chaque section animée est rendue une seconde fois, isolément, dans un fichier SVG temporaire ; son contenu est extrait et réinjecté dans le SVG final au sein d'un <g id="fx-<section>">, puis un bloc <style> (un @keyframes par effet actif, combinés dans la propriété animation de #fx-<section>) est inséré après la balise <svg> ouvrante. Le fichier temporaire est supprimé aussitôt utilisé. Sans aucun de ces réglages sur aucune section, le SVG produit est strictement identique à un rendu sans cette fonctionnalité.

L'animation nécessite un visualiseur SVG qui applique CSS @keyframes (un navigateur, typiquement) ; les moteurs QtSvg (utilisés par exemple par qimgv) n'exécutent aucune animation CSS et affichent l'image statique, sans erreur.

Si le fichier .ini indiqué est introuvable, ou si une couleur est mal formée (longueur incorrecte ou caractères non hexadécimaux après un #), pcLogo affiche un message d'erreur explicite sur la sortie d'erreur et quitte avec le code 1.

Syntaxe

pcLogo [-e|--expand facteur] [-b|--brandname nom | fichier.ini]

pcLogo -h | --help

Build

Paquets Debian requis :

apt install cmake g++ libcairo2-dev libpango1.0-dev libgdk-pixbuf-2.0-dev

Compilation :

cd build
cmake ..
make

Le binaire est produit dans build/pcLogo et installé dans /home/local/bin via make install.

Options

fichier.ini (positionnel)

Chemin du fichier de description du logo. Défaut : ~/.config/pcLogo/pcLogo.ini (repli sur /root/.config/pcLogo/pcLogo.ini si la variable d'environnement HOME est absente).

Exemple : pcLogo /root/.config/pcLogo/pcLogo.ini

-e, --expand facteur

Multiplie les dimensions du rendu par ce facteur décimal positif (>1 agrandit, <1 réduit). Le contexte Cairo est mis à l'échelle avant tout tracé (cairo_scale) : le résultat reste net à toute taille, que la sortie soit PNG (nouvelle résolution de rasterisation) ou SVG (le fichier vectoriel reste de toute façon redimensionnable sans perte, quel que soit ce facteur). Défaut : 1.

Exemple : pcLogo --expand 2 logo.ini

-b, --brandname nom

Utilise nom.ini au lieu du fichier .ini par défaut : cherché d'abord dans le répertoire courant, puis dans ~/.config/pcLogo (repli sur /root/.config/pcLogo si HOME est absent). Erreur explicite si nom.ini n'existe dans aucun des deux. Incompatible avec un fichier .ini positionnel (l'un ou l'autre, jamais les deux).

Exemple : pcLogo --brandname acme

-h, --help

Affiche l'aide (fonctionnement, syntaxe, exemple par option) et quitte.

Exemple : pcLogo --help

Format du fichier .ini

[canvas]
width = 135
height = 135
output = logo
background = #ffffff

[frame]
outer_color = #777777
outer_width = 1.3
outer_radius = 9
inner_color = #202020
inner_width = 1.5
inner_x = 3
inner_y = 3
inner_w = 129
inner_h = 129
inner_radius = 7

[powered_by]
text = POWERED BY
font = DejaVu Sans Bold
size = 10
scale_x = 0.59
x = 10
y = 21
color = #000000

[main]
text = PC Street
font = Arial Black
size = 28
scale_x = 0.6533
y = 47
color = #2777F0
boldness = 1.0

[stripes]
color = #000000
alpha = 0.5
width = 1.0
x1 = 8
x2 = 126
y1 = 53
y2 = 81
step = 3.3

[address]
text = @Bois Dery
font = Comic Sans MS
size = 12
y = 82
color = #2E78EB
boldness = 0.6

[contact]
text = contact@pcstreet.fr
font = Comic Sans MS
size = 9
y = 108
color = #000000

Cette configuration reconstitue le logo PC Street d'origine, affinée par comparaisons successives avec logo.jpg (bornes de chaque bloc de texte, couleurs, épaisseurs de trait, débordement par rapport aux bandes). Points clés :

  • police de « PC Street » : Arial Black, confirmée
 par les fichiers sources originaux retrouvés a posteriori
 (images/logo pcstreet.ai, PDF 1.5 — police intégrée
 Arial-Black via pdffonts — et
 images/Logo.PCStreet.svg, export Inkscape —
 font-family:'Arial Black') ;
  • compression horizontale de « PC Street » : scale_x =
 0.6533, retrouvée indépendamment dans les deux fichiers sources
 (matrices de transformation 53.2101/81.4457 dans le flux
 PDF et matrix(0.6533212,0,0,-1,...) dans le SVG — même
 valeur à 10⁻⁴ près). Une compression géométrique amincit aussi les
 jambages verticaux du texte : la clé boldness = 1.0
 compense cet amincissement (voir ClassTextRenderer
 ci-dessous) ;
  • taille de « PC Street » : size = 28 a été choisie
 pour que la hauteur d'encre réelle tienne dans la zone des bandes
 (y1=53 à y2=81) — une taille plus grande,
 bien que plus proche en largeur, faisait déborder le texte au-dessus
 et en dessous des bandes ;
  • bandes : noires (#000000), mais très diluées
 (alpha = 0.5, width = 1.0) — un noir plein
 était bien trop contrasté par rapport à l'original ;
  • @Bois Dery utilise Comic Sans MS (non gras)
 avec un renfort modéré (boldness = 0.6) : la version
 Bold de cette police est déjà trop épaisse pour la
 boucle du @, mais un renfort léger sur la version
 normale rapproche mieux l'ensemble du mot de l'épaisseur de trait
 originale sans refermer cette boucle. Un étirement horizontal
 (scale_x > 1) a été testé pour élargir le mot mais
 déformait les lettres (trop rondes/plates) : abandonné au profit de
 proportions naturelles, quitte à rester un peu plus étroit que
 l'original ;
  • contact@pcstreet.fr utilise Comic Sans MS
 (non gras, sans renfort) ;
  • [powered_by] et [contact] sont en noir pur
 (#000000) ;
  • les positions verticales (y) ont été calibrées en
 mesurant, pour chaque police/taille utilisée, l'écart entre le haut du
 calque Pango (paramètre y) et le haut réel de l'encre
 rendue, puis en appliquant cet écart aux bornes hautes mesurées sur
 logo.jpg.

Toutes les clés numériques ([frame], positions/tailles de texte, [stripes]) ont une valeur par défaut si elles sont absentes du fichier ; seules les clés text des sections de texte n'ont pas de défaut (chaîne vide si absentes).

Architecture

  • ClassIniConfig : chargement et accès typé au fichier
 .ini ;
  • ClassColor : conversion d'une couleur hexadécimale
 #RRGGBB en source Cairo RGBA ;
  • ClassCairoCanvas : encapsulation RAII de la surface et du
 contexte Cairo, selon un CanvasFormat explicite (Png,
 Jpeg, Svg) fourni par l'appelant — Jpeg réutilise la même surface
 ARGB32 que Png, converti sans alpha via gdk-pixbuf à
 l'écriture (Cairo n'a pas d'export JPEG natif) ;
  • ClassFrameRenderer : dessin des cadres à coins arrondis ;
  • ClassTextRenderer : dessin d'un texte Pango positionné ;
  • ClassStripeRenderer : dessin des bandes horizontales ;
  • ClassLogoRenderer : orchestration de l'ensemble du rendu.