Class SvgImage
Nome do espaço: Aspose.Imaging.FileFormats.Svg Assembleia: Aspose.Imaging.dll (25.4.0)
Manipular arquivos de imagem Scalar Vector Graphics (SVG) com a nossa API, utilizandoO poder do formato de texto baseado em XML para personalização e escalabilidade sem fio.Carregar facilmente imagens SVG, rasterizar elementos vectores e converter para outros formatos,enquanto controla os níveis de compressão para otimizar o tamanho e a qualidade do arquivo para seus projetos.
[JsonObject(MemberSerialization.OptIn)]
public sealed class SvgImage : VectorImage, IDisposable, IObjectWithBounds, IObjectWithSizeF, IHasXmpData, IHasMetadata
Inheritance
object ← DisposableObject ← DataStreamSupporter ← Image ← VectorImage ← SvgImage
Implements
IDisposable , IObjectWithBounds , IObjectWithSizeF , IHasXmpData , IHasMetadata
Membros herdados
VectorImage.GetEmbeddedImages() , VectorImage.RemoveBackground() , VectorImage.RemoveBackground(RemoveBackgroundSettings) , VectorImage.Resize(int, int, ResizeType) , VectorImage.Resize(int, int, ImageResizeSettings) , VectorImage.RotateFlip(RotateFlipType) , VectorImage.Crop(Rectangle) , VectorImage.Rotate(float) , VectorImage.SizeF , VectorImage.WidthF , VectorImage.HeightF , VectorImage.Width , VectorImage.Height , Image.CanLoad(string) , Image.CanLoad(string, LoadOptions) , Image.CanLoad(Stream) , Image.CanLoad(Stream, LoadOptions) , Image.Create(ImageOptionsBase, int, int) , Image.Create(Image[]) , Image.Create(MultipageCreateOptions) , Image.Create(string[], bool) , Image.Create(string[]) , Image.Create(Image[], bool) , Image.GetFileFormat(string) , Image.GetFileFormat(Stream) , Image.GetFittingRectangle(Rectangle, int, int) , Image.GetFittingRectangle(Rectangle, int[], int, int) , Image.Load(string, LoadOptions) , Image.Load(string) , Image.Load(Stream, LoadOptions) , Image.Load(Stream) , Image.GetProportionalWidth(int, int, int) , Image.GetProportionalHeight(int, int, int) , Image.RemoveMetadata() , Image.CanSave(ImageOptionsBase) , Image.Resize(int, int) , Image.Resize(int, int, ResizeType) , Image.Resize(int, int, ImageResizeSettings) , Image.GetDefaultOptions(object[]) , Image.GetOriginalOptions() , Image.ResizeWidthProportionally(int) , Image.ResizeHeightProportionally(int) , Image.ResizeWidthProportionally(int, ResizeType) , Image.ResizeHeightProportionally(int, ResizeType) , Image.ResizeWidthProportionally(int, ImageResizeSettings) , Image.ResizeHeightProportionally(int, ImageResizeSettings) , Image.RotateFlip(RotateFlipType) , Image.Rotate(float) , Image.Crop(Rectangle) , Image.Crop(int, int, int, int) , Image.Save() , Image.Save(string) , Image.Save(string, ImageOptionsBase) , Image.Save(string, ImageOptionsBase, Rectangle) , Image.Save(Stream, ImageOptionsBase) , Image.Save(Stream, ImageOptionsBase, Rectangle) , Image.GetSerializedStream(ImageOptionsBase, Rectangle, out int) , Image.SetPalette(IColorPalette, bool) , Image.BitsPerPixel , Image.Bounds , Image.Container , Image.Height , Image.Palette , Image.UsePalette , Image.Size , Image.Width , Image.InterruptMonitor , Image.BufferSizeHint , Image.AutoAdjustPalette , Image.HasBackgroundColor , Image.FileFormat , Image.BackgroundColor , DataStreamSupporter.CacheData() , DataStreamSupporter.Save() , DataStreamSupporter.Save(Stream) , DataStreamSupporter.Save(string) , DataStreamSupporter.Save(string, bool) , DataStreamSupporter.DataStreamContainer , DataStreamSupporter.IsCached , DisposableObject.Dispose() , DisposableObject.Disposed , object.GetType() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Examples
O exemplo a seguir mostra como converter uma imagem svgz para svg fromat
string file = "example.svgz";
string baseFolder = System.IO.Path.Combine("D:", "Compressed");
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".svg";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions() { PageSize = image.Size};
image.Save(outFile, new Aspose.Imaging.ImageOptions.SvgOptions() {VectorRasterizationOptions = vectorRasterizationOptions});
}
O exemplo a seguir mostra como converter uma imagem svg para svgz fromat
string file = "juanmontoya_lingerie.svg";
string baseFolder = System.IO.Path.Combine("D:", "Compressed");
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".svgz";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions() { PageSize = image.Size};
image.Save(outFile, new Aspose.Imaging.ImageOptions.SvgOptions() {VectorRasterizationOptions = vectorRasterizationOptions, Compress = true});
}
Este exemplo mostra como carregar uma imagem SVG de um fluxo de arquivo e rasterizá-lo para PNG.
string dir = "c:\\temp\\";
// Load an SVG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "test.svg"))
using (Aspose.Imaging.FileFormats.Svg.SvgImage svgImage = new Aspose.Imaging.FileFormats.Svg.SvgImage(stream))
{
// In order to rasterize SVG we need to specify rasterization options.
Aspose.Imaging.ImageOptions.SvgRasterizationOptions rasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions();
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
saveOptions.VectorRasterizationOptions = rasterizationOptions;
svgImage.Save(dir + "test.output.png", saveOptions);
}
O exemplo a seguir mostra como converter uma imagem comprimida (O EMZ,.wmz, *.svgz) para raster fromat
string[] files = new[] {"example.emz", "example.wmz", "example.svgz"};
string baseFolder = System.IO.Path.Combine("D:","Compressed");
foreach (var file in files)
{
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".png";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = (Aspose.Imaging.ImageOptions.VectorRasterizationOptions)image.GetDefaultOptions(new object[] { Color.White, image.Width, image.Height });
image.Save(outFile, new Aspose.Imaging.ImageOptions.PngOptions(){VectorRasterizationOptions = vectorRasterizationOptions});
}
}
Constructors
SvgImage(Redação)
Instalando um novo objeto da classe Aspose.Imaging.FileFormats.Svg.SvgImage, utilizando oum caminho especificado para localizar e carregar a imagem. este construtor facilita ocriação de exemplos de imagem SVG a partir de arquivos externos, permitindointegração em sistemas de software e fluxos de trabalho.
public SvgImage(string path)
Parameters
path
string
O caminho para carregar a imagem e iniciar os dados de pixel e paleta com.
Exceptions
O caminho é zero.
SvgImage(Stream)
Cria uma nova instância da classe Aspose.Imaging.FileFormats.Svg.SvgImage, carregando a imagemEste fabricante permite o carregamento direto do SVGImagens de fluxos, melhorando a flexibilidade e a eficiência na gestão da imagemrecursos dentro das aplicações de software.
public SvgImage(Stream stream)
Parameters
stream
Stream
O fluxo para carregar a imagem e iniciar os dados de pixel e paleta com.
Examples
Este exemplo mostra como carregar uma imagem SVG de um fluxo de arquivo e rasterizá-lo para PNG.
string dir = "c:\\temp\\";
// Load an SVG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "test.svg"))
using (Aspose.Imaging.FileFormats.Svg.SvgImage svgImage = new Aspose.Imaging.FileFormats.Svg.SvgImage(stream))
{
// In order to rasterize SVG we need to specify rasterization options.
Aspose.Imaging.ImageOptions.SvgRasterizationOptions rasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions();
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
saveOptions.VectorRasterizationOptions = rasterizationOptions;
svgImage.Save(dir + "test.output.png", saveOptions);
}
Exceptions
O fluxo é nulo.
SvgImage(Int, Int)
Instale um novo Objeto Aspose.Imaging.FileFormats.Svg.SvgImage com a largura especificada eEste construtor permite que os desenvolvedores criem imagens SVG comdimensões, facilitando o controle preciso sobre o tamanho da imagem duranteA iniciação.
public SvgImage(int width, int height)
Parameters
width
int
A imagem de largura.
height
int
A altura da imagem.
SvgImage(Avaliações, int, int)
Cria uma nova instância da classe Aspose.Imaging.FileFormats.Svg.SvgImage com SVG especificadoopções, largura da imagem e parâmetros de altura. este construtor permiteDesenvolvedores para iniciar imagens SVG com opções e dimensões personalizadas,proporcionar flexibilidade na gestão do conteúdo e layout do SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
As opções do SVG.
width
int
Imagem de largura.
height
int
altura da imagem.
Properties
BitsPerPixel
Retira os bits por número de pixels da imagem. é importante notar queEste parâmetro não se aplica às imagens vector, uma vez que elas não são medidas emEsta propriedade fornece informações cruciais sobre a cor da imagemProfundidade, auxílio em tarefas de processamento e manipulação.
public override int BitsPerPixel { get; }
Valor da propriedade
Exceptions
Invalididade para imagens vector
FileFormat
retorna o formato de arquivo da imagem, fornecendo metadados essenciais paraprocessamento e verificação de compatibilidade. esta propriedade é instrumental emdeterminar as estratégias de decodificação e de codificação apropriadas para a gestão daDados de imagem efetivamente em diferentes sistemas e aplicações.
public override FileFormat FileFormat { get; }
Valor da propriedade
IsCached
Retira um valor booleano indicando se os dados do objeto estão atualmentecache, eliminando a necessidade de operações adicionais de leitura de dados.A propriedade fornece uma visão do estado de caching atual, otimizando os dadosRecuperação e processamento de fluxos de trabalho para melhorar o desempenho e eficiência.
public override bool IsCached { get; }
Valor da propriedade
XmpData
Receba ou coleta dados XMP.
public XmpPacketWrapper XmpData { get; set; }
Valor da propriedade
Methods
CacheData()
Cache os dados e garante que não haverá carregamento adicional de dados deo subjacente Aspose.Imaging.DataStreamSupporter.DataStreamContainer.Otimização melhora o desempenho eliminando a recuperação de dados redundanteoperações, especialmente benéficas em cenários que requerem acesso frequente aodados da imagem.
public override void CacheData()
Crop(Rectangle)
Corra o rectangulo especificado.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
do rectangulo.
GetDefaultOptions(Objeto[])
Retire as opções padrão configuradas para a imagem, fornecendo uma linha de baseconfiguração para várias operações, tais como redirecionamento, compressão ou codificação.O método é fundamental para garantir um comportamento consistente e padrões de qualidade em todo o mundo.Tarefas de processamento de imagem sem a necessidade de parameterias explícitas.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[ ]
Os argumentos .
Returns
Opções Default
GetImage2Export(ImagemOpçõesBase, Rectangle, IImageExporter)
Obtenha a imagem para exportar.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
A base das opções de imagem.
boundsRectangle
Rectangle
Os limites são rectangulares.
exporter
IImageExporter
do exportador.
Returns
A imagem para exportar
ReleaseManagedResources()
Assegure-se de que os recursos não gerenciados não sejam liberados aqui, uma vez que eles podem já ter sido liberados.
protected override void ReleaseManagedResources()
Resize(Int, Int, ResizeType)
Recuperar a imagem para ajustar as dimensões especificadas ao mesmo tempo que preserva o seu aspectoEste método fornece uma maneira conveniente de ajustar o tamanho da imagemsem distorcer as suas proporções, garantindo a visualização ou o armazenamento óptimode acordo com as dimensões desejadas.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
A nova amplitude.
newHeight
int
A nova altura.
resizeType
ResizeType
O tipo de resgate.
Rotate(Flotação)
Rotando a imagem ao redor do centro.
public override void Rotate(float angle)
Parameters
angle
float
O ângulo de rotação em graus. valores positivos girarão de maneira horária.
SaveData(Stream)
Salve os dados.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
O fluxo para salvar dados para.
SetPalette(Coloração, Bool)
Aplique uma paleta especificada à imagem, permitindo a personalização da corpara fins estéticos ou funcionais. este método proporciona flexibilidadeem gerenciamento de paletes de cores para atender a diferentes requisitos de design ou aplicação.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
A paleta para definir.
updateColors
bool
se configurado para “verdadeira” cores será atualizado de acordo com a nova paleta; caso contrário, os índices de cores permanecem inalterados. note que os índices inalterados podem quebrar a imagem no carregamento se alguns índices não têm entradas de paleta correspondentes.