GifImage-klass

Summary: The API for Graphical Interchange Format (GIF) image file provides
developers with versatile tools for processing compressed raster images and
animated GIFs. Offering features like XMP metadata handling, color palette
settings, background and transparent color control, opacity settings, resize,
crop, filter application, gamma corrections, contrast adjustment, grayscale
transformation, and conversion to other formats. This API empowers seamless
manipulation and enhancement of GIF images for a wide range of applications.

Module: aspose.imaging.fileformats.gif

Full Name: aspose.imaging.fileformats.gif.GifImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

NameDescription
GifImage(first_frame)Att skapa GIF‑bilder blir enkelt med GifImage
konstruktor. Med bara firstFrame‑parametern går du in i en värld av dynamisk
visuell kommunikation.
GifImage(first_frame, global_palette)Initiera ett nytt GifImage objekt med angivna parametrar för
första ramen och global palett. Börja hantera GIF‑bilder snabbt, och säkerställ
korrekt återgivning med anpassningsbara inställningar för optimala resultat.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)Kom igång enkelt med GifImage‑konstruktorn. Med denna
enkla metoden kan du dyka in i att skapa animerade GIF‑filer med lätthet. Ange bara
firstFrame, globalPalette, paletteColorResolution, aspectRatio och andra
parametrar, så är du redo att ge liv åt dina visuella element.

Properties

NameTypeAccessDescription
active_frameGifFrameBlockr/wHantera och manipulera ramar med denna egenskap, vilket möjliggör smidig navigering och
modifiering av den aktiva ramen i GIF‑bilden.
auto_adjust_paletteboolr/wHämtar eller anger ett värde som indikerar om automatisk justering av palett.
background_colorColorr/wHantera bakgrundsfärgen i GIF‑bilden med denna egenskap. Du kan sätta eller
hämta bakgrundsfärgen för att säkerställa konsistens och förbättra den visuella attraktionskraften.
background_color_indexSystem.Byter/wStyr bakgrundsfärgindexet för GIF‑bilden med denna egenskap. Sätt eller
hämta indexet för att upprätthålla konsistens eller uppnå önskade visuella effekter.
bits_per_pixelintrHämtar bildens bitar per pixel.
blocksIGifBlock[]rFå sömlös åtkomst till GIF‑blocken med denna egenskap, vilket underlättar enkel
hämtning och manipulering av bildens underliggande datastrukturer.
boundsRectanglerHämtar objektets gränser.
buffer_size_hintintr/wHämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
containerImagerHämtar Image behållaren.
data_stream_containerStreamContainerrHämtar objektets datastream.
disposedboolrHämtar ett värde som indikerar om den här instansen är frigjord.
exif_dataExifDatar/wHämtar eller anger Exif-instans.
file_formatFileFormatrHämta filformatet enkelt med denna egenskap. Det är din primära källa
för att identifiera formatet på dina filer. Sömlöst integrerad i ditt arbetsflöde,
ger den viktig information utan krångel.
has_alphaboolrHämtar ett värde som indikerar om denna instans har alfa.
has_background_colorboolr/wDenna egenskap avgör om GIF‑bilden innehåller en bakgrundsfärg. Om
true indikerar det att bilden har en bakgrundsfärg.
has_trailerboolr/wHantera förekomsten av en trailer i dina GIF‑filer med denna egenskap. Oavsett om du
behöver kontrollera om en trailer finns eller ange dess närvaro, förenklar denna egenskap
processen. Håll dina GIF‑filer strukturerade och i enlighet med denna intuitiva funktion.
has_transparent_colorboolr/wBestäm om den aktiva ramen i GIF‑bilden innehåller en transparent färg.
Denna egenskap ger ett bekvämt sätt att kontrollera transparens i bilden.
heightintrHämtar bildens höjd.
horizontal_resolutionfloatr/wHämtar eller anger den horisontella upplösningen, i pixlar per tum, för denna RasterImage.
image_opacityfloatrHämta opaciteten för den aktiva ramen i bilden, vilket ger insikt i
dess transparensnivå. Denna egenskap är särskilt användbar för att förstå
graden av transparens eller ogenomskinlighet i den aktiva ramen i bilden.
interrupt_monitorInterruptMonitorr/wHämtar eller anger avbrottsövervakaren.
is_cachedboolrHämtar ett värde som indikerar om bilddata för närvarande är cachad.
is_interlacedboolrBestämmer om bilden är interlaced, vilket påverkar dess visning under inläsning. Denna
egenskap ger insikt i bildens renderingsbeteende, vilket är avgörande för
optimering av inläsningsstrategier och förbättring av den övergripande visningsupplevelsen.
is_palette_sortedboolr/wStyr sorteringen av paletten i dina GIF-bilder med hjälp av denna egenskap. Oavsett
om du behöver kontrollera om paletten är sorterad eller ange sorteringsbeteendet, så ger denna
egenskap ett enkelt sätt att hantera palettens organisation i dina
GIF-filer.
is_raw_data_availableboolrHämtar ett värde som indikerar om inläsning av rådata stöds.
loops_countintr/wHämta loopantalet enkelt med denna egenskap. Om din GIF-bild innehåller
loopinformation ger denna egenskap dig snabb åtkomst till loopantalet, vilket gör det möjligt att sömlöst hantera loopbeteendet i dina GIF-filer.
metadataImageMetadatarHämtar eller anger XMP-data från ramen.
page_countintrHämta det totala antalet sidor som finns i bilden med denna
enkla egenskap. Idealisk för att snabbt bedöma omfattningen av bildens innehåll.
pagesImage[]rFå åtkomst till sidorna i bilden via denna praktiska egenskap,
vilket möjliggör sömlös navigering och manipulation av enskilda sidor vid behov.
paletteIColorPaletter/wHämtar eller anger färgpaletten. Färgpaletten används inte när pixlar representeras direkt.
palette_color_resolution_bitsSystem.Byter/wHantera palettens färgupplösning i dina GIF-bilder med denna egenskap. Justera
antalet bitar som används för att representera färger i paletten, vilket ger fin kontroll
över färgdjup och bildkvalitet.
pixel_aspect_ratioSystem.Byter/wHantera pixelns bildförhållande i GIF-bilden med denna egenskap. Ställ in eller hämta
bildförhållandet för att säkerställa korrekt rendering och bevara visuell trohet.
premultiply_componentsboolr/wHämtar eller anger ett värde som indikerar om bildkomponenterna måste förmultipliceras.
raw_custom_color_converterIColorConverterr/wHämtar eller anger den anpassade färgkonvertern
raw_data_formatPixelDataFormatrHämtar det råa dataformatet.
raw_data_settingsRawDataSettingsrHämtar de aktuella inställningarna för rådata. Observera att när dessa inställningar används laddas data utan konvertering.
raw_fallback_indexintr/wHämtar eller anger reservindexet som ska användas när palettindexet är utanför gränserna
raw_indexed_color_converterIIndexedColorConverterr/wHämtar eller anger den indexerade färgkonvertern
raw_line_sizeintrHämtar den råa radstorleken i byte.
sizeSizerHämtar objektets storlek.
transparent_colorColorr/wHämta den transparenta färgen för den aktiva ramen i GIF-bilden. Denna egenskap
låter dig komma åt den specifika färg som har markerats som transparent
i den för närvarande aktiva ramen.
update_xmp_databoolr/wHämtar eller anger ett värde som indikerar om XMP-metadata ska uppdateras.
use_paletteboolrHämtar ett värde som indikerar om bildpaletten används.
use_raw_databoolr/wHämtar eller anger ett värde som indikerar om rådatainläsning ska användas när rådatainläsning är tillgänglig.
vertical_resolutionfloatr/wHämtar eller anger den vertikala upplösningen, i pixlar per tum, för denna RasterImage.
widthintrHämtar bildens bredd.
xmp_dataXmpPacketWrapperr/wHämtar eller anger Xmp-data.

Methods

NameDescription
add_block(block)Att lägga till ett nytt GIF-block gör att du kan inkludera ytterligare data i bilden.
Denna metod låter dig lägga till anpassade block i GIF-bilden, som kan
innehålla olika typer av information.
add_page(page)Inkludera en ny sida sömlöst i den befintliga bilden, vilket förbättrar dess innehåll
och utökar dess omfattning. Denna metod utökar bildsamlingar med ytterligare
innehåll, vilket främjar kreativitet och flexibilitet i bildhantering och sammansättning.
adjust_brightness(brightness)Justerar bildens ljusstyrka enligt den angivna
brightness-parametern. Denna metod modifierar hela bildens ljusstyrka enhetligt, vilket ökar eller minskar den totala luminansen för att uppnå
önskad effekt.
adjust_contrast(contrast)Justerar bildens kontrast, vilket ökar eller minskar skillnaden i
ljusstyrka mellan pixlar. Denna metod ändrar bildens övergripande tonomfång,
så att mörkare områden blir mörkare och ljusare områden blir ljusare för att förbättra visuell klarhet
och detaljrikedom.
adjust_gamma(gamma)Förbättra bildkvaliteten genom att tillämpa gammakorrigering. Denna metod justerar bildens färg
gamma för att uppnå optimal visuell klarhet. Den ändrar gamma‑värdet
för varje pixel, vilket resulterar i förbättrad färgåtergivning och övergripande bildutseende.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Gammakorrigering av en bild applicerar en icke‑linjär justering av pixelvärdena,
vilket ökar eller minskar ljusstyrkan baserat på de angivna koefficienterna för de röda,
gröna och blå kanalerna. Denna metod hjälper till att finjustera färgbalansen och
luminansen i bilden, vilket förbättrar dess övergripande utseende och visuella kvalitet.
analyze_percentage_digital_signature(password)Beräknar procentuell likhet mellan den extraherade datan och det ursprungliga lösenordet.
auto_brightness_contrast()Utför automatisk adaptiv ljusstyrke‑ och kontrastnormalisering för hela bilden.
auto_rotate()Rotera automatiskt bilden baserat på orienteringsdata som extraheras från Exif
metadata. Denna metod säkerställer att bilder visas i korrekt orientering,
förbättrar användarupplevelsen och eliminerar behovet av manuella justeringar. Genom
att analysera Exif‑information roteras bilden därefter, vilket ger en sömlös
visningsupplevelse på olika plattformar och enheter. Denna automatiserade rotationsprocess
förenklar bildhantering och förbättrar den övergripande användbarheten, särskilt när
man hanterar stora bildsatser med varierande orienteringar.
binarize_bradley(brightness_difference)Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med
integral bildtröskling är en metod för att konvertera en gråskalebild till en
binär bild. Denna algoritm beräknar en lokal tröskel för varje pixel baserat på
den genomsnittliga intensiteten hos omgivande pixlar inom ett angivet fönster. Genom
att adaptivt justera tröskeln baserat på lokala pixelintensiteter är Bradleys
metod effektiv för att hantera variationer i belysning och kontrast över bilden.
binarize_bradley(brightness_difference, window_size)Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med hjälp av integral‑bildtröskling
binarize_fixed(threshold)Binarisering av en bild med ett fördefinierat tröskelvärde konverterar en gråskala- eller färgbild
till en binär bild, där varje pixel klassificeras som antingen svart eller vit
baserat på om dess intensitetsvärde överstiger ett angivet tröskelvärde.
binarize_otsu()Binarisering av en bild med Otsu-tröskling är en metod som används för att automatiskt
bestämma det optimala tröskelvärdet för att konvertera en gråskalebild till en
binär bild. Otsu‑trösklingsalgoritmen beräknar den tröskel som
minimerar intraklassvariansen för pixelintensiteterna i de två resulterande
klasserna (förgrund och bakgrund). Denna teknik är särskilt användbar när
det optimala tröskelvärdet är okänt och måste bestämmas adaptivt baserat
på bildens histogram.
blend(origin, overlay, overlay_alpha)Blandar denna bildinstans med overlay-bilden.
blend(origin, overlay, overlay_area, overlay_alpha)Blandar denna bildinstans med overlay-bilden.
cache_data()Cachar data privat.
can_load(file_path)Bestämmer om bilden kan läsas in från den angivna filsökvägen.
can_load(file_path, load_options)Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.
can_load(stream)Bestämmer om bilden kan läsas in från den angivna strömmen.
can_load(stream, load_options)Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.
can_load_stream(stream)Bestämmer om bilden kan läsas in från den angivna strömmen.
can_load_stream_with_options(stream, load_options)Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.
can_load_with_options(file_path, load_options)Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.
can_save(options)Bestämmer om bilden kan sparas till det angivna filformatet som representeras av de medföljande sparalternativen.
clear_blocks()Att rensa alla GIF‑block tar bort all befintlig data som lagrats i bilden.
Denna operation återställer bilden effektivt till ett tomt tillstånd, vilket tar bort alla
tidigare tillagda block. Använd denna metod när du behöver börja om från början med en ren
start för att skapa eller modifiera en GIF‑bild.
create(files)Skapar flersidig bild som innehåller de angivna filerna.
create(files, throw_exception_on_load_error)Skapar flersidig bild som innehåller de angivna filerna.
create(image_options, width, height)Skapar en ny bild med de angivna skapandealternativen.
create(image_options, width, height, pixels)Skapar en RasterImage‑instans från den angivna pixelarrayen.

Validerar att den angivna bredden och höjden matchar dimensionerna på pixeldata.
Denna metod kan endast användas när biblioteket är i licensierat läge.
create(images)Skapar en ny bild med de angivna bilderna som sidor
create(images, dispose_images)Skapar en ny bild från de angivna bilderna som sidor.
create(multipage_create_options)Skapar de angivna flersidiga skapalternativen.
create_from_files(files)Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.
create_from_files(files, throw_exception_on_load_error)Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.
create_from_images(images)Skapar en ny bild med de angivna bilderna som sidor
create_from_images(images, dispose_images)Skapar en ny bild från de angivna bilderna som sidor.
crop(left_shift, right_shift, top_shift, bottom_shift)Beskär bild med förskjutningar.
crop(rectangle)Beskär bilden med ett angivet rektangelområde. Denna operation tar bort den yttre
delen av bilden och lämnar endast det valda området som definieras av rektangeln.
dither(dithering_method, bits_count)Utför dithering på den aktuella bilden.
dither(dithering_method, bits_count, custom_palette)Applicera dithering på den aktuella bilden. Denna process förbättrar bildkvaliteten genom att
minska färgbandning och förbättra färgövergångar, vilket resulterar i ett mjukare
utseende.
embed_digital_signature(password)Bädda in digital signatur baserad på angivet lösenord i varje sida av bilden.
filter(rectangle, options)Applicera ett specifikt filter på det angivna området i bilden, förbättra dess visuella
kvalitet eller ändra dess utseende enligt önskemål. Denna metod bearbetar selektivt
pixlar inom den definierade rektangeln, vilket möjliggör riktade justeringar samtidigt
som integriteten hos den omgivande bilddata bevaras.
get_argb_32_pixel(x, y)Hämtar en bildpixel i 32-bitars ARGB.
get_default_argb_32_pixels(rectangle)Hämtar standardarrayen för 32-bitars ARGB-pixlar.
get_default_options(args)Hämtar standardalternativen.
get_default_pixels(rectangle, partial_pixel_loader)Hämtar standardpixelarrayen med partiell pixel‑laddare.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Hämtar standardarrayen för rådata med partiell pixel‑laddare.
get_default_raw_data(rectangle, raw_data_settings)Hämtar standardarrayen för rådata.
get_file_format(file_path)Hämtar filformatet.
get_file_format(stream)Hämtar filformatet.
get_file_format_of_stream(stream)Hämtar filformatet.
get_fitting_rectangle(rectangle, pixels, width, height)Hämtar rektangeln som passar den aktuella bilden.
get_fitting_rectangle(rectangle, width, height)Hämtar rektangeln som passar den aktuella bilden.
get_modify_date(use_default)Hämtar datum och tid då resursbilden senast ändrades.
get_original_options()Hämta de ursprungliga filinställningsbaserade alternativen, avgörande för att upprätthålla trohet
och konsistens i bildbehandling och manipulation. Denna metod möjliggör sömlös
integration av filspecifika parametrar i efterföljande operationer, vilket säkerställer
exakt återgivning och efterlevnad av bildens inneboende egenskaper.
Detta kan vara hjälpsamt för att behålla bitdjup och andra parametrar i den ursprungliga bilden oförändrade.
Till exempel, om vi laddar en svartvit PNG-bild med 1 bit per pixel och sedan sparar den med hjälp av
DataStreamSupporter.save(file_path) metoden, kommer den resulterande PNG-bilden med 8-bit per pixel att produceras.
För att undvika detta och spara PNG-bilden med 1-bit per pixel, använd denna metod för att få motsvarande sparalternativ och skicka dem
till Image.save(file_path, options) metoden som den andra parametern.
get_pixel(x, y)Hämtar en bildpixel.
get_proportional_height(width, height, new_width)Hämtar en proportionell höjd.
get_proportional_width(width, height, new_height)Hämtar en proportionell bredd.
get_serialized_stream(image_options, clipping_rectangle, page_number)Konverterar till aps.
get_skew_angle()Hämtar snedvinkeln.
Denna metod är tillämplig på skannade textdokument för att bestämma snedvinkeln vid skanning.
grayscale()Omvandlingen av en bild till dess gråskalerepresentation konverterar färgbilden till en gråskala version genom att ta bort färginformation medan luminansen bevaras.
Denna process förenklar bilden till gråtoner, vilket gör den lämplig för olika tillämpningar såsom utskrift, dokumentbehandling och gråskalanalys.
insert_block(index, block)Att infoga ett nytt GIF-block gör att du kan lägga till anpassad data på en specifik position
inom bilden. Denna metod möjliggör att placera anpassade block på en önskad
plats i GIF-bilden, vilket ger flexibilitet i organisering och strukturering av
bilddata.
is_digital_signed(password, percentage_threshold)Utför en snabb kontroll för att avgöra om bilden är digitalt signerad, med det angivna lösenordet och tröskelvärdet.
load(file_path)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
load(file_path, load_options)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
load(stream)Läser in en ny bild från den angivna strömmen.
load(stream, load_options)Läser in en ny bild från den angivna strömmen.
load_argb_32_pixels(rectangle)Läser in 32-bitars ARGB‑pixlar.
load_argb_64_pixels(rectangle)Läser in 64-bitars ARGB‑pixlar.
load_cmyk_32_pixels(rectangle)Läser in pixlar i CMYK‑format.
load_cmyk_pixels(rectangle)Läser in pixlar i CMYK‑format.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.load_cmyk_32_pixels(rectangle) metoden.
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Läser in 32-bitars ARGB‑pixlar delvis (i block).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Läser in 64-bitars ARGB‑pixlar delvis i paket.
load_partial_pixels(desired_rectangle, pixel_loader)Läser in pixlar delvis i paket.
load_pixels(rectangle)Läser in pixlar.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Läser in rådata.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Läser in rådata.
load_stream(stream)Läser in en ny bild från den angivna strömmen.
load_stream_with_options(stream, load_options)Läser in en ny bild från den angivna strömmen.
load_with_options(file_path, load_options)Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.
normalize_angle()Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterImage.rotate(angle) metoder.
normalize_angle(resize_proportionally, background_color)Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) metoder.
normalize_histogram()Normaliserar bildens histogram — justera pixelvärden för att använda hela tillgängliga intervallet.
order_blocks()Att ordna GIF-blocken enligt GIF-specifikationen säkerställer korrekt GIF
layout och efterlevnad av standarden. Denna process innebär att arrangera
blocken i rätt sekvens enligt specifikationen. Dessutom kan det
innebära att ta bort vissa GifGraphicsControlBlock instanser som
inte är nödvändiga för den slutliga layouten. Genom att följa GIF-specifikationen kommer den
resulterande bilden att vara korrekt strukturerad och kompatibel med GIF‑visnings
applikationer.
read_argb_32_scan_line(scan_line_index)Läser hela skanningsraden enligt det angivna skanningsradindexet.
read_scan_line(scan_line_index)Läser hela skanningsraden enligt det angivna skanningsradindexet.
remove_block(block)Att ta bort ett GIF-block tar bort specifik data från bilden, vilket ger möjlighet att
rensa upp eller ändra bildstrukturen. Denna metod gör det möjligt att ta bort oönskade
eller onödiga block, vilket optimerar GIF-bilden för effektiv lagring. Använd denna
funktion för att eliminera föråldrad information från bilden samtidigt som dess
integritet och kvalitet bevaras.
remove_metadata()Tar bort metadata för denna bildinstans genom att sätta detta IHasXmpData.xmp_data värde till None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_color(old_color, old_color_diff, new_color)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_color(old_color_argb, old_color_diff, new_color_argb)Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
replace_non_transparent_colors(new_color)Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.
replace_non_transparent_colors(new_color_argb)Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.
resize(new_width, new_height)Ändrar bildens storlek. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize(new_width, new_height, resize_type)Ändrar storlek på detta Image‑instans.
resize(new_width, new_height, settings)Ändrar storlek på detta Image‑instans.
resize_by_settings(new_width, new_height, settings)Ändrar storlek på bilden.
resize_by_type(new_width, new_height, resize_type)Ändrar storlek på bilden.
resize_full_frame(new_width, new_height, resize_type)Ändring av bildens storlek samtidigt som fulla ramar för varje sida i en
GIF tas i beaktande, vilket förhindrar potentiella artefakter från att uppstå. Denna metod är avgörande
för att upprätthålla bildens integritet och kvalitet, särskilt när man arbetar med
animerade GIF‑bilder eller bildsekvenser.
resize_height_proportionally(new_height)Ändrar höjden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize_height_proportionally(new_height, resize_type)Ändrar bredden proportionellt.
resize_height_proportionally(new_height, settings)Ändrar höjden proportionellt.
resize_height_proportionally_settings(new_height, settings)Ändrar höjden proportionellt.
resize_proportional(new_width, new_height, resize_type)Proportionell storleksändring bevarar bildens bildförhållande samtidigt som dess
storlek justeras, vilket säkerställer att bilden inte blir utdragen eller förvrängd. Denna metod
ändrar bildens storlek proportionellt, skalar både bredd och höjd med samma faktor.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.
resize_width_proportionally(new_width)Ändrar bredden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.
resize_width_proportionally(new_width, resize_type)Ändrar bredden proportionellt.
resize_width_proportionally(new_width, settings)Ändrar bredden proportionellt.
resize_width_proportionally_settings(new_width, settings)Ändrar bredden proportionellt.
rotate(angle)Rotera bilden kring centrum.
rotate(angle, resize_proportionally, background_color)Denna metod roterar bilden kring dess mittpunkt. Genom att ange rotations
vinkeln kan du rotera bilden medurs eller moturs för att uppnå önskad
orientering. Denna rotation hjälper till att justera bildens presentation eller
inriktning utan att förvränga dess innehåll.
rotate_flip(rotate_flip_type)Utför rotation, spegling eller båda på den aktiva ramen exklusivt. Denna operation
tillämpar transformationer enbart på den för närvarande aktiva ramen i bilden,
samtidigt som integriteten hos övriga ramar i sekvensen bevaras.
rotate_flip_all(rotate_flip)Roterar alla flip.
save()Sparar bilddata till den underliggande strömmen.
save(file_path)Sparar bilden till den angivna filsökvägen.
save(file_path, options)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
save(file_path, options, bounds_rectangle)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
save(file_path, over_write)Sparar objektets data till den angivna filsökvägen.
save(stream)Sparar objektets data till den angivna strömmen.
save(stream, options_base)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save(stream, options_base, bounds_rectangle)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save_argb_32_pixels(rectangle, pixels)Sparar de 32‑bitars ARGB‑pixlarna.
save_cmyk_32_pixels(rectangle, pixels)Sparar pixlarna.
save_cmyk_pixels(rectangle, pixels)Sparar pixlarna.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.save_cmyk_32_pixels(rectangle, pixels) metoden.
save_pixels(rectangle, pixels)Sparar pixlarna internt.
save_raw_data(data, data_offset, rectangle, raw_data_settings)Sparar rådata.
save_to_stream(stream)Sparar objektets data till den angivna strömmen.
save_to_stream_with_options(stream, options_base)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.
save_with_options(file_path, options)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
save_with_options_rect(file_path, options, bounds_rectangle)Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.
set_argb_32_pixel(x, y, argb_32_color)Ställer in en bildpixel i 32-bit ARGB för den angivna positionen.
set_frame_time(time)Justera varaktigheten för varje ram i millisekunder, vilket säkerställer konsekvent timing
genom hela bildsekvensen. Denna metod sätter enhetligt visningstiden för
varje ram, vilket möjliggör exakt kontroll över animationshastigheten.
Att ändra detta värde återställer fördröjningen för alla ramar.
set_palette(palette, update_colors)Ställer in bildpaletten.
set_pixel(x, y, color)Ställer in en bildpixel för den angivna positionen.
set_resolution(dpi_x, dpi_y)Ställer in upplösningen för denna RasterImage.
try_set_metadata(metadata)Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)Skriver hela skanningsraden till det angivna skanningsradindexet.
write_scan_line(scan_line_index, pixels)Skriver hela skanningsraden till det angivna skanningsradindexet.

Constructor: GifImage(first_frame)

 GifImage(first_frame) 

Att skapa GIF‑bilder blir enkelt med GifImage
konstruktor. Med bara firstFrame‑parametern går du in i en värld av dynamisk
visuell kommunikation.

Parameters:

ParameterTypBeskrivning
first_frameGifFrameBlockDen första ramen för att initiera gif-bilden med.

See also:

Example # 1: This example shows how to create a GIF image and save it to a file.

Example # 2: The following example shows how to compose an animated GIF image from individ…

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette) 

Initiera ett nytt GifImage objekt med angivna parametrar för
första ramen och global palett. Börja hantera GIF‑bilder snabbt, och säkerställ
korrekt återgivning med anpassningsbara inställningar för optimala resultat.

Parameters:

ParameterTypBeskrivning
first_frameGifFrameBlockDen första ramen för att initiera gif-bilden med.
global_paletteIColorPaletteDen globala paletten att använda. Observera att om både firstFrame och globalPalette är null så används standard‑globalpalett.

See also:

Example # 1: This example shows how to create a GIF image with a custom palette and save i…

Constructor: GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

 GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer) 

Kom igång enkelt med GifImage‑konstruktorn. Med denna
enkla metoden kan du dyka in i att skapa animerade GIF‑filer med lätthet. Ange bara
firstFrame, globalPalette, paletteColorResolution, aspectRatio och andra
parametrar, så är du redo att ge liv åt dina visuella element.

Parameters:

ParameterTypBeskrivning
first_frameGifFrameBlockDen första ramen för att initiera gif-bilden med.
global_paletteIColorPaletteDen globala paletten att använda. Observera att om både firstFrame och globalPalette är null så används standard‑globalpalett.
is_palette_sortedboolom den är satt till true sorteras paletten. Observera att parametern används när globalPalette inte är null.
palette_color_resolutionSystem.BytePalettens färglösning. Observera att parametern används när globalPalette inte är null.
palette_background_color_indexSystem.BytePalettens bakgrundsfärgsindex.
aspect_ratioSystem.ByteBildförhållandet.
has_trailerboolom den är satt till true har gif-bilden en trailer, annars skrivs ingen trailer i slutet av strömmen.

Property: active_frame

Hantera och manipulera ramar med denna egenskap, vilket möjliggör smidig navigering och
modifiering av den aktiva ramen i GIF‑bilden.

See also:

Example # 1: The following example shows how to remove all blocks from a GIF image.

Method: add_block(block)

 add_block(block) 

Att lägga till ett nytt GIF-block gör att du kan inkludera ytterligare data i bilden.
Denna metod låter dig lägga till anpassade block i GIF-bilden, som kan
innehålla olika typer av information.

Parameters:

ParameterTypBeskrivning
blockIGifBlockGIF‑blocket att lägga till.

See also:

Example # 1: The following example shows how to compose an animated GIF image from individ…

Method: add_page(page)

 add_page(page) 

Inkludera en ny sida sömlöst i den befintliga bilden, vilket förbättrar dess innehåll
och utökar dess omfattning. Denna metod utökar bildsamlingar med ytterligare
innehåll, vilket främjar kreativitet och flexibilitet i bildhantering och sammansättning.

Parameters:

ParameterTypBeskrivning
pageRasterImageSidan att lägga till.

See also:

Example # 1: Create multipage GIF image using single page raster images.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Justerar bildens ljusstyrka enligt den angivna
brightness-parametern. Denna metod modifierar hela bildens ljusstyrka enhetligt, vilket ökar eller minskar den totala luminansen för att uppnå
önskad effekt.

Parameters:

ParameterTypBeskrivning
ljusstyrkaintLjusstyrkevärde.

See also:

Example # 1: The following example performs brightness correction of a GIF image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Justerar bildens kontrast, vilket ökar eller minskar skillnaden i
ljusstyrka mellan pixlar. Denna metod ändrar bildens övergripande tonomfång,
så att mörkare områden blir mörkare och ljusare områden blir ljusare för att förbättra visuell klarhet
och detaljrikedom.

Parameters:

ParameterTypBeskrivning
kontrastfloatKontrastvärde (i intervallet [-100; 100])

See also:

Example # 1: The following example performs contrast correction of a GIF image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Förbättra bildkvaliteten genom att tillämpa gammakorrigering. Denna metod justerar bildens färg
gamma för att uppnå optimal visuell klarhet. Den ändrar gamma‑värdet
för varje pixel, vilket resulterar i förbättrad färgåtergivning och övergripande bildutseende.

Parameters:

ParameterTypBeskrivning
gammafloatGamma för röd, grön och blå kanalers koefficient

See also:

Example # 1: The following example performs gamma-correction of a GIF image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Gammakorrigering av en bild applicerar en icke‑linjär justering av pixelvärdena,
vilket ökar eller minskar ljusstyrkan baserat på de angivna koefficienterna för de röda,
gröna och blå kanalerna. Denna metod hjälper till att finjustera färgbalansen och
luminansen i bilden, vilket förbättrar dess övergripande utseende och visuella kvalitet.

Parameters:

ParameterTypBeskrivning
gamma_redfloatGamma för röd kanal koefficient
gamma_greenfloatGamma för grön kanal koefficient
gamma_bluefloatGamma för blå kanalkoefficient

See also:

Example # 1: The following example performs gamma-correction of a GIF image applying diffe…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

Beräknar procentuell likhet mellan den extraherade datan och det ursprungliga lösenordet.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet som används för att extrahera den inbäddade datan.

Returns

TypBeskrivning
intProcentuell likhetsvärde.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med
integral bildtröskling är en metod för att konvertera en gråskalebild till en
binär bild. Denna algoritm beräknar en lokal tröskel för varje pixel baserat på
den genomsnittliga intensiteten hos omgivande pixlar inom ett angivet fönster. Genom
att adaptivt justera tröskeln baserat på lokala pixelintensiteter är Bradleys
metod effektiv för att hantera variationer i belysning och kontrast över bilden.

Parameters:

ParameterTypBeskrivning
brightness_differencefloatLjusstyrkeskillnaden mellan en pixel och medelvärdet av ett s × s‑fönster av pixlar centrerade kring denna pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarisering av en bild med Bradleys adaptiva tröskelalgoritm med hjälp av integral‑bildtröskling

Parameters:

ParameterTypBeskrivning
brightness_differencefloatLjusstyrkeskillnaden mellan pixeln och medelvärdet av ett s x s fönster av pixlar
centrerat kring denna pixel.
window_sizeintStorleken på ett s x s fönster av pixlar centrerat kring denna pixel

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Binarisering av en bild med ett fördefinierat tröskelvärde konverterar en gråskala- eller färgbild
till en binär bild, där varje pixel klassificeras som antingen svart eller vit
baserat på om dess intensitetsvärde överstiger ett angivet tröskelvärde.

Parameters:

ParameterTypBeskrivning
tröskelvärdeSystem.ByteTröskelvärde. Om motsvarande gråvärde för en pixel är större än tröskeln, tilldelas värdet 255, annars 0.

See also:

Example # 1: The following example binarizes a GIF image with the predefined threshold. Bi…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Blandar denna bildinstans med overlay-bilden.

Parameters:

ParameterTypBeskrivning
originPointBakgrundsbildens blandningsursprung.
overlayRasterImageÖverlagringsbilden.
overlay_alphaSystem.ByteAlfa för överlagring.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

Blandar denna bildinstans med overlay-bilden.

Parameters:

ParameterTypBeskrivning
originPointBakgrundsbildens blandningsursprung.
overlayRasterImageÖverlagringsbilden.
overlay_areaRectangleÖverlagringsområdet.
overlay_alphaSystem.ByteAlfa för överlagring.

Method: can_load(file_path) [static]

 can_load(file_path) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_load(stream) [static]

 can_load(stream) 

Bestämmer om bilden kan läsas in från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Bestämmer om bilden kan läsas in från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

Bestämmer om bilden kan läsas in från den angivna strömmen och eventuellt med de angivna loadOptions.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att läsa från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna strömmen; annars false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

Bestämmer om bilden kan läsas in från den angivna filsökvägen och eventuellt med de angivna öppningsalternativen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
booltrue om bilden kan laddas från den angivna filen; annars false.

Method: can_save(options)

 can_save(options) 

Bestämmer om bilden kan sparas till det angivna filformatet som representeras av de medföljande sparalternativen.

Parameters:

ParameterTypBeskrivning
optionsImageOptionsBaseSparaalternativen att använda.

Returns

TypBeskrivning
booltrue om bilden kan sparas till det angivna filformatet som representeras av de överförda sparaalternativen; annars false.

Method: create(files) [static]

 create(files) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Skapar flersidig bild som innehåller de angivna filerna.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.
throw_exception_on_load_errorboolom den är inställd på true [throw exception on load error].

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create(image_options, width, height) [static]

 create(image_options, width, height) 

Skapar en ny bild med de angivna skapandealternativen.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
widthintBredden.
heightintHöjden.

Returns

TypBeskrivning
ImageDen nyss skapade bilden.

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels) 

Skapar en RasterImage‑instans från den angivna pixelarrayen.

Validerar att den angivna bredden och höjden matchar dimensionerna på pixeldata.
Denna metod kan endast användas när biblioteket är i licensierat läge.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseAlternativen som används för att skapa RasterImage.
widthintBredden på RasterImage.
heightintHöjden på RasterImage.
pixlarint[]Arrayen med pixelvärden som används för att fylla bilden.

Returns

TypBeskrivning
ImageEn RasterImage som är fylld med den angivna pixeldata.

Method: create(images) [static]

 create(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Skapar en ny bild från de angivna bilderna som sidor.

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.
dispose_imagesboolom den är inställd på true [dispose images].

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Skapar de angivna flersidiga skapalternativen.

Parameters:

ParameterTypBeskrivning
multipage_create_optionsMultipageCreateOptionsAlternativen för att skapa flersidiga bilder.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files) [static]

 create_from_files(files) 

Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

Skapar den flersidiga bilden som innehåller de angivna filerna som sidor med fördröjd inläsning.

Parameters:

ParameterTypBeskrivning
filesstring[]Filerna.
throw_exception_on_load_errorboolom den är inställd på true kasta undantag vid inläsningsfel.

Returns

TypBeskrivning
ImageDen flersidiga bilden

Method: create_from_images(images) [static]

 create_from_images(images) 

Skapar en ny bild med de angivna bilderna som sidor

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

Skapar en ny bild från de angivna bilderna som sidor.

Parameters:

ParameterTypBeskrivning
imagesImage[]Bilderna.
dispose_imagesboolom den är inställd på true [dispose images].

Returns

TypBeskrivning
ImageBilden som IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Beskär bild med förskjutningar.

Parameters:

ParameterTypBeskrivning
left_shiftintVänsterskiftet.
right_shiftintHögerskiftet.
top_shiftintÖversta skiftet.
bottom_shiftintNedersta skiftet.

Method: crop(rectangle)

 crop(rectangle) 

Beskär bilden med ett angivet rektangelområde. Denna operation tar bort den yttre
delen av bilden och lämnar endast det valda området som definieras av rektangeln.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.

See also:

Example # 1: The following example crops a GIF image. The cropping area is be specified vi…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Utför dithering på den aktuella bilden.

Parameters:

ParameterTypBeskrivning
dithering_methodDitheringMethodDithermetoden.
bits_countintDet slutgiltiga bitantalet för dithering.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Applicera dithering på den aktuella bilden. Denna process förbättrar bildkvaliteten genom att
minska färgbandning och förbättra färgövergångar, vilket resulterar i ett mjukare
utseende.

Parameters:

ParameterTypBeskrivning
dithering_methodDitheringMethodDithermetoden.
bits_countintDet slutgiltiga bitantalet för dithering.
custom_paletteIColorPaletteDen anpassade paletten för dithering.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Bädda in digital signatur baserad på angivet lösenord i varje sida av bilden.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet som används för att generera digitala signaturdata.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Applicera ett specifikt filter på det angivna området i bilden, förbättra dess visuella
kvalitet eller ändra dess utseende enligt önskemål. Denna metod bearbetar selektivt
pixlar inom den definierade rektangeln, vilket möjliggör riktade justeringar samtidigt
som integriteten hos den omgivande bilddata bevaras.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.
optionsFilterOptionsBaseAlternativen.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Hämtar en bildpixel i 32-bitars ARGB.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.

Returns

TypBeskrivning
intDen 32‑bitars ARGB-pixeln för den angivna platsen.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Hämtar standardarrayen för 32-bitars ARGB-pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.

Returns

TypBeskrivning
int[]Standardpixelarrayen.

Method: get_default_options(args)

 get_default_options(args) 

Hämtar standardalternativen.

Parameters:

ParameterTypBeskrivning
argsSystem.ObjectArgumenten.

Returns

TypBeskrivning
ImageOptionsBaseStandardalternativ

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Hämtar standardpixelarrayen med partiell pixel‑laddare.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.
partial_pixel_loaderIPartialArgb32PixelLoaderDen partiella pixel‑laddaren.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

Hämtar standardarrayen för rådata med partiell pixel‑laddare.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta pixlar.
partial_raw_data_loaderIPartialRawDataLoaderDen partiella rådata‑laddaren.
raw_data_settingsRawDataSettingsInställningarna för rådata.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Hämtar standardarrayen för rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta rådata.
raw_data_settingsRawDataSettingsInställningarna för rådata.

Returns

TypBeskrivning
System.ByteStandardrådataarrayen.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Hämtar filformatet.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen.

Returns

TypBeskrivning
FileFormatDet bestämda filformatet.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta en passande rektangel.
pixlarint[]De 32-bitars ARGB-pixlarna.
widthintObjektets bredd.
heightintObjektets höjd.

Returns

TypBeskrivning
RectangleDen passande rektangeln eller ett undantag om ingen passande rektangel kan hittas.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

Hämtar rektangeln som passar den aktuella bilden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln för att hämta en passande rektangel.
widthintObjektets bredd.
heightintObjektets höjd.

Returns

TypBeskrivning
RectangleDen passande rektangeln eller ett undantag om ingen passande rektangel kan hittas.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

Hämtar datum och tid då resursbilden senast ändrades.

Parameters:

ParameterTypBeskrivning
use_defaultboolOm den är satt till true används informationen från FileInfo som standardvärde.

Returns

TypBeskrivning
System.DateTimeDatumet och tiden då resursbilden senast ändrades.

Method: get_original_options()

 get_original_options() 

Hämta de ursprungliga filinställningsbaserade alternativen, avgörande för att upprätthålla trohet
och konsistens i bildbehandling och manipulation. Denna metod möjliggör sömlös
integration av filspecifika parametrar i efterföljande operationer, vilket säkerställer
exakt återgivning och efterlevnad av bildens inneboende egenskaper.
Detta kan vara hjälpsamt för att behålla bitdjup och andra parametrar i den ursprungliga bilden oförändrade.
Till exempel, om vi laddar en svartvit PNG-bild med 1 bit per pixel och sedan sparar den med hjälp av
DataStreamSupporter.save(file_path) metoden, kommer den resulterande PNG-bilden med 8-bit per pixel att produceras.
För att undvika detta och spara PNG-bilden med 1-bit per pixel, använd denna metod för att få motsvarande sparalternativ och skicka dem
till Image.save(file_path, options) metoden som den andra parametern.

Returns

TypBeskrivning
ImageOptionsBaseAlternativen baserade på de ursprungliga filinställningarna.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Hämtar en bildpixel.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.

Returns

TypBeskrivning
ColorPixelns färg för den angivna platsen.

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

Hämtar en proportionell höjd.

Parameters:

ParameterTypBeskrivning
widthintBredden.
heightintHöjden.
new_widthintDen nya bredden.

Returns

TypBeskrivning
intDen proportionella höjden.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

Hämtar en proportionell bredd.

Parameters:

ParameterTypBeskrivning
widthintBredden.
heightintHöjden.
new_heightintDen nya höjden.

Returns

TypBeskrivning
intDen proportionella bredden.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Konverterar till aps.

Parameters:

ParameterTypBeskrivning
image_optionsImageOptionsBaseBildalternativen.
clipping_rectangleRectangleKlippningsrektangeln.
page_numberint[]Sidnumret.

Returns

TypBeskrivning
_io.BufferedRandomDen serialiserade strömmen

Method: get_skew_angle()

 get_skew_angle() 

Hämtar snedvinkeln.
Denna metod är tillämplig på skannade textdokument för att bestämma snedvinkeln vid skanning.

Returns

TypBeskrivning
floatSnedvinkeln, i grader.

Method: insert_block(index, block)

 insert_block(index, block) 

Att infoga ett nytt GIF-block gör att du kan lägga till anpassad data på en specifik position
inom bilden. Denna metod möjliggör att placera anpassade block på en önskad
plats i GIF-bilden, vilket ger flexibilitet i organisering och strukturering av
bilddata.

Parameters:

ParameterTypBeskrivning
indexintDet nollbaserade elementet där blocket kommer att infogas.
blockIGifBlockGIF‑blocket att lägga till.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

Utför en snabb kontroll för att avgöra om bilden är digitalt signerad, med det angivna lösenordet och tröskelvärdet.

Parameters:

ParameterTypBeskrivning
passwordstringLösenordet för att kontrollera signeringen.
percentage_thresholdintTröskelvärdet (i procent)[0-100] som avgör om bilden anses vara signerad.
Om det inte anges, kommer ett standardtröskelvärde (75) att tillämpas.

Returns

TypBeskrivning
boolSant om bilden är signerad, annars falskt.

Method: load(file_path) [static]

 load(file_path) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(stream) [static]

 load(stream) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Läser in 32-bitars ARGB‑pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den inlästa 32-bitars ARGB-pixelarrayen.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Läser in 64-bitars ARGB‑pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den laddade 64-bit ARGB-pixelarrayen.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Läser in pixlar i CMYK‑format.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
int[]Den laddade CMYK-pixlarna presenteras som 32-bitars heltalsvärden.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Läser in pixlar i CMYK‑format.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.load_cmyk_32_pixels(rectangle) metoden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
CmykColor[]Den laddade CMYK-pixelarrayen.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Läser in 32-bitars ARGB‑pixlar delvis (i block).

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.
partial_pixel_loaderIPartialArgb32PixelLoaderDen partiella pixel‑laddaren.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Läser in 64-bitars ARGB‑pixlar delvis i paket.

Parameters:

ParameterTypBeskrivning
rectangleRectangleDen önskade rektangeln.
partial_pixel_loaderIPartialArgb64PixelLoaderDen 64-bit ARGB-pixelinläsaren.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Läser in pixlar delvis i paket.

Parameters:

ParameterTypBeskrivning
desired_rectangleRectangleDen önskade rektangeln.
pixel_loaderIPartialPixelLoaderPixelinläsaren.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Läser in pixlar.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda pixlar från.

Returns

TypBeskrivning
Color[]Den laddade pixelarrayen.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

Läser in rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda rådata från.
dest_image_boundsRectangleMålbildens gränser.
raw_data_settingsRawDataSettingsInställningarna för rådata att använda för laddade data. Observera att om data inte är i det angivna formatet kommer datakonvertering att utföras.
raw_data_loaderIPartialRawDataLoaderRådatainläsaren.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Läser in rådata.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att ladda rådata från.
raw_data_settingsRawDataSettingsInställningarna för rådata att använda för laddade data. Observera att om data inte är i det angivna formatet kommer datakonvertering att utföras.
raw_data_loaderIPartialRawDataLoaderRådatainläsaren.

Method: load_stream(stream) [static]

 load_stream(stream) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Läser in en ny bild från den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Läser in en ny bild från den angivna filsökvägen eller URL:en.
Om filePath är en filsökväg öppnar metoden bara filen.
Om filePath är en URL laddar metoden ner filen, sparar den som en temporär och öppnar den.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen eller URL:en att ladda bilden från.
load_optionsLoadOptionsLaddningsalternativen.

Returns

TypBeskrivning
ImageDen inlästa bilden.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Normaliserar vinkeln.
Denna metod är tillämplig på skannade textdokument för att bli av med snedvriden skanning.
Metoden använder RasterImage.get_skew_angle() och RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) metoder.

Parameters:

ParameterTypBeskrivning
resize_proportionallyboolOm den är inställd på true kommer bildens storlek att ändras enligt den roterade rektangelns (hörnpunkternas) projektioner, annars lämnas dimensionerna oförändrade och endast bildens innehåll roteras.
background_colorColorBakgrundens färg.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Läser hela skanningsraden enligt det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.

Returns

TypBeskrivning
int[]Skanningslinjens 32-bit ARGB-färgvärdearray.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Läser hela skanningsraden enligt det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.

Returns

TypBeskrivning
Color[]Skanningslinjens pixel-färgvärdearray.

Method: remove_block(block)

 remove_block(block) 

Att ta bort ett GIF-block tar bort specifik data från bilden, vilket ger möjlighet att
rensa upp eller ändra bildstrukturen. Denna metod gör det möjligt att ta bort oönskade
eller onödiga block, vilket optimerar GIF-bilden för effektiv lagring. Använd denna
funktion för att eliminera föråldrad information från bilden samtidigt som dess
integritet och kvalitet bevaras.

Parameters:

ParameterTypBeskrivning
blockIGifBlockBlocket att ta bort.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_color_argbintGammalt färg-ARGB-värde att ersätta.
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argbintNytt färg-ARGB-värde att ersätta gammal färg med.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_colorColor
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_colorColor

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

Ersätter en färg med en annan med tillåten skillnad och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.

Parameters:

ParameterTypBeskrivning
old_color_argbintGammalt färg-ARGB-värde att ersätta.
old_color_diffSystem.ByteTillåten skillnad i gammal färg för att kunna bredda den ersatta färgtonen.
new_color_argbintNytt färg-ARGB-värde att ersätta gammal färg med.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.

Parameters:

ParameterTypBeskrivning
new_colorColor

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Ersätter alla icke‑transparenta färger med en ny färg och bevarar det ursprungliga alfa‑värdet för att spara mjuka kanter.
Obs: om du använder den på bilder utan transparens, kommer alla färger att ersättas med en enda.

Parameters:

ParameterTypBeskrivning
new_color_argbintNytt färg-ARGB-värde att ersätta icke-transparenta färger med.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Ändrar bildens storlek. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Ändrar storlek på detta Image‑instans.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Ändrar storlek på detta Image‑instans.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
settingsImageResizeSettingsInställningarna.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Ändrar storlek på bilden.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
settingsImageResizeSettingsResize-inställningarna.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Ändrar storlek på bilden.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type) 

Ändring av bildens storlek samtidigt som fulla ramar för varje sida i en
GIF tas i beaktande, vilket förhindrar potentiella artefakter från att uppstå. Denna metod är avgörande
för att upprätthålla bildens integritet och kvalitet, särskilt när man arbetar med
animerade GIF‑bilder eller bildsekvenser.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

Ändrar höjden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
resize_typeResizeTypeTyp av storleksändring.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Ändrar höjden proportionellt.

Parameters:

ParameterTypBeskrivning
new_heightintDen nya höjden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Proportionell storleksändring bevarar bildens bildförhållande samtidigt som dess
storlek justeras, vilket säkerställer att bilden inte blir utdragen eller förvrängd. Denna metod
ändrar bildens storlek proportionellt, skalar både bredd och höjd med samma faktor.
Den proportionella storleksändringen kommer att ändra varje ram enligt förhållandet newWidth/width och newHeight/height.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
new_heightintDen nya höjden.
resize_typeResizeTypeResize-typen.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

Ändrar bredden proportionellt. Standardvärdet ResizeType.NEAREST_NEIGHBOUR_RESAMPLE används.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
resize_typeResizeTypeTyp av storleksändring.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Ändrar bredden proportionellt.

Parameters:

ParameterTypBeskrivning
new_widthintDen nya bredden.
settingsImageResizeSettingsInställningarna för bildstorleksändring.

Method: rotate(angle)

 rotate(angle) 

Rotera bilden kring centrum.

Parameters:

ParameterTypBeskrivning
vinkelfloatRotationsvinkeln i grader. Positiva värden roterar medurs.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Denna metod roterar bilden kring dess mittpunkt. Genom att ange rotations
vinkeln kan du rotera bilden medurs eller moturs för att uppnå önskad
orientering. Denna rotation hjälper till att justera bildens presentation eller
inriktning utan att förvränga dess innehåll.

Parameters:

ParameterTypBeskrivning
vinkelfloatRotationsvinkeln i grader. Positiva värden roterar medurs.
resize_proportionallyboolom den är satt till true kommer bildens storlek att ändras
enligt den roterade rektangelns (hörnpunkternas) projektioner i annat
fall lämnas dimensionerna orörda och endast
internal bildinnehåll roteras.
background_colorColorBakgrundens färg.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Utför rotation, spegling eller båda på den aktiva ramen exklusivt. Denna operation
tillämpar transformationer enbart på den för närvarande aktiva ramen i bilden,
samtidigt som integriteten hos övriga ramar i sekvensen bevaras.

Parameters:

ParameterTypBeskrivning
rotate_flip_typeRotateFlipTypeRotationsvändningstypen.

See also:

Example # 1: This example loads a GIF image, rotates it by 90 degrees clockwise and option…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Roterar alla flip.

Parameters:

ParameterTypBeskrivning
rotate_flipRotateFlipTypeRotationsvändning.

Method: save(file_path)

 save(file_path) 

Sparar bilden till den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen för att spara bilden till.

Method: save(file_path, options)

 save(file_path, options) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.
bounds_rectangleRectangleMålbildernas avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsning.

Method: save(file_path, over_write)

 save(file_path, over_write) 

Sparar objektets data till den angivna filsökvägen.

Parameters:

ParameterTypBeskrivning
file_pathstringFilvägen för att spara objektets data till.
over_writeboolom den är satt till true skriv över filinnehållet, annars kommer data att läggas till.

Method: save(stream)

 save(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara objektets data till.

Method: save(stream, options_base)

 save(stream, options_base) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.
bounds_rectangleRectangleMålbildens avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsningar.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Sparar de 32‑bitars ARGB‑pixlarna.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixlarint[]32-bitars ARGB-pixelarrayen.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Sparar pixlarna.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixlarint[]CMYK-pixlar presenterade som 32-bitars heltalsvärden.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Sparar pixlarna.
Denna metod är föråldrad. Använd den mer effektiva RasterImage.save_cmyk_32_pixels(rectangle, pixels) metoden.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln att spara pixlar till.
pixelsCmykColor[]CMYK-pixelarrayen.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Sparar pixlarna internt.

Parameters:

ParameterTypBeskrivning
rectangleRectangleRektangeln.
pixelsColor[]Pixlarna.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

Sparar rådata.

Parameters:

ParameterTypBeskrivning
dataSystem.ByteRådata.
data_offsetintStartoffset för rådata.
rectangleRectangleRådatarektangeln.
raw_data_settingsRawDataSettingsRådatainställningarna som datan är i.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Sparar objektets data till den angivna strömmen.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara objektets data till.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

Sparar bildens data till den angivna strömmen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
ström_io.BufferedRandomStrömmen att spara bildens data till.
options_baseImageOptionsBaseSparalternativen.
bounds_rectangleRectangleMålbildens avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsningar.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

Sparar objektets data till den angivna filsökvägen i det specificerade filformatet enligt sparalternativ.

Parameters:

ParameterTypBeskrivning
file_pathstringFilsökvägen.
optionsImageOptionsBaseAlternativen.
bounds_rectangleRectangleMålbildernas avgränsningsrektangel. Ställ in den tomma rektangeln för att använda källans avgränsning.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Ställer in en bildpixel i 32-bit ARGB för den angivna positionen.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.
argb_32_colorintDen 32-bitars ARGB-pixeln för den angivna positionen.

Method: set_frame_time(time)

 set_frame_time(time) 

Justera varaktigheten för varje ram i millisekunder, vilket säkerställer konsekvent timing
genom hela bildsekvensen. Denna metod sätter enhetligt visningstiden för
varje ram, vilket möjliggör exakt kontroll över animationshastigheten.
Att ändra detta värde återställer fördröjningen för alla ramar.

Parameters:

ParameterTypBeskrivning
tidintTiden för bildrutes varaktighet i millisekunder.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Ställer in bildpaletten.

Parameters:

ParameterTypBeskrivning
paletteIColorPalettePaletten att ställa in.
update_colorsboolOm den är inställd på true kommer färgerna att uppdateras enligt den nya paletten; annars förblir färgindex oförändrade. Observera att oförändrade index kan krascha bilden vid inläsning om vissa index saknar motsvarande palettposter.

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Ställer in en bildpixel för den angivna positionen.

Parameters:

ParameterTypBeskrivning
xintPixelns x‑position.
yintPixelns y‑position.
colorColorPixelns färg för den angivna positionen.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Ställer in upplösningen för denna RasterImage.

Parameters:

ParameterTypBeskrivning
dpi_xfloatDen horisontella upplösningen, i punkter per tum, för RasterImage.
dpi_yfloatDen vertikala upplösningen, i punkter per tum, för RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Parameters:

ParameterTypBeskrivning
metadataIImageMetadataFormatMetadata.

Returns

TypBeskrivning
boolSant om metadata inte är null och IMetadataContainer‑instansen
stöder och/eller implementerar IImageMetadataFormat‑instansen; annars falskt.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Skriver hela skanningsraden till det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.
argb_32_pixelsint[]Den 32-bitars ARGB-färgarrayen att skriva.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Skriver hela skanningsraden till det angivna skanningsradindexet.

Parameters:

ParameterTypBeskrivning
scan_line_indexintNollbaserat index för skanningslinjen.
pixelsColor[]Pixel‑färgarrayen att skriva.

Examples

This example shows how to create a GIF image and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color


# Skapa ett GIF-ramblock på 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Fyll hela blocket med rött.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	with GifImage(firstBlock) as gifImage:
		gifImage.save("output.gif")

This example shows how to create a GIF image with a custom palette and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color, ColorPaletteHelper


# Skapa ett GIF-ramblock på 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Fyll hela blocket med rött.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Använd en 4-bitars palett för att minska bildstorleken. Kvaliteten kan bli sämre.
	palette = ColorPaletteHelper.create_4_bit()

	with GifImage(firstBlock, palette) as gifImage:
		gifImage.save("output.gif")

The following example shows how to compose an animated GIF image from individual GIF blocks.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color

# Skapa en GIF-bild 100 x 100 px.
# Det första blocket är helt svart som standard.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# Den första cirkeln är röd
		brush1 = SolidBrush(Color.red)

		# Den andra cirkeln är svart
		brush2 = SolidBrush(Color.black)

		# Öka gradvis vinkeln på den röda bågformen.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Öka gradvis vinkeln på den svarta bågen och radera den röda bågen.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

The following example shows how to remove all blocks from a GIF image.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 

# Skapa en GIF-bild 100 x 100 px.
# Det första blocket är helt svart som standard.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

		print("Clear all the blocks")
		gifImage.clear_blocks()

		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

# Utdata ser ut så här:
# Aktiv ramstorlek: { Width = 100, Height = 100}
# Rensa alla block
# Aktiv ram är inte inställd

This example loads a GIF image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Rotera, vänd och spara till utdatafilen.
	with aspycore.as_of(Image.load(join(dir_, "sample.gif")), GifImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example crops a GIF image. The cropping area is be specified via aspose.imaging.Rectangle.

import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.gif import GifImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Beskär bilden. Beskärningsområdet är bildens rektangulära centrala område.
	area = Rectangle(gif_image.width // 4, gif_image.height // 4, gif_image.width // 2,
					 gif_image.height // 2)
	gif_image.crop(area)
	# Spara den beskurna bilden som PNG
	gif_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example binarizes a GIF image with the predefined threshold. Binarized images contain only 2 colors - black and white.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	djvu_image = aspycore.as_of(image, GifImage)
	# Binärisera bilden med ett tröskelvärde på 127.
	# Om ett motsvarande gråvärde för en pixel är större än 127, tilldelas värdet 255, annars 0.
	djvu_image.binarize_fixed(127)
	djvu_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example performs gamma-correction of a GIF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp\\"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Ställ in gamma‑koefficient för röd, grön och blå kanal.
	gif_image.adjust_gamma(2.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs gamma-correction of a GIF image applying different coefficients for color components.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Ställ in individuella gamma‑koefficienter för röd, grön och blå kanal.
	gif_image.adjust_gamma(1.5, 2.5, 3.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a GIF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Ställ in ljushetsvärdet. Godkända värden för ljushet ligger i intervallet [-255, 255].
	gif_image.adjust_brightness(50)
	gif_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a GIF image.



import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

with Image.load(join(dir_, "sample.gif")) as image:

	gif_image = aspycore.as_of(image, GifImage)

	# Ställ in kontrastvärdet. Godkända värden för kontrast ligger i intervallet [-100f, 100f].

	gif_image.adjust_contrast(50.0)

	gif_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())



# ExEnd

Create multipage GIF image using single page raster images.

from aspose.imaging import Image, RasterImage
from aspose.pycore import as_of
from os import listdir
from os.path import isfile, join

def load_frames(directory):
	for f in listdir(directory):
		full_path = join(directory, f)
		if isfile(full_path):
			yield as_of(Image.load(file_path), RasterImage)


# Läs in ramar
frames = list(load_frames("Animation frames"))
# Skapa GIF-bild med den första ramen
with GifImage(GifFrameBlock(frames[0])) as image:
	# Lägg till ramar i GIF-bilden med metoden AddPage
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# Spara GIF-bild
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# Frigör bilderna
		pass

Export of part of animation from GIF image based on time interval.

from aspose.imaging import Image
from aspose.imaging.imageoptions import GifOptions, MultiPageOptions, MultiPageMode, TimeInterval

with Image.load("Animation.gif") as image:
	obj_init = MultiPageOptions()
	obj_init.mode = MultiPageMode.TIME_INTERVAL
	obj_init.time_interval = TimeInterval(0, 400)
	options = GifOptions()
	options.full_frame = True
	options.multi_page_options = obj_init
	image.save("PartOfAnimation.gif", options)