距離の算出(点と直線)

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

Syntax

C#
public static double Distance(
	CFviPoint point,
	CFviLine line
)
Visual Basic
Public Shared Function Distance ( 
	point As CFviPoint,
	line As CFviLine
) As Double

Parameters

point
Type: FVIL.Data..::..CFviPoint
座標点
line
Type: FVIL.Data..::..CFviLine
直線

Return Value

Type: Double
指定された点から直線までの距離を算出します。 指定点と直線(ax+by+c=0)の距離(h)を以下の公式によって求めます。

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

エラーコード：

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

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.Distance(FVIL.Data.CFviPoint,FVIL.Data.CFviLine)
        /// </remarks>
        [FvPluginExecute]
        public void Distance_point_line()
        {
            // 1) 点と直線の生成.
            FVIL.Data.CFviPoint point = new FVIL.Data.CFviPoint(140, 140); 
            FVIL.Data.CFviLineSegment ls = new FVIL.Data.CFviLineSegment(140, 220, 220, 140);
            FVIL.Data.CFviLine line = ls.ToCFviLine();

            // 2) 計測実行.
            double dist = FVIL.Caliper.Function.Distance(point, line);

            // 確認用.
            {
                // 画像、描画表示クラス、オーバーレイのインスタンスの生成.
                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();

                {
                    // 描画図形の生成.
                    // 結果(距離)のGDI文字列の生成.
                    string str_dist = String.Format("{0:F}", (int)(dist));
                    FVIL.GDI.CFviGdiString gStrDist = new FVIL.GDI.CFviGdiString(str_dist);
                    gStrDist.Position = FVIL.Caliper.Function.CenterPoint(new FVIL.Data.CFviPoint(180, 180), point);
                    gStrDist.Align = FVIL.GDI.TextAlign.Center;
                    gStrDist.Angle = FVIL.Caliper.Function.PolarCoordinatesAngle(point);
                    gStrDist.Font.Weight = FVIL.GDI.FontWeight.Thin;    // 文字の太さ.
                    gStrDist.Font.Height = 12;    // 文字の高さ.
                    gStrDist.Font.Width = 6;    // 文字の幅.
                    gStrDist.Color = Color.Red;

                    // 入力線.
                    FVIL.GDI.CFviGdiLine gline1 = new FVIL.GDI.CFviGdiLine(line);
                    gline1.Pen.Color = Color.Green;
                    gline1.Pen.Width = 1;
                    gline1.Pen.Style = FVIL.GDI.PenStyle.Solid;

                    // 補助線の生成.
                    FVIL.Data.CFviLineSegment horz_part = new FVIL.Data.CFviLineSegment(point, new FVIL.Data.CFviPoint(180, 180));
                    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;

                    // 入力点.
                    FVIL.GDI.CFviGdiPoint gpoint1 = new FVIL.GDI.CFviGdiPoint(point);
                    gpoint1.Pen.Color = Color.Green;
                    gpoint1.Pen.Width = 4;

                    // 描画図形の追加.
                    overlay.Figures.Add(gStrDist);
                    overlay.Figures.Add(gline1);
                    overlay.Figures.Add(gline2);
                    overlay.Figures.Add(gpoint1);

                    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.Distance_point_line.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.Distance(FVIL.Data.CFviPoint,FVIL.Data.CFviLine)
        ''' </remarks>
        <FvPluginExecute> _
        Public Sub Distance_point_line()
            ' 1) 点と直線の生成.
            Dim point As New FVIL.Data.CFviPoint(140, 140)
            Dim ls As New FVIL.Data.CFviLineSegment(140, 220, 220, 140)
            Dim line As FVIL.Data.CFviLine = ls.ToCFviLine()

            ' 2) 計測実行.
            Dim dist As Double = FVIL.Caliper.[Function].Distance(point, line)

            ' 確認用.
            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
                    ' 描画図形の生成.
                    ' 結果(距離)のGDI文字列の生成.
                    Dim str_dist As String = [String].Format("{0:F}", CInt(Math.Truncate(dist)))
                    Dim gStrDist As New FVIL.GDI.CFviGdiString(str_dist)
                    gStrDist.Position = FVIL.Caliper.[Function].CenterPoint(New FVIL.Data.CFviPoint(180, 180), point)
                    gStrDist.Align = FVIL.GDI.TextAlign.Center
                    gStrDist.Angle = FVIL.Caliper.[Function].PolarCoordinatesAngle(point)
                    gStrDist.Font.Weight = FVIL.GDI.FontWeight.Thin
                    ' 文字の太さ.
                    gStrDist.Font.Height = 12
                    ' 文字の高さ.
                    gStrDist.Font.Width = 6
                    ' 文字の幅.
                    gStrDist.Color = Color.Red

                    ' 入力線.
                    Dim gline1 As New FVIL.GDI.CFviGdiLine(line)
                    gline1.Pen.Color = Color.Green
                    gline1.Pen.Width = 1
                    gline1.Pen.Style = FVIL.GDI.PenStyle.Solid

                    ' 補助線の生成.
                    Dim horz_part As New FVIL.Data.CFviLineSegment(point, New FVIL.Data.CFviPoint(180, 180))
                    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

                    ' 入力点.
                    Dim gpoint1 As New FVIL.GDI.CFviGdiPoint(point)
                    gpoint1.Pen.Color = Color.Green
                    gpoint1.Pen.Width = 4

                    ' 描画図形の追加.
                    overlay.Figures.Add(gStrDist)
                    overlay.Figures.Add(gline1)
                    overlay.Figures.Add(gline2)
                    overlay.Figures.Add(gpoint1)

                    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.Distance_point_line.png", dstimage)
            End If
        End Sub
    End Class
End Namespace

Exceptions

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

See Also