How to Add Reflection Effect to Text in C

Dlaczego tworzenie TextStyle ma znaczenie?

Obiekt TextStyle służy jako centralny punkt konfiguracji dla wszystkich formatowań tekstu w IronWord. Oddzielajac styl od treści, możesz ponownie uzyc tego samego efektu odbicia w kilku elementach tekstowych, zapewniając spojnosc w całym dokumencie. To podejście także ułatwia globalna aktualizacje efektu odbicia poprzez modyfikacje 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 domyslny efekt odbicia?

Domyslny efekt odbicia tworzy subtelny obraz lustrzany poniżej tekstu z automatycznym zanikiem przezroczystosci. Ta wczesniej skonfigurowana konfiguracja działa dobrze w wiekszosci dokumentów i prezentacji biznesowych, nie wymagajac zadnych dodatkowych dostosowan. Odbicie pojawia sie w standardowej odleglosci z odpowiednimi ustawieniami rozmycia i przezroczystosci, ktore dopełniaja 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 kąt pochylenia poziomego w stopniach. Stwórz efekty perspektywiczne, w których odbicia oddalają się w głąb przestrzeni.

• HorizontalScalingFactor: Pobiera lub ustawia współczynnik skalowania poziomego. Wartości poniżej 100 kompresują; wartości powyżej 100 rozciągają się.

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

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

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

• EndPosition: Pobiera lub ustawia pozycję końcową. Określa, gdzie odbicie całkowicie zanika.

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

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

• VerticalScalingFactor: Pobiera lub ustawia współczynnik skalowania pionowego. Wartości ujemne odwracają tekst; Wielkość określa wysokość.

• StartingOpacity: Pobiera lub ustawia początkową nieprzezroczystość. 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 promień rozmycia w punktach (1/72 cala). Wyższe wartości powodują powstanie bardziej miękkich, rozproszonych odbić.

• VerticalSkewAngle: Pobiera lub ustawia kąt pochylenia pionowego 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.