.. _bpy.types.DynamicPaintCanvasSettings: ****** Canvas ****** .. admonition:: Reference :class: refbox :Panel: :menuselection:`Physics --> Dynamic Paint` :Type: Canvas The Canvas type makes object receive paint from Dynamic Paint brushes. .. figure:: /images/physics_dynamic-paint_canvas_main-panel.png :align: right Canvas main panel. Paint Surface A :ref:`list ` of Dynamic Paint surfaces. These surfaces are basically layers of paint, that work independently from each other. You can define individual settings for them and bake them separately. Is Active The checkbox toggles whether surface is active at all. If not selected no calculations are done. Below you can set surface type and adjust quality and timing settings. Format Each surface has a certain format and type. Format determines how data is stored and outputted. Vertex Dynamic Paint operates directly on mesh vertex data. Results are stored by point cache and can be displayed in viewports. However, using vertex level also requires a highly subdivided mesh to work. Image Sequences Dynamic Paint generates UV wrapped image files of defined resolution as output. Quality Resolution You can adjust the output image dimensions for the *Image Sequences* surface type. For example using 256 will lead to 256×256 image output. Doubling the resolution will likely quadruple the baking time and vice versa. Anti-aliasing :term:`Anti-aliasing` to smooth paint edges using a 5× multisampling method. Frames Start, End Defines surface processing start and end frame. Sub-steps Sub-steps are extra samples between frames. They are usually required when there is a very fast brush. Surface ======= .. admonition:: Reference :class: refbox :Type: Canvas :Panel: :menuselection:`Physics --> Dynamic Paint --> Surface` .. TODO2.8: .. figure:: /images/physics_dynamic-paint_canvas_advanced-panel.png Canvas advanced panel. From *Surface* panel you can adjust surface type and related settings. Surface Type ------------ Each surface has a "type" that defines what surface is used for. Paint ^^^^^ .. figure:: /images/physics_dynamic-paint_canvas_surface-type-paint.jpg :width: 320px Paint Surface. Paint is the basic surface type that outputs color and wetness values. In case of vertex surfaces, results are outputted as vertex colors. A wetmap is a black-and-white output that visualizes paint wetness. White being maximum wetness, black being completely dry. It is usually used as mask for rendering. Some "paint effects" affect wet paint only. Dry Completely disable drying is useful for indefinitely spreading paint. Color Dry It can be used to define wetness level when paint colors start to shift to surface "background". Lower values can be useful to prevent spreading paint from becoming transparent as it dries, while higher values give better results in general. Displace ^^^^^^^^ .. figure:: /images/physics_dynamic-paint_canvas_surface-type-displace.jpg :width: 320px Displace Surface. This type of surface outputs intersection depth from brush objects. Incremental A new displace is added cumulatively on top of an existing displace. Max Displace The maximum level of intersection depth, larger values will be clamped to this value. Displace Factor The multiplier for the intersection depth. You can use it to adjust final displace strength or use negative values to paint bumps. .. tip:: If the displace output seems too rough it usually helps to add a Smooth Modifier after Dynamic Paint in the modifier stack. Waves ^^^^^ .. figure:: /images/physics_dynamic-paint_canvas_surface-type-waves.jpg :width: 320px Waves Surface. This surface type produces simulated wave motion. Like displace, wave surface also uses brush intersection depth to define brush strength. You can use following settings to adjust the motion: Open Borders Allows waves to pass through mesh "edges" instead of reflecting from them. Timescale Directly adjusts simulation speed without affecting simulation outcome. Lower values make simulation go slower and otherwise. Speed Affects how fast waves travel on the surface. This setting is also corresponds to the size of the simulation. Half the speed equals surface double as large. Damping Reduces the wave strength over time. Basically adjusts how fast wave disappears. Spring Adjusts the force that pulls water back to "zero level". Smoothness (Todo) .. (wip) It greatly helps getting rid of the "noise" that occurs if you use a really steep objects (like cubes) as a brush. The new default value is 1.0 which is just high enough to only get rid of the sharpest spikes, so if you want a really smooth waves it's better to use higher values. TOOLTIP: Limit maximum steepness of wave slope between simulation points. Use higher values for smoother waves at expense of reduced detail. .. tip:: In some cases the wave motion gets very unstable around brush. It usually helps to reduce wave speed, brush "wave factor" or even the resolution of mesh/surface. Weight ^^^^^^ .. figure:: /images/physics_dynamic-paint_canvas_surface-type-weight.jpg :width: 320px Weight Surface. This is a special surface type only available for vertex format. It outputs vertex weight groups that can be used by other Blender modifiers and tools. .. tip:: It is usually preferred to use "proximity" based brushes for weight surfaces to allow smooth falloff between weight values. Common Options -------------- For each surface type there are special settings to adjust. Most types have the settings *Dissolve* and *Brush*: Dissolve Used to make the surface smoothly return to its original state during a defined *Time* period. Brush Collection Used to define a specific collection to pick brush objects from. Influence Scale, Radius Scale For tweaking brush settings individually for each surface. Output ====== .. admonition:: Reference :class: refbox :Type: Canvas :Panel: :menuselection:`Physics --> Dynamic Paint --> Output` .. TODO2.8: .. figure:: /images/physics_dynamic-paint_canvas_output-panel.png Canvas Output panel. From Output panel you can adjust how surface outputs its results. Vertex ------ For *Vertex* format surfaces, you can select a mesh data layer (color/weight depending on surface type) to generate results to. You can use the "+"/"-" icons to add/remove a data layers of given name. If layer with given name is not found, it is shown as red. Image Sequence -------------- For *Image Sequence* surfaces, you can define used UV maps and output file saving directory, filenames and image format. Initial Color ============= .. admonition:: Reference :class: refbox :Type: Canvas :Panel: :menuselection:`Physics --> Dynamic Paint --> Initial Color` Allows you to define the initial color of the canvas. (Todo 2.62) - None - Color - UV Texture - Vertex Color Effects ======= .. admonition:: Reference :class: refbox :Type: Canvas :Panel: :menuselection:`Physics --> Dynamic Paint --> Effects` .. TODO2.8: .. figure:: /images/physics_dynamic-paint_canvas_effects-panel.png Effects panel. This is a special feature for "Paint" type surface. It generates animated movement on canvas surface. .. (TODO) each of these effects has its own settings Effects Spread Paint slowly spreads to surrounding points eventually filling all connected areas. Drip Paint moves in specific direction specified by Blender force fields, gravity and velocity with user-defined influences. Shrink Painted area slowly shrinks until disappears completely. For spread and drip effects, only "wet paint" is affected, so as the paint dries, movement becomes slower until it stops. Cache ===== .. admonition:: Reference :class: refbox :Type: Canvas :Panel: :menuselection:`Physics --> Dynamic Paint --> Cache` .. TODO2.8: .. figure:: /images/physics_dynamic-paint_canvas_cache-panel.png Canvas cache panel. This panel is currently only visible for *Vertex* format surfaces. You can use it to adjust and bake point cache.