Draft OCA: Difference between revisions

Latest revision as of 08:03, 15 September 2021

Other languages:

Scalable Vector Graphics .SVG

Airfoil Data Format .DAT

Draft

Description

Draft OCA is a software module used by the Std Open, Std Import and Std Export commands to handle the OCA file format.

The OCA file format is a community effort to create a free, simple and open CAD file format. OCA is largely based on the GCAD file format generated from gCAD3D. Both formats can be imported in FreeCAD, and the OCA files exported by FreeCAD can be opened in gCAD3D.

Importing

The following OCA objects can be imported:

Lines
Arcs and Circles
Closed areas

Exporting

The following FreeCAD objects can be exported:

Lines and wires (polylines)
Arcs and circles
Faces

Preferences

See Import Export Preferences.

Scripting

To export objects to OCA use the export method of the importOCA module.

importOCA.export(exportList, filename)

For the Windows OS: use a / (forward slash) as the path separator in filename.

Example:

import FreeCAD as App
import Draft
import importOCA

doc = App.newDocument()

polygon1 = Draft.make_polygon(3, radius=500)
polygon2 = Draft.make_polygon(5, radius=1500)

doc.recompute()

objects = [polygon1, polygon2]
importOCA.export(objects, "/home/user/Pictures/myfile.oca")

Scalable Vector Graphics .SVG

Airfoil Data Format .DAT

Draft

Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view

Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid

Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state

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, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
 <translate>
-<!--T:13-->
-{{docnav|[[Draft_SVG|SVG]]|[[Draft_DAT|Airfoil Data Format .DAT]]|[[Draft_Module|Draft Module]]|IconC=Workbench_Draft.svg}}
-<!--T:7-->
+<!--T:13-->
+{{Docnav
-{{GuiCommand
+|[[Draft_SVG|Scalable Vector Graphics .SVG]]
-|Name=Draft OCA
+|[[Draft_DAT|Airfoil Data Format .DAT]]
-|MenuLocation=File → Export → Open CAD format (*.oca)
-|Workbenches=[[Draft Workbench|Draft]]
+|[[Draft_Workbench|Draft]]
+|IconL=
-|Shortcut=Ctrl+E
+|IconR=
-|SeeAlso=[[Draft SVG]], [[Draft DXF]]
+|IconC=Workbench_Draft.svg
-|Empty=1
 }}
+</translate>
-== Description == <!--T:8-->
+{{TOCright}}
-This function imports OCA/GCAD files. The [http://groups.google.com/group/open_cad_format OCA file format] is community effort to create a free, simple and open CAD file format.
+<translate>
+==Description== <!--T:8-->
+<!--T:16-->
+Draft OCA is a software module used by the [[File:Std_Open.svg|24px]] [[Std_Open|Std Open]], [[File:Std_Import.svg|24px]] [[Std_Import|Std Import]] and [[File:Std_Export.svg|24px]] [[Std_Export|Std Export]] commands to handle the [http://groups.google.com/group/open_cad_format OCA file format].
 <!--T:9-->
-OCA is largely based on the GCAD file format generated from [http://www.gcad3d.org/ gCAD3D]. Both formats can be imported in FreeCAD, and the OCA files exported by FreeCAD can be opened in gCAD3D.
+The OCA file format is a community effort to create a free, simple and open CAD file format. OCA is largely based on the GCAD file format generated from [http://www.gcad3d.org/ gCAD3D]. Both formats can be imported in FreeCAD, and the OCA files exported by FreeCAD can be opened in gCAD3D.
-== Opening == <!--T:1-->
+==Importing== <!--T:1-->
 <!--T:2-->
-The following OCA objects get imported at the moment:
+The following OCA objects can be imported:
 * Lines
 * Arcs and Circles
 * Closed areas
-== Importing == <!--T:3-->
+==Exporting== <!--T:4-->
-Works the same way as opening but places the objects in the active document instead of creating a new one.
-== Exporting == <!--T:4-->
+<!--T:17-->
-Objects that can be exported at the moment:
+The following FreeCAD objects can be exported:
 * Lines and wires (polylines)
 * Arcs and circles
 * Faces
-== Preferences == <!--T:5-->
+==Preferences== <!--T:5-->
-The following parameters can be specified in the [[Draft Preferences]] tab (menu Edit -> Preferences -> Draft):
-* Import closed areas or not
-== Scripting == <!--T:10-->
+<!--T:18-->
+See [[Import_Export_Preferences|Import Export Preferences]].
-{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].
+==Scripting== <!--T:19-->
+<!--T:10-->
+See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
 <!--T:11-->
-You can export elements to OCA by using the following function:
+To export objects to OCA use the {{incode|export}} method of the importOCA module.
 </translate>
 {{Code|code=
@@ Line 51: / Line 58: @@
 }}
 <translate>
+<!--T:20-->
+* For the Windows OS: use a {{FileName|/}} (forward slash) as the path separator in {{Incode|filename}}.
 <!--T:12-->
 Example:
 </translate>
 {{Code|code=
-import FreeCAD, Draft, importOCA
+import FreeCAD as App
+import Draft
+import importOCA
+doc = App.newDocument()
-p1 = FreeCAD.Vector(0, 0, 0)
-p2 = FreeCAD.Vector(1000, 1000, 0)
-p3 = FreeCAD.Vector(2200, 1500, 0)
-p4 = FreeCAD.Vector(2500, -100, 0)
-obj1 = Draft.makeWire([p1, p2, p3, p4])
+polygon1 = Draft.make_polygon(3, radius=500)
-obj2 = Draft.makeWire([p1, -2.3*p2, -0.8*p3, -1.8*p4])
+polygon2 = Draft.make_polygon(5, radius=1500)
+doc.recompute()
-objects = [obj1, obj2]
+objects = [polygon1, polygon2]
 importOCA.export(objects, "/home/user/Pictures/myfile.oca")
 }}
 <translate>
-<!--T:6-->
-{{docnav|[[Draft_SVG|SVG]]|[[Draft_DAT|Airfoil Data Format .DAT]]|[[Draft_Module|Draft Module]]|IconC=Workbench_Draft.svg}}
-<!--T:14-->
+<!--T:6-->
+{{Docnav
-{{Draft Tools navi}}
+|[[Draft_SVG|Scalable Vector Graphics .SVG]]
+|[[Draft_DAT|Airfoil Data Format .DAT]]
+|[[Draft_Workbench|Draft]]
+|IconL=
+|IconR=
+|IconC=Workbench_Draft.svg
+}}
-<!--T:15-->
-{{Userdocnavi}}
 </translate>
+{{Draft Tools navi{{#translation:}}}}
-{{clear}}
+{{Userdocnavi{{#translation:}}}}
+[[Category:File Formats{{#translation:}}]]