iapi.h 0000644 00000031312 14751151503 0005641 0 ustar 00 /* Copyright (C) 2001-2019 Artifex Software, Inc.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied,
modified or distributed except as expressly authorized under the terms
of the license contained in the file LICENSE in this distribution.
Refer to licensing information at http://www.artifex.com or contact
Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato,
CA 94945, U.S.A., +1(415)492-9861, for further information.
*/
/*
* Public API for Ghostscript interpreter
* for use both as DLL and for static linking.
*
* Should work for Windows, OS/2, Linux, Mac.
*
* DLL exported functions should be as similar as possible to imain.c
* You will need to include "ierrors.h".
*
* Current problems:
* 1. Ghostscript does not support multiple instances.
* 2. Global variables in gs_main_instance_default()
* and gsapi_instance_counter
*/
/* Exported functions may need different prefix
* GSDLLEXPORT marks functions as exported
* GSDLLAPI is the calling convention used on functions exported
* by Ghostscript
* GSDLLCALL is used on callback functions called by Ghostscript
* When you include this header file in the caller, you may
* need to change the definitions by defining these
* before including this header file.
* Make sure you get the calling convention correct, otherwise your
* program will crash either during callbacks or soon after returning
* due to stack corruption.
*/
#ifndef iapi_INCLUDED
# define iapi_INCLUDED
#ifdef __cplusplus
extern "C" {
#endif
#if defined(_WINDOWS_) || defined(__WINDOWS__)
# ifndef _Windows
# define _Windows
# endif
#endif
#ifdef _Windows
# ifndef GSDLLEXPORT
/* We don't need both the "__declspec(dllexport)" declaration
* and the listing in the .def file - having both results in
* a linker warning on x64 builds (but is incorrect on x86, too)
*/
# if 0
# define GSDLLEXPORT __declspec(dllexport)
# else
# define GSDLLEXPORT
# endif
# endif
# ifndef GSDLLAPI
# define GSDLLAPI __stdcall
# endif
# ifndef GSDLLCALL
# define GSDLLCALL __stdcall
# endif
#endif /* _Windows */
#if defined(OS2) && defined(__IBMC__)
# ifndef GSDLLAPI
# define GSDLLAPI _System
# endif
# ifndef GSDLLCALL
# define GSDLLCALL _System
# endif
#endif /* OS2 && __IBMC */
#ifdef __MACOS__
# pragma export on
#endif
#ifndef GSDLLEXPORT
# define GSDLLEXPORT
#endif
#ifndef GSDLLAPI
# define GSDLLAPI
#endif
#ifndef GSDLLCALL
# define GSDLLCALL
#endif
#if defined(__IBMC__)
# define GSDLLAPIPTR * GSDLLAPI
# define GSDLLCALLPTR * GSDLLCALL
#else
# define GSDLLAPIPTR GSDLLAPI *
# define GSDLLCALLPTR GSDLLCALL *
#endif
#ifndef display_callback_DEFINED
# define display_callback_DEFINED
typedef struct display_callback_s display_callback;
#endif
#ifndef gs_memory_DEFINED
# define gs_memory_DEFINED
typedef struct gs_memory_s gs_memory_t;
#endif
#ifndef gx_device_DEFINED
# define gx_device_DEFINED
typedef struct gx_device_s gx_device;
#endif
typedef struct gsapi_revision_s {
const char *product;
const char *copyright;
long revision;
long revisiondate;
} gsapi_revision_t;
/* Get version numbers and strings.
* This is safe to call at any time.
* You should call this first to make sure that the correct version
* of the Ghostscript is being used.
* pr is a pointer to a revision structure.
* len is the size of this structure in bytes.
* Returns 0 if OK, or if len too small (additional parameters
* have been added to the structure) it will return the required
* size of the structure.
*/
GSDLLEXPORT int GSDLLAPI
gsapi_revision(gsapi_revision_t *pr, int len);
/*
* WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
* Ghostscript supports only one instance.
* The current implementation uses a global static instance
* counter to make sure that only a single instance is used.
* If you try to create two instances, the second attempt
* will return < 0 and set pinstance to NULL.
* WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
*/
/* Create a new instance of Ghostscript.
* This instance is passed to most other API functions.
* The caller_handle will be provided to callback functions.
*/
GSDLLEXPORT int GSDLLAPI
gsapi_new_instance(void **pinstance, void *caller_handle);
/*
* WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
* Ghostscript supports only one instance.
* The current implementation uses a global static instance
* counter to make sure that only a single instance is used.
* WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
*/
/* Destroy an instance of Ghostscript
* Before you call this, Ghostscript must have finished.
* If Ghostscript has been initialised, you must call gsapi_exit()
* before gsapi_delete_instance.
*/
GSDLLEXPORT void GSDLLAPI
gsapi_delete_instance(void *instance);
/* Set the callback functions for stdio
* The stdin callback function should return the number of
* characters read, 0 for EOF, or -1 for error.
* The stdout and stderr callback functions should return
* the number of characters written.
* If a callback address is NULL, the real stdio will be used.
*/
GSDLLEXPORT int GSDLLAPI
gsapi_set_stdio(void *instance,
int (GSDLLCALLPTR stdin_fn)(void *caller_handle, char *buf, int len),
int (GSDLLCALLPTR stdout_fn)(void *caller_handle, const char *str, int len),
int (GSDLLCALLPTR stderr_fn)(void *caller_handle, const char *str, int len));
/* Set the callback function for polling.
* This is used for handling window events or cooperative
* multitasking. This function will only be called if
* Ghostscript was compiled with CHECK_INTERRUPTS
* as described in gpcheck.h.
* The polling function should return 0 if all is well,
* and negative if it wants ghostscript to abort.
* The polling function must be fast.
*/
GSDLLEXPORT int GSDLLAPI gsapi_set_poll(void *instance,
int (GSDLLCALLPTR poll_fn)(void *caller_handle));
/* Set the display device callback structure.
* If the display device is used, this must be called
* after gsapi_new_instance() and before gsapi_init_with_args().
* See gdevdisp.h for more details.
*/
GSDLLEXPORT int GSDLLAPI gsapi_set_display_callback(
void *instance, display_callback *callback);
/* Set the string containing the list of default device names
* for example "display x11alpha x11 bbox". Allows the calling
* application to influence which device(s) gs will try in order
* to select the default device
*
* *Must* be called after gsapi_new_instance() and before
* gsapi_init_with_args().
*/
GSDLLEXPORT int GSDLLAPI
gsapi_set_default_device_list(void *instance, char *list, int listlen);
/* Returns a pointer to the current default device string
* *Must* be called after gsapi_new_instance().
*/
GSDLLEXPORT int GSDLLAPI
gsapi_get_default_device_list(void *instance, char **list, int *listlen);
/* Set the encoding used for the args. By default we assume
* 'local' encoding. For windows this equates to whatever the current
* codepage is. For linux this is utf8.
*
* Use of this API (gsapi) with 'local' encodings (and hence without calling
* this function) is now deprecated!
*/
GSDLLEXPORT int GSDLLAPI gsapi_set_arg_encoding(void *instance,
int encoding);
enum {
GS_ARG_ENCODING_LOCAL = 0,
GS_ARG_ENCODING_UTF8 = 1,
GS_ARG_ENCODING_UTF16LE = 2
};
/* Initialise the interpreter.
* This calls gs_main_init_with_args() in imainarg.c
* 1. If quit or EOF occur during gsapi_init_with_args(),
* the return value will be gs_error_Quit. This is not an error.
* You must call gsapi_exit() and must not call any other
* gsapi_XXX functions.
* 2. If usage info should be displayed, the return value will be gs_error_Info
* which is not an error. Do not call gsapi_exit().
* 3. Under normal conditions this returns 0. You would then
* call one or more gsapi_run_*() functions and then finish
* with gsapi_exit().
*/
GSDLLEXPORT int GSDLLAPI gsapi_init_with_args(void *instance,
int argc, char **argv);
#ifdef __WIN32__
GSDLLEXPORT int GSDLLAPI gsapi_init_with_argsA(void *instance,
int argc, char **argv);
GSDLLEXPORT int GSDLLAPI gsapi_init_with_argsW(void *instance,
int argc, wchar_t **argv);
#endif
/*
* The gsapi_run_* functions are like gs_main_run_* except
* that the error_object is omitted.
* If these functions return <= -100, either quit or a fatal
* error has occured. You then call gsapi_exit() next.
* The only exception is gsapi_run_string_continue()
* which will return gs_error_NeedInput if all is well.
*/
GSDLLEXPORT int GSDLLAPI
gsapi_run_string_begin(void *instance,
int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_string_continue(void *instance,
const char *str, unsigned int length, int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_string_end(void *instance,
int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_string_with_length(void *instance,
const char *str, unsigned int length, int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_string(void *instance,
const char *str, int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_file(void *instance,
const char *file_name, int user_errors, int *pexit_code);
#ifdef __WIN32__
GSDLLEXPORT int GSDLLAPI
gsapi_run_fileA(void *instance,
const char *file_name, int user_errors, int *pexit_code);
GSDLLEXPORT int GSDLLAPI
gsapi_run_fileW(void *instance,
const wchar_t *file_name, int user_errors, int *pexit_code);
#endif
/* Retrieve the memory allocator for the interpreter instance */
GSDLLEXPORT gs_memory_t * GSDLLAPI
gsapi_get_device_memory(void *instance);
/* Set the device */
GSDLLEXPORT int GSDLLAPI
gsapi_set_device(void *instance, gx_device *pdev);
/* Exit the interpreter.
* This must be called on shutdown if gsapi_init_with_args()
* has been called, and just before gsapi_delete_instance().
*/
GSDLLEXPORT int GSDLLAPI
gsapi_exit(void *instance);
/* function prototypes */
typedef int (GSDLLAPIPTR PFN_gsapi_revision)(
gsapi_revision_t *pr, int len);
typedef int (GSDLLAPIPTR PFN_gsapi_new_instance)(
void **pinstance, void *caller_handle);
typedef void (GSDLLAPIPTR PFN_gsapi_delete_instance)(
void *instance);
typedef int (GSDLLAPIPTR PFN_gsapi_set_stdio)(void *instance,
int (GSDLLCALLPTR stdin_fn)(void *caller_handle, char *buf, int len),
int (GSDLLCALLPTR stdout_fn)(void *caller_handle, const char *str, int len),
int (GSDLLCALLPTR stderr_fn)(void *caller_handle, const char *str, int len));
typedef int (GSDLLAPIPTR PFN_gsapi_set_poll)(void *instance,
int(GSDLLCALLPTR poll_fn)(void *caller_handle));
typedef int (GSDLLAPIPTR PFN_gsapi_set_display_callback)(
void *instance, display_callback *callback);
typedef int (GSDLLAPIPTR PFN_gsapi_set_default_device_list)(
void *instance, char *list, int listlen);
typedef int (GSDLLAPIPTR PFN_gsapi_get_default_device_list)(
void *instance, char **list, int *listlen);
typedef int (GSDLLAPIPTR PFN_gsapi_init_with_args)(
void *instance, int argc, char **argv);
#ifdef __WIN32__
typedef int (GSDLLAPIPTR PFN_gsapi_init_with_argsA)(
void *instance, int argc, char **argv);
typedef int (GSDLLAPIPTR PFN_gsapi_init_with_argsW)(
void *instance, int argc, wchar_t **argv);
#endif
typedef int (GSDLLAPIPTR PFN_gsapi_set_arg_encoding)(
void *instance, int encoding);
typedef int (GSDLLAPIPTR PFN_gsapi_run_string_begin)(
void *instance, int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_string_continue)(
void *instance, const char *str, unsigned int length,
int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_string_end)(
void *instance, int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_string_with_length)(
void *instance, const char *str, unsigned int length,
int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_string)(
void *instance, const char *str,
int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_file)(void *instance,
const char *file_name, int user_errors, int *pexit_code);
#ifdef __WIN32__
typedef int (GSDLLAPIPTR PFN_gsapi_run_fileA)(void *instance,
const char *file_name, int user_errors, int *pexit_code);
typedef int (GSDLLAPIPTR PFN_gsapi_run_fileW)(void *instance,
const wchar_t *file_name, int user_errors, int *pexit_code);
#endif
typedef gs_memory_t * (GSDLLAPIPTR PFN_gsapi_get_device_memory)(void *instance);
typedef gs_memory_t * (GSDLLAPIPTR PFN_gsapi_set_device)(void *instance, gx_device *pdev);
typedef int (GSDLLAPIPTR PFN_gsapi_exit)(void *instance);
#ifdef __MACOS__
#pragma export off
#endif
#ifdef __cplusplus
} /* extern 'C' protection */
#endif
#endif /* iapi_INCLUDED */
ierrors.h 0000644 00000004215 14751151503 0006406 0 ustar 00 /* Copyright (C) 2001-2019 Artifex Software, Inc.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied,
modified or distributed except as expressly authorized under the terms
of the license contained in the file LICENSE in this distribution.
Refer to licensing information at http://www.artifex.com or contact
Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato,
CA 94945, U.S.A., +1(415)492-9861, for further information.
*/
/* Definition of error codes */
#ifndef ierrors_INCLUDED
# define ierrors_INCLUDED
#include "gserrors.h"
/*
* DO NOT USE THIS FILE IN THE GRAPHICS LIBRARY.
* THIS FILE IS PART OF THE POSTSCRIPT INTERPRETER.
* USE gserrors.h IN THE LIBRARY.
*/
/*
* A procedure that may return an error always returns
* a non-negative value (zero, unless otherwise noted) for success,
* or negative for failure.
* We use ints rather than an enum to avoid a lot of casting.
*/
/* Define the error name table */
extern const char *const gs_error_names[];
/* ------ PostScript Level 1 errors ------ */
#define LEVEL1_ERROR_NAMES\
"unknownerror", "dictfull", "dictstackoverflow", "dictstackunderflow",\
"execstackoverflow", "interrupt", "invalidaccess", "invalidexit",\
"invalidfileaccess", "invalidfont", "invalidrestore", "ioerror",\
"limitcheck", "nocurrentpoint", "rangecheck", "stackoverflow",\
"stackunderflow", "syntaxerror", "timeout", "typecheck", "undefined",\
"undefinedfilename", "undefinedresult", "unmatchedmark", "VMerror"
/* ------ Additional Level 2 errors (also in DPS) ------ */
#define LEVEL2_ERROR_NAMES\
"configurationerror", "undefinedresource", "unregistered"
/* ------ Additional DPS errors ------ */
#define DPS_ERROR_NAMES\
"invalidcontext", "invalidid"
#define ERROR_NAMES\
LEVEL1_ERROR_NAMES, LEVEL2_ERROR_NAMES, DPS_ERROR_NAMES
/*
* Define which error codes require re-executing the current object.
*/
#define GS_ERROR_IS_INTERRUPT(ecode)\
((ecode) == gs_error_interrupt || (ecode) == gs_error_timeout)
#endif /* ierrors_INCLUDED */
gserrors.h 0000644 00000033664 14751151504 0006602 0 ustar 00 /* Copyright (C) 2001-2019 Artifex Software, Inc.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied,
modified or distributed except as expressly authorized under the terms
of the license contained in the file LICENSE in this distribution.
Refer to licensing information at http://www.artifex.com or contact
Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato,
CA 94945, U.S.A., +1(415)492-9861, for further information.
*/
/* Error code definitions */
#ifndef gserrors_INCLUDED
# define gserrors_INCLUDED
/* A procedure that may return an error always returns */
/* a non-negative value (zero, unless otherwise noted) for success, */
/* or negative for failure. */
/* We don't use a typedef internally to avoid a lot of casting. */
enum gs_error_type {
gs_error_ok = 0,
gs_error_unknownerror = -1, /* unknown error */
gs_error_dictfull = -2,
gs_error_dictstackoverflow = -3,
gs_error_dictstackunderflow = -4,
gs_error_execstackoverflow = -5,
gs_error_interrupt = -6,
gs_error_invalidaccess = -7,
gs_error_invalidexit = -8,
gs_error_invalidfileaccess = -9,
gs_error_invalidfont = -10,
gs_error_invalidrestore = -11,
gs_error_ioerror = -12,
gs_error_limitcheck = -13,
gs_error_nocurrentpoint = -14,
gs_error_rangecheck = -15,
gs_error_stackoverflow = -16,
gs_error_stackunderflow = -17,
gs_error_syntaxerror = -18,
gs_error_timeout = -19,
gs_error_typecheck = -20,
gs_error_undefined = -21,
gs_error_undefinedfilename = -22,
gs_error_undefinedresult = -23,
gs_error_unmatchedmark = -24,
gs_error_VMerror = -25, /* must be the last Level 1 error */
/* ------ Additional Level 2 errors (also in DPS, ------ */
gs_error_configurationerror = -26,
gs_error_undefinedresource = -27,
gs_error_unregistered = -28,
gs_error_invalidcontext = -29,
/* invalidid is for the NeXT DPS extension. */
gs_error_invalidid = -30,
/* ------ Pseudo-errors used internally ------ */
gs_error_hit_detected = -99,
gs_error_Fatal = -100,
/*
* Internal code for the .quit operator.
* The real quit code is an integer on the operand stack.
* gs_interpret returns this only for a .quit with a zero exit code.
*/
gs_error_Quit = -101,
/*
* Internal code for a normal exit from the interpreter.
* Do not use outside of interp.c.
*/
gs_error_InterpreterExit = -102,
/* Need the remap color error for high level pattern support */
gs_error_Remap_Color = -103,
/*
* Internal code to indicate we have underflowed the top block
* of the e-stack.
*/
gs_error_ExecStackUnderflow = -104,
/*
* Internal code for the vmreclaim operator with a positive operand.
* We need to handle this as an error because otherwise the interpreter
* won't reload enough of its state when the operator returns.
*/
gs_error_VMreclaim = -105,
/*
* Internal code for requesting more input from run_string.
*/
gs_error_NeedInput = -106,
/*
* Internal code for a normal exit when usage info is displayed.
* This allows Window versions of Ghostscript to pause until
* the message can be read.
*/
gs_error_Info = -110,
/* A special 'error', like reamp color above. This is used by a subclassing
* device to indicate that it has fully processed a device method, and parent
* subclasses should not perform any further action. Currently this is limited
* to compositor creation.
*/
gs_error_handled = -111
};
/* We do provide a typedef type for external API use */
typedef enum gs_error_type gs_error_t;
int gs_log_error(int, const char *, int);
#if !defined(DEBUG) || defined(GS_THREADSAFE)
# define gs_log_error(err, file, line) (err)
#endif
#ifdef GS_THREADSAFE
#define gs_note_error(err) (err)
#define return_error(err) return (err)
#else
#define gs_note_error(err) gs_log_error(err, __FILE__, __LINE__)
#define return_error(err) return gs_note_error(err)
#endif
#if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L
# if defined(__GNUC__) && __GNUC__ >= 2
# define __func__ __FUNCTION__
# elif defined(__FUNCTION__)
# define __func__ __FUNCTION__
# elif defined(__FUNC__)
# define __func__ __FUNC__
# else
# define __func__ "<unknown>"
# endif
#endif
/*
* Error reporting macros.
*
*/
#ifndef __printflike
#if __GNUC__ > 2 || __GNUC__ == 2 && __GNUC_MINOR__ >= 7
#define __printflike(fmtarg, firstvararg) \
__attribute__((__format__ (__printf__, fmtarg, firstvararg)))
#else
#define __printflike(fmtarg, firstvararg)
#endif
#endif
const char *gs_errstr(int code);
#ifdef GS_THREADSAFE
/* In threadsafe builds, we just swallow errors unreported */
#define gs_throw_code(code) \
(code)
#define gs_throw(code, fmt) \
(code)
#define gs_throw1(code, fmt, arg1) \
(code)
#define gs_throw2(code, fmt, arg1, arg2) \
(code)
#define gs_throw3(code, fmt, arg1, arg2, arg3) \
(code)
#define gs_throw4(code, fmt, arg1, arg2, arg3, arg4) \
(code)
#define gs_throw5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
(code)
#define gs_throw6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
(code)
#define gs_throw7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
(code)
#define gs_throw8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
(code)
#define gs_throw9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
(code)
/* Bubble the code up the stack
*/
#define gs_rethrow_code(code) \
(code)
#define gs_rethrow(code, fmt) \
(code)
#define gs_rethrow1(code, fmt, arg1) \
(code)
#define gs_rethrow2(code, fmt, arg1, arg2) \
(code)
#define gs_rethrow3(code, fmt, arg1, arg2, arg3) \
(code)
#define gs_rethrow4(code, fmt, arg1, arg2, arg3, arg4) \
(code)
#define gs_rethrow5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
(code)
#define gs_rethrow6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
(code)
#define gs_rethrow7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
(code)
#define gs_rethrow8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
(code)
#define gs_rethrow9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
(code)
/* This will cause trouble, as it implies you are fixing an error
* the system will spew messages
*/
#define gs_catch(code, fmt) \
(code)
#define gs_catch1(code, fmt, arg1) \
(code)
#define gs_catch2(code, fmt, arg1, arg2) \
(code)
#define gs_catch3(code, fmt, arg1, arg2, arg3) \
(code)
#define gs_catch4(code, fmt, arg1, arg2, arg3, arg4) \
(code)
#define gs_catch5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
(code)
#define gs_catch6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
(code)
#define gs_catch7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
(code)
#define gs_catch8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
(code)
#define gs_catch9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
(code)
/* gs_warn is a printf
*/
#define gs_warn(fmt) \
DO_NOTHING
#define gs_warn1(fmt, arg1) \
DO_NOTHING
#define gs_warn2(fmt, arg1, arg2) \
DO_NOTHING
#define gs_warn3(fmt, arg1, arg2, arg3) \
DO_NOTHING
#define gs_warn4(fmt, arg1, arg2, arg3, arg4) \
DO_NOTHING
#define gs_warn5(fmt, arg1, arg2, arg3, arg4, arg5) \
DO_NOTHING
#define gs_warn6(fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
DO_NOTHING
#define gs_warn7(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
DO_NOTHING
#define gs_warn8(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
DO_NOTHING
#define gs_warn9(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
DO_NOTHING
#else
int gs_throw_imp(const char *func, const char *file, int line,
int op, int code, const char *fmt, ...) __printflike(6, 7);
/* Use throw at origin of error
*/
#define gs_throw_code(code) \
gs_throw1((code), "%s", gs_errstr((code)))
#define gs_throw(code, fmt) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt)
#define gs_throw1(code, fmt, arg1) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1)
#define gs_throw2(code, fmt, arg1, arg2) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2)
#define gs_throw3(code, fmt, arg1, arg2, arg3) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3)
#define gs_throw4(code, fmt, arg1, arg2, arg3, arg4) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4)
#define gs_throw5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4, arg5)
#define gs_throw6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6)
#define gs_throw7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
#define gs_throw8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
#define gs_throw9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
gs_throw_imp(__func__, __FILE__, __LINE__, 0, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9)
/* Bubble the code up the stack
*/
#define gs_rethrow_code(code) \
gs_rethrow1((code), "%s", gs_errstr((code)))
#define gs_rethrow(code, fmt) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt)
#define gs_rethrow1(code, fmt, arg1) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1)
#define gs_rethrow2(code, fmt, arg1, arg2) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2)
#define gs_rethrow3(code, fmt, arg1, arg2, arg3) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3)
#define gs_rethrow4(code, fmt, arg1, arg2, arg3, arg4) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4)
#define gs_rethrow5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4, arg5)
#define gs_rethrow6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6)
#define gs_rethrow7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
#define gs_rethrow8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
#define gs_rethrow9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
gs_throw_imp(__func__, __FILE__, __LINE__, 1, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9)
/* This will cause trouble, as it implies you are fixing an error
* the system will spew messages
*/
#define gs_catch(code, fmt) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt)
#define gs_catch1(code, fmt, arg1) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1)
#define gs_catch2(code, fmt, arg1, arg2) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2)
#define gs_catch3(code, fmt, arg1, arg2, arg3) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3)
#define gs_catch4(code, fmt, arg1, arg2, arg3, arg4) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4)
#define gs_catch5(code, fmt, arg1, arg2, arg3, arg4, arg5) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4, arg5)
#define gs_catch6(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6)
#define gs_catch7(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
#define gs_catch8(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
#define gs_catch9(code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
gs_throw_imp(__func__, __FILE__, __LINE__, 2, code, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9)
/* gs_warn is a printf
*/
#define gs_warn(fmt) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt)
#define gs_warn1(fmt, arg1) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1)
#define gs_warn2(fmt, arg1, arg2) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2)
#define gs_warn3(fmt, arg1, arg2, arg3) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3)
#define gs_warn4(fmt, arg1, arg2, arg3, arg4) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4)
#define gs_warn5(fmt, arg1, arg2, arg3, arg4, arg5) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4, arg5)
#define gs_warn6(fmt, arg1, arg2, arg3, arg4, arg5, arg6) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4, arg5, arg6)
#define gs_warn7(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7)
#define gs_warn8(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
#define gs_warn9(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) \
(void)gs_throw_imp(__func__, __FILE__, __LINE__, 3, 0, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9)
#endif
/* just in case you don't know 0 means no error
* other return codes are errors.
*/
#define gs_okay 0
#endif /* gserrors_INCLUDED */
gdevdsp.h 0000644 00000023412 14751151504 0006356 0 ustar 00 /* Copyright (C) 2001-2019 Artifex Software, Inc.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied,
modified or distributed except as expressly authorized under the terms
of the license contained in the file LICENSE in this distribution.
Refer to licensing information at http://www.artifex.com or contact
Artifex Software, Inc., 1305 Grant Avenue - Suite 200, Novato,
CA 94945, U.S.A., +1(415)492-9861, for further information.
*/
/* gdevdsp.h - callback structure for DLL based display device */
#ifndef gdevdsp_INCLUDED
# define gdevdsp_INCLUDED
/*
* The callback structure must be provided by calling the
* Ghostscript APIs in the following order:
* gsapi_new_instance(&minst);
* gsapi_set_display_callback(minst, callback);
* gsapi_init_with_args(minst, argc, argv);
*
* Supported parameters and default values are:
* -sDisplayHandle=16#04d2 or 1234 string
* Caller supplied handle as a decimal or hexadecimal number
* in a string. On 32-bit platforms, it may be set
* using -dDisplayHandle=1234 for backward compatibility.
* Included as first parameter of all callback functions.
*
* -dDisplayFormat=0 long
* Color format specified using bitfields below.
* Included as argument of display_size() and display_presize()
* These can only be changed when the device is closed.
*
* The second parameter of all callback functions "void *device"
* is the address of the Ghostscript display device instance.
* The arguments "void *handle" and "void *device" together
* uniquely identify an instance of the display device.
*
* A typical sequence of callbacks would be
* open, presize, memalloc, size, sync, page
* presize, memfree, memalloc, size, sync, page
* preclose, memfree, close
* The caller should not access the image buffer:
* - before the first sync
* - between presize and size
* - after preclose
* If opening the device fails, you might see the following:
* open, presize, memalloc, memfree, close
*
*/
#define DISPLAY_VERSION_MAJOR 2
#define DISPLAY_VERSION_MINOR 0
#define DISPLAY_VERSION_MAJOR_V1 1 /* before separation format was added */
#define DISPLAY_VERSION_MINOR_V1 0
/* The display format is set by a combination of the following bitfields */
/* Define the color space alternatives */
typedef enum {
DISPLAY_COLORS_NATIVE = (1<<0),
DISPLAY_COLORS_GRAY = (1<<1),
DISPLAY_COLORS_RGB = (1<<2),
DISPLAY_COLORS_CMYK = (1<<3),
DISPLAY_COLORS_SEPARATION = (1<<19)
} DISPLAY_FORMAT_COLOR;
#define DISPLAY_COLORS_MASK 0x8000fL
/* Define whether alpha information, or an extra unused bytes is included */
/* DISPLAY_ALPHA_FIRST and DISPLAY_ALPHA_LAST are not implemented */
typedef enum {
DISPLAY_ALPHA_NONE = (0<<4),
DISPLAY_ALPHA_FIRST = (1<<4),
DISPLAY_ALPHA_LAST = (1<<5),
DISPLAY_UNUSED_FIRST = (1<<6), /* e.g. Mac xRGB */
DISPLAY_UNUSED_LAST = (1<<7) /* e.g. Windows BGRx */
} DISPLAY_FORMAT_ALPHA;
#define DISPLAY_ALPHA_MASK 0x00f0L
/* Define the depth per component for DISPLAY_COLORS_GRAY,
* DISPLAY_COLORS_RGB and DISPLAY_COLORS_CMYK,
* or the depth per pixel for DISPLAY_COLORS_NATIVE
* DISPLAY_DEPTH_2 and DISPLAY_DEPTH_12 have not been tested.
*/
typedef enum {
DISPLAY_DEPTH_1 = (1<<8),
DISPLAY_DEPTH_2 = (1<<9),
DISPLAY_DEPTH_4 = (1<<10),
DISPLAY_DEPTH_8 = (1<<11),
DISPLAY_DEPTH_12 = (1<<12),
DISPLAY_DEPTH_16 = (1<<13)
/* unused (1<<14) */
/* unused (1<<15) */
} DISPLAY_FORMAT_DEPTH;
#define DISPLAY_DEPTH_MASK 0xff00L
/* Define whether Red/Cyan should come first,
* or whether Blue/Black should come first
*/
typedef enum {
DISPLAY_BIGENDIAN = (0<<16), /* Red/Cyan first */
DISPLAY_LITTLEENDIAN = (1<<16) /* Blue/Black first */
} DISPLAY_FORMAT_ENDIAN;
#define DISPLAY_ENDIAN_MASK 0x00010000L
/* Define whether the raster starts at the top or bottom of the bitmap */
typedef enum {
DISPLAY_TOPFIRST = (0<<17), /* Unix, Mac */
DISPLAY_BOTTOMFIRST = (1<<17) /* Windows */
} DISPLAY_FORMAT_FIRSTROW;
#define DISPLAY_FIRSTROW_MASK 0x00020000L
/* Define whether packing RGB in 16-bits should use 555
* or 565 (extra bit for green)
*/
typedef enum {
DISPLAY_NATIVE_555 = (0<<18),
DISPLAY_NATIVE_565 = (1<<18)
} DISPLAY_FORMAT_555;
#define DISPLAY_555_MASK 0x00040000L
/* Define the row alignment, which must be equal to or greater than
* the size of a pointer.
* The default (DISPLAY_ROW_ALIGN_DEFAULT) is the size of a pointer,
* 4 bytes (DISPLAY_ROW_ALIGN_4) on 32-bit systems or 8 bytes
* (DISPLAY_ROW_ALIGN_8) on 64-bit systems.
*/
typedef enum {
DISPLAY_ROW_ALIGN_DEFAULT = (0<<20),
/* DISPLAY_ROW_ALIGN_1 = (1<<20), */ /* not currently possible */
/* DISPLAY_ROW_ALIGN_2 = (2<<20), */ /* not currently possible */
DISPLAY_ROW_ALIGN_4 = (3<<20),
DISPLAY_ROW_ALIGN_8 = (4<<20),
DISPLAY_ROW_ALIGN_16 = (5<<20),
DISPLAY_ROW_ALIGN_32 = (6<<20),
DISPLAY_ROW_ALIGN_64 = (7<<20)
} DISPLAY_FORMAT_ROW_ALIGN;
#define DISPLAY_ROW_ALIGN_MASK 0x00700000L
#ifndef display_callback_DEFINED
#define display_callback_DEFINED
typedef struct display_callback_s display_callback;
#endif
/*
* Note that for Windows, the display callback functions are
* cdecl, not stdcall. This differs from those in iapi.h.
*/
struct display_callback_s {
/* Size of this structure */
/* Used for checking if we have been handed a valid structure */
int size;
/* Major version of this structure */
/* The major version number will change if this structure changes. */
int version_major;
/* Minor version of this structure */
/* The minor version number will change if new features are added
* without changes to this structure. For example, a new color
* format.
*/
int version_minor;
/* New device has been opened */
/* This is the first event from this device. */
int (*display_open)(void *handle, void *device);
/* Device is about to be closed. */
/* Device will not be closed until this function returns. */
int (*display_preclose)(void *handle, void *device);
/* Device has been closed. */
/* This is the last event from this device. */
int (*display_close)(void *handle, void *device);
/* Device is about to be resized. */
/* Resize will only occur if this function returns 0. */
/* raster is byte count of a row. */
int (*display_presize)(void *handle, void *device,
int width, int height, int raster, unsigned int format);
/* Device has been resized. */
/* New pointer to raster returned in pimage */
int (*display_size)(void *handle, void *device, int width, int height,
int raster, unsigned int format, unsigned char *pimage);
/* flushpage */
int (*display_sync)(void *handle, void *device);
/* showpage */
/* If you want to pause on showpage, then don't return immediately */
int (*display_page)(void *handle, void *device, int copies, int flush);
/* Notify the caller whenever a portion of the raster is updated. */
/* This can be used for cooperative multitasking or for
* progressive update of the display.
* This function pointer may be set to NULL if not required.
*/
int (*display_update)(void *handle, void *device, int x, int y,
int w, int h);
/* Allocate memory for bitmap */
/* This is provided in case you need to create memory in a special
* way, e.g. shared. If this is NULL, the Ghostscript memory device
* allocates the bitmap. This will only called to allocate the
* image buffer. The first row will be placed at the address
* returned by display_memalloc.
*/
void *(*display_memalloc)(void *handle, void *device, unsigned long size);
/* Free memory for bitmap */
/* If this is NULL, the Ghostscript memory device will free the bitmap */
int (*display_memfree)(void *handle, void *device, void *mem);
/* Added in V2 */
/* When using separation color space (DISPLAY_COLORS_SEPARATION),
* give a mapping for one separation component.
* This is called for each new component found.
* It may be called multiple times for each component.
* It may be called at any time between display_size
* and display_close.
* The client uses this to map from the separations to CMYK
* and hence to RGB for display.
* GS must only use this callback if version_major >= 2.
* The unsigned short c,m,y,k values are 65535 = 1.0.
* This function pointer may be set to NULL if not required.
*/
int (*display_separation)(void *handle, void *device,
int component, const char *component_name,
unsigned short c, unsigned short m,
unsigned short y, unsigned short k);
};
/* This is the V1 structure, before separation format was added */
struct display_callback_v1_s {
int size;
int version_major;
int version_minor;
int (*display_open)(void *handle, void *device);
int (*display_preclose)(void *handle, void *device);
int (*display_close)(void *handle, void *device);
int (*display_presize)(void *handle, void *device,
int width, int height, int raster, unsigned int format);
int (*display_size)(void *handle, void *device, int width, int height,
int raster, unsigned int format, unsigned char *pimage);
int (*display_sync)(void *handle, void *device);
int (*display_page)(void *handle, void *device, int copies, int flush);
int (*display_update)(void *handle, void *device, int x, int y,
int w, int h);
void *(*display_memalloc)(void *handle, void *device, unsigned long size);
int (*display_memfree)(void *handle, void *device, void *mem);
};
#define DISPLAY_CALLBACK_V1_SIZEOF sizeof(struct display_callback_v1_s)
#endif /* gdevdsp_INCLUDED */