Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Environment and Utilities /
Chapter 3 - Errors, Warnings, and Notices / About QuickDraw GX Errors, Warnings, and Notices


Debugging Version

When you install the debugging version, QuickDraw GX posts errors, warnings, and notices in addition to those posted by the non-debugging version. The debugging analysis and resulting number of errors, warnings, and notices posted is far more extensive than can be provided by the non-debugging version of QuickDraw GX. As a result, the debugging version executes significantly slower than the non-debugging version.

The errors and warnings posted by both the debugging and non-debugging versions of QuickDraw GX are listed in the sections "Errors" beginning on page 3-6 and "Warnings" beginning on page 3-10. The errors, warnings, and notices described in the following sections are posted only in the debugging version of QuickDraw GX.

The debugging version also provides a number of useful functions that you can use to analyze your code and that assist in determining the cause of a wide variety of problems. These are described in the section "Using Errors, Warnings, and Notices" beginning on page 3-30.

The debugging version of QuickDraw GX also provides validation functions and GraphicsBug so that you can examine the details of each graphics object. These are described in the chapter "QuickDraw GX Debugging" in this book.

Errors

This section describes the errors that the debugging version of QuickDraw GX may post. QuickDraw GX debugging errors can be grouped into the following categories:

Table 3-16 gives the debugging error number range
Table 3-16 Debugging error number range
NumberName
-27700gxFirstSystemDebuggingError
-27000gxLastSystemError
.

Table 3-17 lists the internal debugging errors
Table 3-17 Internal debugging errors
NumberName
-27700functionality_unimplemented
-27699clip_to_frame_shape_unimplemented
.

Table 3-18 lists the font parameter debugging errors.
Table 3-18 Font parameter debugging errors
NumberName
-27698illegal_font_storage_type
-27697illegal_font_storage_reference
-27696illegal_font_attributes

QuickDraw GX bad parameter errors are posted when a required parameter is out of range, invalid, or is passed with the value of nil. Table 3-19 lists the bad parameter debugging errors.
Table 3-19 Bad parameter debugging errors
NumberName
-27695parameter_out_of_range
-27694inconsistent_parameters
-27693index_is_less_than_zero
-27692index_is_less_than_one
-27691count_is_less_than_zero
-27690count_is_less_than_one
-27689contour_is_less_than_zero
-27688length_is_less_than_zero
-27687invalid_client_reference
-27686invalid_graphics_heap_start_pointer
-27685invalid_nongraphic_globals_pointer
-27684colorSpace_out_of_range
-27683pattern_lattice_out_of_range
-27682frequency_parameter_out_of_range
-27681tinting_parameter_out_of_range
-27680method_parameter_out_of_range
-27679space_may_not_be_indexed
-27678glyph_index_too_small
-27677no_glyphs_added_to_font
-27676glyph_not_added_to_font
-27675point_does_not_intersect_bitmap
-27674required_font_table_not_present
-27673unknown_font_table_format
-27672shapeFill_not_allowed
-27671inverseFill_face_must_set_clipLayer_flag
-27670invalid_transferMode_colorSpace
-27669colorProfile_must_be_nil
 
-27668bitmap_pixel_size_must_be_1
-27667empty_shape_not_allowed
-27666ignorePlatformShape_not_allowed
-27665nil_style_in_glyph_not_allowed
-27664complex_glyph_style_not_allowed
-27663invalid_mapping
-27662cannot_set_item_shapes_to_nil
-27661cannot_use_original_item_shapes_when_growing_picture
-27660cannot_add_unspecified_new_glyphs
-27659cannot_dispose_locked_tag
-27658cannot_dispose_locked_shape

Table 3-20 lists the QuickDraw GX restricted access debugging errors
Table 3-20 Restricted access debugging errors
NumberName
-27657shape_access_not_allowed
-27656colorSet_access_restricted
-27655colorProfile_access_restricted
-27654tag_access_restricted
-27653viewDevice_access_restricted
-27652graphic_type_does_not_have_a_structure
-27651style_run_array_does_not_match_number_of_characters
-27650rectangles_cannot_be_inserted_into
-27649unknown_graphics_heap
-27648graphics_routine_selector_is_obsolete
-27647cannot_set_graphics_client_memory_without_setting_size
-27646graphics_client_memory_too_small
-27645graphics_client_memory_is_already_allocated
-27644viewPort_is_a_window
.

Table 3-21 lists the QuickDraw GX wrong type and bad reference debugging errors.
Table 3-21 Wrong type and bad reference debugging errors
NumberName
-27643illegal_type_for_shape
-27642shape_does_not_contain_a_bitmap
-27641shape_does_not_contain_text
-27640picture_expected
-27639bitmap_is_not_resizable
-27638shape_may_not_be_a_bitmap
-27637shape__may_not_be_a_picture
-27636graphic_type_does_not_contain_points
-27635graphic_type_does_not_have_multiple_contours
-27634graphic_type_cannot_be_mapped
-27633graphic_type_cannot_be_moved
-27632graphic_type_cannot_be_scaled
-27631graphic_type_cannot_be_rotated
-27630graphic_type_cannot_be_skewed
-27629graphic_type_cannot_be_reset
-27628graphic_type_cannot_be_dashed
-27627graphic_type_cannot_be_reduced
-27626graphic_type_cannot_be_inset
-27625shape_cannot_be_inverted
-27624shape_does_not_have_area
-27623shape_does not_have_length
-27622first_glyph_advance_must_be_absolute
-27621picture_cannot_contain_itself
-27620viewPort_cannot_contain_itself
-27619cannot_set_unique_items_attribute_when_picture_contains_items
-27618layer_style_cannot_contain_a_face
-27617layer_glyph_shape_cannot_contain_nil_styles

QuickDraw GX posts validation errors only when QuickDraw GX validation error functions activate validation error checking. Validation error checking is discussed the chapter "QuickDraw GX Debugging" in this book. Table 3-22 lists the type validation debugging errors.
Table 3-22 Type validation debugging errors
NumberName
-27616object_wrong_type
-27615shape_wrong_type
-27614style_wrong_type
-27613ink_wrong_type
-27612transform_wrong_type
-27611device_wrong_type
-27610port_wrong_type

Table 3-23 lists the QuickDraw GX cache validation debugging errors.
Table 3-23 Cache validation debugging errors
NumberName
-27609shape_cache_wrong_type
-27608style_cache_wrong_type
-27607ink_cache_wrong_type
-27606transform_cache_wrong_type
-27605port_cache_wrong_type
-27604shape_cache_parent_mismatch
-27603style_cache_parent_mismatch
-27602ink_cache_parent_mismatch
-27601transform_cache_parent_mismatch
-27600port_cache_parent_mismatch
-27599invalid_shape_cache_port
-27598invalid_shape_cache_device
-27597invalid_ink_cache_port
-27596invalid_ink_cache_device
-27595invalid_style_cache_port
-27594invalid_style_cache_device
-27593invalid_transform_cache_port
-27592invalid_transform_cache_device
-27591recursive_caches

Table 3-24 lists the QuickDraw GX shape cache validation debugging errors.
Table 3-24 Shape cache validation shape debugging errors
NumberName
-27590invalid_fillShape_ownerCount
-27589recursive_fillShapes

Table 3-25 lists the QuickDraw GX memory block validation debugging errors.
Table 3-25 Memory block validation debugging errors
NumberName
-27588indirect_memory_block_too_small
-27587indirect_memory_block_too_large
-27586unexpected_nil_pointer
-27585bad_address

Table 3-26 lists the QuickDraw GX object validation debugging errors.
Table 3-26 Object validation debugging errors
NumberName
-27584no_owners
-27583invalid_pointer
-27582invalid_seed
-27581invalid_frame_seed
-27580invalid_text_seed
-27579invalid_draw_seed
-27578bad_printer_flags

Table 3-27 lists the QuickDraw GX path and polygon validation debugging errors.
Table 3-27 Path and polygon validation debugging errors
NumberName
-27577invalid_vector_count
-27576invalid_contour_count

Table 3-28 lists the QuickDraw GX bitmap validation debugging errors.
Table 3-28 Bitmap validation debugging errors
NumberName
-27575bitmap_ptr_too_small
-27574bitmap_ptr_not_aligned
-27573bitmap_rowBytes_negative
-27572bitmap_width_negative
-27571bitmap_height_negative
-27570invalid_pixelSize
-27569bitmap_rowBytes_too_small
-27568bitmap_rowBytes_not_aligned
-27567bitmap_rowBytes_must_be_specified_for_user_image_buffer

Table 3-29 lists the QuickDraw GX bitmap image validation debugging errors.
Table 3-29 Bitmap image validation debugging errors
NumberName
-27566invalid_bitImage_fileOffset
-27565invalid_bitImage_owners
-27564invalid_bitImage_rowBytes
-27563invalid_bitImage_internal_flag

Table 3-30 lists the QuickDraw GX text validation debugging errors.
Table 3-30 Text validation debugging errors
NumberName
-27562text_bounds_cache_wrong_size
-27561text_metrics_cache_wrong_size
-27560text_index_cache_wrong_size

Table 3-31 lists the QuickDraw GX glyph validation debugging errors.
Table 3-31 Glyph validation debugging errors
NumberName
-27559glyph_run_count_negative
-27558glyph_run_count_zero
-27557glyph_run_counts_do_not_sum_to_character_count
-27556glyph_first_advance_bit_set_not_allowed
-27555glyph_tangent_vectors_both_zero

Table 3-32 lists the QuickDraw GX layout validation debugging errors.
Table 3-32 Layout validation debugging errors
NumberName
-27554layout_run_length_negative
-27553layout_run_length_zero
-27552layout_run_level_negative
-27551layout_run_lengths_do_not_sum_to_text_length

Table 3-33 lists the QuickDraw GX picture validation debugging errors.
Table 3-33 Picture validation debugging errors
NumberName
-27550bad_shape_in_picture
-27549bad_style_in_picture
-27548bad_ink_in_picture
-27547bad_transform_in_picture
-27546bad_shape_cache_in_picture
-27545bad_seed_in_picture
-27544invalid_picture_count

Table 3-34 lists the QuickDraw GX text face validation debugging errors.
Table 3-34 Text face validation debugging errors
NumberName
-27543bad_textLayer_count
-27542bad_fillType_in_textFace
-27541bad_style_in_textFace
-27540bad_transform_in_textFace

Table 3-35 lists the QuickDraw GX transform validation debugging errors.
Table 3-35 Transform validation debugging errors
NumberName
-27539invalid_matrix_flag
-27538transform_clip_missing

Table 3-36 lists the QuickDraw GX font cache validation debugging errors.
Table 3-36 Font cache validation debugging errors
NumberName
-27537metrics_wrong_type
-27536metrics_point_size_probably_bad
-27535scalar_block_wrong_type
-27534scalar_block_parent_mismatch
-27533scalar_block_too_small
-27532scalar_block_too_large
-27531invalid_metrics_range
-27530invalid_metrics_flags
-27529metrics_maxWidth_probably_bad
-27528font_wrong_type
-27527font_wrong_size
-27526invalid_font_platform
-27525invalid_lookup_range
-27524invalid_lookup_platform
-27523font_not_in_font_list
-27522metrics_not_in_metrics_list

Table 3-37 lists the QuickDraw GX view device validation debugging errors.
Table 3-37 View device validation debugging errors
NumberName
-27521bad_device_private_flags
-27520bad_device_attributes
-27519invalid_device_number
-27518invalid_device_viewGroup
-27517invalid_device_bounds
-27516invalid_bitmap_in_device

Table 3-38 lists the QuickDraw GX color set validation debugging errors.
Table 3-38 Color set validation debugging errors
NumberName
-27515colorSet_wrong_type
-27514invalid_colorSet_viewDevice_owners
-27513invalid_colorSet_colorSpace
-27512invalid_colorSet_count

Table 3-39 lists the QuickDraw GX color profile validation debugging errors.
Table 3-39 Color profile validation debugging errors
NumberName
-27511colorProfile_wrong_type
-27510invalid_colorProfile_flags
-27509invalid_colorProfile_response_count

Table 3-40 lists the QuickDraw GX internal backing store validation debugging errors.
Table 3-40 Internal backing store validation debugging errors
NumberName
-27508backing_free_parent_mismatch
-27507backing_store_parent_mismatch

Warnings

This section describes the warnings that the debugging version of QuickDraw GX may post. QuickDraw GX debugging warnings can be grouped into the following categories:

Table 3-41 gives the range of debugging warning numbers.
Table 3-41 Debugging warning number range
NumberDescription
-26700gxFirstSystemDebuggingWarning
-26000gxLastSystemWarning

Table 3-42 lists the QuickDraw GX invalid data debugging warnings.
Table 3-42 Invalid data debugging warnings
NumberName
-26700new_shape_contains_invalid_data
-26699new_tag_contains_invalid_data
-26698extra_data_passed_was_ignored
-26697font_table_not_found
-26696font_name_not_found
-26695unable_to_traverse_open_contour_that_starts_or_ends_off_the_curve
-26694unable_to_draw_open_contour_that_starts_or_ends_off_the_curve
-26693cannot_dispose_default_shape
-26692cannot_dispose_default_style
-26691cannot_dispose_default_ink
-26690cannot_dispose_default_transform
-26689cannot_dispose_default_colorProfile
-26688cannot_dispose_default_colorSet
-26687shape_direct_attribute_not_set

Table 3-43 lists the QuickDraw GX can't find debugging warnings.
Table 3-43 Can't find debugging warnings
NumberName
-26686point_does_not_intersect_port
-26685cannot_dispose_non_font
-26684face_override_style_font_must_match_style
-26683union_of_area_and_and_length_returns_area_only
-26682insufficient_coordinate_space_for_new_device

Table 3-44 lists the QuickDraw GX other debugging warnings.
Table 3-44 Other debugging warnings
NumberName
-26681shape_passed_has_no_bounds
-26680tags_of_type_flst_removed
-26679translator_not_installed_on_this_grafport

Notices

QuickDraw GX provides notices only in the debugging version. This section describes the notices that the debugging version of QuickDraw GX may post. Each QuickDraw notice has a unique notice number and a notice name. Table 3-45 gives the debugging notice number range.
Table 3-45 Debugging version notice number summary
NumberDescription
-25999gxFirstSystemNotice
-25500gxLastSystemNotice

Table 3-46 lists the QuickDraw GX debugging notices.
Table 3-46 Debugging notices
NumberName
-25999parameters_have_no_effect
-25998attributes_already_set
-25997caps_already_set
-25996clip_already_set
-25995color_already_set
-25994curve_error_already_set
-25993dash_already_set
-25992default_colorProfile_already_set
-25991default_ink_already_set
-25990default_transform_already_set
 
-25989default_shape_already_set
-25988default_style_already_set
-25987dither_already_set
-25986encoding_already_set
-25985face_already_set
-25984fill_already_set
-25983font_already_set
-25982font_variations_already_set
-25981glyph_positions_are_already_set
-25980glyph_tangents_are_already_set
-25979halftone_already_set
-25978hit_test_already_set
-25977ink_already_set
-25976join_already_set
-25975justification_already_set
-25974mapping_already_set
-25973pattern_already_set
-25972pen_already_set
-25971style_already_set
-25970tag_already_set
-25969text_attributes_already_set
-25968text_size_already_set
-25967transfer_already_set
-25966translator_already_installed_on_this_grafport
-25965transform_already_set
-25964type_already_set
-25963validation_level_already_set
-25962viewPorts_already_set
-25961viewPorts_already_in_viewGroup
-25960viewDevice_already_in_viewGroup
-25959geometry_unaffected
-25958mapping_unaffected
-25957tags_in_shape_ignored
-25956shape_already_in_primitive_form
-25955shape_already_in_simple_form
-25954shape_already_broken
-25953shape_already_joined
-25952cache_already_cleared
-25951shape_not_disposed
-25950style_not_disposed
-25949ink_not_disposed
-25948transform_not_disposed
-25947colorSet_not_disposed
-25946colorProfile_not_disposed
-25945font_not_disposed
-25944glyph_tangents_have_no_effect
-25943glyph_positions_determined_by_advance
-25942transform_viewPorts_already_set
-25941directShape_attribute_set_as_side_effect
-25940lockShape_called_as_side_effect
-25939lockTag_called_as_side_effect
-25938shapes_unlocked_as_side_effect
-25937shape_not_locked
-25936tag_not_locked
-25935disposed_dead_caches
-25934disposed_live_caches
-25933low_on_memory
-25932very_low_on_memory
-25931transform_references_disposed_viewPort


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996