Lägg till bildramar i presentationer med Python

Introduktion

Bildramar i Aspose.Slides för Python låter dig placera och hantera raster- och vektorbilder som inbyggda bildobjekt på bilden. Du kan infoga bilder från filer eller strömmar, positionera och ändra storlek med exakta koordinater, applicera rotation, ange transparens och kontrollera z‑ordning tillsammans med andra former. API:et stödjer också beskärning, bevarande av bildförhållanden, inställning av kanter och effekter samt ersättning av den underliggande bilden utan att bygga om layouten. Eftersom bildramar beter sig som vanliga former kan du lägga till animationer, hyperlänkar och alternativ text, vilket gör det enkelt att skapa visuellt rika, tillgängliga presentationer.

Skapa bildramar

Detta avsnitt visar hur du infogar en bild i en bild genom att skapa en PictureFrame med Aspose.Slides för Python. Du får lära dig hur du laddar bilden, placerar den exakt på bilden och styr dess storlek och formatering.

Skapa en instans av klassen Presentation.
Hämta en bild efter dess index.
Skapa en PPImage genom att lägga till bilden i presentationens ImageCollection. Denna bild används för att fylla formen.
Ange ramens bredd och höjd.
Skapa en PictureFrame av den storleken med metoden add_picture_frame.
Spara presentationen som en PPTX‑fil.

import aspose.slides as slides

# Skapa en instans av Presentation-klassen för att representera en PPTX-fil.
with slides.Presentation() as presentation:
    # Hämta den första bilden.
    slide = presentation.slides[0]

    # Lägg till bilden i presentationen.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Lägg till en bildram med storlek anpassad till bilden.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Spara presentationen som PPTX.
        presentation.save("picture_frame.pptx", slides.export.SaveFormat.PPTX)

Bildramar låter dig snabbt skapa presentationsbilder från bilder. När du kombinerar bildramar med Aspose.Slides sparalternativ kan du styra I/O‑operationer för att konvertera bilder från ett format till ett annat. Du kanske vill se dessa sidor: konvertera bild till JPG; konvertera JPG till bild; konvertera JPG till PNG; konvertera PNG till JPG; konvertera PNG till SVG; konvertera SVG till PNG.

Skapa bildramar med relativ skala

Detta avsnitt demonstrerar hur du placerar en bild med fast storlek och sedan tillämpar procentuell skalning oberoende på bredd och höjd. Eftersom procentandelarna kan skilja sig kan bildförhållandet förändras. Skalning utförs relativt bildens ursprungliga dimensioner.

Skapa en instans av klassen Presentation.
Hämta en bild efter dess index.
Skapa en PPImage genom att lägga till bilden i presentationens ImageCollection.
Lägg till en PictureFrame på bilden.
Ange bildramens relativa bredd och höjd.
Spara presentationen som en PPTX‑fil.

import aspose.slides as slides

# Skapa en instans av Presentation-klassen för att representera en PPTX-fil.
with slides.Presentation() as presentation:
    # Hämta den första bilden.
    slide = presentation.slides[0]

    # Lägg till bilden i presentationens bildsamling.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Lägg till en bildram på bilden.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)

        # Ange relativ skalning för bredd och höjd.
        picture_frame.relative_scale_height = 0.8
        picture_frame.relative_scale_width = 1.35

        # Spara presentationen.
        presentation.save("relative_scaling.pptx", slides.export.SaveFormat.PPTX)

Extrahera rasterbilder från bildramar

Du kan extrahera rasterbilder från PictureFrame‑objekt och spara dem som PNG, JPG och andra format. Koden nedan visar hur du extraherar en bild från dokumentet “sample.pptx” och sparar den i PNG‑format.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    first_slide = presentation.slides[0]
    first_shape = first_slide.shapes[0]

    if isinstance(first_shape, slides.PictureFrame):
        image = first_shape.picture_format.picture.image.image
        image.save("slide_1_shape_1.png", slides.ImageFormat.PNG)

Extrahera SVG‑bilder från bildramar

När en presentation innehåller SVG‑grafik placerad i PictureFrame-former låter Aspose.Slides för Python via .NET dig hämta de ursprungliga vektorbilderna med fullständig noggrannhet. Genom att gå igenom bildens formsamling kan du identifiera varje PictureFrame, kontrollera om den underliggande PPImage innehåller SVG‑innehåll och sedan spara bilden till disk eller en ström i dess ursprungliga SVG‑format.

Koden nedan demonstrerar hur du extraherar en SVG‑bild från en bildram:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.PictureFrame):
        svg_image = shape.picture_format.picture.image.svg_image

        if svg_image is not None:
            with open("output.svg", "w", encoding="utf-8") as svg_stream:
                svg_stream.write(svg_image.svg_content)

Hämta bildtransparens

Aspose.Slides låter dig hämta transparenseffekten som applicerats på en bild. Denna Python‑kod demonstrerar operationen:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    picture_frame = presentation.slides[0].shapes[0]
    image_transform = picture_frame.picture_format.picture.image_transform
    for effect in image_transform:
        if isinstance(effect, slides.effects.AlphaModulateFixed):
            transparency_value = 100 - effect.amount
            print("Picture transparency: " + str(transparency_value))

Alla effekter som applicerats på bilder finns i aspose.slides.effects.

Hämta ljusstyrka och kontrast för en bild

Aspose.Slides låter dig hämta ljusstyrke‑ och kontrasteffekten som applicerats på en bild. Klassen Luminance representerar denna bildtransformationseffekt.

Denna Python‑kod visar hur du får ljusstyrke‑ och kontrastinställningarna från en bildram:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]
    picture_frame = shape

    image_transform = picture_frame.picture_format.picture.image_transform
    for effect in image_transform:
        if isinstance(effect, slides.effects.Luminance):
            luminance = effect.get_effective()
            brightness = luminance.brightness
            contrast = luminance.contrast

            print("Brightness: " + str(brightness))
            print("Contrast: " + str(contrast))

Formatering av bildramar

Aspose.Slides erbjuder många formateringsalternativ som du kan applicera på en bildram. Med dessa alternativ kan du justera en bildram för att möta specifika krav.

Skapa en instans av klassen Presentation.
Hämta en bild efter dess index.
Skapa en PPImage genom att lägga till bilden i presentationens ImageCollection. Denna bild används för att fylla formen.
Ange ramens bredd och höjd.
Skapa en PictureFrame av den storleken med bildens add_picture_frame-metod.
Ange bildramens linjefärg.
Ange bildramens linjebredd.
Rotera bildramen genom att ange ett positivt (medurs) eller negativt (moturs) värde.
Spara den ändrade presentationen som en PPTX‑fil.

import aspose.slides as slides
import aspose.pydrawing as draw

# Skapa en instans av Presentation-klassen för att representera en PPTX-fil.
with slides.Presentation() as presentation:
    # Hämta den första bilden.
    slide = presentation.slides[0]

    # Lägg till bilden i presentationens bildsamling.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Lägg till en bildram med storlek anpassad till bilden.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Applicera formatering på bildramen.
        picture_frame.line_format.fill_format.fill_type = slides.FillType.SOLID
        picture_frame.line_format.fill_format.solid_fill_color.color = draw.Color.blue
        picture_frame.line_format.width = 20
        picture_frame.rotation = 45

    # Spara presentationen som PPTX.
    presentation.save("picture_formatting.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose har utvecklat en gratis Collage Maker. Om du behöver sammanfoga JPG/JPEG eller PNG‑bilder, eller skapa fotogriddern, kan du använda denna tjänst.

Lägg till bilder som länkar

För att hålla presentationsfiler små kan du lägga till bilder eller videor via länkar istället för att bädda in filerna direkt i presentationerna. Följande Python‑kod visar hur du infogar en bild och en video i en platshållare:

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    slide = presentation.slides[0]

    shapes_to_remove = []

    for shape in slide.shapes:
        if shape.placeholder is None:
            continue

        if shape.placeholder.type == slides.PlaceholderType.PICTURE:
            picture_frame = slide.shapes.add_picture_frame(
                slides.ShapeType.RECTANGLE, shape.x, shape.y, shape.width, shape.height, None)

            picture_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            shapes_to_remove.append(shape)

        elif shape.placeholder.type == slides.PlaceholderType.MEDIA:
            video_frame = slide.shapes.add_video_frame(shape.X, shape.Y, shape.width, shape.height, "")

            video_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            video_frame.link_path_long = "https://youtu.be/t_1LYZ102RA"
            shapes_to_remove.append(shape)

    for shape in shapes_to_remove:
        slide.shapes.remove(shape)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Beskär bilder

I det här avsnittet lär du dig hur du beskär den synliga delen av en bild i en bildram utan att ändra källfilen. Du får också lära dig den grundläggande metoden för att applicera beskärningsmarginaler för att skapa en ren, fokuserad komposition direkt på bilden.

Följande Python‑kod visar hur du beskär en bild på en bild:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # Lägg till bilden i presentationens bildsamling.
    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    # Lägg till en bildram på bilden.
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 100, 100, 420, 250, image)

    # Beskär bilden (procentvärden).
    picture_frame.picture_format.crop_left = 23.6
    picture_frame.picture_format.crop_right = 21.5
    picture_frame.picture_format.crop_top = 3
    picture_frame.picture_format.crop_bottom = 31

    # Spara resultatet.
    presentation.save("cropped_image.pptx", slides.export.SaveFormat.PPTX)

Ta bort beskurna områden av bilder

Om du vill ta bort de beskurna områdena av en bild i en ram, använd metoden delete_picture_cropped_areas. Metoden returnerar den beskurna bilden, eller originalbilden om ingen beskärning behövs.

Följande Python‑kod demonstrerar operationen:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    # Hämta PictureFrame från den första bilden.
    picture_frame = slides.shape[0]

    # Hämta PictureFrame från den första bilden.
    cropped_image = picture_frame.picture_format.delete_picture_cropped_areas()

    # Spara resultatet.
    presentation.save("deleted_cropped_areas.pptx", slides.export.SaveFormat.PPTX)

NOTE

Metoden delete_picture_cropped_areas lägger till den beskurna bilden i presentationens bildsamling. Om bilden endast används i den bearbetade PictureFrame kan detta minska presentationsstorleken; annars kan antalet bilder i den resulterande presentationen öka.

Under beskärning konverterar metoden WMF/EMF‑metafiler till en raster‑PNG‑bild.

Komprimera bilder

Du kan komprimera en bild i en presentation med metoden PictureFillFormat.compress_image. Denna metod komprimerar en bild genom att minska dess storlek baserat på formens storlek och angiven upplösning, med möjlighet att ta bort beskurna områden.

Den justerar bildens storlek och upplösning på liknande sätt som PowerPoints Picture Format → Compress Pictures → Resolution‑funktion.

Följande Python‑exempel visar hur du komprimerar en bild i en presentation genom att ange en målupplösning och eventuellt ta bort beskurna områden:

import aspose.slides as slides

with slides.Presentation("demo.pptx") as presentation:
    slide = presentation.slides[0]
    picture_frame = slide.shapes[0]

    # Komprimera bilden med en målupplösning på 150 DPI (web-upplösning) och ta bort beskurna områden.
    result = picture_frame.picture_format.compress_image(True, slides.export.PicturesCompression.DPI150)

    # Kontrollera resultatet av komprimeringen.
    if result:
        print("Image successfully compressed.")
    else:
        print("Image compression failed or no changes were necessary.")

    presentation.save("compressed_image.pptx", slides.export.SaveFormat.PPTX)

Eller genom att ange ett eget DPI‑värde direkt:

import aspose.slides as slides

with slides.Presentation("demo.pptx") as presentation:
    slide = presentation.slides[0]
    picture_frame = slide.shapes[0]

    # Komprimera bilden till 150 DPI (web-upplösning), ta bort beskurna områden.
    picture_frame.picture_format.compress_image(True, 150)

    presentation.save("compressed_image.pptx", slides.export.SaveFormat.PPTX)

NOTE

Metoden konverterar bilden till en lägre upplösning baserat på formens storlek och angivet DPI. Beskurna regioner kan också raderas för att optimera filstorleken. Om bilden är en metafil (WMF/EMF) eller SVG kommer komprimering inte att tillämpas. JPEG‑kvaliteten bevaras eller minskas något beroende på upplösning, på samma sätt som PowerPoint hanterar högupplösta JPEG‑filer.

Lås bildförhållandet

Om du vill att en form som innehåller en bild ska behålla sitt bildförhållande efter att du ändrat bildens dimensioner, sätt egenskapen aspect_ratio_locked till True.

Följande Python‑kod visar hur du låser en forms bildförhållande:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    layout = presentation.layout_slides.get_by_type(slides.SlideLayoutType.CUSTOM)
    empty_slide = presentation.slides.add_empty_slide(layout)

    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = empty_slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

    # Lås bildförhållandet vid storleksändring.
    picture_frame.picture_frame_lock.aspect_ratio_locked = True

    presentation.save("aspect_ratio_locked.pptx", slides.export.SaveFormat.PPTX)

NOTE

Denna Lock Aspect Ratio-inställning bevarar endast formens bildförhållande, inte bildens förhållande inuti den.

Använd stretch‑offset‑egenskaper

Genom att använda egenskaperna stretch_offset_left, stretch_offset_top, stretch_offset_right och stretch_offset_bottom i klassen PictureFillFormat kan du definiera en fyllningsrektangel.

När stretchning anges för en bild skalas källrektangeln för att passa fyllningsrektangeln. Varje kant av fyllningsrektangeln definieras av en procentuell offset från motsvarande kant av formens omgivningsruta. En positiv procent anger ett inskjut, medan en negativ procent anger ett utskjut.

Skapa en instans av klassen Presentation.
Hämta en referens till en bild efter dess index.
Lägg till en rektangulär AutoShape.
Ange formens fyllningstyp.
Ange formens bildfyllningsläge.
Ladda en bild.
Tilldela bilden för att fylla formen.
Ange bildens offset från motsvarande kanter av formens omgivningsruta.
Spara presentationen som en PPTX‑fil.

Följande Python‑kod demonstrerar hur du använder stretch‑offset‑egenskaperna:

import aspose.slides as slides

# Skapa en instans av Presentation-klassen som representerar en PPTX-fil.
with slides.Presentation() as presentation:
    # Hämta den första bilden.
    slide = presentation.slides[0]

    # Lägg till en rektangulär AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 300, 300)

    # Ange formens fyllningstyp.
    shape.fill_format.fill_type = slides.FillType.PICTURE

    # Ange formens bildfyllningsläge.
    shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

    # Läs in bilden och lägg till den i presentationen.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

    # Tilldela bilden för att fylla formen.
    shape.fill_format.picture_fill_format.picture.image = image

    # Ange bildens offset från motsvarande kanter av formens omgivningsruta.
    shape.fill_format.picture_fill_format.stretch_offset_left = 25
    shape.fill_format.picture_fill_format.stretch_offset_right = 25
    shape.fill_format.picture_fill_format.stretch_offset_top = -20
    shape.fill_format.picture_fill_format.stretch_offset_bottom = -10

    # Spara PPTX-filen till disk.
    presentation.save("stretch_offset.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose tillhandahåller gratis konverterare—JPEG till PowerPoint och PNG till PowerPoint—som låter dig snabbt skapa presentationer från bilder.

Vanliga frågor

Hur kan jag ta reda på vilka bildformat som stöds för PictureFrame?

Aspose.Slides stödjer både rasterbilder (PNG, JPEG, BMP, GIF osv.) och vektorbilder (till exempel SVG) via bildobjektet som tilldelas en PictureFrame. Listan över stödjade format överlappar i allmänhet med funktionerna i bild‑ och konverteringsmotorn.

Hur påverkar att lägga till dussintals stora bilder PPTX‑storlek och prestanda?

Att bädda in stora bilder ökar filstorlek och minnesanvändning; att länka bilder hjälper hålla presentationsstorleken nere men kräver att de externa filerna förblir åtkomliga. Aspose.Slides erbjuder möjlighet att lägga till bilder via länk för att minska filstorleken.

Hur kan jag låsa ett bildobjekt så att det inte av misstag flyttas eller skalas?

Använd shape locks för en PictureFrame (till exempel inaktivera flyttning eller skalning). Låsningsmekanismen beskrivs för former i en separat protection article och stöds för olika formtyper, inklusive PictureFrame.

Bevaras SVG‑vektorfidelitet när en presentation exporteras till PDF/bilder?

Aspose.Slides låter dig extrahera en SVG från en PictureFrame som den ursprungliga vektorn. När du exporterar till PDF eller rasterformat kan resultatet rasteriseras beroende på exportinställningarna; faktumet att den ursprungliga SVG:n lagras som en vektor bekräftas av extraktionsbeteendet.