Mako 7.3.0 API
Error handling

EDL errors. Many of the EDL APIs return an (unsigned) integer result code where EDL_OK (0) indicates "success" and a non-zero value indicates an error of some kind.
A look-up function is provided to convert these integer result codes into (localizable) strings (see EDL::getEDLErrorString()) More...

Enumerations

enum  EDLErrorCode {
}
 These result codes are returned by a Mako API as an unsigned integer result code. EDL_OK (0) indicates "success" whereas a non-zero value indicates an error of some kind. More...
 

Detailed Description

EDL errors. Many of the EDL APIs return an (unsigned) integer result code where EDL_OK (0) indicates "success" and a non-zero value indicates an error of some kind.
A look-up function is provided to convert these integer result codes into (localizable) strings (see EDL::getEDLErrorString())

Enumeration Type Documentation

◆ EDLErrorCode

These result codes are returned by a Mako API as an unsigned integer result code. EDL_OK (0) indicates "success" whereas a non-zero value indicates an error of some kind.

Enumerator
EDL_ERR_PANIC 

Unstable state - abort the application.

EDL_ERR_UNDEFINED 

Undefined error.

EDL_ERR_LICENSE 

Invalid serial number or licence provided.

EDL_ERR_FILENOTFOUND 

File not found.

EDL_ERR_CORRUPT_PNG_IMAGE 

Corrupt PNG image encountered.

EDL_ERR_OUTOFMEMORY 

Out of memory.

EDL_ERR_READ 

Read error.

EDL_ERR_LARGE_FILE 

File too large.

EDL_ERR_OPENFORWRITE 

Open file for write failed.

EDL_ERR_WRITE 

Write failed.

EDL_ERR_IOERROR 

General IO error.

EDL_ERR_COMPRESS 

Compression error.

EDL_ERR_CONFIG 

Configuration error.

EDL_ERR_RESTRICTED_FONT 

A restricted font has been encountered.

EDL_ERR_ABORTED 

Job aborted by user.

EDL_ERR_BAD_ARGUMENTS 

General error for bad arguments passed to an API function.

EDL_ERR_VECTOR_ERROR 

An out-of range value was accessed in a CEDLVector.

EDL_ERR_BAD_FONT_MAP 

An error was found in a FontMap file.

EDL_ERR_UNICODE 

An invalid Unicode string was encountered.

EDL_ERR_PAGE_TOO_LARGE 

A page was too large to be used.

EDL_ERR_OPENFORREAD 

Open for read failed.

JM_ERR_GENERAL 

A general error occurred. Additional information will be provided with the exception.

JM_ERR_UNSUPPORTED 

An attempt was made to use an unsupported, unimplemented feature.

JM_ERR_REVERT_FAILED 

An attempt was made to revert a page that could not be performed.

JM_ERR_TARGET_NOT_FOUND 

A target with the given DOMid was not found.

JM_ERR_RANGE_ERROR 

An attempt was made to request or add an item from the API with an out-of-bounds index.

JM_ERR_PAGE_NOT_FOUND 

The given page was not found in a document.

JM_ERR_DOCUMENT_NOT_FOUND 

The given document was not found in an assembly.

JM_DUPLICATE_FIELD_PARTIAL_NAME 

A field with a duplicate partial name was found.

JM_ERR_FORM_FIELD_NOT_FOUND 

The given form field was not found.

JM_ERR_DUPLICATE_WIDGET 

A widget with a duplicate reference was not found.

JM_ERR_WIDGET_NOT_FOUND 

The given widget annotation or annotation reference could not be found.

JM_ERR_BAD_CONFIGURATION 

General configuration error.

JM_ERR_APPEARANCE_NOT_FOUND 

The required annotation appearance was not found.

JM_ERR_ANNOTATION_NOT_FOUND 

The required annotation was not found.

JM_ERR_ASSEMBLY_WRITE_FORBIDDEN 

The given assembly cannot be written due to security permissions.

JM_ERR_FONT_NOT_FOUND 

The requested font was not found.

JM_ERR_TOO_MANY_PDFOUT_WRITERS 

There are too many PDF Out writers currently in progress.

JM_ERR_INFORMATION_NOT_AVAILABLE 

The requested information is not yet available.

JM_ERR_DIRECTORY_DOESNT_EXIST 

A required directory does not exist on disk.

JM_ERR_RESOURCE_NOT_FOUND 

The requested resource could not be found.

JM_ERR_BAD_UNICODE_CMAP 

A bad ToUnicode CMap was encountered.

JM_ERR_OPTIONAL_CONTENT_GROUP_NOT_FOUND 

The requested optional content group was not found.

JM_ERR_INVALID_OPTIONAL_CONTENT 

Invalid optional content information encountered.

JM_ERR_PCLXL 

PCL/XL Processing error.

JM_ERR_PCL 

PCL5 Processing error.

JM_ERR_PJL 

PJL Processing error.

JM_ERR_SYMBOLSET_NOT_FOUND 

The requested PCL or PCL/XL symbol set was not found.

JM_ERR_PDF_OBJECT_NOT_FOUND 

An expected PDF object was not found.

JM_ERR_INVALID_PDF_OBJECT 

An invalid PDF object was encountered.

JM_ERR_INCORRECT_PDF_OBJECT_TYPE 

A PDF object of an invalid/unexpected type was encountered.

JM_ERR_IJPDS 

IJPDS Processing error.

JM_ERR_ATTEMPTED_WRITE_ON_OPEN_INPUT 

An attempt was made to open a writable stream on a file a file referenced by an open input.

JM_ERR_TTF_INSTRUCTIONS 

Invalid TrueType instructions were encountered.

EDL_ERR_BAD_DIMENSIONS 

Bad dimensions specified for an object.

EDL_ERR_NULL_NODE 

An unexpected null DOM node pointer was encountered.

EDL_ERR_BAD_BRUSH 

A bad brush was encountered.

EDL_ERR_DOM_CREATION_FAILED 

Failure while attempting to create a DOM object.

EDL_ERR_INVALID_DOM_ID 

An invalid DOMid was encountered.

EDL_ERR_INVALID_TYPE3_GLYPH 

An invalid Type 3 Glyph was encountered.

EDL_ERR_TYPE3_GLYPH_NOT_FOUND 

A Type 3 glyph was not found.

EDL_ERR_INVALID_GLYPHS 

An invalid Glyphs node was encountered.

EDL_ERR_BOUNDS_CALCULATION_FAILED 

An error was encountered while trying to find the bounds of a node.

EDL_ERR_NODE_ERROR 

An error was encountered while manipulating a node.

EDL_ERR_BAD_FONT 

A bad font was encountered.

EDL_ERR_BAD_GEOMETRY 

Bad path geometry was encountered.

EDL_ERR_IMMUTABLE_GEOMETRY 

An attempt was made to edit an immutable geometry element.

EDL_ERR_NO_COLOR_NAME 

No color name could be determined for the given colorant.

EDL_ERR_INVALID_ZIP 

XPS input: Invalid ZIP file encountered.

EDL_ERR_NO_CONTENT_TYPE 

XPS input: Unable to retrieve the content type for the part.

EDL_ERR_PROCESS_PART 

XPS input: Error processing the part.

EDL_ERR_XPS_PROVIDER 

XPS input: XPS provider error.

EDL_ERR_MISSING_RESOURCE 

XPS input: Missing resource.

EDL_ERR_DTD_CONTENT 

XPS input: DTD content detected.

EDL_ERR_MISSING_REQ_ATTRIBUTE 

XPS input: An element is missing a required attribute.

EDL_ERR_INVALID_ATTRIBUTE 

XPS input: An invalid attribute has been encountered in the element.

EDL_ERR_PROPERTY_ALREADY_SET 

XPS input: Attempt to set the same property twice.

EDL_ERR_REMOTERESOURCE_REF 

XPS input: Remote resource dictionary references another remote resource dictionary.

EDL_ERR_KEY_SET_NON_RESOURCE 

XPS input: Key attribute is set for an element that is not in the resource dictionary.

EDL_ERR_UNSUPPORTED_GLYPHS 

XPS input: Unsupported glyphs encountered.

EDL_ERR_INVALID_URI 

XPS input: Invalid URI encountered.

EDL_ERR_DEFLATE 

XPS input: Deflate error.

EDL_ERR_NO_KEY_RESDICT_OBJECT 

XPS input: Resource dictionary is missing the key attribute.

EDL_ERR_ADD_OBJECT_RESDICT 

XPS input: Error adding the element to the resource dictionary.

EDL_ERR_INVALID_ABBR_PATH 

XPS input: Error processing abbreviated path.

EDL_ERR_NAMESPACE_NOT_UNDERSTOOD 

XPS input: Namespace is not understood.

EDL_ERR_XML_PARSER 

XPS input: Parser error encountered.

EDL_ERR_NO_REQ_ELEMENT 

XPS input: Element is missing a required subelement.

EDL_ERR_MORE_THAN_ONE_ELEMENT 

XPS input: Element has more than one instance of a subelement.

EDL_ERR_INVALID_ELEMENT 

XPS input: Element contains an invalid subelement.

EDL_ERR_FALLBACK_BEFORE_CHOICE 

XPS input: Fallback element has been found before choice.

EDL_ERR_PREFIX_NOT_DEFINED 

XPS input: Undefined prefix encountered.

EDL_ERR_UNPREFIXED_ATTRIBUTE 

XPS input: Unprefixed attribute encountered.

EDL_ERR_BROKEN_ELEMENT_SEQUENCE 

XPS input: Broken element sequence encountered.

EDL_ERR_PREFIXED_ATTRIBUTE 

XPS input: Prefixed attribute encountered.

EDL_ERR_INVALID_IMAGE 

XPS input: Invalid image encountered.

EDL_ERR_NUMBER_REQ_ELEMENT 

XPS input: Insufficient elements of a particular type encountered.

EDL_ERR_MISSING_XPS_PART 

XPS input: Missing XPS part.

EDL_ERR_PRINTTICKET_EXISTS 

XPS input: PrintTicket already exists.

EDL_ERR_MULTIPLE_STARTPARTS_RELS 

XPS input: Multiple StartPart relationships encountered.

EDL_ERR_DICT_ITEM_PRESENT 

XPS input: Multiple items with the same key present.

EDL_ERR_MULTIPLE_COREPROPERTIES_RELS 

XPS input: Multiple CoreProperty relationships encountered.

EDL_ERR_MULTIPLE_DOCSTRUCTURE_RELS 

XPS input: Multiple DocumentStructure relationships encountered.

EDL_ERR_MULTIPLE_THUMBNAIL_RELS 

XPS input: Multiple thumbnail relationships encountered.

EDL_ERR_INVALID_THUMBNAIL_TYPE 

XPS input: Invalid thumbnail type encountered.

EDL_ERR_PRESERVED_ITEMS_NOT_DECLARED_IGNORABLE 

XPS input: Unable to preserve items! The namespace is not declared as ignorable.

EDL_ERR_MORE_THAN_ONE_GROUP_ELEMENT 

XPS input: Element contains more than one subelement.

EDL_ERR_NO_REQ_GROUP_ELEMENT 

XPS input: Element requires one subelement.

EDL_ERR_INVALID_COLOR_SPECIFICATION 

XPS input: Invalid color specification encountered.

EDL_ERR_PROCESS_CONTENT_NOT_DECLARED_IGNORABLE 

XPS input: Namespace in ProcessContent attribute is not declared as ignorable.

EDL_ERR_DUPLICATE_URI 

XPS input: Duplicate URI encountered.

EDL_ERR_UNEXPECTED_RESOURCE 

XPS output: Unexpected resource encountered.

EDL_ERR_DEVICE_OUTOFMEMORY 

XPS output: Insufficient device memory to process page.

EDL_ERR_XPS_FROM_ENCRYPTED_SOURCE 

XPS output: Attempt to create XPS from an encrypted document.

EDL_ERR_DELETE_OUTLINE_WITH_CLOSED_PARENT 

Outline: Attempt to delete outline entry with closed parent.

EDL_ERR_APPEND_OUTLINE_TO_CLOSED_NODE 

Outline: Attempt to append outline entry to a closed node.

EDL_ERR_FAILS_TO_ADD_OUTLINE_TO_METADATA_STORAGE 

Outline: Failed to append an outline entry to the metadata storage node.

EDL_ERR_INTERNAL_RIP 

Internal RIP error.

EDL_ERR_OPEN_PDF 

PDF input: Error opening PDF.

EDL_ERR_INVALID_PDF_PASSWORD 

PDF input: Error opening encrypted PDF; Invalid password and/or incorrect private key.

EDL_ERR_PSOUT_GENERAL_FAILURE 

PS output: General error.

EDL_ERR_PDFOUT_GENERAL_FAILURE 

PDF output: General error.

EDL_ERR_INVALID_FONT 

PDF output: Error processing a font.

EDL_ERR_INCOMPATIBLE_PDFA 

PDF/A output: Incompatible content found.

EDL_ERR_INCOMPATIBLE_PDFX 

PDF/X output: Incompatible content found.

EDL_ERR_BAD_COLOR_SPACE 

Color: A bad color space was encountered.

EDL_ERR_COLOR_CONVERSION_FAILURE 

Color: Color conversion failed.

EDL_ERR_INCOMPATIBLE_IMAGE_PARAMETER 

Image: An image encoder has been given an image or parameter that it cannot handle.

EDL_ERR_IMAGE_PARAMETER_OUT_OF_RANGE 

Image: An image parameter for encoding or decoding is outside the expected range.

EDL_ERR_IMAGE_DECODE_FAILURE 

Image: An image could not be decoded.

EDL_ERR_IMAGE_ENCODE_FAILURE 

Image: An image could not be encoded.

EDL_ERR_ZIP_WRITE_ONLY 

Zip: An attempt was made to retrieve a stream from a write-only Zip file.

EDL_ERR_ZIP_PATH_NOT_FOUND 

Zip: An expected entry in a Zip package was not found.

EDL_ERR_LICENSE_MISSING 

License: License checking indicated that required license information is missing.

EDL_ERR_LICENSE_BAD_CONFIG 

License:

EDL_ERR_LICENSE_INVALID 

License: License checking indicated that this license is invalid.