Crear y aplicar efectos de WordArt en C++
¿Acerca de WordArt?
WordArt o Word Art es una función que permite aplicar efectos a textos para que resalten. Con WordArt, por ejemplo, puedes trazar el contorno de un texto o llenarlo con un color (o degradado), añadirle efectos 3D, etc. También puedes sesgar, doblar y estirar la forma de un texto.
WordArt en Microsoft PowerPoint
Para usar WordArt en Microsoft PowerPoint, debes seleccionar una de las plantillas de WordArt predefinidas. Una plantilla de WordArt es un conjunto de efectos que se aplican a un texto o a su forma.
WordArt en Aspose.Slides
En Aspose.Slides para C++ 20.10, implementamos soporte para WordArt y mejoramos la función en versiones posteriores de Aspose.Slides para C++.
Con Aspose.Slides para C++, puedes crear fácilmente tu propia plantilla de WordArt (un efecto o una combinación de efectos) en C++ y aplicarla a los textos.
Crear una Plantilla de WordArt Simple y Aplicarla al Texto
Usando Aspose.Slides
Primero, creamos un texto simple con este código 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");
Ahora, establecemos la altura de la fuente del texto a un valor mayor para que el efecto sea más visible mediante este código:
auto fontData = System::MakeObject<FontData>(u"Arial Black");
portion->get_PortionFormat()->set_LatinFont(fontData);
portion->get_PortionFormat()->set_FontHeight(36.0f);
Usando Microsoft PowerPoint
Ve al menú de efectos de WordArt en Microsoft PowerPoint:

Desde el menú de la derecha, puedes elegir un efecto de WordArt predefinido. Desde el menú de la izquierda, puedes especificar la configuración para un WordArt nuevo.
Estos son algunos de los parámetros u opciones disponibles:

Usando Aspose.Slides
Aquí, aplicamos el color de patrón SmallGrid al texto y añadimos un borde negro de ancho 1 usando este código:
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());
El texto resultante:

Aplicar Otros Efectos de WordArt
Usando Microsoft PowerPoint
Desde la interfaz del programa, puedes aplicar estos efectos a un texto, bloque de texto, forma o elemento similar:

Por ejemplo, los efectos Sombra, Reflexión y Resplandor pueden aplicarse a un texto; los efectos Formato 3D y Rotación 3D pueden aplicarse a un bloque de texto; la propiedad Bordes Suaves puede aplicarse a un Objeto Forma (sigue teniendo efecto cuando no se establece la propiedad Formato 3D).
Aplicar Efectos de Sombra al Texto
Aquí, pretendemos establecer solo las propiedades relacionadas con un texto. Aplicamos el efecto de sombra a un texto usando este código 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);
La API de Aspose.Slides admite tres tipos de sombras: OuterShadow, InnerShadow y PresetShadow.
Con PresetShadow, puedes aplicar una sombra a un texto (usando valores predefinidos).
Usando Microsoft PowerPoint
En PowerPoint, puedes usar un tipo de sombra. Aquí tienes un ejemplo:

Usando Aspose.Slides
Aspose.Slides permite aplicar dos tipos de sombras a la vez: InnerShadow y PresetShadow.
Notas:
- Cuando se usan juntos OuterShadow y PresetShadow, solo se aplica el efecto OuterShadow.
- Si se usan simultáneamente OuterShadow e InnerShadow, el efecto resultante depende de la versión de PowerPoint. Por ejemplo, en PowerPoint 2013 el efecto se duplica. Pero en PowerPoint 2007 se aplica el efecto OuterShadow.
Aplicar Efectos de Reflexión
Añadimos una reflexión al texto mediante este ejemplo de código 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);
Aplicar Efectos de Resplandor
Aplicamos el efecto de resplandor al texto para que brille o destaque usando este código:
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);
El resultado de la operación:

Usar Transformaciones en WordArt
Utilizamos el método set_Transform (que afecta a todo el bloque de texto) mediante este código:
textFrame->get_TextFrameFormat()->set_Transform(TextShapeType::ArchUpPour);
El resultado:

Usando PowerPoint
Para acceder a los tipos de transformación predefinidos, ve a: Formato -> Efecto de Texto -> Transformar
Usando Aspose.Slides
Para seleccionar un tipo de transformación, utiliza la enumeración TextShapeType.
Aplicar Efectos 3D a Texto y Formas
Establecemos un efecto 3D a una forma de texto con este ejemplo de código:
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);
El texto y su forma resultantes:

Aplicamos un efecto 3D al texto con este código 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);
El resultado de la operación:

La aplicación de efectos 3D a textos o sus formas y la interacción entre efectos se rigen por ciertas reglas.
Considera una escena para un texto y la forma que contiene ese texto. El efecto 3D incluye la representación del objeto 3D y la escena en la que se coloca el objeto.
- Cuando la escena está establecida tanto para la figura como para el texto, la escena de la figura tiene mayor prioridad y la escena del texto se ignora.
- Cuando la figura carece de su propia escena pero tiene representación 3D, se usa la escena del texto.
- De lo contrario, cuando la forma originalmente no tiene efecto 3D, la forma es plana y el efecto 3D solo se aplica al texto.
Estas descripciones están relacionadas con los métodos ThreeDFormat.getLightRig() y ThreeDFormat.getCamera().
Aplicar Efectos de Sombra Exterior a Formas
Aspose.Slides para C++ proporciona las clases IOuterShadow y IInnerShadow que permiten aplicar efectos de sombra a un texto contenido en TextFrame. Sigue estos pasos:
- Crea una instancia de la clase Presentation.
- Obtén la referencia de una diapositiva usando su índice.
- Añade una AutoShape de tipo Rectangle a la diapositiva.
- Accede al TextFrame asociado a la AutoShape.
- Establece el FillType de la AutoShape a NoFill.
- Instancia la clase OuterShadow.
- Define el BlurRadius de la sombra.
- Define la Direction de la sombra.
- Define la Distance de la sombra.
- Establece el RectanglelAlign a TopLeft.
- Define el PresetColor de la sombra a Black.
- Guarda la presentación como archivo PPTX.
Este código de ejemplo en C++—una implementación de los pasos anteriores—muestra cómo aplicar el efecto de sombra exterior a un texto:
auto pres = System::MakeObject<Presentation>();
// Obtener referencia de la diapositiva
auto sld = pres->get_Slides()->idx_get(0);
// Añadir un AutoShape de tipo Rectángulo
auto ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 150.0f, 50.0f);
// Añadir TextFrame al Rectángulo
ashp->AddTextFrame(u"Aspose TextBox");
// Desactivar el relleno de la forma en caso de que queramos obtener la sombra del texto
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Añadir sombra exterior y establecer todos los parámetros necesarios
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);
// Guardar la presentación en disco
pres->Save(u"pres_out.pptx", SaveFormat::Pptx);
Aplicar Efectos de Sombra Interior a Formas
Sigue estos pasos:
- Crea una instancia de la clase Presentation.
- Obtén la referencia de la diapositiva.
- Añade una AutoShape del tipo Rectangle.
- Habilita InnerShadowEffect.
- Define todos los parámetros necesarios.
- Establece el ColorType como Scheme.
- Define el Scheme Color.
- Guarda la presentación como archivo PPTX.
Este código de ejemplo (basado en los pasos anteriores) muestra cómo añadir un conector entre dos formas en C++:
auto presentation = System::MakeObject<Presentation>();
// Obtener referencia de una diapositiva
auto slide = presentation->get_Slides()->idx_get(0);
// Añadir un AutoShape de tipo Rectángulo
auto ashp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 400.0f, 300.0f);
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Añadir TextFrame al Rectángulo
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);
// Habilitar InnerShadowEffect
auto ef = pf->get_EffectFormat();
ef->EnableInnerShadowEffect();
// Establecer todos los parámetros necesarios
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);
// Establecer ColorType como Scheme
shadow->get_ShadowColor()->set_ColorType(ColorType::Scheme);
// Establecer color del esquema
shadow->get_ShadowColor()->set_SchemeColor(SchemeColor::Accent1);
// Guardar presentación
presentation->Save(u"WordArt_out.pptx", SaveFormat::Pptx);
Preguntas Frecuentes
¿Puedo usar los efectos de WordArt con diferentes fuentes o escrituras (p. ej., árabe, chino)?
Sí, Aspose.Slides admite Unicode y funciona con todas las fuentes y escrituras principales. Los efectos de WordArt como sombra, relleno y contorno pueden aplicarse independientemente del idioma, aunque la disponibilidad de fuentes y el renderizado pueden depender de las fuentes del sistema.
¿Puedo aplicar los efectos de WordArt a elementos del patrón de diapositivas?
Sí, puedes aplicar efectos de WordArt a formas en diapositivas maestro, incluidos marcadores de posición de título, pies de página o texto de fondo. Los cambios realizados en el patrón se reflejarán en todas las diapositivas asociadas.
¿Los efectos de WordArt afectan al tamaño del archivo de la presentación?
Un poco. Los efectos de WordArt como sombras, resplandores y rellenos degradados pueden aumentar ligeramente el tamaño del archivo debido a los metadatos de formato añadidos, pero la diferencia suele ser insignificante.
¿Puedo previsualizar el resultado de los efectos de WordArt sin guardar la presentación?
Sí, puedes renderizar diapositivas que contengan WordArt a imágenes (p. ej., PNG, JPEG) usando el método GetImage de las interfaces IShape o ISlide. Esto te permite previsualizar el resultado en memoria o en pantalla antes de guardar o exportar la presentación completa.