vx_tutorial_image_crop_roi.c

Go to the documentation of this file.

/*
*
* Copyright (c) 2017 Texas Instruments Incorporated
*
* All rights reserved not granted herein.
*
* Limited License.
*
* Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive
* license under copyrights and patents it now or hereafter owns or controls to make,
* have made, use, import, offer to sell and sell ("Utilize") this software subject to the
* terms herein.  With respect to the foregoing patent license, such license is granted
* solely to the extent that any such patent is necessary to Utilize the software alone.
* The patent license shall not apply to any combinations which include this software,
* other than combinations with devices manufactured by or for TI ("TI Devices").
* No hardware patent is licensed hereunder.
*
* Redistributions must preserve existing copyright notices and reproduce this license
* (including the above copyright notice and the disclaimer and (if applicable) source
* code license limitations below) in the documentation and/or other materials provided
* with the distribution
*
* Redistribution and use in binary form, without modification, are permitted provided
* that the following conditions are met:
*
* *       No reverse engineering, decompilation, or disassembly of this software is
* permitted with respect to any software provided in binary form.
*
* *       any redistribution and use are licensed by TI for use only with TI Devices.
*
* *       Nothing shall obligate TI to provide you with source code for the software
* licensed and provided to you in object code.
*
* If software source code is provided to you, modification and redistribution of the
* source code are permitted provided that the following conditions are met:
*
* *       any redistribution and use of the source code, including any resulting derivative
* works, are licensed by TI for use only with TI Devices.
*
* *       any redistribution and use of any object code compiled from the source code
* and any resulting derivative works, are licensed by TI for use only with TI Devices.
*
* Neither the name of Texas Instruments Incorporated nor the names of its suppliers
*
* may be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* DISCLAIMER.
*
* THIS SOFTWARE IS PROVIDED BY TI AND TI'S LICENSORS "AS IS" AND ANY EXPRESS
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL TI AND TI'S LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/



#include <stdio.h>
#include <VX/vx.h>
#include <utility.h>

#define IN_FILE_NAME       "${VX_TEST_DATA_PATH}/colors.bmp"

#define OUT_FILE_NAME      "${VX_TEST_DATA_PATH}/vx_tutorial_image_crop_roi.bmp"

vx_image  load_image_from_handle_from_file(
            vx_context context,
            char *filename,
            vx_bool convert_to_gray_scale,
            tivx_utils_bmp_image_params_t *imgParams);

void vx_tutorial_image_crop_roi()
{
    vx_context context;
    vx_image image, roi_image;
    vx_uint32 width, height;
    vx_rectangle_t rect;
    tivx_utils_bmp_image_params_t   imgParams;
    printf(" vx_tutorial_image_crop_roi: Tutorial Started !!! \n");

    context = vxCreateContext();
    printf(" Loading file %s ...\n", IN_FILE_NAME);

    image = load_image_from_handle_from_file(context, IN_FILE_NAME, (vx_bool)vx_false_e, &imgParams);

    vxSetReferenceName((vx_reference)image, "ORIGINAL");

    show_image_attributes(image);
    vxQueryImage(image, (vx_enum)VX_IMAGE_WIDTH, &width, sizeof(vx_uint32));
    vxQueryImage(image, (vx_enum)VX_IMAGE_HEIGHT, &height, sizeof(vx_uint32));

    rect.start_x = width/4;
    rect.start_y = height/4;
    rect.end_x   = rect.start_x + width/2;
    rect.end_y   = rect.start_y + height/2;

    roi_image = vxCreateImageFromROI(image, &rect);

    vxSetReferenceName((vx_reference)roi_image, "CROP_ROI");

    show_image_attributes(roi_image);
    printf(" Saving to file %s ...\n", OUT_FILE_NAME);

    tivx_utils_save_vximage_to_bmpfile(OUT_FILE_NAME, roi_image);
    vxReleaseImage(&roi_image);
    vxReleaseImage(&image);
    /* now it is safe to release the memory passed to the image
     * NOTE: "roi_image" also holds a reference to the memory since
     *       its created from the "image"
     *       Hence memory passed to "image" should be freed after "roi_image"
     *       is released
     */
    tivx_utils_bmp_read_release(&imgParams);

    vxReleaseContext(&context);
    printf(" vx_tutorial_image_crop_roi: Tutorial Done !!! \n");
    printf(" \n");
}

vx_image  load_image_from_handle_from_file(
            vx_context context,
            char *filename,
            vx_bool convert_to_gray_scale,
            tivx_utils_bmp_image_params_t *imgParams)
{
    char outFilePath[TIOVX_UTILS_MAXPATHLENGTH];
    vx_image image = NULL;
    uint32_t width, height, stride;
    vx_df_image df;
    vx_status vxStatus;
    int32_t     status;
    void *data_ptr;
    int32_t dcn = (convert_to_gray_scale != (vx_bool)(vx_bool)vx_false_e) ? 1 : -1;

    status = tivx_utils_expand_file_path(filename, outFilePath);

    status = tivx_utils_bmp_read(outFilePath, dcn, imgParams);

    if (status == 0)
    {
        vxStatus = (vx_status)VX_SUCCESS;
        width    = imgParams->width;
        height   = imgParams->height;
        stride   = imgParams->stride_y;
        df       = imgParams->format;
        data_ptr = imgParams->data;
    }
    else
    {
        vxStatus = (vx_status)VX_FAILURE;
    }

    if(vxStatus == (vx_status)VX_SUCCESS)
    {
        vx_imagepatch_addressing_t image_addr[1];
        void *ptrs[1];
        uint32_t bpp;

        if( df == (vx_df_image)VX_DF_IMAGE_U8 )
            bpp = 1;
        else
        if( df == (vx_df_image)VX_DF_IMAGE_RGB )
            bpp = 3;
        else
        if( df == (vx_df_image)VX_DF_IMAGE_RGBX )
            bpp = 4;
        else
            bpp = 1; /* it should not reach here for BMP files */

        image_addr[0].dim_x = width;
        image_addr[0].dim_y = height;
        image_addr[0].stride_x = bpp;
        image_addr[0].stride_y = stride;
        image_addr[0].scale_x = VX_SCALE_UNITY;
        image_addr[0].scale_y = VX_SCALE_UNITY;
        image_addr[0].step_x = 1;
        image_addr[0].step_y = 1;

        ptrs[0] = data_ptr;

        image = vxCreateImageFromHandle(context, df, image_addr, ptrs, (vx_enum)VX_MEMORY_TYPE_HOST);
        /* MUST not free memory that is passed to vxCreateImageFromHandle, until
         * that memory ptr is swapped out from the image
         * or the image handle is released
         */
        /* bmp_file_read_release(bmp_file_context); */
    }
    return image;
}