Extend `CanvasItem::draw_circle()` with filled, width, and antialiased options
Make it possible to draw unfilled circle, like draw_rect(). Antialising is only implemented for unfilled version.
This commit is contained in:
Yaohua Xiong
Rémi Verschelde
parent
f91db3dc58
commit
1f2aa17d14
|
|
@ -77,8 +77,14 @@
|
|||
<param index="0" name="position" type="Vector2" />
|
||||
<param index="1" name="radius" type="float" />
|
||||
<param index="2" name="color" type="Color" />
|
||||
<param index="3" name="filled" type="bool" default="true" />
|
||||
<param index="4" name="width" type="float" default="-1.0" />
|
||||
<param index="5" name="antialiased" type="bool" default="false" />
|
||||
<description>
|
||||
Draws a colored, filled circle. See also [method draw_arc], [method draw_polyline] and [method draw_polygon].
|
||||
Draws a circle. See also [method draw_arc], [method draw_polyline], and [method draw_polygon].
|
||||
If [param filled] is [code]true[/code], the circle will be filled with the [param color] specified. If [param filled] is [code]false[/code], the circle will be drawn as a stroke with the [param color] and [param width] specified.
|
||||
If [param width] is negative, then two-point primitives will be drawn instead of a four-point ones. This means that when the CanvasItem is scaled, the lines will remain thin. If this behavior is not desired, then pass a positive [param width] like [code]1.0[/code].
|
||||
[b]Note:[/b] [param width] is only effective if [param filled] is [code]false[/code].
|
||||
</description>
|
||||
</method>
|
||||
<method name="draw_colored_polygon">
|
||||
|
|
|
|||
|
|
@ -323,3 +323,10 @@ Validate extension JSON: Error: Field 'classes/TextEdit/methods/set_selection_mo
|
|||
|
||||
Removed optional arguments set_selection_mode, use set_selection_origin_line/column instead.
|
||||
Compatibility methods registered.
|
||||
|
||||
|
||||
GH-84472
|
||||
--------
|
||||
Validate extension JSON: Error: Field 'classes/CanvasItem/methods/draw_circle/arguments': size changed value in new API, from 3 to 6.
|
||||
|
||||
Optional arguments added. Compatibility methods registered.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,41 @@
|
|||
/**************************************************************************/
|
||||
/* canvas_item.compat.inc */
|
||||
/**************************************************************************/
|
||||
/* This file is part of: */
|
||||
/* GODOT ENGINE */
|
||||
/* https://godotengine.org */
|
||||
/**************************************************************************/
|
||||
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
||||
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
||||
/* */
|
||||
/* Permission is hereby granted, free of charge, to any person obtaining */
|
||||
/* a copy of this software and associated documentation files (the */
|
||||
/* "Software"), to deal in the Software without restriction, including */
|
||||
/* without limitation the rights to use, copy, modify, merge, publish, */
|
||||
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
||||
/* permit persons to whom the Software is furnished to do so, subject to */
|
||||
/* the following conditions: */
|
||||
/* */
|
||||
/* The above copyright notice and this permission notice shall be */
|
||||
/* included in all copies or substantial portions of the Software. */
|
||||
/* */
|
||||
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
||||
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
||||
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
||||
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
||||
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
||||
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
||||
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
||||
/**************************************************************************/
|
||||
|
||||
#ifndef DISABLE_DEPRECATED
|
||||
|
||||
void CanvasItem::_draw_circle_compat_84472(const Point2 &p_pos, real_t p_radius, const Color &p_color) {
|
||||
draw_circle(p_pos, p_radius, p_color, true, -1.0, false);
|
||||
}
|
||||
|
||||
void CanvasItem::_bind_compatibility_methods() {
|
||||
ClassDB::bind_compatibility_method(D_METHOD("draw_circle", "position", "radius", "color"), &CanvasItem::_draw_circle_compat_84472);
|
||||
}
|
||||
|
||||
#endif
|
||||
|
|
@ -29,6 +29,7 @@
|
|||
/**************************************************************************/
|
||||
|
||||
#include "canvas_item.h"
|
||||
#include "canvas_item.compat.inc"
|
||||
|
||||
#include "scene/2d/canvas_group.h"
|
||||
#include "scene/main/canvas_layer.h"
|
||||
|
|
@ -726,11 +727,40 @@ void CanvasItem::draw_rect(const Rect2 &p_rect, const Color &p_color, bool p_fil
|
|||
}
|
||||
}
|
||||
|
||||
void CanvasItem::draw_circle(const Point2 &p_pos, real_t p_radius, const Color &p_color) {
|
||||
void CanvasItem::draw_circle(const Point2 &p_pos, real_t p_radius, const Color &p_color, bool p_filled, real_t p_width, bool p_antialiased) {
|
||||
ERR_THREAD_GUARD;
|
||||
ERR_DRAW_GUARD;
|
||||
|
||||
RenderingServer::get_singleton()->canvas_item_add_circle(canvas_item, p_pos, p_radius, p_color);
|
||||
if (p_filled) {
|
||||
if (p_width != -1.0) {
|
||||
WARN_PRINT("The draw_circle() \"width\" argument has no effect when \"filled\" is \"true\".");
|
||||
}
|
||||
|
||||
RenderingServer::get_singleton()->canvas_item_add_circle(canvas_item, p_pos, p_radius, p_color);
|
||||
} else if (p_width >= 2.0 * p_radius) {
|
||||
RenderingServer::get_singleton()->canvas_item_add_circle(canvas_item, p_pos, p_radius + 0.5 * p_width, p_color);
|
||||
} else {
|
||||
// Tessellation count is hardcoded. Keep in sync with the same variable in `RendererCanvasCull::canvas_item_add_circle()`.
|
||||
const int circle_segments = 64;
|
||||
|
||||
Vector<Vector2> points;
|
||||
points.resize(circle_segments + 1);
|
||||
|
||||
Vector2 *points_ptr = points.ptrw();
|
||||
const real_t circle_point_step = Math_TAU / circle_segments;
|
||||
|
||||
for (int i = 0; i < circle_segments; i++) {
|
||||
float angle = i * circle_point_step;
|
||||
points_ptr[i].x = Math::cos(angle) * p_radius;
|
||||
points_ptr[i].y = Math::sin(angle) * p_radius;
|
||||
points_ptr[i] += p_pos;
|
||||
}
|
||||
points_ptr[circle_segments] = points_ptr[0];
|
||||
|
||||
Vector<Color> colors = { p_color };
|
||||
|
||||
RenderingServer::get_singleton()->canvas_item_add_polyline(canvas_item, points, colors, p_width, p_antialiased);
|
||||
}
|
||||
}
|
||||
|
||||
void CanvasItem::draw_texture(const Ref<Texture2D> &p_texture, const Point2 &p_pos, const Color &p_modulate) {
|
||||
|
|
@ -1163,7 +1193,7 @@ void CanvasItem::_bind_methods() {
|
|||
ClassDB::bind_method(D_METHOD("draw_multiline", "points", "color", "width"), &CanvasItem::draw_multiline, DEFVAL(-1.0));
|
||||
ClassDB::bind_method(D_METHOD("draw_multiline_colors", "points", "colors", "width"), &CanvasItem::draw_multiline_colors, DEFVAL(-1.0));
|
||||
ClassDB::bind_method(D_METHOD("draw_rect", "rect", "color", "filled", "width"), &CanvasItem::draw_rect, DEFVAL(true), DEFVAL(-1.0));
|
||||
ClassDB::bind_method(D_METHOD("draw_circle", "position", "radius", "color"), &CanvasItem::draw_circle);
|
||||
ClassDB::bind_method(D_METHOD("draw_circle", "position", "radius", "color", "filled", "width", "antialiased"), &CanvasItem::draw_circle, DEFVAL(true), DEFVAL(-1.0), DEFVAL(false));
|
||||
ClassDB::bind_method(D_METHOD("draw_texture", "texture", "position", "modulate"), &CanvasItem::draw_texture, DEFVAL(Color(1, 1, 1, 1)));
|
||||
ClassDB::bind_method(D_METHOD("draw_texture_rect", "texture", "rect", "tile", "modulate", "transpose"), &CanvasItem::draw_texture_rect, DEFVAL(Color(1, 1, 1, 1)), DEFVAL(false));
|
||||
ClassDB::bind_method(D_METHOD("draw_texture_rect_region", "texture", "rect", "src_rect", "modulate", "transpose", "clip_uv"), &CanvasItem::draw_texture_rect_region, DEFVAL(Color(1, 1, 1, 1)), DEFVAL(false), DEFVAL(true));
|
||||
|
|
|
|||
|
|
@ -166,6 +166,12 @@ protected:
|
|||
|
||||
void _notification(int p_what);
|
||||
static void _bind_methods();
|
||||
|
||||
#ifndef DISABLE_DEPRECATED
|
||||
void _draw_circle_compat_84472(const Point2 &p_pos, real_t p_radius, const Color &p_color);
|
||||
static void _bind_compatibility_methods();
|
||||
#endif
|
||||
|
||||
void _validate_property(PropertyInfo &p_property) const;
|
||||
|
||||
_FORCE_INLINE_ void set_hide_clip_children(bool p_value) { hide_clip_children = p_value; }
|
||||
|
|
@ -273,7 +279,7 @@ public:
|
|||
void draw_multiline(const Vector<Point2> &p_points, const Color &p_color, real_t p_width = -1.0);
|
||||
void draw_multiline_colors(const Vector<Point2> &p_points, const Vector<Color> &p_colors, real_t p_width = -1.0);
|
||||
void draw_rect(const Rect2 &p_rect, const Color &p_color, bool p_filled = true, real_t p_width = -1.0);
|
||||
void draw_circle(const Point2 &p_pos, real_t p_radius, const Color &p_color);
|
||||
void draw_circle(const Point2 &p_pos, real_t p_radius, const Color &p_color, bool p_filled = true, real_t p_width = -1.0, bool p_antialiased = false);
|
||||
void draw_texture(const Ref<Texture2D> &p_texture, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1, 1));
|
||||
void draw_texture_rect(const Ref<Texture2D> &p_texture, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false);
|
||||
void draw_texture_rect_region(const Ref<Texture2D> &p_texture, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, bool p_clip_uv = false);
|
||||
|
|
|
|||
Loading…
Reference in New Issue