🤖 AIによる機械翻訳（非公式） — これは OpenCV 5.0.0 公式リファレンス（英語）を AI (Claude) で自動翻訳したものです。訳に誤りを含む場合があります。正確な情報は 公式英語版（原文） を参照してください。
Package org.opencv.face

クラス Face

  • public class Face
extends java.lang.Object

    • コンストラクタの要約

      コンストラクタ
      Constructor Description
      Face()  

    • メソッドの要約

      すべてのメソッド 静的メソッド 具象メソッド
      Modifier and Type Method Description
      static Facemark createFacemarkAAM()  
      static Facemark createFacemarkKazemi()  
      static Facemark createFacemarkLBF()  
      static void drawFacemarks​(Mat image, Mat points)
      Utility to draw the detected facial landmark points
      static void drawFacemarks​(Mat image, Mat points, Scalar color)
      Utility to draw the detected facial landmark points
      static boolean getFacesHAAR​(Mat image, Mat faces, java.lang.String face_cascade_name)
      Default face detector This function is mainly utilized by the implementation of a Facemark Algorithm.
      static boolean loadDatasetList​(java.lang.String imageList, java.lang.String annotationList, java.util.List<java.lang.String> images, java.util.List<java.lang.String> annotations)
      A utility to load list of paths to training image and annotation file.
      static boolean loadFacePoints​(java.lang.String filename, Mat points)
      A utility to load facial landmark information from a given file.
      static boolean loadFacePoints​(java.lang.String filename, Mat points, float offset)
      A utility to load facial landmark information from a given file.
      static boolean loadTrainingData​(java.lang.String imageList, java.lang.String groundTruth, java.util.List<java.lang.String> images, Mat facePoints)
      A utility to load facial landmark information from the dataset.
      static boolean loadTrainingData​(java.lang.String imageList, java.lang.String groundTruth, java.util.List<java.lang.String> images, Mat facePoints, float offset)
      A utility to load facial landmark information from the dataset.
      static boolean loadTrainingData​(java.lang.String filename, java.util.List<java.lang.String> images, Mat facePoints)
      A utility to load facial landmark dataset from a single file.
      static boolean loadTrainingData​(java.lang.String filename, java.util.List<java.lang.String> images, Mat facePoints, char delim)
      A utility to load facial landmark dataset from a single file.
      static boolean loadTrainingData​(java.lang.String filename, java.util.List<java.lang.String> images, Mat facePoints, char delim, float offset)
      A utility to load facial landmark dataset from a single file.
      static boolean loadTrainingData​(java.util.List<java.lang.String> filename, java.util.List<MatOfPoint2f> trainlandmarks, java.util.List<java.lang.String> trainimages)
      This function extracts the data for training from .txt files which contains the corresponding image name and landmarks.

      • クラス java.lang.Object から継承したメソッド

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • コンストラクタの詳細

      • Face

        public Face()

    • メソッドの詳細

      • createFacemarkAAM

        public static Facemark createFacemarkAAM()

      • createFacemarkLBF

        public static Facemark createFacemarkLBF()

      • createFacemarkKazemi

        public static Facemark createFacemarkKazemi()

      • getFacesHAAR

        public static boolean getFacesHAAR​(Mat image,
                                   Mat faces,
                                   java.lang.String face_cascade_name)
        Default face detector This function is mainly utilized by the implementation of a Facemark Algorithm. End users are advised to use function Facemark::getFaces which can be manually defined and circumvented to the algorithm by Facemark::setFaceDetector.
        引数:
        image - 処理対象の入力画像。
        faces - 検出された顔の関心領域を表す関数の出力。各顔は cv::Rect コンテナに格納される。<B>使用例</B> std::vector<cv::Rect> faces; CParams params("haarcascade_frontalface_alt.xml"); cv::face::getFaces(frame, faces, &params); for(int j=0;j<faces.size();j++){ cv::rectangle(frame, faces[j], cv::Scalar(255,0,255)); } cv::imshow("detection", frame);
        face_cascade_name - 自動生成
        戻り値:
        自動生成

      • loadDatasetList

        public static boolean loadDatasetList​(java.lang.String imageList,
                                      java.lang.String annotationList,
                                      java.util.List<java.lang.String> images,
                                      java.util.List<java.lang.String> annotations)
        A utility to load list of paths to training image and annotation file.
        引数:
        imageList - 学習用画像のパスを記載したファイル。
        annotationList - 学習用アノテーションのパスを記載したファイル。
        images - 読み込まれた学習用画像のパス。
        annotations - 読み込まれたアノテーションファイルのパス。使用例: String imageFiles = "images_path.txt"; String ptsFiles = "annotations_path.txt"; std::vector<String> images_train; std::vector<String> landmarks_train; loadDatasetList(imageFiles,ptsFiles,images_train,landmarks_train);
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.lang.String filename,
                                       java.util.List<java.lang.String> images,
                                       Mat facePoints,
                                       char delim,
                                       float offset)
        A utility to load facial landmark dataset from a single file.
        引数:
        filename - データセット情報を含むファイルのファイル名。各行には画像のファイル名に続いて、顔のランドマーク点の x と y の値の組がスペース区切りで記述される。例 /home/user/ibug/image_003_1.jpg 336.820955 240.864510 334.238298 260.922709 335.266918 ... /home/user/ibug/image_005_1.jpg 376.158428 230.845712 376.736984 254.924635 383.265403 ...
        images - 各要素がデータセット内の画像のファイル名を表すベクトル。メモリ節約のため、画像はデフォルトでは読み込まれない。
        facePoints - すべての学習データについて読み込まれたランドマーク点。
        delim - 各要素間の区切り文字。デフォルト値は空白文字。
        offset - 読み込んだ点を調整するためのオフセット値。<B>使用例</B> cv::String imageFiles = "../data/images_train.txt"; cv::String ptsFiles = "../data/points_train.txt"; std::vector<String> images; std::vector<std::vector<Point2f> > facePoints; loadTrainingData(imageFiles, ptsFiles, images, facePoints, 0.0f);
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.lang.String filename,
                                       java.util.List<java.lang.String> images,
                                       Mat facePoints,
                                       char delim)
        A utility to load facial landmark dataset from a single file.
        引数:
        filename - データセット情報を含むファイルのファイル名。各行には画像のファイル名に続いて、顔のランドマーク点の x と y の値の組がスペース区切りで記述される。例 /home/user/ibug/image_003_1.jpg 336.820955 240.864510 334.238298 260.922709 335.266918 ... /home/user/ibug/image_005_1.jpg 376.158428 230.845712 376.736984 254.924635 383.265403 ...
        images - 各要素がデータセット内の画像のファイル名を表すベクトル。メモリ節約のため、画像はデフォルトでは読み込まれない。
        facePoints - すべての学習データについて読み込まれたランドマーク点。
        delim - 各要素間の区切り文字。デフォルト値は空白文字。<B>使用例</B> cv::String imageFiles = "../data/images_train.txt"; cv::String ptsFiles = "../data/points_train.txt"; std::vector<String> images; std::vector<std::vector<Point2f> > facePoints; loadTrainingData(imageFiles, ptsFiles, images, facePoints, 0.0f);
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.lang.String filename,
                                       java.util.List<java.lang.String> images,
                                       Mat facePoints)
        A utility to load facial landmark dataset from a single file.
        引数:
        filename - データセット情報を含むファイルのファイル名。各行には画像のファイル名に続いて、顔のランドマーク点の x と y の値の組がスペース区切りで記述される。例 /home/user/ibug/image_003_1.jpg 336.820955 240.864510 334.238298 260.922709 335.266918 ... /home/user/ibug/image_005_1.jpg 376.158428 230.845712 376.736984 254.924635 383.265403 ...
        images - 各要素がデータセット内の画像のファイル名を表すベクトル。メモリ節約のため、画像はデフォルトでは読み込まれない。
        facePoints - すべての学習データについて読み込まれたランドマーク点。<B>使用例</B> cv::String imageFiles = "../data/images_train.txt"; cv::String ptsFiles = "../data/points_train.txt"; std::vector<String> images; std::vector<std::vector<Point2f> > facePoints; loadTrainingData(imageFiles, ptsFiles, images, facePoints, 0.0f);
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.lang.String imageList,
                                       java.lang.String groundTruth,
                                       java.util.List<java.lang.String> images,
                                       Mat facePoints,
                                       float offset)
        A utility to load facial landmark information from the dataset.
        引数:
        imageList - 学習データセット内の画像ファイル名の一覧を含むファイル。
        groundTruth - ランドマーク点の情報が格納されたファイルの一覧を含むファイル。各ファイルの内容は標準形式に従う必要がある (face::loadFacePoints を参照)。
        images - 各要素がデータセット内の画像のファイル名を表すベクトル。メモリ節約のため、画像はデフォルトでは読み込まれない。
        facePoints - すべての学習データについて読み込まれたランドマーク点。
        offset - 読み込んだ点を調整するためのオフセット値。<B>使用例</B> cv::String imageFiles = "../data/images_train.txt"; cv::String ptsFiles = "../data/points_train.txt"; std::vector<String> images; std::vector<std::vector<Point2f> > facePoints; loadTrainingData(imageFiles, ptsFiles, images, facePoints, 0.0f); images_train.txt の内容の例 /home/user/ibug/image_003_1.jpg /home/user/ibug/image_004_1.jpg /home/user/ibug/image_005_1.jpg /home/user/ibug/image_006.jpg points_train.txt の内容の例 /home/user/ibug/image_003_1.pts /home/user/ibug/image_004_1.pts /home/user/ibug/image_005_1.pts /home/user/ibug/image_006.pts
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.lang.String imageList,
                                       java.lang.String groundTruth,
                                       java.util.List<java.lang.String> images,
                                       Mat facePoints)
        A utility to load facial landmark information from the dataset.
        引数:
        imageList - 学習データセット内の画像ファイル名の一覧を含むファイル。
        groundTruth - ランドマーク点の情報が格納されたファイルの一覧を含むファイル。各ファイルの内容は標準形式に従う必要がある (face::loadFacePoints を参照)。
        images - 各要素がデータセット内の画像のファイル名を表すベクトル。メモリ節約のため、画像はデフォルトでは読み込まれない。
        facePoints - すべての学習データについて読み込まれたランドマーク点。<B>使用例</B> cv::String imageFiles = "../data/images_train.txt"; cv::String ptsFiles = "../data/points_train.txt"; std::vector<String> images; std::vector<std::vector<Point2f> > facePoints; loadTrainingData(imageFiles, ptsFiles, images, facePoints, 0.0f); images_train.txt の内容の例 /home/user/ibug/image_003_1.jpg /home/user/ibug/image_004_1.jpg /home/user/ibug/image_005_1.jpg /home/user/ibug/image_006.jpg points_train.txt の内容の例 /home/user/ibug/image_003_1.pts /home/user/ibug/image_004_1.pts /home/user/ibug/image_005_1.pts /home/user/ibug/image_006.pts
        戻り値:
        自動生成

      • loadTrainingData

        public static boolean loadTrainingData​(java.util.List<java.lang.String> filename,
                                       java.util.List<MatOfPoint2f> trainlandmarks,
                                       java.util.List<java.lang.String> trainimages)
        This function extracts the data for training from .txt files which contains the corresponding image name and landmarks. The first file in each file should give the path of the image whose landmarks are being described in the file. Then in the subsequent lines there should be coordinates of the landmarks in the image i.e each line should be of the form x,y where x represents the x coordinate of the landmark and y represents the y coordinate of the landmark. For reference you can see the files as provided in the <a href="http://www.ifp.illinois.edu/~vuongle2/helen/">HELEN dataset</a>
        引数:
        filename - .txt ファイルの名前を含む cv::String 型のベクトル。
        trainlandmarks - すべての画像の形状またはランドマークを格納する cv::Point2f 型のベクトル。
        trainimages - ランドマークが追跡される画像の名前を格納する cv::String 型のベクトル。
        戻り値:
        ブール値。データの読み込みに成功した場合は true を、それ以外の場合は false を返す

      • loadFacePoints

        public static boolean loadFacePoints​(java.lang.String filename,
                                     Mat points,
                                     float offset)
        A utility to load facial landmark information from a given file.
        引数:
        filename - 顔のランドマークデータを含むファイルのファイル名。
        points - 読み込まれた顔のランドマーク点。
        offset - 読み込んだ点を調整するためのオフセット値。<B>使用例</B> std::vector<Point2f> points; face::loadFacePoints("filename.txt", points, 0.0f); アノテーションファイルはデフォルト形式に従う必要があり、その形式は次のとおりである version: 1 n_points: 68 { 212.716603 499.771793 230.232816 566.290071 ... } ここで n_points は対象とする点の数で、各点は x と y の位置として表される。
        戻り値:
        自動生成

      • loadFacePoints

        public static boolean loadFacePoints​(java.lang.String filename,
                                     Mat points)
        A utility to load facial landmark information from a given file.
        引数:
        filename - 顔のランドマークデータを含むファイルのファイル名。
        points - 読み込まれた顔のランドマーク点。<B>使用例</B> std::vector<Point2f> points; face::loadFacePoints("filename.txt", points, 0.0f); アノテーションファイルはデフォルト形式に従う必要があり、その形式は次のとおりである version: 1 n_points: 68 { 212.716603 499.771793 230.232816 566.290071 ... } ここで n_points は対象とする点の数で、各点は x と y の位置として表される。
        戻り値:
        自動生成

      • drawFacemarks

        public static void drawFacemarks​(Mat image,
                                 Mat points,
                                 Scalar color)
        Utility to draw the detected facial landmark points
        引数:
        image - 処理対象の入力画像。
        points - 描画される点のデータを含む。
        color - cv::Scalar で表される BGR 形式の点の色。<B>使用例</B> std::vector<Rect> faces; std::vector<std::vector<Point2f> > landmarks; facemark->getFaces(img, faces); facemark->fit(img, faces, landmarks); for(int j=0;j<rects.size();j++){ face::drawFacemarks(frame, landmarks[j], Scalar(0,0,255)); }

      • drawFacemarks

        public static void drawFacemarks​(Mat image,
                                 Mat points)
        Utility to draw the detected facial landmark points
        引数:
        image - 処理対象の入力画像。
        points - 描画される点のデータを含む。<B>使用例</B> std::vector<Rect> faces; std::vector<std::vector<Point2f> > landmarks; facemark->getFaces(img, faces); facemark->fit(img, faces, landmarks); for(int j=0;j<rects.size();j++){ face::drawFacemarks(frame, landmarks[j], Scalar(0,0,255)); }