stream.c File Reference

#include "MagickCore/studio.h"
#include "MagickCore/blob.h"
#include "MagickCore/blob-private.h"
#include "MagickCore/cache.h"
#include "MagickCore/cache-private.h"
#include "MagickCore/color-private.h"
#include "MagickCore/composite-private.h"
#include "MagickCore/constitute.h"
#include "MagickCore/exception.h"
#include "MagickCore/exception-private.h"
#include "MagickCore/geometry.h"
#include "MagickCore/memory_.h"
#include "MagickCore/memory-private.h"
#include "MagickCore/pixel.h"
#include "MagickCore/pixel-accessor.h"
#include "MagickCore/policy.h"
#include "MagickCore/quantum.h"
#include "MagickCore/quantum-private.h"
#include "MagickCore/semaphore.h"
#include "MagickCore/stream.h"
#include "MagickCore/stream-private.h"
#include "MagickCore/string_.h"

Data Structures
struct	_StreamInfo
Functions
static const Quantum *	GetVirtualPixelStream (const Image *, const VirtualPixelMethod, const ssize_t, const ssize_t, const size_t, const size_t, ExceptionInfo *)
static MagickBooleanType	StreamImagePixels (const StreamInfo *, const Image *, ExceptionInfo *)
static MagickBooleanType	SyncAuthenticPixelsStream (Image *, ExceptionInfo *)
static Quantum *	QueueAuthenticPixelsStream (Image *, const ssize_t, const ssize_t, const size_t, const size_t, ExceptionInfo *)
MagickExport StreamInfo *	AcquireStreamInfo (const ImageInfo *image_info, ExceptionInfo *exception)
static void	RelinquishStreamPixels (CacheInfo *cache_info)
static void	DestroyPixelStream (Image *image)
MagickExport StreamInfo *	DestroyStreamInfo (StreamInfo *stream_info)
static void *	GetAuthenticMetacontentFromStream (const Image *image)
static Quantum *	GetAuthenticPixelsStream (Image *image, const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
static Quantum *	GetAuthenticPixelsFromStream (const Image *image)
static MagickBooleanType	GetOneAuthenticPixelFromStream (Image *image, const ssize_t x, const ssize_t y, Quantum *pixel, ExceptionInfo *exception)
static MagickBooleanType	GetOneVirtualPixelFromStream (const Image *image, const VirtualPixelMethod virtual_pixel_method, const ssize_t x, const ssize_t y, Quantum *pixel, ExceptionInfo *exception)
MagickPrivate const void *	GetStreamInfoClientData (StreamInfo *stream_info)
static const Quantum *	GetVirtualPixelsStream (const Image *image)
static const void *	GetVirtualMetacontentFromStream (const Image *image)
static MagickBooleanType	AcquireStreamPixels (CacheInfo *cache_info, ExceptionInfo *exception)
static const Quantum *	GetVirtualPixelStream (const Image *image, const VirtualPixelMethod magick_unused(virtual_pixel_method), const ssize_t x, const ssize_t y, const size_t columns, const size_t rows, ExceptionInfo *exception)
MagickExport MagickBooleanType	OpenStream (const ImageInfo *image_info, StreamInfo *stream_info, const char *filename, ExceptionInfo *exception)
MagickExport Image *	ReadStream (const ImageInfo *image_info, StreamHandler stream, ExceptionInfo *exception)
MagickPrivate void	ResetStreamAnonymousMemory (void)
MagickPrivate void	SetStreamInfoClientData (StreamInfo *stream_info, const void *client_data)
MagickExport void	SetStreamInfoMap (StreamInfo *stream_info, const char *map)
MagickExport void	SetStreamInfoStorageType (StreamInfo *stream_info, const StorageType storage_type)
static size_t	WriteStreamImage (const Image *image, const void *pixels, const size_t columns)
MagickExport Image *	StreamImage (const ImageInfo *image_info, StreamInfo *stream_info, ExceptionInfo *exception)
MagickExport MagickBooleanType	WriteStream (const ImageInfo *image_info, Image *image, StreamHandler stream, ExceptionInfo *exception)
Variables
static ssize_t	cache_anonymous_memory = (-1)

---

Function Documentation

MagickExport StreamInfo* AcquireStreamInfo	(	const ImageInfo *	image_info,
		ExceptionInfo *	exception
	)

References AcquireAlignedMemory(), AcquireCriticalMemory(), AcquireImage(), CharPixel, ConstantString(), MagickAssumeAligned, MagickCoreSignature, _StreamInfo::map, _StreamInfo::pixels, ResourceLimitFatalError, _StreamInfo::signature, _StreamInfo::storage_type, _StreamInfo::stream, and ThrowFatalException.

static MagickBooleanType AcquireStreamPixels	(	CacheInfo *	cache_info,
		ExceptionInfo *	exception
	)			[inline, static]

References AcquireAlignedMemory(), cache_anonymous_memory, DestroyString(), _CacheInfo::filename, GetMagickModule, GetPolicyValue(), IOMode, _CacheInfo::length, LocaleCompare(), MagickAssumeAligned, MagickFalse, MagickTrue, MapBlob(), _CacheInfo::mapped, MissingDelegateError, _CacheInfo::pixels, ResourceLimitError, and ThrowMagickException().

Referenced by GetVirtualPixelStream(), and QueueAuthenticPixelsStream().

static void DestroyPixelStream

(

Image *

image

)

[static]

References _Image::cache, _Image::debug, DestroyPixelCacheNexus(), _CacheInfo::file_semaphore, _Image::filename, GetMagickModule, LockSemaphoreInfo(), LogMagickEvent(), MagickCoreSignature, MagickFalse, MagickTrue, _CacheInfo::nexus_info, _CacheInfo::number_threads, _CacheInfo::reference_count, RelinquishAlignedMemory(), RelinquishSemaphoreInfo(), RelinquishStreamPixels(), _CacheInfo::semaphore, _CacheInfo::signature, _Image::signature, TraceEvent, and UnlockSemaphoreInfo().

Referenced by ReadStream().

MagickExport StreamInfo* DestroyStreamInfo

(

StreamInfo *

stream_info

)

References CloseBlob(), DestroyImage(), DestroyQuantumInfo(), DestroyString(), GetMagickModule, LogMagickEvent(), MagickCoreSignature, _StreamInfo::map, _StreamInfo::pixels, _StreamInfo::quantum_info, RelinquishAlignedMemory(), RelinquishMagickMemory(), _StreamInfo::signature, _StreamInfo::stream, and TraceEvent.

static void* GetAuthenticMetacontentFromStream

(

const Image *

image

)

[static]

References _Image::cache, _Image::debug, _Image::filename, GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, _CacheInfo::metacontent, _CacheInfo::signature, _Image::signature, and TraceEvent.

Referenced by ReadStream().

static Quantum* GetAuthenticPixelsFromStream

(

const Image *

image

)

[static]

References _Image::cache, _Image::debug, _Image::filename, GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, _CacheInfo::pixels, _CacheInfo::signature, _Image::signature, and TraceEvent.

Referenced by ReadStream().

static Quantum* GetAuthenticPixelsStream	(	Image *	image,
		const ssize_t	x,
		const ssize_t	y,
		const size_t	columns,
		const size_t	rows,
		ExceptionInfo *	exception
	)			[static]

References _Image::debug, _Image::filename, GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, QueueAuthenticPixelsStream(), _Image::signature, and TraceEvent.

Referenced by GetOneAuthenticPixelFromStream(), and ReadStream().

static MagickBooleanType GetOneAuthenticPixelFromStream	(	Image *	image,
		const ssize_t	x,
		const ssize_t	y,
		Quantum *	pixel,
		ExceptionInfo *	exception
	)			[static]

References _PixelInfo::alpha, AlphaPixelChannel, _Image::background_color, _PixelInfo::black, BlackPixelChannel, _PixelInfo::blue, BluePixelChannel, ClampToQuantum(), GetAuthenticPixelsStream(), GetPixelChannelChannel(), GetPixelChannels(), _PixelInfo::green, GreenPixelChannel, MagickCoreSignature, MagickFalse, MagickTrue, MaxPixelChannels, _PixelInfo::red, RedPixelChannel, and _Image::signature.

Referenced by ReadStream().

static MagickBooleanType GetOneVirtualPixelFromStream	(	const Image *	image,
		const VirtualPixelMethod	virtual_pixel_method,
		const ssize_t	x,
		const ssize_t	y,
		Quantum *	pixel,
		ExceptionInfo *	exception
	)			[static]

References _PixelInfo::alpha, AlphaPixelChannel, _Image::background_color, _PixelInfo::black, BlackPixelChannel, _PixelInfo::blue, BluePixelChannel, ClampToQuantum(), GetPixelChannelChannel(), GetPixelChannels(), GetVirtualPixelStream(), _PixelInfo::green, GreenPixelChannel, MagickCoreSignature, MagickFalse, MagickTrue, MaxPixelChannels, _PixelInfo::red, RedPixelChannel, and _Image::signature.

Referenced by ReadStream().

MagickPrivate const void* GetStreamInfoClientData

(

StreamInfo *

stream_info

)

References _StreamInfo::client_data, MagickCoreSignature, and _StreamInfo::signature.

static const void* GetVirtualMetacontentFromStream

(

const Image *

image

)

[static]

References _Image::cache, _Image::debug, _Image::filename, GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, _CacheInfo::metacontent, _CacheInfo::signature, _Image::signature, and TraceEvent.

Referenced by ReadStream().

static const Quantum* GetVirtualPixelsStream

(

const Image *

image

)

[static]

References _Image::cache, _Image::debug, _Image::filename, GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, _CacheInfo::pixels, _CacheInfo::signature, _Image::signature, and TraceEvent.

Referenced by ReadStream().

static const Quantum* GetVirtualPixelStream	(	const Image *	image,
		const VirtualPixelMethod	magick_unusedvirtual_pixel_method,
		const ssize_t	x,
		const ssize_t	y,
		const size_t	columns,
		const size_t	rows,
		ExceptionInfo *	exception
	)			[static]

References AcquireStreamPixels(), _Image::cache, _Image::columns, _Image::debug, _Image::filename, GetMagickModule, _CacheInfo::length, LogMagickEvent(), magick_unreferenced, MagickCoreSignature, MagickFalse, _CacheInfo::metacontent, _CacheInfo::metacontent_extent, _CacheInfo::number_channels, _CacheInfo::pixels, RelinquishStreamPixels(), _Image::rows, _CacheInfo::signature, _Image::signature, StreamError, ThrowMagickException(), and TraceEvent.

static const Quantum* GetVirtualPixelStream	(	const Image *	,
		const	VirtualPixelMethod,
		const	ssize_t,
		const	ssize_t,
		const	size_t,
		const	size_t,
		ExceptionInfo *
	)			[static]

Referenced by GetOneVirtualPixelFromStream(), and ReadStream().

MagickExport MagickBooleanType OpenStream	(	const ImageInfo *	image_info,
		StreamInfo *	stream_info,
		const char *	filename,
		ExceptionInfo *	exception
	)

References CopyMagickString(), _Image::filename, MagickPathExtent, OpenBlob(), _StreamInfo::stream, and WriteBinaryBlobMode.

static Quantum * QueueAuthenticPixelsStream	(	Image *	image,
		const ssize_t	x,
		const ssize_t	y,
		const size_t	columns,
		const size_t	rows,
		ExceptionInfo *	exception
	)			[static]

References AcquireStreamPixels(), _Image::cache, _CacheInfo::colorspace, _Image::colorspace, _CacheInfo::columns, _Image::columns, _Image::filename, GetBlobStreamHandler(), GetMagickModule, GetPixelCacheColorspace(), GetPixelCacheStorageClass(), _CacheInfo::length, MagickCoreSignature, MagickFalse, _CacheInfo::metacontent, _CacheInfo::metacontent_extent, _CacheInfo::number_channels, _CacheInfo::pixels, RelinquishStreamPixels(), _CacheInfo::rows, _Image::rows, _CacheInfo::signature, _CacheInfo::storage_class, _Image::storage_class, StreamError, ThrowMagickException(), and UndefinedClass.

Referenced by GetAuthenticPixelsStream(), and ReadStream().

MagickExport Image* ReadStream	(	const ImageInfo *	image_info,
		StreamHandler	stream,
		ExceptionInfo *	exception
	)

References AcquirePixelCache(), _ImageInfo::cache, CloneImageInfo(), _ImageInfo::debug, _CacheMethods::destroy_pixel_handler, DestroyImageInfo(), DestroyPixelStream(), _ImageInfo::filename, _CacheMethods::get_authentic_metacontent_from_handler, _CacheMethods::get_authentic_pixels_from_handler, _CacheMethods::get_authentic_pixels_handler, _CacheMethods::get_one_authentic_pixel_from_handler, _CacheMethods::get_one_virtual_pixel_from_handler, _CacheMethods::get_virtual_metacontent_from_handler, _CacheMethods::get_virtual_pixel_handler, _CacheMethods::get_virtual_pixels_handler, GetAuthenticMetacontentFromStream(), GetAuthenticPixelsFromStream(), GetAuthenticPixelsStream(), GetMagickModule, GetOneAuthenticPixelFromStream(), GetOneVirtualPixelFromStream(), GetPixelCacheMethods(), GetVirtualMetacontentFromStream(), GetVirtualPixelsStream(), GetVirtualPixelStream(), InitializePixelChannelMap(), LogMagickEvent(), MagickCoreSignature, MagickFalse, _CacheMethods::queue_authentic_pixels_handler, QueueAuthenticPixelsStream(), ReadImage(), ResetPixelCacheChannels(), SetPixelCacheMethods(), _ExceptionInfo::signature, _ImageInfo::signature, _ImageInfo::stream, _CacheMethods::sync_authentic_pixels_handler, SyncAuthenticPixelsStream(), and TraceEvent.

Referenced by PingBlob(), PingImage(), and StreamImage().

static void RelinquishStreamPixels

(

CacheInfo *

cache_info

)

[inline, static]

References _CacheInfo::length, MagickFalse, _CacheInfo::mapped, _CacheInfo::metacontent, _CacheInfo::pixels, RelinquishAlignedMemory(), and UnmapBlob().

Referenced by DestroyPixelStream(), GetVirtualPixelStream(), and QueueAuthenticPixelsStream().

MagickPrivate void ResetStreamAnonymousMemory

(

void

)

References cache_anonymous_memory.

MagickPrivate void SetStreamInfoClientData	(	StreamInfo *	stream_info,
		const void *	client_data
	)

References _StreamInfo::client_data, MagickCoreSignature, and _StreamInfo::signature.

MagickExport void SetStreamInfoMap	(	StreamInfo *	stream_info,
		const char *	map
	)

References CloneString(), MagickCoreSignature, _StreamInfo::map, and _StreamInfo::signature.

MagickExport void SetStreamInfoStorageType	(	StreamInfo *	stream_info,
		const StorageType	storage_type
	)

References MagickCoreSignature, _StreamInfo::signature, and _StreamInfo::storage_type.

MagickExport Image* StreamImage	(	const ImageInfo *	image_info,
		StreamInfo *	stream_info,
		ExceptionInfo *	exception
	)

References AcquireQuantumInfo(), _ImageInfo::client_data, CloneImageInfo(), _ImageInfo::debug, DestroyImage(), DestroyImageInfo(), DestroyQuantumInfo(), _StreamInfo::exception, _ImageInfo::filename, GetMagickModule, _StreamInfo::image_info, LogMagickEvent(), MagickCoreSignature, MagickFalse, _StreamInfo::quantum_info, ReadStream(), _StreamInfo::signature, _ImageInfo::signature, TraceEvent, and WriteStreamImage().

static MagickBooleanType StreamImagePixels	(	const StreamInfo *	stream_info,
		const Image *	image,
		ExceptionInfo *	exception
	)			[static]

References AcquireQuantumMemory(), AlphaQuantum, BlackQuantum, BlueQuantum, CharPixel, ClampToQuantum(), CMYKColorspace, _Image::colorspace, CyanQuantum, _Image::debug, DoublePixel, _Image::filename, FloatPixel, GetAuthenticPixelQueue(), GetImageExtent(), GetMagickModule, GetPixelAlpha(), GetPixelBlack(), GetPixelBlue(), GetPixelChannels(), GetPixelGreen(), GetPixelIntensity(), GetPixelRed(), GreenQuantum, ImageError, IndexQuantum, LocaleCompare(), LogMagickEvent(), LongLongPixel, LongPixel, MagentaQuantum, MagickCoreSignature, MagickFalse, MagickTrue, _StreamInfo::map, _QuantumInfo::minimum, OpacityQuantum, OptionError, _StreamInfo::pixels, _StreamInfo::quantum_info, QuantumPixel, QuantumScale, RedQuantum, RelinquishMagickMemory(), ResourceLimitError, _QuantumInfo::scale, ScaleQuantumToChar(), ScaleQuantumToLong(), ScaleQuantumToLongLong(), ScaleQuantumToShort(), ShortPixel, _Image::signature, _StreamInfo::signature, _StreamInfo::storage_type, ThrowMagickException(), TraceEvent, UndefinedQuantum, and YellowQuantum.

Referenced by WriteStreamImage().

static MagickBooleanType SyncAuthenticPixelsStream	(	Image *	image,
		ExceptionInfo *	exception
	)

References _Image::cache, _CacheInfo::columns, _Image::debug, _Image::filename, GetBlobStreamHandler(), GetMagickModule, LogMagickEvent(), MagickCoreSignature, MagickFalse, MagickTrue, _CacheInfo::pixels, _CacheInfo::signature, _Image::signature, StreamError, ThrowMagickException(), and TraceEvent.

Referenced by ReadStream().

MagickExport MagickBooleanType WriteStream	(	const ImageInfo *	image_info,
		Image *	image,
		StreamHandler	stream,
		ExceptionInfo *	exception
	)

References CloneImageInfo(), _ImageInfo::debug, DestroyImageInfo(), _ImageInfo::filename, GetMagickModule, LogMagickEvent(), _ImageInfo::magick, MagickCoreSignature, MagickFalse, _Image::signature, _ImageInfo::signature, _ImageInfo::stream, TraceEvent, and WriteImage().

static size_t WriteStreamImage	(	const Image *	image,
		const void *	pixels,
		const size_t	columns
	)			[static]

References AcquireAlignedMemory(), _Image::cache, CharPixel, _Image::client_data, CloneImageInfo(), _CacheInfo::columns, DestroyImageInfo(), DoublePixel, _StreamInfo::exception, _ImageInfo::extract, _StreamInfo::extract_info, FloatPixel, _RectangleInfo::height, _StreamInfo::image, _StreamInfo::image_info, LongLongPixel, LongPixel, MagickCoreSignature, _StreamInfo::map, ParseAbsoluteGeometry(), _StreamInfo::pixels, QuantumPixel, RelinquishAlignedMemory(), _CacheInfo::rows, SetImageInfo(), ShortPixel, _CacheInfo::signature, _StreamInfo::storage_type, _StreamInfo::stream, StreamImagePixels(), _RectangleInfo::width, WriteBlob(), _RectangleInfo::x, _RectangleInfo::y, and _StreamInfo::y.

Referenced by StreamImage().

---

Variable Documentation

ssize_t cache_anonymous_memory = (-1) [static]

Referenced by AcquireStreamPixels(), and ResetStreamAnonymousMemory().