Cómo agregar un efecto de reflejo al texto en C#

¿Por qué es importante crear un TextStyle?

El objeto TextStyle sirve como punto central de configuración para todo el formato de texto en IronWord. Al separar el estilo del contenido, se puede reutilizar el mismo efecto de reflejo en varios elementos de texto, lo que garantiza la coherencia en todo el documento. Este enfoque también facilita la actualización global del efecto de reflexión mediante la modificación de un único objeto de estilo.

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-effect.cs

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ReflectionEffect = new Reflection(),
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("reflectionEffect.docx");

¿Qué aspecto tiene la reflexión por defecto?

El efecto de reflejo predeterminado crea una sutil imagen de espejo debajo del texto con atenuación automática de la opacidad. Esta configuración preestablecida funciona bien para la mayoría de los documentos y presentaciones empresariales sin requerir ninguna personalización adicional. El reflejo aparece a una distancia estándar con los ajustes adecuados de desenfoque y transparencia que complementan varios tamaños y estilos de fuente.

¿Qué propiedades controlan el aspecto de Reflection?

• SchemeColor: Obtiene o establece el esquema de color del efecto de reflexión. Matiza los reflejos con cualquier color para conseguir efectos de agua o superficies metálicas.

• ÁnguloDeDesviaciónHorizontal: Obtiene o establece el ángulo de inclinación horizontal en grados. Crear efectos de perspectiva en los que los reflejos se pierdan en la distancia.

• FactorDeEscaladoHorizontal: Obtiene o establece el factor de escala horizontal. Los valores inferiores a 100 se comprimen; valores superiores a 100 de estiramiento.

• DistanciaDeTexto: Obtiene o establece la distancia en puntos (1/72 pulgadas). Los valores más pequeños crean reflexiones ajustadas; los valores más grandes simulan superficies distantes.

• Ángulo de dirección: Obtiene o establece el ángulo de dirección en grados. Determina la dirección aparente de la fuente de luz.

• ÁnguloDeDirecciónDeDesvanecimiento: Obtiene o establece la dirección de desvanecimiento en grados. Controla el desvanecimiento vertical para reflejos en el suelo o el desvanecimiento angular para efectos de agua.

• EndPosition: Obtiene o establece la posición final. Determina dónde se desvanece completamente el reflejo.

• PosiciónInicial: Obtiene o establece la posición inicial. Normalmente 0 para empezar inmediatamente debajo del texto.

• <código>EndingOpacity</código>: Obtiene o establece la opacidad final. Los valores más bajos crean reflejos sutiles que se difuminan hasta la transparencia.

• VerticalScalingFactor: Obtiene o establece el factor de escalado vertical. Los valores negativos voltean el texto; la magnitud controla la altura.

• OpacidadInicial: Obtiene o establece la opacidad inicial. Los valores más altos crean reflexiones iniciales más fuertes.

• Alineación: Obtiene o establece la alineación. Elija entre varias opciones para colocar el reflejo en relación con el texto.

• RadioDeDesenfoque: Obtiene o establece el radio de desenfoque en puntos (1/72 pulgadas). Los valores más altos crean reflejos más suaves y difusos.

• ÁnguloDeDesviaciónVertical: Obtiene o establece el ángulo de inclinación vertical en grados. Se utiliza para crear efectos de reflejo inclinado.

¿Cómo puedo crear un efecto de reflexión personalizado?

Los efectos de reflejo personalizados le permiten adaptarse a la marca de su organización o crear estilos visuales únicos. El siguiente ejemplo muestra un reflejo dorado con una posición y una opacidad específicas que crean un aspecto profesional para certificados, premios o cabeceras de documentos premium.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

// Add text with style
doc.AddText("Customized reflection").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedReflectionEffect.docx");

¿Qué resultados puedo conseguir con las propiedades personalizadas?

El ejemplo de reflejo personalizado anterior produce un reflejo dorado distintivo que realza la sensación de calidad del documento. Al ajustar el gradiente de opacidad de 0% a 100%, el reflejo crea un efecto de fundido inverso en el que el reflejo se hace más fuerte a medida que se aleja del texto. Esta técnica funciona bien para crear cabeceras destacadas o resaltar anuncios importantes.

Mejores prácticas para efectos de reflexión

Al aplicar efectos de reflexión en documentos profesionales, tenga en cuenta estas directrices:

La sutileza suele funcionar mejor: Para documentos empresariales, utilice valores de opacidad de terminación más bajos (20-40%) para crear reflejos sutiles que realcen sin distraer. Reserva los efectos más fuertes para materiales de marketing o presentaciones en los que el impacto visual sea primordial.

Adapte el estilo de su documento: Alinee las propiedades de reflexión con el diseño general de su documento. Los documentos formales se benefician de los reflejos verticales simples con un mínimo de desenfoque, mientras que los materiales creativos pueden utilizar ángulos sesgados y reflejos de colores para conseguir un efecto artístico.

Consideraciones de rendimiento: Los efectos de reflejo complejos con valores altos de radio de desenfoque pueden aumentar el tamaño del archivo y el tiempo de procesamiento. Para documentos con numerosos elementos reflejados, pruebe el rendimiento y ajuste las propiedades en consecuencia.

Conciencia de accesibilidad: Recuerde que los efectos decorativos como los reflejos deben mejorar la comunicación clara en lugar de sustituirla. Asegúrese de que el texto principal sigue siendo muy legible, especialmente cuando cree documentos que deban cumplir las normas de accesibilidad.