Parameters

• func [In]
  pointer to the new URL to filename conversion function. This function should read input URL (passed in s), then it should check if it evaluates to filename. If it does it should extract that filename and put it back into s. New function should return one of the following :
  • PIL_ROOTNAME_FILE
    if URL evaluates to filename. For instance file://some/file.fits[1] or simply /some/file.fits. In both cases the filename stored in s will be /some/file.fits (assuming default PIL's conversion function).
  • PIL_ROOTNAME_NOTFILE
    if URL does not evaluate to filename
  • PIL_ROOTNAME_STDIN
    if URL specifies standard input stream (stdin/STDIN for instance)
  • PIL_ROOTNAME_STDOUT
    if URL specifies standard input stream (stdout/STDOUT for instance)
  • PIL_ROOTNAME_STDINOUT
    if URL specifies standard input stream ('-' for instance)
  • other value
    generic error code, like NULL pointers, PIL not initialized, etc...