/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%                QQQ   U   U   AAA   N   N  TTTTT  U   U  M   M               %

%               Q   Q  U   U  A   A  NN  N    T    U   U  MM MM               %

%               Q   Q  U   U  AAAAA  N N N    T    U   U  M M M               %

%               Q  QQ  U   U  A   A  N  NN    T    U   U  M   M               %

%                QQQQ   UUU   A   A  N   N    T     UUU   M   M               %

%                                                                             %

%             MagicCore Methods to Acquire / Destroy Quantum Pixels           %

%                                                                             %

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

#include "MagickCore/blob.h"

#include "MagickCore/blob-private.h"

#include "MagickCore/color-private.h"

#include "MagickCore/exception.h"

#include "MagickCore/exception-private.h"

#include "MagickCore/cache.h"

#include "MagickCore/cache-private.h"

#include "MagickCore/colorspace.h"

#include "MagickCore/colorspace-private.h"

#include "MagickCore/constitute.h"

#include "MagickCore/delegate.h"

#include "MagickCore/geometry.h"

#include "MagickCore/list.h"

#include "MagickCore/magick.h"

#include "MagickCore/memory_.h"

#include "MagickCore/memory-private.h"

#include "MagickCore/monitor.h"

#include "MagickCore/option.h"

#include "MagickCore/pixel.h"

#include "MagickCore/pixel-accessor.h"

#include "MagickCore/property.h"

#include "MagickCore/quantum.h"

#include "MagickCore/quantum-private.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/thread-private.h"

#include "MagickCore/utility.h"

/*

  Define declarations.

*/

#define QuantumSignature  0xab

/*

  Forward declarations.

*/

static void

  DestroyQuantumPixels(QuantumInfo *);

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   A c q u i r e Q u a n t u m I n f o                                       %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  AcquireQuantumInfo() allocates the QuantumInfo structure.

%

%  The format of the AcquireQuantumInfo method is:

%

%      QuantumInfo *AcquireQuantumInfo(const ImageInfo *image_info,Image *image)

%

%  A description of each parameter follows:

%

%    o image_info: the image info.

%

%    o image: the image.

%

*/

MagickExport QuantumInfo *AcquireQuantumInfo(const ImageInfo *image_info,

  Image *image)

{

  MagickBooleanType

    status;

  QuantumInfo

    *quantum_info;

  quantum_info=(QuantumInfo *) AcquireCriticalMemory(sizeof(*quantum_info));

  quantum_info->signature=MagickCoreSignature;

  GetQuantumInfo(image_info,quantum_info);

  if (image == (const Image *) NULL)

    return(quantum_info);

  status=SetQuantumDepth(image,quantum_info,image->depth);

  quantum_info->endian=image->endian;

  if (status == MagickFalse)

    quantum_info=DestroyQuantumInfo(quantum_info);

  return(quantum_info);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

+   A c q u i r e Q u a n t u m P i x e l s                                   %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  AcquireQuantumPixels() allocates the pixel staging areas.

%

%  The format of the AcquireQuantumPixels method is:

%

%      MagickBooleanType AcquireQuantumPixels(QuantumInfo *quantum_info,

%        const size_t extent)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

%    o extent: the quantum info.

%

*/

static MagickBooleanType AcquireQuantumPixels(QuantumInfo *quantum_info,

  const size_t extent)

{

  ssize_t

    i;

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum_info->number_threads=(size_t) GetMagickResourceLimit(ThreadResource);

  quantum_info->pixels=(MemoryInfo **) AcquireQuantumMemory(

    quantum_info->number_threads,sizeof(*quantum_info->pixels));

  if (quantum_info->pixels == (MemoryInfo **) NULL)

    return(MagickFalse);

  quantum_info->extent=extent;

  (void) memset(quantum_info->pixels,0,quantum_info->number_threads*

    sizeof(*quantum_info->pixels));

  for (i=0; i < (ssize_t) quantum_info->number_threads; i++)

  {

    unsigned char

      *pixels;

    quantum_info->pixels[i]=AcquireVirtualMemory(extent+1,sizeof(*pixels));

    if (quantum_info->pixels[i] == (MemoryInfo *) NULL)

      {

        DestroyQuantumPixels(quantum_info);

        return(MagickFalse);

      }

    pixels=(unsigned char *)  GetVirtualMemoryBlob(quantum_info->pixels[i]);

    (void) memset(pixels,0,(extent+1)*sizeof(*pixels));

    pixels[extent]=QuantumSignature;

  }

  return(MagickTrue);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   D e s t r o y Q u a n t u m I n f o                                       %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  DestroyQuantumInfo() deallocates memory associated with the QuantumInfo

%  structure.

%

%  The format of the DestroyQuantumInfo method is:

%

%      QuantumInfo *DestroyQuantumInfo(QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

*/

MagickExport QuantumInfo *DestroyQuantumInfo(QuantumInfo *quantum_info)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if (quantum_info->pixels != (MemoryInfo **) NULL)

    DestroyQuantumPixels(quantum_info);

  if (quantum_info->semaphore != (SemaphoreInfo *) NULL)

    RelinquishSemaphoreInfo(&quantum_info->semaphore);

  quantum_info->signature=(~MagickCoreSignature);

  quantum_info=(QuantumInfo *) RelinquishMagickMemory(quantum_info);

  return(quantum_info);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

+   D e s t r o y Q u a n t u m P i x e l s                                   %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  DestroyQuantumPixels() destroys the quantum pixels.

%

%  The format of the DestroyQuantumPixels() method is:

%

%      void DestroyQuantumPixels(QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

*/

static void DestroyQuantumPixels(QuantumInfo *quantum_info)

{

  ssize_t

    i;

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  assert(quantum_info->pixels != (MemoryInfo **) NULL);

  for (i=0; i < (ssize_t) quantum_info->number_threads; i++)

    if (quantum_info->pixels[i] != (MemoryInfo *) NULL)

      {

#ifndef NDEBUG

        ssize_t

          extent;

        unsigned char

          *pixels;

        /*

          Did we overrun our quantum buffer?

        */

        extent=(ssize_t) quantum_info->extent;

        pixels=(unsigned char *) GetVirtualMemoryBlob(quantum_info->pixels[i]);

        assert(pixels[extent] == QuantumSignature);

#endif

        quantum_info->pixels[i]=RelinquishVirtualMemory(

          quantum_info->pixels[i]);

      }

  quantum_info->pixels=(MemoryInfo **) RelinquishMagickMemory(

    quantum_info->pixels);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m E x t e n t                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumExtent() returns the quantum pixel buffer extent.

%

%  The format of the GetQuantumExtent method is:

%

%      size_t GetQuantumExtent(Image *image,const QuantumInfo *quantum_info,

%        const QuantumType quantum_type)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o quantum_type: Declare which pixel components to transfer (red, green,

%      blue, opacity, RGB, or RGBA).

%

*/

MagickExport size_t GetQuantumExtent(const Image *image,

  const QuantumInfo *quantum_info,const QuantumType quantum_type)

{

  size_t

    channels;

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  channels=1;

  switch (quantum_type)

  {

    case GrayAlphaQuantum: channels=2; break;

    case IndexAlphaQuantum: channels=2; break;

    case RGBQuantum: channels=3; break;

    case BGRQuantum: channels=3; break;

    case RGBAQuantum: channels=4; break;

    case RGBOQuantum: channels=4; break;

    case BGRAQuantum: channels=4; break;

    case CMYKQuantum: channels=4; break;

    case CMYKAQuantum: channels=5; break;

    case MultispectralQuantum: channels=GetImageChannels(image); break;

    case CbYCrAQuantum: channels=4; break;

    case CbYCrQuantum: channels=3; break;

    case CbYCrYQuantum: channels=4; break;

    default: break;

  }

  if (quantum_info->pack == MagickFalse)

    return((size_t) (channels*image->columns*((quantum_info->depth+7)/8))+

      (quantum_info->pad*image->columns));

  return((size_t) ((channels*image->columns*quantum_info->depth+7)/8)+

    (quantum_info->pad*image->columns));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m E n d i a n                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumEndian() returns the quantum endian of the image.

%

%  The endian of the GetQuantumEndian method is:

%

%      EndianType GetQuantumEndian(const QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

*/

MagickExport EndianType GetQuantumEndian(const QuantumInfo *quantum_info)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  return(quantum_info->endian);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m F o r m a t                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumFormat() returns the quantum format of the image.

%

%  The format of the GetQuantumFormat method is:

%

%      QuantumFormatType GetQuantumFormat(const QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

*/

MagickExport QuantumFormatType GetQuantumFormat(const QuantumInfo *quantum_info)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  return(quantum_info->format);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m I n f o                                               %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumInfo() initializes the QuantumInfo structure to default values.

%

%  The format of the GetQuantumInfo method is:

%

%      GetQuantumInfo(const ImageInfo *image_info,QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o image_info: the image info.

%

%    o quantum_info: the quantum info.

%

*/

MagickExport void GetQuantumInfo(const ImageInfo *image_info,

  QuantumInfo *quantum_info)

{

  const char

    *option;

  assert(quantum_info != (QuantumInfo *) NULL);

  (void) memset(quantum_info,0,sizeof(*quantum_info));

  quantum_info->quantum=8;

  quantum_info->maximum=1.0;

  quantum_info->scale=QuantumRange;

  quantum_info->pack=MagickTrue;

  quantum_info->semaphore=AcquireSemaphoreInfo();

  quantum_info->signature=MagickCoreSignature;

  if (image_info == (const ImageInfo *) NULL)

    return;

  option=GetImageOption(image_info,"quantum:format");

  if (option != (char *) NULL)

    quantum_info->format=(QuantumFormatType) ParseCommandOption(

      MagickQuantumFormatOptions,MagickFalse,option);

  option=GetImageOption(image_info,"quantum:minimum");

  if (option != (char *) NULL)

    quantum_info->minimum=StringToDouble(option,(char **) NULL);

  option=GetImageOption(image_info,"quantum:maximum");

  if (option != (char *) NULL)

    quantum_info->maximum=StringToDouble(option,(char **) NULL);

  if ((quantum_info->minimum == 0.0) && (quantum_info->maximum == 0.0))

    quantum_info->scale=0.0;

  else

    if (quantum_info->minimum == quantum_info->maximum)

      {

        quantum_info->scale=(double) QuantumRange/quantum_info->minimum;

        quantum_info->minimum=0.0;

      }

    else

      quantum_info->scale=(double) QuantumRange/(quantum_info->maximum-

        quantum_info->minimum);

  option=GetImageOption(image_info,"quantum:scale");

  if (option != (char *) NULL)

    quantum_info->scale=StringToDouble(option,(char **) NULL);

  option=GetImageOption(image_info,"quantum:polarity");

  if (option != (char *) NULL)

    quantum_info->min_is_white=LocaleCompare(option,"min-is-white") == 0 ?

      MagickTrue : MagickFalse;

  quantum_info->endian=image_info->endian;

  ResetQuantumState(quantum_info);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m P i x e l s                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumPixels() returns the quantum pixels.

%

%  The format of the GetQuantumPixels method is:

%

%      unsigned char *QuantumPixels GetQuantumPixels(

%        const QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

*/

MagickExport unsigned char *GetQuantumPixels(const QuantumInfo *quantum_info)

{

  const int

    id = GetOpenMPThreadId();

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  return((unsigned char *) GetVirtualMemoryBlob(quantum_info->pixels[id]));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   G e t Q u a n t u m T y p e                                               %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  GetQuantumType() returns the quantum type of the image.

%

%  The format of the GetQuantumType method is:

%

%      QuantumType GetQuantumType(Image *image,ExceptionInfo *exception)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

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

%

*/

MagickExport QuantumType GetQuantumType(Image *image,ExceptionInfo *exception)

{

  QuantumType

    quantum_type;

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  (void) exception;

  quantum_type=RGBQuantum;

  if (image->alpha_trait != UndefinedPixelTrait)

    quantum_type=RGBAQuantum;

  if (image->colorspace == CMYKColorspace)

    {

      quantum_type=CMYKQuantum;

      if (image->alpha_trait != UndefinedPixelTrait)

        quantum_type=CMYKAQuantum;

    }

  if (IsGrayColorspace(image->colorspace) != MagickFalse)

    {

      quantum_type=GrayQuantum;

      if (image->alpha_trait != UndefinedPixelTrait)

        quantum_type=GrayAlphaQuantum;

    }

  if (image->storage_class == PseudoClass)

    {

      quantum_type=IndexQuantum;

      if (image->alpha_trait != UndefinedPixelTrait)

        quantum_type=IndexAlphaQuantum;

    }

  if (image->number_meta_channels != 0)

    quantum_type=MultispectralQuantum;

  return(quantum_type);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

+   R e s e t Q u a n t u m S t a t e                                         %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  ResetQuantumState() resets the quantum state.

%

%  The format of the ResetQuantumState method is:

%

%      void ResetQuantumState(QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

*/

MagickPrivate void ResetQuantumState(QuantumInfo *quantum_info)

{

  static const unsigned int mask[32] =

  {

    0x00000000U, 0x00000001U, 0x00000003U, 0x00000007U, 0x0000000fU,

    0x0000001fU, 0x0000003fU, 0x0000007fU, 0x000000ffU, 0x000001ffU,

    0x000003ffU, 0x000007ffU, 0x00000fffU, 0x00001fffU, 0x00003fffU,

    0x00007fffU, 0x0000ffffU, 0x0001ffffU, 0x0003ffffU, 0x0007ffffU,

    0x000fffffU, 0x001fffffU, 0x003fffffU, 0x007fffffU, 0x00ffffffU,

    0x01ffffffU, 0x03ffffffU, 0x07ffffffU, 0x0fffffffU, 0x1fffffffU,

    0x3fffffffU, 0x7fffffffU

  };

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum_info->state.inverse_scale=1.0;

  if (fabs(quantum_info->scale) >= MagickEpsilon)

    quantum_info->state.inverse_scale/=quantum_info->scale;

  quantum_info->state.pixel=0U;

  quantum_info->state.bits=0U;

  quantum_info->state.mask=mask;

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m F o r m a t                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumAlphaType() sets the quantum format.

%

%  The format of the SetQuantumAlphaType method is:

%

%      void SetQuantumAlphaType(QuantumInfo *quantum_info,

%        const QuantumAlphaType type)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

%    o type: the alpha type (e.g. associate).

%

*/

MagickExport void SetQuantumAlphaType(QuantumInfo *quantum_info,

  const QuantumAlphaType type)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum_info->alpha_type=type;

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m D e p t h                                             %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumDepth() sets the quantum depth.

%

%  The format of the SetQuantumDepth method is:

%

%      MagickBooleanType SetQuantumDepth(const Image *image,

%        QuantumInfo *quantum_info,const size_t depth)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o depth: the quantum depth.

%

*/

MagickExport MagickBooleanType SetQuantumDepth(const Image *image,

  QuantumInfo *quantum_info,const size_t depth)

{

  /*

    Allocate the quantum pixel buffer.

  */

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  quantum_info->depth=MagickMin(depth,64);

  if (quantum_info->format == FloatingPointQuantumFormat)

    {

      if (quantum_info->depth > 32)

        quantum_info->depth=64;

      else

        if (quantum_info->depth > 24)

          quantum_info->depth=32;

        else

          if (quantum_info->depth > 16)

            quantum_info->depth=24;

          else

            quantum_info->depth=16;

    }

  return(SetQuantumExtent(image,quantum_info));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m E n d i a n                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumEndian() sets the quantum endian.

%

%  The endian of the SetQuantumEndian method is:

%

%      MagickBooleanType SetQuantumEndian(const Image *image,

%        QuantumInfo *quantum_info,const EndianType endian)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o endian: the quantum endian.

%

*/

MagickExport MagickBooleanType SetQuantumEndian(const Image *image,

  QuantumInfo *quantum_info,const EndianType endian)

{

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  quantum_info->endian=endian;

  return(SetQuantumExtent(image,quantum_info));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m E x t e n t                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumExtent() sets the quantum pixel buffer extent.

%

%  The format of the SetQuantumExtent method is:

%

%      MagickBooleanType SetQuantumExtent(Image *image,

%        QuantumInfo *quantum_info)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

*/

MagickExport MagickBooleanType SetQuantumExtent(const Image *image,

  QuantumInfo *quantum_info)

{

  size_t

    extent,

    quantum;

  /*

    Speculative allocation since we don't yet know the quantum type.

  */

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum=(GetPixelChannels(image)+quantum_info->pad+3)*

    ((quantum_info->depth+7)/8)*sizeof(double);

  extent=MagickMax(image->columns,image->rows)*quantum;

  if ((MagickMax(image->columns,image->rows) != 0) &&

      (quantum != (extent/MagickMax(image->columns,image->rows))))

    return(MagickFalse);

  if (quantum_info->pixels != (MemoryInfo **) NULL)

    {

      if (extent <= quantum_info->extent)

        return(MagickTrue);

      DestroyQuantumPixels(quantum_info);

    }

  return(AcquireQuantumPixels(quantum_info,extent));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m F o r m a t                                           %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumFormat() sets the quantum format.

%

%  The format of the SetQuantumFormat method is:

%

%      MagickBooleanType SetQuantumFormat(const Image *image,

%        QuantumInfo *quantum_info,const QuantumFormatType format)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o format: the quantum format.

%

*/

MagickExport MagickBooleanType SetQuantumFormat(const Image *image,

  QuantumInfo *quantum_info,const QuantumFormatType format)

{

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  quantum_info->format=format;

  return(SetQuantumExtent(image,quantum_info));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m I m a g e T y p e                                     %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumImageType() sets the image type based on the quantum type.

%

%  The format of the SetQuantumImageType method is:

%

%      void ImageType SetQuantumImageType(Image *image,

%        const QuantumType quantum_type)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_type: Declare which pixel components to transfer (red, green,

%      blue, opacity, RGB, or RGBA).

%

*/

MagickExport void SetQuantumImageType(Image *image,

  const QuantumType quantum_type)

{

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  switch (quantum_type)

  {

    case IndexQuantum:

    case IndexAlphaQuantum:

    {

      image->type=PaletteType;

      break;

    }

    case GrayQuantum:

    case GrayAlphaQuantum:

    {

      image->type=GrayscaleType;

      if (image->depth == 1)

        image->type=BilevelType;

      break;

    }

    case CyanQuantum:

    case MagentaQuantum:

    case YellowQuantum:

    case BlackQuantum:

    case CMYKQuantum:

    case CMYKAQuantum:

    case MultispectralQuantum:

    {

      image->type=ColorSeparationType;

      break;

    }

    default:

    {

      image->type=TrueColorType;

      break;

    }

  }

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m M e t a C h a n n e l                                 %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumMetaChannel() sets the quantum meta-channel that will exported or

%  imported when the quantum type is MultispectralQuantum. To unset the

%  meta-channel, set the meta-channel to -1.

%

%  The format of the SetQuantumMetaChannel method is:

%

%      void SetQuantumMetaChannel(const Image *image,QuantumInfo *quantum_info,

%        const ssize_t meta_channel)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o meta_channel: the meta channel.

%

*/

MagickExport MagickBooleanType SetQuantumMetaChannel(const Image *image,

  QuantumInfo *quantum_info, const ssize_t meta_channel) 

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if ((meta_channel < -1) ||

      (meta_channel >= (ssize_t) image->number_meta_channels))

    return(MagickFalse);

  quantum_info->meta_channel=meta_channel+1;

  return(MagickTrue);

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m P a c k                                               %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumPack() sets the quantum pack flag.

%

%  The format of the SetQuantumPack method is:

%

%      void SetQuantumPack(QuantumInfo *quantum_info,

%        const MagickBooleanType pack)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

%    o pack: the pack flag.

%

*/

MagickExport void SetQuantumPack(QuantumInfo *quantum_info,

  const MagickBooleanType pack)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum_info->pack=pack;

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m P a d                                                 %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumPad() sets the quantum pad.

%

%  The format of the SetQuantumPad method is:

%

%      MagickBooleanType SetQuantumPad(const Image *image,

%        QuantumInfo *quantum_info,const size_t pad)

%

%  A description of each parameter follows:

%

%    o image: the image.

%

%    o quantum_info: the quantum info.

%

%    o pad: the quantum pad.

%

*/

MagickExport MagickBooleanType SetQuantumPad(const Image *image,

  QuantumInfo *quantum_info,const size_t pad)

{

  assert(image != (Image *) NULL);

  assert(image->signature == MagickCoreSignature);

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  if (IsEventLogging() != MagickFalse)

    (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);

  if (pad >= (MAGICK_SSIZE_MAX/GetImageChannels(image)))

    return(MagickFalse);

  quantum_info->pad=pad;

  return(SetQuantumExtent(image,quantum_info));

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m M i n I s W h i t e                                   %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumMinIsWhite() sets the quantum min-is-white flag.

%

%  The format of the SetQuantumMinIsWhite method is:

%

%      void SetQuantumMinIsWhite(QuantumInfo *quantum_info,

%        const MagickBooleanType min_is_white)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

%    o min_is_white: the min-is-white flag.

%

*/

MagickExport void SetQuantumMinIsWhite(QuantumInfo *quantum_info,

  const MagickBooleanType min_is_white)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);

  quantum_info->min_is_white=min_is_white;

}

/*

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

%                                                                             %

%                                                                             %

%                                                                             %

%   S e t Q u a n t u m Q u a n t u m                                         %

%                                                                             %

%                                                                             %

%                                                                             %

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

%

%  SetQuantumQuantum() sets the quantum quantum.

%

%  The format of the SetQuantumQuantum method is:

%

%      void SetQuantumQuantum(QuantumInfo *quantum_info,const size_t quantum)

%

%  A description of each parameter follows:

%

%    o quantum_info: the quantum info.

%

%    o quantum: the quantum quantum.

%

*/

MagickExport void SetQuantumQuantum(QuantumInfo *quantum_info,

  const size_t quantum)

{

  assert(quantum_info != (QuantumInfo *) NULL);

  assert(quantum_info->signature == MagickCoreSignature);