How to Add Reflection Effect to Text in C#

Por que é importante criar um TextStyle?

O objeto TextStyle serve como ponto central para a configuração de toda a formatação de texto no IronWord. Ao separar o estilo do conteúdo, você pode reutilizar o mesmo efeito de reflexo em vários elementos de texto, garantindo consistência em todo o documento. Essa abordagem também facilita a atualização do efeito de reflexão globalmente, modificando um ú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(),
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

Qual é a aparência do reflexo padrão?

O efeito de reflexo padrão cria uma imagem espelhada sutil abaixo do texto, com atenuação automática da opacidade. Essa configuração predefinida funciona bem para a maioria dos documentos e apresentações comerciais, sem exigir qualquer personalização adicional. O reflexo aparece a uma distância padrão, com configurações adequadas de desfoque e transparência que complementam vários tamanhos e estilos de fonte.

Quais propriedades controlam a aparência do reflexo?

• SchemeColor: Obtém ou define a cor do esquema do efeito de reflexão. Aplique qualquer cor aos reflexos para criar efeitos de superfície em água ou metal.

• HorizontalSkewAngle: Obtém ou define o ângulo de inclinação horizontal em graus. Crie efeitos de perspectiva onde os reflexos se afastam na distância.

• HorizontalScalingFactor: Obtém ou define o fator de escala horizontal. Valores abaixo de 100 comprimem; Valores acima de 100 esticam.

• DistanceFromText: Obtém ou define a distância em pontos (1/72 polegada). Valores menores criam reflexos mais fechados; Valores maiores simulam superfícies distantes.

• DirectionAngle: Obtém ou define o ângulo de direção em graus. Determina a direção aparente da fonte de luz.

• FadeDirectionAngle: Obtém ou define a direção do desvanecimento em graus. Controle o desvanecimento vertical para reflexos no chão ou o desvanecimento angular para efeitos na água.

• EndPosition: Obtém ou define a posição final. Determina o ponto em que o reflexo desaparece completamente.

• StartPosition: Obtém ou define a posição inicial. Normalmente, o valor 0 começa imediatamente abaixo do texto.

• EndingOpacity: Obtém ou define a opacidade final. Valores mais baixos criam reflexos sutis que se desvanecem até à transparência.

• VerticalScalingFactor: Obtém ou define o fator de escala vertical. Valores negativos invertem o texto; A magnitude controla a altura.

• StartingOpacity: Obtém ou define a opacidade inicial. Valores mais altos geram reflexões iniciais mais fortes.

• Alignment: Obtém ou define o alinhamento. Escolha entre várias opções para posicionar o reflexo em relação ao texto.

• BlurRadius: Obtém ou define o raio de desfoque em pontos (1/72 polegada). Valores mais altos criam reflexos mais suaves e difusos.

• VerticalSkewAngle: Obtém ou define o ângulo de inclinação vertical em graus. Utilize para criar efeitos de reflexo inclinado.

Como faço para criar um efeito de reflexo personalizado?

Os efeitos de reflexo personalizados permitem que você combine a identidade visual da sua organização com a sua marca ou crie estilos visuais exclusivos. O exemplo a seguir demonstra um reflexo com tonalidade dourada, com configurações específicas de posicionamento e opacidade, que criam uma aparência profissional para certificados, prêmios ou cabeçalhos de documentos de alta qualidade.

: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,
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized reflection"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

Que resultados posso alcançar com propriedades personalizadas?

O exemplo de reflexo personalizado acima produz um reflexo distinto com tonalidade dourada que realça a sensação de sofisticação do documento. Ao ajustar o gradiente de opacidade de 0% a 100%, o reflexo cria um efeito de desvanecimento inverso, onde o reflexo se torna mais forte à medida que se afasta do texto. Essa técnica funciona bem para criar cabeçalhos chamativos ou destacar anúncios importantes.

Melhores práticas para efeitos de reflexão

Ao implementar efeitos de reflexão em documentos profissionais, considere estas diretrizes:

A sutileza costuma ser a melhor opção : para documentos comerciais, use valores de opacidade mais baixos (20-40%) para criar reflexos sutis que realçam o documento sem distrair. Reserve efeitos mais impactantes para materiais de marketing ou apresentações onde o impacto visual é fundamental.

Combine com o estilo do seu documento : alinhe as propriedades de reflexão com o design geral do seu documento. Documentos formais se beneficiam de reflexos verticais simples com o mínimo de desfoque, enquanto materiais criativos podem utilizar ângulos oblíquos e reflexos coloridos para um efeito artístico.

Considerações sobre desempenho : Efeitos de reflexão complexos com altos valores de raio de desfoque podem aumentar o tamanho do arquivo e o tempo de processamento. Para documentos com muitos elementos refletidos, teste o desempenho e ajuste as propriedades de acordo.

Conscientização sobre acessibilidade : Lembre-se de que efeitos decorativos, como reflexos, devem aprimorar, e não substituir, a comunicação clara. Garanta que seu texto principal permaneça altamente legível, especialmente ao criar documentos que precisam atender aos padrões de acessibilidade.