リージョンの生成 (楕円形)

Namespace: FVIL.Data
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
public virtual void Create(
	CFviEllipse ellipse
)
Visual Basic
Public Overridable Sub Create ( 
	ellipse As CFviEllipse
)

Parameters

ellipse
Type: FVIL.Data..::..CFviEllipse
楕円形

Remarks

楕円形のリージョンを生成します。

下図に示す楕円は、中心が(5.0, 4.0)、長軸半径が3.0、短軸半径が2.0の楕円リージョンを作成した場合の例です。 また、長軸半径と短軸半径をともに0とした場合、１点のリージョンが作成されます。

座標の制限:
図形の座標は、-16777216.0~16777215.0 の範囲に限定されます。 範囲を超える座標が指定された場合は、例外を発行します。

生成に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値ErrorCode メンバ内容
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリ不足の為、生成に失敗しました。
11FVIL.ErrorCode.INVALID_PARAMETER引数に指定された値が不正です。

Examples

ソースコード:
C# Copy imageCopy
using System;
using System.Collections.Generic;
using System.Text;
using fvalgcli;

namespace User.SampleCode.Data
{
    public partial class Region
    {
        /// <summary>
        /// [リージョン構造クラス]
        /// 初期値指定コンストラクタ (楕円形)
        /// </summary>
        [FvPluginExecute]
        public void Ellipse_ctor()
        {
            // 1) インスタンスの準備とリージョンの生成.
            FVIL.Data.CFviRegion region = new FVIL.Data.CFviRegion(new FVIL.Data.CFviEllipse(5.0, 4.0, 3.0, 2.0, 0.0 ));

            // E) 生成されたリージョンの保存.
            region.Save(Defs.ResultDir + "\\RegionEllipse_ctor.png");
        }
        /// <summary>
        /// [リージョン構造クラス]
        /// リージョンの生成 (楕円形)
        /// </summary>
        [FvPluginExecute]
        public void Ellipse_Create()
        {
            // 1) インスタンスの準備.
            FVIL.Data.CFviRegion region = new FVIL.Data.CFviRegion();

            // 2) リージョンの生成.
            region.Create(new FVIL.Data.CFviEllipse(5.0, 4.0, 3.0, 2.0, 0.0));

            // E) 生成されたリージョンの保存.
            region.Save(Defs.ResultDir + "\\RegionEllipse_Create.png");
        }        
    }
}

Visual Basic Copy imageCopy
Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Namespace SampleCode.Data
    Public Partial Class Region
        ''' <summary>
        ''' [リージョン構造クラス]
        ''' 初期値指定コンストラクタ (楕円形)
        ''' </summary>
        <FvPluginExecute> _
        Public Sub Ellipse_ctor()
            ' 1) インスタンスの準備とリージョンの生成.
            Dim region As New FVIL.Data.CFviRegion(New FVIL.Data.CFviEllipse(5.0, 4.0, 3.0, 2.0, 0.0))

            ' E) 生成されたリージョンの保存.
            region.Save(Defs.ResultDir & "\RegionEllipse_ctor.png")
        End Sub
        ''' <summary>
        ''' [リージョン構造クラス]
        ''' リージョンの生成 (楕円形)
        ''' </summary>
        <FvPluginExecute> _
        Public Sub Ellipse_Create()
            ' 1) インスタンスの準備.
            Dim region As New FVIL.Data.CFviRegion()

            ' 2) リージョンの生成.
            region.Create(New FVIL.Data.CFviEllipse(5.0, 4.0, 3.0, 2.0, 0.0))

            ' E) 生成されたリージョンの保存.
            region.Save(Defs.ResultDir & "\RegionEllipse_Create.png")
        End Sub
    End Class
End Namespace

Exceptions

ExceptionCondition
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also