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   ;
 231 }
 232 \f
 233 /*
 234 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 235 %                                                                             %
 236 %                                                                             %
 237 %                                                                             %
 238 %   G e t M a g i c k H o m e U R L                                           %
 239 %                                                                             %
 240 %                                                                             %
 241 %                                                                             %
 242 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 243 %
 244 %  GetMagickHomeURL() returns the ImageMagick home URL.
 245 %
 246 %  The format of the GetMagickHomeURL method is:
 247 %
 248 %      char *GetMagickHomeURL(void)
 249 %
 250 */
 251 MagickExport char *GetMagickHomeURL(void)
 252 {
 253   char
 254     path[MaxTextExtent];
 255
 256   const char
 257     *element;
 258
 259   ExceptionInfo
 260     *exception;
 261
 262   LinkedListInfo
 263     *paths;
 264
 265   exception=AcquireExceptionInfo();
 266   paths=GetConfigurePaths(MagickURLFilename,exception);
 267   exception=DestroyExceptionInfo(exception);
 268   if (paths == (LinkedListInfo *) NULL)
 269     return(ConstantString(MagickHomeURL));
 270   element=(const char *) GetNextValueInLinkedList(paths);
 271   while (element != (const char *) NULL)
 272   {
 273     (void) FormatLocaleString(path,MaxTextExtent,"%s%s%s",element,
 274       DirectorySeparator,MagickURLFilename);
 275     if (IsPathAccessible(path) != MagickFalse)
 276       return(ConstantString(path));
 277     element=(const char *) GetNextValueInLinkedList(paths);
 278   }
 279   return(ConstantString(MagickHomeURL));
 280 }
 281 \f
 282 /*
 283 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 284 %                                                                             %
 285 %                                                                             %
 286 %                                                                             %
 287 %   G e t M a g i c k P a c k a g e N a m e                                   %
 288 %                                                                             %
 289 %                                                                             %
 290 %                                                                             %
 291 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 292 %
 293 %  GetMagickPackageName() returns the ImageMagick package name.
 294 %
 295 %  The format of the GetMagickName method is:
 296 %
 297 %      const char *GetMagickName(void)
 298 %
 299 %  No parameters are required.
 300 %
 301 */
 302 MagickExport const char *GetMagickPackageName(void)
 303 {
 304   return(MagickPackageName);
 305 }
 306 \f
 307 /*
 308 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 309 %                                                                             %
 310 %                                                                             %
 311 %                                                                             %
 312 %   G e t M a g i c k Q u a n t u m D e p t h                                 %
 313 %                                                                             %
 314 %                                                                             %
 315 %                                                                             %
 316 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 317 %
 318 %  GetMagickQuantumDepth() returns the ImageMagick quantum depth.
 319 %
 320 %  The format of the GetMagickQuantumDepth method is:
 321 %
 322 %      const char *GetMagickQuantumDepth(size_t *depth)
 323 %
 324 %  A description of each parameter follows:
 325 %
 326 %    o depth: the quantum depth is returned as a number.
 327 %
 328 */
 329 MagickExport const char *GetMagickQuantumDepth(size_t *depth)
 330 {
 331   if (depth != (size_t *) NULL)
 332     *depth=(size_t) MAGICKCORE_QUANTUM_DEPTH;
 333   return(MagickQuantumDepth);
 334 }
 335 \f
 336 /*
 337 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 338 %                                                                             %
 339 %                                                                             %
 340 %                                                                             %
 341 %   G e t M a g i c k Q u a n t u m R a n g e                                 %
 342 %                                                                             %
 343 %                                                                             %
 344 %                                                                             %
 345 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 346 %
 347 %  GetMagickQuantumRange() returns the ImageMagick quantum range.
 348 %
 349 %  The format of the GetMagickQuantumRange method is:
 350 %
 351 %      const char *GetMagickQuantumRange(size_t *range)
 352 %
 353 %  A description of each parameter follows:
 354 %
 355 %    o range: the quantum range is returned as a number.
 356 %
 357 */
 358 MagickExport const char *GetMagickQuantumRange(size_t *range)
 359 {
 360   if (range != (size_t *) NULL)
 361     *range=(size_t) QuantumRange;
 362   return(MagickQuantumRange);
 363 }
 364 \f
 365 /*
 366 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 367 %                                                                             %
 368 %                                                                             %
 369 %                                                                             %
 370 %   G e t M a g i c k R e l e a s e D a t e                                   %
 371 %                                                                             %
 372 %                                                                             %
 373 %                                                                             %
 374 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 375 %
 376 %  GetMagickReleaseDate() returns the ImageMagick release date.
 377 %
 378 %  The format of the GetMagickReleaseDate method is:
 379 %
 380 %      const char *GetMagickReleaseDate(void)
 381 %
 382 %  No parameters are required.
 383 %
 384 */
 385 MagickExport const char *GetMagickReleaseDate(void)
 386 {
 387   return(MagickReleaseDate);
 388 }
 389 \f
 390 /*
 391 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 392 %                                                                             %
 393 %                                                                             %
 394 %                                                                             %
 395 %   G e t M a g i c k S i g n a t u r e                                       %
 396 %                                                                             %
 397 %                                                                             %
 398 %                                                                             %
 399 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 400 %
 401 %  GetMagickSignature() returns a signature that uniquely encodes the
 402 %  MagickCore libary version, quantum depth, HDRI status, OS word size, and
 403 %  endianness.
 404 %
 405 %  The format of the GetMagickSignature method is:
 406 %
 407 %      unsigned int GetMagickSignature(const StringInfo *nonce)
 408 %
 409 %  A description of each parameter follows:
 410 %
 411 %    o nonce: arbitrary data.
 412 %
 413 */
 414
 415 static unsigned int CRC32(const unsigned char *message,const size_t length)
 416 {
 417   register ssize_t
 418     i;
 419
 420   static MagickBooleanType
 421     crc_initial = MagickFalse;
 422
 423   static unsigned int
 424     crc_xor[256];
 425
 426   unsigned int
 427     crc;
 428
 429   /*
 430     Generate a 32-bit cyclic redundancy check for the message.
 431   */
 432   if (crc_initial == MagickFalse)
 433     {
 434       register unsigned int
 435         i;
 436
 437       unsigned int
 438         alpha;
 439
 440       for (i=0; i < 256; i++)
 441       {
 442         register ssize_t
 443           j;
 444
 445         alpha=i;
 446         for (j=0; j < 8; j++)
 447           alpha=(alpha & 0x01) ? (0xEDB88320 ^ (alpha >> 1)) : (alpha >> 1);
 448         crc_xor[i]=alpha;
 449       }
 450       crc_initial=MagickTrue;
 451     }
 452   crc=0xFFFFFFFF;
 453   for (i=0; i < (ssize_t) length; i++)
 454     crc=crc_xor[(crc ^ message[i]) & 0xff] ^ (crc >> 8);
 455   return(crc ^ 0xFFFFFFFF);
 456 }
 457
 458 MagickExport unsigned int GetMagickSignature(const StringInfo *nonce)
 459 {
 460   register unsigned char
 461     *p;
 462
 463   StringInfo
 464     *version;
 465
 466   unsigned int
 467     signature;
 468
 469   version=AcquireStringInfo(MaxTextExtent);
 470   p=GetStringInfoDatum(version);
 471   signature=MAGICKCORE_QUANTUM_DEPTH;
 472   (void) memcpy(p,&signature,sizeof(signature));
 473   p+=sizeof(signature);
 474   signature=MAGICKCORE_HDRI_ENABLE;
 475   (void) memcpy(p,&signature,sizeof(signature));
 476   p+=sizeof(signature);
 477   signature=MagickLibInterface;
 478   (void) memcpy(p,&signature,sizeof(signature));
 479   p+=sizeof(signature);
 480   signature=1;  /* endianess */
 481   (void) memcpy(p,&signature,sizeof(signature));
 482   p+=sizeof(signature);
 483   SetStringInfoLength(version,p-GetStringInfoDatum(version));
 484   if (nonce != (const StringInfo *) NULL)
 485     ConcatenateStringInfo(version,nonce);
 486   signature=CRC32(GetStringInfoDatum(version),GetStringInfoLength(version));
 487   version=DestroyStringInfo(version);
 488   return(signature);
 489 }
 490 \f
 491 /*
 492 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 493 %                                                                             %
 494 %                                                                             %
 495 %                                                                             %
 496 %   G e t M a g i c k V e r s i o n                                           %
 497 %                                                                             %
 498 %                                                                             %
 499 %                                                                             %
 500 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 501 %
 502 %  GetMagickVersion() returns the ImageMagick API version as a string and
 503 %  as a number.
 504 %
 505 %  The format of the GetMagickVersion method is:
 506 %
 507 %      const char *GetMagickVersion(size_t *version)
 508 %
 509 %  A description of each parameter follows:
 510 %
 511 %    o version: the ImageMagick version is returned as a number.
 512 %
 513 */
 514 MagickExport const char *GetMagickVersion(size_t *version)
 515 {
 516   if (version != (size_t *) NULL)
 517     *version=MagickLibVersion;
 518   return(MagickVersion);
 519 }
 520 \f
 521 /*
 522 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 523 %                                                                             %
 524 %                                                                             %
 525 %                                                                             %
 526 %   L i s t M a g i c k V e r s i o n                                         %
 527 %                                                                             %
 528 %                                                                             %
 529 %                                                                             %
 530 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 531 %
 532 %  ListMagickVersion() identifies the ImageMagick version by printing its
 533 %  attributes to the file.  Attributes include the copyright, features, and
 534 %  delegates.
 535 %
 536 %  The format of the ListMagickVersion method is:
 537 %
 538 %      void ListMagickVersion(FILE *file)
 539 %
 540 %  A description of each parameter follows:
 541 %
 542 %    o file: the file, typically stdout.
 543 %
 544 */
 545 MagickExport void ListMagickVersion(FILE *file)
 546 {
 547   (void) FormatLocaleFile(file,"Version: %s\n",
 548     GetMagickVersion((size_t *) NULL));
 549   (void) FormatLocaleFile(file,"Copyright: %s\n",GetMagickCopyright());
 550   (void) FormatLocaleFile(file,"Features: %s\n",GetMagickFeatures());
 551   (void) FormatLocaleFile(file,"Delegates: %s\n\n",GetMagickDelegates());
 552 }