Drawing Documentation

From FreeCAD Documentation
Revision as of 13:11, 16 November 2019 by David69 (talk | contribs) (Created page with "=== DrawingView.cpp === Fais un tas de trucs qt de l'interface graphique. Besoin de lire plus à ce sujet.")
Jump to: navigation, search
Other languages:
čeština • ‎English • ‎français • ‎italiano • ‎română

Cette page documente le module de dessin de jcc242. Il inclut des fichiers et des fonctionnalités sur lesquels il travaille actuellement et qui peuvent ne pas encore être dans la branche principale. La source de ces fichiers est sur son Github mais faites attention car il est pour le moment très instable!

Base (Mod/Drawing)

gdtsvg.py

Script Python génère des extraits svg pour des éléments tels que des symboles gd & t, des symboles de dimension et des éléments de base svg tels que des lignes, des cercles et des chemins.

Il a plusieurs fichiers qui ne font pas vraiment beaucoup de choses. Exécutez DrawingTest.py pour créer un groupe d’icônes svg dans le répertoire icon qui affiche différentes icônes dans le fichier gdtsvg.py. settingslist.py, dimesettings et convert.py sont tous déconseillés pour les méthodes de paramétrage plus anciennes et doivent probablement être supprimés à mesure que la branche de dessin se fusionne en maître.

DrawingAlgos.py

Crée des lignes svg à partir d'une liste de sommets, prend en charge les bords cachés et visibles. Devrait probablement être fusionné avec gdtsvg.py à l’échéance du fichier.

createSVG

Accepte la pièce en tant qu'argument, projette la pièce dans des lignes à partir de l'objet Drawing.project, puis dessine et crée le svg pour chaque ligne.

App

Contient le backend du module de dessin.

AppDrawing.cpp

Initialise les différents espaces de noms, modules et éléments utilisés dans le module de dessin. Lance une erreur s'il ne peut pas charger le module Part.

DrawingExport.cpp

Deux classes: SVGOutput et DXFOutput. Ils contiennent tous deux des méthodes pour afficher le code dans leur langue respective. Nécessite généralement un objet de la typedef appropriée, et parfois des informations d'identifiant supplémentaires.

FeatureClip.cpp

Les méthodes Callback (?) pour l'interface de découpage des fonctionnalités, semble-t-il. Appelées seules, elles créeront le chemin du clip. Si ShowFrame.getValue est défini sur TRUE, il affiche également la bordure de l'image.

FeaturePage.cpp

Gère les vues.

onChanged() pour faire des choses quand les propriétés sont modifiées.

execute() pour recalculer une vue de fonctionnalité, selon le cas. Il semble avoir des outils pour vérifier les textes modifiables et sauvegarder les dessins. Demande plus de recherche.

getEditableTextsFromTemplate() pour récupérer le texte qui peut être édité par FreeCAD depuis un fichier SVG.

FeatureProjection.cpp

Aplatit l'objet en une image 2D?

FeatureView.cpp

Définit les propriétés des vues.

FeatureViewAnnotation.cpp

Définit les propriétés des annotations (juste du texte à l’heure actuelle), dispose d’une méthode d'exécution pour mettre à jour le texte s'il est modifié/déplacé.

FeatureViewPart.cpp

Constructeur pour ajouter des propriétés. Obtient des trucs d'aspect pour les parties projetées.

PageGroup.cpp

Ajoute simplement une propriété pour une liste de pages, pas grand chose d'autre.

Precompiled.cppp

Simplement #inclus "PreCompiled.h"

ProjectionAlgos.cpp

Le constructeur exécute simplement la méthode execute() pour mettre à jour ses données.

invertY: puisque SVG effectue son axe y vers l’arrière par rapport à tous les autres systèmes de coordonnées du monde, nous devons l’inverser lors de la conversion d’une pièce FreeCAD en projection SVG pour la vue de dessin.

getSVG: récupère le code SVG à partir du logiciel DrawingExport. Formats dépendant du type de ligne (masqués ou non et autres éléments, à comprendre...).

getDXF: identique à getSVG à l'exception du format DXF.


Gui - interface graphique

AppDrawingGui.cpp

Initialise l’interface graphique.

AppDrawingGuiPy.cpp

Fournit des interfaces d'ouverture, d'importation et d'exportation? Il semblerait que ce soit accessible en Python.

Command.cpp

Gère les commandes (à partir de la barre d’outils?) telles que la création de nouveaux dessins et autres choses. Il semble que cela gère les appels QT depuis le clic sur le bouton jusqu’à la commande à utiliser, par exemple. Cliquez sur le bouton CmdDrawingOrthoViews pour afficher l'interface graphique Ortho Views dans la boîte de dialogue de la tâche.

DrawingView.cpp

Fais un tas de trucs qt de l'interface graphique. Besoin de lire plus à ce sujet.

TaskDialog.cpp

Creates the task dialog thing on the side and probably switches to it from the tree view, as appropriate.

TaskOrthoViews.cpp

Creates the task dialog for placing the orthographic views!

Does a lot of the calculations for where to position stuff (automatic calculations as well, it seems).

Takes the input from the TaskOrthoViews gui and does stuff with it. Uses the single inheritance method talked about on the qt website.

ViewProviderPage.cpp

Constructor adds some properties for the view stuff. Destructor does nothing. Attaches something (attaches what? attaches the view to the page?) sets and gets display modes (what are display modes? what do they do and what are possible options?) Does something about updating some kind of data has a context menu that says "Show drawing", figure out what this means Has a thing for double clicking to select the view (I think?)

showDrawingView seems to do some work on settings things up: gets the current document, sets the window icon and title, adds it to the main window (of FreeCAD?)

ViewProviderView.cpp

Doesn't seem to do much, though I am sure it is important.

Workbench.cpp

Adds the icons to the toolbars and stuff.

Workflow

Program Flow

CanvasView is the actual QGraphicsScene object and DrawingView processes a list of FeatureView that are linked by reference in /App/FeatureViewPage. DrawingView then chooses the appropriate QGraphicsItem class (QGraphicsItemViewPart or QGraphicsItemViewDimension) and then calls a function in CanvasView to create this and add it to the scene.

Adding commands to the Drawing Workbench

4 simple steps:

  1. Add a class to Command.cpp. Follow the others for an example of the formatting.
  2. Add a title, icon, tooltip, etc., again, follow the existing classes in command.cpp
  3. Add your class to the bottom of Command.cpp
  4. Add your information to Workbench.cpp, this will tell FreeCAD/Drawing module where to place the icons defined in command.cpp in the actual freecad interface (the toolbars, dropdowns, etc.)