Legacy Document
Important: The information in this document is obsolete and should not be used for new development.
Important: The information in this document is obsolete and should not be used for new development.
Errors
QuickDraw GX provides you with an extended set of errors in the debugging version and a reduced set of errors in the non-debugging version. Each QuickDraw GX error constant has an error number described by thegxGraphicsErrortype definition and thegxGraphicErrorsenumeration:
typedef long gxGraphicsError; enum gxGraphicErrors { /* truly fatal errors */ out_of_memory = -27999, internal_fatal_error, no_outline_font_found, not_enough_memory_for_graphics_client_heap, could_not_create_backing_store, /* internal errors */ internal_error = -27950, internal_font_error, internal_layout_error, /* recoverable errors */ could_not_dispose_backing_store = internal_layout_error + 2, unflattening_interrupted_by_client, /* font manager errors */ font_cannot_be_changed, illegal_font_parameter, /* gxFont scaler errors */ null_font_scaler_context = -27900, null_font_scaler_input, invalid_font_scaler_context, invalid_font_scaler_input, invalid_font_scaler_font_data, font_scaler_newblock_failed, font_scaler_getfonttable_failed, font_scaler_bitmap_allocation_failed, font_scaler_outline_allocation_failed, required_font_scaler_table_missing, unsupported_font_scaler_outline_format, unsupported_font_scaler_stream_format, unsupported_font_scaler_font_format, font_scaler_hinting_error, font_scaler_rasterizer_error, font_scaler_internal_error, font_scaler_invalid_matrix, font_scaler_fixed_overflow, font_scaler_api_version_mismatch, font_scaler_streaming_aborted, unknown_font_scaler_error, /* bad parameters */ parameter_is_nil = -27850, shape_is_nil, style_is_nil, transform_is_nil, ink_is_nil, transferMode_is_nil, color_is_nil, colorProfile_is_nil, colorSet_is_nil, spoolProcedure_is_nil, tag_is_nil, type_is_nil, mapping_is_nil, invalid_viewDevice_reference, invalid_viewGroup_reference, invalid_viewPort_reference, /* implementation limits */ number_of_contours_exceeds_implementation_limit = -27800, number_of_points_exceeds_implementation_limit, size_of_polygon_exceeds_implementation_limit, size_of_path_exceeds_implementation_limit, size_of_text_exceeds_implementation_limit, size_of_bitmap_exceeds_implementation_limit, number_of_colors_exceeds_implementation_limit, procedure_not_reentrant #ifdef debugging , /* internal debugging errors: following available only in */ /* the debugging init */ functionality_unimplemented = -27700, clip_to_frame_shape_unimplemented, /* font parameter debugging errors */ illegal_font_storage_type, illegal_font_storage_reference, illegal_font_attributes, /* parameter debugging errors */ parameter_out_of_range, inconsistent_parameters, index_is_less_than_zero, index_is_less_than_one, count_is_less_than_zero, count_is_less_than_one, contour_is_less_than_zero, length_is_less_than_zero, invalid_client_reference, invalid_graphics_heap_start_pointer, invalid_nongraphic_globals_pointer, colorSpace_out_of_range, pattern_lattice_out_of_range, frequency_parameter_out_of_range, tinting_parameter_out_of_range, method_parameter_out_of_range, space_may_not_be_indexed, glyph_index_too_small, no_glyphs_added_to_font, glyph_not_added_to_font, point_does_not_intersect_bitmap, required_font_table_not_present, unknown_font_table_format, /* the styles encoding is not present in the font */ shapeFill_not_allowed, inverseFill_face_must_set_clipLayer_flag, invalid_transferMode_colorSpace, colorProfile_must_be_nil, bitmap_pixel_size_must_be_1, empty_shape_not_allowed, ignorePlatformShape_not_allowed, nil_style_in_glyph_not_allowed, complex_glyph_style_not_allowed, invalid_mapping, cannot_set_item_shapes_to_nil, cannot_use_original_item_shapes_when_growing_picture, cannot_add_unspecified_new_glyphs, cannot_dispose_locked_tag, cannot_dispose_locked_shape, /* restricted access */ shape_access_not_allowed, colorSet_access_restricted, colorProfile_access_restricted, tag_access_restricted, viewDevice_access_restricted, graphic_type_does_not_have_a_structure, style_run_array_does_not_match_number_of_characters, rectangles_cannot_be_inserted_into, unknown_graphics_heap, graphics_routine_selector_is_obsolete, cannot_set_graphics_client_memory_without_setting_size, graphics_client_memory_too_small, graphics_client_memory_is_already_allocated, viewPort_is_a_window, /* wrong type/bad reference */ illegal_type_for_shape, shape_does_not_contain_a_bitmap, shape_does_not_contain_text, picture_expected, bitmap_is_not_resizable, shape_may_not_be_a_bitmap, shape_may_not_be_a_picture, graphic_type_does_not_contain_points, graphic_type_does_not_have_multiple_contours, graphic_type_cannot_be_mapped, graphic_type_cannot_be_moved, graphic_type_cannot_be_scaled, graphic_type_cannot_be_rotated, graphic_type_cannot_be_skewed, graphic_type_cannot_be_reset, graphic_type_cannot_be_dashed, graphic_type_cannot_be_reduced, graphic_type_cannot_be_inset, shape_cannot_be_inverted, shape_does_not_have_area, shape_does_not_have_length, first_glyph_advance_must_be_absolute, picture_cannot_contain_itself, viewPort_cannot_contain_itself, cannot_set_unique_items_attribute_when_picture_ contains_items, layer_style_cannot_contain_a_face, layer_glyph_shape_cannot_contain_nil_styles, /* validation errors */ object_wrong_type, shape_wrong_type, style_wrong_type, ink_wrong_type, transform_wrong_type, device_wrong_type, port_wrong_type, /*cache validation errors */ shape_cache_wrong_type, style_cache_wrong_type, ink_cache_wrong_type, transform_cache_wrong_type, port_cache_wrong_type, shape_cache_parent_mismatch, style_cache_parent_mismatch, ink_cache_parent_mismatch, transform_cache_parent_mismatch, port_cache_parent_mismatch, invalid_shape_cache_port, invalid_shape_cache_device, invalid_ink_cache_port, invalid_ink_cache_device, invalid_style_cache_port, invalid_style_cache_device, invalid_transform_cache_port, invalid_transform_cache_device, recursive_caches, /*shape cache validation errors */ invalid_fillShape_ownerCount, recursive_fillShapes, /*memory block validation errors */ indirect_memory_block_too_small, indirect_memory_block_too_large, unexpected_nil_pointer, bad_address, /* object validation errors */ no_owners, invalid_pointer, invalid_seed, invalid_frame_seed, invalid_text_seed, invalid_draw_seed, bad_private_flags, /* path and polygon validation errors */ invalid_vector_count, invalid_contour_count, /* validation bitmap errors */ bitmap_ptr_too_small, bitmap_ptr_not_aligned, bitmap_rowBytes_negative, bitmap_width_negative, bitmap_height_negative, invalid_pixelSize, bitmap_rowBytes_too_small, bitmap_rowBytes_not_aligned, bitmap_rowBytes_must_be_specified_for_user_image_buffer, /* bitmap validation image errors */ invalid_bitImage_fileOffset, invalid_bitImage_owners, invalid_bitImage_rowBytes, invalid_bitImage_internal_flag, /* text validation errors */ text_bounds_cache_wrong_size, text_metrics_cache_wrong_size, text_index_cache_wrong_size, /* glyph validation errors */ glyph_run_count_negative, glyph_run_count_zero, glyph_run_counts_do_not_sum_to_character_count, glyph_first_advance_bit_set_not_allowed, glyph_tangent_vectors_both_zero, /* layout validation errors */ layout_run_length_negative, layout_run_length_zero, layout_run_level_negative, layout_run_lengths_do_not_sum_to_text_length, /* picture validation errors */ bad_shape_in_picture, bad_style_in_picture, bad_ink_in_picture, bad_transform_in_picture, bad_shape_cache_in_picture, bad_seed_in_picture, invalid_picture_count, /* text face validation errors */ bad_textLayer_count, bad_fillType_in_textFace, bad_style_in_textFace, bad_transform_in_textFace, /* transform validation errors */ invalid_matrix_flag, transform_clip_missing, /* font cache validation errors */ metrics_wrong_type, metrics_point_size_probably_bad, scalar_block_wrong_type, scalar_block_parent_mismatch, scalar_block_too_small, scalar_block_too_large, invalid_metrics_range, invalid_metrics_flags, metrics_maxWidth_probably_bad, font_wrong_type, font_wrong_size, invalid_font_platform, invalid_lookup_range, invalid_lookup_platform, font_not_in_font_list, metrics_not_in_metrics_list, /* view device validation errors */ bad_device_private_flags, bad_device_attributes, invalid_device_number, invalid_device_viewGroup, invalid_device_bounds, invalid_bitmap_in_device, /* color set validation errors */ colorSet_wrong_type, invalid_colorSet_viewDevice_owners, invalid_colorSet_colorSpace, invalid_colorSet_count, /* color profile validation errors */ colorProfile_wrong_type, invalid_colorProfile_flags, invalid_colorProfile_response_count, /* internal backing store validation errors */ backing_free_parent_mismatch, backing_store_parent_mismatch #endif };QuickDraw GX non-debugging errors are listed in the section "Errors" beginning on page 3-6. Debugging errors are listed in the section "Errors" beginning on page 3-6.