granicus.if.org Git - imagemagick/blob - MagickCore/version.c

   1 /*
   2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   3 %                                                                             %
   4 %                                                                             %
   5 %                                                                             %
   6 %               V   V  EEEEE  RRRR   SSSSS  IIIII   OOO   N   N               %
   7 %               V   V  E      R   R  SS       I    O   O  NN  N               %
   8 %               V   V  EEE    RRRR    SSS     I    O   O  N N N               %
   9 %                V V   E      R R       SS    I    O   O  N  NN               %
  10 %                 V    EEEEE  R  R   SSSSS  IIIII   OOO   N   N               %
  11 %                                                                             %
  12 %                                                                             %
  13 %                   MagickCore Version and Copyright Methods                  %
  14 %                                                                             %
  15 %                              Software Design                                %
  16 %                                John Cristy                                  %
  17 %                               September 2002                                %
  18 %                                                                             %
  19 %                                                                             %
  20 %  Copyright 1999-2013 ImageMagick Studio LLC, a non-profit organization      %
  21 %  dedicated to making software imaging solutions freely available.           %
  22 %                                                                             %
  23 %  You may not use this file except in compliance with the License.  You may  %
  24 %  obtain a copy of the License at                                            %
  25 %                                                                             %
  26 %    http://www.imagemagick.org/script/license.php                            %
  27 %                                                                             %
  28 %  Unless required by applicable law or agreed to in writing, software        %
  29 %  distributed under the License is distributed on an "AS IS" BASIS,          %
  30 %  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   %
  31 %  See the License for the specific language governing permissions and        %
  32 %  limitations under the License.                                             %
  33 %                                                                             %
  34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  35 %
  36 %
  37 */
  38 \f
  39 #include "MagickCore/studio.h"
  40 #include "MagickCore/configure.h"
  41 #include "MagickCore/exception.h"
  42 #include "MagickCore/exception-private.h"
  43 #include "MagickCore/hashmap.h"
  44 #include "MagickCore/locale_.h"
  45 #include "MagickCore/option.h"
  46 #include "MagickCore/string_.h"
  47 #include "MagickCore/utility.h"
  48 #include "MagickCore/utility-private.h"
  49 #include "MagickCore/version.h"
  50 \f
  51 /*
  52   Define declarations.
  53 */
  54 #define MagickURLFilename  "index.html"
  55 \f
  56 /*
  57 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  58 %                                                                             %
  59 %                                                                             %
  60 %                                                                             %
  61 %   G e t M a g i c k C o p y r i g h t                                       %
  62 %                                                                             %
  63 %                                                                             %
  64 %                                                                             %
  65 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  66 %
  67 %  GetMagickCopyright() returns the ImageMagick API copyright as a string.
  68 %
  69 %  The format of the GetMagickCopyright method is:
  70 %
  71 %      const char *GetMagickCopyright(void)
  72 %
  73 */
  74 MagickExport const char *GetMagickCopyright(void)
  75 {
  76   return(MagickCopyright);
  77 }
  78 \f
  79 /*
  80 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  81 %                                                                             %
  82 %                                                                             %
  83 %                                                                             %
  84 %   G e t M a g i c k D e l e g a t e s                                       %
  85 %                                                                             %
  86 %                                                                             %
  87 %                                                                             %
  88 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  89 %
  90 %  GetMagickDelegates() returns the ImageMagick delegate libraries.
  91 %
  92 %  The format of the GetMagickDelegates method is:
  93 %
  94 %      const char *GetMagickDelegates(void)
  95 %
  96 %  No parameters are required.
  97 %
  98 */
  99 MagickExport const char *GetMagickDelegates(void)
 100 {
 101   return ""
 102 #if defined(MAGICKCORE_AUTOTRACE_DELEGATE)
 103   "autotrace "
 104 #endif
 105 #if defined(MAGICKCORE_BZLIB_DELEGATE)
 106   "bzlib "
 107 #endif
 108 #if defined(MAGICKCORE_CAIRO_DELEGATE)
 109   "cairo "
 110 #endif
 111 #if defined(MAGICKCORE_DJVU_DELEGATE)
 112   "djvu "
 113 #endif
 114 #if defined(MAGICKCORE_DPS_DELEGATE)
 115   "dps "
 116 #endif
 117 #if defined(MAGICKCORE_EMF_DELEGATE)
 118   "emf "
 119 #endif
 120 #if defined(MAGICKCORE_FFTW_DELEGATE)
 121   "fftw "
 122 #endif
 123 #if defined(MAGICKCORE_FONTCONFIG_DELEGATE)
 124   "fontconfig "
 125 #endif
 126 #if defined(MAGICKCORE_FREETYPE_DELEGATE)
 127   "freetype "
 128 #endif
 129 #if defined(MAGICKCORE_FPX_DELEGATE)
 130   "fpx "
 131 #endif
 132 #if defined(MAGICKCORE_GS_DELEGATE)
 133   "gslib "
 134 #endif
 135 #if defined(MAGICKCORE_GVC_DELEGATE)
 136   "gvc "
 137 #endif
 138 #if defined(MAGICKCORE_JBIG_DELEGATE)
 139   "jbig "
 140 #endif
 141 #if defined(MAGICKCORE_JPEG_DELEGATE) && defined(MAGICKCORE_PNG_DELEGATE)
 142   "jng "
 143 #endif
 144 #if defined(MAGICKCORE_JP2_DELEGATE)
 145   "jp2 "
 146 #endif
 147 #if defined(MAGICKCORE_JPEG_DELEGATE)
 148   "jpeg "
 149 #endif
 150 #if defined(MAGICKCORE_LCMS_DELEGATE)
 151   "lcms "
 152 #endif
 153 #if defined(MAGICKCORE_LQR_DELEGATE)
 154   "lqr "
 155 #endif
 156 #if defined(MAGICKCORE_LTDL_DELEGATE)
 157   "ltdl "
 158 #endif
 159 #if defined(MAGICKCORE_LZMA_DELEGATE)
 160   "lzma "
 161 #endif
 162 #if defined(MAGICKCORE_OPENEXR_DELEGATE)
 163   "openexr "
 164 #endif
 165 #if defined(MAGICKCORE_PANGOCAIRO_DELEGATE)
 166   "pangocairo "
 167 #endif
 168 #if defined(MAGICKCORE_PNG_DELEGATE)
 169   "png "
 170 #endif
 171 #if defined(MAGICKCORE_DPS_DELEGATE) || defined(MAGICKCORE_GS_DELEGATE) || defined(WIN32)
 172   "ps "
 173 #endif
 174 #if defined(MAGICKCORE_RSVG_DELEGATE)
 175   "rsvg "
 176 #endif
 177 #if defined(MAGICKCORE_TIFF_DELEGATE)
 178   "tiff "
 179 #endif
 180 #if defined(MAGICKCORE_WEBP_DELEGATE)
 181   "webp "
 182 #endif
 183 #if defined(MAGICKCORE_WMF_DELEGATE) || defined (MAGICKCORE_WMFLITE_DELEGATE)
 184   "wmf "
 185 #endif
 186 #if defined(MAGICKCORE_X11_DELEGATE)
 187   "x "
 188 #endif
 189 #if defined(MAGICKCORE_XML_DELEGATE)
 190   "xml "
 191 #endif
 192 #if defined(MAGICKCORE_ZLIB_DELEGATE)
 193   "zlib"
 194 #endif
 195   ;
 196 }
 197 \f
 198 /*
 199 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 200 %                                                                             %
 201 %                                                                             %
 202 %                                                                             %
 203 %   G e t M a g i c k F e a t u r e s                                         %
 204 %                                                                             %
 205 %                                                                             %
 206 %                                                                             %
 207 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 208 %
 209 %  GetMagickFeatures() returns the ImageMagick features.
 210 %
 211 %  The format of the GetMagickFeatures method is:
 212 %
 213 %      const char *GetMagickFeatures(void)
 214 %
 215 %  No parameters are required.
 216 %
 217 */
 218 MagickExport const char *GetMagickFeatures(void)
 219 {
 220   return "DPC"
 221 #if defined(MAGICKCORE_HDRI_SUPPORT)
 222   " HDRI"
 223 #endif
 224 #if defined(MAGICKCORE_OPENCL_SUPPORT)
 225   " OpenCL"
 226 #endif
 227 #if defined(MAGICKCORE_OPENMP_SUPPORT)
 228   " OpenMP"
 229 #endif
 230 #if defined(MAGICKCORE_BUILD_MODULES) || defined(_DLL)
 231   " Modules"
 232 #endif
 233   ;
 234 }
 235 \f
 236 /*
 237 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 238 %                                                                             %
 239 %                                                                             %
 240 %                                                                             %
 241 %   G e t M a g i c k H o m e U R L                                           %
 242 %                                                                             %
 243 %                                                                             %
 244 %                                                                             %
 245 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 246 %
 247 %  GetMagickHomeURL() returns the ImageMagick home URL.
 248 %
 249 %  The format of the GetMagickHomeURL method is:
 250 %
 251 %      char *GetMagickHomeURL(void)
 252 %
 253 */
 254 MagickExport char *GetMagickHomeURL(void)
 255 {
 256   char
 257     path[MaxTextExtent];
 258
 259   const char
 260     *element;
 261
 262   ExceptionInfo
 263     *exception;
 264
 265   LinkedListInfo
 266     *paths;
 267
 268   exception=AcquireExceptionInfo();
 269   paths=GetConfigurePaths(MagickURLFilename,exception);
 270   exception=DestroyExceptionInfo(exception);
 271   if (paths == (LinkedListInfo *) NULL)
 272     return(ConstantString(MagickHomeURL));
 273   element=(const char *) GetNextValueInLinkedList(paths);
 274   while (element != (const char *) NULL)
 275   {
 276     (void) FormatLocaleString(path,MaxTextExtent,"%s%s%s",element,
 277       DirectorySeparator,MagickURLFilename);
 278     if (IsPathAccessible(path) != MagickFalse)
 279       return(ConstantString(path));
 280     element=(const char *) GetNextValueInLinkedList(paths);
 281   }
 282   return(ConstantString(MagickHomeURL));
 283 }
 284 \f
 285 /*
 286 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 287 %                                                                             %
 288 %                                                                             %
 289 %                                                                             %
 290 %   G e t M a g i c k P a c k a g e N a m e                                   %
 291 %                                                                             %
 292 %                                                                             %
 293 %                                                                             %
 294 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 295 %
 296 %  GetMagickPackageName() returns the ImageMagick package name.
 297 %
 298 %  The format of the GetMagickName method is:
 299 %
 300 %      const char *GetMagickName(void)
 301 %
 302 %  No parameters are required.
 303 %
 304 */
 305 MagickExport const char *GetMagickPackageName(void)
 306 {
 307   return(MagickPackageName);
 308 }
 309 \f
 310 /*
 311 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 312 %                                                                             %
 313 %                                                                             %
 314 %                                                                             %
 315 %   G e t M a g i c k Q u a n t u m D e p t h                                 %
 316 %                                                                             %
 317 %                                                                             %
 318 %                                                                             %
 319 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 320 %
 321 %  GetMagickQuantumDepth() returns the ImageMagick quantum depth.
 322 %
 323 %  The format of the GetMagickQuantumDepth method is:
 324 %
 325 %      const char *GetMagickQuantumDepth(size_t *depth)
 326 %
 327 %  A description of each parameter follows:
 328 %
 329 %    o depth: the quantum depth is returned as a number.
 330 %
 331 */
 332 MagickExport const char *GetMagickQuantumDepth(size_t *depth)
 333 {
 334   if (depth != (size_t *) NULL)
 335     *depth=(size_t) MAGICKCORE_QUANTUM_DEPTH;
 336   return(MagickQuantumDepth);
 337 }
 338 \f
 339 /*
 340 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 341 %                                                                             %
 342 %                                                                             %
 343 %                                                                             %
 344 %   G e t M a g i c k Q u a n t u m R a n g e                                 %
 345 %                                                                             %
 346 %                                                                             %
 347 %                                                                             %
 348 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 349 %
 350 %  GetMagickQuantumRange() returns the ImageMagick quantum range.
 351 %
 352 %  The format of the GetMagickQuantumRange method is:
 353 %
 354 %      const char *GetMagickQuantumRange(size_t *range)
 355 %
 356 %  A description of each parameter follows:
 357 %
 358 %    o range: the quantum range is returned as a number.
 359 %
 360 */
 361 MagickExport const char *GetMagickQuantumRange(size_t *range)
 362 {
 363   if (range != (size_t *) NULL)
 364     *range=(size_t) QuantumRange;
 365   return(MagickQuantumRange);
 366 }
 367 \f
 368 /*
 369 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 370 %                                                                             %
 371 %                                                                             %
 372 %                                                                             %
 373 %   G e t M a g i c k R e l e a s e D a t e                                   %
 374 %                                                                             %
 375 %                                                                             %
 376 %                                                                             %
 377 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 378 %
 379 %  GetMagickReleaseDate() returns the ImageMagick release date.
 380 %
 381 %  The format of the GetMagickReleaseDate method is:
 382 %
 383 %      const char *GetMagickReleaseDate(void)
 384 %
 385 %  No parameters are required.
 386 %
 387 */
 388 MagickExport const char *GetMagickReleaseDate(void)
 389 {
 390   return(MagickReleaseDate);
 391 }
 392 \f
 393 /*
 394 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 395 %                                                                             %
 396 %                                                                             %
 397 %                                                                             %
 398 %   G e t M a g i c k S i g n a t u r e                                       %
 399 %                                                                             %
 400 %                                                                             %
 401 %                                                                             %
 402 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 403 %
 404 %  GetMagickSignature() returns a signature that uniquely encodes the
 405 %  MagickCore libary version, quantum depth, HDRI status, OS word size, and
 406 %  endianness.
 407 %
 408 %  The format of the GetMagickSignature method is:
 409 %
 410 %      unsigned int GetMagickSignature(const StringInfo *nonce)
 411 %
 412 %  A description of each parameter follows:
 413 %
 414 %    o nonce: arbitrary data.
 415 %
 416 */
 417
 418 static unsigned int CRC32(const unsigned char *message,const size_t length)
 419 {
 420   register ssize_t
 421     i;
 422
 423   static MagickBooleanType
 424     crc_initial = MagickFalse;
 425
 426   static unsigned int
 427     crc_xor[256];
 428
 429   unsigned int
 430     crc;
 431
 432   /*
 433     Generate a 32-bit cyclic redundancy check for the message.
 434   */
 435   if (crc_initial == MagickFalse)
 436     {
 437       register unsigned int
 438         i;
 439
 440       unsigned int
 441         alpha;
 442
 443       for (i=0; i < 256; i++)
 444       {
 445         register ssize_t
 446           j;
 447
 448         alpha=i;
 449         for (j=0; j < 8; j++)
 450           alpha=(alpha & 0x01) ? (0xEDB88320 ^ (alpha >> 1)) : (alpha >> 1);
 451         crc_xor[i]=alpha;
 452       }
 453       crc_initial=MagickTrue;
 454     }
 455   crc=0xFFFFFFFF;
 456   for (i=0; i < (ssize_t) length; i++)
 457     crc=crc_xor[(crc ^ message[i]) & 0xff] ^ (crc >> 8);
 458   return(crc ^ 0xFFFFFFFF);
 459 }
 460
 461 MagickExport unsigned int GetMagickSignature(const StringInfo *nonce)
 462 {
 463   register unsigned char
 464     *p;
 465
 466   StringInfo
 467     *version;
 468
 469   unsigned int
 470     signature;
 471
 472   version=AcquireStringInfo(MaxTextExtent);
 473   p=GetStringInfoDatum(version);
 474   signature=MAGICKCORE_QUANTUM_DEPTH;
 475   (void) memcpy(p,&signature,sizeof(signature));
 476   p+=sizeof(signature);
 477   signature=MAGICKCORE_HDRI_ENABLE;
 478   (void) memcpy(p,&signature,sizeof(signature));
 479   p+=sizeof(signature);
 480   signature=MagickLibInterface;
 481   (void) memcpy(p,&signature,sizeof(signature));
 482   p+=sizeof(signature);
 483   signature=1;  /* endianess */
 484   (void) memcpy(p,&signature,sizeof(signature));
 485   p+=sizeof(signature);
 486   SetStringInfoLength(version,p-GetStringInfoDatum(version));
 487   if (nonce != (const StringInfo *) NULL)
 488     ConcatenateStringInfo(version,nonce);
 489   signature=CRC32(GetStringInfoDatum(version),GetStringInfoLength(version));
 490   version=DestroyStringInfo(version);
 491   return(signature);
 492 }
 493 \f
 494 /*
 495 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 496 %                                                                             %
 497 %                                                                             %
 498 %                                                                             %
 499 %   G e t M a g i c k V e r s i o n                                           %
 500 %                                                                             %
 501 %                                                                             %
 502 %                                                                             %
 503 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 504 %
 505 %  GetMagickVersion() returns the ImageMagick API version as a string and
 506 %  as a number.
 507 %
 508 %  The format of the GetMagickVersion method is:
 509 %
 510 %      const char *GetMagickVersion(size_t *version)
 511 %
 512 %  A description of each parameter follows:
 513 %
 514 %    o version: the ImageMagick version is returned as a number.
 515 %
 516 */
 517 MagickExport const char *GetMagickVersion(size_t *version)
 518 {
 519   if (version != (size_t *) NULL)
 520     *version=MagickLibVersion;
 521   return(MagickVersion);
 522 }
 523 \f
 524 /*
 525 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 526 %                                                                             %
 527 %                                                                             %
 528 %                                                                             %
 529 %   L i s t M a g i c k V e r s i o n                                         %
 530 %                                                                             %
 531 %                                                                             %
 532 %                                                                             %
 533 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 534 %
 535 %  ListMagickVersion() identifies the ImageMagick version by printing its
 536 %  attributes to the file.  Attributes include the copyright, features, and
 537 %  delegates.
 538 %
 539 %  The format of the ListMagickVersion method is:
 540 %
 541 %      void ListMagickVersion(FILE *file)
 542 %
 543 %  A description of each parameter follows:
 544 %
 545 %    o file: the file, typically stdout.
 546 %
 547 */
 548 MagickExport void ListMagickVersion(FILE *file)
 549 {
 550   (void) FormatLocaleFile(file,"Version: %s\n",
 551     GetMagickVersion((size_t *) NULL));
 552   (void) FormatLocaleFile(file,"Copyright: %s\n",GetMagickCopyright());
 553   (void) FormatLocaleFile(file,"Features: %s\n",GetMagickFeatures());
 554   (void) FormatLocaleFile(file,"Delegates: %s\n\n",GetMagickDelegates());
 555 }