/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%     CCCC   OOO   N   N  SSSSS  TTTTT  IIIII  TTTTT  U   U  TTTTT  EEEEE     %

%    C      O   O  NN  N  SS       T      I      T    U   U    T    E         %

%    C      O   O  N N N  ESSS     T      I      T    U   U    T    EEE       %

%    C      O   O  N  NN     SS    T      I      T    U   U    T    E         %

%     CCCC   OOO   N   N  SSSSS    T    IIIII    T     UUU     T    EEEEE     %

%                                                                             %

%                                                                             %

%                  MagickCore Methods to Constitute an Image                  %

%                                                                             %

%                             Software Design                                 %

%                                  Cristy                                     %

%                               October 1998                                  %

%                                                                             %

%                                                                             %

%  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/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/attribute.h"

#include "MagickCore/blob.h"

#include "MagickCore/blob-private.h"

#include "MagickCore/exception.h"

#include "MagickCore/exception-private.h"

#include "MagickCore/cache.h"

#include "MagickCore/client.h"

#include "MagickCore/coder-private.h"

#include "MagickCore/colorspace-private.h"

#include "MagickCore/constitute.h"

#include "MagickCore/constitute-private.h"

#include "MagickCore/delegate.h"

#include "MagickCore/geometry.h"

#include "MagickCore/identify.h"

#include "MagickCore/image-private.h"

#include "MagickCore/list.h"

#include "MagickCore/magick.h"

#include "MagickCore/memory_.h"

#include "MagickCore/monitor.h"

#include "MagickCore/monitor-private.h"

#include "MagickCore/option.h"

#include "MagickCore/pixel.h"

#include "MagickCore/pixel-accessor.h"

#include "MagickCore/policy.h"

#include "MagickCore/profile.h"

#include "MagickCore/profile-private.h"

#include "MagickCore/property.h"

#include "MagickCore/quantum.h"

#include "MagickCore/resize.h"

#include "MagickCore/resource_.h"

#include "MagickCore/semaphore.h"

#include "MagickCore/statistic.h"

#include "MagickCore/stream.h"

#include "MagickCore/string_.h"

#include "MagickCore/string-private.h"

#include "MagickCore/timer.h"

#include "MagickCore/timer-private.h"

#include "MagickCore/token.h"

#include "MagickCore/transform.h"

#include "MagickCore/utility.h"

#include "MagickCore/utility-private.h"

/*

  Define declarations.

*/

#define MaxReadRecursionDepth  100

/*

  Typedef declarations.

*/

typedef struct _ConstituteInfo

{

  const char

    *caption,

    *comment,

    *dispose,

    *label;

  MagickBooleanType

    sync_from_exif,

    sync_from_tiff;

  MagickStatusType

    delay_flags;

  size_t

    delay;

  ssize_t

    ticks_per_second;

} ConstituteInfo;

/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%   C o n s t i t u t e I m a g e                                             %

%                                                                             %

%                                                                             %

%                                                                             %

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%

%  ConstituteImage() returns an image from the pixel data you supply.

%  The pixel data must be in scanline order top-to-bottom.  The data can be

%  char, short int, int, float, or double.  Float and double require the

%  pixels to be normalized [0..1], otherwise [0..QuantumRange].  For example, to

%  create a 640x480 image from unsigned red-green-blue character data, use:

%

%      image = ConstituteImage(640,480,"RGB",CharPixel,pixels,&exception);

%

%  The format of the ConstituteImage method is:

%

%      Image *ConstituteImage(const size_t columns,const size_t rows,

%        const char *map,const StorageType storage,const void *pixels,

%        ExceptionInfo *exception)

%

%  A description of each parameter follows:

%

%    o columns: width in pixels of the image.

%

%    o rows: height in pixels of the image.

%

%    o map:  This string reflects the expected ordering of the pixel array.

%      It can be any combination or order of R = red, G = green, B = blue,

%      A = alpha (0 is transparent), O = opacity (0 is opaque), C = cyan,

%      Y = yellow, M = magenta, K = black, I = intensity (for grayscale),

%      P = pad.

%

%    o storage: Define the data type of the pixels.  Float and double types are

%      expected to be normalized [0..1] otherwise [0..QuantumRange].  Choose

%      from these types: CharPixel, DoublePixel, FloatPixel, IntegerPixel,

%      LongPixel, QuantumPixel, or ShortPixel.

%

%    o pixels: This array of values contain the pixel components as defined by

%      map and type.  You must preallocate this array where the expected

%      length varies depending on the values of width, height, map, and type.

%

%    o exception: return any errors or warnings in this structure.

%

*/

MagickExport Image *ConstituteImage(const size_t columns,const size_t rows,

  const char *map,const StorageType storage,const void *pixels,

  ExceptionInfo *exception)

{

  Image

    *image;

  MagickBooleanType

    status;

  ssize_t

    i;

  size_t

    length;

  /*

    Allocate image structure.

  */

  assert(map != (const char *) NULL);

  assert(pixels != (void *) NULL);

  assert(exception != (ExceptionInfo *) NULL);

  assert(exception->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",map);

  image=AcquireImage((ImageInfo *) NULL,exception);

  if (image == (Image *) NULL)

    return((Image *) NULL);

  switch (storage)

  {

    case CharPixel: image->depth=8*sizeof(unsigned char); break;

    case DoublePixel: image->depth=8*sizeof(double); break;

    case FloatPixel: image->depth=8*sizeof(float); break;

    case LongPixel: image->depth=8*sizeof(unsigned long); break;

    case LongLongPixel: image->depth=8*sizeof(MagickSizeType); break;

    case ShortPixel: image->depth=8*sizeof(unsigned short); break;

    default: break;

  }

  length=strlen(map);

  for (i=0; i < (ssize_t) length; i++)

  {

    switch (map[i])

    {

      case 'a':

      case 'A':

      case 'O':

      case 'o':

      {

        image->alpha_trait=BlendPixelTrait;

        break;

      }

      case 'C':

      case 'c':

      case 'm':

      case 'M':

      case 'Y':

      case 'y':

      case 'K':

      case 'k':

      {

        image->colorspace=CMYKColorspace;

        break;

      }

      case 'I':

      case 'i':

      {

        image->colorspace=GRAYColorspace;

        break;

      }

      default:

      {

        if (length == 1)

          image->colorspace=GRAYColorspace;

        break;

      }

    }

  }

  status=SetImageExtent(image,columns,rows,exception);

  if (status == MagickFalse)

    return(DestroyImageList(image));

  status=ResetImagePixels(image,exception);

  if (status == MagickFalse)

    return(DestroyImageList(image));

  status=ImportImagePixels(image,0,0,columns,rows,map,storage,pixels,exception);

  if (status == MagickFalse)

    image=DestroyImage(image);

  return(image);

}

/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%   P i n g I m a g e                                                         %

%                                                                             %

%                                                                             %

%                                                                             %

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%

%  PingImage() returns all the properties of an image or image sequence

%  except for the pixels.  It is much faster and consumes far less memory

%  than ReadImage().  On failure, a NULL image is returned and exception

%  describes the reason for the failure.

%

%  The format of the PingImage method is:

%

%      Image *PingImage(const ImageInfo *image_info,ExceptionInfo *exception)

%

%  A description of each parameter follows:

%

%    o image_info: Ping the image defined by the file or filename members of

%      this structure.

%

%    o exception: return any errors or warnings in this structure.

%

*/

#if defined(__cplusplus) || defined(c_plusplus)

extern "C" {

#endif

static size_t PingStream(const Image *magick_unused(image),

  const void *magick_unused(pixels),const size_t columns)

{

  magick_unreferenced(image);

  magick_unreferenced(pixels);

  return(columns);

}

#if defined(__cplusplus) || defined(c_plusplus)

}

#endif

MagickExport Image *PingImage(const ImageInfo *image_info,

  ExceptionInfo *exception)

{

  Image

    *image;

  ImageInfo

    *ping_info;

  assert(image_info != (ImageInfo *) NULL);

  assert(image_info->signature == MagickCoreSignature);

  assert(exception != (ExceptionInfo *) NULL);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",

      image_info->filename);

  ping_info=CloneImageInfo(image_info);

  ping_info->ping=MagickTrue;

  image=ReadStream(ping_info,&PingStream,exception);

  if (image != (Image *) NULL)

    {

      ResetTimer(&image->timer);

      if (ping_info->verbose != MagickFalse)

        (void) IdentifyImage(image,stdout,MagickFalse,exception);

    }

  ping_info=DestroyImageInfo(ping_info);

  return(image);

}

/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%   P i n g I m a g e s                                                       %

%                                                                             %

%                                                                             %

%                                                                             %

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%

%  PingImages() pings one or more images and returns them as an image list.

%

%  The format of the PingImage method is:

%

%      Image *PingImages(ImageInfo *image_info,const char *filename,

%        ExceptionInfo *exception)

%

%  A description of each parameter follows:

%

%    o image_info: the image info.

%

%    o filename: the image filename.

%

%    o exception: return any errors or warnings in this structure.

%

*/

MagickExport Image *PingImages(ImageInfo *image_info,const char *filename,

  ExceptionInfo *exception)

{

  char

    ping_filename[MagickPathExtent];

  Image

    *image,

    *images;

  ImageInfo

    *read_info;

  /*

    Ping image list from a file.

  */

  assert(image_info != (ImageInfo *) NULL);

  assert(image_info->signature == MagickCoreSignature);

  assert(exception != (ExceptionInfo *) NULL);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",

      image_info->filename);

  (void) SetImageOption(image_info,"filename",filename);

  (void) CopyMagickString(image_info->filename,filename,MagickPathExtent);

  (void) InterpretImageFilename(image_info,(Image *) NULL,image_info->filename,

    (int) image_info->scene,ping_filename,exception);

  if (LocaleCompare(ping_filename,image_info->filename) != 0)

    {

      ExceptionInfo

        *sans;

      ssize_t

        extent,

        scene;

      /*

        Images of the form image-%d.png[1-5].

      */

      read_info=CloneImageInfo(image_info);

      sans=AcquireExceptionInfo();

      (void) SetImageInfo(read_info,0,sans);

      sans=DestroyExceptionInfo(sans);

      if (read_info->number_scenes == 0)

        {

          read_info=DestroyImageInfo(read_info);

          return(PingImage(image_info,exception));

        }

      (void) CopyMagickString(ping_filename,read_info->filename,

        MagickPathExtent);

      images=NewImageList();

      extent=(ssize_t) (read_info->scene+read_info->number_scenes);

      for (scene=(ssize_t) read_info->scene; scene < (ssize_t) extent; scene++)

      {

        (void) InterpretImageFilename(image_info,(Image *) NULL,ping_filename,

          (int) scene,read_info->filename,exception);

        image=PingImage(read_info,exception);

        if (image == (Image *) NULL)

          continue;

        AppendImageToList(&images,image);

      }

      read_info=DestroyImageInfo(read_info);

      return(images);

    }

  return(PingImage(image_info,exception));

}

/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%   R e a d I m a g e                                                         %

%                                                                             %

%                                                                             %

%                                                                             %

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%

%  ReadImage() reads an image or image sequence from a file or file handle.

%  The method returns a NULL if there is a memory shortage or if the image

%  cannot be read.  On failure, a NULL image is returned and exception

%  describes the reason for the failure.

%

%  The format of the ReadImage method is:

%

%      Image *ReadImage(const ImageInfo *image_info,ExceptionInfo *exception)

%

%  A description of each parameter follows:

%

%    o image_info: Read the image defined by the file or filename members of

%      this structure.

%

%    o exception: return any errors or warnings in this structure.

%

*/

static MagickBooleanType IsCoderAuthorized(const char *coder,

  const PolicyRights rights,ExceptionInfo *exception)

{

  if (IsRightsAuthorized(CoderPolicyDomain,rights,coder) == MagickFalse)

    {

      errno=EPERM;

      (void) ThrowMagickException(exception,GetMagickModule(),PolicyError,

        "NotAuthorized","`%s'",coder);

      return(MagickFalse);

    }

  return(MagickTrue);

}

static void InitializeConstituteInfo(const ImageInfo *image_info,

  ConstituteInfo *constitute_info)

{

  const char

    *option;

  memset(constitute_info,0,sizeof(*constitute_info));

  constitute_info->sync_from_exif=MagickTrue;

  constitute_info->sync_from_tiff=MagickTrue;

  option=GetImageOption(image_info,"exif:sync-image");

  if (IsStringFalse(option) != MagickFalse)

    constitute_info->sync_from_exif=MagickFalse;

  option=GetImageOption(image_info,"tiff:sync-image");

  if (IsStringFalse(option) != MagickFalse)

    constitute_info->sync_from_tiff=MagickFalse;

  constitute_info->caption=GetImageOption(image_info,"caption");

  constitute_info->comment=GetImageOption(image_info,"comment");

  constitute_info->label=GetImageOption(image_info,"label");

  option=GetImageOption(image_info,"delay");

  if (option != (const char *) NULL)

    {

      GeometryInfo

        geometry_info;

      constitute_info->delay_flags=ParseGeometry(option,&geometry_info);

      if (constitute_info->delay_flags != NoValue)

        {

          constitute_info->delay=(size_t) floor(geometry_info.rho+0.5);

          if ((constitute_info->delay_flags & SigmaValue) != 0)

            constitute_info->ticks_per_second=CastDoubleToSsizeT(floor(

              geometry_info.sigma+0.5));

        }

    }

}

static void SyncOrientationFromProperties(Image *image,

  ConstituteInfo *constitute_info,ExceptionInfo *exception)

{

  const char

    *orientation;

  orientation=(const char *) NULL;

  if (constitute_info->sync_from_exif != MagickFalse)

    {

      orientation=GetImageProperty(image,"exif:Orientation",exception);

      if (orientation != (const char *) NULL)

        {

          image->orientation=(OrientationType) StringToLong(orientation);

          (void) DeleteImageProperty(image,"exif:Orientation");

        }

    }

  if ((orientation == (const char *) NULL) &&

      (constitute_info->sync_from_tiff != MagickFalse))

    {

      orientation=GetImageProperty(image,"tiff:Orientation",exception);

      if (orientation != (const char *) NULL)

        {

          image->orientation=(OrientationType) StringToLong(orientation);

          (void) DeleteImageProperty(image,"tiff:Orientation");

        }

    }

}

static void SyncResolutionFromProperties(Image *image,

  ConstituteInfo *constitute_info, ExceptionInfo *exception)

{

  const char

    *resolution_x,

    *resolution_y,

    *resolution_units;

  MagickBooleanType

    used_tiff;

  resolution_x=(const char *) NULL;

  resolution_y=(const char *) NULL;

  resolution_units=(const char *) NULL;

  used_tiff=MagickFalse;

  if (constitute_info->sync_from_exif != MagickFalse)

    {

      resolution_x=GetImageProperty(image,"exif:XResolution",exception);

      resolution_y=GetImageProperty(image,"exif:YResolution",exception);

      if ((resolution_x != (const char *) NULL) &&

          (resolution_y != (const char *) NULL))

        resolution_units=GetImageProperty(image,"exif:ResolutionUnit",

          exception);

    }

  if ((resolution_x == (const char *) NULL) &&

      (resolution_y == (const char *) NULL) &&

      (constitute_info->sync_from_tiff != MagickFalse))

    {

      resolution_x=GetImageProperty(image,"tiff:XResolution",exception);

      resolution_y=GetImageProperty(image,"tiff:YResolution",exception);

      if ((resolution_x != (const char *) NULL) &&

          (resolution_y != (const char *) NULL))

        {

          used_tiff=MagickTrue;

          resolution_units=GetImageProperty(image,"tiff:ResolutionUnit",

            exception);

        }

    }

  if ((resolution_x != (const char *) NULL) &&

      (resolution_y != (const char *) NULL))

    {

      GeometryInfo

        geometry_info;

      ssize_t

        option_type;

      geometry_info.rho=image->resolution.x;

      geometry_info.sigma=1.0;

      (void) ParseGeometry(resolution_x,&geometry_info);

      if (geometry_info.sigma != 0)

        image->resolution.x=geometry_info.rho/geometry_info.sigma;

      if (strchr(resolution_x,',') != (char *) NULL)

        image->resolution.x=geometry_info.rho+geometry_info.sigma/1000.0;

      geometry_info.rho=image->resolution.y;

      geometry_info.sigma=1.0;

      (void) ParseGeometry(resolution_y,&geometry_info);

      if (geometry_info.sigma != 0)

        image->resolution.y=geometry_info.rho/geometry_info.sigma;

      if (strchr(resolution_y,',') != (char *) NULL)

        image->resolution.y=geometry_info.rho+geometry_info.sigma/1000.0;

      if (resolution_units != (char *) NULL)

        {

          option_type=ParseCommandOption(MagickResolutionOptions,MagickFalse,

            resolution_units);

          if (option_type >= 0)

            image->units=(ResolutionType) option_type;

        }

      if (used_tiff == MagickFalse)

        {

          (void) DeleteImageProperty(image,"exif:XResolution");

          (void) DeleteImageProperty(image,"exif:YResolution");

          (void) DeleteImageProperty(image,"exif:ResolutionUnit");

        }

      else

        {

          (void) DeleteImageProperty(image,"tiff:XResolution");

          (void) DeleteImageProperty(image,"tiff:YResolution");

          (void) DeleteImageProperty(image,"tiff:ResolutionUnit");

        }

    }

}

MagickExport Image *ReadImage(const ImageInfo *image_info,

  ExceptionInfo *exception)

{

  char

    filename[MagickPathExtent],

    magick[MagickPathExtent],

    magick_filename[MagickPathExtent];

  ConstituteInfo

    constitute_info;

  const DelegateInfo

    *delegate_info;

  const MagickInfo

    *magick_info;

  DecodeImageHandler

    *decoder;

  ExceptionInfo

    *sans_exception;

  Image

    *image,

    *next;

  ImageInfo

    *read_info;

  MagickBooleanType

    status;

  /*

    Determine image type from filename prefix or suffix (e.g. image.jpg).

  */

  assert(image_info != (ImageInfo *) NULL);

  assert(image_info->signature == MagickCoreSignature);

  assert(image_info->filename != (char *) NULL);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",

      image_info->filename);

  assert(exception != (ExceptionInfo *) NULL);

  read_info=CloneImageInfo(image_info);

  (void) CopyMagickString(magick_filename,read_info->filename,MagickPathExtent);

  (void) SetImageInfo(read_info,0,exception);

  (void) CopyMagickString(filename,read_info->filename,MagickPathExtent);

  (void) CopyMagickString(magick,read_info->magick,MagickPathExtent);

  /*

    Call appropriate image reader based on image type.

  */

  sans_exception=AcquireExceptionInfo();

  magick_info=GetMagickInfo(read_info->magick,sans_exception);

  if (sans_exception->severity == PolicyError)

    InheritException(exception,sans_exception);

  sans_exception=DestroyExceptionInfo(sans_exception);

  if (magick_info != (const MagickInfo *) NULL)

    {

      if (GetMagickEndianSupport(magick_info) == MagickFalse)

        read_info->endian=UndefinedEndian;

      else

        if ((image_info->endian == UndefinedEndian) &&

            (GetMagickRawSupport(magick_info) != MagickFalse))

          {

            unsigned long

              lsb_first;

            lsb_first=1;

            read_info->endian=(*(char *) &lsb_first) == 1 ? LSBEndian :

              MSBEndian;

         }

    }

  if ((magick_info != (const MagickInfo *) NULL) &&

      (GetMagickDecoderSeekableStream(magick_info) != MagickFalse))

    {

      image=AcquireImage(read_info,exception);

      (void) CopyMagickString(image->filename,read_info->filename,

        MagickPathExtent);

      status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);

      if (status == MagickFalse)

        {

          read_info=DestroyImageInfo(read_info);

          image=DestroyImage(image);

          return((Image *) NULL);

        }

      if (IsBlobSeekable(image) == MagickFalse)

        {

          /*

            Coder requires a seekable stream.

          */

          *read_info->filename='\0';

          status=ImageToFile(image,read_info->filename,exception);

          if (status == MagickFalse)

            {

              (void) CloseBlob(image);

              read_info=DestroyImageInfo(read_info);

              image=DestroyImage(image);

              return((Image *) NULL);

            }

          read_info->temporary=MagickTrue;

        }

      (void) CloseBlob(image);

      image=DestroyImage(image);

    }

  image=NewImageList();

  decoder=GetImageDecoder(magick_info);

  if (decoder == (DecodeImageHandler *) NULL)

    {

      delegate_info=GetDelegateInfo(read_info->magick,(char *) NULL,exception);

      if (delegate_info == (const DelegateInfo *) NULL)

        {

          (void) SetImageInfo(read_info,0,exception);

          (void) CopyMagickString(read_info->filename,filename,

            MagickPathExtent);

          magick_info=GetMagickInfo(read_info->magick,exception);

          decoder=GetImageDecoder(magick_info);

        }

    }

  if (decoder != (DecodeImageHandler *) NULL)

    {

      /*

        Call appropriate image reader based on image type.

      */

      if ((magick_info != (const MagickInfo *) NULL) &&

          (GetMagickDecoderThreadSupport(magick_info) == MagickFalse))

        LockSemaphoreInfo(magick_info->semaphore);

      status=IsCoderAuthorized(read_info->magick,ReadPolicyRights,exception);

      image=(Image *) NULL;

      if (status != MagickFalse)

        image=decoder(read_info,exception);

      if ((magick_info != (const MagickInfo *) NULL) &&

          (GetMagickDecoderThreadSupport(magick_info) == MagickFalse))

        UnlockSemaphoreInfo(magick_info->semaphore);

    }

  else

    {

      delegate_info=GetDelegateInfo(read_info->magick,(char *) NULL,exception);

      if (delegate_info == (const DelegateInfo *) NULL)

        {

          (void) ThrowMagickException(exception,GetMagickModule(),

            MissingDelegateError,"NoDecodeDelegateForThisImageFormat","`%s'",

            read_info->magick);

          if (read_info->temporary != MagickFalse)

            (void) RelinquishUniqueFileResource(read_info->filename);

          read_info=DestroyImageInfo(read_info);

          return((Image *) NULL);

        }

      /*

        Let our decoding delegate process the image.

      */

      image=AcquireImage(read_info,exception);

      if (image == (Image *) NULL)

        {

          read_info=DestroyImageInfo(read_info);

          return((Image *) NULL);

        }

      (void) CopyMagickString(image->filename,read_info->filename,

        MagickPathExtent);

      *read_info->filename='\0';

      if (GetDelegateThreadSupport(delegate_info) == MagickFalse)

        LockSemaphoreInfo(delegate_info->semaphore);

      status=InvokeDelegate(read_info,image,read_info->magick,(char *) NULL,

        exception);

      if (GetDelegateThreadSupport(delegate_info) == MagickFalse)

        UnlockSemaphoreInfo(delegate_info->semaphore);

      image=DestroyImageList(image);

      read_info->temporary=MagickTrue;

      if (status != MagickFalse)

        (void) SetImageInfo(read_info,0,exception);

      magick_info=GetMagickInfo(read_info->magick,exception);

      decoder=GetImageDecoder(magick_info);

      if (decoder == (DecodeImageHandler *) NULL)

        {

          if (IsPathAccessible(read_info->filename) != MagickFalse)

            (void) ThrowMagickException(exception,GetMagickModule(),

              MissingDelegateError,"NoDecodeDelegateForThisImageFormat","`%s'",

              read_info->magick);

          else

            ThrowFileException(exception,FileOpenError,"UnableToOpenFile",

              read_info->filename);

          read_info=DestroyImageInfo(read_info);

          return((Image *) NULL);

        }

      /*

        Call appropriate image reader based on image type.

      */

      if (GetMagickDecoderThreadSupport(magick_info) == MagickFalse)

        LockSemaphoreInfo(magick_info->semaphore);

      status=IsCoderAuthorized(read_info->magick,ReadPolicyRights,exception);

      image=(Image *) NULL;

      if (status != MagickFalse)

        image=(decoder)(read_info,exception);

      if (GetMagickDecoderThreadSupport(magick_info) == MagickFalse)

        UnlockSemaphoreInfo(magick_info->semaphore);

    }

  if (read_info->temporary != MagickFalse)

    {

      (void) RelinquishUniqueFileResource(read_info->filename);

      read_info->temporary=MagickFalse;

      if (image != (Image *) NULL)

        (void) CopyMagickString(image->filename,filename,MagickPathExtent);

    }

  if (image == (Image *) NULL)

    {

      read_info=DestroyImageInfo(read_info);

      return(image);

    }

  if (exception->severity >= ErrorException)

    (void) LogMagickEvent(ExceptionEvent,GetMagickModule(),

      "Coder (%s) generated an image despite an error (%d), "

      "notify the developers",image->magick,exception->severity);

  if (IsBlobTemporary(image) != MagickFalse)

    (void) RelinquishUniqueFileResource(read_info->filename);

  if ((IsSceneGeometry(read_info->scenes,MagickFalse) != MagickFalse) &&

      (GetImageListLength(image) != 1))

    {

      Image

        *clones;

      clones=CloneImages(image,read_info->scenes,exception);

      image=DestroyImageList(image);

      if (clones != (Image *) NULL)

        image=GetFirstImageInList(clones);

      if (image == (Image *) NULL)

        {

          read_info=DestroyImageInfo(read_info);

          return(image);

        }

    }

  InitializeConstituteInfo(read_info,&constitute_info);

  for (next=image; next != (Image *) NULL; next=GetNextImageInList(next))

  {

    char

      magick_path[MagickPathExtent],

      *property;

    const StringInfo

      *profile;

    next->taint=MagickFalse;

    GetPathComponent(magick_filename,MagickPath,magick_path);

    if ((*magick_path == '\0') && (*next->magick == '\0'))

      (void) CopyMagickString(next->magick,magick,MagickPathExtent);

    (void) CopyMagickString(next->magick_filename,magick_filename,

      MagickPathExtent);

    if (IsBlobTemporary(image) != MagickFalse)

      (void) CopyMagickString(next->filename,filename,MagickPathExtent);

    if (next->magick_columns == 0)

      next->magick_columns=next->columns;

    if (next->magick_rows == 0)

      next->magick_rows=next->rows;

    (void) GetImageProperty(next,"exif:*",exception);

    (void) GetImageProperty(next,"icc:*",exception);

    (void) GetImageProperty(next,"iptc:*",exception);

    (void) GetImageProperty(next,"xmp:*",exception);

    SyncOrientationFromProperties(next,&constitute_info,exception);

    SyncResolutionFromProperties(next,&constitute_info,exception);

    if (next->page.width == 0)

      next->page.width=next->columns;

    if (next->page.height == 0)

      next->page.height=next->rows;

    if (constitute_info.caption != (const char *) NULL)

      {

        property=InterpretImageProperties(read_info,next,

          constitute_info.caption,exception);

        (void) SetImageProperty(next,"caption",property,exception);

        property=DestroyString(property);

      }

    if (constitute_info.comment != (const char *) NULL)

      {

        property=InterpretImageProperties(read_info,next,

          constitute_info.comment,exception);

        (void) SetImageProperty(next,"comment",property,exception);

        property=DestroyString(property);

      }

    if (constitute_info.label != (const char *) NULL)

      {

        property=InterpretImageProperties(read_info,next,

          constitute_info.label,exception);

        (void) SetImageProperty(next,"label",property,exception);

        property=DestroyString(property);

      }

    if (LocaleCompare(next->magick,"TEXT") == 0)

      (void) ParseAbsoluteGeometry("0x0+0+0",&next->page);

    if ((read_info->extract != (char *) NULL) &&

        (read_info->stream == (StreamHandler) NULL))

      {

        RectangleInfo

          geometry;

        MagickStatusType

          flags;

        SetGeometry(next,&geometry);

        flags=ParseAbsoluteGeometry(read_info->extract,&geometry);

        if ((next->columns != geometry.width) ||

            (next->rows != geometry.height))

          {

            if (((flags & XValue) != 0) || ((flags & YValue) != 0))

              {

                Image

                  *crop_image;

                crop_image=CropImage(next,&geometry,exception);

                if (crop_image != (Image *) NULL)

                  ReplaceImageInList(&next,crop_image);

              }

            else

              if (((flags & WidthValue) != 0) || ((flags & HeightValue) != 0))

                {

                  flags=ParseRegionGeometry(next,read_info->extract,&geometry,

                    exception);

                  if ((geometry.width != 0) && (geometry.height != 0))

                    {

                      Image *resize_image = ResizeImage(next,geometry.width,

                        geometry.height,next->filter,exception);

                      if (resize_image != (Image *) NULL)

                        ReplaceImageInList(&next,resize_image);

                    }

                }

          }

      }

    profile=GetImageProfile(next,"icc");

    if (profile == (const StringInfo *) NULL)

      profile=GetImageProfile(next,"icm");

    profile=GetImageProfile(next,"iptc");

    if (profile == (const StringInfo *) NULL)

      profile=GetImageProfile(next,"8bim");

    if (IsSourceDataEpochSet() == MagickFalse)

      {

        char

          timestamp[MagickTimeExtent];

        (void) FormatMagickTime(next->timestamp,sizeof(timestamp),timestamp);

        (void) SetImageProperty(next,"date:timestamp",timestamp,exception);

        (void) FormatMagickTime((time_t) GetBlobProperties(next)->st_mtime,

          sizeof(timestamp),timestamp);

        (void) SetImageProperty(next,"date:modify",timestamp,exception);

        (void) FormatMagickTime((time_t) GetBlobProperties(next)->st_ctime,

          sizeof(timestamp),timestamp);

        (void) SetImageProperty(next,"date:create",timestamp,exception);

      }

    if (constitute_info.delay_flags != NoValue)

      {

        if ((constitute_info.delay_flags & GreaterValue) != 0)

          {

            if (next->delay > constitute_info.delay)

              next->delay=constitute_info.delay;

          }

        else

          if ((constitute_info.delay_flags & LessValue) != 0)

            {

              if (next->delay < constitute_info.delay)

                next->delay=constitute_info.delay;

            }

          else

            next->delay=constitute_info.delay;

        if ((constitute_info.delay_flags & SigmaValue) != 0)

          next->ticks_per_second=constitute_info.ticks_per_second;

      }

    if (constitute_info.dispose != (const char *) NULL)

      {

        ssize_t

          option_type;

        option_type=ParseCommandOption(MagickDisposeOptions,MagickFalse,

          constitute_info.dispose);

        if (option_type >= 0)

          next->dispose=(DisposeType) option_type;

      }

    if (read_info->verbose != MagickFalse)

      (void) IdentifyImage(next,stderr,MagickFalse,exception);

    image=next;

  }

  read_info=DestroyImageInfo(read_info);

  if (GetBlobError(image) != MagickFalse)

    ThrowReaderException(CorruptImageError,"UnableToReadImageData");

  return(GetFirstImageInList(image));

}

/*

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%                                                                             %

%                                                                             %

%                                                                             %

%   R e a d I m a g e s                                                       %

%                                                                             %

%                                                                             %

%                                                                             %

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%

%  ReadImages() reads one or more images and returns them as an image list.