Difference between revisions of "FR/Documentation/Les formes (shapes)"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Style des lignes)
m (Style des lignes)
Line 372: Line 372:
 
[[Image:shape1.png|center]]
 
[[Image:shape1.png|center]]
 
Voir aussi <idl>com.sun.star.drawing.LineDash</idl> and <idl>com.sun.star.drawing.LineStyle</idl>.
 
Voir aussi <idl>com.sun.star.drawing.LineDash</idl> and <idl>com.sun.star.drawing.LineStyle</idl>.
 
+
 
+
=Dessiner des formes=
 
+
==La forme “polyligne”==
 
+
 
+
 
+
 
+
 
+
Figure 6 Dernier exemple
+
Dessiner des formes
+
La forme “polyligne”  
+
 
La première fois que nous abordons les polylignes il nous faut comprendre la notion de  
 
La première fois que nous abordons les polylignes il nous faut comprendre la notion de  
 
Sequence < Sequence < Point >> ? Pour ce faire une description à l'aide des classiques fichiers IDL s'impose. Nous en donnons deux dans les listings  100 et 101 qui suivent :
 
Sequence < Sequence < Point >> ? Pour ce faire une description à l'aide des classiques fichiers IDL s'impose. Nous en donnons deux dans les listings  100 et 101 qui suivent :
 
+
<source lang="idl">
Listing 100 PointSequenceSequence IDL File
+
//Listing 17 PointSequenceSequence IDL File
 
// IDL
 
// IDL
 
module com { module sun { module star { module drawing {
 
module com { module sun { module star { module drawing {
 
typedef sequence<PointSequence> PointSequenceSequence;
 
typedef sequence<PointSequence> PointSequenceSequence;
 
}; }; }; };  
 
}; }; }; };  
 
+
</source>
 
Qu'est-ce alors qu'une  PointSequence ?
 
Qu'est-ce alors qu'une  PointSequence ?
 
+
<source lang="idl">
Listing 101 PointSequence IDL File
+
//Listing 18 PointSequence IDL File
 
// IDL
 
// IDL
 
module com { module sun { module star { module drawing {
 
module com { module sun { module star { module drawing {
 
typedef sequence<com::sun::star::awt::Point> PointSequence;
 
typedef sequence<com::sun::star::awt::Point> PointSequence;
 
}; }; }; };  
 
}; }; }; };  
 +
</source>
 
We can have a look at PolyLineShape now :
 
We can have a look at PolyLineShape now :
Listing 102 PolyLineShape IDL File  
+
<source lang="idl">
 +
//Listing 19 PolyLineShape IDL File  
 
// IDL
 
// IDL
 
  module com {  module sun {  module star {  module drawing {
 
  module com {  module sun {  module star {  module drawing {
Line 413: Line 407:
 
};
 
};
 
}; }; }; };
 
}; }; }; };
 
+
</source>
 
Les autres fichiers IDL fque nous avons à inspecter sont le service PolyPolygonDescriptor  :
 
Les autres fichiers IDL fque nous avons à inspecter sont le service PolyPolygonDescriptor  :
  
Listing 103 Fichier IDL du service PolyPolygonDescriptor  
+
Listing 20 Fichier IDL du service PolyPolygonDescriptor  
 
// IDL
 
// IDL
 
module com {  module sun {  module star {  module drawing {
 
module com {  module sun {  module star {  module drawing {
Line 426: Line 420:
 
};
 
};
 
}; }; }; };
 
}; }; }; };
 +
</source>
 
où nous voyons que PolyPolygon est une propriété. Ces fichiers nous permettent de tirer des règles quant à leurs utilisations.
 
où nous voyons que PolyPolygon est une propriété. Ces fichiers nous permettent de tirer des règles quant à leurs utilisations.
construire en premier lieu une séquence de séquence de points et mettre des valeurs dedans.
+
* Construire en premier lieu une séquence de séquence de points et mettre des valeurs dedans.
En second lieu la transformer en un type any
+
* En second lieu la transformer en un type any
en dernier lieu utiliser l'interface XpropertySet pour donner des valeurs à la propriété PolyPolygon.
+
* En dernier lieu utiliser l'interface XpropertySet pour donner des valeurs à la propriété PolyPolygon.
 
Cela nous conduit au final à l'exemple suivant :
 
Cela nous conduit au final à l'exemple suivant :
 
+
<source lang="cpp">
Listing 104 Using a Polyline Shape
+
//Listing 21 Using a Polyline Shape
 
// C++
 
// C++
 
Sequence< Sequence< Point > > PointsSeqSeq(2);
 
Sequence< Sequence< Point > > PointsSeqSeq(2);
Line 462: Line 457:
 
Reference< XPropertySet > rPolyShapeProps(rPolyLineShape,UNO_QUERY);
 
Reference< XPropertySet > rPolyShapeProps(rPolyLineShape,UNO_QUERY);
 
rPolyShapeProps->setPropertyValue(OUString::createFromAscii("PolyPolygon"),PropspolyPoly);
 
rPolyShapeProps->setPropertyValue(OUString::createFromAscii("PolyPolygon"),PropspolyPoly);
 
+
</source>
 
Exécuter cet exemple nous donnera la figure présentée ci-dessous.
 
Exécuter cet exemple nous donnera la figure présentée ci-dessous.
  
Si vous remplacez la forme PolyLineShape par la forme PolyPolygonShape dans le code du Listing 104 vous obtiendrez la même forme mais cette fois-ci fermée (et remplie par la couleur par défaut).
+
[[Image:Shape2.png|center|Polyline Example]]
Les formes de Bezier
+
 
 +
Si vous remplacez la forme PolyLineShape par la forme PolyPolygonShape dans le code du Listing 21 vous obtiendrez la même forme mais cette fois-ci fermée (et remplie par la couleur par défaut).
 +
==Les formes de Bezier==
 
Commençons maintenant par décrire la structure centrale de ce genre de forme, à savoir la structure PolyPolygonBezierCoords. Le fichier IDL correspondant est présenté :
 
Commençons maintenant par décrire la structure centrale de ce genre de forme, à savoir la structure PolyPolygonBezierCoords. Le fichier IDL correspondant est présenté :
 
+
<source lang="idl">
Listing 105 PolyPolygonBezierCoords IDL File
+
//Listing 22 PolyPolygonBezierCoords IDL File
 
// IDL
 
// IDL
 
module com {  module sun {  module star {  module drawing {
 
module com {  module sun {  module star {  module drawing {
Line 483: Line 480:
 
};
 
};
 
}; }; }; };   
 
}; }; }; };   
 
+
</source>
 
PointSequenceSequence a déjà été présenté dans la section précédente. Plus de précision sur les drapeaux (flags) est maintenant attendue par le lecteur impatient. Encore une fois, c'est un fichier IDL qui vient à notre secours :
 
PointSequenceSequence a déjà été présenté dans la section précédente. Plus de précision sur les drapeaux (flags) est maintenant attendue par le lecteur impatient. Encore une fois, c'est un fichier IDL qui vient à notre secours :
 
+
<source lang="idl">
Listing 106 Fichier IDL pour l'énumération PolygonFlags  
+
//Listing 23 Fichier IDL pour l'énumération PolygonFlags  
 
// IDL
 
// IDL
 
  module com {  module sun {  module star {  module drawing {
 
  module com {  module sun {  module star {  module drawing {
Line 496: Line 493:
 
SYMMETRIC   
 
SYMMETRIC   
 
};
 
};
}; }; }; };
+
}; }; }; };  
 +
</source>
 
Le service ClosedBezierShape est lui aussi intéressant  :
 
Le service ClosedBezierShape est lui aussi intéressant  :
 
+
<source lang="idl">
Listing 107 ClosedBezierShape Service : IDL File  
+
Listing 24 ClosedBezierShape Service : IDL File  
 
// IDL
 
// IDL
 
  module com {  module sun {  module star {  module drawing {
 
  module com {  module sun {  module star {  module drawing {
Line 512: Line 510:
 
service com::sun::star::drawing::RotationDescriptor;
 
service com::sun::star::drawing::RotationDescriptor;
 
};
 
};
}; }; }; };
+
}; }; }; };  
 +
</source>
 
et encore le service PolyPolygonDescriptor :
 
et encore le service PolyPolygonDescriptor :
 
+
<source lang="idl">
Listing 108 PolyPolygonBezierDescriptor Service : IDL File  
+
Listing 25 PolyPolygonBezierDescriptor Service : IDL File  
 
// IDL
 
// IDL
 
module com {  module sun {  module star {  module drawing {
 
module com {  module sun {  module star {  module drawing {
Line 525: Line 524:
 
};
 
};
 
}; }; }; };   
 
}; }; }; };   
 
+
</source>
 
Ce service est comme au chapitre précédent caractérisé par un ensemble de propriétés. Nous n'avons pas encore rencontré la première  (PolygonKind)  et donc nous sommes obligés d'aller plus avant dans notre quête aux fichiers IDL :
 
Ce service est comme au chapitre précédent caractérisé par un ensemble de propriétés. Nous n'avons pas encore rencontré la première  (PolygonKind)  et donc nous sommes obligés d'aller plus avant dans notre quête aux fichiers IDL :
 
+
<source lang="idl">
Listing 109 PolygonKind Enumeration : IDL File  
+
//Listing 26 PolygonKind Enumeration : IDL File  
 
// IDL
 
// IDL
 
module com {  module sun {  module star {  module drawing {
 
module com {  module sun {  module star {  module drawing {
Line 553: Line 552:
 
};  
 
};  
 
}; }; }; };   
 
}; }; }; };   
 
+
</source>
 
Notez que cette propriété est en lecture seule. Nous avons pour une fois laissé les commentaires pour comprendre les significations des valeurs pas toujours très simple à inférer à partir des seuls noms.
 
Notez que cette propriété est en lecture seule. Nous avons pour une fois laissé les commentaires pour comprendre les significations des valeurs pas toujours très simple à inférer à partir des seuls noms.
 
Le code suivant est une illustration de tout cela par une courbe de Bezier fermée :
 
Le code suivant est une illustration de tout cela par une courbe de Bezier fermée :
 
+
<source lang="cpp">
Listing 110 Forme de Bezier fermée : un exemple
+
//Listing 27 Forme de Bezier fermée : un exemple
 
// C++
 
// C++
 
// Bezier
 
// Bezier
Line 606: Line 605:
 
rClosedBezierShapeProps->setPropertyValue(OUString::createFromAscii
 
rClosedBezierShapeProps->setPropertyValue(OUString::createFromAscii
 
                               ("PolyPolygonBezier"), ClosedBezierProperty);
 
                               ("PolyPolygonBezier"), ClosedBezierProperty);
 
+
</source>
 
En lisant le fichier IDL PolyPolygonBezierShape.idl je déduis que je n'ai qu'à remplacer “ClosedBezierShape” par “PolyPolygonBezierShape pour avoir une forme de Bezier ouverte. Mais cela ne fonctionne pas et je ne sais pas pourquoi pour le moment. Andrew Pitonyak a écrit dans son livre : “toutes les combinaisons de points et de drapeaux ne sont pas valides” et je suppose avoir une mauvaise combinaison des deux.
 
En lisant le fichier IDL PolyPolygonBezierShape.idl je déduis que je n'ai qu'à remplacer “ClosedBezierShape” par “PolyPolygonBezierShape pour avoir une forme de Bezier ouverte. Mais cela ne fonctionne pas et je ne sais pas pourquoi pour le moment. Andrew Pitonyak a écrit dans son livre : “toutes les combinaisons de points et de drapeaux ne sont pas valides” et je suppose avoir une mauvaise combinaison des deux.

Revision as of 13:48, 7 July 2008

Nous décrivons en premier notre nouveau code initial. Il est identique aux codes précédents mais on ajoute quelques procédures pour simplifier le code (d'après Christian Junker ici).

//Listing 1
// C++
// Ne pas oublier la directive : #include <com/sun/star/drawing/XShapes.hpp>
// N'oubliez pas d'ajouter "com.sun.star.drawing.XShapes \" in the makefile
 
// N'oubliez pas d'ajouter : using namespace com::sun::star::beans;
// Ne pas oublier la directive : #include <com/sun/star/beans/XPropertySet.hpp>
// N'oubliez pas d'ajouter "com.sun.star.beans.XPropertySet \" in the makefile
 
// Christian Junker code
void MakePosition(sal_Int32 x, sal_Int32 y, ::com::sun::star::awt::Point *Pos) 
{ 
 
	Pos->X = x; 
	Pos->Y = y; 
} 
 
void MakeSize(sal_Int32 width, sal_Int32 height, ::com::sun::star::awt::Size *Size) 
{ 
	Size->Width = width; 
	Size->Height = height; 
} 
 
void DrawMe(Reference< XShape > &Shape, Reference< XDrawPage > &page, const char *shapename) 
{ 
	Reference< XShapes > Shapes(page, UNO_QUERY); 
	Shapes->add(Shape); 
	Reference< XPropertySet > shapeprops(Shape, UNO_QUERY); 
	shapeprops->setPropertyValue(OUString::createFromAscii("Name"),
					makeAny(OUString::createFromAscii(shapename))); 
}

Avec ces procédures nous commençons maintenant d'une forme de rectangle : notre nouveau code initial principal est alors:

//Listing 2
int main( ) {
//retrieve an instance of the remote service manager
    Reference< XMultiServiceFactory > rOfficeServiceManager;
    rOfficeServiceManager = ooConnect();
    if( rOfficeServiceManager.is() ){
        printf( "Connected sucessfully to the office\n" );
    }
 
//get the desktop service using createInstance returns an XInterface type
    Reference< XInterface  > Desktop = rOfficeServiceManager->createInstance(
    OUString::createFromAscii( "com.sun.star.frame.Desktop" ));
 
//query for the XComponentLoader interface
    Reference< XComponentLoader > rComponentLoader (Desktop, UNO_QUERY);
    if( rComponentLoader.is() ){
        	printf( "XComponentloader successfully instanciated\n" );
    	}
 
//get an instance of the OOowriter document
    Reference< XComponent > xcomponent = rComponentLoader->loadComponentFromURL(
	OUString::createFromAscii("private:factory/sdraw"),
        OUString::createFromAscii("_blank"),
        0,
        Sequence < ::com::sun::star::beans::PropertyValue >());
 
// added code here
	Reference< XDrawPagesSupplier > rDrawDoc(xcomponent, UNO_QUERY);
 
// query the XDrawPages Interface
	Reference< XDrawPages > rDrawPages = rDrawDoc->getDrawPages();
 
// query the XIndexAccess Interface
	Reference< XIndexAccess > rPageIndexAccess(rDrawPages, UNO_QUERY);
 
	Any DrawPage = rPageIndexAccess->getByIndex(0);
 
// Query the XDrawPage Interface
	Reference< XDrawPage > rDrawPage(DrawPage, UNO_QUERY);
// query for the XNamed Interface
	Reference< XNamed > rNamed(DrawPage, UNO_QUERY);
	rNamed->setName(OUString::createFromAscii("My first page"));
 
	Reference< XMultiServiceFactory > DocFactory(xcomponent, UNO_QUERY);
 
	Point *Pos = new (Point);
	Size *TheSize = new ( Size );
 
	Reference< XInterface > RectangleShape = DocFactory->createInstance(
	               OUString::createFromAscii("com.sun.star.drawing.RectangleShape") );
	Reference< XShape > rRectShape(RectangleShape, UNO_QUERY);
	MakePosition(2000, 6000, Pos);
	MakeSize(7000, 2000, TheSize);
	rRectShape->setPosition(*Pos);
	rRectShape->setSize(*TheSize);
	DrawMe(rRectShape, rDrawPage, "My TextShape");
 
// add code here 
 
    return 0;
}

Ce code dessine un rectangle coloré en bleu.

Les propriétés de la forme

Couleurs d'arrière plan et des formes

La forme est créée habituellement avec une couleur uniforme d'arrière plan par défaut. Il est naturellement possible de changer ceci. Pour comprendre comment cela fonctionne, un petit tour vers le fichier IDL <OpenOffice.org1.1_SDK>/idl/com/sun/star/drawing/fillstyle.idl nous sera nécessaire :

//Listing 3 Détail du fichier FillStyle.idl
// IDL
module com {  module sun {  module star {  module drawing {
enum FillStyle
{
	NONE,
	SOLID,
	GRADIENT, 
	HATCH, 
	BITMAP  
}; 
}; }; }; };

Ce problème a déjà été abordé dans le chapitre “4.5.1 Exemple de calcul de la fonction”: nous pouvons déduire de ce fichier IDL que nos constantes dans C++ seront : FillStyle_NONE, FillStyle_SOLID,... et FillStyle_BITMAP et nous devons construire les fichiers hpp et hxx correspondants. Le deuxième problème est de savoir comment traduire ce bout de code OOoBasic :

'Listing 4
REM  *****  BASIC  *****
MaForme.FillColor = RGB(255,200,255)
MaForme.FillStyle = com.sun.star.drawing.FillStyle.NONE

Est-ce que le FillStyle est une propriété et qu'en est-il du FillColor? Pour chercher une réponse nous retournons à un fichier IDL qui se nomme FillProperties.idl :

 
//Listing 5
// IDL
module com { module sun { module star { module drawing {
service FillProperties
{
	[property] com::sun::star::drawing::FillStyle FillStyle;
	[property] long FillColor;
	[property] short FillTransparence;
	[property] string FillTransparenceGradientName;
	[optional, property] com::sun::star::awt::Gradient FillTransparenceGradient;
	[property] string FillGradientName;
	[optional, property] com::sun::star::awt::Gradient FillGradient;
	[property] string FillHatchName;
	[optional, property] com::sun::star::drawing::Hatch FillHatch;
	[property] string FillBitmapName;
	[optional, property] com::sun::star::awt::XBitmap FillBitmap;
	[optional, property] string FillBitmapURL;
	[property] short FillBitmapOffsetX;
	[property] short FillBitmapOffsetY;
	[property] short FillBitmapPositionOffsetX;
	[property] short FillBitmapPositionOffsetY;
	[property] com::sun::star::drawing::RectanglePoint FillBitmapRectanglePoint;
	[property] boolean FillBitmapLogicalSize;
	[property] long FillBitmapSizeX;
	[property] long FillBitmapSizeY;
	[property] com::sun::star::drawing::BitmapMode FillBitmapMode;
	[property] boolean FillBackground;
};
}; }; }; };

Les deux premières propriétés semblent intéressantes pour nous. Nous commençons avec FillColor. Si nous ajoutons ce code nous obtenons un rectangle avec une autre couleur.

 
//Listing 6
// C++
// N'oubliez pas d'ajouter : using namespace com::sun::star::beans;
// N'oubliez pas d'ajouter la directive : #include <com/sun/star/beans/XPropertySet.hpp>
// N'oubliez pas d'ajouter "com.sun.star.beans.XPropertySet \" dans le makefile
 
// Get the property set of the rRectShape 
	Reference< XPropertySet > rShapeProps(rRectShape,UNO_QUERY);
	Any color;
	color<<=(long)0xFF00;  //green
	rShapeProps->setPropertyValue(OUString::createFromAscii("FillColor"),color);

La couleur est définie en RVB (Rouge Vert Bleu) : un octet pour chaque couleur : 0xff0000 est rouge, 0x00ff00 est vert et 0x0000ff est bleu. Il est temps de changer la couleur de l'arrière plan avec la constante prédéfinie FillStyle_NONE. Cela se fait simplement en ajoutant ce code :

 
//Listing 7 Positionner la couleur 
// C++
// N'oubliez pas d'ajouter la directive : #include <com/sun/star/drawing/FillStyle.hpp>
// N'oubliez pas d'ajouter "com.sun.star.drawing.FillStyle \" in the makefile
 
	Any FillStyle;
	FillStyle <<= FillStyle_NONE;
	rShapeProps->setPropertyValue(OUString::createFromAscii("FillStyle"),FillStyle);

Nous arrêtons ici mais il y a beaucoup à faire avec les autres constantes FillStyle.

Forme et Ombre

L'ombre est décrite par le fichier ShadowProperties.idl que nous présentons maintenant :

 
//Listing 8 Fichier ShadowProperties.idl
// IDL
module com {  module sun {  module star {  module drawing {
service ShadowProperties
{
	[property] boolean Shadow;
	[property] long ShadowColor;
	[property] short ShadowTransparence;
	[property] long ShadowXDistance;
	[property] long ShadowYDistance;
};
}; }; }; };

Ensuite le code correspondant en C++ pour manipuler ces propriétés peut être :

 
//Listing 9 Manipuler les ombres
// C++
// Shadow
	Any ShadowProperties[4];
	ShadowProperties[0] <<= (sal_Bool)true;
	ShadowProperties[1] <<= (long) 0xFF0000; // rouge
	ShadowProperties[2] <<= (long) 300;
	ShadowProperties[3] <<= (long) 300;
	rShapeProps->setPropertyValue(OUString::createFromAscii("Shadow"),ShadowProperties[0]);
	rShapeProps->setPropertyValue(OUString::createFromAscii("ShadowColor"),ShadowProperties[1]);
	rShapeProps->setPropertyValue(OUString::createFromAscii("ShadowXDistance"),ShadowProperties[2]);
	rShapeProps->setPropertyValue(OUString::createFromAscii("ShadowYDistance"),ShadowProperties[3]);

lequel dessine une ombre rouge à la forme rectangulaire.

La Rotation de la forme et sa déformation

Pour une rotation, le fichier IDL correspondant est :

 
//Listing 10 Fichier RotationDescriptor.idl
// IDL
module com {  module sun {  module star {  module drawing {
service RotationDescriptor
{
/** This is the angle for rotation of this Shape.
	The shape is rotated counter-clockwise around the center of the bounding box. */
 
	[property] long RotateAngle;
	[optional, property] long ShearAngle;
};
}; }; }; };

L'angle est donné en 1/100° commençant d'une ligne horizontale. Ainsi le code du Listing 11 ci-dessous donne une rotation de 30°.

 
//Listing 11
// C++
	Any Angle;
	Angle <<= (long)3000; // 30 degres
	rShapeProps->setPropertyValue(OUString::createFromAscii("RotateAngle"),Angle);

Abordons maintenant un problème différent, celui des styles de lignes.

Style des lignes

Les fichiers IDL correspondants sont donnés maintenant. Commençons par le fichier LineProperties.idl

 
// Listing 12 Le fichier LineProperties.idl
// IDL
module com {  module sun {  module star {  module drawing {
service LineProperties
{
	[property] com::sun::star::drawing::LineStyle LineStyle;
	[property] com::sun::star::drawing::LineDash LineDash;
	[property] long LineColor;
	[property] short LineTransparence;
	[property] long LineWidth; 
	[property] com::sun::star::drawing::LineJoint LineJoint; 
	[optional, property] string LineStartName;
	[optional, property] com::sun::star::drawing::PolyPolygonBezierCoords LineStart; 
	[optional, property] com::sun::star::drawing::PolyPolygonBezierCoords LineEnd; 
	[optional, property] boolean LineStartCenter; 
	[optional, property] long LineStartWidth; 
	[optional, property] boolean LineEndCenter; 
	[optional, property] long LineEndWidth; 
}; 
}; }; }; };

Regardons maintenant le fichier LineStyle.idl : il définit une énumération qui est maintenant présentée.

 
//Listing 13 L'énumération LineStyle
// IDL
module com {  module sun {  module star {  module drawing {
enum LineStyle
{
	NONE,
	SOLID, 
	DASH
};
}; }; }; };

Nous donnons la signification de ces constantes :

styles de lignes
Constante Signification
NONE La ligne est invisible
SOLID Ligne continue (valeur par défaut)
DASH Ligne en tirets; La propriété LineDash contrôle la forme du tiret

Pour être complet, il nous faut maintenant regarder le fichier LineDash.idl qui définit une structure.

 
//Listing 14 Le fichier LineDash.idl
// IDL
module com {  module sun {  module star {  module drawing {
struct LineDash
{
	com::sun::star::drawing::DashStyle Style;
	short Dots; 
	long DotLen; 
	short Dashes; 
	long DashLen; 
	long Distance; 
};
}; }; }; };

Regardons les significations de chacun des champs :

lineDash properties
Propriété Signification
Style Une constante ( com.sun.star.drawing.DashStyle.xxx) qui donne le style de tirets
Dots Combien de points
DotLen Longueur des points en 1/100 mm
Dashes Combien de tirets
DashLen Longueur des tirets en 1/100 mm
Distance distance entre les points en 1/100 mm

Les styles en tirets sont donnés par une énumération comme le montre le fichier DashStyle.idl ci-dessous :

 
//Listing 15 Enumération définie par le fichier DashStyle.idl
// IDL
module com {  module sun {  module star {  module drawing {
enum DashStyle
{
	RECT,
	ROUND,
	RECTRELATIVE,
	ROUNDRELATIVE 
};
}; }; }; };

Voici un exemple en C++ qui utilise le style des lignes :

 
//Listing 16 Exemple complet d'utilisation des styles des lignes
// C++
// Line dash
// N'oubliez pas d'ajouter : #include <com/sun/star/drawing/LineDash.hpp>
// N'oubliez pas d'ajouter "com.sun.star.drawing.LineDash \" dans le makefile
// N'oubliez pas d'ajouter : #include <com/sun/star/drawing/LineStyle.hpp>
// N'oubliez pas d'ajouter "com.sun.star.drawing.LineStyle \" dans le makefile
	LineDash *Tirets = new (LineDash);
	Tirets->Style = DashStyle_RECT;
  	Tirets->Dots = 3;
  	Tirets->DotLen = 50;
  	Tirets->Dashes = 2;
  	Tirets->DashLen = 200;
  	Tirets->Distance = 150;
	Any LineStyle,LineDash,LineWidth;
	LineStyle <<= LineStyle_DASH;
	rShapeProps->setPropertyValue(OUString::createFromAscii("LineStyle"),LineStyle);
	LineDash <<= *Tirets;
	rShapeProps->setPropertyValue(OUString::createFromAscii("LineDash"),LineDash);
	color <<= (long)0xFF00;
	rShapeProps->setPropertyValue(OUString::createFromAscii("LineColor"),color);
	LineWidth <<= (long) 50;
	rShapeProps->setPropertyValue(OUString::createFromAscii("LineWidth"),LineWidth);

Ajouter ce code au précédent donne cette figure :

Shape1.png

Voir aussi com.sun.star.drawing.LineDash and com.sun.star.drawing.LineStyle.

Dessiner des formes

La forme “polyligne”

La première fois que nous abordons les polylignes il nous faut comprendre la notion de Sequence < Sequence < Point >> ? Pour ce faire une description à l'aide des classiques fichiers IDL s'impose. Nous en donnons deux dans les listings 100 et 101 qui suivent :

//Listing 17 PointSequenceSequence IDL File
// IDL
module com { module sun { module star { module drawing {
	typedef sequence<PointSequence> PointSequenceSequence;
}; }; }; };

Qu'est-ce alors qu'une PointSequence ?

//Listing 18 PointSequence IDL File
// IDL
module com { module sun { module star { module drawing {
	typedef sequence<com::sun::star::awt::Point> PointSequence;
}; }; }; };

We can have a look at PolyLineShape now :

//Listing 19 PolyLineShape IDL File 
// IDL
 module com {  module sun {  module star {  module drawing {
service PolyLineShape
{
	service com::sun::star::drawing::Shape;
	service com::sun::star::drawing::LineProperties;
	service com::sun::star::drawing::PolyPolygonDescriptor;
	service com::sun::star::drawing::Text;
	service com::sun::star::drawing::ShadowProperties;
	service com::sun::star::drawing::RotationDescriptor;
};
}; }; }; };

Les autres fichiers IDL fque nous avons à inspecter sont le service PolyPolygonDescriptor  :

Listing 20 Fichier IDL du service PolyPolygonDescriptor // IDL module com { module sun { module star { module drawing { service PolyPolygonDescriptor { [readonly, property] com::sun::star::drawing::PolygonKind PolygonKind; [property] com::sun::star::drawing::PointSequenceSequence PolyPolygon; [property] com::sun::star::drawing::PointSequenceSequence Geometry; }; }; }; }; }; </source> où nous voyons que PolyPolygon est une propriété. Ces fichiers nous permettent de tirer des règles quant à leurs utilisations.

  • Construire en premier lieu une séquence de séquence de points et mettre des valeurs dedans.
  • En second lieu la transformer en un type any
  • En dernier lieu utiliser l'interface XpropertySet pour donner des valeurs à la propriété PolyPolygon.

Cela nous conduit au final à l'exemple suivant :

//Listing 21 Using a Polyline Shape
	// C++
	Sequence< Sequence< Point > > PointsSeqSeq(2);
	Sequence< Point > PointsArray(4);
	//Size *TheSize = new ( Size );
 
	Reference< XInterface > PolyLineShape = DocFactory->createInstance(
	               OUString::createFromAscii("com.sun.star.drawing.PolyLineShape") );
	Reference< XShape > rPolyLineShape(PolyLineShape, UNO_QUERY);
	MakePosition(1100, 8000, &PointsArray[0]);
	MakePosition(1500, 6000, &PointsArray[1]);
	MakePosition(1900, 8000, &PointsArray[2]);
	MakePosition(2300, 6000, &PointsArray[3]);
 
	PointsSeqSeq[0]=PointsArray;
 
	PointsArray.realloc(5);
	MakePosition(1100, 9000, &PointsArray[0]);
	MakePosition(1500, 7000, &PointsArray[1]);
	MakePosition(1900, 9000, &PointsArray[2]);
	MakePosition(2300, 7000, &PointsArray[3]);
	MakePosition(2700, 9000, &PointsArray[4]);
	PointsSeqSeq[1]=PointsArray;
 
	DrawMe(rPolyLineShape, rDrawPage, "");
 
	Any PropspolyPoly;
	PropspolyPoly <<= PointsSeqSeq;
	Reference< XPropertySet > rPolyShapeProps(rPolyLineShape,UNO_QUERY);
	rPolyShapeProps->setPropertyValue(OUString::createFromAscii("PolyPolygon"),PropspolyPoly);

Exécuter cet exemple nous donnera la figure présentée ci-dessous.

Polyline Example

Si vous remplacez la forme PolyLineShape par la forme PolyPolygonShape dans le code du Listing 21 vous obtiendrez la même forme mais cette fois-ci fermée (et remplie par la couleur par défaut).

Les formes de Bezier

Commençons maintenant par décrire la structure centrale de ce genre de forme, à savoir la structure PolyPolygonBezierCoords. Le fichier IDL correspondant est présenté :

//Listing 22 PolyPolygonBezierCoords IDL File
// IDL
module com {  module sun {  module star {  module drawing {
 
struct PolyPolygonBezierCoords
{
	// DocMerge: empty anyway
	com::sun::star::drawing::PointSequenceSequence Coordinates; 
 
	// DocMerge: empty anyway
	com::sun::star::drawing::FlagSequenceSequence Flags;
 
};
}; }; }; };

PointSequenceSequence a déjà été présenté dans la section précédente. Plus de précision sur les drapeaux (flags) est maintenant attendue par le lecteur impatient. Encore une fois, c'est un fichier IDL qui vient à notre secours :

//Listing 23 Fichier IDL pour l'énumération PolygonFlags 
// IDL
 module com {  module sun {  module star {  module drawing {
enum PolygonFlags
{
	NORMAL,
	SMOOTH, 
	CONTROL, 
	SYMMETRIC  
};
}; }; }; };

Le service ClosedBezierShape est lui aussi intéressant  :

Listing 24 ClosedBezierShape Service : IDL File 
// IDL
 module com {  module sun {  module star {  module drawing {
service ClosedBezierShape
{
	service com::sun::star::drawing::Shape;
	service com::sun::star::drawing::LineProperties;
	service com::sun::star::drawing::FillProperties;
	service com::sun::star::drawing::PolyPolygonBezierDescriptor;
	service com::sun::star::drawing::Text;
	service com::sun::star::drawing::ShadowProperties;
	service com::sun::star::drawing::RotationDescriptor;
};
}; }; }; };

et encore le service PolyPolygonDescriptor :

Listing 25 PolyPolygonBezierDescriptor Service : IDL File 
// IDL
module com {  module sun {  module star {  module drawing {
service PolyPolygonBezierDescriptor
{
	[readonly, property] com::sun::star::drawing::PolygonKind PolygonKind;
	[property] com::sun::star::drawing::PolyPolygonBezierCoords PolyPolygonBezier;
	[property] com::sun::star::drawing::PolyPolygonBezierCoords Geometry;
};
}; }; }; };

Ce service est comme au chapitre précédent caractérisé par un ensemble de propriétés. Nous n'avons pas encore rencontré la première (PolygonKind) et donc nous sommes obligés d'aller plus avant dans notre quête aux fichiers IDL :

//Listing 26 PolygonKind Enumeration : IDL File 
// IDL
module com {  module sun {  module star {  module drawing {
enum PolygonKind
{
	/** This is the PolygonKind for a LineShape.	 */
	LINE,
	/** This is the PolygonKind for a PolyPolygonShape.	 */
	POLY,
	/** This is the PolygonKind for a PolyLineShape.	 */
	PLIN, 
	/** This is the PolygonKind for an OpenBezierShape.	 */
	PATHLINE, 
	/** This is the PolygonKind for a ClosedBezierShape.	 */
	PATHFILL, 
	/** This is the PolygonKind for an OpenFreeHandShape.	 */
	FREELINE, 
	/** This is the PolygonKind for a ClosedFreeHandShape.	 */
	FREEFILL, 
	/** This is the PolygonKind for a PolyPolygonPathShape.	 */
	PATHPOLY, 
	/** This is the PolygonKind for a PolyLinePathShape.	 */
	PATHPLIN 
}; 
}; }; }; };

Notez que cette propriété est en lecture seule. Nous avons pour une fois laissé les commentaires pour comprendre les significations des valeurs pas toujours très simple à inférer à partir des seuls noms. Le code suivant est une illustration de tout cela par une courbe de Bezier fermée :

//Listing 27 Forme de Bezier fermée : un exemple
// C++
// Bezier
// Don't forget to add : #include <com/sun/star/drawing/PolyPolygonBezierCoords.hpp>
// Don't forget to add "com.sun.star.drawing.PolyPolygonBezierCoords \" in the makefile
 
	struct PolyPolygonBezierCoords BezierCords;
 
// we suppose we use the previous declarations of PointsSeqSeq and PointsArray 
// (previous chapter on PolyPolygonShape) : we then only realloc
 
	PointsSeqSeq.realloc(1);
	PointsArray.realloc(4);
 
	MakePosition(1000, 1000, &PointsArray[0]);
	MakePosition(3000, 4000, &PointsArray[1]);
	MakePosition(3000, 4000, &PointsArray[2]);
	MakePosition(5000, 1000, &PointsArray[3]);
	PointsSeqSeq[0]=PointsArray;
	BezierCords.Coordinates = PointsSeqSeq;
 
// Don't forget to add : #include <com/sun/star/drawing/FlagSequenceSequence.hpp>
// Don't forget to add "com.sun.star.drawing.FlagSequenceSequence \" in the makefile
// Don't forget to add : #include <com/sun/star/drawing/FlagSequence.hpp>
// Don't forget to add "com.sun.star.drawing.FlagSequence \" in the makefile
	FlagSequenceSequence flagsSeqSeq(1);
	FlagSequence flagsSeq(4);
 
// Don't forget to add : #include <com/sun/star/drawing/PolygonFlags.hpp>
// Don't forget to add "com.sun.star.drawing.PolygonFlags \" in the makefile
	flagsSeq[0] = PolygonFlags_NORMAL;
	flagsSeq[1] = PolygonFlags_CONTROL;
	flagsSeq[2] = PolygonFlags_CONTROL;
	flagsSeq[3] = PolygonFlags_NORMAL;
	flagsSeqSeq[0] = flagsSeq;
	BezierCords.Flags = flagsSeqSeq;
// PolyPolygonBezier is a property => construct a Any type;
	Any ClosedBezierProperty;
	ClosedBezierProperty <<= BezierCords;
// create the PolyPolygonBezierShape Service
	Reference< XInterface > closedBezierShape = DocFactory->createInstance(
	               OUString::createFromAscii("com.sun.star.drawing.ClosedBezierShape") );
	Reference< XShape > rClosedBezierShape(closedBezierShape, UNO_QUERY);
	if (! rClosedBezierShape.is()) printf("****Pb with Bezier\n");
	DrawMe(rClosedBezierShape, rDrawPage, "");
// Adjust the properties :
	Reference< XPropertySet > rClosedBezierShapeProps(rClosedBezierShape,UNO_QUERY);
	rClosedBezierShapeProps->setPropertyValue(OUString::createFromAscii
                               ("PolyPolygonBezier"),	ClosedBezierProperty);

En lisant le fichier IDL PolyPolygonBezierShape.idl je déduis que je n'ai qu'à remplacer “ClosedBezierShape” par “PolyPolygonBezierShape pour avoir une forme de Bezier ouverte. Mais cela ne fonctionne pas et je ne sais pas pourquoi pour le moment. Andrew Pitonyak a écrit dans son livre : “toutes les combinaisons de points et de drapeaux ne sont pas valides” et je suppose avoir une mauvaise combinaison des deux.

Personal tools