| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % U U RRRR L % |
| % U U R R L % |
| % U U RRRR L % |
| % U U R R L % |
| % UUU R R LLLLL % |
| % % |
| % % |
| % Retrieve An Image Via URL. % |
| % % |
| % Software Design % |
| % Cristy % |
| % Bill Radcliffe % |
| % March 2000 % |
| % % |
| % % |
| % Copyright 1999-2021 ImageMagick Studio LLC, a non-profit organization % |
| % dedicated to making software imaging solutions freely available. % |
| % % |
| % You may not use this file except in compliance with the License. You may % |
| % obtain a copy of the License at % |
| % % |
| % https://imagemagick.org/script/license.php % |
| % % |
| % Unless required by applicable law or agreed to in writing, software % |
| % distributed under the License is distributed on an "AS IS" BASIS, % |
| % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. % |
| % See the License for the specific language governing permissions and % |
| % limitations under the License. % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % |
| */ |
| |
| /* |
| Include declarations. |
| */ |
| #include "MagickCore/studio.h" |
| #include "MagickCore/blob.h" |
| #include "MagickCore/blob-private.h" |
| #include "MagickCore/constitute.h" |
| #include "MagickCore/exception.h" |
| #include "MagickCore/exception-private.h" |
| #include "MagickCore/image.h" |
| #include "MagickCore/image-private.h" |
| #include "MagickCore/list.h" |
| #include "MagickCore/magick.h" |
| #include "MagickCore/memory_.h" |
| #include "MagickCore/module.h" |
| #include "MagickCore/quantum-private.h" |
| #include "MagickCore/static.h" |
| #include "MagickCore/resource_.h" |
| #include "MagickCore/string_.h" |
| #include "MagickCore/utility.h" |
| #if defined(MAGICKCORE_XML_DELEGATE) |
| # if defined(MAGICKCORE_WINDOWS_SUPPORT) |
| # if !defined(__MINGW32__) |
| # include <win32config.h> |
| # endif |
| # endif |
| # include <libxml/parser.h> |
| # include <libxml/xmlmemory.h> |
| # include <libxml/nanoftp.h> |
| # include <libxml/nanohttp.h> |
| #endif |
| #if defined(MAGICKCORE_WINDOWS_SUPPORT) && \ |
| !defined(__MINGW32__) |
| # include <urlmon.h> |
| # pragma comment(lib, "urlmon.lib") |
| #endif |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e a d U R L I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % ReadURLImage retrieves an image via URL, decodes the image, and returns |
| % it. It allocates the memory necessary for the new Image structure and |
| % returns a pointer to the new image. |
| % |
| % The format of the ReadURLImage method is: |
| % |
| % Image *ReadURLImage(const ImageInfo *image_info,ExceptionInfo *exception) |
| % |
| % A description of each parameter follows: |
| % |
| % o image_info: the image info. |
| % |
| % o exception: return any errors or warnings in this structure. |
| % |
| */ |
| |
| #if defined(__cplusplus) || defined(c_plusplus) |
| extern "C" { |
| #endif |
| |
| #if defined(MAGICKCORE_XML_DELEGATE) && defined(LIBXML_FTP_ENABLED) |
| static void GetFTPData(void *userdata,const char *data,int size) |
| { |
| FILE |
| *file; |
| |
| size_t |
| length; |
| |
| file=(FILE *) userdata; |
| if (file == (FILE *) NULL) |
| return; |
| if (size <= 0) |
| return; |
| length=fwrite(data,size,1,file); |
| (void) length; |
| } |
| #endif |
| |
| #if defined(__cplusplus) || defined(c_plusplus) |
| } |
| #endif |
| |
| static Image *ReadURLImage(const ImageInfo *image_info,ExceptionInfo *exception) |
| { |
| char |
| filename[MagickPathExtent]; |
| |
| FILE |
| *file; |
| |
| Image |
| *image, |
| *images, |
| *next; |
| |
| ImageInfo |
| *read_info; |
| |
| int |
| unique_file; |
| |
| images=(Image *) NULL; |
| image=AcquireImage(image_info,exception); |
| read_info=CloneImageInfo(image_info); |
| SetImageInfoBlob(read_info,(void *) NULL,0); |
| #if !defined(MAGICKCORE_WINDOWS_SUPPORT) || defined(__MINGW32__) |
| if (LocaleCompare(read_info->magick,"https") == 0) |
| { |
| MagickBooleanType |
| status; |
| |
| /* |
| Leverage delegate to read HTTPS link. |
| */ |
| status=InvokeDelegate(read_info,image,"https:decode",(char *) NULL, |
| exception); |
| if (status != MagickFalse) |
| { |
| (void) FormatLocaleString(read_info->filename,MagickPathExtent, |
| "%s.dat",read_info->unique); |
| *read_info->magick='\0'; |
| images=ReadImage(read_info,exception); |
| (void) RelinquishUniqueFileResource(read_info->filename); |
| if (images != (Image *) NULL) |
| for (next=images; next != (Image *) NULL; next=next->next) |
| (void) CopyMagickString(next->filename,image->filename, |
| MagickPathExtent); |
| } |
| read_info=DestroyImageInfo(read_info); |
| image=DestroyImage(image); |
| return(images); |
| } |
| #endif |
| if (LocaleCompare(read_info->magick,"file") == 0) |
| { |
| (void) CopyMagickString(read_info->filename,image_info->filename+2, |
| MagickPathExtent); |
| *read_info->magick='\0'; |
| images=ReadImage(read_info,exception); |
| read_info=DestroyImageInfo(read_info); |
| image=DestroyImage(image); |
| return(GetFirstImageInList(images)); |
| } |
| file=(FILE *) NULL; |
| unique_file=AcquireUniqueFileResource(read_info->filename); |
| if (unique_file != -1) |
| file=fdopen(unique_file,"wb"); |
| if ((unique_file == -1) || (file == (FILE *) NULL)) |
| { |
| ThrowFileException(exception,FileOpenError,"UnableToCreateTemporaryFile", |
| read_info->filename); |
| read_info=DestroyImageInfo(read_info); |
| image=DestroyImage(image); |
| return((Image *) NULL); |
| } |
| (void) CopyMagickString(filename,image_info->magick,MagickPathExtent); |
| (void) ConcatenateMagickString(filename,":",MagickPathExtent); |
| LocaleLower(filename); |
| (void) ConcatenateMagickString(filename,image_info->filename, |
| MagickPathExtent); |
| #if defined(MAGICKCORE_WINDOWS_SUPPORT) && !defined(__MINGW32__) |
| (void) fclose(file); |
| if (URLDownloadToFile(NULL,filename,read_info->filename,0,NULL) != S_OK) |
| { |
| ThrowFileException(exception,FileOpenError,"UnableToOpenFile", |
| filename); |
| (void) RelinquishUniqueFileResource(read_info->filename); |
| read_info=DestroyImageInfo(read_info); |
| image=DestroyImage(image); |
| return((Image *) NULL); |
| } |
| #else |
| #if defined(MAGICKCORE_XML_DELEGATE) && defined(LIBXML_FTP_ENABLED) |
| if (LocaleCompare(read_info->magick,"ftp") == 0) |
| { |
| void |
| *context; |
| |
| xmlNanoFTPInit(); |
| context=xmlNanoFTPNewCtxt(filename); |
| if (context != (void *) NULL) |
| { |
| if (xmlNanoFTPConnect(context) >= 0) |
| (void) xmlNanoFTPGet(context,GetFTPData,(void *) file, |
| (char *) NULL); |
| (void) xmlNanoFTPClose(context); |
| } |
| } |
| #endif |
| #if defined(MAGICKCORE_XML_DELEGATE) && defined(LIBXML_HTTP_ENABLED) |
| if (LocaleCompare(read_info->magick,"http") == 0) |
| { |
| char |
| buffer[8192], |
| *type; |
| |
| int |
| bytes; |
| |
| void |
| *context; |
| |
| type=(char *) NULL; |
| context=xmlNanoHTTPMethod(filename,(const char *) NULL, |
| (const char *) NULL,&type,(const char *) NULL,0); |
| if (context != (void *) NULL) |
| { |
| ssize_t |
| count; |
| |
| while ((bytes=xmlNanoHTTPRead(context,buffer,sizeof(buffer))) > 0) |
| count=(ssize_t) fwrite(buffer,bytes,1,file); |
| (void) count; |
| xmlNanoHTTPClose(context); |
| xmlFree(type); |
| xmlNanoHTTPCleanup(); |
| } |
| } |
| #endif |
| (void) fclose(file); |
| #endif |
| *read_info->magick='\0'; |
| images=ReadImage(read_info,exception); |
| (void) RelinquishUniqueFileResource(read_info->filename); |
| if (images != (Image *) NULL) |
| for (next=images; next != (Image *) NULL; next=next->next) |
| (void) CopyMagickString(next->filename,image->filename,MagickPathExtent); |
| read_info=DestroyImageInfo(read_info); |
| image=DestroyImage(image); |
| if (images != (Image *) NULL) |
| GetPathComponent(image_info->filename,TailPath,images->filename); |
| else |
| { |
| (void) ThrowMagickException(exception,GetMagickModule(),CoderError, |
| "NoDataReturned","`%s'",filename); |
| return((Image *) NULL); |
| } |
| return(GetFirstImageInList(images)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e g i s t e r U R L I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RegisterURLImage() adds attributes for the URL image format to |
| % the list of supported formats. The attributes include the image format |
| % tag, a method to read and/or write the format, whether the format |
| % supports the saving of more than one frame to the same file or blob, |
| % whether the format supports native in-memory I/O, and a brief |
| % description of the format. |
| % |
| % The format of the RegisterURLImage method is: |
| % |
| % size_t RegisterURLImage(void) |
| % |
| */ |
| ModuleExport size_t RegisterURLImage(void) |
| { |
| MagickInfo |
| *entry; |
| |
| entry=AcquireMagickInfo("URL","HTTP","Uniform Resource Locator (http://)"); |
| #if (defined(MAGICKCORE_WINDOWS_SUPPORT) && \ |
| !defined(__MINGW32__)) || \ |
| (defined(MAGICKCORE_XML_DELEGATE) && defined(LIBXML_HTTP_ENABLED)) |
| entry->decoder=(DecodeImageHandler *) ReadURLImage; |
| #endif |
| entry->format_type=ImplicitFormatType; |
| (void) RegisterMagickInfo(entry); |
| entry=AcquireMagickInfo("URL","HTTPS","Uniform Resource Locator (https://)"); |
| entry->decoder=(DecodeImageHandler *) ReadURLImage; |
| entry->format_type=ImplicitFormatType; |
| (void) RegisterMagickInfo(entry); |
| entry=AcquireMagickInfo("URL","FTP","Uniform Resource Locator (ftp://)"); |
| #if (defined(MAGICKCORE_WINDOWS_SUPPORT) && \ |
| !defined(__MINGW32__)) || \ |
| (defined(MAGICKCORE_XML_DELEGATE) && defined(LIBXML_FTP_ENABLED)) |
| entry->decoder=(DecodeImageHandler *) ReadURLImage; |
| #endif |
| entry->format_type=ImplicitFormatType; |
| (void) RegisterMagickInfo(entry); |
| entry=AcquireMagickInfo("URL","FILE","Uniform Resource Locator (file://)"); |
| entry->decoder=(DecodeImageHandler *) ReadURLImage; |
| entry->format_type=ImplicitFormatType; |
| (void) RegisterMagickInfo(entry); |
| return(MagickImageCoderSignature); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % U n r e g i s t e r U R L I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % UnregisterURLImage() removes format registrations made by the |
| % URL module from the list of supported formats. |
| % |
| % The format of the UnregisterURLImage method is: |
| % |
| % UnregisterURLImage(void) |
| % |
| */ |
| ModuleExport void UnregisterURLImage(void) |
| { |
| (void) UnregisterMagickInfo("HTTP"); |
| (void) UnregisterMagickInfo("FTP"); |
| (void) UnregisterMagickInfo("FILE"); |
| } |
