ProjectSettings¶

继承¶

Object

简要描述¶

包含可从任何地方访问的全局变量。

描述¶

包含可从任何地方访问的全局变量。

命名“项目设置”属性时，请使用设置的完整路径，包括类别。

**覆盖：**通过在项目的根目录中创建名为override.cfg的文件，可以覆盖任何项目设置。

成员¶

方法¶

常量¶

成员说明¶

• String android/modules

• Color application/boot_splash/bg_color

• bool application/boot_splash/fullsize

• String application/boot_splash/image

• bool application/boot_splash/use_filter

• String application/config/custom_user_dir_name

• String application/config/description

• String application/config/icon

• String application/config/macos_native_icon

• String application/config/name

• String application/config/project_settings_override

• bool application/config/use_custom_user_dir

• String application/config/windows_native_icon

• bool application/run/disable_stderr

• bool application/run/disable_stdout

• int application/run/frame_delay_msec

• bool application/run/low_processor_mode

• int application/run/low_processor_mode_sleep_usec

• String application/run/main_scene

• float audio/channel_disable_threshold_db

• float audio/channel_disable_time

• String audio/default_bus_layout

• String audio/driver

• bool audio/enable_audio_input

• int audio/mix_rate

• int audio/output_latency

• int audio/video_delay_compensation_ms

• int compression/formats/gzip/compression_level

• int compression/formats/zlib/compression_level

• int compression/formats/zstd/compression_level

• bool compression/formats/zstd/long_distance_matching

• int compression/formats/zstd/window_log_size

• bool debug/gdscript/completion/autocomplete_setters_and_getters

• bool debug/gdscript/warnings/constant_used_as_function

• bool debug/gdscript/warnings/deprecated_keyword

• bool debug/gdscript/warnings/enable

• bool debug/gdscript/warnings/exclude_addons

• bool debug/gdscript/warnings/function_conflicts_constant

• bool debug/gdscript/warnings/function_conflicts_variable

• bool debug/gdscript/warnings/function_may_yield

• bool debug/gdscript/warnings/function_used_as_property

• bool debug/gdscript/warnings/incompatible_ternary

• bool debug/gdscript/warnings/integer_division

• bool debug/gdscript/warnings/narrowing_conversion

• bool debug/gdscript/warnings/property_used_as_function

• bool debug/gdscript/warnings/return_value_discarded

• bool debug/gdscript/warnings/shadowed_variable

• bool debug/gdscript/warnings/standalone_expression

• bool debug/gdscript/warnings/standalone_ternary

• bool debug/gdscript/warnings/treat_warnings_as_errors

• bool debug/gdscript/warnings/unassigned_variable

• bool debug/gdscript/warnings/unassigned_variable_op_assign

• bool debug/gdscript/warnings/unreachable_code

• bool debug/gdscript/warnings/unsafe_call_argument

• bool debug/gdscript/warnings/unsafe_cast

• bool debug/gdscript/warnings/unsafe_method_access

• bool debug/gdscript/warnings/unsafe_property_access

• bool debug/gdscript/warnings/unused_argument

• bool debug/gdscript/warnings/unused_class_variable

• bool debug/gdscript/warnings/unused_signal

• bool debug/gdscript/warnings/unused_variable

• bool debug/gdscript/warnings/variable_conflicts_function

• bool debug/gdscript/warnings/void_assignment

• String debug/settings/crash_handler/message

• int debug/settings/fps/force_fps

• int debug/settings/gdscript/max_call_stack

• int debug/settings/profiler/max_functions

• bool debug/settings/stdout/print_fps

• bool debug/settings/stdout/verbose_stdout

• int debug/settings/visual_script/max_call_stack

• Color debug/shapes/collision/contact_color

• int debug/shapes/collision/max_contacts_displayed

• Color debug/shapes/collision/shape_color

• Color debug/shapes/navigation/disabled_geometry_color

• Color debug/shapes/navigation/geometry_color

• String display/mouse_cursor/custom_image

• Vector2 display/mouse_cursor/custom_image_hotspot

• Vector2 display/mouse_cursor/tooltip_position_offset

• bool display/window/dpi/allow_hidpi

• bool display/window/energy_saving/keep_screen_on

• String display/window/handheld/orientation

• bool display/window/ios/hide_home_indicator

• bool display/window/per_pixel_transparency/allowed

• bool display/window/per_pixel_transparency/enabled

• bool display/window/size/always_on_top

• bool display/window/size/borderless

• bool display/window/size/fullscreen

• int display/window/size/height

• bool display/window/size/resizable

• int display/window/size/test_height

• int display/window/size/test_width

• int display/window/size/width

• bool display/window/vsync/use_vsync

• bool display/window/vsync/vsync_via_compositor

• String editor/script_templates_search_path

• PoolStringArray editor/search_in_file_extensions

• int gui/common/default_scroll_deadzone

• bool gui/common/swap_ok_cancel

• String gui/theme/custom

• String gui/theme/custom_font

• bool gui/theme/use_hidpi

• int gui/timers/incremental_search_max_interval_msec

• float gui/timers/text_edit_idle_detect_sec

• float gui/timers/tooltip_delay_sec

• Dictionary input/ui_accept

• Dictionary input/ui_cancel

• Dictionary input/ui_down

• Dictionary input/ui_end

• Dictionary input/ui_focus_next

• Dictionary input/ui_focus_prev

• Dictionary input/ui_home

• Dictionary input/ui_left

• Dictionary input/ui_page_down

• Dictionary input/ui_page_up

• Dictionary input/ui_right

• Dictionary input/ui_select

• Dictionary input/ui_up

• bool input_devices/pointing/emulate_mouse_from_touch

• bool input_devices/pointing/emulate_touch_from_mouse

• String layer_names/2d_physics/layer_1

• String layer_names/2d_physics/layer_10

• String layer_names/2d_physics/layer_11

• String layer_names/2d_physics/layer_12

• String layer_names/2d_physics/layer_13

• String layer_names/2d_physics/layer_14

• String layer_names/2d_physics/layer_15

• String layer_names/2d_physics/layer_16

• String layer_names/2d_physics/layer_17

• String layer_names/2d_physics/layer_18

• String layer_names/2d_physics/layer_19

• String layer_names/2d_physics/layer_2

• String layer_names/2d_physics/layer_20

• String layer_names/2d_physics/layer_3

• String layer_names/2d_physics/layer_4

• String layer_names/2d_physics/layer_5

• String layer_names/2d_physics/layer_6

• String layer_names/2d_physics/layer_7

• String layer_names/2d_physics/layer_8

• String layer_names/2d_physics/layer_9

• String layer_names/2d_render/layer_1

• String layer_names/2d_render/layer_10

• String layer_names/2d_render/layer_11

• String layer_names/2d_render/layer_12

• String layer_names/2d_render/layer_13

• String layer_names/2d_render/layer_14

• String layer_names/2d_render/layer_15

• String layer_names/2d_render/layer_16

• String layer_names/2d_render/layer_17

• String layer_names/2d_render/layer_18

• String layer_names/2d_render/layer_19

• String layer_names/2d_render/layer_2

• String layer_names/2d_render/layer_20

• String layer_names/2d_render/layer_3

• String layer_names/2d_render/layer_4

• String layer_names/2d_render/layer_5

• String layer_names/2d_render/layer_6

• String layer_names/2d_render/layer_7

• String layer_names/2d_render/layer_8

• String layer_names/2d_render/layer_9

• String layer_names/3d_physics/layer_1

• String layer_names/3d_physics/layer_10

• String layer_names/3d_physics/layer_11

• String layer_names/3d_physics/layer_12

• String layer_names/3d_physics/layer_13

• String layer_names/3d_physics/layer_14

• String layer_names/3d_physics/layer_15

• String layer_names/3d_physics/layer_16

• String layer_names/3d_physics/layer_17

• String layer_names/3d_physics/layer_18

• String layer_names/3d_physics/layer_19

• String layer_names/3d_physics/layer_2

• String layer_names/3d_physics/layer_20

• String layer_names/3d_physics/layer_3

• String layer_names/3d_physics/layer_4

• String layer_names/3d_physics/layer_5

• String layer_names/3d_physics/layer_6

• String layer_names/3d_physics/layer_7

• String layer_names/3d_physics/layer_8

• String layer_names/3d_physics/layer_9

• String layer_names/3d_render/layer_1

• String layer_names/3d_render/layer_10

• String layer_names/3d_render/layer_11

• String layer_names/3d_render/layer_12

• String layer_names/3d_render/layer_13

• String layer_names/3d_render/layer_14

• String layer_names/3d_render/layer_15

• String layer_names/3d_render/layer_16

• String layer_names/3d_render/layer_17

• String layer_names/3d_render/layer_18

• String layer_names/3d_render/layer_19

• String layer_names/3d_render/layer_2

• String layer_names/3d_render/layer_20

• String layer_names/3d_render/layer_3

• String layer_names/3d_render/layer_4

• String layer_names/3d_render/layer_5

• String layer_names/3d_render/layer_6

• String layer_names/3d_render/layer_7

• String layer_names/3d_render/layer_8

• String layer_names/3d_render/layer_9

• String locale/fallback

• String locale/test

• bool logging/file_logging/enable_file_logging

• String logging/file_logging/log_path

• int logging/file_logging/max_log_files

• int memory/limits/message_queue/max_size_kb

• int memory/limits/multithreaded_server/rid_pool_prealloc

• int network/limits/debugger_stdout/max_chars_per_second

• int network/limits/debugger_stdout/max_errors_per_second

• int network/limits/debugger_stdout/max_messages_per_frame

• int network/limits/debugger_stdout/max_warnings_per_second

• int network/limits/packet_peer_stream/max_buffer_po2

• int network/limits/tcp/connect_timeout_seconds

• int network/limits/webrtc/max_channel_in_buffer_kb

• int network/limits/websocket_client/max_in_buffer_kb

• int network/limits/websocket_client/max_in_packets

• int network/limits/websocket_client/max_out_buffer_kb

• int network/limits/websocket_client/max_out_packets

• int network/limits/websocket_server/max_in_buffer_kb

• int network/limits/websocket_server/max_in_packets

• int network/limits/websocket_server/max_out_buffer_kb

• int network/limits/websocket_server/max_out_packets

• int network/remote_fs/page_read_ahead

• int network/remote_fs/page_size

• String network/ssl/certificates

• int node/name_casing

• int node/name_num_separator

• int physics/2d/bp_hash_table_size

• int physics/2d/cell_size

• float physics/2d/default_angular_damp

• int physics/2d/default_gravity

• Vector2 physics/2d/default_gravity_vector

• float physics/2d/default_linear_damp

• int physics/2d/large_object_surface_threshold_in_cells

• String physics/2d/physics_engine

• float physics/2d/sleep_threshold_angular

• float physics/2d/sleep_threshold_linear

• int physics/2d/thread_model

• float physics/2d/time_before_sleep

• bool physics/3d/active_soft_world

• float physics/3d/default_angular_damp

• float physics/3d/default_gravity

• Vector3 physics/3d/default_gravity_vector

• float physics/3d/default_linear_damp

• String physics/3d/physics_engine

• bool physics/common/enable_object_picking

• int physics/common/physics_fps

• float physics/common/physics_jitter_fix

• Color rendering/environment/default_clear_color

• String rendering/environment/default_environment

• int rendering/limits/buffers/blend_shape_max_buffer_size_kb

• int rendering/limits/buffers/canvas_polygon_buffer_size_kb

• int rendering/limits/buffers/canvas_polygon_index_buffer_size_kb

• int rendering/limits/buffers/immediate_buffer_size_kb

• int rendering/limits/rendering/max_renderable_elements

• int rendering/limits/rendering/max_renderable_lights

• int rendering/limits/rendering/max_renderable_reflections

• float rendering/limits/time/time_rollover_secs

• bool rendering/quality/2d/gles2_use_nvidia_rect_flicker_workaround

• bool rendering/quality/2d/use_pixel_snap

• bool rendering/quality/depth/hdr

• bool rendering/quality/depth/hdr.mobile

• String rendering/quality/depth_prepass/disable_for_vendors

• bool rendering/quality/depth_prepass/enable

• int rendering/quality/directional_shadow/size

• int rendering/quality/directional_shadow/size.mobile

• String rendering/quality/driver/driver_name

• bool rendering/quality/driver/fallback_to_gles2

• int rendering/quality/filters/anisotropic_filter_level

• int rendering/quality/filters/msaa

• bool rendering/quality/filters/use_nearest_mipmap_filter

• int rendering/quality/intended_usage/framebuffer_allocation

• int rendering/quality/intended_usage/framebuffer_allocation.mobile

• int rendering/quality/reflections/atlas_size

• int rendering/quality/reflections/atlas_subdiv

• bool rendering/quality/reflections/high_quality_ggx

• bool rendering/quality/reflections/high_quality_ggx.mobile

• int rendering/quality/reflections/irradiance_max_size

• bool rendering/quality/reflections/texture_array_reflections

• bool rendering/quality/reflections/texture_array_reflections.mobile

• bool rendering/quality/shading/force_blinn_over_ggx

• bool rendering/quality/shading/force_blinn_over_ggx.mobile

• bool rendering/quality/shading/force_lambert_over_burley

• bool rendering/quality/shading/force_lambert_over_burley.mobile

• bool rendering/quality/shading/force_vertex_shading

• bool rendering/quality/shading/force_vertex_shading.mobile

• int rendering/quality/shadow_atlas/quadrant_0_subdiv

• int rendering/quality/shadow_atlas/quadrant_1_subdiv

• int rendering/quality/shadow_atlas/quadrant_2_subdiv

• int rendering/quality/shadow_atlas/quadrant_3_subdiv

• int rendering/quality/shadow_atlas/size

• int rendering/quality/shadow_atlas/size.mobile

• int rendering/quality/shadows/filter_mode

• int rendering/quality/shadows/filter_mode.mobile

• bool rendering/quality/subsurface_scattering/follow_surface

• int rendering/quality/subsurface_scattering/quality

• int rendering/quality/subsurface_scattering/scale

• bool rendering/quality/subsurface_scattering/weight_samples

• bool rendering/quality/voxel_cone_tracing/high_quality

• int rendering/threads/thread_model

• bool rendering/vram_compression/import_bptc

• bool rendering/vram_compression/import_etc

• bool rendering/vram_compression/import_etc2

• bool rendering/vram_compression/import_pvrtc

• bool rendering/vram_compression/import_s3tc

方法说明¶

• add_property_info add_property_info(hint: Dictionary)

将自定义属性信息添加到属性。该目录必须包含：

-名称：String（属性的名称）

-类型：int（请参见Variant.Type）

-可选的提示：int（请参见PropertyHint）和hint_string：String

示例：

ProjectSettings.set（“category/property_name”，0）

var property_info = {
    "name": "category/property_name",
    "type": TYPE_INT,
    "hint": PROPERTY_HINT_ENUM,
    "hint_string": "one,two,three"
}

ProjectSettings.add_property_info（property_info）

• clear clear(name: String)

清除整个配置（不建议这样做，可能会破坏东西）。

• get_order get_order(name: String) const

返回配置值的顺序（保存到配置文件时的影响）。

• get_setting get_setting(name: String) const

返回设置的值。

示例：

打印（ProjectSettings.get_setting（"application/config/name"））

• globalize_path globalize_path(path: String) const

将本地化路径（res//）转换为完整的本机OS路径。

• has_setting has_setting(name: String) const

如果存在配置值，则返回true。

• load_resource_pack load_resource_pack(pack: String, replace_files: bool = true)

将pack指定的.pck或.zip文件的内容加载到资源文件系统（res：//）中。

**注意：**如果pack中的文件与资源文件系统中已有的文件共享相同的路径，则任何尝试加载该文件的尝试都将使用pack，除非replace_files设置为false。

• localize_path localize_path(path: String) const

将路径转换为本地化路径（res：//路径）。

• property_can_revert property_can_revert(name: String)

如果指定的属性存在并且其初始值与当前值不同，则返回true。

• property_get_revert property_get_revert(name: String)

返回指定属性的初始值。

• save save()

将配置保存到project.ideavr文件中。

• save_custom save_custom(file: String)

将配置保存到自定义文件。

• set_initial_value set_initial_value(name: String, value: Variant)

设置指定属性的初始值。

• set_order set_order(name: String, position: int)

设置配置值的顺序（保存到配置文件时会产生影响）。

• set_setting set_setting(name: String, value: Variant)

设置设置的值。

示例：

ProjectSettings.set_setting（"application/config/name"，"Example"）