GraphicsMagick 的 OpenCL 开发记录（十六）

<2022-04-01 Fri>

关于AcquireCriticalMemory()函数的异常处理（一）

不太好给AcquireCriticalMemory()添加异常处理，GraphicsMagick中定义好的内存分配失败的异常就那么几个，查找所有调用AcquireCriticalMemory()的地方，发现有给StringInfo，有给ImageInfo，还有给MagickCLCacheInfo等等分配内存的，在每个调用AcquireCriticalMemory()的地方抛出异常是可行的，可以使用GraphicsMagick中已定义好的异常类型，比如StringInfo可以用UnableToAllocateString来代替，ImageInfo可以用UnableToAllocateImage，MagickCLCacheInfo可能需要增加一个异常类型；或者在AcquireCriticalMemory()函数内部处理异常，这正是ImageMagick的处理方式，但是这样的话在AcquireCriticalMemory()内部不能明确表达出是哪种类型操作产生的异常。当然可以通过增加参数来解决，但是处理起来同样很麻烦。

目前我修改的函数是这样的，固定了它的类型为UnableToAllocateModuleInfo，没有把此修改放到源代码里，目前仅存在笔记里：

MagickExport void *AcquireCriticalMemory(const size_t len)
{
  void
    *memory;

  // Fail if memory request cannot be fulfilled.
  memory=MagickMalloc(len);
  if (memory == (void *) NULL)
    MagickFatalError3(ResourceLimitFatalError,MemoryAllocationFailed,
      UnableToAllocateModuleInfo);
  return(memory);
}

<2022-04-02 Sat>

关于AcquireCriticalMemory()函数的异常处理（二）

了解了一下GraphicsMagick的异常处理，可以这么来用：

MagickExport void *AcquireCriticalMemory(const size_t len)
{
  void
    *memory;

  ExceptionInfo
    exception;

  GetExceptionInfo(&exception);

  // Fail if memory request cannot be fulfilled.
  memory=MagickMalloc(len);
  if (memory == (void *) NULL)
    ThrowException(&exception,ResourceLimitError,MemoryAllocationFailed,
      "AcquireCriticalMemory");
  return(memory);
}

但是发现如果memory为空时ThrowException()并不能结束掉程序，它最终调用的是ThrowLoggedException()函数将其记录下来。也可以这么使用：

MagickExport void *AcquireCriticalMemory(const size_t len)
{
  void
    *memory;

  // Fail if memory request cannot be fulfilled.
  memory=MagickMalloc(len);
  if (memory == (void *) NULL)
    MagickFatalError(ResourceLimitFatalError,MemoryAllocationFailed,
      "ocl: AcquireCriticalMemory");
  return(memory);
}

这是我当前使用的方案，当指针为0时它结束掉程序，打印出如下的信息：

[ysouyno@arch gm-ocl]$ gm display ~/temp/bg1a.jpg
gm display: Memory allocation failed (ocl: AcquireCriticalMemory) [Resource temporarily unavailable].

如果能把输出的信息弄得再详细点儿就更好了。

值得注意的是在GraphicsMagick中有MagickFatalError()，MagickFatalError2()和MagickFatalError3()三个功能相似的函数，MagickFatalError()可以使用字符串做为参数，MagickFatalError2()也可以使用字符串做为参数，但是它与MagickFatalError()的具体应用场景还不太了解，MagickFatalError3()只能使用预定义的异常类型。

见commit：for AcquireCriticalMemory。