How to Add Reflection Effect to Text in C

Dlaczego tworzenie TextStyle ma znaczenie?

Obiekt TextStyle służy jako centralny punkt konfiguracji dla całego formatowania tekstu w IronWord. Oddzielając styl od treści, można ponownie użyć tego samego efektu odbicia w kilku elementach tekstowych, zapewniając spójność w całym dokumencie. To podejście także ułatwia globalną aktualizację efektu odbicia poprzez modyfikację jednego obiektu stylu.

: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");

Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ReflectionEffect = New Reflection()
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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")

Jak wygląda domyślny efekt odbicia?

Domyślny efekt odbicia tworzy subtelny obraz lustrzany poniżej tekstu z automatycznym zanikiem przezroczystości. Ta wcześniej skonfigurowana konfiguracja działa dobrze w większości dokumentów i prezentacji biznesowych, nie wymagając żadnych dodatkowych dostosowań. Odbicie pojawia się w standardowej odległości z odpowiednimi ustawieniami rozmycia i przezroczystości, które dopełniają różne rozmiary i style czcionek.

Które właściwości kontrolują wygląd odbicia?

• SchemeColor: Pobiera lub ustawia kolor schematu efektu odbicia. Odbicia barw w dowolnym kolorze dla efektów wodnych lub metalicznych powierzchni.

• HorizontalSkewAngle: Pobiera lub ustawia poziomy kat skosny w stopniach. Stwórz efekty perspektywiczne, w których odbicia oddalają się w głąb przestrzeni.

• HorizontalScalingFactor: Pobiera lub ustawia poziomy wspolczynnik skali. Wartości poniżej 100 kompresują; wartości powyżej 100 rozciągają się.

• DistanceFromText: Pobiera lub ustawia odleglosc w punktach (1/72 cala). Mniejsze wartości tworzą ciasne odbicia; Większe wartości symulują odległe powierzchnie.

• DirectionAngle: Pobiera lub ustawia kat kierunku w stopniach. Określa kierunek widocznego źródła światła.

• FadeDirectionAngle: Pobiera lub ustawia kierunek zaniku w stopniach. Kontroluj pionowe zanikanie w przypadku odbić podłogi lub ukośne zanikanie w przypadku efektów wodnych.

• EndPosition: Pobiera lub ustawia koncowa pozycje. Określa, gdzie odbicie całkowicie zanika.

• StartPosition: Pobiera lub ustawia początkową pozycję. Zazwyczaj 0, aby rozpocząć bezpośrednio pod tekstem.

• EndingOpacity: Pobiera lub ustawia koncowa przezroczystosc. Niższe wartości tworzą subtelne odbicia, które stopniowo przechodzą w przezroczystość.

• VerticalScalingFactor: Pobiera lub ustawia pionowy wspolczynnik skali. Wartości ujemne odwracają tekst; Wielkość określa wysokość.

• StartingOpacity: Pobiera lub ustawia poczatkowa przezroczystosc. Wyższe wartości powodują silniejsze początkowe odbicia.

• Alignment: Pobiera lub ustawia wyrównanie. Wybierz jedną z opcji, aby ustawić odbicie względem tekstu.

• BlurRadius: Pobiera lub ustawia promien rozmycia w punktach (1/72 cala). Wyższe wartości powodują powstanie bardziej miękkich, rozproszonych odbić.

• VerticalSkewAngle: Pobiera lub ustawia pionowy kat skosny w stopniach. Służy do tworzenia efektów ukośnego odbicia.

Jak stworzyć niestandardowy efekt odbicia?

Niestandardowe efekty odbicia pozwalają dopasować wygląd do wizerunku marki Twojej organizacji lub stworzyć unikalne style wizualne. Poniższy przykład przedstawia odbicie w kolorze złotym z określonymi ustawieniami położenia i krycia, które nadają profesjonalny wygląd certyfikatom, nagrodom lub nagłówkom dokumentów 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,
    },
};

// 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");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ReflectionEffect = New Reflection() With {
        .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
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As 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")

Jakie wyniki mogę osiągnąć dzięki niestandardowym właściwościom?

Powyższy przykład niestandardowego odbicia tworzy charakterystyczne odbicie w złocistym odcieniu, które podkreśla ekskluzywny charakter dokumentu. Dzięki zmianie gradientu krycia od 0% do 100% odbicie tworzy efekt odwróconego zanikania, w którym odbicie staje się silniejsze w miarę oddalania się od tekstu. Technika ta sprawdza się dobrze przy tworzeniu wyróżniających się nagłówków lub podkreślaniu ważnych ogłoszeń.

Najlepsze praktyki dotyczące efektów refleksji

Podczas stosowania efektów refleksji w profesjonalnych dokumentach należy uwzględnić następujące wytyczne:

Subtelność często działa najlepiej: w przypadku dokumentów biznesowych należy stosować niższe wartości krycia (20–40%), aby uzyskać subtelne odbicia, które wzbogacają wygląd, nie odwracając uwagi. Silniejsze efekty należy zarezerwować dla materiałów marketingowych lub prezentacji, w których najważniejszy jest efekt wizualny.

Dopasuj styl dokumentu: Dostosuj właściwości odbicia do ogólnego projektu dokumentu. W przypadku dokumentów formalnych zalecane są proste odbicia pionowe z minimalnym rozmyciem, natomiast w materiałach kreatywnych można wykorzystać skośne kąty i kolorowe odbicia w celu uzyskania efektu artystycznego.

Uwagi dotyczące wydajności: Złożone efekty odbicia przy wysokich wartościach promienia rozmycia mogą zwiększyć rozmiar pliku i wydłużyć czas przetwarzania. W przypadku dokumentów zawierających wiele elementów odbitych należy przetestować wydajność i odpowiednio dostosować właściwości.

Świadomość dostępności: Należy pamiętać, że efekty dekoracyjne, takie jak odbicia, powinny wzbogacać, a nie zastępować jasną komunikację. Należy zadbać o wysoką czytelność tekstu źródłowego, zwłaszcza w przypadku tworzenia dokumentów, które muszą spełniać standardy dostępności.