Files
ImageMagick-mirror/coders/url.c
T
2026-01-11 10:16:12 +01:00

299 lines
12 KiB
C

/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% 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 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/license/ %
% %
% 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/delegate.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/nt-base-private.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_WINDOWS_SUPPORT)
# include <urlmon.h>
# if !defined(__MINGW32__)
# pragma comment(lib, "urlmon.lib")
# endif
#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(MAGICKCORE_WINDOWS_SUPPORT)
static Image* InvokeURLDelegate(ImageInfo* read_info,Image* image,
const char *delegate,ExceptionInfo* exception)
{
Image
*images,
*next;
MagickBooleanType
status;
images=(Image *) NULL;
status=InvokeDelegate(read_info,image,delegate,(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);
}
return(images);
}
#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)
if (LocaleCompare(read_info->magick,"http") == 0)
{
images=InvokeURLDelegate(read_info,image,"http:decode",exception);
read_info=DestroyImageInfo(read_info);
image=DestroyImage(image);
return(images);
}
if (LocaleCompare(read_info->magick,"https") == 0)
{
images=InvokeURLDelegate(read_info,image,"https:decode",exception);
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)
(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
(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://)");
entry->decoder=(DecodeImageHandler *) ReadURLImage;
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)
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");
}