Přehled obrázků
Toto téma obsahuje úvod do součásti Microsoft Windows Presentation Foundation Imaging Component. WPF Imaging umožňuje vývojářům zobrazovat, transformovat a formátovat obrázky.
Komponenta WPF Imaging
WPF Imaging poskytuje významná vylepšení možností vytváření imicí v rámci systému Microsoft Windows. Možnosti vytváření obrázků, jako je zobrazení rastrového obrázku nebo použití obrázku na společném ovládacím prvku, byly dříve závislé na knihovnách GDI (Microsoft Windows Graphics Device Interface) nebo Microsoft Windows GDI+. Toto rozhraní API poskytuje základní funkce pro vytváření imagí, ale chybí funkce, jako je podpora rozšiřitelnosti kodeků a podpora obrázků s vysokou věrností. WPF Imaging je navržená tak, aby překonat nedostatky GDI a GDI+ a poskytla novou sadu rozhraní API pro zobrazování a používání obrázků ve vašich aplikacích.
Existují dva způsoby přístupu k rozhraní WPF Imaging API, spravované komponentě a nespravované komponentě. Nespravovaná komponenta poskytuje následující funkce.
Model rozšiřitelnosti pro nové nebo proprietární formáty obrázků
Vylepšili jsme výkon a zabezpečení nativních formátů obrázků, včetně rastrových obrázků (BMP), Joint Photographics Experts Group (JPEG), Portable Network Graphics (PNG), Tagged Image File Format (TIFF), Microsoft Windows Media Photo, Graphics Interchange Format (GIF) a ikony (.ico).
Zachování dat obrázků s vysokou hloubkou až 8 bitů na kanál (32 bitů na pixel).
Nedestruktivní škálování, oříznutí a otočení obrázků
Zjednodušená správa barev
Podpora in-file, proprietárních metadat.
Spravovaná komponenta využívá nespravovanou infrastrukturu k zajištění bezproblémové integrace imagí s jinými funkcemi WPF, jako je uživatelské rozhraní, animace a grafika. Spravovaná komponenta také přináší výhody modelu rozšiřitelnosti kodeků wpf (Windows Presentation Foundation), který umožňuje automatické rozpoznávání nových formátů obrázků v aplikacích WPF.
Většina spravovaného rozhraní WPF Imaging API se nachází v System.Windows.Media.Imaging oboru názvů, i když několik důležitých typů, například ImageBrush a ImageDrawing nachází se v System.Windows.Media oboru názvů a Image nachází se v System.Windows.Controls oboru názvů.
Toto téma obsahuje další informace o spravované komponentě. Další informace o nespravovaném rozhraní API naleznete v dokumentaci k nespravované komponentě WPF Imaging.
Formáty obrázků WPF
Kodek se používá k dekódování nebo kódování určitého formátu média. WPF Imaging obsahuje kodek pro formáty obrázků BMP, JPEG, PNG, TIFF, Windows Media Photo, GIF a ICON. Každý z těchto kodeků umožňuje aplikacím dekódovat a s výjimkou ICON kódovat příslušné formáty obrázků.
BitmapSource je důležitou třídou používanou při dekódování a kódování obrázků. Jedná se o základní stavební blok kanálu WPF Imaging a představuje jednu konstantní sadu pixelů v určité velikosti a rozlišení. Může BitmapSource to být individuální rámec více snímků nebo může být výsledkem transformace provedené na obrázku BitmapSource. Jedná se o nadřazený prvek mnoha primárních tříd používaných při vytváření image WPF, jako BitmapFrameje .
A BitmapFrame slouží k ukládání skutečných rastrových dat ve formátu obrázku. Mnoho formátů obrázků podporuje pouze jeden BitmapFrame, i když formáty jako GIF a TIFF podporují více snímků na jeden obrázek. Snímky používají dekodéry jako vstupní data a předávají se kodérům k vytváření souborů obrázků.
Následující příklad ukazuje, jak BitmapFrame je vytvořen z obrázku BitmapSource TIFF a pak přidán do obrázku TIFF.
BitmapSource image5 = BitmapSource.Create(
width,
height,
96,
96,
PixelFormats.Indexed1,
BitmapPalettes.WebPalette,
pixels,
stride);
FileStream stream5 = new FileStream("palette.tif", FileMode.Create);
TiffBitmapEncoder encoder5 = new TiffBitmapEncoder();
encoder5.Frames.Add(BitmapFrame.Create(image5));
encoder5.Save(stream5);
Dim image5 As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, BitmapPalettes.WebPalette, pixels, stride)
Dim stream5 As New FileStream("palette.tif", FileMode.Create)
Dim encoder5 As New TiffBitmapEncoder()
encoder5.Frames.Add(BitmapFrame.Create(image5))
encoder5.Save(stream5)
Dekódování formátu obrázku
Dekódování obrázku je překlad formátu obrázku na data obrázků, která může systém používat. Data obrázku se pak dají použít k zobrazení, zpracování nebo kódování do jiného formátu. Výběr dekodéru je založený na formátu obrázku. Výběr kodeku je automatický, pokud není zadán konkrétní dekodér. Příklady v části Zobrazení obrázků ve WPF ukazují automatické dekódování. Dekodéry vlastního formátu vyvinuté pomocí nespravovaných rozhraní WPF Imaging a registrované v systému se automaticky účastní výběru dekodéru. To umožňuje automatické zobrazení vlastních formátů v aplikacích WPF.
Následující příklad ukazuje použití rastrového dekodéru k dekódování obrázku formátu BMP.
// Open a Uri and decode a BMP image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.bmp", UriKind::RelativeOrAbsolute);
BmpBitmapDecoder^ decoder2 = gcnew BmpBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource2 = decoder2->Frames[0];
// Draw the Image
Image^ myImage2 = gcnew Image();
myImage2->Source = bitmapSource2;
myImage2->Stretch = Stretch::None;
myImage2->Margin = System::Windows::Thickness(20);
// Open a Uri and decode a BMP image
Uri myUri = new Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute);
BmpBitmapDecoder decoder2 = new BmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];
// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);
' Open a Uri and decode a BMP image
Dim myUri As New Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute)
Dim decoder2 As New BmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource2 As BitmapSource = decoder2.Frames(0)
' Draw the Image
Dim myImage2 As New Image()
myImage2.Source = bitmapSource2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)
Kódování formátu obrázku
Kódování obrázků je překlad dat obrázků do konkrétního formátu obrázku. Zakódovaná data obrázků se pak dají použít k vytvoření nových souborů obrázků. WPF Imaging poskytuje kodéry pro každý z výše popsaných formátů obrázků.
Následující příklad ukazuje použití kodéru k uložení nově vytvořené rastrové image.
FileStream^ stream = gcnew FileStream("new.bmp", FileMode::Create);
BmpBitmapEncoder^ encoder = gcnew BmpBitmapEncoder();
TextBlock^ myTextBlock = gcnew TextBlock();
myTextBlock->Text = "Codec Author is: " + encoder->CodecInfo->Author->ToString();
encoder->Frames->Add(BitmapFrame::Create(image));
encoder->Save(stream);
FileStream stream = new FileStream("new.bmp", FileMode.Create);
BmpBitmapEncoder encoder = new BmpBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
encoder.Save(stream);
Dim stream As New FileStream("new.bmp", FileMode.Create)
Dim encoder As New BmpBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
encoder.Save(stream)
Zobrazení obrázků ve WPF
Existuje několik způsobů, jak zobrazit obrázek v aplikaci WPF (Windows Presentation Foundation). Obrázky lze zobrazit pomocí Image ovládacího prvku, malovat na vizuálu pomocí nebo ImageBrushkreslit pomocí .ImageDrawing
Použití ovládacího prvku Obrázek
Image je prvek architektury a primární způsob zobrazení obrázků v aplikacích. V jazyce XAML Image lze použít dvěma způsoby: syntaxi atributu nebo syntaxi vlastností. Následující příklad ukazuje, jak vykreslit obrázek o šířce 200 pixelů pomocí syntaxe atributu i syntaxe značek vlastností. Další informace o syntaxi atributu a syntaxi vlastností naleznete v tématu Přehled vlastností závislostí.
<!-- Simple image rendering. However, rendering an image this way may not
result in the best use of application memory. See markup below which
creates the same end result but using less memory. -->
<Image Width="200"
Source="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg"/>
<Image Width="200">
<Image.Source>
<!-- To save significant application memory, set the DecodePixelWidth or
DecodePixelHeight of the BitmapImage value of the image source to the desired
height and width of the rendered image. If you don't do this, the application will
cache the image as though it were rendered as its normal size rather than just
the size that is displayed. -->
<!-- Note: In order to preserve aspect ratio, only set either DecodePixelWidth
or DecodePixelHeight but not both. -->
<BitmapImage DecodePixelWidth="200"
UriSource="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg" />
</Image.Source>
</Image>
Mnoho příkladů používá BitmapImage objekt k odkazování na soubor obrázku. BitmapImage je specializovaný BitmapSource , který je optimalizovaný pro načítání XAML (Extensible Application Markup Language) a je snadný způsob, jak zobrazit obrázky jako Source ovládací prvek Image .
Následující příklad ukazuje, jak pomocí kódu vykreslit obrázek o šířce 200 pixelů.
Poznámka:
BitmapImage implementuje ISupportInitialize rozhraní pro optimalizaci inicializace u více vlastností. Změny vlastností mohou nastat pouze během inicializace objektů. Volání BeginInit signálu, že inicializace začala, a EndInit signalizovat, že inicializace byla dokončena. Po inicializaci se změny vlastností ignorují.
// Create Image Element
Image myImage = new Image();
myImage.Width = 200;
// Create source
BitmapImage myBitmapImage = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage.BeginInit();
myBitmapImage.UriSource = new Uri(@"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg");
// To save significant application memory, set the DecodePixelWidth or
// DecodePixelHeight of the BitmapImage value of the image source to the desired
// height or width of the rendered image. If you don't do this, the application will
// cache the image as though it were rendered as its normal size rather than just
// the size that is displayed.
// Note: In order to preserve aspect ratio, set DecodePixelWidth
// or DecodePixelHeight but not both.
myBitmapImage.DecodePixelWidth = 200;
myBitmapImage.EndInit();
//set image source
myImage.Source = myBitmapImage;
' Create Image Element
Dim myImage As New Image()
myImage.Width = 200
' Create source
Dim myBitmapImage As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage.BeginInit()
myBitmapImage.UriSource = New Uri("C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg")
' To save significant application memory, set the DecodePixelWidth or
' DecodePixelHeight of the BitmapImage value of the image source to the desired
' height or width of the rendered image. If you don't do this, the application will
' cache the image as though it were rendered as its normal size rather than just
' the size that is displayed.
' Note: In order to preserve aspect ratio, set DecodePixelWidth
' or DecodePixelHeight but not both.
myBitmapImage.DecodePixelWidth = 200
myBitmapImage.EndInit()
'set image source
myImage.Source = myBitmapImage
Otočení, převod a oříznutí obrázků
WPF umožňuje uživatelům transformovat obrázky pomocí vlastností BitmapImage nebo pomocí dalších BitmapSource objektů, jako CroppedBitmap jsou nebo FormatConvertedBitmap. Tyto transformace obrázků můžou obrázek škálovat nebo otáčet, měnit formát pixelů obrázku nebo oříznout obrázek.
Otočení obrázků se provádí pomocí Rotation vlastnosti BitmapImage. Otočení lze provádět pouze v 90stupňových přírůstcích. V následujícím příkladu je obrázek otočený o 90 stupňů.
<Image Width="150" Margin="5" Grid.Column="0" Grid.Row="1">
<Image.Source>
<TransformedBitmap Source="/sampleImages/watermelon.jpg" >
<TransformedBitmap.Transform>
<RotateTransform Angle="90"/>
</TransformedBitmap.Transform>
</TransformedBitmap>
</Image.Source>
</Image>
// Create Image element.
Image rotated90 = new Image();
rotated90.Width = 150;
// Create the TransformedBitmap to use as the Image source.
TransformedBitmap tb = new TransformedBitmap();
// Create the source to use as the tb source.
BitmapImage bi = new BitmapImage();
bi.BeginInit();
bi.UriSource = new Uri(@"sampleImages/watermelon.jpg", UriKind.RelativeOrAbsolute);
bi.EndInit();
// Properties must be set between BeginInit and EndInit calls.
tb.BeginInit();
tb.Source = bi;
// Set image rotation.
RotateTransform transform = new RotateTransform(90);
tb.Transform = transform;
tb.EndInit();
// Set the Image source.
rotated90.Source = tb;
' Create Image element.
Dim rotated90 As New Image()
rotated90.Width = 150
' Create the TransformedBitmap to use as the Image source.
Dim tb As New TransformedBitmap()
' Create the source to use as the tb source.
Dim bi As New BitmapImage()
bi.BeginInit()
bi.UriSource = New Uri("sampleImages/watermelon.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Properties must be set between BeginInit and EndInit calls.
tb.BeginInit()
tb.Source = bi
' Set image rotation.
Dim transform As New RotateTransform(90)
tb.Transform = transform
tb.EndInit()
' Set the Image source.
rotated90.Source = tb
Převod obrázku do jiného formátu pixelů, jako je například stupně šedé, se provádí pomocí FormatConvertedBitmap. V následujících příkladech je obrázek převeden na Gray4.
<!-- Grayscale XAML Image -->
<Image Width="200" Grid.Column="0" Grid.Row="1">
<Image.Source>
<FormatConvertedBitmap Source="/sampleImages/rocks.jpg" DestinationFormat="Gray4" />
</Image.Source>
</Image>
//Create Image Element
Image grayImage = new Image();
grayImage.Width = 200;
grayImage.Margin = new Thickness(5);
//Create source using xaml defined resource.
FormatConvertedBitmap fcb = new FormatConvertedBitmap(
(BitmapImage)this.Resources["masterImage"],PixelFormats.Gray4,null,0);
//set image source
grayImage.Source = fcb;
'Create Image Element
Dim grayImage As New Image()
grayImage.Width = 200
grayImage.Margin = New Thickness(5)
'Create source using xaml defined resource.
Dim fcb As New FormatConvertedBitmap(CType(Me.Resources("masterImage"), BitmapImage), PixelFormats.Gray4, Nothing, 0)
'set image source
grayImage.Source = fcb
Pokud chcete obrázek oříznout, můžete Clip použít vlastnost Image nebo CroppedBitmap použít. Pokud chcete jenom zobrazit část obrázku, Clip obvykle byste měli použít. Pokud potřebujete zakódovat a uložit oříznutý obrázek, CroppedBitmap měl by se použít. V následujícím příkladu se obrázek ořízne pomocí vlastnosti Clip pomocí .EllipseGeometry
<!-- Cropping an Image using Clip -->
<Image Width="200" Grid.Column="0" Grid.Row="5" Margin="5"
Source="/sampleImages/gecko.jpg">
<Image.Clip>
<EllipseGeometry Center="75,50" RadiusX="50" RadiusY="25" />
</Image.Clip>
</Image>
//Create the image for clipping
Image clipImage = new Image();
clipImage.Width = 200;
clipImage.Margin = new Thickness(5);
//Create & Set source
BitmapImage bi = new BitmapImage();
//BitmapImage.UriSource must be in a BeginInit/EndInit block
bi.BeginInit();
bi.UriSource = new Uri("pack://application:,,/sampleImages/gecko.jpg");
bi.EndInit();
clipImage.Source = bi;
//Clip the using an EllipseGeometry
EllipseGeometry clipGeometry = new EllipseGeometry(new Point(75, 50), 50, 25);
clipImage.Clip = clipGeometry;
' Create the image for clipping
Dim clipImage As New Image()
clipImage.Width = 200
clipImage.Margin = New Thickness(5)
'Create & Set source
Dim bi As New BitmapImage()
' BitmapImage properties must be in a BeginInit/EndInit block
bi.BeginInit()
bi.UriSource = New Uri("pack://application:,,/sampleImages/gecko.jpg")
bi.EndInit()
clipImage.Source = bi
' Clip the using an EllipseGeometry
Dim clipGeometry As New EllipseGeometry(New System.Windows.Point(75, 50), 50, 25)
clipImage.Clip = clipGeometry
Roztažení obrázků
Vlastnost Stretch určuje, jak je obrázek roztažený tak, aby vyplnil kontejner. Vlastnost Stretch přijímá následující hodnoty definované výčtem Stretch :
None: Obrázek není roztažený tak, aby vyplnil výstupní oblast. Pokud je obrázek větší než výstupní oblast, obrázek se nakreslí do výstupní oblasti a vystřihne, co se nevejde.
Fill: Obrázek se škáluje tak, aby odpovídal výstupní oblasti. Vzhledem k tomu, že výška a šířka obrázku se škálují nezávisle, původní poměr stran obrázku nemusí být zachován. To znamená, že image může být závlečná, aby se výstupní kontejner zcela vyplnil.
Uniform: Obrázek se škáluje tak, aby se zcela vešel do výstupní oblasti. Poměr stran obrázku se zachová.
UniformToFill: Obrázek se škáluje tak, aby zcela vyplnil výstupní oblast při zachování původního poměru stran obrázku.
Následující příklad použije každý z dostupných Stretch výčtů na .Image
Následující obrázek ukazuje výstup z příkladu a ukazuje vliv na různá Stretch nastavení při použití na obrázek.
Různá nastavení roztažení
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
<DockPanel>
<Border DockPanel.Dock="Top" Background="Black">
<TextBlock Foreground="White" HorizontalAlignment="Stretch" FontSize="20">
Stretching an Image
</TextBlock>
</Border>
<Grid Name="simpleGrid" Background="{StaticResource CheckeredBrushResource}"
Margin="10"
ShowGridLines="True"
VerticalAlignment="Center"
HorizontalAlignment="Center">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="175" />
<ColumnDefinition Width="175" />
<ColumnDefinition Width="175" />
<ColumnDefinition Width="175" />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition />
<RowDefinition Height="200"/>
</Grid.RowDefinitions>
<!-- Labels -->
<TextBlock Style="{StaticResource Header1}"
Grid.Column="0" Grid.Row="0">None</TextBlock>
<TextBlock Style="{StaticResource Header1}"
Grid.Column="1" Grid.Row="0">Uniform</TextBlock>
<TextBlock Style="{StaticResource Header1}"
Grid.Column="2" Grid.Row="0">UniformToFill</TextBlock>
<TextBlock Style="{StaticResource Header1}"
Grid.Column="3" Grid.Row="0">Fill</TextBlock>
<Border Grid.Column="0" Grid.Row="1" BorderThickness="1" BorderBrush="Black">
<!-- None: Image is not scaled. If image is larger than the
output area, the image will be cropped to the size of the output area.-->
<Image
Source="sampleImages/gecko.jpg"
Stretch="None" />
</Border>
<Border Grid.Column="1" Grid.Row="1" BorderThickness="1" BorderBrush="Black">
<!-- Uniform: Scale to fit output area.
Aspect ratio is preserved.-->
<Image
Source="sampleImages/gecko.jpg"
Stretch="Uniform" />
</Border>
<Border Grid.Column="2" Grid.Row="1" BorderThickness="1" BorderBrush="Black">
<!-- UniformToFill: Scale to completely fill output area.
Aspect ratio is preserved. Cropping may occur.-->
<Image
Source="sampleImages/gecko.jpg"
Stretch="UniformToFill" />
</Border>
<Border Grid.Column="3" Grid.Row="1" BorderThickness="1" BorderBrush="Black">
<!-- Fill: Scale to completely fill output area.
Aspect ratio may not be preserved.-->
<Image
Source="sampleImages/gecko.jpg"
Stretch="Fill" />
</Border>
</Grid>
</DockPanel>
</Page>
Malování s obrázky
Obrázky lze také zobrazit v aplikaci obrazem Brushpomocí . Štětce umožňují malovat objekty uživatelského rozhraní s čímkoli od jednoduchých, plných barev až po složité sady vzorů a obrázků. Chcete-li malovat s obrázky, použijte .ImageBrush Typ ImageBrush , TileBrush který definuje jeho obsah jako rastrový obrázek. Zobrazí ImageBrush jeden obrázek, který je určen jeho ImageSource vlastností. Můžete určit, jak se obrázek roztáhne, zarovná a zarovná, a umožní vám zabránit zkreslení a vytvářet vzory a další efekty. Následující obrázek ukazuje některé efekty, které lze dosáhnout pomocí ImageBrush.
Štětce obrázků můžou vyplnit obrazce, ovládací prvky, text a další prvky.
Následující příklad ukazuje, jak malovat pozadí tlačítka pomocí obrázku ImageBrushpomocí .
<!-- Sets the button's Background property with an ImageBrush. The resulting
button has an image as its background. -->
<Button Grid.Row="3" Grid.Column="2"
Height="75" Width="100" Foreground="White" FontWeight="Bold"
HorizontalAlignment="Left">
A Button
<Button.Background>
<ImageBrush ImageSource="sampleImages\blueberries.jpg" />
</Button.Background>
</Button>
Další informace o ImageBrush obrázcích a malování najdete v tématu Malování s obrázky, výkresy a vizuály.
Metadata obrázků
Některé soubory obrázků obsahují metadata, která popisují obsah nebo charakteristiky souboru. Většina digitálních fotoaparátů například vytváří obrázky, které obsahují metadata o make a modelu fotoaparátu použitého k zachycení obrázku. Každý formát obrázku zpracovává metadata odlišně, ale WPF Imaging poskytuje jednotný způsob ukládání a načítání metadat pro každý podporovaný formát obrázku.
Přístup k metadatům je poskytován prostřednictvím Metadata vlastnosti objektu BitmapSource . MetadataBitmapMetadata vrátí objekt, který obsahuje všechna metadata obsažená obrázkem. Tato data můžou být v jednom schématu metadat nebo v kombinaci různých schémat. WPF Imaging podporuje následující schémata metadat obrázků: Exchangeable image file (Exif), tEXt (PNG Textal Data), image file directory (IFD), International Press Telecommunications Council (IPTC) a Extensible Metadata Platform (XMP).
Pro zjednodušení procesu čtení metadat poskytuje několik pojmenovaných vlastností, BitmapMetadata ke kterým lze snadno přistupovat, například Author, Titlea CameraModel. Mnohé z těchto pojmenovaných vlastností lze také použít k zápisu metadat. Čtenář dotazů metadat metadat poskytuje další podporu pro čtení metadat. Metoda GetQuery se používá k načtení čtečky dotazů metadat poskytnutím řetězcového dotazu, jako je například /app1/exif/. V následujícím příkladu GetQuery se používá k získání textu uloženého v umístění /Text/Description .
// Add the metadata of the bitmap image to the text block.
TextBlock^ myTextBlock = gcnew TextBlock();
myTextBlock->Text = "The Description metadata of this image is: " + pngInplace->GetQuery("/Text/Description")->ToString();
// Add the metadata of the bitmap image to the text block.
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "The Description metadata of this image is: " + pngInplace.GetQuery("/Text/Description").ToString();
' Add the metadata of the bitmap image to the text block.
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "The Description metadata of this image is: " + pngInplace.GetQuery("/Text/Description").ToString()
K zápisu metadat se používá zapisovač dotazů metadat. SetQuery získá zapisovač dotazu a nastaví požadovanou hodnotu. V následujícím příkladu SetQuery se používá k zápisu textu uloženého v umístění /Text/Description .
Stream^ pngStream = gcnew FileStream("smiley.png", FileMode::Open, FileAccess::ReadWrite, FileShare::ReadWrite);
PngBitmapDecoder^ pngDecoder = gcnew PngBitmapDecoder(pngStream, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapFrame^ pngFrame = pngDecoder->Frames[0];
InPlaceBitmapMetadataWriter^ pngInplace = pngFrame->CreateInPlaceBitmapMetadataWriter();
if (pngInplace->TrySave() == true)
{
pngInplace->SetQuery("/Text/Description", "Have a nice day.");
}
pngStream->Close();
Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();
Dim pngStream As New System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite)
Dim pngDecoder As New PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim pngFrame As BitmapFrame = pngDecoder.Frames(0)
Dim pngInplace As InPlaceBitmapMetadataWriter = pngFrame.CreateInPlaceBitmapMetadataWriter()
If pngInplace.TrySave() = True Then
pngInplace.SetQuery("/Text/Description", "Have a nice day.")
End If
pngStream.Close()
Rozšiřitelnost kodeků
Základní funkcí WPF Imaging je model rozšiřitelnosti pro nové kodeky obrázků. Tato nespravovaná rozhraní umožňují vývojářům kodeků integrovat kodeky s WPF, aby nové formáty obrázků mohly automaticky používat aplikace WPF.
Ukázku rozhraní API rozšiřitelnosti najdete v ukázkovém kodeku Win32. Tato ukázka ukazuje, jak vytvořit dekodér a kodér pro vlastní formát obrázku.
Poznámka:
Aby ho systém rozpoznal, musí být kodek digitálně podepsaný.
Viz také
.NET Desktop feedback
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro