Skip to content
This SDK only works with devices released within the past 3 years. We regularly optimize and update the SDK to ensure compatibility and performance. We do not guarantee compatibility or provide technical support for devices older than 3 years.

# NET_SDK_SEARCH_IMAGE_BY_IMAGE

### Structure Definition

C++C#

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    typedef struct _net_sdk_search_image_by_image_
    {
        unsigned int pageIndex;
        unsigned int pageSize;
        unsigned int similarity;
        unsigned int resultCountLimit;
        DD_TIME_EX startTime;
        DD_TIME_EX endTime;
        unsigned int searchType;
        struct
        {
            unsigned int itemId;
        } sfaceFeatures;
        NET_SDK_FACE_IMG_INFO_CH sfaceImgs;
        struct
        {
            unsigned int groupsId;
        } sfaceFeatureGroups;
        struct
        {
            unsigned int isContainRecognized;
            unsigned int isContainNotRecognized;
            unsigned int groupsId;
        } srecognizedFilter;
        struct
        {
            unsigned int imgWidth;
            unsigned int imgHeight;
            unsigned int imgLen;
            unsigned char* imgData;
        } sfaceImgData;
    } NET_SDK_SEARCH_IMAGE_BY_IMAGE;

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    [StructLayout(LayoutKind.Sequential, Pack = 4)]
    public struct NET_SDK_SEARCH_IMAGE_BY_IMAGE
    {
        public UInt32 pageIndex;
        public UInt32 pageSize;
        public UInt32 similarity;
        public UInt32 resultCountLimit;
        public DD_TIME_EX startTime;
        public DD_TIME_EX endTime;
        public UInt32 searchType;
        public struct NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceFeatures
        {
            public UInt32 itemId;
        }
        public NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceFeatures sfaceFeatures;
        public NET_SDK_FACE_IMG_INFO_CH sfaceImgs;
        public struct NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceFeatureGroups
        {
            public UInt32 groupsId;
        }
        public NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceFeatureGroups sfaceFeatureGroups;
        public struct NET_SDK_SEARCH_IMAGE_BY_IMAGE_srecognizedFilter
        {
            public UInt32 isContainRecognized;
            public UInt32 isContainNotRecognized;
            public UInt32 groupsId;
        }
        public NET_SDK_SEARCH_IMAGE_BY_IMAGE_srecognizedFilter srecognizedFilter;
        public struct NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceImgData
        {
            public UInt32 imgWidth;
            public UInt32 imgHeight;
            public UInt32 imgLen;
            public IntPtr imgData;
        }
        public NET_SDK_SEARCH_IMAGE_BY_IMAGE_sfaceImgData sfaceImgData;
    }

### Function Description

Search image by image structure.

### Member Description

Member | Type | Remark
--- | --- | ---
pageIndex | unsigned int | The page number of the query.
pageSize | unsigned int | Quantity per page.
similarity | unsigned int | Similarity.
resultCountLimit | unsigned int | Limit the number of results.
startTime | `DD_TIME_EX` | Start time.
endTime | `DD_TIME_EX` | End time.
searchType | unsigned int | Search type, refer to `NET_SDK_SEARCH_IMAGE_BY_IMAGE_TYPE`.
sfaceFeatures |
    1
    2
    3
    4
    struct
    {
        unsigned int itemId;            // Target ID
    } sfaceFeatures;
| Face features, when searchType is SEARCH_IMAGE_BY_FACE_FEATURES.
sfaceImgs | `NET_SDK_FACE_IMG_INFO_CH` | Face images, when searchType is SEARCH_IMAGE_BY_FACE_FEATURE_GROUPS.
sfaceFeatureGroups |
    1
    2
    3
    4
    struct
    {
        unsigned int groupsId; // Face group ID.
    } sfaceFeatureGroups;
| Face Group
srecognizedFilter |
    1
    2
    3
    4
    5
    6
    struct
    {
        unsigned int isContainRecognized;    // Whether to include recognized ones.
        unsigned int isContainNotRecognized; // Whether to include unrecognized ones.
        unsigned int groupsId;               // Face group ID.
    } srecognizedFilter;
| Identify the filter.
sfaceImgData |
    1
    2
    3
    4
    5
    6
    7
    struct
    {
        unsigned int imgWidth;  // Image width.
        unsigned int imgHeight; // Image height.
        unsigned int imgLen;    // Image data length.
        unsigned char* imgData; // Image data.
    } sfaceImgData;
| Face image data, when searchType is SEARCH_IMAGE_BY_FACE_IMAGE_DATA.

Error Code