Manual de Usuario del Sailcut CAD

Robert Lainé

Jeremy Lainé

Translation: Joan Gelpi

Sailcut CAD 1.2.1 - 25 January 2006


Tabla de contenidos

1. Introducción
1.1. Sobre el Sailcut CAD
1.2. Información técnica sobre el programa
2. Instalación
2.1. ¿Cómo obtener el Sailcut CAD?
2.2. Requerimientos de compilación
2.3. Compilación e instalación
3. Usando el Sailcut CAD
3.1. Últimas notas
3.2. Preferencias de usuario
4. Crear una vela
4.1. Pantalla Dimensiones (menú Ver->Dimensiones)
4.2. Mould dialog screen (View->Mould menu)
4.3. Rig viewer (View->Rig menu)
4.4. View controls
4.5. Sail panels development
4.6. Loading / saving sails
4.7. Exporting 3D sails
4.8. Printing data and drawings
5. Sails surface formulation in Sailcut
5.1. History
5.2. Of the complexity of the definition of the surface of a sail
5.3. Some Maths
5.4. Other aspects of the surface formulation
6. Where can I find more information about Sailcut CAD?
6.1. I think I found a bug, what should I do?
6.2. I would like to help develop Sailcut CAD, what should I do?
7. File formats used by Sailcut CAD
7.1. Text representation of developed sail
7.2. Text representation of 3D sail
7.3. XML representation of a sail
8. Copyright

1. Introducción

1.1. Sobre el Sailcut CAD

Sailcut es un software para el diseño de velas desarrollado para paños planos. El Sailcut se puede usar tanto para velas de cuatro lados tipo cangreja como para mayores y foques Marconi de tres lados.

La primera versión del Sailcut fue desarrollada en 1978 y usada por Robert Lainé para fabricar las velas de su barco "Flying Sheep III", un ¼ Ton IOR. Sailcut ha estado disponible en la web desde 1994 y es utilizado por muchos fabricantes de velas, tanto amateurs como profesionales, para cruceros, regatas y recientemente para barcos de radiocontrol.

Sailcut se basa en una única definición matemática para la superfície vélica que asegura un perfil aerodinámico y uniforme.

1.2. Información técnica sobre el programa

Sailcut CAD se ha escrito con la intención que sea transportable. El programa fuente es el C++ utilizando la librería Qt de Trolltech para los gráficos y el OpenGL para la visualización en 3D de las velas. Sailcut CAD se puede compilar y funcionar bajo GNU/Linux, Microsoft Windows y MacOSX.

2. Instalación

2.1. ¿Cómo obtener el Sailcut CAD?

Se puede descargar la última versión del Sailcut CAD desde la página principal en http://sailcut.sourceforge.net/. También está disponible en binario (compilado) y en código fuente.

2.2. Requerimientos de compilación

Sailcut se puede compilar con una gran variedad de sistemas que admitan el compilador C++ y las herramientas QT4 de Trolltech. Para hacer uso del Sailcut CAD en formato 3D se debe contar con el OpenGL en nuestro sistema.

2.2.1. Notas para MacOS/X

En los sistemas operativos bajo MacOSX, debemos instalar también el paquete Fink el cual está disponible en http://fink.sourceforge.net/.

2.2.2. Notas para Microsoft Windows

En primer lugar, se necesintan varias herramientas de compilación de Mingo que pueden descargarse desde http://www.mingw.org/. Hay que descargar e instalar los siguientes programas:

  • MinGW : MinGW-4.1.0.exe

  • MSYS : MSYS-1.0.10.exe

  • MSYS Developer Tool Kit : msysDTK-1.0.1.exe

Después debemos descargar e instalar el Qt4.0 Opensource para Windows desde la página de Trolltech: http://www.trolltech.com/.

  • Qt4 : qt-win-opensource-desktop-4.0.0-mingw.exe

2.3. Compilación e instalación

2.3.1. Procedimiento

El procedimiento para compilar e instalar el Sailcut CAD implica tres pasos: arrancar la configuración de escritura, compilar e instalar. Debemos teclear en el directorio que contenga el código fuente del Sailcut CAD lo siguente:

% ./configure
% make
% make install

2.3.2. Notas para Windows

Para compilar Sailcut CAD en nuestro sistema, debemos lanzar MSYS para obtener el símbolo de sistema y en el directorio de Sailcut teclear:

% ./configure
% make

2.3.3. Notas para MacOS/X

Sailcut CAD se puede compilar y arrancar usando el paquete Fink. Para ello debemos teclear en el directorio raíz del Sailcut:

% ./configure --with-qt-includes=/sw/include/qt
% make
% make install

3. Usando el Sailcut CAD

3.1. Últimas notas

Al igual que la versión 0.6.5, el Sailcut CAD usa diferentes extensiones para cada tipo de archivo instalado en lugar de los finales con extensión ".xml". Si deseamos abrir nuestras velas creadas con la versión anterior del Sailcut CAD debemos renombrar el archivo de definición de vela así como las extensiones con ".saildef". Al abrir el archivo resultante, todos los archivos se conservarán excepto los datos para el molde.

3.2. Preferencias de usuario

3.2.1. Preferencias de archivo

Las preferencias se almacenan en un archivo llamado ".sailcutrc". Bajo UNIX este archivo se localiza en el directorio raíz y en Windows está en "C:\".

3.2.2. Internacionalización

Como en la versión 0.5.5, el Sailcut CAD tiene soporte para la internacionalización. Al arrancar el programa, podemos seleccionar el idioma que nos interese en el menu Ver->Idioma.

4. Crear una vela

Cuando iniciamos Sailcut CAD, se presenta una vela por defecto y en la parte superior de la ventana encontraremos menús desplegables. El menú ARCHIVO se usa para cargar una vela existente, GUARDAR los parámetros de la vela y EXPORTAR los paneles desarrollados.

Se puede modificar las dimensiones de la vela utilizando el menú Ver->Dimensiones.

Con el menú Ver->Molde podremos modificar el perfil de la vela.

Y en el menú Ver->Aparejo visualizaremos varias velas con diferentes aparejos.

4.1. Pantalla Dimensiones (menú Ver->Dimensiones)

El programa permite diseñar tanto una vela triangular como cuadrangular. La clásica vela Marconi se diseña esencialmente igual que una Cangreja pero con un pequeño puño de driza.

La superficie de la vela se genera desde unas sencillas ecuaciones que definen el perfil en todas las alturas. Dichos perfiles se basan en los extremos de las velas que han sido definidos por la longitud y alunamiento en cada lado y por el twist de la vela. En la ventana "Dimensión" hallaremos los parámetros que definen la vela.

Al pulsar el botón "Calcular" el programa evalúa y visualiza los datos auxiliares. Estos datos aparecen en pestañas de color y que pueden modificarse. Si el color es rojo, significa que el valor excede del límite superior; si es amarillo indica que está por debajo del límite aceptable y debe cambiarse.

Una vez finalizada la entrada de datos de dimensiones, pulsamos OK para visualizar la vela en formato 3D.

4.1.1. Pestaña "Geometría del Aparejo"

El primer paso es seleccionar el tipo de vela con la que vamos a trabajar y entrar los datos que definen la geometría del aparejo y el plano vélico (ver la Figura 1.)

Seleccionar el tipo de vela marcando bulón deseado:

  • FOQUE para cualquier vela de proa,

  • MAYOR para cualquier vela envergada en el mástil,

  • ALA para cualquier tipo de cometa simétrica.

The rig data are used for displaying the sails in their proper relative position with the "rig viewer".

Figura 1. Sailcut plan definition

Sailcut plan definition

4.1.2. Pestaña "Dimensiones de la vela"

Aquí es donde se introducen las dimensiones de la vela.

En una vela mayor, el valor mínimo para la longitud de la percha (galleta del puño de driza) es de 5mm. Cualquier valor inferior dará siempre por defecto 5mm. El ángulo de percha viene definido como el ángulo entre el mástil y la baluma que puede ser hasta 90 grados.

El alunamiento del pujamen, la baluma y la percha extiende la vela más allá de su línea recta.

El alunamiento negativo equivaldrá a un hueco en la parte exterior de la vela.

La posición del alunamiento se expresa en porcentaje en el correspondiente lado de la vela calculado desde la parte más baja o más externa del lado.

Figura 2. Sailcut edges definition

Sailcut edges definition

Dimensions and angles defining the sail plan are expressed in millimetre and degrees.

Length of the sail sides and diagonal are the 3D straight line distance between the corners of the sail.

The actual length on the finished sail lais on the floor can be slightly longer depending on the shape of the sail. For example, the foot length entered in the screen below is 3600 mm. If the foot camber is null then that will be the actual distance between clew and tack (straight foot) of the finished sail. If a 10% camber is entered for the foot depth, then the actual foot will be the length of the arc which has 10% camber, that is 2.7% longer than the straight line foot length.

Having entered the sail main dimensions you can press on the "Compute" button to obtain additional informations on the sail, like the X-Y coordinates of the corners of the sail, the perpendicular length LP measured from the clew to the luff as well as IRC racing rules width.

The X-Y coordinates of the sail corners are usefull to quickly adjust the data entered. For example if you find that the clew height (Y) is way below or above the height of the tack when you would like it to be leveled, then you can substract or add the difference to the leech length.

4.1.3. "Layout" box

Click on the radio button corresponding to the desired layout of the sail. The layout of the panels does not affect the shape of the sail which is defined by its dimensions and its mould. Except for the Radial cut layout, the number of panels is determined by the cloth width and seam width entered in the "Cloth" box.

  • The most commonly used layout is the "Crosscut". The panels are laid perpendicular to the straight line joining the peak to the clew of the sail.

  • The "Twist foot" layout is similar to the cross cut except that the lower panels are rotated such that they do not intersect the foot of the sail.

  • The "Horizontal cut" layout lay the seams in the horizontal plane. This option can be used to visualise the profile of the sail at various levels and to output files with the 3D coordinates of the sails for use by CFD tools.

  • The "Vertical cut" layout places the panels parrallel to the straight line joining the peak to the clew of the sail. This is the favorite layout for the old timer's main sail.

  • The "Mitre cut" layout is the favorite for the old timer's genoa. The sail is divided in two parts by a line joining the clew to the mid point on the luff and the panels organised to be perpendicular to the foot in the lower part of the sail and perpendicular to the leech in its upper part.

  • The "Radial cut" is used mostly for competition as the cloth is mostly aligned with the directions of maximum strain. When using the Radial cut option it is important to understand the definition of the number of sections, number of radial gores and number of luff gores (see figure below).

Figura 3. Radial cut gores definition

Radial cut gores definition

4.1.4. "Sail shape" box

You enter there the depth of the sail at 3 levels, near the foot, in the middle of the sail(the exact position being defined in the mould screen) and near the top of the sail.

The twist angle is the angle expressed in degrees by which the top of the sail is rotated with respect to the foot. The twist is globally determined by the amount by which the apparent wind at the top of the mast is rotated with respect to the apparent wind at deck level. For a jib the twist is sometime driven by the need to have the upper part of the leech sufficiently open to clear the spreaders. For a mainsail the twist is also driven by the ability of the rig to carry the tension in the leech, in particular a gaff rig will have more twist in its main sail than a Bermuda rig. It is important that the twist angle entered in Sailcut reflects the reality of the shape of the leech when sailing in an average wind.

The sheeting angle value is the actual sheeting angle measured from the boat centerline when the sail is set on the boat. For a jib the minimum value is 5 degrees. The value is of importance to ensure that the sail is properly positioned when displayed in the "rig viewer". You can then visualise for example the slot between a jib and the main sail as set when sailing.

4.1.5. "Cloth" box

Enter there the width of cloth used, the width of the seams between adjacent panels, the width of material to be added to the leech to make the leech hem and the width of material for the other edges hems.

The figure below describes de location of the various hems and seam width.

Sailcut will compute the panels such that they fit within the declared cloth width including the seam and hems width as appropriate.

Figura 4. Sailcut seams and hems definition

Sailcut seams and hems definition

4.2. Mould dialog screen (View->Mould menu)

The depth of the sail can be entered at three levels located at the bottom (foot) the middle (maximum depth level) and near the top.

The vertical position of the maximum depth profile is controlled by the vertical slide bar to the right of the left vertical frame.

The luff shape and the leech shape can be adjusted for the Top profile and Middle profile only. The foot profile is always an arc of circle.

In order to avoid that the leech makes a hook in the upper part of the sail when the wind increases it is recommended that the Top profile luff shape value be higher than that of the middle profile and that the leech shape value at the top be lower than the middle value.

4.3. Rig viewer (View->Rig menu)

This viewer is used to display several sails on the same rig.

The File->Add sail menu entry is used to purge the viewer.

The File->Add sail menu entry is used to add sails already created and saved with Sailcut.

Once a sail is added to the rig viewer the sail information frame appears below and it is possible to translate the sail in the 3 directions by adding X-Y-Z displacement values. If you have misplaced a sail use the Reload button to recover the initial sail. You can also use the Remove button to eliminate a sail. 2 slides allows you to ratate the rig in azimuth and elevation and view the ig from any vantage point.

The File->Save menu entry is used to save a rig with a combination of sails.

Rigs which have been saved can be later opened as an entity with File->Open menu entry.

Note that the rig viewer window must be closed to allow you to return to the main screen of Sailcut.

4.4. View controls

It is possible to zoom, pan and rotate the sail in the view window:

  • rotation : you can control the rotation that is applied to the sail by using the elevation and azimuth sliders.

  • pan : click on a point with the left mouse to center the view on that point.

  • zoom : to zoom in press CTRL and + and to zoom out press CTRL and -. You can also use the zoom buttons in the view controls or your mouse wheel to zoom in and out.

4.5. Sail panels development

The developed sail is display by clicking on the "Development" tab from Sailcut CAD's main window. This presents you with a view of the developed (flat) panels of the sail. The view controls are the same as those of the main window. The blue line represents the edge of the finished panel (draw line) and the red line represents the outer edge taking into account the seam and hems width allowance (cut line).

You can export the points which define the edges of the developed panels with the draw and cut lines to the following file formats:

4.6. Loading / saving sails

Once you have customised you sail, you can save it to a file (File->Save or File->Save As) and load it (File->Open) next time you want to work on it. Both the sail's dimensions and the parameters of the mould are saved.

Sailcut CAD uses XML files to store the sail data. These files are plain text so they can easily be viewed using your favourite text editor.

4.7. Exporting 3D sails

On top of Sailcut CAD's native file format it is possible to export the points of the edges of the panels that make up a sail. You export the three dimensional sail to the following file formats:

4.8. Printing data and drawings

The File menu offers various printout possibilities:

  • File->Print->data, will print the data of the sail,

  • File->Print->drawing, will print a drawing of the complete sail,

  • File->Print->develop, will print all the developed panels with key points coordinates (1 panel per page). The definition of the developed panel key points coordinates is given in the figure below. The X,Y coordinates are absolute coordinates referenced to the lower left corner of the box enveloping the contour of the CUT line of the panel (edge of cloth). The dX,dY coordinates are relative to the straight line joining the end of the corresponding edge and it should be remembered that the origin of dX is at the left end of the edge and positive value of dY indicate that the point is left of the straight line joining the origin to the end points of the edge.

The printout scaling is such that the sail drawing and the largest developed panel automatically fit in one page. For printing panels to a precise scale it is preferable to export the developed sail in a DXF file and use a CAD package to print the panels.

Figura 5. Developed panels drawing

Developed panels drawing

5. Sails surface formulation in Sailcut

This section is a translation of the paper presented by Robert Lainé to the second Workshop Science Voile IRENAV in Brest, France on 21 May 2004.

5.1. History

Sailcut software was initially written in 1978 in Basic language on a computer with 1.6 KB of memory, one line text screen and a small 32 columns text printer. Hence the necessity to keep the surface formulation simple for designing the sails which I built and used on my IOR ¼ton.

This short cycle: "design => manufacturing => utilisation => modification", without commercial constraints linked to sailmakers work habits has allowed me to converge quickly on a compact and robust way of describing the sail surface. The method is valid for classical triangular sails and also for quadrangular sails used on old timers and modern rigs with very large headboard. Later on, the use of Sailcut by professional sailmakers has necessitated the addition of graphic interface to the kernel of Sailcut, but that is an other story... Since 1993 the Microsoft Visual Basic version of Sailcut is available at http://www.sailcut.com and since 2003, the source code of Sailcut re-written in C++ is available at http://sailcut.sourceforge.net. For protection of the intellectual rights, the name Sailcut is a registered trademark, but the author maintains free and unrestricted access to Sailcut.

5.2. Of the complexity of the definition of the surface of a sail

A sail is a complex surface which sailmakers have historically defined by notions like depth at various height and position of the point of maximum depth along the local cord of the profile. This method of defining the surface of the sail by control points allows for an easy comparison of the shape between the intended design and reality. Unfortunately a large number of different surfaces can pass through these few control points. Then notions like the slope at the leading edge and trailing edge of the profiles were introduced to help sailmaker get a better control of the shape of the sail profile. Using interpolation between basic control points, with or without constraints on the tangents at the extremities of the profiles, to determine the depth of the sail in all points were too demanding for old days personal computer processing capability.

From the beginning of my racing activities, I was interested in the aerodynamic of sails. The books "Theory of wings sections" by Ira H. Abbott and Albert E. von Doenhoff, and "Sailing Theory and Practice" by C.A. Marchaj convinced me that the distribution of camber along the profile was the determining factor in the quality of a sail profile. I was very sceptical about the definition of a profile by its depth, the position of its maximum depth along the cord and segments of cubic or quadratic curves on either side. Rather than trying to reproduce existing sail shape based on depth measurements, I looked for a law of distribution of its camber giving a reasonably aerodynamic profile on the complete sail surface. The first attempt was to model directly the distribution of camber, however that required to process simultaneously the first and second derivative of the surface many points of the sail surface, far too much work for my small computer. At the time I was racing on the North Sea often in relatively heavy weather for my ¼ ton and I wanted sail profiles with a high peak of pressure very far forward to fight against the tendency of the depth to move backward as the cloth stretched in increasing winds. I finally selected a simple equation defining only the second derivative of the profile and giving a monotonic decrease of its value along the cord of the profile. Experience showed that with the then available cloth, the leech was sometime falling to leeward in the upper part of the sail. I then introduced a second term in the equation to be able to control the minimum value of the second derivative at the leech. This equation is therefore controlled by only two parameters.

5.3. Some Maths

The coordinate system used is such that the plane X-Y contains the tack, the clew and the head of the luff. The X axis is horizontal and orientated positively from tack toward clew. The Y axis is vertical orientated upward and the Z axis (depth) is perpendicular to the X-Y plane. Profiles are defined by the intersection of the surface of the sail with an horizontal plane parallel to Z-X plane. The depth Z of any point of a given profile is a function of the local X ordinate normalised to the profile local cord as shown in the figure below.

Figura 6. Sailcut coordinate system

Sailcut coordinate system

The following equation is used to describe the second derivative of the profile function of X:

Z''= K*[-A*(1-X)^AV - AR*X]

After a first integration it gives the slope of the profile:

Z'= K*[A*(1 - X)^(AV + 1) / (AV+1) - AR/2 * X^2 + C]

Finally after a second integration the equation giving the depth at any point is:

Z = K*[-A*(1-X)^(AV+2) / (( AV+2)*(AV+1)) - AR/6 * X^3 + C*X + B]

To meet the profile end conditions (X=0, Z=0) and (X=1, Z=0) the constants B and C are:

B = A / ((AV + 2) * (AV + 1))
C = AR / 6 - B

The maximum depth is obtained when the slope Z' is equal to zero, this allow to calculate K such that the depth at that point is the one desired.

The factors AV and AR give a measure of the camber at the leading edge (AV) and trailing edge (AR). Together with the maximum depth value these factors are sufficient to describe the profile of the sail at any height.

The factor A defines different families of profiles with a different distribution of fullness fore/aft. In practice A = 1 give good profiles for sails used in light conditions. I prefer to use sail profiles with more fullness forward and a flatter leech as obtained with the factor A = 1 + AV / 4. This is the factor used in Sailcut and it give a good range of utilisation of the sails.

The following table give an example of profile data obtained with the above equations.

AV = 5.00
AR = 0.02
K = 2.94
A = 2.250
B = 0.054
C =-0.050
curvature = z" / (1+ z'*z')^3/2

x

z"

z'

z

curvature

0.0

-6.615

0.955

0.00

-2.503

0.1

-3.912

0.438

0.0674

-3.007

0.2

-2.179

0.140

0.0949

-2.117

0.3

-1.129

-0.021

0.1000

-1.129

0.4

-0.538

-0.101

0.0934

-0.530

0.5

-0.236

-0.138

0.0812

-0.230

0.6

-0.103

-0.154

0.0665

-0.099

0.7

-0.057

-0.161

0.0507

-0.055

0.8

-0.049

-0.166

0.0343

-0.047

0.9

-0.053

-0.172

0.0174

-0.051

1.0

-0.059

-0.177

0.00

-0.056

Having defined a single equation for all profiles it is a matter of varying the maximum depth and the factors AV and AR as function of the height of the profile to generate the complete surface of the sail. The profile at foot level being always an arc of circle, the factors AV and AR are equal to zero and only the depth of the foot is entered by the user. A profile called «mid profile» is located around the middle of the height and the factors AV and AR are set such that the profile has the required shape. A third control profile defined as for the "mid profile" is located at the top of the sail. For all other profiles the depth value is interpolated by a quadratic equation and the factors AV and AR are interpolated linearly between between the foot, the middle and top values.

In total 3 values of depth, 2 pairs of factor (AV, AR) and the vertical position of the "mid profile" are used to define the basic mould of the sail.

Note that in Sailcut software the value displayed for the luff factor is equal to the AV ceofficient while the leech factor displayed is 50 time the AR coefficient used in the above equations such that the users can use more friendly range of data than second and third decimal figures.

5.4. Other aspects of the surface formulation

The above basic mould is not sufficient to define a real sail. Indeed the luff, gaff, leech and foot of the sail are never straight and further more the sail profiles are always twisted from the foot to the top of the sail. I use the distance from the point of maximum round to the straight line and two arcs of parabola rejoining the adjacent corners to define the real edges of the sail. The profiles defined by the sail mould described above are resting on the real edges of the sail. The twist of the sail is finally obtained by applying to each profile a rotation around the leading edge end point.

It is to be noted that this method of modelling the surface of sails gives shapes without bumps or hollows and guarantees that there is no inversion of camber in the profiles. The method is applicable to triangular and quadrangular sails and Sailcut is commonly used for designing old timers gaff sails.

6. Where can I find more information about Sailcut CAD?

The Sailcut CAD project lives at http://sailcut.sourceforge.net/. This is where you will find links to all matters related to Sailcut CAD!

6.1. I think I found a bug, what should I do?

Sailcut CAD is constantly under development and feedback from users is very welcome! If you think you found bug, visit Sailcut's homepage , you will find instructions in the "Reporting a Bug" section.

6.2. I would like to help develop Sailcut CAD, what should I do?

You can help us improve Sailcut even if you are not a programmer! Simply using Sailcut and reporting any bugs you might find is of considerable help to us. We are also looking for people to help keep translations up to date and to produce new translations. If you are interested in translating Sailcut into your native language, visit the Sailcut CAD homepage and send an email to the development mailing list!

If you have some knowledge of C++ and are interested in making Sailcut CAD a better program, visit the Sailcut CAD homepage where you will find both snapshots of the Sailcut CAD code and how to access to the CVS repository. Once you have had a chance to familiarise yourself with the code, contact us via the forums or our mailing lists!

7. File formats used by Sailcut CAD

7.1. Text representation of developed sail

This section describes the structure of the file generated by Sailcut CAD using the menu File->Export development->to TXT sail. The extension of a text sail file is ".txt".

A sail is made of a number of panels, each panel has 4 basic sides : left, top, right, bottom which are joined by a drawing line. The origin is at the bottom left corner of a rectangle surrounding the panel. These four basic sides define the net area of the panel after assembly in the sail.

Around the basic panel there is provision for stiching the panels and sail edge hems, the outer side of the panel is defined by four sides named cutLeft, cutTop, cutRight, cutBottom and the material is cut along these sides.

Depending on whether or not you have added material for hems around the sail some of these sides may be identical to the basic sides of the panel.

Test main sail cross cut (flat)   // name of the sail
===== CPanel : 0 ====           // begining of panel 0
== CPanelLabel : name ==        // marker for panel label name
0
== CPanelLabel : height ==      // marker for label height
5
== CPanelLabel : color ==       // marker for label color
1
== CPanelLabel : origin ==      // marker for label origin coordinates
427.717 764.064 0               // X Y Z coordinates (Z is always =0)
== CPanelLabel : direction ==   // marker for label orientation
168.204 -57.8975        0
== CSide : left ==              // begin left side of panel
#0      92.5718 886.006 0       // X Y Z coordinates of point 0
#1      92.5718 886.006 0       // X Y Z coordinates of point 1
...
== CSide : top ==               // begin top side
#0      92.5718 886.006 0       // X Y Z coordinates of point 0
#1      262.77  886.006 0
...
== CSide : right ==             // begin right side
#0      3533.09 25.5986 0
#1      3526.2  169.113 0
...
== CSide : bottom ==            // begin bottom side
#0      92.5718 886.006 0
#1      259.921 823.943 0
...
== CSide : cutLeft ==           // begin left cut line
#0      0       899.006 0       // X Y Z coordinates of point 0
    of left cut line 
#1      0       899.006 0
...
== CSide : cutTop ==            // begin top cut line
#0      1150.25 899.006 0
#1      262.77  899.006 0
...
== CSide : cutRight ==          // begin right cut line
#0      3574.36 0       0
#1      3566.15 171.031 0
...
== CSide : cutBottom ==         // begin bottom cut line
#0      0       899.006 0
#1      252.966 805.191 0
...
===== CPanel : 1 ====           // beginning of panel 1
== CPanelLabel : name ==        // marker for panel label name
1
== CPanelLabel : height ==
5
== CPanelLabel : color ==
1
== CPanelLabel : origin ==
889.341 2.64113 0
== CPanelLabel : direction ==
170.396 0.562482        0
== CSide : left ==
#0      548.746 0.388633        0
#1      367.439 68.706  0
...
== CSide : top ==
#0      203.679 871.331 0
#1      393.052 872.078 0
...

7.2. Text representation of 3D sail

This section describes the structure of the file generated by Sailcut CAD using the menu File->Export 3D sail->to TXT sail. The extension of a text sail file is ".txt".

A 3D sail is made of a number of panels, each panel has 4 basic sides : left, top, right, bottom which are joined by a drawing line.

Test main sail cross cut (3D)   // name of the sail
===== CPanel : 0 ====           // begining of panel 0
== CPanelLabel : name ==        // marker for panel label name
0
== CPanelLabel : height ==      // marker for label height
5
== CPanelLabel : color ==       // marker for label color
1
== CPanelLabel : origin ==      // marker for label origin coordinates
427.717 764.064 0               // X Y Z coordinates (Z is always =0)
== CPanelLabel : direction ==   // marker for label orientation
168.204 -57.8975        0
== CSide : left ==              // begin left side of panel
#0      92.5718 886.006 0       // X Y Z coordinates of point 0
#1      92.5718 886.006 0       // X Y Z coordinates of point 1
...
== CSide : top ==               // begin top side
#0      92.5718 886.006 0       // X Y Z coordinates of point 0
#1      262.77  886.006 0
...
== CSide : right ==             // begin right side
#0      3533.09 25.5986 0
#1      3526.2  169.113 0
...
== CSide : bottom ==            // begin bottom side
#0      92.5718 886.006 0
#1      259.921 823.943 0
...
===== CPanel : 1 ====           // beginning of panel 1
== CPanelLabel : name ==        // marker for panel label name
1
== CPanelLabel : height ==
5
== CPanelLabel : color ==
1
== CPanelLabel : origin ==
889.341 2.64113 0
== CPanelLabel : direction ==
170.396 0.562482        0
== CSide : left ==
#0      548.746 0.388633        0
#1      367.439 68.706  0
...
== CSide : top ==
#0      203.679 871.331 0
#1      393.052 872.078 0
...

7.3. XML representation of a sail

This describe the structure of the file generated by Sailcut using the menu File->Export development->to XML sail or File->Export 3D sail->to XML sail. The extension of an XML sail file is ".sail3d".

A sail is made of a number of panels Each panel has 4 basic sides : left, top, right, bottom which are joined by a drawing line. The origin is at the bottom left corner of a rectangle surrounding the panel. These four basic sides define the net area of the panel after assembly in the sail. Around the basic panel there is provision for stiching the panels and sail edge hems, the outer side of the panel is defined by four sides named cutLeft, cutTop, cutRight, cutBottom and the material is cut along these sides. Depending on whether or not you have added material for hems around the sail some of these sides may be identical to the basic sides of the panel.

<!DOCTYPE Sailcut >
<CSailDoc>                          // header begin file
<CSail name="sail" >                // begin sail + name of sail
<vector size="10" name="panel" >    // indicate that the sail is made
                                       of 10 panels
<CPanel name="0" >                  // begin panel 0
<CSide name="left" >                // begin of left side of the panel
<vector size="7" name="point" >     // number of points on left side is 7
<CPoint3d name="0" >                // first point = 0
<real value="92.5718" name="x" />   // first point coordinate X
<real value="886.006" name="y" />   // first point coordinate Y
<real value="0" name="z" />         // coordinate Z is always 0 
        // for a developped panel
</CPoint3d>                         // end of first point
<CPoint3d name="1" >                // second point = 1                             
<real value="92.5718" name="x" />                
<real value="886.006" name="y" />
<real value="0" name="z" />
</CPoint3d>                         // end of second point 
 ...
</vector>                           // end of list of left side points
</CSide>                            // end of left side 
<CSide name="top" >                 // begin top side
<vector size="21" name="point" >    // number of points on top side is 21
<CPoint3d name="0" >                // first point = 0
<real value="92.5718" name="x" />
<real value="886.006" name="y" />
<real value="0" name="z" />
</CPoint3d>
<CPoint3d name="1" >                // second point = 1
<real value="262.77" name="x" />
<real value="886.006" name="y" />
<real value="0" name="z" />
</CPoint3d>
 ...
</vector>                           // end list of points of top side
</CSide>                            // end top side
<CSide name="right" >               // begin right side
 ...
</CSide>                            // end right side
 
<CSide name="bottom" >              // begin bottom side
 ...
</CSide>                            // end bottom side

<int value="1" name="hasHems" />    // header indicating that the panel 
                                       has hems cloth around the edges
<CSide name="cutLeft" >             // begin left side cut line
<vector size="7" name="point" >     // left side has 7 points 
<CPoint3d name="0" >                // first point = 0
<real value="0" name="x" />
<real value="899.006" name="y" />
<real value="0" name="z" />
</CPoint3d>                         // end first point
 ...
</vector>                           // end list of left side points
</CSide>                            // end left side cut line
<CSide name="cutTop" >              // begin top cut line
 ...
</CSide>                            // end top cut line
<CSide name="cutRight" >            // begin right cut line
 ...
</CSide>                            // end right cut line
<CSide name="cutBottom" >           // begin bottom cut line
 ...
</CSide>                            // end bottom cut line
</CPanel>                           // end of first panel
<CPanel name="1" >                  // begin second panel = 1
<CSide name="left" >                // begin left side
<vector size="7" name="point" >
<CPoint3d name="0" >
<real value="548.746" name="x" />
<real value="0.388633" name="y" />
<real value="0" name="z" />
</CPoint3d>
 ...
</vector>
</CSide>                            // end left side
 ...
 ...
</CSail>                            // end sail
</CSailDoc>                         // end file

8. Copyright

Copyright (C) 1993-2005 Robert & Jeremy Lainé.

Sailcut is a Registered Trademark of Robert Lainé.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. See http://www.fsf.org/ for the licence terms and details.

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 General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

The authors would appreciate that publications on sails designed with Sailcut include some acknowledgement of their work.