From cdf559e68c2496b20745b2acfcb2ac82fc1d0713 Mon Sep 17 00:00:00 2001 From: Grosskopf Date: Sun, 26 Nov 2017 16:37:37 +0100 Subject: Added documentation for VisualServer --- doc/classes/Texture.xml | 10 +- doc/classes/VisualServer.xml | 286 ++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 292 insertions(+), 4 deletions(-) (limited to 'doc/classes') diff --git a/doc/classes/Texture.xml b/doc/classes/Texture.xml index 855a8f12de..52972177bf 100644 --- a/doc/classes/Texture.xml +++ b/doc/classes/Texture.xml @@ -117,22 +117,26 @@ - Generate mipmaps, to enable smooth zooming out of the texture. + Generate mipmaps, which are smaller versions of the same texture to use when zoomed out, keeping the aspect ratio. - Repeat (instead of clamp to edge). + Repeats texture (instead of clamp to edge). - Turn on magnifying filter, to enable smooth zooming in of the texture. + Magnifying filter, to enable smooth zooming in of the texture. Default flags. Generate mipmaps, repeat, and filter are enabled. + Anisotropic mipmap filtering. Generates smaller versions of the same texture with different aspect ratios. + More effective on planes often shown going to the horrizon as those textures (Walls or Ground for example) get squashed in the viewport to different aspect ratios and regular mipmaps keep the aspect ratio so they don't optimize storage that well in those cases. + Converts texture to SRGB color space. + Repeats texture with alternate sections mirrored. Texture is a video surface. diff --git a/doc/classes/VisualServer.xml b/doc/classes/VisualServer.xml index c84aad26a1..9783d14b4e 100644 --- a/doc/classes/VisualServer.xml +++ b/doc/classes/VisualServer.xml @@ -24,6 +24,7 @@ + Sets images to be rendered in the window margin. @@ -38,12 +39,14 @@ + Sets margin size, where black bars (or images, if [method black_bars_set_images] was used) are rendered. + Creates a canvas and returns the assigned [RID]. @@ -58,6 +61,7 @@ + Adds a circle command to the [CanvasItem]'s draw commands. @@ -68,6 +72,7 @@ + If ignore is [code]true[/code], the VisualServer does not perform clipping. @@ -86,6 +91,7 @@ + Adds a line command to the [CanvasItem]'s draw commands. @@ -98,6 +104,7 @@ + Adds a [Mesh] to the [CanvasItem]'s draw commands. Only affects its aabb at the moment. @@ -110,6 +117,7 @@ + Adds a [MultiMesh] to the [CanvasItem]'s draw commands. Only affects its aabb at the moment. @@ -138,6 +146,8 @@ + Adds a nine patch image to the [CanvasItem]'s draw commands. + See [NinePatchRect] for more explanation. @@ -156,6 +166,7 @@ + Adds a particles system to the [CanvasItem]'s draw commands. @@ -176,6 +187,7 @@ + Adds a polygon to the [CanvasItem]'s draw commands. @@ -192,6 +204,7 @@ + Adds a polyline, which is a line from mutliple points with a width, to the [CanvasItem]'s draw commands. @@ -212,6 +225,7 @@ + Adds a primitive to the [CanvasItem]'s draw commands. @@ -224,6 +238,7 @@ + Adds a rectangle to the [CanvasItem]'s draw commands. @@ -234,6 +249,8 @@ + Adds a [Transform2D] command to the [CanvasItem]'s draw commands. + This sets the extra_matrix uniform when executed. This affects the later command's of the canvas item. @@ -254,6 +271,7 @@ + Adds a textured rect to the [CanvasItem]'s draw commands. @@ -276,6 +294,7 @@ + Adds a texture rect with region setting to the [CanvasItem]'s draw commands. @@ -298,6 +317,7 @@ + Adds a triangle array to the [CanvasItem]'s draw commands. @@ -306,12 +326,14 @@ + Clears the [CanvasItem] and removes all commands in it. + Creates a new [CanvasItem] and returns its [RID]. @@ -322,6 +344,7 @@ + Sets clipping for the [CanvasItem]. @@ -334,6 +357,7 @@ + Sets the [CanvasItem] to copy a rect to the backbuffer. @@ -346,6 +370,7 @@ + Defines a custom drawing rectangle for the [CanvasItem]. @@ -366,6 +391,7 @@ + Sets [CanvasItem] to be drawn behind its parent. @@ -376,6 +402,7 @@ + Sets the index for the [CanvasItem]. @@ -386,6 +413,7 @@ + The light mask. See [LightOccluder2D] for more information on light masks. @@ -396,6 +424,7 @@ + Sets a new material to the [CanvasItem]. @@ -406,6 +435,7 @@ + Sets the color that modulates the [CanvasItem] and its children. @@ -416,6 +446,7 @@ + Sets the parent for the [CanvasItem]. @@ -426,6 +457,7 @@ + Sets the color that modulates the [CanvasItem] without children. @@ -436,6 +468,7 @@ + Sets if [CanvasItem]'s children should be sorted by y-position. @@ -446,6 +479,7 @@ + Sets the [CanvasItem]'s [Transform2D]. @@ -456,6 +490,7 @@ + Sets if the [CanvasItem] uses its parent's material. @@ -466,6 +501,7 @@ + Sets if the canvas item (including its children) is visible. @@ -476,6 +512,7 @@ + Sets the [CanvasItem]'s z order position. @@ -486,6 +523,7 @@ + If this is enabled, the z-position of the parent will be added to the childrens z-position. @@ -496,12 +534,14 @@ + Attaches the canvas light to the canvas. Removes it from its previous canvas. + Creates a canvas light. @@ -512,12 +552,14 @@ + Attaches a light occluder to the canvas. Removes it from its previous canvas. + Creates a light occluder. @@ -528,6 +570,7 @@ + Enables or disables light occluder. @@ -538,6 +581,7 @@ + The light mask. See [LightOccluder2D] for more information on light masks @@ -548,6 +592,7 @@ + Sets a light occluder's polygon. @@ -558,6 +603,7 @@ + Sets a light occluder's [Transform2D]. @@ -568,6 +614,7 @@ + Sets the color for a light. @@ -578,6 +625,7 @@ + Enables or disables a canvas light. @@ -588,6 +636,7 @@ + Sets a canvas light's energy. @@ -598,6 +647,7 @@ + Sets a canvas light's height. @@ -608,6 +658,7 @@ + The light mask. See [LightOccluder2D] for more information on light masks @@ -618,6 +669,7 @@ + The shadow mask. binary about wich layers this canvas light affects wich canvas item's shadows. See [LightOccluder2D] for more information on light masks. @@ -630,6 +682,7 @@ + The layer range that gets rendered with this light. @@ -640,6 +693,7 @@ + The mode of the light, see CANVAS_LIGHT_MODE_* constants. @@ -660,6 +714,7 @@ + Sets the width of the shadow buffer, size gets scaled to the next power of two for this. @@ -670,6 +725,7 @@ + Sets the color of the canvas light's shadow. @@ -680,6 +736,7 @@ + Enables or disables the canvas light's shadow. @@ -690,6 +747,7 @@ + Sets the canvas light's shadow's filter, see CANVAS_LIGHT_SHADOW_FILTER_* constants. @@ -700,6 +758,7 @@ + Sets the length of the shadow's gradient. @@ -710,6 +769,7 @@ + Smoothens the shadow. The lower, the more smooth. @@ -740,6 +800,7 @@ + Sets the canvas light's [Transform2D]. @@ -758,6 +819,7 @@ + Creates a new light occluder polygon. @@ -768,6 +830,7 @@ + Sets an occluder polygons cull mode. See CANVAS_OCCLUDER_POLYGON_CULL_MODE_* constants. @@ -780,6 +843,7 @@ + Sets the shape of the occluder polygon. @@ -790,6 +854,7 @@ + Sets the shape of the occluder polygon as lines. @@ -802,6 +867,7 @@ + A copy of the canvas item will be drawn with a local offset of the mirroring [Vector2]. @@ -812,30 +878,35 @@ + Modulates all colors in the given canvas. + Draws a frame. + Removes buffers and clears testcubes. + Draws a frame. Same as [method draw]. + Syncronizes threads. @@ -844,6 +915,7 @@ + Tries to free an object in the VisualServer. @@ -852,30 +924,35 @@ + Returns a certain information, see RENDER_INFO_* for options. + Returns the id of the test cube. Creates one if none exists. + Returns the id of the test texture. Creates one if none exists. + Returns the id of a white texture. Creates one if none exists. + Returns [code]true[/code] if changes have been made to the VisualServer's data. [method draw] is usually called if this happens. @@ -892,12 +969,14 @@ + Returns true, if the OS supports a certain feature. Features might be s3tc, etc, etc2 and pvrtc, + Initializes the visual server. @@ -910,12 +989,14 @@ + Returns a mesh of a sphere with the given amount of horizontal and vertical subdivisions. + Returns an empty material. @@ -926,6 +1007,7 @@ + Returns the value of a certain material's parameter. @@ -934,6 +1016,7 @@ + Returns the shader of a certain material's shader. Returns an empty RID if the material doesn't have a shader. @@ -944,6 +1027,7 @@ + Sets a materials line width. @@ -954,6 +1038,7 @@ + Sets an objects next material. @@ -966,6 +1051,7 @@ + Sets a materials parameter. @@ -976,6 +1062,7 @@ + Sets a material's render priority. @@ -986,6 +1073,7 @@ + Sets a shader material's shader. @@ -1002,6 +1090,7 @@ + Adds a surface generated from the Arrays to a mesh. See PRIMITIVE_TYPE_* constants for types. @@ -1010,12 +1099,14 @@ + Removes all surfaces from a mesh. + Creates a new mesh. @@ -1024,6 +1115,7 @@ + Returns a mesh's blend shape count. @@ -1032,6 +1124,7 @@ + Returns a mesh's blend shape mode. @@ -1040,6 +1133,7 @@ + Returns a mesh's custom aabb. @@ -1048,6 +1142,7 @@ + Returns a mesh's number of surfaces. @@ -1058,6 +1153,7 @@ + Removes a mesh's surface. @@ -1068,6 +1164,7 @@ + Sets a mesh's blend shape count. @@ -1078,6 +1175,7 @@ + Sets a mesh's blend shape mode. @@ -1088,6 +1186,7 @@ + Sets a mesh's custom aabb. @@ -1098,6 +1197,7 @@ + Returns a mesh's surface's aabb. @@ -1108,6 +1208,7 @@ + Returns a mesh's surface's vertex buffer. @@ -1118,6 +1219,7 @@ + Returns a mesh's surface's amount of indices. @@ -1128,6 +1230,7 @@ + Returns a mesh's surface's amount of vertices. @@ -1138,6 +1241,7 @@ + Returns a mesh's surface's buffer arrays. @@ -1148,6 +1252,7 @@ + Returns a mesh's surface's arrays for blend shapes @@ -1158,6 +1263,7 @@ + Returns the format of a mesh's surface. @@ -1168,6 +1274,7 @@ + Returns a mesh's surface's index buffer. @@ -1178,6 +1285,7 @@ + Returns a mesh's surface's material. @@ -1188,6 +1296,7 @@ + Returns the primitive type of a mesh's surface. @@ -1198,6 +1307,7 @@ + Returns the aabb of a mesh's surface's skeleton. @@ -1210,6 +1320,7 @@ + Sets a mesh's surface's material. @@ -1236,6 +1347,7 @@ + Sets a boot image. The color defines the background color and if scale is [code]true[/code], the image will be scaled to fit the screen size. @@ -1258,6 +1370,7 @@ + Creates an empty shader. @@ -1266,6 +1379,7 @@ + Returns a shader's code. @@ -1276,6 +1390,7 @@ + Returns a default texture from a shader searched by name. @@ -1284,6 +1399,7 @@ + Returns the parameters of a shader. @@ -1294,6 +1410,7 @@ + Sets a shader's code. @@ -1306,12 +1423,14 @@ + Sets a shader's default texture. Overwrites the texture given by name. + Creates an empty sky. @@ -1324,6 +1443,7 @@ + Sets a sky's texture. @@ -1346,12 +1466,14 @@ + Allocates space for a texture's image or video. + Creates an empty texture. @@ -1362,12 +1484,14 @@ + Creates a texture, allocates the space for an image, and fills in the image. + Returns a list of all the textures and their information. @@ -1378,6 +1502,7 @@ + Returns a copy of a texture's image unless it's a CubeMap, in wich case it returns the [RID] of the image at one of the cubes sides. @@ -1386,6 +1511,7 @@ + Returns the flags of a texture. @@ -1394,6 +1520,7 @@ + Returns the format of the texture's image. @@ -1402,6 +1529,7 @@ + Returns the texture's height. @@ -1410,6 +1538,7 @@ + Returns the texture's path. @@ -1418,6 +1547,7 @@ + Returns the opengl id of the texture's image. @@ -1426,6 +1556,7 @@ + Returns the texture's width. @@ -1438,6 +1569,7 @@ + Sets the texture's image data. If it's a CubeMap, it sets the image data at a cube side. @@ -1448,6 +1580,7 @@ + Sets the texture's flags. See [enum TextureFlags] for options @@ -1458,6 +1591,7 @@ + Sets the texture's path. @@ -1466,6 +1600,7 @@ + If [code]true[/code], sets internal processes to shrink all image data to half the size. @@ -1478,6 +1613,7 @@ + Overwrites the texture's width and height. @@ -1486,6 +1622,7 @@ + If [code]true[/code], the image will be stored in the texture's images array if overwritten. @@ -1496,6 +1633,7 @@ + Sets a viewport's camera. @@ -1506,6 +1644,7 @@ + Sets a viewport's canvas. @@ -1518,12 +1657,14 @@ + Attaches a viewport to a screen. + Creates an empty viewport. @@ -1532,6 +1673,7 @@ + Detaches the viewport from the screen. @@ -1542,6 +1684,7 @@ + Returns a viewport's render info. for options see VIEWPORT_RENDER_INFO* constants. @@ -1550,6 +1693,7 @@ + Returns the viewport's last rendered frame. @@ -1560,6 +1704,7 @@ + Detaches a viewport from a canvas and vice versa. @@ -1570,6 +1715,7 @@ + If [code]true[/code], sets the viewport active, else sets it inactive. @@ -1582,6 +1728,7 @@ + Sets the renderlayer for a viewport's canvas. @@ -1594,6 +1741,7 @@ + Sets the transformation of a viewport's canvas. @@ -1604,6 +1752,7 @@ + Sets the clear mode of a viewport. See VIEWPORT_CLEAR_MODE_* constants for options. @@ -1614,6 +1763,7 @@ + Sets the debug draw mode of a viewport. See VIEWPORT_DEBUG_DRAW_* constants for options. @@ -1624,6 +1774,7 @@ + If [code]true[/code] a viewport's 3D rendering should be disabled. @@ -1634,6 +1785,7 @@ + If [code]true[/code] rendering of a viewport's environment should be disabled. @@ -1644,6 +1796,7 @@ + Sets the viewport's global transformation matrix. @@ -1654,6 +1807,7 @@ + If [code]true[/code] the viewport should render to hdr. @@ -1664,6 +1818,7 @@ + If [code]true[/code] the viewport's canvas should not be rendered. @@ -1684,6 +1839,7 @@ + Sets the anti-aliasing mode. see [enum ViewportMSAA] for options. @@ -1694,6 +1850,7 @@ + Sets the viewport's parent to another viewport. @@ -1704,6 +1861,8 @@ + Sets a viewport's scenario. + The scenario contains information about the [enum ScenarioDebugMode], environment information, reflection atlas etc. @@ -1716,6 +1875,7 @@ + Sets the shadow atlas quadrant's subdivision. @@ -1726,6 +1886,7 @@ + Sets the size of the shadow atlas's images. @@ -1738,6 +1899,7 @@ + Sets the viewport's width and height. @@ -1748,6 +1910,7 @@ + If [code]true[/code] the viewport should render its background as transparent. @@ -1758,6 +1921,7 @@ + Sets when the viewport should be updated. See VIEWPORT_UPDATE_MODE_* constants for options. @@ -1768,6 +1932,7 @@ + Sets what should be rendered in the viewport. See VIEWPORT_USAGE_* constants for options. @@ -1778,6 +1943,7 @@ + If [code]true[/code] the viewport should use augmented or virtual reality technologies. See [ARVRInterface]. @@ -1788,6 +1954,7 @@ + If [code]true[/code] the viewport's rendering should be flipped vertically. @@ -1799,160 +1966,232 @@ + Marks an error that shows that the index array is empty. + The minimum Z-layer for canvas items. + The maximum Z-layer for canvas items. + The minimum renderpriority of all materials. + The maximum renderpriority of all materials. + Marks the left side of a cubemap. + Marks the right side of a cubemap. + Marks the bottom side of a cubemap. + Marks the top side of a cubemap. + Marks the front side of a cubemap. + Marks the back side of a cubemap. + Generate mipmaps, which are smaller versions of the same texture to use when zoomed out, keeping the aspect ratio. + Repeat (instead of clamp to edge). + Turn on magnifying filter, to enable smooth zooming in of the texture. + Anisotropic mipmap filtering. Generates smaller versions of the same texture with different aspect ratios. + More effective on planes often shown going to the horrizon as those textures (Walls or Ground for example) get squashed in the viewport to different aspect ratios and regular mipmaps keep the aspect ratio so they don't optimize storage that well in those cases. + Converts texture to SRGB color space. + Repeat texture with alternate sections mirrored. + Texture is a cubemap. + Texture is a video surface. + Default flags. Generate mipmaps, repeat, and filter are enabled. + Shader is a 3D shader. + Shader is a 2D shader. + Shader is a particle shader. + Marks maximum of the shader types array. used internally. + Array is a vertex array. + Array is a normal array. + Array is a tangent array. + Array is a color array. + Array is a uv coordinates array. + Array is a uv coordinates array for the second uv coordinates. + Array contains bone information. + Array is weight information. + Array is index array. + Marks the maximum of the array types. Used internally. + Flag used to mark a vertex array. + Flag used to mark a normal array. + Flag used to mark a tangent array. + Flag used to mark a color array. + Flag used to mark a uv coordinates array. + Flag used to mark a uv coordinates array for the second uv coordinates. + Flag used to mark a bone information array. + Flag used to mark a weights array. + Flag used to mark a index array. + Flag used to mark a compressed (half float) vertex array. + Flag used to mark a compressed (half float) normal array. + Flag used to mark a compressed (half float) tangent array. + Flag used to mark a compressed (half float) color array. + Flag used to mark a compressed (half float) uv coordinates array. + Flag used to mark a compressed (half float) uv coordinates array for the second uv coordinates. + Flag used to mark a compressed (half float) weight array. + Flag used to mark that the array contains 2D vertices. + Flag used to mark that the array uses 16 bit bones instead of 8 bit. + Used to set flags ARRAY_COMPRESS_VERTEX, ARRAY_COMPRESS_NORMAL, ARRAY_COMPRESS_TANGENT, ARRAY_COMPRESS_COLOR, ARRAY_COMPRESS_TEX_UV, ARRAY_COMPRESS_TEX_UV2 and ARRAY_COMPRESS_WEIGHTS quickly. + Primitive to draw consists of points. + Primitive to draw consists of lines. + Primitive to draw consists of a line strip from start to end. + Primitive to draw consists of a line loop (a line strip with a line between the last and the first vertex). + Primitive to draw consists of triangles. + Primitive to draw consists of a triangle strip (the last 3 verticies are always combined to make a triangle). + Primitive to draw consists of a triangle strip (the last 2 verticies are always combined with the first to make a triangle). + Marks the primitive types endpoint. used internally. + Is a directional (sun) light. + is an omni light. + is an spot light. + The light's energy. + The light's influence on specularity. + The light's range. + The light's attenuation. + The spotlight's angle. + The spotlight's attenuation. + Scales the shadow color. @@ -1969,6 +2208,7 @@ + The light parameters endpoint. Used internally. @@ -1979,28 +2219,40 @@ + The viewport is always cleared before drawing. + The viewport is never cleared before drawing. + The viewport is cleared once, then the clear mode is set to [VIEWPORT_CLEAR_NEVER]. + Multisample antialiasing is disabled. + Multisample antialiasing is set to 2X. + Multisample antialiasing is set to 4X. + Multisample antialiasing is set to 8X. + Multisample antialiasing is set to 16X. + The Viewport does not render 3D but samples. + The Viewport does not render 3D and does not sample. + The Viewport renders 3D with effects. + The Viewport renders 3D but without effects. @@ -2015,14 +2267,19 @@ + Marks end of VIEWPORT_RENDER_INFO* constants. Used internally. + Debug draw is disabled. Default setting. + Debug draw sets objects to unshaded. + Overwrites clear color to [code](0,0,0,0)[/code]. + Debug draw draws objects in wireframe. @@ -2033,38 +2290,53 @@ + The instance does not have a type. + The instance is a mesh. + The instance is a multimesh. + The instance is an immediate geometry. + The instance is a particle emitter. + The instance is a light. + The max value for INSTANCE_* constants, used internally. + A combination of the flags of geometry instances (mesh, multimesh, immediate and particles). + The nine patch gets stretched where needed. + The nine patch gets filled with tiles where needed. + The nine patch gets filled with tiles where needed and stretches them a bit if needed. + Adds light color additive to the canvas. + Adds light color subtractive to the canvas. + The light adds color depending on transparency. + The light adds color depending on mask. @@ -2079,34 +2351,46 @@ + Culling of the canvas occluder is disabled. + Culling of the canvas occluder is clockwise. + Culling of the canvas occluder is counterclockwise. + The amount of objects in the frame. + The amount of vertices in the frame. + The amount of modified materials in the frame. + The amount of shader rebinds in the frame. + The amount of surface changes in the frame. + The amount of draw calls in frame. + The amount of vertex memory and texture memory used. + The amount of texture memory used. + The amount of vertex memory used. - + \ No newline at end of file -- cgit v1.2.3