Formátování tvarů PowerPointu v Javě

Úvod

Formátujte tvary v PowerPointu úpravou jejich obrysů, výplní a efektů. Aspose.Slides pro Java vám umožňuje tato nastavení řídit programově, včetně průhlednosti, rotace a 3D formátování.

Možnosti formátování tvarů v PowerPointu

Aspose.Slides pro Java poskytuje rozhraní a metody, které vám umožní formátovat tvary pomocí stejných možností, jaké jsou dostupné v PowerPointu.

Formátování čar

Použijte IShape.getLineFormat k řízení obrysu tvaru. Tento příklad vytvoří nevyplněný obdélník s modrým, čárkovaným obrysem. ILineFormat.setStyle vybere složenou čáru „tlustá-jemná“, zatímco ILineFormat.setWidth nastaví její šířku na 7 bodů a ILineFormat.setDashStyle vybere vzor čáry.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getLineFormat().setStyle(LineStyle.ThickThin);
    shape.getLineFormat().setWidth(7);
    shape.getLineFormat().setDashStyle(LineDashStyle.Dash);
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    presentation.save("formatted_lines.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Formátované čáry v prezentaci

Nastavení vlastních vzorů čáry

Použijte ILineFormat.setCustomDashPattern, když předdefinované styly čar neposkytují požadované délky čárek a mezer, například pro značkové obrysy nebo technické diagramy. Při přiřazení vzoru se automaticky změní styl čáry na LineDashStyle.Custom.

Pole vstupů střídá délky čárek a mezer, začíná čárou. Každá hodnota je násobkem šířky čáry: { 4, 2 } při šířce 3 body vytvoří čáru o délce 12 bodů, následovanou mezerou 6 bodů. Používejte dvojice konečných, nezáporných hodnot k definování kompletních úseků čáry a mezery. Příklad používá kladné hodnoty, aby byly všechny čáry a mezery viditelné.

Tento příklad vytvoří pět modrých čar se stejnou délkou a plochými konci. První tři porovnávají vzory při šířce 3 body. Čtvrtá opakuje první vzor při dvojnásobné šířce, zdvojnásobujíc jak délku čáry, tak mezery. Pátá přepíná z vlastního vzoru na plnou čáru.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[][] patterns = {
        { 4, 2 },
        { 1, 2 },
        { 6, 2, 1, 2 },
        { 4, 2 },
        { 4, 2 }
    };

    for (int i = 0; i < patterns.length; i++) {
        IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0);
        line.getLineFormat().setWidth(i == 3 ? 6 : 3);
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 139));
        line.getLineFormat().setCapStyle(LineCapStyle.Flat);
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setCustomDashPattern(patterns[i]);
    }

    // Vrátit poslední čáru na plný styl.
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);

    presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Chcete‑li se vrátit k předdefinovanému čárkovanému stylu, předáte LineDashStyle.Dash metodě ILineFormat.setDashStyle. Vybraný styl řídí vzhled čáry.

Výsledek v PowerPointu, shora dolů: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; a Solid, 3 pt.

Tři vlastní vzory čáry, širší čára s prvním vzorem a plná čára v PowerPointu

Nastavení koncových tvarů čáry

Použijte ILineFormat.setCapStyle k nastavení konců otevřené čáry. Třída LineCapStyle poskytuje tři explicitní styly konců:

  • Flat: Tah končí v koncovém bodě.
  • Round: Polokruhový konec přesahuje koncový bod o polovinu šířky čáry.
  • Square: Čtvercový konec přesahuje koncový bod o polovinu šířky čáry.

Třída také zahrnuje NotDefined, což znamená, že žádný styl konce není výslovně přiřazen.

Konce se liší od šipek, které přidávají symboly na konce čáry, a od spojů, které řídí rohy mezi úseky čáry. Tento příklad zakazuje šípky pomocí ILineFormat.setBeginArrowheadStyle a ILineFormat.setEndArrowheadStyle, aby byly porovnávány pouze tvary konců.

Následující příklad vytvoří tři jinak identické vodorovné čáry o šířce 20 bodů. Shora dolů používají ploché, kulaté a čtvercové konce. Jejich koncové souřadnice jsou stejné; kulaté a čtvercové konce přesahují 10 bodů za každý konec.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    byte[] capStyles = new byte[] { LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square };

    for (int i = 0; i < capStyles.length; i++) {
        IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0);
        line.getLineFormat().setWidth(20);
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 139));
        line.getLineFormat().setDashStyle(LineDashStyle.Solid);
        line.getLineFormat().setCapStyle(capStyles[i]);
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None);
    }

    presentation.save("line_caps.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek v PowerPointu, shora dolů: Flat, Round a Square.

Plochý, kulatý a čtvercový konec na identických tlustých čarách v PowerPointu

Použití skicovacích efektů na čáry tvarů

Skicovací efekt dává čáře tvaru vzhled ručně nakreslený. Použijte IShape.getLineFormat pro přístup k nastavením čáry, ILineFormat.getSketchFormat pro přístup k nastavením skicy a ISketchFormat.setSketchType pro výběr hodnoty ze třídy LineSketchType.

Následující Java kód ukazuje, jak použít efekt LineSketchType.Curved, přečíst výslovně přiřazenou hodnotu a odstranit efekt pomocí LineSketchType.None:

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);

    ISketchFormat sketchFormat = shape.getLineFormat().getSketchFormat();
    sketchFormat.setSketchType(LineSketchType.Curved);
    int explicitSketchType = sketchFormat.getSketchType();
    System.out.println("Explicit sketch type: " + explicitSketchType);
    sketchFormat.setSketchType(LineSketchType.None);
} finally {
    presentation.dispose();
}

Hodnota vrácená metodou ISketchFormat.getSketchType představuje nastavení přiřazené přímo tvaru. Pokud může být formátování čáry zděděno z motivu, hlavní snímku nebo rozvržení, použijte ILineFormat.getEffective, přistupujte k ILineFormatEffectiveData.getSketchFormat a přečtěte ISketchFormatEffectiveData.getSketchType. Efektivní hodnota odráží formátování, které je skutečně aplikováno po vyřešení dědičnosti. Tento příklad vyžaduje existující prezentaci s alespoň jedním tvarem na první snímku a vypíše obě hodnoty:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    ILineFormat lineFormat = shape.getLineFormat();
    int explicitSketchType = lineFormat.getSketchFormat().getSketchType();
    ILineFormatEffectiveData effectiveLineFormat = lineFormat.getEffective();
    int effectiveSketchType = effectiveLineFormat.getSketchFormat().getSketchType();

    System.out.println("Explicit sketch type: " + explicitSketchType);
    System.out.println("Effective sketch type: " + effectiveSketchType);
} finally {
    presentation.dispose();
}

Formátování stylů spojení

Zde jsou tři možnosti typu spojení:

  • Round
  • Miter
  • Bevel

Styl spoje řídí, jak se dva obrysové úseky setkají v rohu. Použijte Round pro zaoblené rohy, Miter pro ostré rohy nebo Bevel pro zploštělé rohy.

Styl spoje v prezentaci

Tento příklad vytvoří tři černé obdélníky s modrými obrysy o šířce 15 bodů. Používá ILineFormat.setJoinStyle pro nastavení hodnot miter, bevel a round třídy LineJoinStyle, aby ukázal, jak jsou rohy vykresleny.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape miterShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75);
    IAutoShape bevelShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75);
    IAutoShape roundShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75);

    miterShape.getFillFormat().setFillType(FillType.Solid);
    miterShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    bevelShape.getFillFormat().setFillType(FillType.Solid);
    bevelShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    roundShape.getFillFormat().setFillType(FillType.Solid);
    roundShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    miterShape.getLineFormat().setWidth(15);
    bevelShape.getLineFormat().setWidth(15);
    roundShape.getLineFormat().setWidth(15);

    miterShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    miterShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    bevelShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    bevelShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    roundShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    roundShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    miterShape.getLineFormat().setJoinStyle(LineJoinStyle.Miter);
    bevelShape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel);
    roundShape.getLineFormat().setJoinStyle(LineJoinStyle.Round);

    miterShape.getTextFrame().setText("Miter Join Style");
    bevelShape.getTextFrame().setText("Bevel Join Style");
    roundShape.getTextFrame().setText("Round Join Style");

    presentation.save("join_styles.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Omezení spojů Miter u ostrých rohů

Použijte ILineFormat.setMiterLimit spolu s ILineFormat.setJoinStyle nastaveným na LineJoinStyle.Miter k omezení, jak daleko může ostrý roh vystoupit.

Limit je poměr vzdálenosti mezi vnitřním a vnějším rohem spoje k šířce čáry. Například hodnota 8 povoluje délku miteru až osminásobek šířky čáry; není to měření v bodech. Pokud by roh překročil limit, PowerPoint použije zploštělý spoj. Větší limit umožňuje ostřejší body. Nastavení ovlivňuje jen spoje typu miter a jeho změna nemá viditelný efekt, pokud roh zůstává v obou limitech.

Tento příklad vytvoří dva identické nevyplněné trojúhelníky s obrysy o šířce 20 bodů. Levý trojúhelník používá limit 2 a pravý limit 8. Každý trojúhelník je široký 80 bodů a vysoký 160 bodů, což dává poměr délky miteru k šířce čáry přibližně 4.12. Proto PowerPoint zploští levý vrchol a zachová pravý.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[] miterLimits = new float[] { 2f, 8f };

    for (int i = 0; i < miterLimits.length; i++) {
        IAutoShape triangle = slide.getShapes().addAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160);
        triangle.getFillFormat().setFillType(FillType.NoFill);
        triangle.getLineFormat().setWidth(20);
        triangle.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 139));
        triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter);
        triangle.getLineFormat().setMiterLimit(miterLimits[i]);
    }

    presentation.save("miter_limits.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek v PowerPointu: Miter limit 2 vlevo a miter limit 8 vpravo.

Zploštělý vrchol s limitem miter 2 a ostrý vrchol s limitem miter 8 v PowerPointu

Gradientní výplň

Gradientní výplň míchá barvy napříč tvarem. Tento příklad vyplní elipsu lineárním gradientem pod úhlem 45° od červené po fialovou pomocí IFillFormat.getGradientFormat. Metoda IGradientStopCollection.addPresetColor umístí barevné zastávky na 0 a 1, na začátek a konec gradientu. Vymazání existujících zastávek zajistí, že budou použity jen tyto dvě barvy.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Gradient);
    shape.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear);
    shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45);
    shape.getFillFormat().getGradientFormat().getGradientStops().clear();
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0f, PresetColor.Purple);
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0f, PresetColor.Red);

    presentation.save("gradient_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Elipsa s gradientní výplní

Pokud gradient v exportovaném obrázku vypadá jinak než v PowerPointu, viz Choose a Gradient Rendering Style. Můžete vybrat styl vykreslování bez změny gradientní výplně uložené v prezentaci.

Nastavení úhlu lineárního gradientu

Použijte IGradientFormat.setLinearGradientAngle k řízení orientace výplně GradientShape.Linear. Úhel se měří ve stupních a zvyšuje se po směru hodinových ručiček: 0 běží zleva doprava, 90 shora dolů, 180 zprava doleva a 270 zdola nahoru. Podporují se i desetinné úhly. Konečné úhly mimo interval [0, 360) jsou normalizovány na jednu otáčku; např. -45 se stane 315 a 360 se stane 0.

Tento příklad vytvoří šest obdélníků se stejnými červenými, zelenými a modrými zastávkami na pozicích 0, 0.5 a 1. Škálování je vypnuto, aby šlo úhly porovnat nezávisle na proporcích obdélníků. Úhly, zleva doprava, jsou 0, 45 a 90 v první řadě a 135, 180 a 270 ve druhé řadě.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[] angles = new float[] { 0, 45, 90, 135, 180, 270 };

    for (int i = 0; i < angles.length; i++) {
        int x = 30 + (i % 3) * 230;
        int y = 30 + (i / 3) * 190;

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
        shape.getFillFormat().setFillType(FillType.Gradient);

        IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(GradientShape.Linear);
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0f, Color.RED);
        gradient.getGradientStops().add(0.5f, Color.GREEN);
        gradient.getGradientStops().add(1f, Color.BLUE);
        gradient.setLinearGradientScaled(NullableBool.False);
        gradient.setLinearGradientAngle(angles[i]);
    }

    presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek v PowerPointu:

Lineární gradienty při 0°, 45° a 90° v horní řadě a 135°, 180° a 270° ve spodní řadě

Škálování lineárního gradientu s tvarem

IGradientFormat.setLinearGradientScaled přijímá hodnotu NullableBool. Nastavte ji explicitně na False, aby geometrický úhel gradientu zůstal stejný při změně proporcí tvaru, nebo na True, aby se gradient škáloval s šířkou a výškou tvaru. Při povoleném škálování se viditelný úhel může lišit od přiřazeného úhlu u nečtvercového tvaru.

Následující příklad používá úhel 45° a stejné barevné zastávky jako v předchozím porovnání úhlů. Levý sloupec používá False; pravý sloupec používá True. Každý sloupec obsahuje široký obdélník nad vysokým obdélníkem. Oba začínají se stejnými širokými rozměry; změna šířky a výšky druhého obdélníku ukazuje, jak výplň reaguje na změnu velikosti bez změny nastavení gradientu.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    byte[] scalingOptions = new byte[] { NullableBool.False, NullableBool.True };

    for (int column = 0; column < scalingOptions.length; column++) {
        for (int row = 0; row < 2; row++) {
            int x = 30 + column * 360;
            int y = row == 0 ? 30 : 150;

            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90);
            shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
            shape.getFillFormat().setFillType(FillType.Gradient);

            IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
            gradient.setGradientShape(GradientShape.Linear);
            gradient.getGradientStops().clear();
            gradient.getGradientStops().add(0f, Color.RED);
            gradient.getGradientStops().add(0.5f, Color.GREEN);
            gradient.getGradientStops().add(1f, Color.BLUE);
            gradient.setLinearGradientAngle(45);
            gradient.setLinearGradientScaled(scalingOptions[column]);

            if (row == 1) {
                shape.setWidth(90);
                shape.setHeight(280);
            }
        }
    }

    presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek v PowerPointu, se škálováním vypnutým vlevo a povoleným vpravo:

Široké a vysoké obdélníky s 45° gradientem, porovnání LinearGradientScaled False vlevo a True vpravo

Se škálováním vypnutým si šikmé barevné pásy zachovají stejnou orientaci v obou obdélnících. Se škálováním povoleným se pásy roztahují podle proporcí tvaru. To pomáhá reprodukovat gradient šablony při přizpůsobení tvaru jiné velikosti. Na čtverci povolení škálování nemění vzhled tohoto 45° gradientu.

Oba nastavení – úhel i škálování – se vztahují jen na lineární gradienty. Neregulují výplně GradientShape.Radial nebo GradientShape.Rectangle.

Kombinace úhlu s směrem gradientu

IGradientFormat.setGradientDirection vybírá styl gradientu ze třídy GradientDirection; není náhradou za číselný úhel. Pro lineární gradient mohou styly rohu změnit oblast, ve které jsou barvy rozloženy, aniž by změnily úhel nastavený metodou setLinearGradientAngle. Při porovnávání úhlů nebo škálování nechte směr beze změny.

Následující příklad aplikuje stejná nastavení v opačném pořadí. Oba obdélníky mají stejný vzhled: nastavení směru před nebo po úhlu výsledek nemění.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    for (int i = 0; i < 2; i++) {
        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
        shape.getFillFormat().setFillType(FillType.Gradient);

        IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(GradientShape.Linear);
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0f, Color.RED);
        gradient.getGradientStops().add(0.5f, Color.GREEN);
        gradient.getGradientStops().add(1f, Color.BLUE);
        gradient.setLinearGradientScaled(NullableBool.True);

        if (i == 0) {
            gradient.setGradientDirection(GradientDirection.FromCorner1);
            gradient.setLinearGradientAngle(30);
        } else {
            gradient.setLinearGradientAngle(30);
            gradient.setGradientDirection(GradientDirection.FromCorner1);
        }
    }

    presentation.save("linear_gradient_direction.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Vzorková výplň

Vzorková výplň používá dvoubarevný návrh, například tečky, pruhy nebo šachovnici. Tento příklad používá IPatternFormat.setPatternStyle k výběru vzoru „mřížka“. IPatternFormat.getBackColor poskytuje světle šedé pozadí a IPatternFormat.getForeColor poskytuje žlutou barvu vzoru.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Pattern);
    shape.getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.Trellis);
    shape.getFillFormat().getPatternFormat().getBackColor().setColor(Color.LIGHT_GRAY);
    shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW);

    presentation.save("pattern_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Obdélník s vzorkovou výplní

Obrázková výplň

Obrázková výplň používá obrázek uvnitř tvaru. Tento příklad vyžaduje lokální obrázek a používá Images.fromFile k načtení do kolekce obrázků prezentace. Nastavení IPictureFillFormat.setPictureFillMode na režim dlaždic opakuje obrázek uvnitř obdélníku. Použitý zdrojový obrázek je zobrazen níže:

Obrázek lotosu

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130);
    shape.getFillFormat().setFillType(FillType.Picture);
    shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile);

    IImage image = Images.fromFile("lotus.png");
    IPPImage picture;
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }
    shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    presentation.save("picture_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Tvar s obrázkovou výplní

Opakovat obrázek jako texturu

Pokud chcete nastavit opakovaný obrázek jako texturu a přizpůsobit chování opakování, můžete použít následující metody rozhraní IPictureFillFormat a třídy PictureFillFormat:

  • setPictureFillMode: Nastavuje režim výplně obrázkem – Tile nebo Stretch.
  • setTileAlignment: Určuje zarovnání dlaždic uvnitř tvaru.
  • setTileFlip: Řídí, zda je dlaždice otočena horizontálně, vertikálně nebo obojí.
  • setTileOffsetX: Nastavuje horizontální posun dlaždice (v bodech) od počátku tvaru.
  • setTileOffsetY: Nastavuje vertikální posun dlaždice (v bodech) od počátku tvaru.
  • setTileScaleX: Definuje horizontální měřítko dlaždice v procentech.
  • setTileScaleY: Definuje vertikální měřítko dlaždice v procentech.

Tento příklad vyžaduje lokální obrázek a konfiguruje IPictureFillFormat tak, aby jej opakoval při 50 % původní velikosti. Posuny –32 bodů posunou dlaždice horizontálně i vertikálně; zarovnání vpravo dole a otočení v obou směrech určuje, jak je opakovaná textura uspořádána.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);

    IAutoShape shape = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95);
    shape.getFillFormat().setFillType(FillType.Picture);

    IImage sourceImage = Images.fromFile("lotus.png");
    IPPImage presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFillFormat pictureFillFormat = shape.getFillFormat().getPictureFillFormat();
    pictureFillFormat.getPicture().setImage(presentationImage);
    pictureFillFormat.setPictureFillMode(PictureFillMode.Tile);
    pictureFillFormat.setTileOffsetX(-32);
    pictureFillFormat.setTileOffsetY(-32);
    pictureFillFormat.setTileScaleX(50);
    pictureFillFormat.setTileScaleY(50);
    pictureFillFormat.setTileAlignment(RectangleAlignment.BottomRight);
    pictureFillFormat.setTileFlip(TileFlip.FlipBoth);

    presentation.save("tile.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Možnosti dlaždic

Plná barevná výplň

Plná výplň dává tvaru jedinou, jednotnou barvu. Tento příklad používá IFillFormat.setFillType k nastavení režimu plné výplně a přiřadí žlutou barvu pomocí IFillFormat.getSolidFillColor, poté uloží obdélník v prezentaci.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.YELLOW);

    presentation.save("solid_color_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Tvar s plnou barevnou výplní

Kopírování barev s zachováním odkazů na motiv

Použijte IColorFormat.copyFrom ke kopírování definice barvy, včetně typu barvy, odkazu na motiv a transformací. To je užitečné při přenosu výplňové barvy mezi tvary, které by měly i nadále následovat motiv prezentace. Metoda kopíruje jen barvu: nekopíruje typ výplně, obrys ani jiné formátování tvaru. Cílový typ výplně nastavte explicitně pomocí IFillFormat.setFillType.

Tento příklad vytvoří tři obdélníky, zleva doprava: zdroj, kopii citlivou na motiv a pevnou RGB kopii. Zdroj používá IColorFormat.setSchemeColor k odkazu na první akcentní barvu a přidává odstín pomocí IColorOperationCollection.add. RGB kopie používá efektivní výplňovou barvu zdroje, takže všechny tři na začátku vypadají identicky. Voláním IColorFormat.setColor nastaví pevnou RGB hodnotu a vymaže veškeré existující transformace barvy.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(new Color(65, 105, 225));

    IAutoShape source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140);
    IAutoShape themeCopy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140);
    IAutoShape rgbCopy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140);

    for (IAutoShape shape : new IAutoShape[] { source, themeCopy, rgbCopy }) {
        shape.getFillFormat().setFillType(FillType.Solid);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
    }

    IColorFormat sourceColor = source.getFillFormat().getSolidFillColor();
    sourceColor.setSchemeColor(SchemeColor.Accent1);
    sourceColor.getColorTransform().add(ColorTransformOperation.Tint, 0.75f);

    themeCopy.getFillFormat().getSolidFillColor().copyFrom(sourceColor);
    rgbCopy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor());

    IImage before = slide.getImage(1f, 1f);
    try {
        before.save("color-copy-before.png", ImageFormat.Png);
    } finally {
        before.dispose();
    }

    // Odkazy na motiv následují novou akcentní barvu; pevná hodnota RGB ne.
    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(new Color(255, 69, 0));

    IImage after = slide.getImage(1f, 1f);
    try {
        after.save("color-copy-after.png", ImageFormat.Png);
    } finally {
        after.dispose();
    }
    presentation.save("copied_colors.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Před změnou motivu jsou všechny tři výplně shodné:

Zdroj, copyFrom cíl a pevný RGB cíl s identickými modrými výplněmi

Po změně motivu zdroj a kopie citlivá na motiv následují novou akcentní barvu a zachovají svůj odstín. Pevná RGB kopie zůstane modrá:

Zdroj a copyFrom cíl s oranžovými výplněmi, zatímco pevný RGB cíl zůstává modrý

Zkopírovaná definice je nezávislá na zdroji. Následná změna odkazu na motiv, přiřazení jiné barvy nebo přidání/odebrání transformací neovlivní cíl. Změna motivu stále ovlivní oba tvary, protože každý samostatně odkazuje na stejnou barvu motivu.

Uložení a znovuotevření PPTX zachová typ zkopírované barvy vrácený metodou IColorFormat.getColorType, odkaz na motiv a kolekci transformací vrácenou metodou IColorFormat.getColorTransform; neplochuje definici na RGB.

Při kopírování mezi různými kontexty motivů, např. prezentacemi s odlišnými akcentními paletami, se zkopírovaný odkaz vyhodnocuje vůči motivu cíle. Stejný odkaz a transformace tak mohou vytvořit jinou viditelnou barvu. Viz Presentation Theme pro více informací o konfiguraci motivových barev.

Použití pozadí snímku jako výplně tvaru

Použijte IAutoShape.setUseBackgroundFill, když má tvar odpovídat pozadí snímku, například v šabloně prezentace. Nastavte typ výplně pomocí IFillFormat.setFillType na FillType.NotDefined nejprve, abyste odstranili jakoukoli explicitní výplň. S tímto spojením tvar používá pozadí snímku místo své vlastní výplně. Pouze nastavení příznaku neodstraní existující explicitní výplň.

To se liší od FillType.NoFill: výplň pozadí zakrývá objekty za tvarem odpovídajícím oblastí pozadí snímku, zatímco žádná výplň tyto objekty nechává viditelné. Gradient zůstává zarovnán k snímku místo toho, aby se restartoval uvnitř každého tvaru.

Následující příklad vytvoří hlavní pozadí zděděné snímkem a umístí purpurovou pruh za tři obdélníky. Levý obdélník používá pozadí, prostřední nemá výplň a pravý přepíná z výplně pozadí na explicitní oranžovou výplň.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    // Zdědit gradient z hlavního motivu.
    slide.getBackground().setType(BackgroundType.NotDefined);
    slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined);
    IBackground background = slide.getLayoutSlide().getMasterSlide().getBackground();
    background.setType(BackgroundType.OwnBackground);
    background.getFillFormat().setFillType(FillType.Gradient);
    IGradientFormat gradient = background.getFillFormat().getGradientFormat();
    gradient.setGradientShape(GradientShape.Linear);
    gradient.setLinearGradientAngle(0);
    gradient.getGradientStops().clear();
    gradient.getGradientStops().add(0, new Color(0, 0, 139));
    gradient.getGradientStops().add(1, new Color(135, 206, 250));

    // Přidejte tento objekt jako první, aby byl za obdélníky.
    IAutoShape band = slide.getShapes().addAutoShape(ShapeType.Rectangle, 25, 150, 670, 100);
    band.getFillFormat().setFillType(FillType.Solid);
    band.getFillFormat().getSolidFillColor().setColor(Color.MAGENTA);
    band.getLineFormat().getFillFormat().setFillType(FillType.NoFill);

    IAutoShape backgroundShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200);
    backgroundShape.getFillFormat().setFillType(FillType.NotDefined);
    backgroundShape.setUseBackgroundFill(true);

    IAutoShape noFillShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200);
    noFillShape.getFillFormat().setFillType(FillType.NoFill);

    IAutoShape explicitShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200);
    explicitShape.getFillFormat().setFillType(FillType.NotDefined);
    explicitShape.setUseBackgroundFill(true);

    // Zakázat výplň pozadí před použitím explicitní výplně.
    explicitShape.setUseBackgroundFill(false);
    explicitShape.getFillFormat().setFillType(FillType.Solid);
    explicitShape.getFillFormat().getSolidFillColor().setColor(new Color(255, 165, 0));

    presentation.save("background_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek, zleva doprava: výplň pozadí, žádná výplň a explicitní výplň. Purpurový pruh je skryt levým a pravým obdélníkem, ale zůstává viditelný skrz prostřední obdélník.

Výplň pozadí, žádná výplň a explicitní oranžová výplň nad purpurovým pruhem

Stejné chování platí pro pozadí definované přímo na snímku nebo zděděné z rozvržení. Tvar používá rozlišené pozadí snímku; příklad ponechává jak pozadí snímku, tak rozvržení nedefinované, aby je poskytl hlavní motiv.

Nastavení průhlednosti

U plné výplně řídí alfa komponenta barvy neprůhlednost: 0 je úplně průhledná a 255 úplně neprůhledná. Tento příklad používá alfa hodnotu 128 pro žlutý obdélník, což jej činí přibližně 50 % průhledným, takže podkladový obdélník zůstává viditelný. Barva je přiřazena pomocí IFillFormat.getSolidFillColor.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape solidShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    IAutoShape transparentShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75);
    transparentShape.getFillFormat().setFillType(FillType.Solid);
    transparentShape.getFillFormat().getSolidFillColor().setColor(new Color(255, 255, 0, 128));

    presentation.save("shape_transparency.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Průhledný tvar

Rotace tvarů

Použijte IShape.setRotation k rotaci tvaru v rovině snímku. Úhel se měří ve stupních; tento příklad otočí obdélník o 5 stupňů po směru hodinových ručiček a uloží prezentaci.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.setRotation(5);

    presentation.save("shape_rotation.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

Rotace tvaru

Přidání 3D efektního zkosení

Použijte IShape.getThreeDFormat k přidání hloubky a zkosených hran tvaru. Tento příklad vytvoří zelenou elipsu s oranžovým obrysem, použije IThreeDFormat.setDepth k nastavení hloubky na 4 body a aplikuje kruhové horní zkosení o šířce a výšce 6 bodů pomocí IThreeDFormat.getBevelTop. Front‑facing ortografická kamera a tříbodové osvětlení činí zkosení viditelným.

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(0, 128, 0));
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(255, 165, 0));
    shape.getLineFormat().setWidth(2.0);
    shape.getThreeDFormat().setDepth(4);
    shape.getThreeDFormat().getBevelTop().setBevelType(BevelPresetType.Circle);
    shape.getThreeDFormat().getBevelTop().setHeight(6);
    shape.getThreeDFormat().getBevelTop().setWidth(6);
    shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
    shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.ThreePt);
    shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);

    presentation.save("3D_bevel_effect.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

3D efekt zkosení

Přidání 3D rotačních efektů

3D pohled tvaru je řízen nastavením kamery. Tento příklad používá ICamera.setRotation s úhly latitude, longitude a revoluce 40, 35 a 20 stupňů. Vybere izometrickou kameru pomocí ICamera.setCameraType a vyvážené osvětlení pomocí ILightRig.setLightType, poté uloží formatovaný obdélník.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    autoShape.getTextFrame().setText("Hello, Aspose!");
    autoShape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp);
    autoShape.getThreeDFormat().getCamera().setRotation(40, 35, 20);
    autoShape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced);

    presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Výsledek:

3D rotační efekt

Řízení černobílého vykreslování pro tvary

Metoda IShape.setBlackWhiteMode určuje, jak se jednotlivý tvar vykreslí, když je prezentace zobrazena nebo zpracována v černobílém režimu. Samotná metoda neaktivuje černobílý režim a nemění výplň, obrys ani jiné formátování tvaru v normálním barevném režimu.

Použijte hodnotu ze třídy BlackWhiteMode pro výběr požadovaného chování. Například Automatic nechá aplikaci zvolit konverzi, Gray a LightGray použijí šedé odstíny, BlackWhite jen černou a bílou, Black a White vynutí jedinou barvu, Color zachová normální barvy a Hidden vynechá tvar v černobílém režimu. NotDefined znamená, že není přiřazen žádný režim na úrovni tvaru.

Tento příklad vytvoří oranžový obdélník a použije IShape.setBlackWhiteMode k nastavení režimu na šedou. Uložený tvar si zachová oranžovou výplň pro normální barevné zobrazení a požádá o šedé zobrazení aplikace, které respektují nastavení černobílého režimu:

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(255, 165, 0));
    shape.setBlackWhiteMode(BlackWhiteMode.Gray);

    presentation.save("shape_black_white_mode.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

V normálním barevném režimu obdélník zachovává oranžovou výplň. V černobílém pracovním postupu používá šedé zabarvení, protože jeho režim je nastaven na Gray. To vám umožní zachovat plno‑barevný snímek a zároveň definovat odlišný vzhled pro tisk, náhled nebo jiné postupy, které respektují nastavení černobílého zobrazení prezentace.

Resetování formátování

Použijte ISlide.reset k obnovení pozice, velikosti a formátování zástupných objektů snímku z odpovídajících zástupných objektů rozvržení. Tento příklad vyžaduje existující prezentaci s propojenými zástupnými objekty rozvržení a resetuje každý snímek před uložením. Tvary bez odpovídajících zástupných objektů rozvržení nejsou resetovány.

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        slide.reset();
    }

    presentation.save("reset_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Často kladené dotazy

Ovlivňuje formátování tvaru konečnou velikost souboru prezentace?

Barvy, styly čar a nastavení efektů obvykle přidávají jen málo dat ve srovnání s vloženými obrázky a médiemi. Obrázkové výplně mohou zvýšit velikost souboru, protože jejich obrázky jsou uloženy v prezentaci.

Jak mohu detekovat tvary na snímku, které mají identické formátování, abych je mohl seskupit?

Porovnejte klíčové vlastnosti formátování každého tvaru – výplň, čáru a nastavení efektů. Pokud se všechny odpovídající hodnoty shodují, považujte jejich styly za identické a logicky je seskupte; to usnadní následnou správu stylů.

Mohu uložit sadu vlastních stylů tvarů do samostatného souboru pro opětovné použití v jiných prezentacích?

Ano. Uložte ukázkové tvary s požadovanými styly do šablonového souboru prezentace nebo souboru .POTX. Při vytváření nové prezentace otevřete šablonu, klonujte potřebné stylované tvary a znovu aplikujte jejich formátování tam, kde je potřeba.