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

Add page "custom drawing in 3D" #10707

Open
sosasees opened this issue Feb 22, 2025 · 6 comments
Open

Add page "custom drawing in 3D" #10707

sosasees opened this issue Feb 22, 2025 · 6 comments
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features topic:rendering topic:3d

Comments

@sosasees
Copy link

Your Godot version: 4.4.beta1

Issue description: i am prototyping procedural 3D visuals, so i need to use custom drawing in 3D to create procedural 3D visuals but there is no "custom drawing in 3D" documentation page.
if there is documentation about cusom drawing in 3D, i can't find it because i can't think of another name that such documentation could have except "custom drawing in 3D"

URL to the documentation page (if already existing):
the documentation page does not exist. here are the search results which should find the page "custom drawing in 3D" but they did not

@AThousandShips AThousandShips added content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features topic:rendering area:manual Issues and PRs related to the Manual/Tutorials section of the documentation topic:3d labels Feb 22, 2025
@sosasees
Copy link
Author

i want the page "custom drawing in 3D" to be the 3D equivalent of "custom drawing in 2D":
a starting guide to script‑generated visuals in 3D, similar to what "custom drawing in 2D" teaches for 2D

@Calinou
Copy link
Member

Calinou commented Feb 22, 2025

There is no 1:1 equivalent of the custom 2D drawing API in 3D. You need to use procedural mesh generation instead: https://docs.godotengine.org/en/latest/tutorials/3d/procedural_geometry/index.html

@tetrapod00
Copy link
Contributor

There is no precise equivalent of _draw() in 3D nodes (on Node3D or GeometryInstance3D or VisualInstance3D). So the exact purpose of Custom Drawing in 2D, which is documenting the _draw() function, doesn't make sense in 3D.

Existing pages that cover similar topics to "custom drawing in 3D" would be:

Since the underlying features are different, a Custom drawing in 3D page could make sense as a landing/redirect page for the existing pages. But it wouldn't directly document a specific feature. We try not to include tutorial pages that don't document specific features, so I don't think we should duplicate the documentation for a specific existing feature like ArrayMesh in a new page either

@sosasees
Copy link
Author

we could add this especially‑written message box above the normal search results for "custom drawing in 3D" on the search results page:

you might be looking for these pages:

@tetrapod00
Copy link
Contributor

We really don't have that much control over the search to do that

@sosasees
Copy link
Author

how could we get the ability to add especially‑written messages above automatic search results?

@fire fire changed the title add page "custom drawing in 3D" Add page "custom drawing in 3D" Feb 26, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features topic:rendering topic:3d
Projects
None yet
Development

No branches or pull requests

4 participants