円の接線の検出

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

Syntax

C#
public static CFviLine TangentLine(
	CFviPoint point,
	CFviCircle circle
)
Visual Basic
Public Shared Function TangentLine ( 
	point As CFviPoint,
	circle As CFviCircle
) As CFviLine

Parameters

point
Type: FVIL.Data..::..CFviPoint
円上の点
circle
Type: FVIL.Data..::..CFviCircle
円

Return Value

Type: CFviLine
円上の点における接線を求めます。 円上の点の指定は、厳密には整数型の指定では誤差が出てしまいます。 よって本関数では、誤差を四捨五入して１画素未満であれば円の方程式により正しい円上の点を導きだし、 その点上での接線の方程式を求めます。

正常に実行できなかった場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値ErrorCode メンバ内容
51FVIL.ErrorCode.LICENSE_ERROR ライセンスキーが見つからない為、実行できません。 または、 FVIL._SetUp.InitVisionLibrary が実行されていません。
11FVIL.ErrorCode.INVALID_PARAMETERパラメータに誤りがあります。
29FVIL.ErrorCode.NOT_CALCULABLE計算不可能です。

Examples

C# Copy imageCopy
//    $Revision: 1.3 $

using System;
using System.Collections.Generic;
using System.Text;
using System.Drawing;
using fvalgcli;    // FvPluginXXXX attribute requires fvalgcli

namespace User.SampleCode
{
    public partial class Caliper
    {
        /// <summary>
        /// 円の接線の検出の測定.
        /// </summary>
        /// <remarks>
        /// FVIL.Caliper.Function.TangentLine(FVIL.Data.CFviPoint,FVIL.Data.CFviCircle)
        /// </remarks>
        [FvPluginExecute]
        public void TangentLine()
        {
            // 1) 円と点の生成.
            FVIL.Data.CFviPoint point = new FVIL.Data.CFviPoint(220, 120);
            FVIL.Data.CFviCircle circle = new FVIL.Data.CFviCircle(140, 120, 80);

            // 2) 計測実行.
            FVIL.Data.CFviLine line = FVIL.Caliper.Function.TangentLine(point, circle);

            // 確認用.
            {
                // 画像、描画表示クラス、オーバーレイのインスタンスの生成.
                FVIL.Data.CFviImage image = new FVIL.Data.CFviImage(320, 240, FVIL.ImageType.UC8, 1);
                FVIL.GDI.CFviDisplay display = new FVIL.GDI.CFviDisplay();
                FVIL.GDI.CFviOverlay overlay = new FVIL.GDI.CFviOverlay();

                {
                    // 描画図形の生成.
                    // 入力点.
                    FVIL.GDI.CFviGdiPoint gpoint1 = new FVIL.GDI.CFviGdiPoint(point);
                    gpoint1.Pen.Color = Color.Green;
                    gpoint1.Pen.Width = 4;

                    // 補助点(円の中心)
                    FVIL.GDI.CFviGdiPoint gpoint2 = new FVIL.GDI.CFviGdiPoint(circle.Center);
                    gpoint2.Pen.Color = Color.Green;
                    gpoint2.Pen.Width = 4;

                    // 入力円.
                    FVIL.GDI.CFviGdiCircle gcircle = new FVIL.GDI.CFviGdiCircle( circle );
                    gcircle.Pen.Color = Color.Green;
                    gcircle.Pen.Width = 1;
                    gcircle.Pen.Style = FVIL.GDI.PenStyle.Solid;

                    // 結果線.
                    FVIL.GDI.CFviGdiLine gline1 = new FVIL.GDI.CFviGdiLine( line );
                    gline1.Pen.Color = Color.Red;
                    gline1.Pen.Width = 1;
                    gline1.Pen.Style = FVIL.GDI.PenStyle.Solid;

                    // 補助線.
                    FVIL.Data.CFviLine horz = FVIL.Caliper.Function.VerticalLine(point, line);
                    FVIL.Data.CFviLineSegment horz_part = new FVIL.Data.CFviLineSegment(circle.Center, FVIL.Caliper.Function.CrossPoint(line, horz));
                    FVIL.GDI.CFviGdiLineSegment gline2 = new FVIL.GDI.CFviGdiLineSegment(horz_part);
                    gline2.Pen.Color = Color.Green;
                    gline2.Pen.Width = 1;
                    gline2.Pen.Style = FVIL.GDI.PenStyle.Dot;

                    // 描画図形の追加.
                    overlay.Figures.Add(gpoint1);
                    overlay.Figures.Add(gpoint2);
                    overlay.Figures.Add(gcircle);
                    overlay.Figures.Add(gline1);
                    overlay.Figures.Add(gline2);
                    overlay.Enable = true;

                }

                // 画像表示クラスへの追加.
                display.Overlays.Add(overlay);
                display.Image = image;
                display.DisplayRect = image.Window;

                // 描画イメージの保存.
                FVIL.Data.CFviImage dstimage = new FVIL.Data.CFviImage();
                display.SaveImage(dstimage);
                FVIL.File.Function.SaveImageFile(Defs.ResultDir + "/Caliper.TangentLine.png", dstimage);
            }
        }
    }
}

Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports System.Drawing
Imports fvalgcli
' FvPluginXXXX attribute requires fvalgcli
Namespace SampleCode
    Public Partial Class Caliper
        ''' <summary>
        ''' 円の接線の検出の測定.
        ''' </summary>
        ''' <remarks>
        ''' FVIL.Caliper.Function.TangentLine(FVIL.Data.CFviPoint,FVIL.Data.CFviCircle)
        ''' </remarks>
        <FvPluginExecute> _
        Public Sub TangentLine()
            ' 1) 円と点の生成.
            Dim point As New FVIL.Data.CFviPoint(220, 120)
            Dim circle As New FVIL.Data.CFviCircle(140, 120, 80)

            ' 2) 計測実行.
            Dim line As FVIL.Data.CFviLine = FVIL.Caliper.[Function].TangentLine(point, circle)

            ' 確認用.
            If True Then
                ' 画像、描画表示クラス、オーバーレイのインスタンスの生成.
                Dim image As New FVIL.Data.CFviImage(320, 240, FVIL.ImageType.UC8, 1)
                Dim display As New FVIL.GDI.CFviDisplay()
                Dim overlay As New FVIL.GDI.CFviOverlay()

                If True Then
                    ' 描画図形の生成.
                    ' 入力点.
                    Dim gpoint1 As New FVIL.GDI.CFviGdiPoint(point)
                    gpoint1.Pen.Color = Color.Green
                    gpoint1.Pen.Width = 4

                    ' 補助点(円の中心)
                    Dim gpoint2 As New FVIL.GDI.CFviGdiPoint(circle.Center)
                    gpoint2.Pen.Color = Color.Green
                    gpoint2.Pen.Width = 4

                    ' 入力円.
                    Dim gcircle As New FVIL.GDI.CFviGdiCircle(circle)
                    gcircle.Pen.Color = Color.Green
                    gcircle.Pen.Width = 1
                    gcircle.Pen.Style = FVIL.GDI.PenStyle.Solid

                    ' 結果線.
                    Dim gline1 As New FVIL.GDI.CFviGdiLine(line)
                    gline1.Pen.Color = Color.Red
                    gline1.Pen.Width = 1
                    gline1.Pen.Style = FVIL.GDI.PenStyle.Solid

                    ' 補助線.
                    Dim horz As FVIL.Data.CFviLine = FVIL.Caliper.[Function].VerticalLine(point, line)
                    Dim horz_part As New FVIL.Data.CFviLineSegment(circle.Center, FVIL.Caliper.[Function].CrossPoint(line, horz))
                    Dim gline2 As New FVIL.GDI.CFviGdiLineSegment(horz_part)
                    gline2.Pen.Color = Color.Green
                    gline2.Pen.Width = 1
                    gline2.Pen.Style = FVIL.GDI.PenStyle.Dot

                    ' 描画図形の追加.
                    overlay.Figures.Add(gpoint1)
                    overlay.Figures.Add(gpoint2)
                    overlay.Figures.Add(gcircle)
                    overlay.Figures.Add(gline1)
                    overlay.Figures.Add(gline2)
                    overlay.Enable = True

                End If

                ' 画像表示クラスへの追加.
                display.Overlays.Add(overlay)
                display.Image = image
                display.DisplayRect = image.Window

                ' 描画イメージの保存.
                Dim dstimage As New FVIL.Data.CFviImage()
                display.SaveImage(dstimage)
                FVIL.File.[Function].SaveImageFile(Defs.ResultDir & "/Caliper.TangentLine.png", dstimage)
            End If
        End Sub
    End Class
End Namespace

Exceptions

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

See Also