Macro Unroll Ruled Surface: Difference between revisions

From FreeCAD Documentation
(Addon_Manager -> Std_AddonMgr)
(v1.1 - py3/qt5 compat)
Line 5: Line 5:
|Name=Macro Unroll Ruled Surface
|Name=Macro Unroll Ruled Surface
|Description=The macro allows to unroll ruled surfaces and to draw them on a page.
|Description=The macro allows to unroll ruled surfaces and to draw them on a page.
|Author=Hervé B.
|Author=Hervé B., heda
|Version=1.0
|Version=1.1
|Date=2013-09-14
|Date=2022-07-24
|Download=[https://www.freecadweb.org/wiki/images/b/ba/Macro_Unroll_Ruled_Surface.png ToolBar icon]
|Download=[https://www.freecadweb.org/wiki/images/b/ba/Macro_Unroll_Ruled_Surface.png ToolBar icon]
}}
}}
Line 19: Line 19:


== Installation == <!--T:4-->
== Installation == <!--T:4-->
Available in Add-on manager.
Copy the code file of the macro in the directory :

*'''Linux & Mac''' : $home/.Freecad/Mod/UnrollRuledSurface.
*'''Windows''' : C:\Program Files\FreeCAD0.13
Add templates : A3_Landscape_Empty.svg A3_Landscape.svg A4_Landscape_Empty.svg A4_Landscape.svg<br />
Cf [http://forum.freecadweb.org/viewtopic.php?f=17&t=4563&p=35737#p35737 Macro for unrolling ruled surfaces]
Cf [http://forum.freecadweb.org/viewtopic.php?f=17&t=4563&p=35737#p35737 Macro for unrolling ruled surfaces]


Line 32: Line 30:


<!--T:6-->
<!--T:6-->
[[File:Macro unrollRuledSurface 01.png|Macro_unrollRuledSurface]]
[[File:Macro_UnrollRuledSurface_start_form.png|Macro_unrollRuledSurface]]


== Instruction for use == <!--T:7-->
== Instruction for use == <!--T:7-->
# Select ruled surfaces
# Select ruled surfaces
# Explode them (cf Draft menu)
# Explode them (cf Draft menu - downgrade)
# Select the surfaces
# Select the surfaces
# Execute the macro
# Execute the macro
Line 43: Line 41:


<!--T:9-->
<!--T:9-->
The lastest version of the macro is to be found at [https://github.com/FreeCAD/FreeCAD-macros/blob/master/Drawing/UnrollRuledSurface.FCMacro UnrollRuledSurface.FCMacro] but the easiest way to install this macro is through the [[Std_AddonMgr|Addon Manager]] [[File:Std_AddonMgr.svg|24px|Std_AddonMgr]]
The lastest version of the macro is here on the wiki. An earlier version can be found at [https://github.com/FreeCAD/FreeCAD-macros/blob/master/Drawing/UnrollRuledSurface.FCMacro UnrollRuledSurface.FCMacro] but the easiest way to install this macro is through the [[Std_AddonMgr|Addon Manager]] [[File:Std_AddonMgr.svg|24px|Std_AddonMgr]]
.
.
</translate>
</translate>
Line 51: Line 49:
'''Macro_unrollRuledSurface.py'''
'''Macro_unrollRuledSurface.py'''


<!--DO NOT CHANGE THE <pre> </pre> TAG, code contains pipe or space character which breaks the wiki macro-->
{{MacroCode|code=
<pre>
# -*- coding: utf-8 -*-


#***************************************************************************
#***************************************************************************
#* *
#* *
#* Copyright (c) 2013 - DoNovae/Herve BAILLY <hbl13@donovae.com> *
#* Copyright (c) 2013 - DoNovae/Herve BAILLY <hbl13@donovae.com> *
#* Copyright (c) 2022 - heda <heda@fc-forum> *
#* *
#* *
#* This program is free software; you can redistribute it and/or modify *
#* This program is free software; you can redistribute it and/or modify *
Line 74: Line 75:
#* *
#* *
#***************************************************************************
#***************************************************************************
__Name__ = 'Unroll Ruled Surface'
__Comment__ = 'Unroll of a ruled surface and draw it on a page.'
__Author__ = 'Hervé B., heda'
__Version__ = '1.1'
__Date__ = '2022-07-24'
__License__ = 'LGPL-2.0-or-later'
__Web__ = 'https://www.freecadweb.org/wiki/Macro_Unroll_Ruled_Surface'
__Wiki__ = 'https://www.freecadweb.org/wiki/Macro_Unroll_Ruled_Surface'
__Icon__ = ''
__Help__ = ('Select ruled surfaces, Explode them (cf Draft menu), '
'Select the surfaces, Execute the macro')
__Status__ = ''
__Requires__ = ''
__Communication__ = ''
__Files__ = ''


__doc__ = """
#####################################
select a face, or several and run the macro.
# Macro UnrollRuledSurface
a solid needs to be draft/downgraded to get the faces as separate objects
# Unroll of a ruled surface
#####################################
import FreeCAD , FreeCADGui , Part, Draft, math, Drawing , PySide, os
from PySide import QtGui,QtCore
from FreeCAD import Base
#from unrollRuledSurface.unfoldBox import unfoldBoxClass # commented 06/08/2015 give error "No module named unrollRuledSurface.unfoldBox"
fields_l = []
unroll_l = []


the macro is intended to unroll lofted faces,
function beyond that is (in current version) a bonus

settings are not context aware, all settings not applicable are ignored.
as example, using autoscaling ignores the scale-value in the form


v1.1 (2022-07-24) py3/qt5 compat, cosmetic code changes, minor code tweaks,
used gridlayout for form, added option to skip drawing,
added simplistic alternative layout engine
v1.0.1 (2019-02-01) - on git
v1.0 (2013-09-14) - on wiki

note:
- unfolding sometimes works and sometimes not
- should be converted to use techdraw

"""

import os
from PySide import QtGui, QtCore
import FreeCAD, FreeCADGui
import Part, Draft

Vector = FreeCAD.Base.Vector
PrintMessage = FreeCAD.Console.PrintMessage
PrintError = FreeCAD.Console.PrintError

settings = dict()
unroll_l = []
dwgtpl = 'Mod/Drawing/Templates'


#####################################
#####################################
# Functions
#####################################
#####################################


#####################################
#####################################
### Functions
# Function errorDialog
#####################################
#####################################

def errorDialog(msg):
def errorDialog(msg):
diag = QtGui.QMessageBox(QtGui.QMessageBox.Critical,u"Error Message",msg )
diag = QtGui.QMessageBox(QtGui.QMessageBox.Critical, "Error Message", msg)
diag.setWindowFlags(PySide.QtCore.Qt.WindowStaysOnTopHint)
diag.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
diag.exec_()
diag.exec_()

def ending():
PrintMessage("UnrollRuledSurface: end.\n")
PrintMessage("===========================================\n")
FreeCAD.ActiveDocument.recompute()




#####################################
# Function proceed
#####################################
def proceed():
def proceed():
QtGui.qApp.setOverrideCursor(QtCore.Qt.WaitCursor)
QtGui.QApplication.setOverrideCursor(QtCore.Qt.WaitCursor)


FreeCAD.Console.PrintMessage("===========================================\n")
PrintMessage("===========================================\n")
FreeCAD.Console.PrintMessage("UnrollRuledSurface: start.\n")
PrintMessage("UnrollRuledSurface: start.\n")
try:
try:
file_name = fields_l[0].text()
sts = lambda s: settings.get(s)

pts_nbr = float(fields_l[1].text())
scale = float(fields_l[2].text())
file_name = sts("fname").text()
scale_auto = scale_check.isChecked()
pts_nbr = float(sts("dpts").text())
edge0 = edge0_check.isChecked()
makedwg = sts("mkdwg").isChecked()
a3 = a3_check.isChecked()
altlay = sts("altlayout").isChecked()
scale = float(sts("scale").text()) # ignored if autoscale is set
cartridge = cartridge_check.isChecked()
onedrawing = onedrawing_check.isChecked()
scale_auto = sts("autoscale").isChecked()
edge0 = sts("edge").checkedId() == -2
FreeCAD.Console.PrintMessage("UnrollRuledSurface.file_name: "+file_name+"\n")
a3 = sts("papersize").checkedId() == -3
FreeCAD.Console.PrintMessage("UnrollRuledSurface.pts_nbr: "+str(pts_nbr)+"\n")
cartridge = sts("cartridge").isChecked()
FreeCAD.Console.PrintMessage("UnrollRuledSurface.scale: "+str(scale)+"\n")
onedrawing = sts("groupdwg").isChecked()
FreeCAD.Console.PrintMessage("UnrollRuledSurface.scale_check: "+str(scale_auto)+"\n")

FreeCAD.Console.PrintMessage("UnrollRuledSurface.edge0_check: "+str(edge0)+"")
FreeCAD.Console.PrintMessage("UnrollRuledSurface.a3_check: "+str(a3)+"\n")
PrintMessage("UnrollRuledSurface.file_name: {}\n".format(file_name))
FreeCAD.Console.PrintMessage("UnrollRuledSurface.cartridge: "+str(cartridge)+"\n")
PrintMessage("UnrollRuledSurface.pts_nbr: {}\n".format(pts_nbr))
FreeCAD.Console.PrintMessage("UnrollRuledSurface.onedrawing: "+str(onedrawing)+"\n")
PrintMessage("UnrollRuledSurface.edge0: {}\n".format(edge0))
PrintMessage("UnrollRuledSurface.makedwg: {}\n".format(makedwg))
except:
msg="UnrollRuledSurface: wrong inputs...\n"
PrintMessage("UnrollRuledSurface.altlay: {}\n".format(altlay))
PrintMessage("UnrollRuledSurface.scale_check: {}\n".format(scale_auto))
FreeCAD.Console.PrintError(msg)
PrintMessage("UnrollRuledSurface.scale: {}\n".format(scale))
errorDialog(msg)
PrintMessage("UnrollRuledSurface.a3_check: {}\n".format(a3))
PrintMessage("UnrollRuledSurface.cartridge: {}\n".format(cartridge))
PrintMessage("UnrollRuledSurface.onedrawing: {}\n".format(onedrawing))
except:
msg = "UnrollRuledSurface: wrong inputs...\n"
PrintError(msg)
errorDialog(msg)
QtGui.QApplication.restoreOverrideCursor()
DialogBox.hide()
ending()
return

QtGui.QApplication.restoreOverrideCursor()
DialogBox.hide()
unrollRS = unrollRuledSurface(file_name, pts_nbr, edge0)

## Get selection
sel = FreeCADGui.Selection.getSelection()
if not sel:
PrintMessage("UnrollRuledSurface: no selection...\n")
ending()
return

faceid = 0
objnames_l, objnames0_l = [], []
grp = FreeCAD.ActiveDocument.addObject("App::DocumentObjectGroup",
"{}_objs".format(file_name))

for objid, obji in enumerate(sel):
shape = obji.Shape
faces = shape.Faces
for idx in range(len(faces)):
msg = "UnrollRuledSurface.proceed: ObjId = {}, faceId = {}\n"
PrintMessage(msg.format(objid, faceid))
name = obji.Name
if len(faces) > 1:
name = "{}.face_{}".format(name, idx)
obj = unrollRS.unroll(faces[idx], name)
obj.ViewObject.Visibility = not makedwg
grp.addObject(obj)

objnames_l.append([obj, name])
objnames0_l.append([obji, name])
faceid += 1


if not makedwg:
ending()
return


if altlay:
draw = Drawing2dAlt(scale, scale_auto, a3)
n = 4 if onedrawing else 1
chunks = [objnames_l[i:i + n] for i in range(0, len(objnames_l), n)]
for i, chunk in enumerate(chunks, start=1):
draw.drawpage(chunk, "{}_page{:02}".format(file_name, i))

else:
idx = 0
while len(objnames_l) > 0:
draw = Drawing2d(scale, scale_auto, a3, cartridge, onedrawing,
"{}_page{:02}".format(file_name, idx))
objnames_l = draw.all2d(objnames_l)
idx += 1
msg = "UnrollRuledSurface: obj_l = {}\n"
PrintMessage(msg.format(len(objnames_l)))


QtGui.qApp.restoreOverrideCursor()
DialogBox.hide()
unrollRS=unrollRuledSurface( file_name , pts_nbr , edge0 )
#
# Get selection
#
sel=FreeCADGui.Selection.getSelection()
faceid=0
objnames_l=[]
objnames0_l=[]
grp=FreeCAD.activeDocument().addObject("App::DocumentObjectGroup", str(file_name)+"_objs")
for objid in range( sel.__len__() ):
shape=sel[objid].Shape
faces=shape.Faces
for id in range( faces.__len__() ):
FreeCAD.Console.PrintMessage("UnrollRuledSurface.proceed: ObjId= "+str(objid)+" , faceId= "+str( faceid )+"\n")
if faces.__len__() > 1:
name=sel[objid].Name+".faces "+str(id)
else:
name=sel[objid].Name
obj=unrollRS.unroll(faces[id],name)
obj.ViewObject.Visibility=False
grp.addObject(obj)
objnames_l.append( [ obj , name ] )
objnames0_l.append( [ sel[objid] , name ] )
faceid=faceid+1
id=0
while objnames_l.__len__() > 0:
draw=Drawing2d( scale, scale_auto , a3 , cartridge , onedrawing,str(file_name)+"_page"+str(id) )
objnames_l=draw.all( objnames_l )
id=id+1
FreeCAD.Console.PrintMessage("UnrollRuledSurface: obj_l= "+str(objnames_l.__len__())+"\n")


FreeCAD.Console.PrintMessage("UnrollRuledSurface: end.\n")
FreeCAD.Console.PrintMessage("===========================================\n")


#####################################
# Function close
#####################################
def close():
def close():
DialogBox.hide()
DialogBox.hide()

def getType(obj):
return type(obj).__name__



#####################################
# Class unrollRuledSurface
# - file_name : ouput file
# - pts_nbr : nbr point of
# discretization
#####################################
class unrollRuledSurface:
class unrollRuledSurface:
"""
def __init__( self, file_name, pts_nbr , edge0 ):
unroll ruled surfaces
self.doc = FreeCAD.activeDocument()
self.file_name = file_name
:file_name: ouput file
self.pts_nbr = int(pts_nbr)
:pts_nbr: nbr point of discretization
"""
self.edge0 = edge0
FreeCAD.Console.PrintMessage("UnrollRuledSurface.unroll - file_name: "+self.file_name+" , pts_nbr: "+str(self.pts_nbr)+"\n")
def __init__(self, file_name, pts_nbr, edge0):
self.doc = FreeCAD.ActiveDocument
self.file_name = file_name
self.pts_nbr = int(pts_nbr)
self.edge0 = edge0
msg = "UnrollRuledSurface.unroll - file_name: {}, pts_nbr: {}\n"
PrintMessage(msg.format(file_name, pts_nbr))




def discretize(self, curve):
#####################################
# Function discretize
"""discretize a curve"""
if getType(curve) in ('GeomLineSegment', 'GeomCircle'):
#####################################
def discretize(self,curve):
sd = curve.discretize(self.pts_nbr)
if type(curve).__name__=='GeomLineSegment':
elif getType(curve) == 'GeomBSplineCurve':
sd=curve.discretize( self.pts_nbr )
nodes = curve.getPoles()
spline = Part.BSplineCurve()
elif type(curve).__name__=='GeomBSplineCurve':
nodes=curve.getPoles()
spline.buildFromPoles(nodes)
spline=Part.BSplineCurve()
sd = spline.discretize(self.pts_nbr)
else:
spline.buildFromPoles( nodes )
sd=spline.discretize( self.pts_nbr )
sd = curve.discretize(self.pts_nbr)
return sd
elif type(curve).__name__=='GeomCircle':
sd=curve.discretize( self.pts_nbr )
else:
sd=curve.discretize( self.pts_nbr )
return sd


def nbpoles(self, curve):
#####################################
"""find number of poles for a curve"""
# Function nbpoles
if getType(curve) == 'GeomLineSegment':
#####################################
nbpol=1
def nbpoles(self,curve):
if type(curve).__name__=='GeomLineSegment':
elif getType(curve) == 'GeomBSplineCurve':
nbpol=1
nbpol=curve.NbPoles
elif type(curve).__name__=='GeomBSplineCurve':
elif getType(curve) == 'GeomCircle':
nbpol=curve.NbPoles
nbpol=2
elif type(curve).__name__=='GeomCircle':
elif getType(curve) == 'GeomBezierCurve':
nbpol=2
nbpol=4
else:
elif type(curve).__name__=='GeomBezierCurve':
nbpol=4
nbpol=0
else:
nbpol=0
FreeCAD.Console.PrintMessage("UnrollRulrdSurface.nbpole {:s} = {:d}\n".format(type(curve).__name__,nbpol))
return nbpol


msg = "UnrollRulrdSurface.nbpole {:s} = {:d}\n"
#####################################
PrintMessage(msg.format(getType(curve), nbpol))
# Function unroll
return nbpol
#####################################
# Unroll of a face
# composed of 2 or 4 edges
#####################################
def unroll(self,face,name):
FreeCAD.Console.PrintMessage("UnrollRuledSurface.unroll: Ege Nbr= "+str( face.Edges.__len__())+"\n")
if face.Edges.__len__() == 2:
e1=face.Edges[0]
e2=face.Edges[1]
sd1=e1.Curve.discretize( self.pts_nbr )
sd2=e2.Curve.discretize( self.pts_nbr )
elif face.Edges.__len__() == 3:
e1=face.Edges[0]
e2=face.Edges[2]
sd1=e1.Curve.discretize( self.pts_nbr )
sd2=e2.Curve.discretize( self.pts_nbr )
else:
E0=face.Edges[0]
E1=face.Edges[1]
E2=face.Edges[2]
E3=face.Edges[3]
#
# Choose more complexe curve as edge
#
nbpol0=self.nbpoles(E0.Curve)
nbpol1=self.nbpoles(E1.Curve)
nbpol2=self.nbpoles(E2.Curve)
nbpol3=self.nbpoles(E3.Curve)
FreeCAD.Console.PrintMessage("UnrollRuledSurface.unroll: nbpol0= {:d}, nbpol1= {:d}, nbpol2= {:d}, nbpol3= {:d}\n".format(nbpol0,nbpol1,nbpol2,nbpol3))


def unroll(self, face, name):
if self.edge0:
"""unrolls a face composed of 2 to 4 edges"""
e1=E0
e2=E2
nbredges = len(face.Edges)
v=self.discretize( E1 )
msg = "UnrollRuledSurface.unroll: Edge Nbr = {}\n"
PrintMessage(msg.format(nbredges))
v0=v[0]
v1=v[self.pts_nbr-1]
else:
e1=E1
e2=E3
v=self.discretize( E2 )
v0=v[0]
v1=v[self.pts_nbr-1]


if nbredges == 2:
sd1=self.discretize( e1 )
sd2=self.discretize( e2 )
e1, e2 = face.Edges
sd1 = e1.Curve.discretize(self.pts_nbr)
#
sd2 = e2.Curve.discretize(self.pts_nbr)
# Reverse if curves cross over
#
if not ( sd2[0].__eq__( v0 ) or not sd2[0].__eq__( v1 ) ):
sd2.reverse()


elif nbredges == 3:
#
e1, _, e2 = face.Edges
# Create a polygon object and set its nodes
sd1 = e1.Curve.discretize(self.pts_nbr)
#
sd2 = e2.Curve.discretize(self.pts_nbr)
devlxy_l=self.devlxyz( sd1 , sd2 )
FreeCAD.Console.PrintMessage("UnrollRuledSurface.unroll: size devlxy_l: "+str( devlxy_l.__len__())+"\n")
p=self.doc.addObject("Part::Polygon",name)
p.Nodes=devlxy_l
self.doc.recompute()
FreeCADGui.SendMsgToActiveView("ViewFit")
return p


else:
#####################################
E0, E1, E2, E3, *_ = face.Edges
# Function vect_copy
# Choose more complexe curve as edge
# - vect:
nbpol0 = self.nbpoles(E0.Curve)
# - return copy of vector
nbpol1 = self.nbpoles(E1.Curve)
#####################################
nbpol2 = self.nbpoles(E2.Curve)
def vect_copy( self, vect):
nbpol3 = self.nbpoles(E3.Curve)
v= vect.add( FreeCAD.Base.Vector(0,0,0) )
msg = ("UnrollRuledSurface.unroll: nbpol0= {:d}, nbpol1= {:d},"
return v
" nbpol2= {:d}, nbpol3= {:d}\n")
PrintMessage(msg.format(nbpol0, nbpol1, nbpol2, nbpol3))


if self.edge0:
#####################################
e1, e2 = E0, E2
# Function vect_cos
v = self.discretize(E1)
# - vect1,2:
v0, v1 = v[0], v[self.pts_nbr-1]
# - return cos angle between
# 2 vectors
else:
e1, e2 = E1, E3
#####################################
v = self.discretize(E2)
def vect_cos( self , vect1, vect2 ):
v0, v1 = v[0], v[self.pts_nbr-1]
cosalp=vect1.dot(vect2)/vect1.Length/vect2.Length
return cosalp
#####################################
# Function vect_sin
# - vect1,2:
# - return abs(sin) angle between
# 2 vectors
#####################################
def vect_sin( self , vect1, vect2 ):
v= FreeCAD.Base.Vector(0,0,0)
v.x=vect1.y*vect2.z-vect1.z*vect2.y
v.y=vect1.z*vect2.x-vect1.x*vect2.z
v.z=vect1.x*vect2.y-vect1.y*vect2.x
sinalp=v.Length/vect1.Length/vect2.Length
return sinalp


sd1 = self.discretize(e1)
sd2 = self.discretize(e2)
#####################################
# Reverse if curves cross over
# Function devlxyz
if not (sd2[0].__eq__(v0) or not sd2[0].__eq__(v1)):
# - vect1,2: 2 edges of the shape
# - return dvlxy_l
sd2.reverse()
#####################################
# unroll of a face
# composed of 4 edges
#####################################
def devlxyz( self , vect1 , vect2 ):
#
# Init
#
if ( vect1.__len__() != vect2.__len__()) or ( vect1.__len__() != self.pts_nbr ) or ( vect2.__len__() != self.pts_nbr ):
msg="UnrollRuledSurface.devlxyz: incompatility of sizes vect1 , vect2, pts_nbr- "+str( vect1.__len__())+" , "+str( vect2.__len__())+" , "+str( self.pts_nbr )+"\n"
FreeCAD.Console.PrintError(msg)
errorDialog(msg)


# Create a polygon object and set its nodes
devlxy_l=[]
devlxy_l = self.devlxyz(sd1, sd2)
devl1xy_l=[]
msg = "UnrollRuledSurface.unroll: size devlxy_l: {}\n"
devl2xy_l=[]
PrintMessage(msg.format(len(devlxy_l)))
errormax=0.0
p = self.doc.addObject("Part::Polygon", name)
#
p.Nodes = devlxy_l
# Init unroll
self.doc.recompute()
# AB
FreeCADGui.ActiveDocument.ActiveView.fitAll()
#
return p
a1b1=vect2[0].sub(vect1[0])
oa1=FreeCAD.Vector(0,0,0)
devl1xy_l.append( oa1 ) #A1
ob1=FreeCAD.Vector(a1b1.Length,0,0)
devl2xy_l.append( ob1 ) #B1
#self.draw_line( devl1xy_l[0] , devl2xy_l[0] )
#self.draw_line( vect1[0] , vect2[0] )
for j in range( 1 , self.pts_nbr ) :
#
# AB
#
ab=vect2[j-1].sub(vect1[j-1])
#self.draw_line( vect1[j-1] , vect2[j-1] )
#
# AC
#
ac=vect1[j].sub(vect1[j-1])
#
# BD
#
bd=vect2[j].sub(vect2[j-1])
#
# CD
#
cd=vect2[j].sub(vect1[j])
#
# A1B1 in unroll plan
#
a1b1=devl2xy_l[j-1].sub(devl1xy_l[j-1])
a1b1n=self.vect_copy(a1b1)
a1b1n.normalize()
a1b1on=FreeCAD.Vector(-a1b1n.y,a1b1n.x,0)
#
# A1C1
#
cosalp=self.vect_cos( ab , ac )
sinalp=self.vect_sin( ab , ac )
a1c1=self.vect_copy(a1b1n)
a1c1.multiply(cosalp*ac.Length)
v=self.vect_copy(a1b1on)
v.multiply(sinalp*ac.Length)
a1c1=a1c1.add(v)
#FreeCAD.Console.PrintMessage("UnrollRuledSurface.alp a1b1: "+str(a1b1n.getAngle(a1b1on))+"\n")
#FreeCAD.Console.PrintMessage("UnrollRuledSurface.alp oc1: "+str(a1b1n.getAngle(a1c1)-alp)+"\n")
#FreeCAD.Console.PrintMessage("UnrollRuledSurface.length oc1: "+str(a1c1.Length-ac.Length)+"\n")
oa1=self.vect_copy(devl1xy_l[j-1])
oc1=oa1.add(a1c1)
devl1xy_l.append(oc1)
#
# B1D1
#
cosalp=self.vect_cos( ab , bd )
sinalp=self.vect_sin( ab , bd )
b1d1=self.vect_copy(a1b1n)
b1d1.multiply(cosalp*bd.Length)
v=self.vect_copy(a1b1on)
v.multiply(sinalp*bd.Length)
b1d1=b1d1.add(v)
#FreeCAD.Console.PrintMessage("UnrollRuledSurface.alp od1: "+str(b1a1n.getAngle(b1d1)-alp)+"\n")
#FreeCAD.Console.PrintMessage("UnrollRuledSurface.length od1: "+str(b1d1.Length-bd.Length)+"\n")
ob1=self.vect_copy(devl2xy_l[j-1])
od1=ob1.add(b1d1)
devl2xy_l.append(od1)
#
# Draw generatrice
#
#self.draw_line( devl1xy_l[j] , devl2xy_l[j] )
c1d1=devl2xy_l[j].sub( devl1xy_l[j] )
if ab.Length <> 0 :
errormax=max(errormax,math.fabs(ab.Length-c1d1.Length)/ab.Length)
#
# The end
#
FreeCAD.Console.PrintMessage("UnrollRuledSurface Error cd,c1d1: {:.1f} %\n".format(errormax*100))


def vect_copy(self, vect):
#
"""returns copy of vector"""
# Close polygone
return vect.add(Vector())
#
devlxy_l = devl1xy_l
devl2xy_l.reverse()
devlxy_l.extend( devl2xy_l )
v=FreeCAD.Vector(0,0,0)
devlxy_l.append( v )


def vect_cos(self, vect1, vect2):
return devlxy_l
"""returns cosine angle between 2 vectors"""
return vect1.dot(vect2) / vect1.Length / vect2.Length


def vect_sin(self, vect1, vect2):
"""returns absolute sinus angle between 2 vectors"""
v = Vector()
v.x = vect1.y * vect2.z - vect1.z * vect2.y
v.y = vect1.z * vect2.x - vect1.x * vect2.z
v.z = vect1.x * vect2.y - vect1.y * vect2.x
return v.Length / vect1.Length / vect2.Length


def devlxyz(self, vect1, vect2):
#####################################
"""
# Function draw_line
unrolls a face composed of 4 edges
# - vect0,1: two points
args: vect1, vect2 --> 2 edges of the shape
#####################################
returns: dvlxy
def draw_line( self , vect0 , vect1 ):
l=Part.Line()
"""
lenv1, lenv2 = len(vect1), len(vect2)
l.StartPoint=vect0
if lenv1 != lenv2 or lenv1 != self.pts_nbr or lenv2 != self.pts_nbr:
l.EndPoint=vect1
msg = ("UnrollRuledSurface.devlxyz: incompatility of sizes vect1,"
self.doc.addObject("Part::Feature","Line").Shape=l.toShape()
" vect2, pts_nbr: ({}, {}, {})\n")
PrintError(msg.format(lenv1, lenv2, self.pts_nbr))
errorDialog(msg)


devlxy_l, devl1xy_l, devl2xy_l = [], [], []
errormax = 0.0
# Init unroll
# AB
a1b1 = vect2[0].sub(vect1[0])
oa1 = Vector(0, 0, 0)
devl1xy_l.append(oa1) #A1
ob1 = Vector(a1b1.Length, 0, 0)
devl2xy_l.append(ob1) #B1
#self.draw_line(devl1xy_l[0], devl2xy_l[0])
#self.draw_line(vect1[0], vect2[0])
for j in range(1, self.pts_nbr):


# AB
#####################################
ab = vect2[j-1].sub(vect1[j-1])
# Class Drawing2d
#self.draw_line(vect1[j-1], vect2[j-1])
# -obj_l: listes of object
# -topxh1
# -topyh1
# -topxv1
# -topyv1
# -topxvmax1
# -topyvmax1
# -topxvmax1
# -topyvmax1
#####################################
class Drawing2d:
#####################################
# Function __init__
# - Scale
# - scale_auto
# - a3
# - cartridge
# - onedrawing
#####################################
def __init__( self, scale , scale_auto , a3 , cartridge , onedrawing , page_str ):
self.TopX_H=0
self.TopY_H=0
self.TopX_V=0
self.TopY_V=0
self.TopX_Hmax=0
self.TopY_Hmax=0
self.TopX_Vmax=0
self.TopY_Vmax=0
self.a3=a3
self.scale=scale
self.scale_auto=scale_auto
self.cartridge=cartridge
self.onedrawing=onedrawing
if self.a3:
self.L=420
self.H=297
self.marge=6
else:
self.L=297
self.H=210
self.marge=6
self.name=page_str


# AC
#####################################
ac = vect1[j].sub(vect1[j-1])
# Function newPage

#####################################
# BD
def newPage( self ):
bd = vect2[j].sub(vect2[j-1])
freecad_dir=os.getenv('HOME')+"/.FreeCAD/Mod/unrollRuledSurface"

page = FreeCAD.activeDocument().addObject('Drawing::FeaturePage', self.name )
if self.a3:
# CD
if self.cartridge:
cd = vect2[j].sub(vect1[j])

page.Template = freecad_dir+'/A3_Landscape.svg'
# A1B1 in unroll plan
a1b1 = devl2xy_l[j-1].sub(devl1xy_l[j-1])
a1b1n = self.vect_copy(a1b1)
a1b1n.normalize()
a1b1on = Vector(-a1b1n.y, a1b1n.x, 0)

# A1C1
cosalp = self.vect_cos(ab, ac)
sinalp = self.vect_sin(ab, ac)
a1c1 = self.vect_copy(a1b1n)
a1c1.multiply(cosalp * ac.Length)
v = self.vect_copy(a1b1on)
v.multiply(sinalp * ac.Length)
a1c1 = a1c1.add(v)
oa1 = self.vect_copy(devl1xy_l[j-1])
oc1 = oa1.add(a1c1)
devl1xy_l.append(oc1)

# B1D1
cosalp = self.vect_cos(ab, bd)
sinalp = self.vect_sin(ab, bd)
b1d1 = self.vect_copy(a1b1n)
b1d1.multiply(cosalp * bd.Length)
v = self.vect_copy(a1b1on)
v.multiply(sinalp * bd.Length)
b1d1 = b1d1.add(v)
ob1 = self.vect_copy(devl2xy_l[j-1])
od1 = ob1.add(b1d1)
devl2xy_l.append(od1)

# Draw generatrice
#self.draw_line(devl1xy_l[j], devl2xy_l[j])
c1d1 = devl2xy_l[j].sub(devl1xy_l[j])
if ab.Length != 0:
abl = ab.Length
errormax = max(errormax, abs(abl - c1d1.Length) / abl)

msg = "UnrollRuledSurface Error cd,c1d1: {:.1f} %\n"
PrintMessage(msg.format(errormax*100))

# Close polygone
devlxy_l = devl1xy_l
devl2xy_l.reverse()
devlxy_l.extend(devl2xy_l)
v = Vector()
devlxy_l.append(v)

return devlxy_l


def draw_line(self, vect0, vect1):
"""draws a Part.Line between vect0 & vect1"""
l = Part.LineSegment()
l.StartPoint = vect0
l.EndPoint = vect1
self.doc.addObject("Part::Feature", "Line").Shape = l.toShape()


class Scale:
"""keeps autoscaling to known integers"""
def __init__(self, scale):
self.scale = scale if scale >= 1 else 1 / scale
self.scale = int(self.scale)
self.inverted = scale >= 1

def get(self):
if self.inverted:
return self.scale, '{}:1'.format(self.scale)
else:
else:
return 1/self.scale, '1:{}'.format(self.scale)
page.Template = freecad_dir+'/A3_Landscape_Empty.svg'

else:

if self.cartridge:
class Drawing2dAlt:
page.Template = freecad_dir+'/A4_Landscape.svg'
"""
Alternative layout engine (Drawing wb), only does plain templates.
not much testing done, not perfect, however probably good enough...
makes 2d drawing with Drawing wb
- obj_l: list of objects
"""
# untouched in v1.1
def __init__(self, scale, scale_auto, a3):

self.a3 = a3
self.scale = scale
self.scale_auto = scale_auto
if self.a3:
self.WH = 420, 297
else:
else:
page.Template = freecad_dir+'/A4_Landscape_Empty.svg'
self.WH = 297, 210
return page




def _mkquadrants(self, nbr):
#####################################
"""lower lefts w/o margin"""
# Function all
w, h = self.WH
#####################################
def all( self, objname_l ):
w2, h2 = w/2, h/2
obj1_l=[]
d = (w**2 + h**2)**(1/2)
for objid in range( objname_l.__len__() ):
if objid == 0 or not self.onedrawing:
page = self.newPage()
obj1_l.extend( self.done( objid , objname_l[objid] ))
return obj1_l


q = {1: [[w, h, d], [[0, h]]],
#####################################
2: [[w2, h, d/2], [[0, h], [w2, h]]],
# Function all
3: [[w2, h2, d/4], [[0, h2], [w2, h2], [0, h]]],
#####################################
4: [[w2, h2, d/4], [[0, h2], [w2, h2], [0, h], [w2, h]]]}
def done( self, id , objname ):
return q.get(nbr)
#
# Init
#
obj_l=[]
obj=objname[0]
objname=objname[1]
xmax=obj.Shape.BoundBox.XMax-obj.Shape.BoundBox.XMin
ymax=obj.Shape.BoundBox.YMax-obj.Shape.BoundBox.YMin
if ymax > xmax :
Draft.rotate( obj , 90 )
Draft.move( obj , FreeCAD.Base.Vector( -obj.Shape.BoundBox.XMin , -obj.Shape.BoundBox.YMin , 0))
xmax=obj.Shape.BoundBox.XMax-obj.Shape.BoundBox.XMin
ymax=obj.Shape.BoundBox.YMax-obj.Shape.BoundBox.YMin


scale=min((self.L-4*self.marge)/xmax,(self.H-4*self.marge)/ymax)


def newPage(self, doc, page_name):
if ( not self.scale_auto ) or ( self.onedrawing ) :
freecad_dir = os.path.join(FreeCAD.getResourceDir(), dwgtpl)
scale=self.scale
page = doc.addObject('Drawing::FeaturePage', page_name)
size = 'A3' if self.a3 else 'A4'
page.Template = freecad_dir + '/{}_Landscape_plain.svg'.format(size)
return page


FreeCAD.Console.PrintMessage("UnrollRuledSurface.drawing: scale= {:.2f}\n".format(scale))


def drawpage(self, faces, page_name):
if id == 0 or not self.onedrawing:
"""max 4 per page, simple layout with halfs or quadrants"""
#
doc = FreeCAD.ActiveDocument
# Init
page = self.newPage(doc, page_name)
#
fontsize = 5 if self.a3 else 7
FreeCAD.Console.PrintMessage("Dawing2d: init\n")
self.TopX_H=self.marge*2
[W, H, D], ll = self._mkquadrants(len(faces))
for [face, name], [x0, y0] in zip(faces, ll):
self.TopY_H=self.marge*2
TopX=self.TopX_H
bb = face.Shape.BoundBox
aspect = max(bb.XLength / bb.YLength, bb.YLength / bb.XLength)
TopY=self.TopY_H
adjusted = max(W / H, H / W) / aspect
self.TopX_H=self.TopX_H + xmax * scale + self.marge
self.TopY_H=self.TopY_H
self.TopX_Hmax=max( self.TopX_Hmax , self.TopX_H )
self.TopY_Hmax=max( self.TopY_Hmax , self.TopY_H + ymax*scale+self.marge )
self.TopX_Vmax=max( self.TopX_Vmax , self.TopX_Hmax )
self.TopX_V=max(self.TopX_Vmax,self.TopX_V)
self.TopY_V=self.marge*2
elif self.onedrawing:
if self.TopX_H + xmax * scale < self.L :
if self.TopY_H + ymax * scale + self.marge*2 < self.H :
#
# H Add at right on same horizontal line
#
FreeCAD.Console.PrintMessage("Dawing2d: horizontal\n")
TopX=self.TopX_H
TopY=self.TopY_H
self.TopX_H=self.TopX_H + xmax * scale + self.marge
self.TopX_Hmax=max( self.TopX_Hmax , self.TopX_H )
self.TopY_Hmax=max( self.TopY_Hmax , self.TopY_H + ymax*scale+self.marge )
self.TopX_Vmax=max( self.TopX_Hmax , self.TopX_Vmax )
self.TopX_Vmax=max( self.TopX_Vmax , self.TopX_Hmax )
self.TopX_V=max(self.TopX_Vmax,self.TopX_V)
else:
#
# V Add at right on same horizontal line
#
FreeCAD.Console.PrintMessage("Dawing2d: vertival\n")
if self.TopX_V + ymax * scale +2* self.marge < self.L and self.TopY_V + xmax * scale + 2*self.marge < self.H :
Draft.rotate( obj , 90 )
Draft.move( obj , FreeCAD.Base.Vector( -obj.Shape.BoundBox.XMin , -obj.Shape.BoundBox.YMin , 0))
x0=xmax;xmax=ymax,ymax=x0
self.TopX_V=max(self.TopX_Vmax, self.TopX_V)
TopX=self.TopX_V
TopY=self.TopY_V
self.TopX_V = self.TopX_V + xmax * scale + self.marge
self.TopY_Vmax=max( self.TopY_Vmax , self.TopY_V + ymax * scale + self.marge )
else:
obj_l.append( [ obj , name ] )
return obj_l


else:
if self.scale_auto:
scale = D / (bb.DiagonalLength * adjusted)
#
else:
# H Carriage return
scale = self.scale
#
if ( self.TopY_Hmax + ymax * scale + self.marge*2 < self.H ):
sc, scr = Scale(scale * 0.95).get()
FreeCAD.Console.PrintMessage("Dawing2d: carriage return: "+str(self.TopY_H + ymax * scale )+" > "+str(self.H)+"\n")
TopX=self.marge*2
TopY=self.TopY_Hmax
self.TopX_H=TopX + xmax * scale + self.marge
self.TopY_H=TopY
self.TopX_Hmax=max( self.TopX_Hmax , self.TopX_H )
self.TopY_Hmax=self.TopY_Hmax + ymax*scale+self.marge
self.TopX_Vmax=max( self.TopX_Vmax , self.TopX_Hmax )
self.TopX_V=max(self.TopX_Vmax,self.TopX_V)
else:
#
# V Add at right on same horizontal line
#
FreeCAD.Console.PrintMessage("Dawing2d: vertival: "+str(self.TopX_V)+" , "+str(self.TopX_Vmax)+"\n")
if self.TopX_V + ymax * scale + 2*self.marge < self.L and self.TopY_V + xmax * scale + 2*self.marge < self.H :
Draft.rotate( obj , 90 )
Draft.move( obj , FreeCAD.Base.Vector( -obj.Shape.BoundBox.XMin , -obj.Shape.BoundBox.YMin , 0))
x0=xmax;xmax=ymax,ymax=x0
TopX=self.TopX_V
TopY=self.TopY_V
self.TopX_V = self.TopX_V + xmax * scale + self.marge
self.TopY_Vmax=max( self.TopY_Vmax , self.TopY_V + ymax * scale + self.marge )
else:
obj_l.append( [ obj , objname ] )
return obj_l


dx = (W - bb.XLength * sc) / 2
page=FreeCAD.activeDocument().getObject(self.name )
dy = (H - bb.YLength * sc) / 2
dyt = dy - fontsize * 2 if dy > fontsize else dy


Text=FreeCAD.activeDocument().addObject('Drawing::FeatureViewAnnotation', objname+"_txt")
Text = doc.addObject('Drawing::FeatureViewAnnotation', f"{name}_txt")
Text.Text=objname
Text.Text = '{} [{}]'.format(name, scr)
Text.X=TopX+xmax*scale/2
Text.X = int(x0 + dx + fontsize / 2)
Text.Y=TopY+ymax*scale/2
Text.Y = int(y0 - dyt - fontsize / 2)
Text.Scale=2
Text.Scale = fontsize


TopView = FreeCAD.activeDocument().addObject('Drawing::FeatureViewPart',objname)
TopView = doc.addObject('Drawing::FeatureViewPart', name)
TopView.Source = obj
TopView.Source = face
TopView.Direction = (0.0,0.0,1)
TopView.Direction = (0, 0, 1)
TopView.Rotation = 0
TopView.Rotation = 0
TopView.X = TopX
TopView.X = int(x0 + dx)
TopView.Y = TopY
TopView.Y = int(y0 - dy)
TopView.ShowHiddenLines = False
TopView.ShowHiddenLines = False
TopView.Scale = scale
TopView.Scale = sc
page.addObject(TopView)
page.addObject(TopView)
page.addObject(Text)
page.addObject(Text)

FreeCAD.activeDocument().recompute()
doc.recompute()
return obj_l
page.ViewObject.doubleClicked()


class Drawing2d:
"""
makes 2d drawing with Drawing wb (original layout engine)
- obj_l: list of objects
"""
# untouched in v1.1
def __init__(self, scale, scale_auto, a3, cartridge, onedrawing, page_str):
self.TopX_H = self.TopY_H = 0
self.TopX_V = self.TopY_V = 0
self.TopX_Hmax = self.TopY_Hmax = 0
self.TopX_Vmax = self.TopY_Vmax = 0
self.a3 = a3
self.scale = scale
self.scale_auto = scale_auto
self.cartridge = cartridge
self.onedrawing = onedrawing
self.marge = 6
if self.a3:
self.L, self.H = 420, 297
else:
self.L, self.H = 297, 210
self.name = page_str

def newPage(self):
freecad_dir = os.path.join(FreeCAD.getResourceDir(), dwgtpl)
doc = FreeCAD.ActiveDocument
page = doc.addObject('Drawing::FeaturePage', self.name)
size = 'A3' if self.a3 else 'A4'
frame = '' if self.cartridge else '_plain'
page.Template = freecad_dir + '/{}_Landscape{}.svg'.format(size, frame)
return page


def all2d(self, objname_l):
obj1_l = []
for objid in range(len(objname_l)):
if objid == 0 or not self.onedrawing:
page = self.newPage()
obj1_l.extend(self.done(objid, objname_l[objid]))
return obj1_l

def done(self, idx, objname):
obj_l = []
obj, objname = objname
marge = self.marge
bb = obj.Shape.BoundBox
xmax = bb.XMax - bb.XMin
ymax = bb.YMax - bb.YMin

if ymax > xmax:
Draft.rotate(obj, 90)
Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
xmax = bb.XMax - bb.XMin
ymax = bb.YMax - bb.YMin

scale = min((self.L-4 * marge) / xmax, (self.H-4 * marge) / ymax)

if (not self.scale_auto) or self.onedrawing:
scale = self.scale

PrintMessage("UnrollRuledSurface.drawing: scale= {:.2f}\n".format(scale))


if idx == 0 or not self.onedrawing:
PrintMessage("Dawing2d: init\n")
TopX = self.TopX_H = marge * 2
TopY = self.TopY_H = marge * 2
self.TopX_H = self.TopX_H + xmax * scale + marge
self.TopY_H = self.TopY_H
self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
self.TopY_Hmax = max(self.TopY_Hmax,
self.TopY_H + ymax * scale + marge)
self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
self.TopX_V = max(self.TopX_Vmax, self.TopX_V)
self.TopY_V = marge * 2

elif self.onedrawing:
if self.TopX_H + xmax * scale < self.L:
if self.TopY_H + ymax * scale + marge * 2 < self.H:
# H Add at right on same horizontal line
PrintMessage("Dawing2d: horizontal\n")
TopX, TopY = self.TopX_H, self.TopY_H
self.TopX_H = self.TopX_H + xmax * scale + marge
self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
self.TopY_Hmax = max(self.TopY_Hmax,
self.TopY_H + ymax * scale + marge)
self.TopX_Vmax = max(self.TopX_Hmax, self.TopX_Vmax)
self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
self.TopX_V = max(self.TopX_Vmax, self.TopX_V)

else:
# V Add at right on same horizontal line
PrintMessage("Dawing2d: vertival\n")
if (self.TopX_V + ymax * scale + 2 * marge < self.L
and self.TopY_V + xmax * scale + 2 * marge < self.H):
Draft.rotate(obj, 90)
Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
x0 = xmax; xmax = ymax; ymax = x0
self.TopX_V = max(self.TopX_Vmax, self.TopX_V)
TopX, TopY = self.TopX_V, self.TopY_V
self.TopX_V = self.TopX_V + xmax * scale + marge
self.TopY_Vmax = max(self.TopY_Vmax,
self.TopY_V + ymax * scale + marge)

else:
obj_l.append([obj, self.name])
return obj_l

else:
# H Carriage return
if self.TopY_Hmax + ymax * scale + self.marge*2 < self.H:
msg = "Drawing2d: carriage return: {} > {}\n"
PrintMessage(msg.format(self.TopY_H + ymax * scale, self.H))
TopX = self.marge * 2
TopY = self.TopY_Hmax
self.TopX_H = TopX + xmax * scale + self.marge
self.TopY_H = TopY
self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
self.TopY_Hmax = self.TopY_Hmax + ymax * scale + self.marge
self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
self.TopX_V = max(self.TopX_Vmax, self.TopX_V)

else:
# V Add at right on same horizontal line
msg = "Drawing2d: vertival: {} , {}\n"
PrintMessage(msg.format(self.TopX_V, self.TopX_Vmax))
if (self.TopX_V + ymax * scale + 2 * marge < self.L
and self.TopY_V + xmax * scale + 2 * marge < self.H):
Draft.rotate(obj, 90)
Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
x0 = xmax; xmax = ymax; ymax = x0
TopX, TopY = self.TopX_V, self.TopY_V
self.TopX_V = self.TopX_V + xmax * scale + marge
self.TopY_Vmax = max(self.TopY_Vmax,
self.TopY_V + ymax * scale + marge)

else:
obj_l.append([obj, objname])
return obj_l

doc = FreeCAD.ActiveDocument
page = doc.getObject(self.name)

Text = doc.addObject('Drawing::FeatureViewAnnotation', f"{objname}_txt")
Text.Text = objname
Text.X = TopX + xmax * scale / 2
Text.Y = TopY + ymax * scale / 2
Text.Scale = 2

TopView = doc.addObject('Drawing::FeatureViewPart', objname)
TopView.Source = obj
TopView.Direction = (0, 0, 1)
TopView.Rotation = 0
TopView.X = TopX
TopView.Y = TopY
TopView.ShowHiddenLines = False
TopView.Scale = scale
page.addObject(TopView)
page.addObject(Text)
doc.recompute()
return obj_l




Line 651: Line 718:


#####################################
#####################################
### Dialog Box
#####################################
#####################################
# Dialog Box
#####################################
#####################################
fields = [[ "File Name" , "UnrollSurface" ]]
fields.append(["Dicretization Points Nbr","100" ])
fields.append(["Scale","1" ])


DialogBox = QtGui.QDialog()
DialogBox = QtGui.QDialog()
DialogBox.resize(250,250)
DialogBox.setWindowTitle("UnrollRuledSurface")
DialogBox.setWindowTitle("UnrollRuledSurface")
la = QtGui.QVBoxLayout(DialogBox)
la = QtGui.QGridLayout(DialogBox)
la.setSpacing(7)
buttonGrp1 = QtGui.QButtonGroup(DialogBox)
buttonGrp2 = QtGui.QButtonGroup(DialogBox)
buttonGrpEdge = QtGui.QButtonGroup(DialogBox)
buttonGrpFormat = QtGui.QButtonGroup(DialogBox)


cols = 4
#
la.addWidget(QtGui.QLabel("File Name"), 0, 0, 1, cols)
# Input fields
fname = QtGui.QLineEdit("UnrollSurface")
#
la.addWidget(fname, 1, 0, 1, cols)
for id in range(len( fields )):
la.addWidget(QtGui.QLabel( fields[ id ][ 0 ] ))
fields_l.append( QtGui.QLineEdit( fields[ id ][ 1 ] ))
la.addWidget( fields_l[ id ] )


la.addWidget(QtGui.QLabel("Discretization Points Nbr"), 2, 0, 1, cols)
scale_check = QtGui.QCheckBox( DialogBox )
dpts = QtGui.QLineEdit("30")
scale_check.setObjectName("checkBox")
la.addWidget(dpts, 3, 0, 1, 2)
scale_check.setChecked(True)
la.addWidget(QtGui.QLabel("Scale auto"))
la.addWidget(scale_check)


###
line3 = QtGui.QFrame(DialogBox)
la.addWidget(QtGui.QLabel("Generatrices from edge:"), 4, 0, 1, 2)
line3.setFrameShape(QtGui.QFrame.HLine)
edgezero = QtGui.QRadioButton("0 to 3")
line3.setFrameShadow(QtGui.QFrame.Sunken)
la.addWidget(line3)
la.addWidget(edgezero, 4, 2)
edgeone = QtGui.QRadioButton("1 to 4")
la.addWidget(edgeone, 4, 3)
buttonGrpEdge.addButton(edgezero); buttonGrpEdge.addButton(edgeone)
edgezero.setChecked(True)


###
edge0_check = QtGui.QRadioButton( DialogBox )
mkdwg = QtGui.QCheckBox("Make drawing")
la.addWidget(QtGui.QLabel("Generatrices from edge 1 to 4" ))
edge0_check.setChecked(False)
mkdwg.setChecked(True)
la.addWidget(edge0_check)
la.addWidget(mkdwg, 5, 0, 1, 2)
edge1_check = QtGui.QRadioButton( DialogBox )
la.addWidget(QtGui.QLabel("Generatrices from edge 0 to 3" ))
edge1_check.setChecked(True)
buttonGrp1.addButton(edge0_check)
buttonGrp1.addButton(edge1_check)
la.addWidget(edge1_check)


line4 = QtGui.QFrame(DialogBox)
altlayout = QtGui.QCheckBox("Alternative layout")
altlayout.setChecked(True)
line4.setFrameShape(QtGui.QFrame.HLine)
la.addWidget(altlayout, 5, 2, 1, 2)
line4.setFrameShadow(QtGui.QFrame.Sunken)
la.addWidget(line4)


a3_check = QtGui.QRadioButton( DialogBox )
la.addWidget(QtGui.QLabel("A3" ))
a3_check.setChecked(False)
la.addWidget(a3_check)
a4_check = QtGui.QRadioButton( DialogBox )
la.addWidget(QtGui.QLabel("A4"))
a4_check.setChecked(True)
buttonGrp2.addButton(a3_check)
buttonGrp2.addButton(a4_check)
la.addWidget(a4_check)


###
cartridge_check = QtGui.QCheckBox( DialogBox )
autoscale = QtGui.QCheckBox("Auto scale")
cartridge_check.setObjectName("checkBox")
autoscale.setChecked(True)
la.addWidget(QtGui.QLabel("Cartridge"))
la.addWidget(autoscale, 6, 0, 1, 2)
cartridge_check.setChecked(False)
la.addWidget(cartridge_check)


la.addWidget(QtGui.QLabel("Scale"), 6, 2)
line6 = QtGui.QFrame(DialogBox)
scale = QtGui.QLineEdit("1")
line6.setFrameShape(QtGui.QFrame.HLine)
la.addWidget(scale, 6, 3)
line6.setFrameShadow(QtGui.QFrame.Sunken)
la.addWidget(line6)


###
onedrawing_check = QtGui.QCheckBox( DialogBox )
la.addWidget(QtGui.QLabel("Paper size:"), 7, 0, 1, 2)
onedrawing_check.setObjectName("checkBox")
rba4 = QtGui.QRadioButton("A4")
la.addWidget(QtGui.QLabel("Group drawings in page"))
la.addWidget(rba4, 7, 2)
onedrawing_check.setChecked(True)
rba3 = QtGui.QRadioButton("A3")
la.addWidget(onedrawing_check)
la.addWidget(rba3, 7, 3)
buttonGrpFormat.addButton(rba4); buttonGrpFormat.addButton(rba3)
rba4.setChecked(True)


###
line7 = QtGui.QFrame(DialogBox)
cartridge = QtGui.QCheckBox("Cartridge")
line7.setFrameShape(QtGui.QFrame.HLine)
cartridge.setChecked(True)
line7.setFrameShadow(QtGui.QFrame.Sunken)
la.addWidget(line7)
la.addWidget(cartridge, 8, 0, 1, 2)


groupdwg = QtGui.QCheckBox("Group drawings in page")
groupdwg.setChecked(True)
la.addWidget(groupdwg, 8, 2, 1, 2)

###
box = QtGui.QDialogButtonBox(DialogBox)
box = QtGui.QDialogButtonBox(DialogBox)
box.setOrientation(QtCore.Qt.Horizontal)
box.setOrientation(QtCore.Qt.Horizontal)
box.setStandardButtons(QtGui.QDialogButtonBox.Cancel.__or__(QtGui.QDialogButtonBox.Ok))
box.setStandardButtons(QtGui.QDialogButtonBox.Cancel|QtGui.QDialogButtonBox.Ok)
la.addWidget(box)
la.addWidget(box, 9, 0, 1, cols)


###
QtCore.QObject.connect(box, QtCore.SIGNAL("accepted()"), proceed )
settings.update(dict(fname=fname, dpts=dpts, edge=buttonGrpEdge,
QtCore.QObject.connect(box, QtCore.SIGNAL("rejected()"), close )
mkdwg=mkdwg, altlayout=altlayout,
autoscale=autoscale, scale=scale,
papersize=buttonGrpFormat,
cartridge=cartridge, groupdwg=groupdwg))

QtCore.QObject.connect(box, QtCore.SIGNAL("accepted()"), proceed)
QtCore.QObject.connect(box, QtCore.SIGNAL("rejected()"), close)
QtCore.QMetaObject.connectSlotsByName(DialogBox)
QtCore.QMetaObject.connectSlotsByName(DialogBox)
DialogBox.show()
DialogBox.show()


</pre>
}}

{{clear}}
{{clear}}

Revision as of 06:13, 24 July 2022

Macro Unroll Ruled Surface

Description
The macro allows to unroll ruled surfaces and to draw them on a page.

Macro version: 1.1
Last modified: 2022-07-24
Download: ToolBar icon
Author: Hervé B., heda
Author
Hervé B., heda
Download
ToolBar icon
Links
Macro Version
1.1
Date last modified
2022-07-24
FreeCAD Version(s)
None
Default shortcut
None
See also
None

Description

The macro allows to unroll ruled surfaces and to draw them on a page.

Macro_unrollRuledSurface

Installation

Available in Add-on manager.

Cf Macro for unrolling ruled surfaces

Options

  • Number of generatrix
  • Scale manual or automatic
  • Page format: a3/a4, cartridge (cf FreeCAD templates)
  • Group drawings in the same page as possible.

Macro_unrollRuledSurface

Instruction for use

  1. Select ruled surfaces
  2. Explode them (cf Draft menu - downgrade)
  3. Select the surfaces
  4. Execute the macro

Script

The lastest version of the macro is here on the wiki. An earlier version can be found at UnrollRuledSurface.FCMacro but the easiest way to install this macro is through the Addon Manager Std_AddonMgr .

ToolBar Icon

Macro_unrollRuledSurface.py

# -*- coding: utf-8 -*-

#***************************************************************************
#*                                                                         *
#*   Copyright (c) 2013 - DoNovae/Herve BAILLY <hbl13@donovae.com>         *
#*   Copyright (c) 2022 - heda <heda@fc-forum>                             *
#*                                                                         *
#*   This program is free software; you can redistribute it and/or modify  *
#*   it under the terms of the GNU Lesser General Public License (LGPL)    *
#*   as published by the Free Software Foundation; either version 2 of     *
#*   the License, or (at your option) any later version.                   *
#*   for detail see the LICENCE text file.                                 *
#*                                                                         *
#*   This program is distributed in the hope that it will be useful,       *
#*   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
#*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
#*   GNU Library General Public License for more details.                  *
#*                                                                         *
#*   You should have received a copy of the GNU Library General Public     *
#*   License along with this program; if not, write to the Free Software   *
#*   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
#*   USA                                                                   *
#*                                                                         *
#***************************************************************************
__Name__ = 'Unroll Ruled Surface'
__Comment__ = 'Unroll of a ruled surface and draw it on a page.'
__Author__ = 'Hervé B., heda'
__Version__ = '1.1'
__Date__ = '2022-07-24'
__License__ = 'LGPL-2.0-or-later'
__Web__ = 'https://www.freecadweb.org/wiki/Macro_Unroll_Ruled_Surface'
__Wiki__ = 'https://www.freecadweb.org/wiki/Macro_Unroll_Ruled_Surface'
__Icon__ = ''
__Help__ = ('Select ruled surfaces, Explode them (cf Draft menu), '
            'Select the surfaces, Execute the macro')
__Status__ = ''
__Requires__ = ''
__Communication__ = ''
__Files__ = ''

__doc__ = """
select a face, or several and run the macro.
a solid needs to be draft/downgraded to get the faces as separate objects

the macro is intended to unroll lofted faces,
function beyond that is (in current version) a bonus

settings are not context aware, all settings not applicable are ignored.
as example, using autoscaling ignores the scale-value in the form


v1.1   (2022-07-24) py3/qt5 compat, cosmetic code changes, minor code tweaks,
       used gridlayout for form, added option to skip drawing,
       added simplistic alternative layout engine
v1.0.1 (2019-02-01) - on git
v1.0   (2013-09-14) - on wiki

note:
- unfolding sometimes works and sometimes not
- should be converted to use techdraw

"""

import os
from PySide import QtGui, QtCore
import FreeCAD, FreeCADGui
import Part, Draft

Vector = FreeCAD.Base.Vector
PrintMessage = FreeCAD.Console.PrintMessage
PrintError = FreeCAD.Console.PrintError

settings = dict()
unroll_l = []
dwgtpl = 'Mod/Drawing/Templates'


#####################################
###   Functions
#####################################

def errorDialog(msg):
    diag = QtGui.QMessageBox(QtGui.QMessageBox.Critical, "Error Message", msg)
    diag.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
    diag.exec_()

def ending():
    PrintMessage("UnrollRuledSurface: end.\n")
    PrintMessage("===========================================\n")
    FreeCAD.ActiveDocument.recompute()


def proceed():
    QtGui.QApplication.setOverrideCursor(QtCore.Qt.WaitCursor)

    PrintMessage("===========================================\n")
    PrintMessage("UnrollRuledSurface: start.\n")
    try:
        sts = lambda s: settings.get(s)

        file_name = sts("fname").text()
        pts_nbr = float(sts("dpts").text())
        makedwg = sts("mkdwg").isChecked()
        altlay = sts("altlayout").isChecked()
        scale = float(sts("scale").text()) # ignored if autoscale is set
        scale_auto = sts("autoscale").isChecked()
        edge0 = sts("edge").checkedId() == -2
        a3 = sts("papersize").checkedId() == -3
        cartridge = sts("cartridge").isChecked()
        onedrawing = sts("groupdwg").isChecked()

        PrintMessage("UnrollRuledSurface.file_name: {}\n".format(file_name))
        PrintMessage("UnrollRuledSurface.pts_nbr: {}\n".format(pts_nbr))
        PrintMessage("UnrollRuledSurface.edge0: {}\n".format(edge0))
        PrintMessage("UnrollRuledSurface.makedwg: {}\n".format(makedwg))
        PrintMessage("UnrollRuledSurface.altlay: {}\n".format(altlay))
        PrintMessage("UnrollRuledSurface.scale_check: {}\n".format(scale_auto))
        PrintMessage("UnrollRuledSurface.scale: {}\n".format(scale))
        PrintMessage("UnrollRuledSurface.a3_check: {}\n".format(a3))
        PrintMessage("UnrollRuledSurface.cartridge: {}\n".format(cartridge))
        PrintMessage("UnrollRuledSurface.onedrawing: {}\n".format(onedrawing))
    except:
        msg = "UnrollRuledSurface: wrong inputs...\n"
        PrintError(msg)
        errorDialog(msg)
        QtGui.QApplication.restoreOverrideCursor()
        DialogBox.hide()
        ending()
        return

    QtGui.QApplication.restoreOverrideCursor()
    DialogBox.hide()
    unrollRS = unrollRuledSurface(file_name, pts_nbr, edge0)

    ##  Get selection
    sel = FreeCADGui.Selection.getSelection()
    if not sel:
        PrintMessage("UnrollRuledSurface: no selection...\n")
        ending()
        return

    faceid = 0
    objnames_l, objnames0_l = [], []
    grp = FreeCAD.ActiveDocument.addObject("App::DocumentObjectGroup",
                                           "{}_objs".format(file_name))

    for objid, obji in enumerate(sel):
        shape = obji.Shape
        faces = shape.Faces
        for idx in range(len(faces)):
            msg = "UnrollRuledSurface.proceed: ObjId = {}, faceId = {}\n"
            PrintMessage(msg.format(objid, faceid))
            name = obji.Name
            if len(faces) > 1:
                name = "{}.face_{}".format(name, idx)
            obj = unrollRS.unroll(faces[idx], name)
            obj.ViewObject.Visibility = not makedwg
            grp.addObject(obj)

        objnames_l.append([obj, name])
        objnames0_l.append([obji, name])
        faceid += 1


    if not makedwg:
        ending()
        return


    if altlay:
        draw = Drawing2dAlt(scale, scale_auto, a3)
        n = 4 if onedrawing else 1
        chunks = [objnames_l[i:i + n] for i in range(0, len(objnames_l), n)]
        for i, chunk in enumerate(chunks, start=1):
            draw.drawpage(chunk, "{}_page{:02}".format(file_name, i))

    else:
        idx = 0
        while len(objnames_l) > 0:
            draw = Drawing2d(scale, scale_auto, a3, cartridge, onedrawing,
                             "{}_page{:02}".format(file_name, idx))
            objnames_l = draw.all2d(objnames_l)
            idx += 1
            msg = "UnrollRuledSurface: obj_l = {}\n"
            PrintMessage(msg.format(len(objnames_l)))



def close():
    DialogBox.hide()

def getType(obj):
    return type(obj).__name__


class unrollRuledSurface:
    """
    unroll ruled surfaces
    :file_name: ouput file
    :pts_nbr: nbr point of discretization
    """
    def __init__(self, file_name, pts_nbr, edge0):
        self.doc = FreeCAD.ActiveDocument
        self.file_name = file_name
        self.pts_nbr = int(pts_nbr)
        self.edge0 = edge0
        msg = "UnrollRuledSurface.unroll - file_name: {}, pts_nbr: {}\n"
        PrintMessage(msg.format(file_name, pts_nbr))


    def discretize(self, curve):
        """discretize a curve"""
        if getType(curve) in ('GeomLineSegment', 'GeomCircle'):
            sd = curve.discretize(self.pts_nbr)
        elif getType(curve) == 'GeomBSplineCurve':
            nodes = curve.getPoles()
            spline = Part.BSplineCurve()
            spline.buildFromPoles(nodes)
            sd = spline.discretize(self.pts_nbr)
        else:
            sd = curve.discretize(self.pts_nbr)
        return sd

    def nbpoles(self, curve):
        """find number of poles for a curve"""
        if getType(curve) == 'GeomLineSegment':
            nbpol=1
        elif getType(curve) == 'GeomBSplineCurve':
            nbpol=curve.NbPoles
        elif getType(curve) == 'GeomCircle':
            nbpol=2
        elif getType(curve) == 'GeomBezierCurve':
            nbpol=4
        else:
            nbpol=0

        msg = "UnrollRulrdSurface.nbpole {:s} = {:d}\n"
        PrintMessage(msg.format(getType(curve), nbpol))
        return nbpol

    def unroll(self, face, name):
        """unrolls a face composed of 2 to 4 edges"""
        nbredges = len(face.Edges)
        msg = "UnrollRuledSurface.unroll: Edge Nbr = {}\n"
        PrintMessage(msg.format(nbredges))

        if nbredges == 2:
            e1, e2 = face.Edges
            sd1 = e1.Curve.discretize(self.pts_nbr)
            sd2 = e2.Curve.discretize(self.pts_nbr)

        elif nbredges == 3:
            e1, _, e2 = face.Edges
            sd1 = e1.Curve.discretize(self.pts_nbr)
            sd2 = e2.Curve.discretize(self.pts_nbr)

        else:
            E0, E1, E2, E3, *_ = face.Edges
            # Choose more complexe curve as edge
            nbpol0 = self.nbpoles(E0.Curve)
            nbpol1 = self.nbpoles(E1.Curve)
            nbpol2 = self.nbpoles(E2.Curve)
            nbpol3 = self.nbpoles(E3.Curve)
            msg = ("UnrollRuledSurface.unroll: nbpol0= {:d}, nbpol1= {:d},"
                   " nbpol2= {:d}, nbpol3= {:d}\n")
            PrintMessage(msg.format(nbpol0, nbpol1, nbpol2, nbpol3))

            if self.edge0:
                e1, e2 = E0, E2
                v = self.discretize(E1)
                v0, v1 = v[0], v[self.pts_nbr-1]
            else:
                e1, e2 = E1, E3
                v = self.discretize(E2)
                v0, v1 = v[0], v[self.pts_nbr-1]

            sd1 = self.discretize(e1)
            sd2 = self.discretize(e2)
            # Reverse if curves cross over
            if not (sd2[0].__eq__(v0) or not sd2[0].__eq__(v1)):
                sd2.reverse()

        # Create a polygon object and set its nodes
        devlxy_l = self.devlxyz(sd1, sd2)
        msg = "UnrollRuledSurface.unroll: size devlxy_l: {}\n"
        PrintMessage(msg.format(len(devlxy_l)))
        p = self.doc.addObject("Part::Polygon", name)
        p.Nodes = devlxy_l
        self.doc.recompute()
        FreeCADGui.ActiveDocument.ActiveView.fitAll()
        return p

    def vect_copy(self, vect):
        """returns copy of vector"""
        return vect.add(Vector())

    def vect_cos(self, vect1, vect2):
        """returns cosine angle between 2 vectors"""
        return vect1.dot(vect2) / vect1.Length / vect2.Length

    def vect_sin(self, vect1, vect2):
        """returns absolute sinus angle between 2 vectors"""
        v = Vector()
        v.x = vect1.y * vect2.z - vect1.z * vect2.y
        v.y = vect1.z * vect2.x - vect1.x * vect2.z
        v.z = vect1.x * vect2.y - vect1.y * vect2.x
        return v.Length / vect1.Length / vect2.Length

    def devlxyz(self, vect1, vect2):
        """
        unrolls a face composed of 4 edges
        args: vect1, vect2 --> 2 edges of the shape
        returns: dvlxy
        """
        lenv1, lenv2 = len(vect1), len(vect2)
        if lenv1 != lenv2 or lenv1 != self.pts_nbr or lenv2 != self.pts_nbr:
            msg = ("UnrollRuledSurface.devlxyz: incompatility of sizes vect1,"
                   " vect2, pts_nbr: ({}, {}, {})\n")
            PrintError(msg.format(lenv1, lenv2, self.pts_nbr))
            errorDialog(msg)

        devlxy_l, devl1xy_l, devl2xy_l = [], [], []
        errormax = 0.0
        # Init unroll
        # AB
        a1b1 = vect2[0].sub(vect1[0])
        oa1 = Vector(0, 0, 0)
        devl1xy_l.append(oa1) #A1
        ob1 = Vector(a1b1.Length, 0, 0)
        devl2xy_l.append(ob1) #B1
        #self.draw_line(devl1xy_l[0], devl2xy_l[0])
        #self.draw_line(vect1[0], vect2[0])
        for j in range(1, self.pts_nbr):

            # AB
            ab = vect2[j-1].sub(vect1[j-1])
            #self.draw_line(vect1[j-1], vect2[j-1])

            # AC
            ac = vect1[j].sub(vect1[j-1])

            # BD
            bd = vect2[j].sub(vect2[j-1])

            # CD
            cd = vect2[j].sub(vect1[j])

            # A1B1 in unroll plan
            a1b1 = devl2xy_l[j-1].sub(devl1xy_l[j-1])
            a1b1n = self.vect_copy(a1b1)
            a1b1n.normalize()
            a1b1on = Vector(-a1b1n.y, a1b1n.x, 0)

            # A1C1
            cosalp = self.vect_cos(ab, ac)
            sinalp = self.vect_sin(ab, ac)
            a1c1 = self.vect_copy(a1b1n)
            a1c1.multiply(cosalp * ac.Length)
            v = self.vect_copy(a1b1on)
            v.multiply(sinalp * ac.Length)
            a1c1 = a1c1.add(v)
            oa1 = self.vect_copy(devl1xy_l[j-1])
            oc1 = oa1.add(a1c1)
            devl1xy_l.append(oc1)

            # B1D1
            cosalp = self.vect_cos(ab, bd)
            sinalp = self.vect_sin(ab, bd)
            b1d1 = self.vect_copy(a1b1n)
            b1d1.multiply(cosalp * bd.Length)
            v = self.vect_copy(a1b1on)
            v.multiply(sinalp * bd.Length)
            b1d1 = b1d1.add(v)
            ob1 = self.vect_copy(devl2xy_l[j-1])
            od1 = ob1.add(b1d1)
            devl2xy_l.append(od1)

            # Draw generatrice
            #self.draw_line(devl1xy_l[j], devl2xy_l[j])
            c1d1 = devl2xy_l[j].sub(devl1xy_l[j])
            if ab.Length != 0:
                abl = ab.Length
                errormax = max(errormax, abs(abl - c1d1.Length) / abl)

        msg = "UnrollRuledSurface Error cd,c1d1: {:.1f} %\n"
        PrintMessage(msg.format(errormax*100))

        # Close polygone
        devlxy_l = devl1xy_l
        devl2xy_l.reverse()
        devlxy_l.extend(devl2xy_l)
        v = Vector()
        devlxy_l.append(v)

        return devlxy_l


    def draw_line(self, vect0, vect1):
        """draws a Part.Line between vect0 & vect1"""
        l = Part.LineSegment()
        l.StartPoint = vect0
        l.EndPoint = vect1
        self.doc.addObject("Part::Feature", "Line").Shape = l.toShape()


class Scale:
    """keeps autoscaling to known integers"""
    def __init__(self, scale):
        self.scale = scale if scale >= 1 else 1 / scale
        self.scale = int(self.scale)
        self.inverted = scale >= 1

    def get(self):
        if self.inverted:
            return self.scale, '{}:1'.format(self.scale)
        else:
            return 1/self.scale, '1:{}'.format(self.scale)


class Drawing2dAlt:
    """
    Alternative layout engine (Drawing wb), only does plain templates.
    not much testing done, not perfect, however probably good enough...
    makes 2d drawing with Drawing wb
    - obj_l: list of objects
    """
    # untouched in v1.1
    def __init__(self, scale, scale_auto, a3):

        self.a3 = a3
        self.scale = scale
        self.scale_auto = scale_auto
        if self.a3:
            self.WH = 420, 297
        else:
            self.WH = 297, 210


    def _mkquadrants(self, nbr):
        """lower lefts w/o margin"""
        w, h = self.WH
        w2, h2 = w/2, h/2
        d = (w**2 + h**2)**(1/2)

        q = {1: [[w, h, d], [[0, h]]],
             2: [[w2, h, d/2], [[0, h], [w2, h]]],
             3: [[w2, h2, d/4], [[0, h2], [w2, h2], [0, h]]],
             4: [[w2, h2, d/4], [[0, h2], [w2, h2], [0, h], [w2, h]]]}
        return q.get(nbr)


    def newPage(self, doc, page_name):
        freecad_dir = os.path.join(FreeCAD.getResourceDir(), dwgtpl)
        page = doc.addObject('Drawing::FeaturePage', page_name)
        size = 'A3' if self.a3 else 'A4'
        page.Template = freecad_dir + '/{}_Landscape_plain.svg'.format(size)
        return page


    def drawpage(self, faces, page_name):
        """max 4 per page, simple layout with halfs or quadrants"""
        doc = FreeCAD.ActiveDocument
        page = self.newPage(doc, page_name)
        fontsize = 5 if self.a3 else 7
        [W, H, D], ll = self._mkquadrants(len(faces))
        for [face, name], [x0, y0] in zip(faces, ll):
            bb = face.Shape.BoundBox
            aspect = max(bb.XLength / bb.YLength, bb.YLength / bb.XLength)
            adjusted = max(W / H, H / W) / aspect

            if self.scale_auto:
                scale = D / (bb.DiagonalLength * adjusted)
            else:
                scale = self.scale
            sc, scr = Scale(scale * 0.95).get()

            dx = (W - bb.XLength * sc) / 2
            dy = (H - bb.YLength * sc) / 2
            dyt = dy - fontsize * 2 if dy > fontsize else dy

            Text = doc.addObject('Drawing::FeatureViewAnnotation', f"{name}_txt")
            Text.Text = '{} [{}]'.format(name, scr)
            Text.X = int(x0 + dx + fontsize / 2)
            Text.Y = int(y0 - dyt - fontsize / 2)
            Text.Scale = fontsize

            TopView = doc.addObject('Drawing::FeatureViewPart', name)
            TopView.Source = face
            TopView.Direction = (0, 0, 1)
            TopView.Rotation = 0
            TopView.X = int(x0 + dx)
            TopView.Y = int(y0 - dy)
            TopView.ShowHiddenLines = False
            TopView.Scale = sc
            page.addObject(TopView)
            page.addObject(Text)

        doc.recompute()
        page.ViewObject.doubleClicked()


class Drawing2d:
    """
    makes 2d drawing with Drawing wb (original layout engine)
    - obj_l: list of objects
    """
    # untouched in v1.1
    def __init__(self, scale, scale_auto, a3, cartridge, onedrawing, page_str):
        self.TopX_H = self.TopY_H = 0
        self.TopX_V = self.TopY_V = 0
        self.TopX_Hmax = self.TopY_Hmax = 0
        self.TopX_Vmax = self.TopY_Vmax = 0
        self.a3 = a3
        self.scale = scale
        self.scale_auto = scale_auto
        self.cartridge = cartridge
        self.onedrawing = onedrawing
        self.marge = 6
        if self.a3:
            self.L, self.H = 420, 297
        else:
            self.L, self.H = 297, 210
        self.name = page_str

    def newPage(self):
        freecad_dir = os.path.join(FreeCAD.getResourceDir(), dwgtpl)
        doc = FreeCAD.ActiveDocument
        page = doc.addObject('Drawing::FeaturePage', self.name)
        size = 'A3' if self.a3 else 'A4'
        frame = '' if self.cartridge else '_plain'
        page.Template = freecad_dir + '/{}_Landscape{}.svg'.format(size, frame)
        return page


    def all2d(self, objname_l):
        obj1_l = []
        for objid in range(len(objname_l)):
            if objid == 0 or not self.onedrawing:
                page = self.newPage()
            obj1_l.extend(self.done(objid, objname_l[objid]))
        return obj1_l

    def done(self, idx, objname):
        obj_l = []
        obj, objname = objname
        marge = self.marge
        bb = obj.Shape.BoundBox
        xmax = bb.XMax - bb.XMin
        ymax = bb.YMax - bb.YMin

        if ymax > xmax:
            Draft.rotate(obj, 90)
        Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
        xmax = bb.XMax - bb.XMin
        ymax = bb.YMax - bb.YMin

        scale = min((self.L-4 * marge) / xmax, (self.H-4 * marge) / ymax)

        if (not self.scale_auto) or self.onedrawing:
            scale = self.scale

        PrintMessage("UnrollRuledSurface.drawing: scale= {:.2f}\n".format(scale))


        if idx == 0 or not self.onedrawing:
            PrintMessage("Dawing2d: init\n")
            TopX = self.TopX_H = marge * 2
            TopY = self.TopY_H = marge * 2
            self.TopX_H = self.TopX_H + xmax * scale + marge
            self.TopY_H = self.TopY_H
            self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
            self.TopY_Hmax = max(self.TopY_Hmax,
                                 self.TopY_H + ymax * scale + marge)
            self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
            self.TopX_V = max(self.TopX_Vmax, self.TopX_V)
            self.TopY_V = marge * 2

        elif self.onedrawing:
            if self.TopX_H + xmax * scale < self.L:
                if self.TopY_H + ymax * scale + marge * 2 < self.H:
                    # H Add at right on same horizontal line
                    PrintMessage("Dawing2d: horizontal\n")
                    TopX, TopY = self.TopX_H, self.TopY_H
                    self.TopX_H = self.TopX_H + xmax * scale + marge
                    self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
                    self.TopY_Hmax = max(self.TopY_Hmax,
                                         self.TopY_H + ymax * scale + marge)
                    self.TopX_Vmax = max(self.TopX_Hmax, self.TopX_Vmax)
                    self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
                    self.TopX_V = max(self.TopX_Vmax, self.TopX_V)

                else:
                    # V Add at right on same horizontal line
                    PrintMessage("Dawing2d: vertival\n")
                    if (self.TopX_V + ymax * scale + 2 * marge < self.L
                        and self.TopY_V + xmax * scale + 2 * marge < self.H):
                        Draft.rotate(obj, 90)
                        Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
                        x0 = xmax; xmax = ymax; ymax = x0
                        self.TopX_V = max(self.TopX_Vmax, self.TopX_V)
                        TopX, TopY = self.TopX_V, self.TopY_V
                        self.TopX_V = self.TopX_V + xmax * scale + marge
                        self.TopY_Vmax = max(self.TopY_Vmax,
                                             self.TopY_V + ymax * scale + marge)

                    else:
                        obj_l.append([obj, self.name])
                        return obj_l

        else:
            # H Carriage return
            if self.TopY_Hmax + ymax * scale + self.marge*2 < self.H:
                msg = "Drawing2d: carriage return: {} > {}\n"
                PrintMessage(msg.format(self.TopY_H + ymax * scale, self.H))
                TopX = self.marge * 2
                TopY = self.TopY_Hmax
                self.TopX_H = TopX + xmax * scale + self.marge
                self.TopY_H = TopY
                self.TopX_Hmax = max(self.TopX_Hmax, self.TopX_H)
                self.TopY_Hmax = self.TopY_Hmax + ymax * scale + self.marge
                self.TopX_Vmax = max(self.TopX_Vmax, self.TopX_Hmax)
                self.TopX_V = max(self.TopX_Vmax, self.TopX_V)

            else:
                # V Add at right on same horizontal line
                msg = "Drawing2d: vertival: {} , {}\n"
                PrintMessage(msg.format(self.TopX_V, self.TopX_Vmax))
                if (self.TopX_V + ymax * scale + 2 * marge < self.L
                    and self.TopY_V + xmax * scale + 2 * marge < self.H):
                    Draft.rotate(obj, 90)
                    Draft.move(obj, Vector(-bb.XMin, -bb.YMin, 0))
                    x0 = xmax; xmax = ymax; ymax = x0
                    TopX, TopY = self.TopX_V, self.TopY_V
                    self.TopX_V = self.TopX_V + xmax * scale + marge
                    self.TopY_Vmax = max(self.TopY_Vmax,
                                         self.TopY_V + ymax * scale + marge)

                else:
                    obj_l.append([obj, objname])
                    return obj_l

        doc = FreeCAD.ActiveDocument
        page = doc.getObject(self.name)

        Text = doc.addObject('Drawing::FeatureViewAnnotation', f"{objname}_txt")
        Text.Text = objname
        Text.X = TopX + xmax * scale / 2
        Text.Y = TopY + ymax * scale / 2
        Text.Scale = 2

        TopView = doc.addObject('Drawing::FeatureViewPart', objname)
        TopView.Source = obj
        TopView.Direction = (0, 0, 1)
        TopView.Rotation = 0
        TopView.X = TopX
        TopView.Y = TopY
        TopView.ShowHiddenLines = False
        TopView.Scale = scale
        page.addObject(TopView)
        page.addObject(Text)
        doc.recompute()
        return obj_l




#####################################
###   Dialog Box
#####################################

DialogBox = QtGui.QDialog()
DialogBox.setWindowTitle("UnrollRuledSurface")
la = QtGui.QGridLayout(DialogBox)
la.setSpacing(7)
buttonGrpEdge = QtGui.QButtonGroup(DialogBox)
buttonGrpFormat = QtGui.QButtonGroup(DialogBox)

cols = 4
la.addWidget(QtGui.QLabel("File Name"), 0, 0, 1, cols)
fname = QtGui.QLineEdit("UnrollSurface")
la.addWidget(fname, 1, 0, 1, cols)

la.addWidget(QtGui.QLabel("Discretization Points Nbr"), 2, 0, 1, cols)
dpts = QtGui.QLineEdit("30")
la.addWidget(dpts, 3, 0, 1, 2)

###
la.addWidget(QtGui.QLabel("Generatrices from edge:"), 4, 0, 1, 2)
edgezero = QtGui.QRadioButton("0 to 3")
la.addWidget(edgezero, 4, 2)
edgeone = QtGui.QRadioButton("1 to 4")
la.addWidget(edgeone, 4, 3)
buttonGrpEdge.addButton(edgezero); buttonGrpEdge.addButton(edgeone)
edgezero.setChecked(True)

###
mkdwg = QtGui.QCheckBox("Make drawing")
mkdwg.setChecked(True)
la.addWidget(mkdwg, 5, 0, 1, 2)

altlayout = QtGui.QCheckBox("Alternative layout")
altlayout.setChecked(True)
la.addWidget(altlayout, 5, 2, 1, 2)


###
autoscale = QtGui.QCheckBox("Auto scale")
autoscale.setChecked(True)
la.addWidget(autoscale, 6, 0, 1, 2)

la.addWidget(QtGui.QLabel("Scale"), 6, 2)
scale = QtGui.QLineEdit("1")
la.addWidget(scale, 6, 3)

###
la.addWidget(QtGui.QLabel("Paper size:"), 7, 0, 1, 2)
rba4 = QtGui.QRadioButton("A4")
la.addWidget(rba4, 7, 2)
rba3 = QtGui.QRadioButton("A3")
la.addWidget(rba3, 7, 3)
buttonGrpFormat.addButton(rba4); buttonGrpFormat.addButton(rba3)
rba4.setChecked(True)

###
cartridge = QtGui.QCheckBox("Cartridge")
cartridge.setChecked(True)
la.addWidget(cartridge, 8, 0, 1, 2)

groupdwg = QtGui.QCheckBox("Group drawings in page")
groupdwg.setChecked(True)
la.addWidget(groupdwg, 8, 2, 1, 2)

###
box = QtGui.QDialogButtonBox(DialogBox)
box.setOrientation(QtCore.Qt.Horizontal)
box.setStandardButtons(QtGui.QDialogButtonBox.Cancel|QtGui.QDialogButtonBox.Ok)
la.addWidget(box, 9, 0, 1, cols)

###
settings.update(dict(fname=fname, dpts=dpts, edge=buttonGrpEdge,
                     mkdwg=mkdwg, altlayout=altlayout,
                     autoscale=autoscale, scale=scale,
                     papersize=buttonGrpFormat,
                     cartridge=cartridge, groupdwg=groupdwg))

QtCore.QObject.connect(box, QtCore.SIGNAL("accepted()"), proceed)
QtCore.QObject.connect(box, QtCore.SIGNAL("rejected()"), close)
QtCore.QMetaObject.connectSlotsByName(DialogBox)
DialogBox.show()