Macro Dump Objects/it

Durante lo sviluppo di modelli complessi è facile perdere traccia di quali sono gli oggetti effettivamente presenti dato che alcuni possono essere nascosti, coperti o trasparenti. Inoltre con un gran numero di oggetti diventa necessario conservarne la traccia per gestire il sistema di denominazione.



Descrizione
Il codice Dump Object enumera tutti gli oggetti contenuti nel documento corrente. Quindi genera un rapporto che elenca ogni oggetto, poi una sintesi che fornisce il numero totale di istanze di ogni Classe, seguito dal numero totale di classi e infine il numero totale di oggetti. L'output del rapporto può essere indirizzato alla vista Report o ad una finestra indipendente. La finestra è non-modale e rimane aperta fino a quando non viene chiusa dall'utente. Ogni finestra contiene nella barra del titolo la data e l'ora in cui è stata generata, quindi si può confrontare il contenuto di più finestre, ad esempio, prima e dopo l'esecuzione di una parte di codice.

Di default sono elencati tutti gli oggetti, come opzione si può indicare anche il posizionamento di ogni oggetto. Inoltre, per gli schizzi si può elencare ogni segmento della geometria.

Installazione
Tutto il codice per dumpObject.FCMacro è in una macro. L'installazione consiste nel copiare il suo codice nella appropriata directory delle Macro. Si attiva invocando dumpObject dal menu Macro. In alternativa, può essere eseguita dalla console.

Uso
Selezionare il documento di cui si desidera analizzare gli oggetti per poi avviare la macro in uno di questi modi:
 * dal menu Macro
 * dalla console Python
 * dalla barra degli strumenti

A seconda dei parametri selezionati nella prima finestra, il rapporto viene visualizzato nella vista Report o in una finestra. Le informazioni mostrano tutti gli oggetti del documento corrente. Alcuni dei benefici attesi sono l'individuazione di:


 * irregolarità nei nomi di oggetti, ad esempio errori di ortografia o nomi predefiniti generati da FreeCAD
 * oggetti duplicati
 * oggetti con nomi duplicati (dove FreeCAD ha dovuto creare il secondo nome oggetto unico)
 * oggetti inaspettati
 * posizionamenti inattesi di oggetti (quando è selezionata l'opzione Show Positions)
 * segmenti inattesi nella geometria dello schizzo (quando è selezionata l'opzione Show Sketcher Segments)

Interfaccia utente
La prima finestra è quella che serve per configurare Object Dump:



La seconda finestra è quella che contiene il rapporto sugli oggetti del documento corrente:



Options

 * output may be directed to one of:
 * the Report view
 * a non-modal window
 * segments in the Geometry for each Sketch may be listed
 * Placement specifics may be listed for objects

Remarks
Although tested with many object types in FreeCAD, there probably are some objects that it does not expect, in that case it should list them generically.

Links
none (so far)