Drawing Template HowTo/it

Questo tutorial è una guida per creare la base e modificare un file grafico SVG da usare come un modello di squadratura nell'ambiente Drawing di FreeCAD. A partire dalla versione 0.14, rev. 2995, di FreeCAD, il modulo Drawing proietta su un foglio di disegno la parte selezionata del modello attenendosi alle regole stabilite nel documento SVG. Tali regole definiscono l'area di lavoro, in coordinate X e Y, in cui FreeCAD può proiettare la parte senza invadere lo spazio occupato dal cartiglio.

Chiunque progetti dei modelli da condividere dovrebbe seguire tutte le direttive di base enunciate in questo tutorial. Nel modello sono inclusi i tag per l'area di lavoro, “Working space”, e per il cartiglio, “Title block” che non sono inclusi nelle versioni precedenti di FreeCAD. Includendo questi tag si rende il modello completamente funzionante per la versione attuale.

Questo tutorial inizia con la creazione di una pagina in Inkscape e la costruzione di un disegno base del modello. Continua con l'aggiunta di alcune opere grafiche che consentono di conferire al lavoro un tocco di personalizzazione o di professionalità. Infine, si vede come modificare il modello e quali informazioni deve contenere per essere utilizzabile in FreeCAD.

Questo tutorial presuppone che il lettore abbia una conoscenza di base di Inkscape e sappia utilizzare un editor di testo.

Impostare la pagina
Iniziare creando un nuovo documento in Inkscape. In riferimento alla pagina del Wiki di FreeCAD sul disegno di modelli: un pixel = un millimetro. Questo significa che per creare un modello adatto a una pagina con dimensioni ANSI A (letter size), che è di 216mm X 279mm, il modello deve avere le dimensioni di 216px X 279px. Per orientare la pagina in senso orizzontale, questi numeri devono essere invertiti. In questa esercitazione, viene utilizzato l'orientamento orizzontale. La pagina è perciò definita con 279px per la larghezza e 216px per l'altezza.

In Inkscape, aprire il menu "File" e selezionare "Proprietà del documento", si dovrebbe vedere la finestra delle Proprietà del documento. Modificare la larghezza e l'altezza come detto prima e verificare che l'unità impostata sia px.



Ora si dispone di un documento Inkscape che è largo 279px e alto 216px. Si può procedere e inserire il bordo.

Il bordo
Quindi, creare il bordo. Sebbene ai fini di questa esercitazione non sia indispensabile, sarà utilizzato in seguito.

Usare lo strumento “Disegna tracciati e linee dritte”, e selezionare la Modalità “Crea una sequenza di segmenti parassiali”, creare un rettangolo entro i confini del documento. Quando il rettangolo è chiuso, cliccare sullo strumento "Seleziona e trasforma oggetti". Ora il rettangolo dovrebbe apparire selezionato. In caso contrario, utilizzare lo strumento e selezionarlo.

Utilizzare le coordinate orizzontali e verticali di impostazione della selezione, insieme alle impostazioni di Larghezza e Altezza della selezione, per posizionare il rettangolo del bordo a 10 unità, (px) dai lati del documento. Inserire i seguenti valori: per X inserire 10, per Y inserire 10, per W inserire 259, e per H inserire 196. Osservare che questi valori impostano l'angolo inferiore sinistro del rettangolo disegnato a 10 unità dal lato sinistro e 10 unità dal lato inferiore dell'angolo inferiore sinistro della pagina. Inserendo Larghezza e Altezza si dimensiona e si centra il rettangolo nel bordo del documento.



Il blocco del cartiglio
Ora è possibile costruire un riquadro delle iscrizioni o cartiglio. È la zona dove viene inserito il testo modificabile con Drawing quando il modello viene utilizzato in FreeCAD. Questo tutorial utilizza un esempio semplice. Il cartiglio può essere semplice o complesso quanto si vuole.

In questo esempio di cartiglio contiene: Nome del progetto, Data, Scala, e Autore. Viene posizionato nell'angolo in basso a destra del bordo.

Iniziare tracciando un rettangolo qualsiasi entro i bordi del documento. Costruirlo nello stesso modo in cui si è costruito il bordo. Poi dividerlo in 4 parti a piacere. Terminata la costruzione, selezionare il rettangolo e le linee di suddivisione, renderli un gruppo, posizionarlo a X = 169, Y = 10 e dimensionarlo con W = 100, H = 50, nello stesso modo usato per il bordo.



Il testo fisso
A questo punto si possono inserire nel cartiglio i blocchi di testo fissi. Sono: Nome del progetto, Data, Scala, e Autore. Per fare questo, basta selezionare lo strumento testo, fare clic da qualche parte nel documento e digitare il testo, usando un blocco diverso per ogni nome. Quindi, fare clic sullo strumento testo, poi nel documento, selezionare la dimensione appropriata del carattere, (la dimensione 6 per questo esempio) e digitare "Nome del progetto". Spostare il puntatore in una nuova posizione, fare di nuovo clic per iniziare un nuovo blocco di testo e digitare "Data". Fare la stessa cosa per Scala, e Autore. Ora, utilizzando lo strumento di selezione, spostare i singoli blocchi di testo, trascinandoli o utilizzando i tasti freccia, per sistemarli nelle posizioni desiderate.

Quando i blocchi di testo sono posizionati correttamente devono essere selezionati, insieme al cartiglio e resi un gruppo. In questo modo il cartiglio e il testo fisso diventano un blocco unico.



Il testo editabile
Ora si possono aggiungere i blocchi di testo modificabili con FreeCAD. Creare e posizionare il testo modificabile nello stesso modo usato per il testo fisso. Si può digitare: NOME, DATA, SCALA, AUTORE, e impostare la dimensione 8. Quando il testo è inserito, selezionare i 4 campi di testo che si desidera siano modificabile e renderli un gruppo separato. Non includerli nel gruppo del cartiglio o del bordo. Con questa parte si è definito il testo modificabile, ma dopo aver aggiunto al modello anche la parte grafica, si deve poi completare il processo di creazione del testo modificabile con FreeCAD. Terminiamo aggiungendo al modello solo una piccola parte grafica.



Adding Artwork
Now that the basic template is done, you can add a bit of artwork to it. This can be whatever you wish. A company or personal graphical logo, a picture or rendering of the project, etc.. For this tutorial the FreeCAD logo, found in the Artwork section of the FreeCAD Wiki will be used. You can simply right click on it and select save image. Once saved, import it into Inkscape. With the image imported into your template, it can be sized and placed where ever you may wish it to be. Adding artwork to your template is as easy as that.

At this point, you can select File, then Save. In this tutorial, the file was simply named example.svg but you may name it whatever you wish.



Opening The File With A Text Editor
Once your template is saved, open it with your favorite text editor. This can be something as basic as Windows Notepad or a more complete editor like Kate. In this tutorial, Kate will be used and all screenshots will be of that editor.

Opening the SVG file with your text editor you will see the following.



The “xmlns:freecad” Tag
The first thing is to insert the following line into the document. This line is the SVG namespace declaration and must be provided so that all SVG elements are identified as belonging to the SVG namespace. xmlns:freecad="http://www.freecadweb.org/wiki/index.php?title=Svg_Namespace" This line is added immediately following the first  -Tag the unit "mm" is added to the width and height fields. And a viewBox Atrribute has to be added. The viewBox ranges from 0 0 to the width and height of the template. This way the SVG user unit (px) is redefined to be 1mm long. In consequence programms linke inkscape will the able to print a resulting drawing up to scale. Current versions of inkscape handle this information very badly. Inscapes effectivly rescales the whole document to 90dpi. After editing a template in Inkscape, it would have the same real word size on its own but elements of the drawing would be scaled down by a factor of 3.54. Therefore it's recommended to remove the "mm" from the width and height attributes before opening an existing template in inkscape and recreate the units and viewBox attribute afterwards.

Working space and Title block Tags
The next lines to add will be the Working space and Title block tag. These tags and their usage are defined on the Drawing Templates page. While these tags are not required, newer versions of the FreeCAD Drawing Workbench benefit from them and they will not affect older versions.

The Working space tag is used to define the space that FreeCAD may make projections into. This allows FreeCAD to make automatic projections on the drawing template and stay within the border that has be drawn, or withing any defined space on the page.

The Title block tag is used to define where within the Working space it resides. This information is used by FreeCAD to avoid using that space within the Working space. This can be referred to as Title block avoidance.

If both tags are used, the Working space tag must appear first and be immediately followed by the title block tag. Both tags must also appear before the first <metadata tag. These tags can be placed either at the top, following the <? xml tag or immediately before the <metadata tag. For this tutorial we will place them at the top.

The Working space Tag
The first tag is the Working space tag and is formated as follows. Where X1, Y1, X2, Y2 are defined as:
 * X1 is the X axis distance from the left edge of the page to the left side of the Border.
 * Y1 is the Y axis distance from the top edge of the page the the top of the Border.
 * X2 is the X axis distance from the left edge of the page to the right side of the Border.
 * Y2 is the Y axis distance from the top edge of the page the the bottom of the Border.

So for this tutorial template, the Working space tag will be.

The Title block Tag
The next tag will be the Title block tag and is formated as follows: Where X1a, Y1a, X2a, Y2a are defined as:
 * X1a is the X axis distance from the left edge of the page to the left side of the Title block
 * Y1a is the Y axis distance from the top edge of the page the the top of the Title block
 * X2a is the X Axis distance from the left edge of the page to the right side of the Title block
 * Y2a is the Y axis distance from the top edge of the page the the bottom of the Title block
 * X1a <= X1 or X2a >= X2
 * Y1a <= Y1 or Y2a >= Y2

Again, referencing the template created with this tutorial, the title block tag will be as follows: Placing these two tags, in proper order at the top of the document looks like this:



The freecad:editable Tag
Adding the freecad:editable tags into the SVG document allows FreeCAD to access the defined text blocks for editing. For those blocks of text that you wish to be editable from within FreeCAD, do the following.

Search down through the SVG document until you find the section that contains the text you wish to have editable. When making the template, you placed these in a group, and as a result, they should appear within the document as a group as well. Once this group of text elements is located, you will add the line freecad:editable=” “ to each text block where the text that you wish to make editable is contained within the quote marks. Place them as shown for all four lines of text to be editable.



The DrawingContent Tag
The last tag that is needed in the Template is the DrawingContent tag. Without it, FreeCAD can not access the drawing template. This tag informs FreeCAD where within the document it may write it's projections and other attributes. It is the one tag that must be within the SVG document for the drawing template to work with FreeCAD.

Questo tag è formattato come segue e si inserisce immediatamente prima dell'ultimo tag .



That's it. The SVG document can now be saved and used with FreeCAD.

Complete Example Template
Below is the finished SVG template. Sense it is in SVG format, you can save and open it in your text editor for review as reference to this tutorial and the creation of your own templates.



Tools
The two tools used in this tutorial were Inkscape and Kate. They can be found by following the links provided below.


 * Inkscape
 * Kate