App Link/it: Difference between revisions
Renatorivo (talk | contribs) (Created page with "Un App Link viene creato con il metodo {{incode|addObject()}} del documento.") |
No edit summary |
||
(35 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{TOCright}} |
|||
== Introduzione == |
== Introduzione == |
||
[[File:Link.svg|32px]] |
|||
Un [[App_Link|App Link]], o formalmente un {{incode|App::Link}}, è un elemento che restituisce un riferimento a un altro oggetto nel documento o in un documento esterno. Questo oggetto è stato introdotto in v0.19 per riutilizzare oggetti precedentemente creati, che è molto utile per creare assiemi. |
|||
Un [[App_Link/it|App Link]], o formalmente un {{incode|App::Link}}, è un tipo di oggetto che fa riferimento o si collega a un altro oggetto, nello stesso documento o in un altro documento. È appositamente progettato per duplicare in modo efficiente un singolo oggetto più volte, il che aiuta nella creazione di [[assembly/it|assemblaggi]] complessi da sottoassiemi più piccoli e da più componenti riutilizzabili come viti, dadi e dispositivi di fissaggio simili. |
|||
Quando viene creata una copia regolare di un oggetto (ad esempio, con [[Part SimpleCopy/it|Crea una copia semplice]] di Part), viene duplicato un intero nuovo oggetto con la sua forma topologica, che consuma molta memoria. App Link viene utilizzato per riutilizzare i dati esistenti di un oggetto esistente, quindi non è necessario creare un intero nuovo oggetto; ciò migliora la gestione delle copie, in particolare nel contesto dell'assemblaggio meccanico in cui possono essere necessari molti duplicati o dove è richiesta l'importazione di assiemi più piccoli in assiemi più grandi. |
|||
[[File: |
[[File:FreeCAD_core_objects.svg|800px]] |
||
{{Caption|Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD}} |
|||
== Utilizzo == |
== Utilizzo == |
||
Vedere la pagina [[Std_LinkMake/it#Utilizzo|Crea link]]. |
|||
Un [[App_Link/it|App Link]] è un oggetto interno, quindi è principalmente destinato all'uso da parte degli sviluppatori durante lo sviluppo di ambienti di lavoro di assemblaggio. Ad esempio, Assembly3 e Assembly4 utilizzano questo oggetto. Vedere [[External workbenches/it|Ambienti esterni]]. |
|||
== Proprietà == |
== Proprietà == |
||
Vedere [[Std_LinkMake/it#Proprietà|Crea link]]. |
|||
Vedere [[Property/it|Proprietà]] per tutti i tipi di proprietà che possono avere gli oggetti con script. |
|||
Un oggetto {{incode|App::Link}} non deriva da una [[Part_Feature/it|Part Feature]], tuttavia, se il collegamento ha un riferimento a un oggetto esterno, mostra le proprietà di quest'ultimo oggetto. |
|||
Queste sono le proprietà disponibili nell'[[property editor/it|editor delle proprietà]] per un {{incode|App::Link}} vuoto. |
|||
=== Dati === |
|||
{{TitleProperty|Link}} |
|||
* {{PropertyData|Linked Object}}: |
|||
* {{PropertyData|Link Transform}}: |
|||
* {{PropertyData|Placement}}: |
|||
* {{PropertyData|Show Element}}: |
|||
* {{PropertyData|Element Count}}: |
|||
* {{PropertyData|Scale}}: |
|||
{{TitleProperty|Base}} |
|||
* {{PropertyData|Label}}: |
|||
===Vista=== |
|||
{{TitleProperty|Link}} |
|||
* {{PropertyView|Draw Style}}: |
|||
* {{PropertyView|Line Width}}: |
|||
* {{PropertyView|Override Material}}: |
|||
* {{PropertyView|Point Size}}: |
|||
* {{PropertyView|Selectable}}: |
|||
* {{PropertyView|Shape Material}}: |
|||
{{TitleProperty|Base}} |
|||
* {{PropertyView|On Top When Selected}}: |
|||
* {{PropertyView|Selection Style}}: |
|||
* {{PropertyView|Show In Tree}}: |
|||
* {{PropertyView|Visibility}}: |
|||
== Script == |
|||
{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]]. |
|||
Vedere [[Part_Feature/it|Part Feature]] per le informazioni generali. |
|||
Un App Link viene creato con il metodo {{incode|addObject()}} del documento. |
|||
{{Code|code= |
|||
import FreeCAD as App |
|||
doc = App.newDocument() |
|||
obj = App.ActiveDocument.addObject("App::Link", "Name") |
|||
obj.Label = "Custom label" |
|||
}} |
|||
== Further reading == |
|||
The App Link object was introduced after 2 years of development and prototyping. This component was thought and developed almost single-handedly by user {{Emphasis|realthunder}}. The motivations and design implementations behind this project are described in his GitHub page, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. In order to accomplish this feature, several core changes to FreeCAD were made; these were also extensively documented in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes]. |
|||
The App Link project started after the redesign of the [[PartDesign Workbench|PartDesign Workbench]] was complete in v0.17. The history of App Link can be traced to some essential forum threads: |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=19&t=21505 Why an object can only be inside one App::Part?] (March 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=21586 Introducing App::Link/XLink] (March 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=22216 Links] (May 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=23015 Realthunder Link implementation: Architecture discussion] (June 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23419 PR #876: Link, stage one, context aware selection] (July 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23626 Preview: Link, stage two, API groundwork] (July 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Assembly3 preview] (December 2017) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=29542 Merging of my Link branch] (June 2018) |
|||
Finally, the pull request and merge happened: |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=27&t=38621 App::Link: the big merge], old thread (July 2019), [https://github.com/FreeCAD/FreeCAD/pull/2350 pull request #2350] (the BIG merge), [https://github.com/realthunder/FreeCAD/tree/LinkMerge LinkMerge branch]. |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=8&t=37757 App::Link: the big merge], main thread (July 2019) |
|||
* [https://forum.freecadweb.org/viewtopic.php?p=329054#p329054 A simple path description of Link, 019, Link stage, Asm3, merge?] (August 2019) |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=39672 PR#2559: expose link and navigation actions], an introduction to the Link feature in 0.19 (September 2019). |
|||
{{Std_Base_navi{{#translation:}}}} |
|||
{{Std Base}} |
|||
{{Document_objects_navi{{#translation:}}}} |
|||
{{Userdocnavi}} |
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 22:33, 27 September 2022
Introduzione
Un App Link, o formalmente un App::Link
, è un tipo di oggetto che fa riferimento o si collega a un altro oggetto, nello stesso documento o in un altro documento. È appositamente progettato per duplicare in modo efficiente un singolo oggetto più volte, il che aiuta nella creazione di assemblaggi complessi da sottoassiemi più piccoli e da più componenti riutilizzabili come viti, dadi e dispositivi di fissaggio simili.
Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD
Utilizzo
Vedere la pagina Crea link.
Proprietà
Vedere Crea link.
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
Oggetti del documento
- Cuore: App DocumentObject
- Base: App FeaturePython, App GeoFeature, Part Feature, Mesh Feature, Fem FemMeshObject
- Forme interne: Part TopoShape, Mesh MeshObject, Fem FemMesh
- Struttura: App DocumentObjectGroup (Std Group), App Part (Std Part), App Link
- Derivate: Part Part2DObject, Sketcher SketchObject, PartDesign Body, PartDesign Feature
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub