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

Various tweaks to Camera2D's documentation #55699

Merged
merged 1 commit into from
Dec 15, 2021

Conversation

Mickeon
Copy link
Contributor

@Mickeon Mickeon commented Dec 7, 2021

A summary of the tweaked descriptions:

  • get_camera_position() explains what the "camera position" is, and mitigates the confusion between this method and Node2D.position;

  • get_camera_screen_center() links to get_camera_position();

  • reset_smoothing() links to smoothing_enabled;

  • drag_horizontal_offset and drag_vertical_offset link to their respective enabled properties;

  • limit_smoothed links to the smoothing_enabled propriety;

  • rotating clarifies that the camera view rotates when enabled.

Partially closes godotengine/godot-docs#5417, as some of the issues described are no longer present in 4.0, or are not fully solved in this PR.

Further adjustments are greatly appreciated, as I'm afraid this could be too verbose. A few of these could be split into their PR if necessary.

A summary of the tweaked descriptions:
* "get_camera_position()" is explains what the camera position is, and mitigates the confusion between this method and Node2D.position;
* "get_camera_screen_center()" links to the "get_camera_position" method;
* "reset_smoothing()" links to the "smoothing_enabled" propriety;

* "drag_horizontal_offset" and "drag_vertical_offset" link to their respective _enabled_ properties;
* "limit_smoothed" links to the "smoothing_enabled" propriety;
* "rotating" clarifies that the camera _view_ rotates when enabled.

Partially closes godotengine/godot-docs#5417, as some of the issues described are no longer present in 4.0, or are not fully solved in this PR.

Further tweaks are welcome, as I'm afraid this could be a too verbose. A few of these could be split into their PR if necessary.
@Mickeon Mickeon requested a review from a team as a code owner December 7, 2021 18:08
@Chaosus Chaosus added this to the 4.0 milestone Dec 7, 2021
@mhilbrunner mhilbrunner merged commit 1930fc8 into godotengine:master Dec 15, 2021
@mhilbrunner
Copy link
Member

Thank you, and congrats on your first contribution to Godot! 🎉

@mhilbrunner mhilbrunner added the cherrypick:3.x Considered for cherry-picking into a future 3.x release label Dec 15, 2021
@mhilbrunner
Copy link
Member

Note: we may want to cherry-pick this, not 100% sure if all properties are the same though.

@akien-mga
Copy link
Member

Cherry-picked for 3.5.

@akien-mga akien-mga removed the cherrypick:3.x Considered for cherry-picking into a future 3.x release label Dec 21, 2021
@Mickeon Mickeon deleted the patch-1 branch January 14, 2022 15:38
@golddotasksquestions
Copy link

golddotasksquestions commented Aug 15, 2022

I'm afraid I still don't understand the rotating (or rotating_view if renamed) description at all.

If true, the camera view rotates with the target.

What target? Where can I set/define what this target is? What is meant by "view" here?
Thanks for the improvements, much appreciated!

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.

General lack of clarity for Camera2D properties and methods.
5 participants