Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fill in descriptions for import options in the class reference #79405

Merged
merged 1 commit into from
Jul 27, 2023

Conversation

Calinou
Copy link
Member

@Calinou Calinou commented Jul 13, 2023

This fully documents all editor import options currently exposed. (We are missing some options due to how they're registered, such as slices/amount in ResourceImporterLayeredTexture and gltf/embedded_texture_handling in EditorSceneFormatImporterGLTF.)

@Calinou Calinou requested review from a team as code owners July 13, 2023 03:12
@Calinou Calinou added this to the 4.2 milestone Jul 13, 2023
@Calinou Calinou force-pushed the doc-import-options branch 3 times, most recently from 66f9c60 to 5f601b8 Compare July 13, 2023 03:20
doc/classes/ResourceImporterDynamicFont.xml Outdated Show resolved Hide resolved
doc/classes/ResourceImporterDynamicFont.xml Outdated Show resolved Hide resolved
doc/classes/ResourceImporterDynamicFont.xml Outdated Show resolved Hide resolved
doc/classes/ResourceImporterDynamicFont.xml Outdated Show resolved Hide resolved
doc/classes/ResourceImporterDynamicFont.xml Outdated Show resolved Hide resolved
@Calinou Calinou force-pushed the doc-import-options branch from 5f601b8 to 69b9032 Compare July 13, 2023 14:23
@YuriSizov YuriSizov requested a review from bruvzg July 26, 2023 15:59
Copy link
Contributor

@YuriSizov YuriSizov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving in principle, but would appreciate @bruvzg to check if all comments were properly addressed.

</member>
<member name="fallbacks" type="Array" setter="" getter="" default="[]">
List of font fallbacks to use if a glyph isn't found in this dynamic font. Fonts at the beginning of the array are attempted first, but fallback fonts that don't support the glyph's language and script are ignored (see [member language_support] and [member script_support]). See also [member allow_system_fallback].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
List of font fallbacks to use if a glyph isn't found in this dynamic font. Fonts at the beginning of the array are attempted first, but fallback fonts that don't support the glyph's language and script are ignored (see [member language_support] and [member script_support]). See also [member allow_system_fallback].
List of font fallbacks to use if a glyph isn't found in this dynamic font. Fonts at the beginning of the array are attempted first, but fallback fonts that don't support the glyph's language and script are attempted last (see [member language_support] and [member script_support]). See also [member allow_system_fallback].

Procedure is like this, text server add each of the fallbacks to the one of 3 lists - language and script match, script match, no match. And do through them in the following order:

  • Main font
  • Language and script match list
  • Script match list
  • No match list
  • System font (from OS.get_system_font_path_for_text)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've applied the suggested change on Calinou's behalf to start the CI. I think for now it's good for merge (so it makes it into 4.2.dev2). If there are further clarifications or corrections required, we can open a follow-up PR.

@YuriSizov YuriSizov force-pushed the doc-import-options branch from 69b9032 to bc58a8a Compare July 27, 2023 17:18
@YuriSizov YuriSizov merged commit da81ca6 into godotengine:master Jul 27, 2023
@YuriSizov
Copy link
Contributor

Thanks!

</member>
<member name="nodes/apply_root_scale" type="bool" setter="" getter="" default="true">
If [code]true[/code], [member nodes/root_scale] will be applied on the meshes and animations directly, while keeping the root node's scale to the default [code](1, 1, 1)[/code]. This means that if you add a child node later on within the imported scene, it won't be scaled. If disabled, [member nodes/root_scale] will multiply the scale of the root node instead.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that I also adjusted these docs in #79774, I have rebased it and attempted to merge the doc changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants