F5image.h

Go to the documentation of this file.

/*
/////////////////////////////////////////////////////////////////
//
// $Id: F5image.h,v 1.5 2004/03/22 15:30:05 werner Exp $
//
// $Log: F5image.h,v $
// Revision 1.5  2004/03/22 15:30:05  werner
// Generalized treatment of refinement within the framework of relative representations. Closer to better support of downsampling topologies.
// Improved documentation.
//
// Revision 1.4  2003/11/13 12:49:54  werner
// Adjusted includes for Windows,
// and added prototype information for generic tensor description types.
//
// Revision 1.3  2003/05/27 11:52:15  zib
// added F5_API stuff to build dll, if you like to build
// a static lib you'll have to define F5_STATIC during every
// build using the headers
//
// Revision 1.2  2002/11/11 17:08:43  werner
// Added a preliminiary interface for AMR data.
//
// Revision 1.1  2001/10/18 19:58:17  werner
// Preliminiary HDF5 Fiber C library
//
// Revision 1.1.1.1  2000/02/10 20:08:25  cvs
// GNU Emacs Configurations
//
// Revision 1.1.1.1  1999/12/02 14:25:59  werner
// Emacs configurations
//
// Revision 1.1.1.1  1999/01/13 13:59:50  werner
// GNU Emacs startup lisp files.
//
//
/////////////////////////////////////////////////////////////////
*/
 
#ifndef __F5image_H
#define __F5image_H
 
#include "F5types.h"
#include "F5coordinates.h"
 
#include "F5WinDLLApi.h"
 
#ifdef  __cplusplus
extern "C"
{
#endif
 
#define F5_IMAGE_RGB_FLOAT_INTENSITY                    "Intensity"
#define F5_IMAGE_RGB_FLOAT_TRANSPARENCY                 "Transparency"
#define F5_IMAGE_FINAL_VIEW                             "Directions"
#define F5_IMAGE_ZBUFFER                                "Zvalues"
#define F5_IMAGE_RGB16_INTENSITY                        "Intensity16"
#define F5_IMAGE_RGB16_TRANSPARENCY                     "Transparency16"
#define F5_IMAGE_RGB8_INTENSITY                         "Intensity8"
#define F5_IMAGE_RGB8_TRANSPARENCY                      "Transparency8"
#define F5_IMAGE_ALPHA_CHANNEL                          "alpha"
 
#define F5_IMAGE_LEFT_STEREO                            "left"
#define F5_IMAGE_RIGHT_STEREO                           "right"
#define F5_IMAGE_EQUATORIAL_CIRCUMVENTION               "observer%05d"
#define F5_IMAGE_CELESTIAL_CIRCUMVENTION                "observer@%05dx%05d"
 
 
 
typedef struct
{
        enum { I_lambda, I_nu, I_invariant } type;
 
        double  lambda_start, lambda_end;
        int     n;
        double  *I;
}
        F5spectrum_t;
 
F5_API hid_t F5spectrum_tid(F5spectrum_t*data);
 
typedef struct
{
        int             height,
                        width;
 
        double           time,
                         viewangle;
 
        F5_vec3_double_t viewpoint;
 
        F5_vec3_double_t origin,
                         x_direction,
                         y_direction;
 
        F5_vec3_float_t *directions;
 
        F5_rgb_real_t   *intensity;
        F5_rgb_real_t   *transparency;
        F5_float_t      *zvalues;
 
        F5_rgb16_t      *intensity16;
        F5_rgb16_t      *transparency16;
        unsigned short  *zvalues16;
 
        F5_rgb_t        *intensity8;
        F5_rgb_t        *transparency8;
        unsigned char   *zvalues8;
 
        unsigned char   *alpha;
 
        F5spectrum_t    *spectrum;
}
        F5image;
 
F5_API void initF5image(F5image*);
F5_API void deleteF5image(F5image*);
 
/**
   @param filename The file name where to store the image
   @param viewpoint_description Some name for the viewpoint.
   @param scenery  Some description of the image
   \note All image with the same scenery must have identical resolution
         (height, widht).
 */
F5_API void saveF5image(F5image*, const char*filename, const char*viewpoint_description, const char*scenery);
 
#ifdef  __cplusplus
}    /* extern "C" */
#endif
 
#endif  /* __F5image_H */