photo: photo: photo.h Source File

00001 /*********************************************************************
00002  *
00003  * Software License Agreement (BSD License)
00004  *
00005  *  Copyright (c) 2009, Robert Bosch LLC.
00006  *  All rights reserved.
00007  *
00008  *  Redistribution and use in source and binary forms, with or without
00009  *  modification, are permitted provided that the following conditions
00010  *  are met:
00011  *
00012  *   * Redistributions of source code must retain the above copyright
00013  *     notice, this list of conditions and the following disclaimer.
00014  *   * Redistributions in binary form must reproduce the above
00015  *     copyright notice, this list of conditions and the following
00016  *     disclaimer in the documentation and/or other materials provided
00017  *     with the distribution.
00018  *   * Neither the name of the Robert Bosch nor the names of its
00019  *     contributors may be used to endorse or promote products derived
00020  *     from this software without specific prior written permission.
00021  *
00022  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
00023  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00024  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
00025  *  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
00026  *  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00027  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00028  *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
00029  *  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00030  *  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
00031  *  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
00032  *  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00033  *  POSSIBILITY OF SUCH DAMAGE.
00034  *
00035  *********************************************************************/
00036 #ifndef PHOTO_H
00037 #define PHOTO_H
00038 
00039 #ifdef __cplusplus
00040 extern "C" {
00041 #endif
00042 
00043 #include <gphoto2/gphoto2-camera.h>
00044 #include <gphoto2/gphoto2-port-log.h>
00045 #include <gphoto2/gphoto2-setting.h>
00046 #include <gphoto2/gphoto2-filesys.h>
00047 #include <photo/photo_image.h>
00048 
00049 #define PHOTO_MODE_DIRECT     0
00050 #define PHOTO_MODE_TO_FILE    1
00051 
00052 typedef struct {
00053   Camera *cam;
00054   GPContext *context;
00055   int mode;
00056 } photo_t, *photo_p;
00057 
00058 /* initialize a new photo */
00059 photo_p photo_initialize(void);
00060 
00061 /* release photo memory */
00062 void photo_free(photo_p photo);
00063 
00064 /* open a specific USB connection the photo */
00065 int photo_open(photo_p photo, const char *model, const char *port);
00066 
00067 /* open the first photo detected on the USB bus */
00068 int photo_autodetect(photo_p photo);
00069 
00070 /* close the photo */
00071 int photo_close(photo_p photo);
00072 
00073 /* set a photo parameter */
00074 int photo_set_config(photo_p photo, const char *param, const char *value);
00075 
00076 /* get a photo parameter */
00077 int photo_get_config(photo_p photo, const char *param, char **value);
00078 
00079 /* capture an image */
00080 int photo_capture(photo_p photo, photo_image_p image);
00081 
00082 /* capture an image to file */
00083 int photo_capture_to_file(photo_p photo, const char *filename);
00084 
00085 #ifdef __cplusplus
00086 }
00087 #endif
00088 
00089 #endif