dc1394_utils.c

This library provides functionality to control any camera that conforms to the 1394-Based Digital C

/*
 * 1394-Based Digital Camera Control Library utilities
 * Copyright (C) Damien Douxchamps <[e-mail]>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#include "dc1394_utils.h"
#include "dc1394_internal.h"

dc1394error_t
dc1394_get_image_size_from_video_mode(dc1394camera_t *camera, dc1394video_mode_t video_mode, uint_t *w, uint_t *h) 
{
  dc1394error_t err;
  uint_t sx, sy;

  switch(video_mode) {
  case DC1394_VIDEO_MODE_160x120_YUV444:
    *w = 160;*h=120;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_320x240_YUV422:
    *w = 320;*h=240;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_640x480_YUV411:
  case DC1394_VIDEO_MODE_640x480_YUV422:
  case DC1394_VIDEO_MODE_640x480_RGB8:
  case DC1394_VIDEO_MODE_640x480_MONO8:
  case DC1394_VIDEO_MODE_640x480_MONO16:
    *w =640;*h=480;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_800x600_YUV422:
  case DC1394_VIDEO_MODE_800x600_RGB8:
  case DC1394_VIDEO_MODE_800x600_MONO8:
  case DC1394_VIDEO_MODE_800x600_MONO16:
    *w=800;*h=600;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_1024x768_YUV422:
  case DC1394_VIDEO_MODE_1024x768_RGB8:
  case DC1394_VIDEO_MODE_1024x768_MONO8:
  case DC1394_VIDEO_MODE_1024x768_MONO16:
    *w=1024;*h=768;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_1280x960_YUV422:
  case DC1394_VIDEO_MODE_1280x960_RGB8:
  case DC1394_VIDEO_MODE_1280x960_MONO8:
  case DC1394_VIDEO_MODE_1280x960_MONO16:
    *w=1280;*h=960;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_1600x1200_YUV422:
  case DC1394_VIDEO_MODE_1600x1200_RGB8:
  case DC1394_VIDEO_MODE_1600x1200_MONO8:
  case DC1394_VIDEO_MODE_1600x1200_MONO16:
    *w=1600;*h=1200;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_FORMAT7_0:
  case DC1394_VIDEO_MODE_FORMAT7_1:
  case DC1394_VIDEO_MODE_FORMAT7_2:
  case DC1394_VIDEO_MODE_FORMAT7_3:
  case DC1394_VIDEO_MODE_FORMAT7_4:
  case DC1394_VIDEO_MODE_FORMAT7_5:
  case DC1394_VIDEO_MODE_FORMAT7_6:
  case DC1394_VIDEO_MODE_FORMAT7_7:
    // get the current color mode from the camera
    err=dc1394_format7_get_image_size(camera, video_mode, &sx, &sy);
    if (err!=DC1394_SUCCESS) {
      return err;
    }
    else {
      *w=sx;
      *h=sy;
    }
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_EXIF:
    return DC1394_FAILURE;
  }

  return DC1394_FAILURE;
}
	

dc1394error_t
dc1394_framerate_as_float(dc1394framerate_t framerate_enum, float *framerate)
{
  switch(framerate_enum)  {
  case DC1394_FRAMERATE_1_875:
    *framerate=1.875;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_3_75:
    *framerate=3.75;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_7_5:
    *framerate=7.5;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_15:
    *framerate=15.0;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_30:
    *framerate=30.0;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_60:
    *framerate=60.0;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_120:
    *framerate=120.0;
    return DC1394_SUCCESS;
  case DC1394_FRAMERATE_240:
    *framerate=240.0;
    return DC1394_SUCCESS;
  }
  return DC1394_INVALID_FRAMERATE;
}

dc1394error_t
dc1394_is_color(dc1394color_coding_t color_coding, dc1394bool_t *is_color)
{
  switch(color_coding)  {
  case DC1394_COLOR_CODING_MONO8:
  case DC1394_COLOR_CODING_MONO16:
  case DC1394_COLOR_CODING_MONO16S:
  case DC1394_COLOR_CODING_RAW8:
  case DC1394_COLOR_CODING_RAW16:
    *is_color=DC1394_FALSE;
    return DC1394_SUCCESS;
  case DC1394_COLOR_CODING_YUV411:
  case DC1394_COLOR_CODING_YUV422:
  case DC1394_COLOR_CODING_YUV444:
  case DC1394_COLOR_CODING_RGB8:
  case DC1394_COLOR_CODING_RGB16:
  case DC1394_COLOR_CODING_RGB16S:
    *is_color=DC1394_TRUE;
    return DC1394_SUCCESS;
  }
  return DC1394_INVALID_COLOR_CODING;
}

dc1394error_t
dc1394_get_bytes_per_pixel(dc1394color_coding_t color_coding, float* bpp)
{
  switch(color_coding) {
  case DC1394_COLOR_CODING_MONO8:
  case DC1394_COLOR_CODING_RAW8:
    *bpp=1.0;
    return DC1394_SUCCESS;
  case DC1394_COLOR_CODING_YUV411:
    *bpp=1.5;
    return DC1394_SUCCESS;
  case DC1394_COLOR_CODING_MONO16:
  case DC1394_COLOR_CODING_RAW16:
  case DC1394_COLOR_CODING_MONO16S:
  case DC1394_COLOR_CODING_YUV422:
    *bpp=2.0;
    return DC1394_SUCCESS;
  case DC1394_COLOR_CODING_YUV444:
  case DC1394_COLOR_CODING_RGB8:
    *bpp=3.0;
    return DC1394_SUCCESS;
  case DC1394_COLOR_CODING_RGB16:
  case DC1394_COLOR_CODING_RGB16S:
    *bpp=6.0;
    return DC1394_SUCCESS;
  }
  return DC1394_INVALID_COLOR_CODING;
}

dc1394error_t
dc1394_get_color_coding_from_video_mode(dc1394camera_t *camera, dc1394video_mode_t video_mode, dc1394color_coding_t *color_coding)
{
  dc1394error_t err;
  dc1394color_coding_t id;

  switch(video_mode) {
  case DC1394_VIDEO_MODE_160x120_YUV444:
    *color_coding=DC1394_COLOR_CODING_YUV444;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_320x240_YUV422:
  case DC1394_VIDEO_MODE_640x480_YUV422:
  case DC1394_VIDEO_MODE_800x600_YUV422:
  case DC1394_VIDEO_MODE_1024x768_YUV422:
  case DC1394_VIDEO_MODE_1280x960_YUV422:
  case DC1394_VIDEO_MODE_1600x1200_YUV422:
    *color_coding=DC1394_COLOR_CODING_YUV422;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_640x480_YUV411:
    *color_coding=DC1394_COLOR_CODING_YUV411;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_640x480_RGB8:
  case DC1394_VIDEO_MODE_800x600_RGB8:
  case DC1394_VIDEO_MODE_1024x768_RGB8:
  case DC1394_VIDEO_MODE_1280x960_RGB8:
  case DC1394_VIDEO_MODE_1600x1200_RGB8:
    *color_coding=DC1394_COLOR_CODING_RGB8;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_640x480_MONO8:
  case DC1394_VIDEO_MODE_800x600_MONO8:
  case DC1394_VIDEO_MODE_1024x768_MONO8:
  case DC1394_VIDEO_MODE_1280x960_MONO8:
  case DC1394_VIDEO_MODE_1600x1200_MONO8:
    *color_coding=DC1394_COLOR_CODING_MONO8;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_800x600_MONO16:
  case DC1394_VIDEO_MODE_640x480_MONO16:
  case DC1394_VIDEO_MODE_1024x768_MONO16:
  case DC1394_VIDEO_MODE_1280x960_MONO16:
  case DC1394_VIDEO_MODE_1600x1200_MONO16:
    *color_coding=DC1394_COLOR_CODING_MONO16;
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_FORMAT7_0:
  case DC1394_VIDEO_MODE_FORMAT7_1:
  case DC1394_VIDEO_MODE_FORMAT7_2:
  case DC1394_VIDEO_MODE_FORMAT7_3:
  case DC1394_VIDEO_MODE_FORMAT7_4:
  case DC1394_VIDEO_MODE_FORMAT7_5:
  case DC1394_VIDEO_MODE_FORMAT7_6:
  case DC1394_VIDEO_MODE_FORMAT7_7:
    // get the current color mode from the camera
    err=dc1394_format7_get_color_coding(camera, video_mode, &id);
    if (err!=DC1394_SUCCESS) {
      return err;
    }
    else {
      *color_coding=id;
    }
    return DC1394_SUCCESS;
  case DC1394_VIDEO_MODE_EXIF:
    return DC1394_FAILURE;
  }

  return DC1394_FAILURE;
}

dc1394bool_t
dc1394_is_video_mode_scalable(dc1394video_mode_t video_mode)
{
  return ((video_mode>=DC1394_VIDEO_MODE_FORMAT7_MIN)&&(video_mode<=DC1394_VIDEO_MODE_FORMAT7_MAX));
}

dc1394bool_t
dc1394_is_video_mode_still_image(dc1394video_mode_t video_mode)
{
  return ((video_mode>=DC1394_VIDEO_MODE_FORMAT6_MIN)&&(video_mode<=DC1394_VIDEO_MODE_FORMAT6_MAX));
}