Dalla documentazione di RAVAL, la libreria MIT dei libri: la stessa che sta nel suo repository.

Grafica, conversioni, tabelle, alberi, stili — RAVAL 2.3

Le funzioni che quasi ogni programma Avalonia di misura o di progetto si riscrive: un grafico a curve con i marcatori, i numeri con i prefissi SI, i colori da mescolare, le figure da stampare a 300 dpi, una tabella che si ordina, un elenco di proprietà, uno stile pulito da strumento. Tutto in codice, senza XAML e senza lambda, nel namespace RAVAL.

Spiegazione con un esempio completo (la finestra di misura di un filtro): TUTORIAL.md, capitolo 15. Ogni membro, con la sua firma, è nel riferimento API.md.

Gli eventi si collegano a metodi con un nome: RChart.MarkersChanged (un Action), RTable.SelectionChanged (un Action<int> con la riga, −1 per nessuna), RPropertyList.Changed (un Action<string, string> con il nome e il valore nuovo, solo dopo Invio o l'uscita dalla casella, e solo se il testo è cambiato).

Conversioni — Graphics\RFormat.cs, Graphics\RColor.cs, Graphics\RCsv.cs

Il grafico — Graphics\RChart.cs, RSeries.cs, RLimit.cs, RTicks.cs

var c = new RChart { TitleY = "dB", UnitX = "Hz" };
c.Series.Add(new RSeries("S21", f, s21));
c.Series.Add(new RSeries("misura", f, m, 1) { Dashed = true });
c.Limits.Add(new RLimit(1.27e9, 1.32e9, -1, RAva.Brush("#2b8a3e")) { Label = "S21 > −1" });
c.MarkersChanged += Leggi;          // un metodo senza argomenti

Gli altri grafici — Graphics\RSmithChart.cs, RPolarChart.cs, RBarChart.cs, RHeatMap.cs

Spiegati nel capitolo 21 del tutorial (esempio ESEMPI_RAVAL\Esempi\GraficiRF.cs); prove in TEST_RAVAL\ProveGraficiRF.cs. Tutti prendono i colori da «ChartBack», «ChartGrid», «ChartInk» con la riserva chiara o scura (Graphics\RPlot.cs, interno), scrivono i numeri con Culture (il punto) e si salvano con SavePng(file, cm, dpi).

La carta di Smith e il grafico polare vengono da ASTRIP (MIT), tradotti in inglese e completati con zoom, letture dei marcatori, regioni colorate, dB e orientamento.

Le figure — Graphics\RImage.cs

RImage.SavePng(controllo, file, larghezza, altezza, dpi) disegna un controllo, anche senza finestra, a qualunque risoluzione, e scrive i dpi nel PNG (RImage.SetDpi per i PNG fatti altrove, RImage.Dpi per leggerli). RImage.Dip(8) è la larghezza in dip di una figura stampata larga 8 cm, che a 300 dpi diventa 945 pixel. È il modo di fare nitide le figure dei libri (la regola: almeno 300 dpi alla misura di stampa).

Tabelle ed elenchi — UI\RTable.cs, UI\RPropertyList.cs

var t = new RTable().Columns("Parte", "Valore:R", "Note");
t.AddRow("C1", "1.5p", "ceramico").AddRow("L1", "10n");
t.SelectionChanged += Mostra;       // un metodo con un int

var p = new RPropertyList().Add("C", "1.5p").Add("ESR", "0.1");
p.Changed += Applica;               // un metodo (string nome, string valore)

• RTable: «:R» in fondo a un'intestazione allinea la colonna a destra, «:C» al centro. Un clic sull'intestazione ordina (per valore se ogni cella è un numero, anche con il prefisso SI; se no in ordine alfabetico), un secondo clic rovescia; un clic su una riga la sceglie. È una Grid di TextBlock: va bene per decine o centinaia di righe.
• RPropertyList: nomi a sinistra, valori in caselle a destra; Changed arriva con Invio o quando la casella perde il fuoco, solo se il testo è cambiato davvero.
  • Show(oggetto) elenca le proprietà pubbliche che stanno in una casella (testi, numeri, sì/no, enum) e scrive nell'oggetto i valori confermati, convertiti con RPropertyList.Convert (numeri come RFormat, anche «1 MHz»). Un testo che non si converte è rifiutato: Rejected con il motivo.
  • Si leggono gli attributi DisplayName, Description, ReadOnly e Browsable; Reload() rilegge l'oggetto; Target è l'oggetto mostrato.
• RVirtualTable (UI\RVirtualTable.cs): la tabella per diecimila o centomila righe, che costruisce solo le righe visibili (un ListBox virtualizzato).
  • LoadCsv(testo), con la prima riga come intestazioni e le colonne numeriche a destra; AddRow e AddRows.
  • Sort(colonna, discendente), per valore o alfabetico; Filter, le righe con una cella che contiene il testo.
  • Rows (tutte), Shown (quelle mostrate), SelectedIndex sempre in Rows, SelectionChanged.
  • SetWidth(colonna, dip); Text() dà le righe con le tabulazioni, per gli appunti.
  • Centomila righe si aprono in un terzo di secondo e si ordinano in due decimi.
• RFormat.TryParse(testo, out valore): Parse senza eccezioni, che scarta subito i testi che non cominciano come un numero. Parse senza unità indicata ora legge anche «10 MHz» (1e7) e «5 V» (5).

L'albero — UI\RTree.cs, UI\RTreeNode.cs

Spiegato nel capitolo 17 del tutorial, con l'esempio ESEMPI_RAVAL\Esempi\Albero.cs; prove in TEST_RAVAL\ProveAlbero.cs.

RTree t = RTree.FromJson(testo);                 // i membri in cima; FromXml: la radice
t.Searchable = true;                             // la casella di ricerca
t.SelectionChanged += Scelto;                    // void Scelto(RTreeNode? n)
t.Opened += Apri;                                // doppio clic o Invio
t.Add(RTreeNode.FromFolder("C:\\"));             // le cartelle si leggono quando si aprono
t.Select(t.Find("componenti[1].valore", "."));

Le voci (TreeViewItem) si costruiscono solo quando il nodo sopra si apre: al loro posto c'è una voce finta che fa vedere la freccia. Un caricatore che lancia un'eccezione dà un figlio rosso con il messaggio e una riga Warning nel log. Il filtro non chiama i caricatori: cerca fra i figli già letti.

Stile — UI\RStyles.cs, UI\RAvaLook.cs

public override void Initialize() {
  Styles.Add(new FluentTheme { DensityStyle = DensityStyle.Compact });
  RStyles.Clean().Apply(this);
  RStyles.Accent(this, Color.Parse("#1f5fa8"), Color.Parse("#5b9be0"));
}

Perché è fatta così

• I numeri si scrivono come li legge un tecnico. Su un asse «1.296 GHz» si legge, «1296000000» no; e chi scrive «4k7» in una cella deve poterlo rileggere. RFormat è usato dal grafico e dalla tabella (che ordina per valore anche le celle con i prefissi).
• Il grafico è disegnato a mano, come la carta di Smith del libro: nessuna dipendenza, ogni pixel si può spiegare in un capitolo, e senza schermo si prova con il mouse finto (TEST_RAVAL\ProveGrafica.cs).
• Le risorse dei colori hanno sempre una riserva. Un'applicazione che non definisce «ChartBack» vede comunque un grafico chiaro o scuro giusto.

Inciampi

• Una risorsa che manca toglie lo sfondo, e con lo sfondo il clic. Uno sfondo legato con Resource a una chiave che l'applicazione non ha resta nullo, e un Border senza sfondo non riceve il mouse: le righe a strisce di RTable non si potevano scegliere nell'applicazione di prova, che chiama i colori in italiano. Ora la striscia è solo dipinta e il clic va a un Border trasparente sopra di lei.
• Bitmap.Save(percorso) è obsoleto in Avalonia 12: si passa PngBitmapEncoderOptions.Default, se no l'avviso (che nei progetti con gli avvisi come errori ferma la compilazione).
• Il nome Border dentro RAva è il metodo, non la classe: in RAvaLook.cs si scrive Avalonia.Controls.Border.BackgroundProperty (lo stesso inciampo di RAva.cs).
• A 300 dpi le scritte dopo un ritaglio sparivano. Una RenderTargetBitmap creata a 300 dpi perdeva ogni testo disegnato dopo la chiusura di un PushClip: il grafico esportato per il libro non aveva né la legenda né i valori dei marcatori, mentre sullo schermo e a 96 dpi c'erano. Non dipende dal renderer di composizione (succede anche chiamando Render a mano). RImage crea la bitmap a 96 dpi con i pixel della risoluzione voluta e mette la scala come trasformazione: stessi pixel, tutto disegnato. Poi scrive nel PNG la risoluzione vera (il blocco pHYs, 11811 pixel al metro per 300 dpi), che i libri chiedono. La prova conta i pixel scritti nell'angolo della legenda (TEST_RAVAL/ProveGrafica.cs).
• Nel disegno a mano l'opacità non la mette nessuno. RImage percorre l'albero visuale da sé, e fino alla 2.5.0 saltava solo gli elementi del tutto trasparenti: un testo con Opacity = 0.6 usciva pieno. Ora ogni elemento con opacità minore di 1 si disegna dentro un PushOpacity; la prova controlla che un rettangolo nero al 50% su bianco esca grigio (TEST_RAVAL/ProveCorrezioni.cs).