TIOVX User Guide
tivx_utils_file_rd_wr.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (c) 2017 Texas Instruments Incorporated
4  *
5  * All rights reserved not granted herein.
6  *
7  * Limited License.
8  *
9  * Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive
10  * license under copyrights and patents it now or hereafter owns or controls to make,
11  * have made, use, import, offer to sell and sell ("Utilize") this software subject to the
12  * terms herein. With respect to the foregoing patent license, such license is granted
13  * solely to the extent that any such patent is necessary to Utilize the software alone.
14  * The patent license shall not apply to any combinations which include this software,
15  * other than combinations with devices manufactured by or for TI ("TI Devices").
16  * No hardware patent is licensed hereunder.
17  *
18  * Redistributions must preserve existing copyright notices and reproduce this license
19  * (including the above copyright notice and the disclaimer and (if applicable) source
20  * code license limitations below) in the documentation and/or other materials provided
21  * with the distribution
22  *
23  * Redistribution and use in binary form, without modification, are permitted provided
24  * that the following conditions are met:
25  *
26  * * No reverse engineering, decompilation, or disassembly of this software is
27  * permitted with respect to any software provided in binary form.
28  *
29  * * any redistribution and use are licensed by TI for use only with TI Devices.
30  *
31  * * Nothing shall obligate TI to provide you with source code for the software
32  * licensed and provided to you in object code.
33  *
34  * If software source code is provided to you, modification and redistribution of the
35  * source code are permitted provided that the following conditions are met:
36  *
37  * * any redistribution and use of the source code, including any resulting derivative
38  * works, are licensed by TI for use only with TI Devices.
39  *
40  * * any redistribution and use of any object code compiled from the source code
41  * and any resulting derivative works, are licensed by TI for use only with TI Devices.
42  *
43  * Neither the name of Texas Instruments Incorporated nor the names of its suppliers
44  *
45  * may be used to endorse or promote products derived from this software without
46  * specific prior written permission.
47  *
48  * DISCLAIMER.
49  *
50  * THIS SOFTWARE IS PROVIDED BY TI AND TI'S LICENSORS "AS IS" AND ANY EXPRESS
51  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
52  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
53  * IN NO EVENT SHALL TI AND TI'S LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT,
54  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
55  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
56  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
57  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
58  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
59  * OF THE POSSIBILITY OF SUCH DAMAGE.
60  *
61  */
62 
67 #ifndef TIVX_UTILS_FILE_RD_WR_H
68 #define TIVX_UTILS_FILE_RD_WR_H
69 
70 #include <VX/vx.h>
71 
98  char *filename,
99  vx_bool convert_to_gray_scale,
100  uint32_t *width,
101  uint32_t *height,
102  uint32_t *stride,
103  vx_df_image *df,
104  void **data_ptr,
105  void **png_file_context);
106 
121 void tivx_utils_png_file_read_release(void *png_file_context);
122 
138  char *filename,
139  uint32_t width,
140  uint32_t height,
141  uint32_t stride,
142  vx_df_image df,
143  void *data_ptr);
144 
160 vx_image tivx_utils_create_vximage_from_pngfile(vx_context context, char *filename, vx_bool convert_to_gray_scale);
161 
173 
194 vx_status tivx_utils_load_vximage_from_pngfile(vx_image image, char *filename, vx_bool convert_to_gray_scale);
195 
204  const char *filename,
205  vx_bool convert_to_gray_scale,
206  uint32_t *width,
207  uint32_t *height,
208  uint32_t *stride,
209  vx_df_image *df,
210  void **data_ptr,
211  void **png_file_context);
212 
221  const void *buf,
222  uint32_t buf_size,
223  vx_bool convert_to_gray_scale,
224  uint32_t *width,
225  uint32_t *height,
226  uint32_t *stride,
227  vx_df_image *df,
228  void **data_ptr,
229  void **png_file_context);
230 
239 void tivx_utils_bmp_file_read_release(void *png_file_context);
240 
249  const char *filename,
250  uint32_t width,
251  uint32_t height,
252  uint32_t stride,
253  vx_df_image df,
254  void *data_ptr);
255 
263 vx_image tivx_utils_create_vximage_from_bmpfile(vx_context context, const char *filename, vx_bool convert_to_gray_scale);
264 
272 vx_status tivx_utils_save_vximage_to_bmpfile(const char *filename, vx_image image);
273 
281 vx_status tivx_utils_load_vximage_from_bmpfile(vx_image image, char *filename, vx_bool convert_to_gray_scale);
282 
283 
284 #endif
285 
struct _vx_image * vx_image
vx_bool
vx_status tivx_utils_load_vximage_from_bmpfile(vx_image image, char *filename, vx_bool convert_to_gray_scale)
Load data from BMP file into a previously created vx_image object.
vx_status tivx_utils_bmp_file_read(const char *filename, vx_bool convert_to_gray_scale, uint32_t *width, uint32_t *height, uint32_t *stride, vx_df_image *df, void **data_ptr, void **png_file_context)
Read data from BMP file.
vx_enum vx_status
vx_status tivx_utils_bmp_file_read_from_memory(const void *buf, uint32_t buf_size, vx_bool convert_to_gray_scale, uint32_t *width, uint32_t *height, uint32_t *stride, vx_df_image *df, void **data_ptr, void **png_file_context)
Read data from BMP file.
struct _vx_context * vx_context
vx_status tivx_utils_save_vximage_to_pngfile(char *filename, vx_image image)
Save data from image object to PNG file.
int32_t tivx_utils_bmp_file_write(const char *filename, uint32_t width, uint32_t height, uint32_t stride, vx_df_image df, void *data_ptr)
Write data into BMP file.
uint32_t vx_df_image
void tivx_utils_bmp_file_read_release(void *png_file_context)
Free memory allocated during bmp file read.
vx_image tivx_utils_create_vximage_from_bmpfile(vx_context context, const char *filename, vx_bool convert_to_gray_scale)
Create a image data object given BMP filename as input.
vx_status tivx_utils_load_vximage_from_pngfile(vx_image image, char *filename, vx_bool convert_to_gray_scale)
Load data from PNG file into a previously created vx_image object.
void tivx_utils_png_file_read_release(void *png_file_context)
Free memory allocated during png_file_read.
vx_status tivx_utils_png_file_read(char *filename, vx_bool convert_to_gray_scale, uint32_t *width, uint32_t *height, uint32_t *stride, vx_df_image *df, void **data_ptr, void **png_file_context)
Read data from PNG file.
vx_image tivx_utils_create_vximage_from_pngfile(vx_context context, char *filename, vx_bool convert_to_gray_scale)
Create a image data object given PNG filename as input.
vx_status tivx_utils_save_vximage_to_bmpfile(const char *filename, vx_image image)
Save data from image object to PNG file.
int32_t tivx_utils_png_file_write(char *filename, uint32_t width, uint32_t height, uint32_t stride, vx_df_image df, void *data_ptr)
Write data into PNG file.