/* # # File : gmic.h # ( C++ header file ) # # Description : GREYC's Magic Image Converter # ( http://gmic.sourceforge.net ) # This file is a part of the CImg Library project. # ( http://cimg.sourceforge.net ) # # Note : Include this file in your C++ source code, if you # want to use the G'MIC interpreter in your own program. # # Copyright : David Tschumperle # ( http://www.greyc.ensicaen.fr/~dtschump/ ) # # License : CeCILL v2.0 # ( http://www.cecill.info/licences/Licence_CeCILL_V2-en.html ) # # This software is governed by the CeCILL license under French law and # abiding by the rules of distribution of free software. You can use, # modify and/ or redistribute the software under the terms of the CeCILL # license as circulated by CEA, CNRS and INRIA at the following URL # "http://www.cecill.info". # # As a counterpart to the access to the source code and rights to copy, # modify and redistribute granted by the license, users are provided only # with a limited warranty and the software's author, the holder of the # economic rights, and the successive licensors have only limited # liability. # # In this respect, the user's attention is drawn to the risks associated # with loading, using, modifying and/or developing or reproducing the # software by the user in light of its specific status of free software, # that may mean that it is complicated to manipulate, and that also # therefore means that it is reserved for developers and experienced # professionals having in-depth computer knowledge. Users are therefore # encouraged to load and test the software's suitability as regards their # requirements in conditions enabling the security of their systems and/or # data to be ensured and, more generally, to use and operate it in the # same conditions as regards security. # # The fact that you are presently reading this means that you have had # knowledge of the CeCILL license and that you accept its terms. # */ #include #ifndef gmic_version #define gmic_version 1508 // Define environment variables. #ifndef gmic_is_beta #define gmic_is_beta 0 #endif #ifndef cimg_verbosity #define cimg_verbosity 1 #endif #if defined(cimg_build) #define cimg_plugin "examples/gmic.cpp" #define cimg_location "../CImg.h" #elif defined(gmic_build) #define cimg_plugin "gmic.cpp" #define cimg_location "./CImg.h" #endif // Define the structures used to store images and image lists. // Your image data must be copied in such structures before // calling the G'MIC interpreter. #ifdef cimg_location #include cimg_location #if cimg_OS==2 #include #endif // Define some special character codes used for replacement in double quoted strings. const char _dollar = 23, _lbrace = 24, _rbrace = 25, _comma = 26, _dquote = 28, _arobace = 29, _newline = 30; // Replace special characters in a string. inline char *gmic_strreplace(char *const str) { for (char *s = str ; *s; ++s) { const char c = *s; if (c<' ') *s = c==_dollar?'$':c==_lbrace?'{':c==_rbrace?'}':c==_comma?',': c==_dquote?'\"':c==_arobace?'@':c; } return str; } #else #include #include #ifndef cimg_version namespace cimg_library { // Define the G'MIC image class. //------------------------------ template struct CImg { unsigned int _width; // Number of image columns (dimension along the X-axis). unsigned int _height; // Number of image lines (dimension along the Y-axis) unsigned int _depth; // Number of image slices (dimension along the Z-axis). unsigned int _spectrum; // Number of image channels (dimension along the C-axis). bool _is_shared; // Tells if the data buffer is shared by another structure. T *_data; // Pointer to the first pixel value. // Destructor. ~CImg(); // Empty constructor. CImg():_width(0),_height(0),_depth(0),_spectrum(0),_is_shared(false),_data(0) {} // Use to allocate a new image with specified dimension. CImg& assign(const unsigned int w, const unsigned int h=1, const unsigned int d=1, const unsigned int s=1); }; // Define the G'MIC image list class. //----------------------------------- template struct CImgList { unsigned int _width; // Number of images in the list. unsigned int _allocated_width; // Allocated items in the list (must be 2^N and >size). CImg *_data; // Pointer to the first image of the list. // Destructor. ~CImgList(); // Empty constructor. CImgList():_width(0),_allocated_width(0),_data(0) {} // Use to allocate a new image list with specified dimension. CImgList& assign(const unsigned int n); }; } #endif // #ifndef cimg_version #endif // #ifdef cimg_location #define gmic_image cimg_library::CImg #define gmic_list cimg_library::CImgList // Define the G'MIC exception class. //---------------------------------- struct gmic_exception { gmic_image _command, _message; gmic_exception(const char *const command, const char *const message) { if (command) { _command.assign(std::strlen(command)+1,1,1,1); std::strcpy(_command._data,command); } if (message) { _message.assign(std::strlen(message)+1,1,1,1); std::strcpy(_message._data,message); } } const char *what() const { // Give the error message returned by the G'MIC interpreter. return _message._data?_message._data:""; } const char *command() const { return _command._data?_command._data:""; } }; // Define the G'MIC interpreter class. //------------------------------------ struct gmic { // Internal environment variables. #if cimg_display!=0 cimg_library::CImgDisplay instant_window[10]; #endif static gmic_list default_commands, default_commands_names; gmic_list commands, command_names, variables[27], variables_names[27], scope; gmic_list dowhiles, repeatdones, whiledones; gmic_image background3d, light3d; gmic_image pose3d; gmic_image status; float focale3d, light3d_x, light3d_y, light3d_z, specular_light3d, specular_shine3d, _progress, *progress; bool is_released, is_debug, is_start, is_quit, is_return, is_double3d, is_default_type, is_shell, check_elif; int verbosity, render3d, renderd3d; volatile int _cancel, *cancel; unsigned int nb_carriages, position; // Constructors - Destructors. // Use them to run the G'MIC interpreter from your C++ source. ~gmic(); gmic(const char *const commands_line, const char *const custom_commands=0, const bool include_default_commands=true, float *const p_progress=0, int *const p_cancel=0); template gmic(const int argc, const char *const *const argv, gmic_list& images, const char *const custom_commands=0, const bool include_default_commands=true, float *const p_progress=0, int *const p_cancel=0); template gmic(const char *const commands_line, gmic_list& images, const char *const custom_commands=0, const bool include_default_commands=true, float *const p_progress=0, int *const p_cancel=0); // All functions below should be considered as 'private' and thus, should not be used // in your own C++ source code. Use them at your own risk. gmic& add_commands(const char *const data_commands, gmic_list& command_names, gmic_list& commands); gmic& add_commands(std::FILE *const file, gmic_list& command_names, gmic_list& commands); gmic_image scope2string(const bool is_last_slash=true) const; gmic_image scope2string(const gmic_image& scope_selection, const bool is_last_slash=true) const; gmic& assign(const char *const custom_commands=0, const bool include_default_commands=true, float *const p_progress=0, int *const p_cancel=0); gmic_image selection2cimg(const char *const string, const unsigned int indice_max, const gmic_list& names, const char *const command, const bool is_selection, const bool allow_new_name, gmic_image& new_name); gmic_list commands_line_to_CImgList(const char *const commands_line); char *selection2string(const gmic_image& selection, const gmic_list& images_names, const bool display_selection) const; template gmic_image substitute_item(const char *const source, gmic_list& images, gmic_list& images_names, const unsigned int (&variables_sizes)[27]); gmic& print(const char *format, ...); template gmic& print(const gmic_list& list, const char *format, ...); template gmic& print(const gmic_list& list, const gmic_image& scope_selection, const char *format, ...); gmic& warning(const char *format, ...); template gmic& warning(const gmic_list& list, const char *format, ...); template gmic& warning(const gmic_list& list, const gmic_image& scope_selection, const char *format, ...); gmic& error(const char *format, ...); template gmic& error(const gmic_list& list, const char *format, ...); template gmic& error(const char *const command, const gmic_list& list, const char *format, ...); template gmic& error(const gmic_list& list, const gmic_image& scope_selection, const char *format, ...); template gmic& _arg_error(const gmic_list& list, const char *const command, const char *const argument); gmic& debug(const char *format, ...); template gmic& debug(const gmic_list& list, const char *format, ...); template gmic& display_images(const gmic_list& images, const gmic_list& images_names, const gmic_image& selection); template gmic& display_plots(const gmic_list& images, const gmic_list& images_names, const gmic_image& selection, const unsigned int plot_type, const unsigned int vertex_type, const double xmin, const double xmax, const double ymin, const double ymax); template gmic& display_objects3d(const gmic_list& images, const gmic_list& images_names, const gmic_image& selection); template gmic& parse(const gmic_list& commands_line, unsigned int& position, gmic_list &images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_bool(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &filename, const unsigned int (&variables_sizes)[27]); gmic& parse_uchar(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_char(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_ushort(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_short(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_uint(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_int(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_float(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); gmic& parse_double(const gmic_list& commands_line, unsigned int& position, gmic_list& images, gmic_list &images_names, const unsigned int (&variables_sizes)[27]); }; // End of the 'gmic' class. #endif // Local Variables: // mode: c++ // End: