JERROR.C
上传用户:wep9318
上传日期:2007-01-07
资源大小:893k
文件大小:7k
源码类别:

图片显示

开发平台:

Visual C++

  1. /*
  2.  * jerror.c
  3.  *
  4.  * Copyright (C) 1991-1994, Thomas G. Lane.
  5.  * This file is part of the Independent JPEG Group's software.
  6.  * For conditions of distribution and use, see the accompanying README file.
  7.  *
  8.  * This file contains simple error-reporting and trace-message routines.
  9.  * These are suitable for Unix-like systems and others where writing to
  10.  * stderr is the right thing to do.  Many applications will want to replace
  11.  * some or all of these routines.
  12.  *
  13.  * These routines are used by both the compression and decompression code.
  14.  */
  15. /* this is not a core library module, so it doesn't define JPEG_INTERNALS */
  16. #include "jinclude.h"
  17. #include "jpeglib.h"
  18. #include "jversion.h"
  19. #include "jerror.h"
  20. #ifndef EXIT_FAILURE /* define exit() codes if not provided */
  21. #define EXIT_FAILURE  1
  22. #endif
  23. /*
  24.  * Create the message string table.
  25.  * We do this from the master message list in jerror.h by re-reading
  26.  * jerror.h with a suitable definition for macro JMESSAGE.
  27.  * The message table is made an external symbol just in case any applications
  28.  * want to refer to it directly.
  29.  */
  30. #ifdef NEED_SHORT_EXTERNAL_NAMES
  31. #define jpeg_std_message_table jMsgTable
  32. #endif
  33. #define JMESSAGE(code,string) string ,
  34. const char * const jpeg_std_message_table[] = {
  35. #include "jerror.h"
  36.   NULL
  37. };
  38. /*
  39.  * Error exit handler: must not return to caller.
  40.  *
  41.  * Applications may override this if they want to get control back after
  42.  * an error.  Typically one would longjmp somewhere instead of exiting.
  43.  * The setjmp buffer can be made a private field within an expanded error
  44.  * handler object.  Note that the info needed to generate an error message
  45.  * is stored in the error object, so you can generate the message now or
  46.  * later, at your convenience.
  47.  * You should make sure that the JPEG object is cleaned up (with jpeg_abort
  48.  * or jpeg_destroy) at some point.
  49.  */
  50. METHODDEF void
  51. error_exit (j_common_ptr cinfo)
  52. {
  53.   /* Always display the message */
  54.   (*cinfo->err->output_message) (cinfo);
  55.   /* Let the memory manager delete any temp files before we die */
  56.   jpeg_destroy(cinfo);
  57.   exit(EXIT_FAILURE);
  58. }
  59. /*
  60.  * Actual output of an error or trace message.
  61.  * Applications may override this method to send JPEG messages somewhere
  62.  * other than stderr.
  63.  */
  64. METHODDEF void
  65. output_message (j_common_ptr cinfo)
  66. {
  67.   char buffer[JMSG_LENGTH_MAX];
  68.   /* Create the message */
  69.   (*cinfo->err->format_message) (cinfo, buffer);
  70.   /* Send it to stderr, adding a newline */
  71.   fprintf(stderr, "%sn", buffer);
  72. }
  73. /*
  74.  * Decide whether to emit a trace or warning message.
  75.  * msg_level is one of:
  76.  *   -1: recoverable corrupt-data warning, may want to abort.
  77.  *    0: important advisory messages (always display to user).
  78.  *    1: first level of tracing detail.
  79.  *    2,3,...: successively more detailed tracing messages.
  80.  * An application might override this method if it wanted to abort on warnings
  81.  * or change the policy about which messages to display.
  82.  */
  83. METHODDEF void
  84. emit_message (j_common_ptr cinfo, int msg_level)
  85. {
  86.   struct jpeg_error_mgr * err = cinfo->err;
  87.   if (msg_level < 0) {
  88.     /* It's a warning message.  Since corrupt files may generate many warnings,
  89.      * the policy implemented here is to show only the first warning,
  90.      * unless trace_level >= 3.
  91.      */
  92.     if (err->num_warnings == 0 || err->trace_level >= 3)
  93.       (*err->output_message) (cinfo);
  94.     /* Always count warnings in num_warnings. */
  95.     err->num_warnings++;
  96.   } else {
  97.     /* It's a trace message.  Show it if trace_level >= msg_level. */
  98.     if (err->trace_level >= msg_level)
  99.       (*err->output_message) (cinfo);
  100.   }
  101. }
  102. /*
  103.  * Format a message string for the most recent JPEG error or message.
  104.  * The message is stored into buffer, which should be at least JMSG_LENGTH_MAX
  105.  * characters.  Note that no 'n' character is added to the string.
  106.  * Few applications should need to override this method.
  107.  */
  108. METHODDEF void
  109. format_message (j_common_ptr cinfo, char * buffer)
  110. {
  111.   struct jpeg_error_mgr * err = cinfo->err;
  112.   int msg_code = err->msg_code;
  113.   const char * msgtext = NULL;
  114.   const char * msgptr;
  115.   char ch;
  116.   boolean isstring;
  117.   /* Look up message string in proper table */
  118.   if (msg_code > 0 && msg_code <= err->last_jpeg_message) {
  119.     msgtext = err->jpeg_message_table[msg_code];
  120.   } else if (err->addon_message_table != NULL &&
  121.      msg_code >= err->first_addon_message &&
  122.      msg_code <= err->last_addon_message) {
  123.     msgtext = err->addon_message_table[msg_code - err->first_addon_message];
  124.   }
  125.   /* Defend against bogus message number */
  126.   if (msgtext == NULL) {
  127.     err->msg_parm.i[0] = msg_code;
  128.     msgtext = err->jpeg_message_table[0];
  129.   }
  130.   /* Check for string parameter, as indicated by %s in the message text */
  131.   isstring = FALSE;
  132.   msgptr = msgtext;
  133.   while ((ch = *msgptr++) != '') {
  134.     if (ch == '%') {
  135.       if (*msgptr == 's') isstring = TRUE;
  136.       break;
  137.     }
  138.   }
  139.   /* Format the message into the passed buffer */
  140.   if (isstring)
  141.     sprintf(buffer, msgtext, err->msg_parm.s);
  142.   else
  143.     sprintf(buffer, msgtext,
  144.     err->msg_parm.i[0], err->msg_parm.i[1],
  145.     err->msg_parm.i[2], err->msg_parm.i[3],
  146.     err->msg_parm.i[4], err->msg_parm.i[5],
  147.     err->msg_parm.i[6], err->msg_parm.i[7]);
  148. }
  149. /*
  150.  * Reset error state variables at start of a new image.
  151.  * This is called during compression startup to reset trace/error
  152.  * processing to default state, without losing any application-specific
  153.  * method pointers.  An application might possibly want to override
  154.  * this method if it has additional error processing state.
  155.  */
  156. METHODDEF void
  157. reset_error_mgr (j_common_ptr cinfo)
  158. {
  159.   cinfo->err->num_warnings = 0;
  160.   /* trace_level is not reset since it is an application-supplied parameter */
  161.   cinfo->err->msg_code = 0; /* may be useful as a flag for "no error" */
  162. }
  163. /*
  164.  * Fill in the standard error-handling methods in a jpeg_error_mgr object.
  165.  * Typical call is:
  166.  * struct jpeg_compress_struct cinfo;
  167.  * struct jpeg_error_mgr err;
  168.  *
  169.  * cinfo.err = jpeg_std_error(&err);
  170.  * after which the application may override some of the methods.
  171.  */
  172. GLOBAL struct jpeg_error_mgr *
  173. jpeg_std_error (struct jpeg_error_mgr * err)
  174. {
  175.   err->error_exit = error_exit;
  176.   err->emit_message = emit_message;
  177.   err->output_message = output_message;
  178.   err->format_message = format_message;
  179.   err->reset_error_mgr = reset_error_mgr;
  180.   err->trace_level = 0; /* default = no tracing */
  181.   err->num_warnings = 0; /* no warnings emitted yet */
  182.   err->msg_code = 0; /* may be useful as a flag for "no error" */
  183.   /* Initialize message table pointers */
  184.   err->jpeg_message_table = jpeg_std_message_table;
  185.   err->last_jpeg_message = (int) JMSG_LASTMSGCODE - 1;
  186.   err->addon_message_table = NULL;
  187.   err->first_addon_message = 0; /* for safety */
  188.   err->last_addon_message = 0;
  189.   return err;
  190. }