LEADTOOLS画像ファイルサポート(Leadtools.Codecsアセンブリ)

フレームを表示

LoadOptions(String)メソッド








ロードするためにオプションを格納しているディスクファイルの名前を格納するString
このRasterCodecsへのオプションをディスクファイルからロードします。
構文
public void LoadOptions( 
   string fileName
)
'Declaration
 
Public Overloads Sub LoadOptions( _
   ByVal fileName As String _
) 
'Usage
 
Dim instance As RasterCodecs
Dim fileName As String
 
instance.LoadOptions(fileName)
public void LoadOptions( 
   string fileName
)
 function Leadtools.Codecs.RasterCodecs.LoadOptions(String)( 
   fileName 
)
public:
void LoadOptions( 
   String^ fileName
) 

パラメーター

fileName
ロードするためにオプションを格納しているディスクファイルの名前を格納するString
解説

RasterCodecsオプションは、簡単にSaveOptions(string fileName)またはSaveOptions(Streamストリーム)を用いてディスクまたはストリームに保存されることができて、それからLoadOptions(string fileName)またはLoadOptions(Streamストリーム)を用いて同じことまたは様々なRasterCodecsオブジェクトへとロードされることができます。

オプションを保存して、ロードすることは、デフォルト以外の専門オプションによるRasterCodecsが使われる状況に便利です。たとえば、サーバでは、アプリケーションはサンプルによって同じくらい説明しました。

オプションは、以下の形式で標準的なXMLファイル(UTF-8がエンコードする)で保存されます:


            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <leadtools_raster_codecs>
              <options>
                 <option FullPropertyName="value" />
              </options>
            </leadtools_raster_codecs>
            

FullPropertyNameRasterCodecsオブジェクトを呼び出しrasterCodecsInstanceておくならば、たとえば、RasterCodecsオブジェクトによってアクセスされるオプションの正確な.NETプロパティ名です、そして、以下を使用してCodecsRasterizeDocumentLoadOptions.XResolutionにアクセスすることができます:


            rasterCodecsInstance.RasterizeDocument.Load.XResolution
            

そして、それゆえに、このオプションがそうであるだろうFullPropertyNameもしもRasterizeDocument.Load.XResolution

LoadOptions(string fileName)LoadOptions(Streamストリーム)メソッドは、現在のRasterCodecsオプションでXMLファイルのコンテンツを結合します。したがって、必要であればファイルからデフォルト動作をオーバーライドしない任意のオプション要素を削除することができます。

サンプル

このサンプルは、オプションを保存して、それからサーバーアプリケーションでロードする方法を示します。

Copy Code  
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing
Imports Leadtools.ImageProcessing.Color
Imports Leadtools.Drawing
Imports Leadtools.Svg

' A bare-boned REST service that loads an image from a URL and returns it as PNG
<System.ServiceModel.ServiceContract()> _
Public Interface ISampleService
   <System.ServiceModel.OperationContract(Name:="Load", IsTerminating:=False, IsInitiating:=True, IsOneWay:=False, AsyncPattern:=False, Action:="Load")> _
   <System.ServiceModel.Web.WebGet(UriTemplate:="/load?url={url}&page={pageNumber}")> _
   Function Load(url As String, pageNumber As Integer) As System.IO.Stream
End Interface
' Implementation
Public Class SampleService
   Implements ISampleService

   ' This is the REST service call
   Public Function Load(url As String, pageNumber As Integer) As System.IO.Stream Implements ISampleService.Load
      ' Load the page
      Using rasterCodecs As New RasterCodecs()
         ' Get the name of the options file from the configuraion file
         Dim optionsFilePath As String = System.Configuration.ConfigurationManager.AppSettings("RasterCodecsOptionsFilePath")

         ' See if it is set and contains a valid file
         If Not IsNothing(optionsFilePath) AndAlso System.IO.File.Exists(optionsFilePath) Then
            ' Set it, this will use the options previously saved with SampleService.PrepareOptions
            rasterCodecs.LoadOptions(optionsFilePath)
         End If

         ' Now load the image
         Using rasterImage As RasterImage = rasterCodecs.Load(New Uri(url), pageNumber)
            ' Save it as PNG
            Dim ms As New System.IO.MemoryStream()
            rasterCodecs.Save(rasterImage, ms, RasterImageFormat.Png, 24)

            ' Set the content length and MIME type
            System.ServiceModel.Web.WebOperationContext.Current.OutgoingResponse.ContentType = "image/png"
            System.ServiceModel.Web.WebOperationContext.Current.OutgoingResponse.ContentLength = ms.Length

            ms.Position = 0
            Return ms
         End Using
      End Using
   End Function

   ' This is a helper method to create the RasterCodecs options file. This method
   ' is meant to be called from ourside the service by an administrator.
   '
   ' We can change any option we want off-line and then save the file
   ' Our service will pick up the new options from the file and use them
   Public Shared Sub PrepareOptions()
      ' Get the name of the options file from the configuraion file
      Dim optionsFilePath As String = System.Configuration.ConfigurationManager.AppSettings("RasterCodecsOptionsFilePath")

      ' See if it is set
      If Not IsNothing(optionsFilePath) Then
         ' Yes, create a new RasterCodecs object
         Using rasterCodecs As New RasterCodecs()
            ' Change any options, for example, set the default resolution for document files ...
            rasterCodecs.Options.RasterizeDocument.Load.XResolution = 300
            rasterCodecs.Options.RasterizeDocument.Load.YResolution = 300
            ' And enable loading text files as RasterImage support
            rasterCodecs.Options.Txt.Load.Enabled = True

            ' Save the options to the file specified by the config
            rasterCodecs.SaveOptions(optionsFilePath)
         End Using
      End If
   End Sub
End Class
using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing;
using Leadtools.ImageProcessing.Color;
using Leadtools.Svg;

// A bare-boned REST service that loads an image from a URL and returns it as PNG
[System.ServiceModel.ServiceContract()]
public interface ISampleService
{
   [System.ServiceModel.OperationContract(Name = "Load", IsTerminating = false, IsInitiating = true, IsOneWay = false, AsyncPattern = false, Action = "Load")]
   [System.ServiceModel.Web.WebGet(UriTemplate = "/load?url={url}&page={pageNumber}")]
   System.IO.Stream Load(string url, int pageNumber);
}
// Implementation
public class SampleService : ISampleService
{
   // This is the REST service call
   public System.IO.Stream Load(string url, int pageNumber)
   {
      // Load the page
      using (RasterCodecs rasterCodecs = new RasterCodecs())
      {
         // Get the name of the options file from the configuraion file
         string optionsFilePath = System.Configuration.ConfigurationManager.AppSettings["RasterCodecsOptionsFilePath"];

         // See if it is set and contains a valid file
         if (optionsFilePath != null && System.IO.File.Exists(optionsFilePath))
         {
            // Set it, this will use the options previously saved with SampleService.PrepareOptions
            rasterCodecs.LoadOptions(optionsFilePath);
         }

         // Now load the image
         using (RasterImage rasterImage = rasterCodecs.Load(new Uri(url), pageNumber))
         {
            // Save it as PNG
            System.IO.MemoryStream ms = new System.IO.MemoryStream();
            rasterCodecs.Save(rasterImage, ms, RasterImageFormat.Png, 24);

            // Set the content length and MIME type
            System.ServiceModel.Web.WebOperationContext.Current.OutgoingResponse.ContentType = "image/png";
            System.ServiceModel.Web.WebOperationContext.Current.OutgoingResponse.ContentLength = ms.Length;

            ms.Position = 0;
            return ms;
         }
      }
   }

   // This is a helper method to create the RasterCodecs options file. This method
   // is meant to be called from ourside the service by an administrator.
   //
   // We can change any option we want off-line and then save the file
   // Our service will pick up the new options from the file and use them
   public static void PrepareOptions()
   {
      // Get the name of the options file from the configuraion file
      string optionsFilePath = System.Configuration.ConfigurationManager.AppSettings["RasterCodecsOptionsFilePath"];

      // See if it is set
      if (optionsFilePath != null)
      {
         // Yes, create a new RasterCodecs object
         using (RasterCodecs rasterCodecs = new RasterCodecs())
         {
            // Change any options, for example, set the default resolution for document files ...
            rasterCodecs.Options.RasterizeDocument.Load.XResolution = 300;
            rasterCodecs.Options.RasterizeDocument.Load.YResolution = 300;
            // And enable loading text files as RasterImage support
            rasterCodecs.Options.Txt.Load.Enabled = true;

            // Save the options to the file specified by the config
            rasterCodecs.SaveOptions(optionsFilePath);
         }
      }
   }
}
必要条件

ターゲットプラットホーム

参照

参照

RasterCodecsクラス
RasterCodecsメンバ
オーバーロードリスト