libjpeg(2)

/* JPEG解压缩的示例程序。我们假定源文件名被传入。我们想要成功返回1，错误为0。*/struct my_error_mgr{  struct jpeg_error_mgr pub;    /* "public" fields */  jmp_buf setjmp_buffer;        /* for return to caller */};typedef struct my_error_mgr *my_error_ptr;void my_error_exit (j_common_ptr cinfo){  /* cinfo-> err真的指向一个my_error_mgr结构，所以强制指针*/  my_error_ptr myerr = (my_error_ptr) cinfo->err;  /*始终显示消息。*/  /*如果我们选择，我们可以推迟这个，直到返回。*/  (*cinfo->err->output_message) (cinfo);  /*将控制返回到setjmp点*/  longjmp(myerr->setjmp_buffer, 1);}int read_JPEG_file (char *filename){  /*此结构体包含JPEG解压缩参数和指针工作空间（由JPEG库根据需要分配）*/  struct jpeg_decompress_struct cinfo;  /*我们使用我们的专用扩展JPEG错误处理程序。   *请注意，此结构体必须与主要的JPEG参数一样的生存周期，以避免指针问题。   */  struct my_error_mgr jerr;  FILE *infile;                 /* 源文件 */  JSAMPARRAY buffer;            /* 输出行缓冲区*/  int row_stride;               /* 输出缓冲区中的物理行宽 */  /*在这个例子中，我们要做任何事情之前打开输入文件，   *所以下面的setjmp（）错误恢复可以假定文件是打开的。   *使用“b”选项来fopen（）要求它读取二进制文件。   */  if ((infile = fopen(filename, "rb")) == NULL) {    fprintf(stderr, "can't open %s\n", filename);    return 0;  }   /*步骤1：分配和初始化JPEG解压缩对象*/  /*我们设置正常的JPEG错误例程，然后覆盖error_exit。*/  cinfo.err = jpeg_std_error(&jerr.pub);  jerr.pub.error_exit = my_error_exit;     /*建立my_error_exit使用的setjmp返回上下文。*/  if (setjmp(jerr.setjmp_buffer))  {    /*如果我们到达这里，JPEG代码发出了一个错误信号。     *我们需要清理JPEG对象，关闭输入文件并返回。     */    jpeg_destroy_decompress(&cinfo);    fclose(infile);    return 0;  }   /*现在我们可以初始化JPEG解压缩对象。*/  jpeg_create_decompress(&cinfo);  /*步骤2：指定数据源（例如，文件）*/  jpeg_stdio_src(&cinfo, infile);  /*步骤3：使用jpeg_read_header（）*/  (void) jpeg_read_header(&cinfo, TRUE);  /*我们可以忽略来自jpeg_read_header的返回值   *（a）stdio数据源不可能暂停，   *（b）我们通过TRUE来拒绝仅表格的JPEG文件作为错误。   */   /*步骤4：设置解压缩参数*/   /*在本示例中，我们不需要更改任何设置的默认值    * jpeg_read_header（），所以我们什么也不做。    */  /*步骤5：启动解压缩器*/  (void) jpeg_start_decompress(&cinfo);   /*我们可以忽略返回值，因为暂停是不可能的与stdio数据源。*/  /*在阅读之前，我们可能需要做一些我们自己的设置数据。   *在jpeg_start_decompress（）之后，我们有正确的缩放   *输出图像尺寸可用，以及输出颜色图   *如果我们要求颜色量化。   *在这个例子中，我们需要制作一个正确大小的输出工作缓冲区。   */     /*输出缓冲区中每行的JSAMPLE */  row_stride = cinfo.output_width * cinfo.output_components;  /*制作一行高的样本数组，当完成图像*/  buffer = (*cinfo.mem->alloc_sarray)                ((j_common_ptr) &cinfo, JPOOL_IMAGE, row_stride, 1);  /*步骤6：while（扫描线仍然被读取）*/  /* jpeg_read_scanlines（...）; */  /*这里我们使用库的状态变量cinfo.output_scanline作为循环计数器*/  while (cinfo.output_scanline < cinfo.output_height)  {    /* jpeg_read_scanlines需要一组指向扫描线的指针。     *这里的数组只有一个元素长，但你可以要求一次扫描线一次，如果这样更方便。     */    (void) jpeg_read_scanlines(&cinfo, buffer, 1);    /*假设put_scanline_someplace需要一个指针和样本计数。*/    put_scanline_someplace(buffer[0], row_stride);  }  /*步骤7：完成减压*/  (void) jpeg_finish_decompress(&cinfo);     /*我们可以忽略返回值，因为暂停是不可能的与stdio数据源。*/      /*第8步：释放JPEG解压缩对象*/   /*这是一个重要的步骤，因为它会释放大量的内存。*/  jpeg_destroy_decompress(&cinfo);  /*在finish_decompress之后，我们可以关闭输入文件。   *这里我们推迟它，直到没有更多的JPEG错误是可能的，以便简化上面的setjmp错误逻辑。   */  fclose(infile); /*此时，您可能需要检查是否有损坏的数据发生警告（测试jerr.pub.num_warnings是否为零）*/  return 1;}