Créer et appliquer des effets WordArt en C++

À propos de WordArt ?

WordArt ou Word Art est une fonctionnalité qui permet d’appliquer des effets aux textes pour les faire ressortir. Avec WordArt, par exemple, vous pouvez tracer le contour d’un texte ou le remplir d’une couleur (ou d’un dégradé), ajouter des effets 3D, etc. Vous pouvez également incliner, plier et étirer la forme d’un texte.

WordArt vous permet de traiter un texte comme vous le feriez avec un objet graphique. En général, WordArt se compose d’effets ou de modifications spéciales appliquées aux textes pour les rendre plus attrayants ou visibles.

WordArt dans Microsoft PowerPoint

Pour utiliser WordArt dans Microsoft PowerPoint, vous devez sélectionner l’un des modèles WordArt prédéfinis. Un modèle WordArt est un ensemble d’effets qui s’applique à un texte ou à sa forme.

WordArt dans Aspose.Slides

Dans Aspose.Slides pour C++ 20.10, nous avons ajouté la prise en charge de WordArt et apporté des améliorations à cette fonctionnalité dans les versions ultérieures d’Aspose.Slides pour C++.

Avec Aspose.Slides pour C++, vous pouvez facilement créer votre propre modèle WordArt (un effet ou une combinaison d’effets) en C++ et l’appliquer aux textes.

Créer un modèle WordArt simple et l’appliquer à un texte

Utilisation d’Aspose.Slides

Tout d’abord, nous créons un texte simple avec ce code C++ :

auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
auto autoShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f);
auto textFrame = autoShape->get_TextFrame();

auto portion = textFrame->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0);
portion->set_Text(u"Aspose.Slides");

Ensuite, nous réglons la hauteur de la police du texte à une valeur plus grande pour rendre l’effet plus visible grâce à ce code :

auto fontData = System::MakeObject<FontData>(u"Arial Black");
portion->get_PortionFormat()->set_LatinFont(fontData);
portion->get_PortionFormat()->set_FontHeight(36.0f);

Utilisation de Microsoft PowerPoint

Accédez au menu des effets WordArt dans Microsoft PowerPoint :

Dans le menu de droite, vous pouvez choisir un effet WordArt prédéfini. Dans le menu de gauche, vous pouvez spécifier les paramètres d’un nouveau WordArt.

Voici quelques-uns des paramètres ou options disponibles :

Utilisation d’Aspose.Slides

Ici, nous appliquons la couleur du motif SmallGrid au texte et ajoutons une bordure de texte noire d’une largeur de 1 pixel grâce à ce code :

auto fillFormat = portion->get_PortionFormat()->get_FillFormat();
fillFormat->set_FillType(FillType::Pattern);
fillFormat->get_PatternFormat()->get_ForeColor()->set_Color(Color::get_DarkOrange());
fillFormat->get_PatternFormat()->get_BackColor()->set_Color(Color::get_White());
fillFormat->get_PatternFormat()->set_PatternStyle(PatternStyle::SmallGrid);

auto lineFillFormat = portion->get_PortionFormat()->get_LineFormat()->get_FillFormat();
lineFillFormat->set_FillType(FillType::Solid);
lineFillFormat->get_SolidFillColor()->set_Color(Color::get_Black());

Le texte résultant :

Appliquer d’autres effets WordArt

Utilisation de Microsoft PowerPoint

Depuis l’interface du programme, vous pouvez appliquer ces effets à un texte, un bloc de texte, une forme ou un élément similaire :

Par exemple, les effets Ombre, Réflexion et Lueur peuvent être appliqués à un texte ; les effets Format 3D et Rotation 3D peuvent être appliqués à un bloc de texte ; la propriété Bords doux peut être appliquée à un objet Forme (elle reste effective même lorsqu’aucune propriété Format 3D n’est définie).

Appliquer des effets d’ombre au texte

Ici, nous avons l’intention de définir uniquement les propriétés liées à un texte. Nous appliquons l’effet d’ombre à un texte avec ce code en C++ :

auto effectFormat = portion->get_PortionFormat()->get_EffectFormat();
effectFormat->EnableOuterShadowEffect();

auto outerShadowEffect = effectFormat->get_OuterShadowEffect();
outerShadowEffect->get_ShadowColor()->set_Color(Color::get_Black());
outerShadowEffect->set_ScaleHorizontal(100);
outerShadowEffect->set_ScaleVertical(65);
outerShadowEffect->set_BlurRadius(4.73);
outerShadowEffect->set_Direction(230.0f);
outerShadowEffect->set_Distance(2);
outerShadowEffect->set_SkewHorizontal(30);
outerShadowEffect->set_SkewVertical(0);
outerShadowEffect->get_ShadowColor()->get_ColorTransform()->Add(ColorTransformOperation::SetAlpha, 0.32f);

L’API Aspose.Slides prend en charge trois types d’ombre : OuterShadow, InnerShadow et PresetShadow.

Avec PresetShadow, vous pouvez appliquer une ombre à un texte (en utilisant des valeurs prédéfinies).

Utilisation de Microsoft PowerPoint

Dans PowerPoint, vous pouvez utiliser un type d’ombre. Voici un exemple :

Utilisation d’Aspose.Slides

Aspose.Slides vous permet en fait d’appliquer deux types d’ombre simultanément : InnerShadow et PresetShadow.

Notes :

• Lorsque OuterShadow et PresetShadow sont utilisés ensemble, seul l’effet OuterShadow est appliqué.
• Si OuterShadow et InnerShadow sont utilisés simultanément, l’effet résultant ou appliqué dépend de la version de PowerPoint. Par exemple, dans PowerPoint 2013, l’effet est doublé. Mais dans PowerPoint 2007, l’effet OuterShadow est appliqué.

Appliquer des effets de réflexion

Nous ajoutons une réflexion au texte avec cet exemple de code en C++ :

auto effectFormat = portion->get_PortionFormat()->get_EffectFormat();
effectFormat->EnableReflectionEffect();

auto reflectionEffect = effectFormat->get_ReflectionEffect();
reflectionEffect->set_BlurRadius(0.5);
reflectionEffect->set_Distance(4.72);
reflectionEffect->set_StartPosAlpha(0.f);
reflectionEffect->set_EndPosAlpha(60.f);
reflectionEffect->set_Direction(90.0f);
reflectionEffect->set_ScaleHorizontal(100);
reflectionEffect->set_ScaleVertical(-100);
reflectionEffect->set_StartReflectionOpacity(60.f);
reflectionEffect->set_EndReflectionOpacity(0.9f);
reflectionEffect->set_RectangleAlign(RectangleAlignment::BottomLeft);

Appliquer des effets de lueur

Nous appliquons l’effet de lueur au texte pour le faire briller ou ressortir en utilisant ce code :

auto effectFormat = portion->get_PortionFormat()->get_EffectFormat();
effectFormat->EnableGlowEffect();

auto glowEffect = effectFormat->get_GlowEffect();
glowEffect->get_Color()->set_R(255);
glowEffect->get_Color()->get_ColorTransform()->Add(ColorTransformOperation::SetAlpha, 0.54f);
glowEffect->set_Radius(7);

Le résultat de l’opération :

Vous pouvez modifier les paramètres d’ombre, d’affichage et de lueur. Les propriétés des effets sont définies séparément pour chaque portion du texte.

Utiliser les transformations dans WordArt

Nous utilisons la méthode set_Transform (inhérente à l’ensemble du bloc de texte) avec ce code :

textFrame->get_TextFrameFormat()->set_Transform(TextShapeType::ArchUpPour);

Le résultat :

Microsoft PowerPoint et Aspose.Slides pour C++ offrent un certain nombre de types de transformation prédéfinis.

Utilisation de PowerPoint

Pour accéder aux types de transformation prédéfinis, suivez : Format -> TextEffect -> Transform

Utilisation d’Aspose.Slides

Pour sélectionner un type de transformation, utilisez l’énumération TextShapeType.

Appliquer des effets 3D au texte et aux formes

Nous appliquons un effet 3D à une forme de texte avec cet exemple de code :

auto threeDFormat = autoShape->get_ThreeDFormat();

threeDFormat->get_BevelBottom()->set_BevelType(BevelPresetType::Circle);
threeDFormat->get_BevelBottom()->set_Height(10.5);
threeDFormat->get_BevelBottom()->set_Width(10.5);

threeDFormat->get_BevelTop()->set_BevelType(BevelPresetType::Circle);
threeDFormat->get_BevelTop()->set_Height(12.5);
threeDFormat->get_BevelTop()->set_Width(11);

threeDFormat->get_ExtrusionColor()->set_Color(Color::get_Orange());
threeDFormat->set_ExtrusionHeight(6);

threeDFormat->get_ContourColor()->set_Color(Color::get_DarkRed());
threeDFormat->set_ContourWidth(1.5);

threeDFormat->set_Depth(3);

threeDFormat->set_Material(MaterialPresetType::Plastic);

threeDFormat->get_LightRig()->set_Direction(LightingDirection::Top);
threeDFormat->get_LightRig()->set_LightType(LightRigPresetType::Balanced);
threeDFormat->get_LightRig()->SetRotation(0.0f, 0.0f, 40.0f);

threeDFormat->get_Camera()->set_CameraType(CameraPresetType::PerspectiveContrastingRightFacing);

Le texte résultant et sa forme :

Nous appliquons un effet 3D au texte avec ce code C++ :

auto threeDFormat = textFrame->get_TextFrameFormat()->get_ThreeDFormat();

threeDFormat->get_BevelBottom()->set_BevelType(BevelPresetType::Circle);
threeDFormat->get_BevelBottom()->set_Height(3.5);
threeDFormat->get_BevelBottom()->set_Width(3.5);

threeDFormat->get_BevelTop()->set_BevelType(BevelPresetType::Circle);
threeDFormat->get_BevelTop()->set_Height(4);
threeDFormat->get_BevelTop()->set_Width(4);

threeDFormat->get_ExtrusionColor()->set_Color(Color::get_Orange());
threeDFormat->set_ExtrusionHeight(6);

threeDFormat->get_ContourColor()->set_Color(Color::get_DarkRed());
threeDFormat->set_ContourWidth(1.5);

threeDFormat->set_Depth(3);

threeDFormat->set_Material(MaterialPresetType::Plastic);

threeDFormat->get_LightRig()->set_Direction(LightingDirection::Top);
threeDFormat->get_LightRig()->set_LightType(LightRigPresetType::Balanced);
threeDFormat->get_LightRig()->SetRotation(0.0f, 0.0f, 40.0f);

threeDFormat->get_Camera()->set_CameraType(CameraPresetType::PerspectiveContrastingRightFacing);

Le résultat de l’opération :

L’application des effets 3D aux textes ou à leurs formes ainsi que les interactions entre les effets sont basées sur certaines règles.

Considérez une scène pour un texte et la forme contenant ce texte. L’effet 3D comprend la représentation d’un objet 3D et la scène sur laquelle l’objet est placé.

• Lorsque la scène est définie à la fois pour la figure et le texte, la scène de la figure a la priorité supérieure — la scène du texte est ignorée.
• Lorsque la figure n’a pas sa propre scène mais possède une représentation 3D, la scène du texte est utilisée.
• Sinon—lorsque la forme n’a initialement aucun effet 3D—la forme reste plane et l’effet 3D ne s’applique qu’au texte.

Ces descriptions sont liées aux méthodes ThreeDFormat.getLightRig() et ThreeDFormat.getCamera().

Appliquer des effets d’ombre extérieure aux formes

Aspose.Slides pour C++ fournit les classes IOuterShadow et IInnerShadow qui permettent d’appliquer des effets d’ombre à un texte contenu dans un TextFrame. Suivez ces étapes :

1. Créer une instance de la classe Presentation.
2. Obtenir la référence d’une diapositive en utilisant son index.
3. Ajouter une AutoShape de type Rectangle à la diapositive.
4. Accéder au TextFrame associé à l’AutoShape.
5. Définir la propriété FillType de l’AutoShape sur NoFill.
6. Instancier la classe OuterShadow
7. Définir le BlurRadius de l’ombre.
8. Définir la Direction de l’ombre
9. Définir la Distance de l’ombre.
10. Définir le RectanglelAlign sur TopLeft.
11. Définir le PresetColor de l’ombre sur Black.
12. Enregistrer la présentation sous forme de fichier PPTX.

Ce code d’exemple en C++—une implémentation des étapes ci‑dessus—vous montre comment appliquer l’effet d’ombre extérieure à un texte :

auto pres = System::MakeObject<Presentation>();
// Obtenir la référence de la diapositive
auto sld = pres->get_Slides()->idx_get(0);

// Ajouter une AutoShape de type Rectangle
auto ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 150.0f, 50.0f);

// Ajouter un TextFrame au Rectangle
ashp->AddTextFrame(u"Aspose TextBox");

// Désactiver le remplissage de la forme au cas où nous voulons obtenir l'ombre du texte
ashp->get_FillFormat()->set_FillType(FillType::NoFill);

// Ajouter une ombre extérieure et définir tous les paramètres nécessaires
ashp->get_EffectFormat()->EnableOuterShadowEffect();
auto shadow = ashp->get_EffectFormat()->get_OuterShadowEffect();
shadow->set_BlurRadius(4.0);
shadow->set_Direction(45.0f);
shadow->set_Distance(3);
shadow->set_RectangleAlign(RectangleAlignment::TopLeft);
shadow->get_ShadowColor()->set_PresetColor(PresetColor::Black);

// Enregistrer la présentation sur le disque
pres->Save(u"pres_out.pptx", SaveFormat::Pptx);

Appliquer des effets d’ombre intérieure aux formes

Suivez ces étapes :

1. Créer une instance de la classe Presentation.
2. Obtenir une référence de la diapositive.
3. Ajouter une AutoShape de type Rectangle.
4. Activer InnerShadowEffect.
5. Définir tous les paramètres nécessaires.
6. Définir ColorType à Scheme.
7. Définir la couleur du schéma.
8. Enregistrer la présentation sous forme de fichier PPTX.

Ce code d’exemple (basé sur les étapes ci‑dessus) vous montre comment ajouter un connecteur entre deux formes en C++ :

auto presentation = System::MakeObject<Presentation>();
// Obtenir la référence d'une diapositive
auto slide = presentation->get_Slides()->idx_get(0);

// Ajouter une AutoShape de type Rectangle
auto ashp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 400.0f, 300.0f);
ashp->get_FillFormat()->set_FillType(FillType::NoFill);

// Ajouter un TextFrame au rectangle
ashp->AddTextFrame(u"Aspose TextBox");
auto port = ashp->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0);
auto pf = port->get_PortionFormat();
pf->set_FontHeight(50.0f);

// Activer InnerShadowEffect    
auto ef = pf->get_EffectFormat();
ef->EnableInnerShadowEffect();

// Définir tous les paramètres nécessaires
auto shadow = ef->get_InnerShadowEffect();
shadow->set_BlurRadius(8.0);
shadow->set_Direction(90.0F);
shadow->set_Distance(6.0);
shadow->get_ShadowColor()->set_B(189);

// Définir ColorType comme Scheme
shadow->get_ShadowColor()->set_ColorType(ColorType::Scheme);

// Définir la couleur du schéma
shadow->get_ShadowColor()->set_SchemeColor(SchemeColor::Accent1);

// Enregistrer la présentation
presentation->Save(u"WordArt_out.pptx", SaveFormat::Pptx);

FAQ

Puis‑je utiliser les effets WordArt avec différentes polices ou scripts (par ex., arabe, chinois) ?

Oui, Aspose.Slides prend en charge Unicode et fonctionne avec toutes les principales polices et scripts. Les effets WordArt tels que l’ombre, le remplissage et le contour peuvent être appliqués quel que soit la langue, bien que la disponibilité des polices et le rendu puissent dépendre des polices du système.

Puis‑je appliquer les effets WordArt aux éléments du masque des diapositives ?

Oui, vous pouvez appliquer les effets WordArt aux formes sur les masques de diapositives, y compris les espaces réservés de titre, les pieds de page ou le texte d’arrière‑plan. Les modifications apportées à la disposition du masque seront répercutées sur toutes les diapositives associées.

Les effets WordArt affectent‑ils la taille du fichier de la présentation ?

Légèrement. Les effets WordArt tels que les ombres, les lueurs et les remplissages en dégradé peuvent légèrement augmenter la taille du fichier en raison des métadonnées de formatage supplémentaires, mais la différence est généralement négligeable.

Puis‑je prévisualiser le résultat des effets WordArt sans enregistrer la présentation ?

Oui, vous pouvez rendre les diapositives contenant des WordArt en images (par ex., PNG, JPEG) à l’aide de la méthode GetImage des interfaces IShape ou ISlide. Cela vous permet de prévisualiser le résultat en mémoire ou à l’écran avant d’enregistrer ou d’exporter la présentation complète.